Skip to content

Breadcrumb 面板屑

显示当前页面的路径,快速返回之前的任意页面。

展示模式

面包屑组件支持动态层级管理和智能路径折叠。

最大展示数:
智能溢出展示

基础用法

最基础的用法,通过 to 属性设置跳转路径。

基础用法

自定义分隔符

通过 separator 属性可自定义分隔符字符串。

自定义分隔符

🚀 自创高级特性

1. 智能溢出折叠 (Smart Overflow)

当导航层级过深时,设置 max-items 可自动将中间项折叠为 ...。这在窄屏容器或深层业务逻辑中能极大保护 UI 布局。

组件底层会自动感应 Nuxt 环境。在 Nuxt 3/4 中使用时,路由跳转会自动由 NuxtLink 接管,支持 Prefetch 预取。

在 Nuxt 中使用

YhBreadcrumb 完美支持 Nuxt 自动导入。

Nuxt 中使用

API

属性名说明类型默认值
separator分隔符字符串string/
separator-icon分隔符图标组件string | Component
max-items最大展示数量,超过则折叠number0 (不折叠)
属性名说明类型默认值
to路由跳转目标string | object
replace是否替换当前路由booleanfalse

主题变量

变量名说明默认值
--yh-breadcrumb-font-size字号14px
--yh-breadcrumb-item-color默认文字颜色var(--yh-text-color-regular)
--yh-breadcrumb-last-color最后一项文字颜色var(--yh-text-color-primary)

Released under the MIT License.