---
id: "layers"
title: "层级、边缘与滚动条"
category: "浮层组件"
document_type: "component-specification"
spec_status: "local-current-draft"
element_ui: "2.15.6"
vue: "2.6.14"
page: "../index.html#spec-layers"
source_data: "../component-data.json"
official_components: []
template_components: []
scenario_count: 5
verification: "scenario-checklist-not-full-test-pass"
---

# 层级、边缘与滚动条

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

## 本页用法与分类

默认用法：默认遵循正文、固定内容、普通浮层、模态容器、模态内浮层和消息反馈的层级关系；本页是静态规则表。

| 区分什么 | 本页内容 | 选用或触发条件 |
| --- | --- | --- |
| 容器关系 | 六层说明谁覆盖谁，不是六种外观。 | 先按内容所属组件确定层级，不按表中序号给业务页面手写固定层级值。 |
| 模态能力 | 是否有遮罩由容器是否阻断背景操作决定。 | 对话框和当前模态抽屉使用遮罩；菜单和文字提示不额外加遮罩。 |
| 空间适配 | 贴边翻转、挂载位置、滚动和退出顺序属于组合环境。 | 在实际表格、弹窗和浮层组合中验收；本页静态关系表不代表这些功能已测试或实现。 |

使用边界：不把层级高低、滚动条宽度或有无遮罩列成自由选择的主题样式。

## 组件规则

- **LAYERS-R01**：层级关系：正文 < 固定表头 / 列 < 下拉 / 气泡浮层 < 模态遮罩与面板 < 模态内浮层 / 文字提示 < 消息反馈。
- **LAYERS-R02**：本库真实运行 Element PopupManager；业务禁止在各页面任意叠加 z-index。模态内部浮层需验证层级及 append-to-body 的位置。
- **LAYERS-R03**：下拉与独立列表滚动条统一6px，设置弹窗沿用4px；轨道浅灰背景、滑块边框灰。同一方向只显示一套原生或自定义滚动条，不因叠加两套轨道产生双滚动条；滚轮及拖拽须能到首尾，不能掩盖最后一项和焦点。
- **LAYERS-R04**：【公共用色】颜色仅从公共色值 引用：主色系 3 个基础色值、辅助功能色 3 个、中性色 10 个，共 16 个基础色值。角色可以多个，实际色值复用；不为每个组件、悬停 或不同字段再新增近似颜色。透明效果仅限遮罩 35% 与阴影 12%，从 外壳深色 派生。
- **LAYERS-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；不通过额外加粗或透明度改变正文轻重。
- **LAYERS-R06**：【叠加优先级】状态叠加规则：禁用阻断交互；输入类控件错误边框覆盖蓝色聚焦边框；输入框不叠加外圈或阴影，其他无边框操作保留键盘焦点提示；选中底覆盖悬停底；只读不等于禁用；加载不等于成功；业务启用/停用的文字结果不等于控件是否可点击。
- **LAYERS-R07**：【内容层】固定表头、固定列使用不透明的对应行状态背景：默认白底，悬停及选中同步整行规则；不能因列固定而丢失选中背景。普通浮层使用白底，边界用边框灰或分隔灰，避免透出底层文字。
- **LAYERS-R08**：【模态层】真实模态遮罩复用外壳深色35%透明度；浮层阴影复用外壳深色12%，不新增分层专属颜色。
- **LAYERS-R09**：【焦点与滚动】焦点色由当前可操作组件定义；滚动条轨道浅灰背景、滑块边框灰，层级容器不自带悬停/选中状态。
- **LAYERS-R10**：【组件边界】层级是容器关系，不是确认流程。只有真正模态的对话框/抽屉使用遮罩；菜单和文字提示不继承模态遮罩。
- **LAYERS-R11**：本专题只提供静态层级示意；贴边定位、嵌套关闭与滚动行为必须在实际浮层组合中验收，不能由此示意宣称已通过。

## 场景与验收清单

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

- [ ] **LAYERS-S01**：当前样例是正文、固定区域、普通浮层、模态容器、模态内浮层到消息反馈的静态关系表；序号不是样式中的实际层级数值，不代表已完成嵌套浮层测试。
- [ ] **LAYERS-S02**：接入验收：固定列、菜单、模态遮罩、模态内浮层、文字提示与消息的遮挡关系。
- [ ] **LAYERS-S03**：接入验收：浮层挂载位置（是否放到页面根节点）、容器滚动后的定位、贴边翻转、缩放与嵌套关闭顺序；同时检查同一方向无重复滚动条、末项可达，不能靠禁止内容滚动消除轨道。
- [ ] **LAYERS-S04**：共用视觉验收：仅核对本组件实际适用的颜色与组合状态；无此能力标为不适用，不给静态内容添加输入错误、半选或按下状态。
- [ ] **LAYERS-S05**：共用文字验收：正文14px/400、次级操作12px/400、标题600；检查实际子元素与弹出层。输入焦点只改自身边框，按钮和链接保留键盘焦点轮廓。

### 专题验收重点

本专题核对层级说明；实际接入另验贴边触发、容器滚动、缩放、模态内弹层和退出顺序，不将静态示意视为通过证据。

## 当前示例模板

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

```html
<div class="color-table-scroll">
<table class="color-role-table">
<caption>层级阅读顺序（由下到上，静态说明）</caption>
<thead>
<tr>
<th>层级</th>
<th>典型内容</th>
<th>覆盖关系与边界</th>
</tr>
</thead>
<tbody>
<tr>
<td>1 · 正文</td>
<td>页面内容、普通表格单元格</td>
<td>基础内容层，不覆盖浮层</td>
</tr>
<tr>
<td>2 · 固定内容</td>
<td>固定表头、固定列</td>
<td>高于正文；使用不透明背景，不透出底层文字</td>
</tr>
<tr>
<td>3 · 普通浮层</td>
<td>下拉选项、菜单、气泡浮层</td>
<td>高于其所属固定区域；不附加模态遮罩</td>
</tr>
<tr>
<td>4 · 模态容器</td>
<td>模态遮罩、对话框、模态抽屉</td>
<td>面板位于自身遮罩之上；背景不可操作</td>
</tr>
<tr>
<td>5 · 模态内浮层</td>
<td>对话框内的下拉、文字提示</td>
<td>高于所属模态面板；退出时先关闭最上层</td>
</tr>
<tr>
<td>6 · 消息反馈</td>
<td>消息、通知</td>
<td>保持可见，避免遮挡当前关键操作</td>
</tr>
</tbody>
</table>
</div>
<p class="help">这是容器关系说明，序号不等于固定 z-index 数值。实际浮层统一交由 Element 浮层管理器分配；须在真实组合中核对挂载位置、滚动、贴边和关闭顺序。</p>
```

## 交付与使用边界

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

## 来源与关联

- 来源线索：历史样板规范 54；DX 设置与下拉滚动条规则。
- [打开本专题页面](../index.html#spec-layers)
- [通用基线](FOUNDATIONS.md)
- [规范总索引](README.md)
- [结构化规范数据](../component-data.json)（记录 id：`layers`）
- [原始历史样板](../original-20260621.html)
- [历史规范条目](../spec-notes.json)

## 本组件颜色状态表

| 状态 / 条件 | 统一规则 |
| --- | --- |
| 内容层 | 固定表头、固定列使用不透明的对应行状态背景：默认白底，悬停及选中同步整行规则；不能因列固定而丢失选中背景。普通浮层使用白底，边界用边框灰或分隔灰，避免透出底层文字。 |
| 模态层 | 真实模态遮罩复用外壳深色35%透明度；浮层阴影复用外壳深色12%，不新增分层专属颜色。 |
| 焦点与滚动 | 焦点色由当前可操作组件定义；滚动条轨道浅灰背景、滑块边框灰，层级容器不自带悬停/选中状态。 |

层级是容器关系，不是确认流程。只有真正模态的对话框/抽屉使用遮罩；菜单和文字提示不继承模态遮罩。

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

## 业务落地场景

- [会员列表 · 会员详情、下拉菜单与弹窗的层级](../../showcase/index.html#members) · [场景文档](../../showcase/docs/members.md)
- [客服工单管理 · 新增/详情 · 上传预览与内部滚动](../../showcase/index.html?example=ticket-create#tickets) · [场景文档](../../showcase/docs/tickets.md)

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