更新记录

0.0.9（2025-10-21） 下载此版本

• fix: 修复安卓因动画导致死循环
• chore: 更新文档

0.0.8（2025-09-26） 下载此版本

• feat: 增加immediate

0.0.7（2025-07-25） 下载此版本

• fix: 修复uniappx ios 首次无法监听尺寸变化

平台兼容性

uni-app(4.54)

uni-app x(4.75)

lime-segmented 分段器组件

一个功能丰富的分段器组件，用于在不同视图间切换。支持多种样式、尺寸和自定义选项，可用于标签切换、分类筛选等多种场景。组件提供了丰富的自定义选项，可以满足各种复杂的界面设计需求。

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

文档链接

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

• 分段器组件文档 - 站点1
• 分段器组件文档 - 站点2
• 分段器组件文档 - 站点3

安装方法

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

代码演示

基础用法

最简单的分段器组件用法，只需要设置选项数组即可。

<l-segmented v-model="value" :options="options" />

const value = ref(1);
const options = ['选项1','选项2','选项3','选项4'];

形状

通过shape设置分段器形状，可选值round。

<l-segmented shape="round" />

类型

通过type设置分段器类型，可选值有button、card、text，默认值为card。

<l-segmented v-model="value" type="button" />
<l-segmented v-model="value" type="text" />

尺寸

通过size设置分段器尺寸，可选值有small、large，默认值为medium。

<l-segmented v-model="value" size="small" />
<l-segmented v-model="value" size="large" />

自定义样式

通过color设置文本颜色，active-color设置当前状态文本颜色，bg-color设置背景色，slider-color设置滑块背景色。

<l-segmented 
  v-model="value" 
  type="button" 
  color="#34c471" 
  active-color="#fff" 
  bg-color="#f3fff8" 
  slider-color="#34c471" 
  :options="options" 
/>

受控模式

通过设置value属性和click事件实现异步控制。

<l-segmented :value="value" :options="options" @click="handleClick" />

const value = ref(1);
const handleClick = (index: number) => {
  uni.showLoading({ title: '校验中' });

  setTimeout(() => {
    uni.hideLoading();
    value.value = index;
  }, 1000);
};

快速预览

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

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

插件标签说明

• 默认 l-segmented 为组件标签
• 默认 lime-segmented 为演示标签

Vue2使用说明

本插件使用了composition-api，如需在Vue2项目中使用，请按照官方教程配置。

关键配置代码（在main.js中添加）：

// vue2
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)

API文档

Props

Events

主题定制

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

支持与赞赏

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

支付宝赞助	微信赞助