Skip to content

Breadcrumb 面包屑

显示当前页面在系统层级中的位置,并提供向上导航能力。

何时使用

  • 系统层级 ≥ 3 级时辅助用户定位。
  • 详情页头部展示 "返回路径",支持多级跳转回。

基本使用

最常见的写法:用一组 <c-breadcrumb-item> 组合,最末一级是当前页(不带链接)。

用 routes 数据驱动

适合从路由表 / 后端响应直接生成路径。routes[i].href 提供链接,routes[i].breadcrumbName 提供文字;最末一项不渲染为 <a>

自定义分隔符

separator 可以是任意字符串。

单项自定义分隔符

某项的 separator 属性会覆盖整组的分隔符。

用 #separator 插槽

用 slot 写自定义分隔符,可以放图标 / SVG / 文字组合。

配合按钮

面包屑右侧常和操作按钮并列,可用 flex 布局。

API

参数类型默认值说明
separatorstring'/'分隔符
routesBreadcrumbRoute[][]路由数据,提供时优先于默认插槽
字段类型说明
breadcrumbNamestring显示文本
titlestringbreadcrumbName 的别名
hrefstring链接地址
pathstring链接地址(兼容字段,与 href 等价)
参数类型默认值说明
hrefstring''设置后整项渲染为 <a>
separatorstring''单项级别覆盖父级 separator
名称说明
default内容
separator自定义分隔符(覆盖字符形式)

Released under the MIT License.