---
url: /guide/palette.md
---
# 主题配色

图表默认跟随宿主主题：渲染时从 `--ev-*` 令牌取色，换主色、切暗色、换肤都自动重绘。需要锁死视觉时用内置色系——`options.palette` 填一个色系 id，整图系列色立即固定：之后宿主改样式变量、换主色都不再影响这张图；明暗两套色值由色系自带，随暗色模式换挡。

## 一键试色

点按钮即切色系，「跟随主题」恢复默认的令牌取色。五个系列正好看到色系前五槽的搭配。

选中色系后这张图的配色就固定了——去[主题接入](/guide/theme)里换主色试试，选了色系的图不会跟着变。

## 色系总览

七套色系按叙事场景选：科技产品选极光，消费营销选落日，人文报告选莫兰迪，健康环保选林间，金融年报选墨蓝，活动大屏选糖果。

## 优先级与固定边界

* 取色优先级：`theme.colors`（手工数组，最高）> `palette`（内置色系，固定）> 令牌跟随（默认）；
* `palette` 固定的是**数据系列色**：网格线、轴文字、标题等结构色仍随宿主明暗，保证任何背景下可读；个别元素要钉死可用 `theme` 显式覆写；
* 每套色系自带浅 / 暗两组（暗色同色相提亮），换挡由图表内部完成，不依赖宿主变量；
* 用 [AI 生成](/guide/ai)时，需求里写明「固定配色 / 不随主题变化」即会带上色系选项。

## API

## 相关

* [主题接入](/guide/theme)（默认的令牌跟随与暗色）
* [设计规范](/guide/design)（色板验收规则）
* [AI 生成](/guide/ai)（数据与需求直接出图）