13.1UI 组件
机器人控制屏、调度看板、网页与 App 只用组件库里的组件与状态,不另画。组件只引用 3.3 的语义角色,换主题时角色换值,组件本身不改。本节的组件标本直接由组件样式表渲染,点右上角的深色模式就能看到同一段代码的暗色版本。
全部组件、全部状态、可交互的版本见 组件预览;每个组件的变体、状态与可访问性清单见 界面组件规范。样式表 components.css 只引用 --cx-* 变量,接入时依次载入 token、字体与图标样式,最后载入它,页面根元素加 cx-ui 类。
通用规则
焦点环亮暗主题各用一档 Leaf,对页面底都 ≥ 3:1
命中区可见尺寸不足 44 px 时向外扩,命中区之间不重叠
Leaf-600 上的字默认 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-switch | 40 × 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-pagination | 36 × 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。
东区 92% RH,超过设定上限 85%。
.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 小时(°C 写在 y 轴头)。
示意数据加“示意”标签;空值断开,不画成 0。
每张网页图表都能切换到同一数据的表格。
3D、阴影、渐变填充;双 y 轴;y 轴不从 0 起的柱状图。
饼图超过 5 片;按数值给无序类别上色;彩虹色阶。
只能靠悬停提示才读得到的值。
折线、条形、堆叠柱、面积、热力图、表格六个示例与亮暗切换见 图表示例,全部规则见 数据可视化规范。幻灯片、Excel 与 Python 从 配色文件 palette.json 取色值,亮暗各一套。
13.3标志动效接入
文件清单、使用场合与片头片尾规格见 8.3 标志动效,这里只写接入:网页、App、剪辑与幻灯片各自怎么放,以及系统开启“减弱动态效果”时怎么处理。接入时要照顾三种情况:
- 默认 · 播放一次载入后播放 1.25 s,停在完整标志
- 减弱动态效果 · 0 ms系统开启时不播放,直接显示完整标志
- 宽不足 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 在“影片”设置里把“重复”设为“无”。这样播完停在末帧。