syncfusion-blazor（同步融合刀）

Syncfusion Blazor Components

Setup

dotnet add package Syncfusion.Blazor.Themes
dotnet add package Syncfusion.Blazor.Core
# Add specific component packages as needed:
dotnet add package Syncfusion.Blazor.Grid
dotnet add package Syncfusion.Blazor.Charts
dotnet add package Syncfusion.Blazor.Schedule
dotnet add package Syncfusion.Blazor.RichTextEditor
dotnet add package Syncfusion.Blazor.PdfViewer
dotnet add package Syncfusion.Blazor.Inputs
dotnet add package Syncfusion.Blazor.Navigations

// Program.cs
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense(
    builder.Configuration["Syncfusion:LicenseKey"]);
builder.Services.AddSyncfusionBlazor();

@* _Imports.razor *@
@using Syncfusion.Blazor
@using Syncfusion.Blazor.Grids
@using Syncfusion.Blazor.Charts

<!-- Theme in App.razor -->
<link href="_content/Syncfusion.Blazor.Themes/bootstrap5.css" rel="stylesheet" />

DataGrid (SfGrid)

<SfGrid DataSource="@_orders" AllowPaging="true" AllowSorting="true"
        AllowFiltering="true" AllowGrouping="true"
        Toolbar="@(new List<string> { "Add", "Edit", "Delete", "Search", "ExcelExport" })">
    <GridEditSettings AllowAdding="true" AllowEditing="true" AllowDeleting="true"
                      Mode="EditMode.Dialog" />
    <GridPageSettings PageSize="25" PageSizes="true" />
    <GridFilterSettings Type="FilterType.Excel" />
    <GridSelectionSettings Type="SelectionType.Multiple" />
    <GridEvents OnActionComplete="ActionComplete" TValue="OrderDto"
                OnToolbarClick="ToolbarClick" />
    <GridColumns>
        <GridColumn Field="@nameof(OrderDto.Id)" HeaderText="Order #" Width="100"
                    IsPrimaryKey="true" />
        <GridColumn Field="@nameof(OrderDto.CustomerName)" HeaderText="Customer" Width="200" />
        <GridColumn Field="@nameof(OrderDto.OrderDate)" HeaderText="Date" Width="140"
                    Format="d" Type="ColumnType.Date" />
        <GridColumn Field="@nameof(OrderDto.Total)" HeaderText="Total" Width="120"
                    Format="C2" TextAlign="TextAlign.Right" />
        <GridColumn Field="@nameof(OrderDto.Status)" HeaderText="Status" Width="130">
            <Template>
                @{
                    var order = (context as OrderDto)!;
                    <SfChip>
                        <ChipItems>
                            <ChipItem Text="@order.Status"
                                      CssClass="@GetStatusClass(order.Status)" />
                        </ChipItems>
                    </SfChip>
                }
            </Template>
        </GridColumn>
    </GridColumns>
</SfGrid>

Server-Side Data Operations

<SfGrid TValue="OrderDto" AllowPaging="true" AllowSorting="true" AllowFiltering="true">
    <SfDataManager Url="/api/orders" Adaptor="Adaptors.WebApiAdaptor" />
</SfGrid>

Charts

<SfChart Title="Monthly Revenue">
    <ChartPrimaryXAxis ValueType="Syncfusion.Blazor.Charts.ValueType.Category" />
    <ChartPrimaryYAxis LabelFormat="C0" />
    <ChartSeriesCollection>
        <ChartSeries DataSource="@_revenueData" XName="Month" YName="Revenue"
                     Type="ChartSeriesType.Column" Fill="#4e73df" />
        <ChartSeries DataSource="@_revenueData" XName="Month" YName="Target"
                     Type="ChartSeriesType.Line" Fill="#e74a3b" Width="2" />
    </ChartSeriesCollection>
    <ChartTooltipSettings Enable="true" />
    <ChartLegendSettings Visible="true" />
</SfChart>

Scheduler

<SfSchedule TValue="AppointmentDto" Height="650px" SelectedDate="@DateTime.Today">
    <ScheduleViews>
        <ScheduleView Option="View.Day" />
        <ScheduleView Option="View.Week" />
        <ScheduleView Option="View.Month" />
        <ScheduleView Option="View.Agenda" />
    </ScheduleViews>
    <ScheduleEventSettings DataSource="@_appointments" />
    <ScheduleEvents OnActionComplete="OnScheduleAction" TValue="AppointmentDto" />
</SfSchedule>

Essential UI Kit Blocks

Pre-built layout blocks: https://blazor.syncfusion.com/essential-ui-kit/blocks

Categories: Grid layouts, login pages, dashboards, pricing tables, profile cards, e-commerce, CRM

@* Example: Use grid block for responsive layout *@
<SfGrid DataSource="@_data">
    @* Configured per Essential UI Kit block pattern *@
</SfGrid>

Theming

Built-in themes: bootstrap5, material3, fluent2, tailwind, fabric, highcontrast

Custom theme: Use ThemeStudio at https://blazor.syncfusion.com/themestudio/

License Key Management

// NEVER hardcode! Use one of:
// 1. User Secrets (development)
dotnet user-secrets set "Syncfusion:LicenseKey" "your-key"

// 2. Environment variable
Environment.GetEnvironmentVariable("SYNCFUSION_LICENSE_KEY");

// 3. Azure Key Vault (production)
builder.Configuration.AddAzureKeyVault(vaultUri, credential);

Syncfusion Agentic UI Builder (FREE)

AI-powered tool that generates complete Blazor UI implementations from natural language prompts. Supports React, Angular, and Blazor. Completely free - no usage limits, token caps, or charges.

How it works

1. Describe - "Create a project management dashboard with a grid, charts, and filters"
2. AI Analyzes - Selects appropriate Syncfusion components and layout patterns
3. Generate Code - Produces ready-to-use Blazor code with Syncfusion components
4. Customize - Refine layouts and add custom functionality

Key capabilities

• Generates complete dashboards, data grids, charts, responsive pages
• Works with existing projects (not just greenfield)
• Code aligns with Syncfusion docs and 1,600+ component APIs
• 30-50% productivity gain over manual development
• Privacy-focused: doesn't access project files, prompts not stored

Activation

• Use #sf_blazor_ui_builder tool command in IDE
• Or include "Syncfusion" keyword in prompts
• Recommended models: Claude Sonnet 4.5+, GPT-5, Gemini 3 Pro

IDE support

VS Code, Cursor, JetBrains IDEs, Code Studio

URL: https://www.syncfusion.com/explore/agentic-ui-builder/

Syncfusion Blazor MCP (AI Coding Assistant)

The official @syncfusion/blazor-assistant MCP server provides:

• Component code generation from natural language
• 80+ Blazor component documentation access
• Troubleshooting and configuration guidance
• Theme and styling assistance

Configured in .mcp.json:

{
  "syncfusion-blazor": {
    "command": "npx",
    "args": ["-y", "@syncfusion/blazor-assistant@latest"],
    "env": { "SYNCFUSION_API_KEY": "${SYNCFUSION_API_KEY}" }
  }
}

Use mcp__syncfusion-blazor__* tools when:

• Generating Syncfusion component code
• Looking up component APIs and properties
• Troubleshooting Syncfusion-specific issues
• Getting theme/styling guidance

Syncfusion Knowledge Base (Common Issues)

Blazor KB Articles

• Rich Text Editor resizing in Dialogs: https://support.syncfusion.com/kb/article/20438/
• Image pasting in Rich Text Editor: https://support.syncfusion.com/kb/article/20116/
• ListBox with ObservableCollection: https://support.syncfusion.com/kb/article/15943/
• DropDownList in DropDownMenu popup: https://support.syncfusion.com/kb/article/15053/
• Custom doughnut chart hole view: https://support.syncfusion.com/kb/article/14060/
• Dynamic markers in Maps: https://support.syncfusion.com/kb/article/14780/
• HeatMap color customization: https://support.syncfusion.com/kb/article/14558/

ASP.NET Core KB Articles

• Detect blank PDF pages: https://support.syncfusion.com/kb/article/22713/
• Extract.p7m PDF content: https://support.syncfusion.com/kb/article/18720/
• Digital signature in rotated PDFs: https://support.syncfusion.com/kb/article/18963/
• Rich Text Editor toolbar on focus: https://support.syncfusion.com/kb/article/19910/
• Multi-page PDF Grid margins: https://support.syncfusion.com/kb/article/18800/
• Auto-fit text in PDF Grid cells: https://support.syncfusion.com/kb/article/18787/

Documentation References

• Blazor introduction: https://blazor.syncfusion.com/documentation/introduction
• Blazor API reference: https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.html
• ASP.NET Core JS2 API: https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.Data.html
• Blazor MCP server docs: https://blazor.syncfusion.com/documentation/ai-coding-assistant/mcp-server