扩展组件(uni-ui)之uni-breadcrumb

135 阅读1分钟

uni-breadcrumb 是 uni-app 中的一个扩展组件,属于 uni-ui 组件库的一部分。这个组件主要用于展示当前页面的路径,帮助用户了解当前位置以及快速返回上级页面。它在构建具有层级结构的页面时非常有用,如文件目录、网站导航等。

基本用法

在使用 uni-breadcrumb 之前,你需要确保已经正确安装了 uni-ui 库,并在页面中引入了 uni-breadcrumbuni-breadcrumb-item 组件。

引入组件

<template>
    <uni-breadcrumb>
        <uni-breadcrumb-item text="首页" to="/pages/index/index"></uni-breadcrumb-item>
        <uni-breadcrumb-item text="分类" to="/pages/category/index"></uni-breadcrumb-item>
        <uni-breadcrumb-item text="详情页"></uni-breadcrumb-item>
    </uni-breadcrumb>
</template>

<script>
    import uniBreadcrumb from '@dcloudio/uni-ui/lib/uni-breadcrumb/uni-breadcrumb.vue'
    import uniBreadcrumbItem from '@dcloudio/uni-ui/lib/uni-breadcrumb-item/uni-breadcrumb-item.vue'
    export default {
        components: { uniBreadcrumb, uniBreadcrumbItem }
    }
</script>

属性和事件

  • uni-breadcrumb 组件本身不带有特殊的属性和事件。
  • uni-breadcrumb-item 的主要属性包括:
    • text:显示的文本内容。
    • to:点击后的跳转链接,可以是页面路径或者外部链接。

示例

在下面的例子中,创建了一个简单的面包屑导航,包括“首页”、“分类”和“详情页”三个层级:

<uni-breadcrumb>
    <uni-breadcrumb-item text="首页" to="/pages/index/index"></uni-breadcrumb-item>
    <uni-breadcrumb-item text="分类" to="/pages/category/index"></uni-breadcrumb-item>
    <uni-breadcrumb-item text="详情页"></uni-breadcrumb-item>
</uni-breadcrumb>

注意事项

  • 面包屑导航通常用于展示页面的层级关系,不适合作为主要的导航工具。
  • 在设置 to 属性时,请确保提供的路径是正确的,以便于正确导航。

更多关于 uni-breadcrumb 组件的使用细节,可以查阅 uni-app 官方文档 或 uni-ui 库的相关文档。