Croprix 品牌手册v1.2.0
13

界面与数据

产品界面、图表与标志动效共用同一套 token:状态不只靠颜色,序列色是固定身份,标志动效只有一种节奏。

13.1UI 组件

机器人控制屏、调度看板、网页与 App 只用组件库里的组件与状态,不另画。组件只引用 3.3 的语义角色,换主题时角色换值,组件本身不改。本节的组件标本直接由组件样式表渲染,点右上角的深色模式就能看到同一段代码的暗色版本。

全部组件、全部状态、可交互的版本见 组件预览;每个组件的变体、状态与可访问性清单见 界面组件规范。样式表 components.css 只引用 --cx-* 变量,接入时依次载入 token、字体与图标样式,最后载入它,页面根元素加 cx-ui 类。

通用规则

查看 亮色主题 Leaf-700 环 2 px 对 Sand-50 4.85:1 间隙 2 px 查看 暗色主题 Leaf-600 环 2 px 对 Navy-950 4.95:1 间隙 2 px

焦点环亮暗主题各用一档 Leaf,对页面底都 ≥ 3:1

暂停 复选框 可见 20 · 命中 44 小按钮 可见 32 · 命中 44 虚线框:扩展后的命中区,单位 px

命中区可见尺寸不足 44 px 时向外扩,命中区之间不重叠

采摘 ✓ Navy-950 字 4.95:1 · 任何字号 采摘 ✓ 白字只限大字 ≥ 18.66 px 且 700 3.14:1 ✕ 按钮默认 600 不够

Leaf-600 上的字默认 Navy-950;白字只用于大字

通用规则图解 · 放大 2 倍亮色底为 Sand-50,暗色底为 Navy-950
焦点环
所有可聚焦元素 2 px 实线,外扩 2 px。亮色主题用 Leaf-700(对 Sand-50 4.85:1),暗色主题用 Leaf-600(对 Navy-950 4.95:1);不写 outline: none。
触控目标
可点击元素 ≥ 44 × 44 px。可见尺寸不够的(小按钮 32、复选框与单选框 20、开关 24、分页 36、标签删除 20、关闭按钮 28–32)用扩展命中区补足,命中区之间不重叠。
对比度
文字 ≥ 4.5:1,大字、图标与描边 ≥ 3:1。主按钮上的字用 Navy-950;Leaf-600 上放白字只允许 ≥ 18.66 px 且字重 700,按钮默认的 600 不够。
状态
状态色只用成功、警告、错误、信息四个语义角色。状态不只靠颜色:错误与成功提示带图标,状态点带文字,表格选中行同时改字重或加勾。
键盘
按钮、链接、输入框、标签页、分页全部可用 Tab 到达;标签页用方向键切换;对话框打开后焦点留在框内,Esc 关闭,关闭后焦点回到触发按钮。
动效
文字、图标与描边颜色 120 ms;按钮背景、开关与退出 200 ms;进入 400 ms;系统开启“减弱动态效果”时过渡归零,加载指示与骨架屏静止。节奏见 8.2 界面动效。
方向
用逻辑方向(起始 / 结束)而不是左 / 右,从右向左书写的界面自动镜像,带方向的图标一起镜像。
22 个组件的尺寸与圆角

尺寸单位为 px;“圆”指全圆角。

组件类名尺寸与圆角
按钮.cx-btn高 32 / 40 / 48,左右 12 / 16 / 24 · 圆角 4
输入框
选择框
.cx-input
.cx-select
高 40(小 32、大 48),内边距 8 × 12 · 圆角 4
文本域.cx-textarea最小高 96,可竖向拉伸 · 圆角 4
复选框
单选框
.cx-check
.cx-radio
20 × 20,命中区 44 · 圆角 2 / 圆
开关.cx-switch40 × 24,滑块 18,命中区 44 · 圆
标签.cx-chip高 28,左右 12 · 圆
状态点.cx-status点径 8,后接文字 · 圆
徽章.cx-badge高 20,最小宽 20 · 圆
卡片.cx-card内边距 24 · 圆角 12;紧凑版 16 · 8
表格.cx-table单元格 8 × 12,紧凑版 4 × 8 · 外框圆角 8
导航栏.cx-navbar高 56,左右 24,标志高 28
标签页.cx-tabs项高 44,左右 12
面包屑.cx-breadcrumb链接高 32
分页.cx-pagination36 × 36,命中区上下各扩 4
提示条.cx-alert内边距 12 × 16,1 px 语义色描边 · 圆角 8
Toast.cx-toast宽 ≤ 360,内边距 12 × 16 · 圆角 8
对话框.cx-modal宽 ≤ 560 · 圆角 12
工具提示.cx-tooltip宽 ≤ 240,内边距 4 × 8 · 圆角 4
进度条.cx-progress高 8,细版 4 · 圆
骨架屏.cx-skeleton圆形 40,矩形高 120 · 圆角 4
空状态.cx-empty内边距 40 × 24,图标 40 · 圆角 12
机器人任务卡.cx-task内边距 16,类别图标 44 × 44 · 圆角 8

组件怎么用

颜色写的是 3.3 的语义角色名,亮暗两套值由 token 给出。

按钮

每页只有一个主按钮。危险按钮只用于不可逆操作,并用对话框二次确认。加载时文字隐去,显示旋转指示。

.cx-btn主 · 次 · 幽灵 · 危险,高 40 px

表单

输入框底用 bg-sunken,描边 1.5 px border-strong;聚焦时描边转 accent 并显示焦点环。错误与成功只改描边和提示的颜色,提示文字前带图标。单位写在框外作后缀;只读用虚线描边。

.cx-field错误态与成功态:只改描边与提示,提示前带图标

状态点与徽章

状态点五种:运行中 success、待命 fg-subtle、警告 warning、故障 danger、同步中 info,永远带文字。徽章只做计数。

.cx-status · .cx-badge状态点永远带文字,徽章只做计数

提示条与 Toast

提示条分信息、成功、警告、错误四级,各带图标。Toast 用反色底,在屏幕结束侧的下角堆叠,宽不超过 360 px。

.cx-alert · .cx-toast警告级提示条与成功 Toast

其余组件

卡片与表格
卡片用小阴影,可点击的卡片悬停时加深一级,选中用 accent 描边。卡片与提示条都不加起始侧色条,状态与级别交给状态点、图标、底色和文字。表格表头用 bg-sunken、小号字、拉丁字母大写并吸顶;数值列右对齐、等宽数字;数据说明与单位写在表题。
导航
导航栏与标签页的当前项用 2 px accent 下划线,不用填充块;分页的当前页用 brand 反白。
对话框
遮罩为 Navy-950 60%,打开时背景不可操作。
工具提示
只放说明,不承载操作。
进度与空状态
进度条的轨道用同色相浅色,并给出当前进度与名称。骨架屏 1.6 s 横向流动。空状态给一个主按钮作为下一步。
任务卡
状态交给状态点与进度条,卡片本身不带状态色;整张卡的无障碍名称概括机器人、作业与状态,例如“R-07,采摘第 12–18 行,运行中”。页首标本就是一张运行中的任务卡。

照片上的压图

界面横幅与封面照片上放白色标题或单色白主标时,叠一层 Navy-950 渐变:72% 不透明的一端保持一段平台,到 70% 处完全透明,文字与标志放在平台内。

background: linear-gradient(
  to top,
  rgb(0 38 65 / 72%) 28%,  /* Navy-950 */
  transparent 70%
);

带绿色叶标的反白主标放在作物暗部,把 to top 换成 to right。规则与实例见 6.6 照片上的标志与文字。

13.2数据可视化

做一张图分四步:先按读者要做的事选形式,再按含义配色,然后校验色弱与对比,最后画标记与数字。

选形式

读者要做的事默认形式与配色
看趋势折线;单序列可用面积,填充 10%
单序列 Navy;作物用 Leaf,环境用 Sky
比大小条形,类别名长或 ≥ 6 类时横放;二维网格用热力图
同一序列同色;量级用顺序色阶
看构成堆叠柱或条;≤ 5 片且只看大概时可用饼或环
序列色,含义固定
看分布直方图、箱线图、点带图
单序列 Navy
看关系散点,≤ 3 个分类并配形状
≤ 3 个序列色
看偏离目标发散条、相对基线的折线
发散色阶 Sky ↔ Harvest
读单个数字统计块:数值、变化、迷你折线
变化方向用成功 / 错误色
读精确值表格:≥ 7 类都要读值、要精确值或混合单位时
不再加颜色

配色

六个序列色、亮暗两套值与各自代表的对象都在 3.5 图表序列 定义,这里只讲图表里怎么用。下面这组序列柱与 3.5 是同一组件,随主题切换。

  • 1 设备
    Navy
  • 2 作物
    Leaf
  • 5 其他
    Soil
  • 4 环境
    Sky
  • 3 警告
    Harvest
  • 6 错误
    Crimson

编号是固定身份:筛选后剩下的序列不重新上色,也不生成第七种颜色。

单序列一律 Navy,除非序列本身是作物(Leaf)或环境(Sky)。强调式常常比多色更清楚:要讲的那个序列用它的颜色,其余用 Sand-300(暗色 Sand-700)。堆叠、分组与多折线 ≤ 4 个序列,散点 ≤ 3 个;再多就合并成“其他”、拆成小图或改用表格。

量级用 Leaf 顺序色阶 50 → 900,最浅一档只做零值或缺失,有值的最浅档从 Leaf-200 起,相邻两档明度要拉得开,档数不超过 7。正负与偏离目标用 Sky ↔ Harvest 发散色阶,中点 Sand-100(暗色 Sand-700);不用 Leaf 或 Crimson 做两极,那会被读成“好 / 坏”。

色弱与对比

  • Leaf 与 Harvest、Soil 与 Harvest、Soil 与 Crimson 不得相邻:堆叠段、并列条、贴近的折线都算相邻。四个以内序列按 Navy → Leaf → Sky → Harvest 排;暗色下 Navy 与 Sky 明度接近,也不相邻。
  • 同一张图有两个以上序列时,同时给图例与直接标注,不只靠颜色区分。
  • 序列色对图表底都 ≥ 3:1:亮色值对白底与 Sand-50 至少 3.6:1,暗色值对 Navy-900 至少 5.6:1。
  • 格内写数值的色块:Leaf-700 及更深用白字,Leaf-600 及更浅用 Leaf-950;这类热力图亮暗主题用同一色阶。

标记与数字

条与柱 ≤ 24 px 粗,数据端 4 px 圆角,段间留 2 px 底色间隙,不描边;线 2 px;点直径 ≥ 8 px,带 2 px 底色环;面积填充 10% 不透明度。网格线 1 px 实线,用边框色(亮色为 Sand-200),只画 3–5 条。不用 3D,不用渐变。

只标末点、极值和要讲的那一个序列,标注用文字色,不用序列色。千位用逗号,同列同小数位,等宽数字;单位写在轴头或列头,不跟在每个数后。

3 号温室温度 · 24 小时折线:0 点到 24 点每小时一个观测点,单位 °C。最低 17.8(03:00),最高 27.1(12:00),24:00 为 18.5;22 到 26 °C 为目标区间。示意数据。 示意 3 号温室温度 · 24 小时 目标区间 22–26 14 18 22 26 30 °C 00:00 04:00 08:00 12:00 16:00 20:00 24:00 27.1 17.8 18.5
折线 · 温度属于环境,用 Sky;只标极值与末点,目标区间用中性底带示意数据
采摘完成率 · 区域 × 时段热力图:A 到 F 六个区在 06 到 18 点六个两小时时段的采摘完成率,单位 %,颜色越深完成率越高,格内写数值。最低 38(B 区 16–18),最高 92(A 区 06–08)。示意数据。 示意 采摘完成率 · 区域 × 时段 A 区 B 区 C 区 D 区 E 区 F 区 06–08 08–10 10–12 12–14 14–16 16–18 92 88 76 64 58 41 85 90 82 70 52 38 78 84 88 74 60 45 66 72 80 86 71 50 54 61 70 82 88 63 40 47 58 69 81 90 完成率 % ≥ 85 75–84 65–74 55–64 45–54 < 45
热力图 · Leaf 顺序色阶六档,格内写值;深格白字、浅格深字,亮暗主题同一色阶示意数据

标题写名词 + 时间范围,单位写在轴头:3 号温室温度 · 24 小时(°C 写在 y 轴头)。

示意数据加“示意”标签;空值断开,不画成 0。

每张网页图表都能切换到同一数据的表格。

3D、阴影、渐变填充;双 y 轴;y 轴不从 0 起的柱状图。

饼图超过 5 片;按数值给无序类别上色;彩虹色阶。

只能靠悬停提示才读得到的值。

折线、条形、堆叠柱、面积、热力图、表格六个示例与亮暗切换见 图表示例,全部规则见 数据可视化规范。幻灯片、Excel 与 Python 从 配色文件 palette.json 取色值,亮暗各一套。

13.3标志动效接入

文件清单、使用场合与片头片尾规格见 8.3 标志动效,这里只写接入:网页、App、剪辑与幻灯片各自怎么放,以及系统开启“减弱动态效果”时怎么处理。接入时要照顾三种情况:

  • 动效播放到 0.56 秒:根部接上,叶片从根部长到大半
    默认 · 播放一次载入后播放 1.25 s,停在完整标志
  • 完整主标,不播放动画
    减弱动态效果 · 0 ms系统开启时不播放,直接显示完整标志
  • 叶标按 32 px 原大渲染叶标按最小尺寸 16 px 原大渲染
    宽不足 96 px · 叶标不用主标也不播放,改用叶标(symbol),≥ 16 px图为 32 px 与 16 px 原大

网页

首屏用 <img> 载入 动画 SVG,CSS 动画在载入时播放一次;文件里已经写好“减弱动态效果”的处理,不用另加脚本。单页应用切换路由后要重播时,改用内联 SVG 并重新插入节点。首屏以外一律用静态 croprix-logo.svg。

<img src="/assets/motion/croprix-logo-animated.svg"
     alt="Croprix" width="240" height="97">

App 与小程序

用 Lottie 文件 croprix-logo.json,自动播放、不循环。系统开启“减弱动态效果”时不播放,直接停在最后一帧:iOS 读 UIAccessibility.isReduceMotionEnabled,Android 看 ANIMATOR_DURATION_SCALE 是否为 0,网页读 prefers-reduced-motion。

const reduce = matchMedia("(prefers-reduced-motion: reduce)").matches;
const anim = lottie.loadAnimation({
  container, renderer: "svg", path: "croprix-logo.json",
  autoplay: !reduce, loop: false,
});
if (reduce) anim.addEventListener("DOMLoaded", () =>
  anim.goToAndStop(anim.totalFrames - 1, true));

剪辑与幻灯片

视频。MP4 与透明 WebM 只含 1.25 s 出标段。做片头时在剪辑软件里把末帧延长 0.75 s,整段 2.0 s 后切入正片;做片尾时把 Navy-900 底版本的末帧定格 3 s,网址按 8.3 加。

幻灯片。只在封面页插入。PowerPoint 在“播放”选项卡把“开始”设为“自动”,不勾“循环播放,直到停止”和“播完返回开头”;Keynote 在“影片”设置里把“重复”设为“无”。这样播完停在末帧。

剪辑时间线实色是文件自带的动画,虚线框是剪辑时加的定格