SuperAPI AI 工具集

sgds-utilities-color-semantics

通用与其它

查看项目

更新于 10-15 21:54

技能介绍

该技能是 SGDS Web Component 中颜色工具类的共享定义,用于统一 background-color、border-color、text-color 等工具的后缀修饰符语义。

用途:当需要澄清颜色 token 后缀含义时使用,确保各颜色工具用法一致。

语义色分类:primary(品牌色,强调与身份)、accent(信息与链接,中性无紧迫感)、success(正向反馈与完成)、danger(错误与破坏性操作)、warning(警示需注意)、purple 与 cyan(仅作视觉变化,无语义)、neutral(同等重要,不作区分)。当 primary 与 accent 相近需要第三种可区分颜色,或需交替配色但不暗示优先级时,可使用 purple、cyan。

强调修饰符(适用于所有语义色 token):default 为平衡的标准外观,用于常见状态与高频元素;emphasis 为强、高可见度外观,用于需吸引注意、激活状态、行动号召与高优先信号;muted 为弱化、低调外观,用于次要信息、非激活状态或低优先指示。强调程度由弱到强为 muted → default → emphasis。

主题行为修饰符:fixed-light 始终为浅色,不随主题变化,适用于必须保持浅色表面的区域;fixed-dark 始终为深色,适用于页脚或主视觉等不反转区域;inverse 取当前主题的反色,浅色模式下呈深色、深色模式下呈浅色,用于需要高对比突出的元素。

透明度修饰符:translucent 半透明,用于按钮或交互元素的悬停/激活叠加层以及图片、渐变之上的元素;transparent 完全不可见但占位,用于需要与填充变体保持尺寸一致的轮廓型组件。

背景专属修饰符:alternate 为页面级第二背景,与 default 交替使用以形成视觉节奏;overlay 为全屏背景,仅用于模态、抽屉与对话框遮罩,不应作用于组件;surface 表示组件级作用域,含 surface 的背景 token 作用于组件(卡片、徽章、面板、输入框),不含者作用于页面区块。border 与 text 的 token 不使用 surface。

限制:资料未提供具体安装命令、代码示例或版本信息。