Croprix 数据可视化规范 v1.2.0
适用于产品界面、销售与客户材料、手册与报告里的一切图表。颜色只从 tokens/dist/tokens.css 取(网页用 --cx-* 变量,其他工具用 palette.json 的 hex);方法遵循"先选形式、再按用途配色、校验、再画标记"的顺序。示例见 examples.html(6 个内联 SVG,亮/暗切换)。
line-example.png折线 · 温度属环境,用 sky · 只标极值与末点 · 亮色line-example-dark.png折线 · 温度属环境,用 sky · 只标极值与末点 · 暗色1. 先选形式:图表类型选择表
| 读者要做的事 | 默认形式 | 配色任务 | 不要用 |
|---|---|---|---|
| 趋势(随时间变化) | 折线;单序列可用面积(填充 10%) | 单序列 navy;多序列分类色 | 双 y 轴、平滑样条 |
| 对比(大小高低) | 条形(类别名长或 ≥ 6 类用横向);网格用热力图 | 单序列同色 navy;量级用顺序色 | 饼图、3D、按数值给条上色 |
| 构成(部分与整体) | 堆叠柱/条;≤ 5 片且只看大概时可用饼/环 | 分类色,语义固定 | 饼 > 5 片、堆叠面积图 > 4 层 |
| 分布(值怎么散布) | 直方图、箱线、点带图 | 单序列 navy | 平滑密度曲线冒充直方图 |
| 关系(两个量怎么关联) | 散点(≤ 3 个分类)、连接散点 | ≤ 3 分类色 + 形状 | 气泡面积表示第 4 维、拟合线无置信区间 |
| 偏离目标 / 正负 | 发散条、相对基线折线 | 发散色阶 sky ↔ harvest | 用红绿表示正负 |
| 单个数字 | 统计块(值 + 变化 + 迷你折线),不是图表 | 变化方向用 success/danger | 一根柱的柱状图、两片饼 |
| ≥ 7 类都要读值 / 多单位 / 精确值 | 表格(见 §6) | — | 再加颜色 |
2. 序列色:顺序与语义
--cx-color-chart-1…6 的编号是身份,不按出场顺序轮换。同一实体在所有图表里颜色不变;筛选后剩余序列不重新上色。
| 序号 | 变量 | 色相 | 语义(固定) | 亮色 | 暗色 |
|---|---|---|---|---|---|
| 1 | --cx-color-chart-1 |
navy | 设备 / 机器人;单序列默认 | navy.700 | navy.400 |
| 2 | --cx-color-chart-2 |
leaf | 作物 / 产量 / 作业进展 | leaf.700 | leaf.400 |
| 3 | --cx-color-chart-3 |
harvest | 告警(警告级)、成熟、能耗 | harvest.600 | harvest.400 |
| 4 | --cx-color-chart-4 |
sky | 环境(温、湿、光、CO₂、EC) | sky.600 | sky.300 |
| 5 | --cx-color-chart-5 |
soil | 基质 / 硬件 / "其他" | soil.600 | soil.400 |
| 6 | --cx-color-chart-6 |
crimson | 告警(错误级),只做告警、不做普通序列 | crimson.600 | crimson.400 |
- 单序列一律 navy(chart-1),除非序列本身是作物(leaf)或环境(sky)语义。
- 强调式:一个序列用其语义色,其余用
--cx-color-sand-300(暗:sand.700)。这常常比多色更清楚。 - 序列数上限:堆叠/分组/多折线 ≤ 4;散点、气泡、地图 ≤ 3;再多就折成"其他"、拆小图或改表格。
- 相邻规则(色弱校验结果):按 OKLab ΔE 与 Machado 2009 色弱模拟跑过全部两两组合:navy↔leaf 21、navy↔harvest 22、navy↔crimson 15、leaf↔sky 17、sky↔harvest 17 通过;leaf↔harvest 仅 2.6、soil↔crimson 0.4、soil↔harvest 4.8 不通过。因此堆叠段、并列条、贴近的折线里 leaf 与 harvest 不得相邻,soil 不与 harvest / crimson 相邻;相邻顺序按 navy → leaf → sky → harvest 排。凡是同图 ≥ 2 序列,必须同时有图例 + 直接标注(或形状/纹理),不能只靠颜色。
- 状态色(success / warning / danger / info)只表示状态,配图标与文字;当序列本身就是"好/坏"(合格率、故障率)用状态色,否则用序列色,不混用。
顺序色阶(量级)
一个色相 leaf:50 → 900 由小到大。热力图、地图 ≤ 7 档;最浅一档只做"零/缺失"底,有值的最浅档从 leaf.200 起(leaf.50/100 对白底对比 < 1.2:1,看不出边界);相邻两档的明度要拉开,leaf.500 与 leaf.600 的 L* 只差 3.6,不同时用——下图六档取 200 / 300 / 400 / 600 / 700 / 800,图例由高到低排。格内写值:leaf.700 及更深用白字,leaf.600 及更浅用 leaf.950。暗色模式:带格内数值的热力图保持同一色阶(每格是独立的面,读的是格内数字与深浅顺序);无标签的面填充(地图、区域带)改为反向 900 → 50,让"多"仍然是与底色反差最大的一端。见下图与 examples.html 的热力图。
发散色阶(正负 / 偏离目标)
sky(冷,低于目标/负)↔ harvest(暖,高于目标/正),中点 sand.100(暗:sand.700)中性;两臂档数相等(各 4 档)。不用 leaf / crimson 做两极(会被读成"好/坏")。
3. 标记与图表元素
| 元素 | 规则 |
|---|---|
| 条 / 柱 | 粗 ≤ 24 px;数据端 4 px 圆角,基线端方角;从同一基线生长;相邻条/堆叠段之间 2 px 底色(bg-raised)间隙,不描边 |
| 线 | 2 px,圆头圆角;≤ 4 条;交叉处点位加 2 px 底色环 |
| 点 | 直径 ≥ 8 px(r ≥ 4),填序列色,2 px 底色环 |
| 面积 | 序列色 10% 不透明度,不做渐变 |
| 网格线 | --cx-color-border 1 px 实线,只画 y 向 3–5 条;不画虚线 |
| 轴 | 基线 --cx-color-border-strong 1 px;刻度文字 11 px --cx-color-fg-muted;y 轴刻度取整数(0 / 500 / 1,000) |
| 标签 | 只标末点、极值、要讲的那一个序列;不给每个点写数;文字永远用文字色(fg / fg-muted),不用序列色写字 |
| 图例 | ≥ 2 序列必有;放左上,一行;单序列不放图例,标题说明即可 |
| 标题 | 名词短语 + 单位 + 时间范围:"3 号温室 温度 · 24 小时";示意数据加"示意"标签 |
| tooltip | 网页图表默认带:折线/面积用十字线 + 当列全部序列的值;条/点/格逐个 hover;命中区 ≥ 24 px;键盘焦点显示同样内容;SVG 静态图用 <title> |
| 空值 | 折线断开不连;条留空并在 tooltip 写"无数据";表格用 —;不画成 0 |
| 数字 | 千分位逗号 1,240;小数按量纲固定位数(温度 1 位、kg 整数、% 整数);单位写在轴头或列头,不跟在每个数后;轴/表/标注用 font-variant-numeric: tabular-nums,统计块大数用比例数字 |
| 暗色模式 | 序列色自动切到暗色档(tokens 已定义);底 bg-raised;网格 border;无标签的顺序填充反向;发散中点换 sand.700;每张图两种模式都要看一遍 |
4. 禁止
- 3D、透视、阴影、渐变填充、发光。
- 饼图 > 5 片;环图中间放大数字以外的内容;两片饼(用统计块)。
- 双 y 轴;y 轴不从 0 起的柱状图;截断轴不加标记。
- 按数值给无序类别上色;彩虹色阶;用 leaf/crimson 表示正负。
- 生成第 7 种序列色;筛选后重新上色。
- 只靠 tooltip 才能读到的值;只靠颜色区分的序列或状态。
- 在图表里写口号或结论性形容词(品牌语调"平实")。
5. 输出与工具
- 网页 / 产品:SVG 或 Canvas,颜色一律
var(--cx-color-…);examples.html是参考实现。 - PPT / PDF / 印刷:从
palette.json取 hex(categorical.light、sequential.light、diverging.light),底色surface(页面底 =color.bg:亮 sand.50、暗 navy.950)或surfaceRaised(卡片底:白 / navy.900)。 - Python / R / Excel:把
palette.json的数组设为默认循环色;Excel 主题色顺序 = chart-1…6。 - 纹理:色弱/黑白打印/
forced-colors场景可加 45° / 135° 细斜线纹理(同色相深一档),默认不开。 - 校验:新配色组合在亮暗两种模式下都按 OKLab ΔE + 色弱模拟校验;不通过的组合不能上线,临界的必须加直接标注。
6. 表格作为图表替代
满足任一条件就用表而不是图:≥ 7 个类别都要读;读者要精确值;混合单位;要按列排序或复制。规则:
- 数值列右对齐、
tabular-nums、同列同小数位;单位放列头("作业时长 h")。 - 文本列左对齐;状态列用状态点 + 文字。
- 表头
bg-sunken小型大写;斑马纹用bg-sunken;行 hoveraccent-soft。 - 空值
—;合计放<tfoot>;数据说明与时间范围放<caption>。 - 每张图都应能切换到同一数据的表格视图(可访问性等价物)。
文件
| 文件 | 说明 |
|---|---|
palette.json |
categorical / sequential / diverging / status,亮暗各一,hex 与 tokens 一致 |
examples.html |
折线、条形、堆叠柱、面积、热力图、表格,六个示例(示意数据) |
line-example.png / heatmap-example.png |
折线、热力图各一张的静态渲染(@2x,亮色;另有 -dark 暗色版) |



