Skip to content

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

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

SidebarItem Props

名称说明类型默认值可选值
title内容String-
dot是否显示图标右上角小红点Booleanfalse
badge图标右上角徽标的内容String|Number-
badgeColor徽标背景颜色String#ee0a24
max徽标最大值,超过最大值会显示 {max}+,仅当 content 为数字时有效String | Number-
offset设置徽标的偏移量,数组的两项分别对应水平向右和垂直向下方向的偏移量,默认单位为 pxArray-
showZero当 徽标值为数字 0 或字符串 '0' 时,是否展示徽标Booleantrue
position徽标位置Stringtop-righttop-left bottom-left bottom-right
disabled是否禁用该项Booleanfalse
themeName主题名称Stringdefault
名称说明回调参数
change切换导航项后触发index
update:value切换导航项时触发index

SidebarItem Events

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

SidebarItem Slots

名称说明
title自定义标题

更多组件,请前往rainui