更新记录

0.0.6（2025-08-31） 下载此版本

• chore: 更新文档

0.0.5（2025-04-25） 下载此版本

• feat: 兼容uniappx鸿蒙next

0.0.4（2025-02-10） 下载此版本

• feat: hbx4.51

平台兼容性

uni-app(4.75)

uni-app x(4.75)

其他

lime-sidebar 侧边导航组件

一个功能丰富的侧边导航组件，用于在不同的内容区域之间进行切换。支持徽标提示、禁用选项、自定义样式等多种配置，可用于分类列表、导航菜单、内容切换等多种场景。组件提供了丰富的自定义选项，可以满足各种复杂的导航设计需求。

插件依赖：lime-shared、lime-style、lime-badge

文档链接

📚 组件详细文档请访问以下站点：

• 侧边导航组件文档 - 站点1
• 侧边导航组件文档 - 站点2
• 侧边导航组件文档 - 站点3

安装方法

1. 在uni-app插件市场中搜索并导入lime-sidebar
2. 导入后可能需要重新编译项目
3. 在页面中使用l-sidebar和l-sidebar-item组件

代码演示

基础用法

最简单的侧边导航组件用法，通过 v-model 绑定当前选中项的索引。

<l-sidebar v-model="active">
  <l-sidebar-item title="标签名称" />
  <l-sidebar-item title="标签名称" />
  <l-sidebar-item title="标签名称" />
</l-sidebar>

// setup 语法
const active = ref(0);

徽标提示

设置 dot 属性后，会在右上角展示一个小红点；设置 badge 属性后，会在右上角展示相应的徽标。

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

禁用选项

通过 disabled 属性禁用选项。

<l-sidebar v-model="active">
  <l-sidebar-item title="标签名称" />
  <l-sidebar-item title="标签名称" disabled />
  <l-sidebar-item title="标签名称" />
</l-sidebar>

监听切换事件

设置 change 方法来监听切换导航项时的事件。

<l-sidebar v-model="active" @change="onChange">
  <l-sidebar-item title="标签名 1" />
  <l-sidebar-item title="标签名 2" />
  <l-sidebar-item title="标签名 3" />
</l-sidebar>

// setup 语法
const active = ref(0);
const onChange = (index: number) => {
  uni.showToast({
    title: `标签${index+1}`
  });
};

圆角样式

通过 round 属性设置圆角样式。

<l-sidebar v-model="active" round>
  <l-sidebar-item title="标签名称" />
  <l-sidebar-item title="标签名称" />
  <l-sidebar-item title="标签名称" />
</l-sidebar>

线条样式

通过 line 属性设置线条样式。

<l-sidebar v-model="active" line>
  <l-sidebar-item title="标签名称" />
  <l-sidebar-item title="标签名称" />
  <l-sidebar-item title="标签名称" />
</l-sidebar>

快速预览

导入插件后，可以直接使用以下标签查看演示效果：

<!-- 代码位于 uni_modules/lime-sidebar/components/lime-sidebar -->
<lime-sidebar />

插件标签说明

Vue2使用说明

main.js中添加以下代码：

// vue2项目中使用
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)

详细配置请参考官方文档：Vue Composition API

API文档

Sidebar Props 属性说明

Sidebar Events 事件

SidebarItem Props 属性说明

SidebarItem Events 事件

SidebarItem Slots 插槽

主题定制

组件提供了以下CSS变量，可用于自定义样式：

支持与赞赏

如果你觉得本插件解决了你的问题，可以考虑支持作者：

支付宝赞助	微信赞助