--- id: "breadcrumb-header" title: "面包屑与返回页头" category: "容器组件" document_type: "component-specification" spec_status: "local-current-draft" element_ui: "2.15.6" vue: "2.6.14" page: "../index.html#spec-breadcrumb-header" source_data: "../component-data.json" official_components: ["breadcrumb", "breadcrumb-item", "page-header"] template_components: [] scenario_count: 6 verification: "scenario-checklist-not-full-test-pass" --- # 面包屑与返回页头 专题 `breadcrumb-header` · 容器组件 · Element UI 2.15.6 ## 适用范围与组件映射 公共色板及字体基线适用于整个运营后台。本库整理基础组件、组件状态和可复用的组合模式；本轮补齐表单整体验证、页面布局和导航组合；具体业务字段与跨页流程仍在业务场景中说明。专题验收清单包含接入要求，不表示当前示例已实现或已验证全部场景。 官方条目映射：`breadcrumb`、`breadcrumb-item`、`page-header`。 ## 通用基线 - 组件库：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`；保留点击热区。 - 本规范库的深色目录、蓝色展示区属于文档排版，不是业务组件颜色或业务导航规范。 ## 本页用法与分类 默认用法：层级较多时展示面包屑；简单详情页使用明确的返回页头即可。选择依据是用户是否需要知道所在层级、返回哪里，不是新增一套可选皮肤。 | 区分什么 | 本页内容 | 选用或触发条件 | | --- | --- | --- | | 用途：层级定位 | 面包屑说明从父层到当前页面的关系。 | 仅父层可以返回；最后一项与页面标题对应且不可点击。没有真实目标的层级不用假链接。 | | 用途：返回与标题 | 返回页头提供一个明确返回目标和当前页面标题。 | 详情返回所属列表；路径简单时可单独使用页头。不要把 history.back 当作任何情况下都正确的返回策略。 | | 布局：窄宽与长名称 | 文字换行属于空间适配，不是新的文字样式。 | 保留完整名称和既定字号；本例可切换320px预览及长名称，父层、标题允许换行。 | | 接入：当前示例与业务状态 | 本页验证组件内目标切换；业务列表状态保持属于宿主工作。 | 本次尚未改造业务导航。接入会员详情前需要明确路由、页码、筛选、滚动和草稿恢复，避免宣称已具备未实现功能。 | 使用边界：不让当前页面名称可点击，不给分隔符加焦点，不盲退到站外或上一个无关页面，也不强制每个页面同时摆放面包屑与返回页头。 ## 组件规则 - **BREADCRUMB-HEADER-R01**：面包屑显示当前页面的层级位置，父层入口可返回相应层级；最后一项是当前页纯文本并标记当前位置，不带链接或按钮行为。 - **BREADCRUMB-HEADER-R02**：返回页头将返回动作与页面标题组合，返回目的地必须明确。会员详情返回会员列表，不能无条件调用浏览器后退而跳出当前功能。 - **BREADCRUMB-HEADER-R03**：面包屑定位层级，返回动作表达离开当前页的目标，两者不互相替代；路径简单的详情页可只保留明确的返回页头，不强制叠加两套导航。本页并列展示便于理解区别。 - **BREADCRUMB-HEADER-R04**：本页使用官方面包屑、面包屑项与页头组件；父层使用原生按钮承接示例内切换，移除无行为文字上的链接角色；为官方页头返回区域补充按钮语义、名称、制表键和回车/空格触发。 - **BREADCRUMB-HEADER-R05**：标题与当前层必须与实际内容同步。返回列表后可再次进入不同会员详情，示例不会改变浏览器路由或执行查询。真实页面的查询条件、滚动和草稿保持由宿主定义。 - **BREADCRUMB-HEADER-R06**：长名称完整可读、窄宽自然换行；不增加小字号以挤入一行。当前页、分隔符、静态说明均不加入制表键顺序。 - **BREADCRUMB-HEADER-R07**：【公共用色】颜色仅从公共色值 引用：主色系 3 个基础色值、辅助功能色 3 个、中性色 10 个，共 16 个基础色值。角色可以多个，实际色值复用；不为每个组件、悬停 或不同字段再新增近似颜色。透明效果仅限遮罩 35% 与阴影 12%，从 外壳深色 派生。 - **BREADCRUMB-HEADER-R08**：【统一字体】统一系统中文字体：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；不通过额外加粗或透明度改变正文轻重。 - **BREADCRUMB-HEADER-R09**：【叠加优先级】状态叠加规则：禁用阻断交互；输入类控件错误边框覆盖蓝色聚焦边框；输入框不叠加外圈或阴影，其他无边框操作保留键盘焦点提示；选中底覆盖悬停底；只读不等于禁用；加载不等于成功；业务启用/停用的文字结果不等于控件是否可点击。 - **BREADCRUMB-HEADER-R10**：【父层入口】面包屑父层正文14px/400、操作蓝；原生按钮或真实链接可返回对应父层。悬停下划线，键盘焦点2px操作蓝轮廓。 - **BREADCRUMB-HEADER-R11**：【当前层与分隔符】当前层正文深灰14px/400、纯文本，不伪装链接；标记当前位置。斜杠用边框灰，只做分隔，不成为可聚焦项。 - **BREADCRUMB-HEADER-R12**：【页头标题与返回】页面标题正文深灰14px/600/21px；返回动作操作蓝12px/400/18px，图标16px，热区至少24px高。说明正文14px，不把说明做得比标题更醒目。 - **BREADCRUMB-HEADER-R13**：【长名称与窄宽】父层与当前层允许自然换行，长英文或连续字符可断行；不缩小字号、不裁掉当前页名称，不用固定高遮挡第二行。 ## 场景与验收清单 以下为需核对的场景组；`[ ]` 不代表已经测试通过。 - [ ] **BREADCRUMB-HEADER-S01**：当前样例：概览 → 会员列表 → 会员详情的组件内层级；父层按钮返回相应内容，当前层纯文本。会员详情账号在列表进入时更新。 - [ ] **BREADCRUMB-HEADER-S02**：当前样例：详情页头返回会员列表、列表页头返回概览；使用明确目标，不依赖浏览器历史。组件示例不修改真实业务数据或路由。 - [ ] **BREADCRUMB-HEADER-S03**：当前样例：320px窄宽与长名称可分别切换，检查面包屑和页头完整换行；保持14px正文、14px/600标题及12px次级动作。 - [ ] **BREADCRUMB-HEADER-S04**：键盘验收：父层原生按钮与页头返回区域可用制表键到达，回车/空格各触发一次；当前层无操作角色；切换后焦点回到对应标题。 - [ ] **BREADCRUMB-HEADER-S05**：业务采用：现有业务尚未采用这组官方面包屑/页头组件；members 与 member-detail 仅为后续接入候选，不以通用业务首页链接冒充已落地场景。 - [ ] **BREADCRUMB-HEADER-S06**：接入真实详情页时，明确返回列表的筛选、页码、滚动与未保存内容策略；不能因示例返回正常就宣称真实业务状态已保留。 ### 专题验收重点 点击概览、会员列表等父层后内容与最后一项同步；在会员详情使用页头返回会员列表，再进入另一账号，标题随账号改变。键盘回车/空格触发返回，焦点回到目标标题；当前项无链接角色。切换320px窄宽与长名称后核对换行。当前为编译和方法检查，浏览器实际焦点、行高与视觉还需实测。 ## 当前示例模板 以下来自本专题的结构化示例，使用 Vue 2 模板语法。`v-model`、事件方法、数据列表等依赖 [components.js](../components.js)；完整样式文件及加载顺序见 [通用基线](FOUNDATIONS.md)。自定义组合标签的内部实现由下方依赖文件提供，不能仅复制标签作为完整组件。 ```html ``` ## 交付与使用边界 - 规范条款、示例代码与待验收场景分开理解；有示例不等于已覆盖所有样式、交互状态和使用场景。 - 业务接口、权限、时区、金额精度、数据规模等依赖应从实际项目读取，不使用演示值代替生产约定。 - 发生样式或文案变更时，同步专题数据、页面与 Markdown，避免规范和样例分离。 ## 来源与关联 - 来源线索：Element UI 2.15.6 官方 Breadcrumb / BreadcrumbItem / PageHeader；本项目补充明确返回目标和键盘语义适配。。 - [打开本专题页面](../index.html#spec-breadcrumb-header) - [通用基线](FOUNDATIONS.md) - [规范总索引](README.md) - [结构化规范数据](../component-data.json)（记录 id：`breadcrumb-header`） - [原始历史样板](../original-20260621.html) - [历史规范条目](../spec-notes.json) 自定义示例 `official-breadcrumb-header` 的实现：[official-navigation.js](../official-navigation.js)。 ## 本组件颜色状态表 | 状态 / 条件 | 统一规则 | | --- | --- | | 父层入口 | 面包屑父层正文14px/400、操作蓝；原生按钮或真实链接可返回对应父层。悬停下划线，键盘焦点2px操作蓝轮廓。 | | 当前层与分隔符 | 当前层正文深灰14px/400、纯文本，不伪装链接；标记当前位置。斜杠用边框灰，只做分隔，不成为可聚焦项。 | | 页头标题与返回 | 页面标题正文深灰14px/600/21px；返回动作操作蓝12px/400/18px，图标16px，热区至少24px高。说明正文14px，不把说明做得比标题更醒目。 | | 长名称与窄宽 | 父层与当前层允许自然换行，长英文或连续字符可断行；不缩小字号、不裁掉当前页名称，不用固定高遮挡第二行。 | 面包屑与页头不具有勾选、半选或成功状态；返回本身不使用危险红，当前页也不套选中按钮蓝底。 [公共颜色与字体 token](../color-tokens.json) · [公共组件样式](../color-contract.css) · [系统字体合同（最后加载）](../font-contract.css) ## 业务落地场景 **当前业务：暂未采用。** 当前业务壳使用左侧菜单与工作页签，尚未采用面包屑或独立返回页头；本页提供会员列表/详情的本地结构示例。只有页面存在稳定父级或明确返回目标时再接入，不能增加无意义层级。 本页保留组件示例和接入规则。已核实的参考截图尚未提供合适业务落点，不链接无关首页，不为覆盖组件而新增业务字段。 **适用条件**：层级较多时展示面包屑；简单详情页使用明确的返回页头即可。选择依据是用户是否需要知道所在层级、返回哪里，不是新增一套可选皮肤。 **采用边界**：不让当前页面名称可点击，不给分隔符加焦点，不盲退到站外或上一个无关页面，也不强制每个页面同时摆放面包屑与返回页头。 [竞品组件拆解](../../reference-review/竞品组件反推规范.html) · [业务场景分类](../../业务场景分类清单.md)