Breadcrumb 面包屑
uni-appH5微信小程序App
跨端层级路径导航,点击非当前项通过 item-click 交给外部处理。
何时使用
页面层级 ≥ 2 层,需要告知用户当前位置并支持向上回跳。
何时不使用
平级内容切换用 Tabs;只有一层结构时无需面包屑。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
9:41
Breadcrumb 面包屑 · uni-app H5 实时运行 新窗口打开
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
items | BreadcrumbItem[] | [] | 面包屑项;href 渲染为 <a> 外链,to 点击仅 emit item-click 由外部跳转,最后一项渲染为当前页文本 |
separator | string | "/" | 分隔符文本,可被 separator 插槽覆盖 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
item-click | BreadcrumbItem, number | 点击非当前页项时触发,参数为该 item 与其下标 |
示例
基础用法
vue
<Breadcrumb :items="crumbs" />自定义分隔符
vue
<Breadcrumb :items="crumbs" separator=">" />监听点击
vue
<Breadcrumb :items="crumbs" @item-click="onCrumb" />