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)

Events

当前组件未暴露组件事件。

Slots

插槽名说明插槽参数
default面包屑项内容。

Expose

当前组件未暴露公开实例方法或属性。

类型导出

名称说明
YhBreadcrumbPropsYhBreadcrumb props 类型
YhBreadcrumbSlotsYhBreadcrumb slots 类型
YhBreadcrumbItemPropsYhBreadcrumbItem props 类型
YhBreadcrumbItemSlotsYhBreadcrumbItem slots 类型
YhBreadcrumbInstanceYhBreadcrumb 实例类型
YhBreadcrumbItemInstanceYhBreadcrumbItem 实例类型

Released under the MIT License.