---
id: "data-values"
title: "金额、单位、零值与空值"
category: "数据展示"
document_type: "component-specification"
spec_status: "local-current-draft"
element_ui: "2.15.6"
vue: "2.6.14"
page: "../index.html#spec-data-values"
source_data: "../component-data.json"
official_components: []
template_components: []
scenario_count: 5
verification: "scenario-checklist-not-full-test-pass"
---

# 金额、单位、零值与空值

专题 `data-values` · 数据展示 · Element UI 2.15.6

## 适用范围与组件映射

公共色板及字体基线适用于整个运营后台。本库整理基础组件、组件状态和可复用的组合模式；本轮补齐表单整体验证、页面布局和导航组合；具体业务字段与跨页流程仍在业务场景中说明。专题验收清单包含接入要求，不表示当前示例已实现或已验证全部场景。

本专题为基础规则、同一组件的补充场景或组合模式，不作为独立的 Element UI 官方组件声明。

## 通用基线

- 组件库：Element UI **2.15.6**；运行样例 Vue **2.6.14**。
- 系统中文字体：macOS 优先苹方，Windows 通常微软雅黑；工程顺序固定为 `"PingFang SC", "Microsoft YaHei", sans-serif`。不要求安装或加载网络字体，兼容回退不是另一套可选样式。
- 后续仅采用经验证且固定版本的兼容 Element UI 2.x；Element Plus 属于独立迁移路线。
- 正文、数据值、输入及已选值：`14px / 400 / 21px`，`#303133`。
- 表头及组件分组标题：`14px / 600 / 21px`；弹窗标题：`16px / 600 / 24px`，均使用 `#303133`。
- 辅助说明：`12px / 400 / 18px`，`#595959`；错误、链接、状态、禁用与占位按各自语义处理。
- 适用组件的默认尺寸为 `small / 32px`；不得将这一高度机械应用于表格、文本域、浮层等全部组件。
- 规范正文与场景说明使用 `14px / 400 / 24px`、`#303133`，不降成灰蓝小字。
- 筛选文本输入占位统一“请输入”；未选择下拉统一“请选择”；默认全部的下拉显示“全部”。字段标签保留业务含义；日期保留开始/结束语义。
- 次级文字操作（查看更多、编辑、详情、数据中心、更多）：`12px / 400 / 18px`，`#3377BB`；保留点击热区。
- 本规范库的深色目录、蓝色展示区属于文档排版，不是业务组件颜色或业务导航规范。

## 本页用法与分类

默认用法：有效数值及单位默认使用正文层级，并按字段约定格式化。先判断真实值、是否缺失和查看权限，再决定显示内容；0始终保留为有效数值。

| 区分什么 | 本页内容 | 选用或触发条件 |
| --- | --- | --- |
| 精度、币种与单位（字段格式） | 格式用于表达数值含义，不是视觉主题。 | 同字段统一精度及单位；展示与原始值分开，复制或导出遵守字段合同。 |
| 零、空与未返回（数据状态） | 它们分别表示有效零、确实缺失或尚未得到结果。 | 按真实数据区分；本页数值空值用“-”，备注空值用“无”，不能由使用方任选一个替代所有情况。 |
| 脱敏与无权限（权限状态） | 脱敏是有数据但隐藏，无权限是不可查看。 | 只有需要保护且有授权查看的字段才提供显隐；无权限和空值不能伪装为可显示的有效值。 |

使用边界：不要用空值样式隐藏0，不要把所有字段都加显隐按钮，也不要按正负号自动选择红绿。

## 组件规则

- **DATA-VALUES-R01**：数据精度、币种和单位服从字段合同；同列使用等宽数字与统一小数展示约定。保留原始精确值供复制 / 导出。
- **DATA-VALUES-R02**：0 是有效数值；空值按字段合同显示，当前数值样例使用“-”，备注为空使用“无”，两者都使用空值灰 #909399。加载中、未返回与无权限必须有明确且不同的文字，不得统一渲染成横杠。USDT 紧凑币种符号沿用 ₮。
- **DATA-VALUES-R03**：正负、百分比、千分位、单位与时区须明确定义；数值不可用浮点四舍五入随意改变实际意义。使用整数最小单位时检查安全整数与求和溢出。未知或无效金额不按0参与范围筛选；某金额列含未知或无效值时，该列合计保持未知，不能将部分已知值伪装成完整合计。显示、复制和导出使用同一口径。
- **DATA-VALUES-R04**：【公共用色】颜色仅从公共色值 引用：主色系 3 个基础色值、辅助功能色 3 个、中性色 10 个，共 16 个基础色值。角色可以多个，实际色值复用；不为每个组件、悬停 或不同字段再新增近似颜色。透明效果仅限遮罩 35% 与阴影 12%，从 外壳深色 派生。
- **DATA-VALUES-R05**：【统一字体】统一系统中文字体：macOS 优先苹方（PingFang SC），Windows 通常使用微软雅黑（Microsoft YaHei）；工程顺序固定为 "PingFang SC", "Microsoft YaHei", sans-serif。使用设备已有字体，不要求安装或加载网络字体；最后一项仅作兼容回退，不是供页面作者任选的另一套样式。正文 14px/400/21px；表头与分组标题 14px/600/21px，弹窗标题 16px/600/24px；次级文字操作和辅助说明 12px/400/18px。正文与标题同用 #303133；不通过额外加粗或透明度改变正文轻重。
- **DATA-VALUES-R06**：【叠加优先级】状态叠加规则：禁用阻断交互；输入类控件错误边框覆盖蓝色聚焦边框；输入框不叠加外圈或阴影，其他无边框操作保留键盘焦点提示；选中底覆盖悬停底；只读不等于禁用；加载不等于成功；业务启用/停用的文字结果不等于控件是否可点击。
- **DATA-VALUES-R07**：掩码表示数据存在但当前隐藏；无权限、未返回、空值分别表达。显示入口必须可识别、有文字名称，并明确当前显示/隐藏状态。
- **DATA-VALUES-R08**：接口权限控制与前端显隐分开：没有查看权限时不得把明文下发后仅用CSS隐藏。本示例全为虚构编号，权限复选框仅用于状态演练。
- **DATA-VALUES-R09**：复制行为要明确复制当前显示值还是完整值；完整值复制同样需要权限。关闭详情或切换记录应恢复默认脱敏；不可把显示开关直接添加到所有业务字段。
- **DATA-VALUES-R10**：【有效值与单位】金额、单位和有效零值使用正文深灰、14px/400；不按正负或大小自动变红绿。
- **DATA-VALUES-R11**：【空值】确实缺失的内容使用空值灰，文案按字段约定：当前数值样例为“-”，备注为“无”；0保留有效数值，不替换为空值提示。
- **DATA-VALUES-R12**：【只读与脱敏】只读真实值仍为正文深灰；脱敏掩码保留正文层级，显示/复制入口使用操作蓝，并按权限控制真实行为。
- **DATA-VALUES-R13**：【读取反馈】只有异步读取时使用主题蓝加载标记；失败使用错误红短提示，不把失败伪装成0或正常空值。
- **DATA-VALUES-R14**：【组件边界】金额、单位和零值是数据角色，不自带行选中、排序或禁用态；处于表格时背景由表格管理。

## 场景与验收清单

以下为需核对的场景组；`[ ]` 不代表已经测试通过。

- [ ] **DATA-VALUES-S01**：整数 / 小数 / 极大极小 / 正负 / 千分位 / 单位 / 精度
- [ ] **DATA-VALUES-S02**：零 / 空 / 未返回 / 无权限 / 格式化后复制原值；业务金额验证未知不匹配零值范围、列内未知传播到合计、求和安全整数溢出及显示/CSV口径一致。
- [ ] **DATA-VALUES-S03**：本页核对有效值、0、空值、未返回、脱敏和无权限的文字角色；显隐入口单独检查焦点与禁用。静态数值不套输入错误、行选中或半选规则。
- [ ] **DATA-VALUES-S04**：核对正文14/400、次级操作12/400、标题600及同色深正文；检查实际弹出层和子 span，不能只检查父元素。
- [ ] **DATA-VALUES-S05**：当前示例：隐藏→显示→隐藏；关闭查看权限后恢复遮蔽且按钮禁用。接入验收：有权限但字段为空时不提供显隐动作；本地编号样例本身不切换为空值。

### 专题验收重点

当前静态对照核对有效0、空值、未返回和无权限的独立文案，精确小数不丢位且与正文使用同一字体；本地显隐及权限切换不泄漏明文。格式化后复制原值、真实请求等待/失败和关闭记录恢复默认脱敏，须在宿主接入后验收。

## 当前示例模板

以下来自本专题的结构化示例，使用 Vue 2 模板语法。`v-model`、事件方法、数据列表等依赖 [components.js](../components.js)；完整样式文件及加载顺序见 [通用基线](FOUNDATIONS.md)。自定义组合标签的内部实现由下方依赖文件提供，不能仅复制标签作为完整组件。

```html
<div class="table-scroll">
<table>
<thead>
<tr>
<th>类型</th>
<th>示例</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>有效零值</td>
<td>
<span class="number">0.00</span>
</td>
<td>不显示为 -</td>
</tr>
<tr>
<td>空值</td>
<td>
<span class="audit-empty-value">-</span>
</td>
<td>尚无此值</td>
</tr>
<tr>
<td>精确数值</td>
<td>
<span class="number">0.123456789</span>
</td>
<td>按字段合同保留精度</td>
</tr>
<tr>
<td>未返回</td>
<td>尚未返回</td>
<td>结果尚未取得，不表示有效0或确实缺失</td>
</tr>
<tr>
<td>无权限</td>
<td>不可见</td>
<td>与空值不同</td>
</tr>
</tbody>
</table>
</div>
<!-- reference-pattern-masked-value-pattern -->
<section class="reference-supplement">
<h4>脱敏、显示与无权限</h4>
<masked-value-pattern>
</masked-value-pattern>
<p class="reference-note">参考截图用于提取场景结构；切换、校验、撤销等演示行为按本规范定义。<a href="https://resycb.axshare.com/#id=n9tpcj&amp;p=会员列表d&amp;g=1" target="_blank" rel="noopener noreferrer">查看参考页</a>
</p>
</section>
```

## 交付与使用边界

- 规范条款、示例代码与待验收场景分开理解；有示例不等于已覆盖所有样式、交互状态和使用场景。
- 业务接口、权限、时区、金额精度、数据规模等依赖应从实际项目读取，不使用演示值代替生产约定。
- 发生样式或文案变更时，同步专题数据、页面与 Markdown，避免规范和样例分离。

## 来源与关联

- 来源线索：历史样板规范 47 / 50 / 62；2026-09-15 参考抽样：https://resycb.axshare.com/#id=n9tpcj&p=会员列表d&g=1。
- [打开本专题页面](../index.html#spec-data-values)
- [通用基线](FOUNDATIONS.md)
- [规范总索引](README.md)
- [结构化规范数据](../component-data.json)（记录 id：`data-values`）
- [原始历史样板](../original-20260621.html)
- [历史规范条目](../spec-notes.json)

自定义示例 `masked-value-pattern` 的实现：[reference-patterns.js](../reference-patterns.js)。

组合样式见 [reference-patterns.css](../reference-patterns.css)；来源及扩展范围见 [参考补充记录](../reference-supplements.md)。

## 本组件颜色状态表

| 状态 / 条件 | 统一规则 |
| --- | --- |
| 有效值与单位 | 金额、单位和有效零值使用正文深灰、14px/400；不按正负或大小自动变红绿。 |
| 空值 | 确实缺失的内容使用空值灰，文案按字段约定：当前数值样例为“-”，备注为“无”；0保留有效数值，不替换为空值提示。 |
| 只读与脱敏 | 只读真实值仍为正文深灰；脱敏掩码保留正文层级，显示/复制入口使用操作蓝，并按权限控制真实行为。 |
| 读取反馈 | 只有异步读取时使用主题蓝加载标记；失败使用错误红短提示，不把失败伪装成0或正常空值。 |

金额、单位和零值是数据角色，不自带行选中、排序或禁用态；处于表格时背景由表格管理。

[公共颜色与字体 token](../color-tokens.json) · [公共组件样式](../color-contract.css) · [系统字体合同（最后加载）](../font-contract.css)

## 业务落地场景

- [存款记录 · 存款金额、手续费等数值列](../../showcase/index.html#deposits) · [场景文档](../../showcase/docs/deposits.md)
- [运营总览 · 指标值、单位、零值及热力表](../../showcase/index.html#overview) · [场景文档](../../showcase/docs/overview.md)

[竞品组件拆解](../../reference-review/竞品组件反推规范.html) · [业务场景分类](../../业务场景分类清单.md)