跳到主要内容

Breadcrumb 面包屑 ​

uni-appH5微信小程序App

跨端层级路径导航,点击非当前项通过 item-click 交给外部处理。

何时使用 ​

页面层级 ≥ 2 层,需要告知用户当前位置并支持向上回跳。

何时不使用 ​

平级内容切换用 Tabs;只有一层结构时无需面包屑。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Breadcrumb 面包屑 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
itemsBreadcrumbItem[][]面包屑项;href 渲染为 <a> 外链,to 点击仅 emit item-click 由外部跳转,最后一项渲染为当前页文本
separatorstring"/"分隔符文本,可被 separator 插槽覆盖

Events ​

名称载荷说明
item-clickBreadcrumbItem, number点击非当前页项时触发,参数为该 item 与其下标

示例 ​

基础用法 ​

vue
<Breadcrumb :items="crumbs" />

自定义分隔符 ​

vue
<Breadcrumb :items="crumbs" separator=">" />

监听点击 ​

vue
<Breadcrumb :items="crumbs" @item-click="onCrumb" />