r-sidebar
r-sidebar 侧边导航,垂直展示的导航栏,用于在不同的内容区域之间进行切换。
示例
vue
<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
