组件/Chart Colors 图表色板

Chart Colors 图表色板

分类、语义、顺序与地图色板,CSS 变量随主题切换

Verified自 0.1.0

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。