Breadcrumb 设计文档

面包屑导航,展示当前页面在层级结构中的位置。字段/API 对齐 Semi:routes 元素为 Route 对象({name, path, href, icon})或纯字符串。支持数据驱动 routes 与声明式 Item 两种用法。

← API 文档

使用建议

面包屑导航,展示当前页面在层级结构中的位置。字段/API 对齐 Semi:routes 元素为 Route 对象({name, path, href, icon})或纯字符串。支持数据驱动 routes 与声明式 Item 两种用法。

Accessibility

ARIA role:navigation

  • nav[aria-label] 下直接放扁平 span/a(对齐 Semi,无 ol/li 列表包裹)
  • 最后一项 aria-current=page,不可点击
  • 无 href 的中间项用 role=link + tabindex=0 + 键盘可激活
  • 分隔符 aria-hidden=true

设计变量

变量默认值用法
--cd-breadcrumb-color var(--cd-color-breadcrumb-default-text-default)面包屑根文字颜色(组件消费)
--cd-breadcrumb-color-active var(--cd-color-breadcrumb-active-text-default)当前页 / 选中项文字颜色(组件消费)
--cd-breadcrumb-color-link var(--cd-color-breadcrumb-default-text-default)可点击项文字颜色 - 常态(对齐 Semi item 常态灰,组件消费)
--cd-breadcrumb-color-link-active var(--cd-color-breadcrumb-default-text-active)可点击项文字颜色 - 按下(对齐 Semi item-link:active,组件消费)
--cd-breadcrumb-color-link-hover var(--cd-color-breadcrumb-default-text-hover)可点击项文字颜色 - 悬浮(对齐 Semi item-link:hover,组件消费)
--cd-breadcrumb-restitem-color var(--cd-color-breadcrumb-restitem-text-default)折叠 … 触发器 / restItem 文字颜色(对齐 Semi restItem,组件消费)
--cd-breadcrumb-separator-color var(--cd-color-breadcrumb-sepearator-default-icon-default)分割符颜色(组件消费)
--cd-color-breadcrumb-active-text-active var(--cd-color-text-0)面包屑文字颜色 - 选中激活
--cd-color-breadcrumb-active-text-default var(--cd-color-text-0)面包屑文字颜色 - 选中
--cd-color-breadcrumb-default-text-active var(--cd-color-link-hover)面包屑文字颜色 - 按下