# WMS 工作台(wms_worker_station) ## UI 排版规范(全站强约束) > 一句话:**布局用 rem(1rem = 100px),间距用 5px 网格;控件高度 36px,行高两档,字号 10 档,圆角 3 档,控件内嵌图标取控件高度的 55~60%。** > 新增页面/组件照此写;改动旧页面时按本节重新排一遍。 > 页面级结构与自查见 **第 14 节**;真机平台注意见 **第 13 节**。 ### 1. 尺寸基数:1rem = 100px - 唯一实现 `src/render-common/rem-base.js`:`html.fontSize = 100 × min(1, 视口宽 / 1280)` - **宽度 ≥1280 一律 1rem = 100px**(1280 / 1920 / 2560 / 4K 都一样,也不看窗口高度); - 窄于 1280 等比缩小,下限 50px(640 宽)。 - 口径:**CSS 里的 rem 值 = 设计稿像素 ÷ 100**(写 `0.5rem` 就是 50px)。 - 真机 APP-PLUS 由 `App.vue` 的 `html { font-size: 7.8125vw !important }` 承担;`7.8125vw = 100/1280`,**必须精确,不要取整**。 - **小数位最多 2 位**(2 位 = 1px 精度,误差 ≤0.5px),`0.20` 写成 `0.2`。 - **媒体查询里不要用 rem 写断点**:媒体查询中的 `rem` 按**初始 16px** 解析,与本项目 1rem = 100px 不是一套(例如写 `20.48rem` 实际是 327px,永远不会触发)。 本项目**不需要窄屏断点**:宽度 <1280 时整站按比例缩放(下限 0.5 倍 = 640px 宽);桌面窗口由 `electron/main.js` 的 `minWidth: 1024` / `minHeight: 640` 兜底。 如需新增断点,写**真实 px** 并注明理由。 ### 2. 控件高度 / 行高 | 类型 | rem | ≥1280 时 | 用途 | |---|---|---|---| | 控件 | `0.36rem` | 36px | **按钮、输入框、下拉、tab、步进按钮全部统一这一档** | | 表格/列表行 | `0.5rem` 左右 | 50px | 表格行、列表行(订单表格实为 `0.52`/`0.56rem`,以内容为准) | | 顶栏 | `0.7rem` | 70px | 顶栏高度,内行由 `0.5rem` 的 logo 决定 | - **控件不要再写 `0.5rem` 高度**(2026-09-25 已全站从 0.5rem 降到 0.36rem);`80px`/`120px` 是移动端口径,PC 上更不要用。 - 图标、图片、头像、缩略图等**非控件**不套这几档,按内容尺寸走。 - **控件内部的图标/徽标/字形**另有比例要求(可见标记 ≈ 控件高度的 55~60%),见第 12 节。 - 按钮**不要写死宽度**:给高度 + 左右 `padding`,宽度跟内容走。 - 给 `button` 设高度时**必须同时设 `line-height`**(uni-app 默认 `line-height: 2.55555556`,不设会文字偏移/被裁)。 - 多行粘贴框(订单页 `.batch-review-input`)例外,按内容给高度。 ### 3. 字号:只有 10 档 | token | rem | ≥1280 | 用途 | |---|---|---|---| | `--wms-font-xs` | 0.15 | 15px | 标签、角标、辅助提示 | | `--wms-font-sm` | 0.17 | 17px | 说明文字 | | `--wms-font-base` | 0.18 | 18px | 正文、表格 | | `--wms-font-md` | 0.2 | 20px | 正文强调 | | `--wms-font-lg` | 0.21 | 21px | 卡片标题 | | `--wms-font-xl` | 0.22 | 22px | 导航菜单、大标题 | | `--wms-font-title` | 0.25 | 25px | 页面/弹窗标题 | | `--wms-font-2xl` | 0.3 | 30px | 大号数值(称重输入、数量) | | `--wms-font-3xl` | 0.35 | 35px | 合计、重点数字 | | `--wms-font-4xl` | 0.45 | 45px | 强调大字(打包拦截提示等) | - 全站字号已统一 ×0.85(只降文字、不降布局尺寸);**要调字号只改字号值,别动 rem 基数**。 - 浮层里的 `px` 字号(退件页摄像头浮窗 11/12/13px、`scan-diag-panel.vue`)是有意为之,不参与本刻度。 ### 4. 间距:5px 网格 - `padding` / `margin` / `gap` 取 **`0.05rem` 的倍数**(5 / 10 / 15 / 20 / 25 / 30 …px)。 - 紧凑标签、角标的**内部微内边距**可取 **`0.02rem` 的倍数**(2 / 4px),不要再出现第三种写法。 - 行高与控件高度不受本网格限制(走第 2 节的 36 / 50 / 70)。 ### 5. 圆角:3 档 + 圆 | 档位 | rem | 用途 | |---|---|---| | 角标 | `0.03rem` | 小标签、角标 | | 控件/小卡片 | `0.07rem` | 按钮、输入框、标签、小色块;列表/信息类小卡片(退件 `.rp-card`、订单左栏卡片) | | 大容器 | `0.13rem` | 页面级面板/弹窗(`.pack-card`、`.popup-card`、`.update-dialog`、`.container`) | | 圆形 | `50%` | 头像、圆形图标按钮 | ### 6. 边框:1px - 常规边框统一 `0.01rem`(≥1280 正好 1px)。 - 例外只有两种:图标描边/装饰虚线 `0.02rem`(2px)、左侧强调条/对齐条 `0.05rem`(5px)。 ### 7. 颜色:用 token,不写死高频色值 - 颜色/圆角/字号都集中在 `src/styles/base.css` 的 `:root`,页面里写 `var(--wms-*)`: `--wms-primary`、`--wms-primary-alt`、`--wms-success`、`--wms-warning`、`--wms-danger`、 `--wms-text` / `-strong` / `-secondary` / `-tertiary` / `-muted` / `-placeholder` / `-disabled`、 `--wms-page-bg`、`--wms-card-bg`、`--wms-bg-subtle`、`--wms-bg-tint`、`--wms-border` / `-alt` / `-light` / `-strong`、`--wms-white`。 - **页面底色全站统一 `--wms-page-bg = #e8eaed`,各页不要自己写底色**(登录页、打包页原先各写 `#f2f2f2` / `#e8eaed`,已统一)。 它比 `#f8f8f8` 深一档:与白卡片对比 **1.21 : 1**(`#f8f8f8` 只有 1.06 : 1),这样白色卡片才「立」得起来。 页面级框架背景在 `pages.json` 的 `globalStyle.backgroundColor`,与 token 保持同值。 - 纯白分两种写法:**底色**用 `var(--wms-card-bg)`,**文字/描边**用 `var(--wms-white)`。 - 一次性特殊色(渐变、遮罩、阴影里的 `rgba()`、品牌图标色)可以直接写。 ### 8. 布局:% / flex 负责伸展,rem 负责封顶 - **大屏表现**:宽度 ≥1280 后所有 rem 尺寸封顶,只做布局变化——多余空间给主区(`flex: 1; min-width: 0`),**不要给窄侧栏**。 - 窄侧栏统一 `flex: 0 0 3.8rem`(380px),三页(订单左栏 / 打包右栏 / 退件左栏)保持一致。 - **主体到页边的留白全站统一**:`--wms-page-pad` = `0.25rem`(25px),由基准 `.page-main` 的 `padding: 0.05rem var(--wms-page-pad) var(--wms-page-pad)` 提供;顶栏 `margin-bottom: 0.2rem` + 上 0.05 = 25px,**四边视觉留白一致**。 - 页面内层容器**不要再加内间距**,否则和基准叠加(订单 `.container` 已置 0;打包页没有 `.page-main`,`.mode-main` 直接取同一个 token)。 - 顶栏(`top-nav`)与打包页顶栏(`.mode-topbar`)的水平内边距也用 `var(--wms-page-pad)`,保证 logo/内容左右对齐。 - **主体内左右分栏间距统一 `--wms-panel-gap` = `0.15rem`(15px)**: 订单 `.panel-left { margin-right }`、退件 `.rp-left { margin-right }`、打包 `.pack-right { margin-left }`(三页统一用 `margin`,保持一致)。 > **更正(2026-10-27)**:2026-09-26 记的“`gap` 在真机生效”**是错的**。真机 `webview_provider` = `com.android.webview`, > `versionName = 52.0.2743.100`(Chromium 52),flex `gap` 要 Chrome 84+ 才有 → **真机上 `gap` 完全失效** > (退件页曾用 `gap: 0.15rem` 分隔两张卡片,像素级采样量到空隙为 **0**)。 > 结论:**间距一律用 `margin`**;页面里现存的 `gap` 要逐步换成 `margin`(同一处只能留一种)。 - 页面骨架统一用 `.page` / `.page-main`,每页只写差异项。 - **侧栏内容用「灰底 + 白卡片」**:侧栏自己不要铺底色(订单左栏、退件左栏都是透明灰底,与右栏一致);里面的每一块(搜索、列表、底部信息栏)做成独立白卡片,卡片间距 `0.15rem`、卡片内边距 `0.15rem`。 - 滚动方式各页自定:整块滚用 `overflow-y: auto`(订单、称重);面板各自滚用 `overflow: hidden` + 子面板 `auto`(退件)。 ### 9. 样式放哪:全局在 base.css,个性化在页面 - 6 个页面都要用的 → `src/styles/base.css`(`App.vue` 的 `