更新记录

1.0.3(2024-08-06) 下载此版本

修改文档

1.0.2(2024-07-30) 下载此版本

适配r-config-provider

1.0.1(2024-07-23) 下载此版本

修复控制台警告

查看更多

平台兼容性

Vue2 Vue3
×
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.1.0 app-vue
钉钉小程序 快手小程序 飞书小程序 京东小程序 鸿蒙元服务
×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari

r-sidebar

r-sidebar 侧边导航,垂直展示的导航栏,用于在不同的内容区域之间进行切换。

示例

<template>
  <r-config-provider>
    <view style="padding: 20px; background-color: #f8f7f6">
      <r-divider content-position="left">基本使用</r-divider>
      <r-sidebar v-model:value="active">
        <r-sidebar-item title="标签名称" />
        <r-sidebar-item title="标签名称" />
        <r-sidebar-item title="标签名称" />
      </r-sidebar>

      <r-divider content-position="left">徽标提示</r-divider>

      <r-sidebar v-model:value="active">
        <r-sidebar-item title="标签名称" dot />
        <r-sidebar-item title="标签名称" badge="5" />
        <r-sidebar-item title="标签名称" />
      </r-sidebar>

      <r-divider content-position="left">禁用选项</r-divider>
      <r-sidebar v-model:value="active">
        <r-sidebar-item title="标签名称" />
        <r-sidebar-item title="标签名称" disabled />
        <r-sidebar-item title="标签名称" />
      </r-sidebar>

      <r-divider content-position="left">监听切换事件</r-divider>

      <r-sidebar v-model:value="active" @change="onChange">
        <r-sidebar-item title="标签名 1" />
        <r-sidebar-item title="标签名 2" />
        <r-sidebar-item title="标签名 3" />
      </r-sidebar>
    </view>
  </r-config-provider>
</template>

<script setup>
import { ref } from "vue";
const active = ref(0);
const onChange = (index) => {
  console.log(index);
};
</script>

API

Sidebar Props

名称 说明 类型 默认值 可选值
value 当前导航项的索引 Number|String 0
themeName 主题名称 String default

SidebarItem Props

名称 说明 类型 默认值 可选值
title 内容 String -
dot 是否显示图标右上角小红点 Boolean false
badge 图标右上角徽标的内容 String|Number -
badgeColor 徽标背景颜色 String #ee0a24
max 徽标最大值,超过最大值会显示 {max}+,仅当 content 为数字时有效 String | Number -
offset 设置徽标的偏移量,数组的两项分别对应水平向右和垂直向下方向的偏移量,默认单位为 px Array -
showZero 当 徽标值为数字 0 或字符串 '0' 时,是否展示徽标 Boolean true
position 徽标位置 String top-right top-left bottom-left bottom-right
disabled 是否禁用该项 Boolean false
themeName 主题名称 String default

Sidebar Events

名称 说明 回调参数
change 切换导航项后触发 index
update:value 切换导航项时触发 index

SidebarItem Events

名称 说明 回调参数
click 点击时触发 index

SidebarItem Slots

名称 说明
title 自定义标题

更多组件,请前往rainui

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问