SuperAPI AI 工具集

igniteui-wc-choose-components

前端与建站

查看项目

更新于 10-22 23:25

技能介绍

用途

本技能用于回答“某个 UI 需求应该用哪个 Ignite UI Web Components 组件”这类问题。AI 智能体和开发者可以借助它,把用户的 UI 描述映射到具体的组件,并获得官方文档、使用示例和 API 参考的链接。它属于组件选型环节,不直接负责编码实现。

前置条件与配置

使用前需要确保 Ignite UI CLI MCP 服务器(igniteui-cli)作为工具提供方可用。资料要求先调用 list_components;如果该工具不可用或调用失败,需要按 reference/mcp-setup.md 中的说明配置服务器,配置完成后告知用户服务器已配置,并说明可能需要重载编辑器以激活工具,然后启动 MCP 服务器,待其启动后再继续组件相关工作。VS Code、Cursor、Claude Desktop 和 JetBrains IDE 的配置步骤见 reference/mcp-setup.md。

主要能力

  • 通过 list_components({ framework: "webcomponents" }) 获取 300 多个文档条目,包括名称、摘要和是否为付费组件;可用 filter 关键词(如 input、grid、chart、nav、date、combo)缩小范围。
  • 通过 get_doc 获取指定组件的用法模式、HTML 示例和插槽。
  • 通过 get_api_reference 获取组件类的完整属性、方法和事件 API;如果不确定类名,可先用 search_api 查询。
  • 通过 search_docs 按功能关键词检索文档。
  • 按 UI 模式给出组件路由表,覆盖输入与表单、按钮与操作、日程与日期选择、通知与反馈、进度指示、布局与容器、导航、列表与数据展示、图表可视化、对话式 AI 等类别。
  • 给出常见场景的推荐组件组合,如登录表单、用户设置页、数据表格、预订表单、分析仪表板、通知流和聊天界面。
  • 说明“网格”类需求的选型原则:需要高级功能(编辑、分页、汇总、分组、层级数据、透视)时选 igniteui-webcomponents-grids;轻量表格选 igniteui-grid-lite。
  • 提示设置或代码需求可加载 igniteui-wc-integrate-with-framework,主题需求可加载 igniteui-wc-customize-component-theme,包体积优化可加载 igniteui-wc-optimize-bundle-size。

包与许可

资料列出各组件的包和许可:通用 UI 组件为 MIT,npm install igniteui-webcomponents;高级网格为商业许可,试用安装用 igniteui-webcomponents-grids,正式许可安装用 @infragistics/igniteui-webcomponents-grids;Grid Lite 为 MIT,npm install igniteui-grid-lite;Dock Manager 为商业许可;图表为商业许可,需安装 igniteui-webcomponents-core 与 igniteui-webcomponents-charts(或对应的 @infragistics 作用域包)。商业组件授权信息需查阅 Infragistics 官网或联系销售。

使用方式

典型流程为:先拆分 UI 模式,再映射到组件,然后确认所属包,接着用 get_doc / get_api_reference 查文档,最后给出最小可运行代码片段。资料也提示:写导入或安装步骤前先选定包;若 package.json 中没有该包,应先添加或安装正确依赖,不能据此认定包无效。

适用场景与限制

适用于新功能需求到组件的映射、用户描述 UI 模式后查找组件名、查看可用组件列表、获取特定组件官方文档或示例链接,以及现有 UI 变更后的重新选型。限制方面:技能本身不提供实现或主题定制,需转接相关技能;商业组件的价格与授权细节资料未提供;部分组件行为细节需以官方文档和 API 参考为准。