---
id: "long-text"
title: "长文本、单号与完整值"
category: "数据展示"
document_type: "component-specification"
spec_status: "local-current-draft"
element_ui: "2.15.6"
vue: "2.6.14"
page: "../index.html#spec-long-text"
source_data: "../component-data.json"
official_components: []
template_components: ["el-button", "el-tooltip"]
scenario_count: 3
verification: "scenario-checklist-not-full-test-pass"
---

# 长文本、单号与完整值

专题 `long-text` · 数据展示 · Element UI 2.15.6

## 适用范围与组件映射

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

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

本页模板直接使用的 Element UI 标签：`el-button`、`el-tooltip`。

## 通用基线

- 组件库：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`；保留点击热区。
- 本规范库的深色目录、蓝色展示区属于文档排版，不是业务组件颜色或业务导航规范。

## 本页用法与分类

默认用法：普通说明默认自然换行，保持正文字号；本页长单号采用前6后6缩略，并保留完整值提示和复制入口。

| 区分什么 | 本页内容 | 选用或触发条件 |
| --- | --- | --- |
| 说明与标识（内容用途） | 说明需要连续阅读，单号需要辨识并可取得完整值。 | 说明优先自然换行；符合本项目单号约定的长标识使用前6后6，不把该规则套到所有长文本。 |
| 换行与省略（空间处理） | 省略仅解决固定区域的长度限制，不改变内容含义。 | 空间允许就换行；列表确需限制占高时才省略，并提供现有完整值承接方式。本页没有行数档位切换器。 |
| 查看与复制（附属功能） | 完整值提示和复制属于实际操作。 | 截短的单号必须能用键盘查看完整值；复制原始完整值。焦点和复制结果按操作自动反馈。 |

使用边界：不要用缩小字号解决溢出，也不要把缩略单号误称为权限脱敏。

## 组件规则

- **LONG-TEXT-R01**：单号沿用前 6 后 6，tooltip 和复制保留完整值；不对所有普通文本套用同一种截断。
- **LONG-TEXT-R02**：普通说明默认自然折行；列表确需限制占高时才使用省略，并通过悬停/键盘聚焦提示或现有详情提供完整内容，不缩小字号。本页展示自然折行与单号缩略，没有可切换的行数档位。
- **LONG-TEXT-R03**：说明类完整值支持键盘查看；tooltip 不遮挡触发点，页面边缘自动调整位置。
- **LONG-TEXT-R04**：【公共用色】颜色仅从公共色值 引用：主色系 3 个基础色值、辅助功能色 3 个、中性色 10 个，共 16 个基础色值。角色可以多个，实际色值复用；不为每个组件、悬停 或不同字段再新增近似颜色。透明效果仅限遮罩 35% 与阴影 12%，从 外壳深色 派生。
- **LONG-TEXT-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；不通过额外加粗或透明度改变正文轻重。
- **LONG-TEXT-R06**：【叠加优先级】状态叠加规则：禁用阻断交互；输入类控件错误边框覆盖蓝色聚焦边框；输入框不叠加外圈或阴影，其他无边框操作保留键盘焦点提示；选中底覆盖悬停底；只读不等于禁用；加载不等于成功；业务启用/停用的文字结果不等于控件是否可点击。
- **LONG-TEXT-R07**：【静态长文本】普通正文使用正文深灰；必要说明辅助深灰；换行或省略不改变有效内容颜色。
- **LONG-TEXT-R08**：【查看与复制】完整值查看、展开或复制入口使用操作蓝；次级动作12px/400，悬停加下划线并保留原语义。
- **LONG-TEXT-R09**：【焦点与不可用】可操作入口使用操作蓝键盘焦点；无可复制值时明确禁用灰并阻止复制，不伪造成功。
- **LONG-TEXT-R10**：【空值与结果】空内容使用空值灰；复制的成功/失败通过独立消息表达，不把长文本长期改成绿色或红色。
- **LONG-TEXT-R11**：【组件边界】长文本本身没有危险动作、半选或禁用状态；只有真实的展开、完整值查看和复制入口可以交互。

## 场景与验收清单

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

- [ ] **LONG-TEXT-S01**：当前示例：长单号采用前6后6缩略，提示和复制保留完整值；普通长文本可换行。
- [ ] **LONG-TEXT-S02**：接入验收：无空格长串、中文、数字、换行和表情内容不截断关键语义；窄容器不挤占操作区。
- [ ] **LONG-TEXT-S03**：接入验收：省略文本能用键盘查看完整值，复制范围不包含省略号或额外说明。

### 专题验收重点

复制值与全文一致；键盘 聚焦 显示完整单号。

## 当前示例模板

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

```html
<div class="demo-line">
<el-tooltip content="CR2026051264345490634092570" placement="top">
<el-button type="text">CR2026...092570</el-button>
</el-tooltip>
<el-button type="text" icon="el-icon-document-copy" aria-label="复制完整单号" @click="copy('CR2026051264345490634092570')">
</el-button>
</div>
<p class="wrap-sample">固定宽度内自然折行：较长的组件说明不会缩小字号，也不会撑开相邻列。</p>
```

## 交付与使用边界

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

## 来源与关联

- 来源线索：历史样板规范 17 / 48 / 61。
- [打开本专题页面](../index.html#spec-long-text)
- [通用基线](FOUNDATIONS.md)
- [规范总索引](README.md)
- [结构化规范数据](../component-data.json)（记录 id：`long-text`）
- [原始历史样板](../original-20260621.html)
- [历史规范条目](../spec-notes.json)

## 本组件颜色状态表

| 状态 / 条件 | 统一规则 |
| --- | --- |
| 静态长文本 | 普通正文使用正文深灰；必要说明辅助深灰；换行或省略不改变有效内容颜色。 |
| 查看与复制 | 完整值查看、展开或复制入口使用操作蓝；次级动作12px/400，悬停加下划线并保留原语义。 |
| 焦点与不可用 | 可操作入口使用操作蓝键盘焦点；无可复制值时明确禁用灰并阻止复制，不伪造成功。 |
| 空值与结果 | 空内容使用空值灰；复制的成功/失败通过独立消息表达，不把长文本长期改成绿色或红色。 |

长文本本身没有危险动作、半选或禁用状态；只有真实的展开、完整值查看和复制入口可以交互。

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

## 业务落地场景

- [操作日志 · 日志行 · 完整请求/响应参数](../../showcase/index.html#logs) · [场景文档](../../showcase/docs/logs.md)

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