SuperAPI AI 工具集

update-component-styles

前端与建站

查看项目

更新于 10-15 22:17

技能介绍

用途:该技能用于修改 Ignite UI Web Components 中已有组件的外观样式,遵循项目的 SCSS 工作流与主题系统。适用于用户要求调整组件外观、增改 CSS 样式、更新主题专属样式或新增 CSS 自定义属性时。

主要能力:按组件目录组织样式文件,区分基础结构样式(themes/[component].base.scss)、跨主题共享样式(themes/shared/*.scss)、各主题文件(bootstrap、material、fluent、indigo)以及明暗模式覆盖文件(themes/light、themes/dark)。支持通过 CSS Parts 暴露可外部样式化的部件,并通过 CSS 自定义属性提供可定制值。

使用方式:先确认组件名、样式改动内容、作用范围(基础、主题专属或两者)以及是否涉及 CSS Parts。按决策树选择要编辑的 SCSS 文件;结构性改动编辑 base.scss,主题无关样式编辑 shared 文件,主题专属样式编辑对应主题文件,明暗变体编辑 light/dark 文件。新增 CSS Parts 时需同步更新 render 方法与 JSDoc 的 @csspart 注释;新增自定义属性需在 JSDoc 中用 @cssproperty 记录。编辑后运行 npm run build:styles 将 SCSS 转译为 .css.js,再用 npm run storybook 手动验证各主题与明暗模式,必要时补充自动化测试。

限制与注意:不要直接编辑 .css.js 文件,否则下次构建会被覆盖;编辑 SCSS 后必须转译,否则改动不生效;避免硬编码颜色,应使用 igniteui-theming 的 color()、theme() 等函数;选择器特异性应保持较低以便用户覆盖;组件需设置合适的 :host display 值。资料未提供具体版本、安装步骤或收费信息。