Croprix 品牌手册规范文件

品牌手册 · 下载 · 数据可视化规范

Croprix 数据可视化规范 v1.2.0

适用于产品界面、销售与客户材料、手册与报告里的一切图表。颜色只从 tokens/dist/tokens.css 取(网页用 --cx-* 变量,其他工具用 palette.json 的 hex);方法遵循"先选形式、再按用途配色、校验、再画标记"的顺序。示例见 examples.html(6 个内联 SVG,亮/暗切换)。

折线示例:3 号温室 24 小时温度,只标最低 17.8、最高 27.1 与末点,22–26 °C 目标区间为中性淡带(示意数据),亮色
line-example.png折线 · 温度属环境,用 sky · 只标极值与末点 · 亮色
折线示例:3 号温室 24 小时温度,只标最低 17.8、最高 27.1 与末点,22–26 °C 目标区间为中性淡带(示意数据),暗色:序列色切到暗色档,底为 navy.950
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

顺序色阶(量级)

一个色相 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 的热力图。

热力图示例:六个区六个时段的采摘完成率,Leaf 顺序色阶,格内写数值(示意数据),亮色
heatmap-example.png热力图 · Leaf 顺序色阶 · 格内写值 · 亮色
热力图示例:六个区六个时段的采摘完成率,Leaf 顺序色阶,格内写数值(示意数据),暗色:序列色切到暗色档,底为 navy.950
heatmap-example-dark.png热力图 · Leaf 顺序色阶 · 格内写值 · 暗色

发散色阶(正负 / 偏离目标)

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. 禁止

5. 输出与工具

6. 表格作为图表替代

满足任一条件就用表而不是图:≥ 7 个类别都要读;读者要精确值;混合单位;要按列排序或复制。规则:

文件

文件 说明
palette.json categorical / sequential / diverging / status,亮暗各一,hex 与 tokens 一致
examples.html 折线、条形、堆叠柱、面积、热力图、表格,六个示例(示意数据)
line-example.png / heatmap-example.png 折线、热力图各一张的静态渲染(@2x,亮色;另有 -dark 暗色版)