Breadcrumb 设计文档

面包屑导航,展示当前页面在层级结构中的位置。字段/API/DOM/class 严格对齐 Semi semi-ui/breadcrumb(index.tsx + item.tsx + bread-context.tsx 三文件拆分同构)。routes 元素为 Route 对象({name, path, href, icon})或纯字符串。支持数据驱动 routes 与声明式 Item 两种用法。icon/separator/renderItem/renderMore 均为组件引用直传(非 Snippet:Svelte 5 运行时无法可靠区分 Snippet 与裸 Component,见 Item.svelte 头注释)。

← API 文档

使用建议

面包屑导航,展示当前页面在层级结构中的位置。字段/API/DOM/class 严格对齐 Semi semi-ui/breadcrumb(index.tsx + item.tsx + bread-context.tsx 三文件拆分同构)。routes 元素为 Route 对象({name, path, href, icon})或纯字符串。支持数据驱动 routes 与声明式 Item 两种用法。icon/separator/renderItem/renderMore 均为组件引用直传(非 Snippet:Svelte 5 运行时无法可靠区分 Snippet 与裸 Component,见 Item.svelte 头注释)。

Accessibility

ARIA role:navigation

  • nav[aria-label] 下直接放扁平 item-wrap span(对齐 Semi,无 ol/li 列表包裹)
  • 最后一项 aria-current=page 挂在 item-wrap(对齐 Semi render() pageLabel),项本体渲染为不可点 span
  • 无 href 的中间项为纯 <span onClick>,无 tabIndex/role(如实对齐 Semi 行为,非本库补充)
  • 折叠触发器 role=button + tabindex=0 + aria-label="Expand breadcrumb items"

设计变量

变量
默认值
用法
--cd-transform-scale-breadcrumb-link-text var(--cd-motion-scale-none) 面包屑文字-放大
--cd-transition-delay-breadcrumb-link-text var(--cd-motion-duration-none) 面包屑文字-文字-延迟时间
--cd-transition-duration-breadcrumb-link-text var(--cd-motion-duration-none) 面包屑文字-文字-动画持续时间
--cd-transition-function-breadcrumb-link-text var(--cd-motion-ease-in) 面包屑文字-文字-过渡曲线
显示第 1 条-第 4 条,共 4 条
  • 1