用途:本技能面向 .NET 8+ 的 Blazor 项目(Server、WebAssembly、Web App 或 MAUI Blazor Hybrid),说明如何使用 Ignite UI for Blazor 的非网格 UI 组件,包括应用配置、表单控件、布局、数据展示、反馈、可视化与布局管理器。本身是路由中枢,不含组件示例与 API 细节,需按任务读取对应参考文件并调用 MCP 文档工具获取真实注册方式与 Razor 标记。
主要能力覆盖:表单控件(Input、Combo Box、Select、Date Picker、Date Range Picker、Calendar、Date Time Input、Mask Input、Checkbox、Radio/Radio Group、Switch、Slider/Range Slider、Rating 及值绑定);布局(Tabs、Stepper、Accordion、Expansion Panel、Navigation Drawer、Navbar、Tree);数据展示(List、Card、Carousel、Avatar、Badge、Chip、Icon、Button、Button Group、进度条、Dropdown、Tooltip、Ripple);反馈(Dialog、Snackbar、Toast、Banner);布局管理器(Dock Manager 与 Tile Manager);图表(Category/Data/Financial/Pie/Donut/Sparkline、Treemap、Geographic Map、Gauges 等)。
必要用法:在 Program.cs 调用 builder.Services.AddIgniteUIBlazor(...),在 _Imports.razor 添加 @using IgniteUI.Blazor.Controls,并在宿主页链接主题 CSS 与 _content/IgniteUI.Blazor/app.bundle.js,且该脚本须位于 Blazor 框架脚本之前。每个组件及其子组件对应模块,需显式注册,例如 builder.Services.AddIgniteUIBlazor(typeof(IgbComboModule), typeof(IgbDatePickerModule));无参调用会注册全部模块但增大包体。通过 @ref 从 C# 访问组件,部分组件(如 IgbIcon)需先 await component.EnsureReady()。
包变体:IgniteUI.Blazor.Lite 与 IgniteUI.Blazor.GridLite 为 MIT、来自 NuGet.org;IgniteUI.Blazor 为授权版,来自 Infragistics 私有源;IgniteUI.Blazor.Trial 为试用版。不要在同一项目混用授权包与 Lite。
适用场景:需要快速在 Blazor 中集成企业级 UI 组件与图表的开发者。
限制:许多组件(如 IgbCombo、IgbRadio)不支持标准 HTML form,需按文档显式绑定值;组件 API 随版本变化,禁止凭记忆书写属性或事件,若参考文件与 MCP 文档未覆盖,应明确说明而非猜测。具体主题、CLI MCP 配置细节以各参考文件为准。