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