Chart Colors 图表色板
分类、语义、顺序与地图色板,CSS 变量随主题切换
API 参考
ChartPalette
| 方法 | 返回 | 说明 |
|---|---|---|
categorical(index, isDarkMode?) | string | 第 index 位分类色(模 6 回绕)。 |
categoricalVar(index) | string | 同一位次的 var(--tx-chart-categorical-N, #hex) 引用,跟随主题。 |
semantic(name, isDarkMode?) | string | 语义色,name 为 'Attention' 等六个之一。 |
sequential('blues', isDarkMode?) | string[] | 顺序色板五档(每次返回新数组)。 |
text('primary' | 'secondary', isDarkMode?) | string | 轴与标签文本色。 |
mapColors(isDarkMode?) | MapColors | { area, bubble, scale[] } 地图配色。 |
CSS 变量
| 变量 | 说明 |
|---|---|
--tx-chart-categorical-1..6 | 分类色板。 |
--tx-chart-semantic-attention/-warning/-success/-neutral/-disabled/-skeleton | 语义色。 |
--tx-chart-sequential-blues-1..5 | 顺序色阶。 |
--tx-chart-text-primary/-secondary | 文本色。 |
--tx-chart-grid-line | 网格线(主文本色 20% 透明度)。 |
--tx-chart-map-area / --tx-chart-map-scale-1..5 | 地图陆地与分级色阶。 |
--tx-skeleton-base-color | 加载占位的底色,指向 --tx-chart-semantic-skeleton。 |
--tx-chart-marker-label-bg | 标记与阈值标签的底色光晕,暗色下换值。 |
所有变量都有亮色默认值,不接宿主主题也能正确渲染;宿主想换品牌色时覆盖变量即可,组件零改动。
双轨取色
图表组件内部只读 --tx-chart-* CSS 变量,.dark 或 [data-theme='dark'] 下自动换成暗色值——所以没有 isDarkMode prop。ChartPalette 则给包外场景(周边 UI 对色、导出图片、canvas)提供十六进制字面值,函数签名与 kumo 同名同形,同样带 isDarkMode 参数;categoricalVar() 是图表入口的扩展,直接返回主题变量的 var() 引用。
色板总览
分类 / 语义 / 顺序
切换站点主题可见变量自动翻转。
Loading demo...
三套色板
- 分类(categorical):6 色按序列位次轮转(模 6 回绕)——
#4290F0蓝、#F5B647黄、#E8649D粉、#8D58EE紫、#50C3B6青、#D37536橙;第 1 位蓝同时是全家族的锚色(顺序色阶与地图色阶的中档都是它)。暗色下只有黄换成#EEB720,其余五位与亮色完全一致。 - 语义(semantic):
Attention/Warning/Success/Neutral/Disabled/Skeleton,表达状态而非序列身份;暗色下 Neutral / Disabled / Skeleton 换值。 - 顺序(sequential):
blues五档,低→高;暗色是方向反转的一套(第 4 档为暗底单独调过,不是简单镜像)。
地图另有一套 --tx-chart-map-*(陆地底色 + 五档分级色阶),见 Maps。