SuperAPI AI 工具集

sgds-utilities-text-color

通用与其它

查看项目

更新于 10-15 21:54

技能介绍

用途:为 SGDS 界面中的文本应用主题感知与语义化颜色,统一内容层级、状态与品牌表达。

主要能力:所有工具类遵循 sgds:text-{variant}-{modifier} 模式,带 sgds: 前缀。颜色默认随日间/夜间主题自动切换,除非使用固定变体。令牌分三类:语义基础色(text-default、text-subtle、text-muted、text-inverse、text-fixed-light、text-fixed-dark);上下文色(primary、accent、success、danger、warning、purple、cyan、neutral,各含 default、emphasis、fixed-light、fixed-dark);排版角色色(display-default、heading-default、body-default、body-subtle、label-default、link-default、link-emphasis)。

使用方式:先完成 sgds-utilities-setup 技能中的必要设置;文本颜色工具需要同时引入工具 CSS 与主题文件 day.css、night.css 才能实现主题感知。按需选择令牌,例如正文用 sgds:text-default 或 sgds:text-subtle,反色表面用 sgds:text-inverse,固定深色背景用 sgds:text-fixed-light,固定浅色背景用 sgds:text-fixed-dark,标题用 sgds:text-heading-default,表单标签用 sgds:text-label-default,链接用 sgds:text-link-default 或 sgds:text-link-emphasis,状态消息用 sgds:text-{success|danger|warning}-default。后缀修饰符(default、emphasis、muted、fixed-light、fixed-dark、inverse、surface)的语义见 utilities-color-semantics。

适用场景:结构化内容优先使用排版角色令牌;通用文本层级使用语义基础令牌;状态或品牌含义使用上下文色。存在 SGDS 组件(<sgds-*>)时优先使用组件。

限制:未提供具体颜色值、浏览器兼容范围与版本要求;需先满足前置设置与主题文件依赖。