Breadcrumb 面板屑
显示当前页面的路径,快速返回之前的任意页面。
展示模式
面包屑组件支持动态层级管理和智能路径折叠。
最大展示数:
首页/...导航组件/面包屑配置/当前节点/
智能溢出展示
基础用法
最基础的用法,通过 to 属性设置跳转路径。
首页/组件/面包屑/
基础用法
自定义分隔符
通过 separator 属性可自定义分隔符字符串。
首页>层级一>层级二>
首页~层级一~层级二~
自定义分隔符
🚀 自创高级特性
1. 智能溢出折叠 (Smart Overflow)
当导航层级过深时,设置 max-items 可自动将中间项折叠为 ...。这在窄屏容器或深层业务逻辑中能极大保护 UI 布局。
2. 路由无缝适配 (NuxtLink Compatible)
组件底层会自动感应 Nuxt 环境。在 Nuxt 3/4 中使用时,路由跳转会自动由 NuxtLink 接管,支持 Prefetch 预取。
在 Nuxt 中使用
YhBreadcrumb 完美支持 Nuxt 自动导入。
首页/仪表盘/
Nuxt 中使用
API
Breadcrumb Props
| 属性名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| separator | 分隔符字符串 | string | / |
| separator-icon | 分隔符图标组件 | string | Component | — |
| max-items | 最大展示数量,超过则折叠 | number | 0 (不折叠) |
BreadcrumbItem Props
| 属性名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| to | 路由跳转目标 | string | object | — |
| replace | 是否替换当前路由 | boolean | false |
主题变量
| 变量名 | 说明 | 默认值 |
|---|---|---|
--yh-breadcrumb-font-size | 字号 | 14px |
--yh-breadcrumb-item-color | 默认文字颜色 | var(--yh-text-color-regular) |
--yh-breadcrumb-last-color | 最后一项文字颜色 | var(--yh-text-color-primary) |