更新记录
1.0.0(2026-07-13)
下载此版本
初始版本
平台兼容性
uni-app(4.0)
| Vue2 |
Vue2插件版本 |
Vue3 |
Vue3插件版本 |
Chrome |
Chrome插件版本 |
Safari |
Safari插件版本 |
app-vue |
app-nvue |
Android |
Android插件版本 |
iOS |
鸿蒙 |
| √ |
1.0.0 |
√ |
1.0.0 |
√ |
1.0.0 |
√ |
1.0.0 |
- |
- |
√ |
1.0.0 |
- |
- |
| 微信小程序 |
微信小程序插件版本 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
小红书小程序 |
快应用-华为 |
快应用-联盟 |
| √ |
1.0.0 |
- |
- |
- |
- |
- |
- |
- |
- |
- |
- |
- |
zv-segmented
分段器,支持滑动块、边框按钮、卡片、文字下划线等样式。
基础用法(slider,默认,兼容旧版)
<zv-segmented
:tabs="['全部', '待支付', '已完成']"
:item-w="200"
:item-h="80"
:radius="50"
bg-color="#fff"
@change="onChange"
/>
样式类型 type
| type |
说明 |
| slider |
滑动色块(默认,等同旧版) |
| button |
基础边框按钮组,选中项填色 |
| card |
灰底 + 白色滑动卡片 |
| text |
纯文字 + 底部指示条 |
基础使用(button)
<zv-segmented
type="button"
shape="round"
:tabs="['未付款', '待评价', '已付款']"
:item-w="220"
:item-h="72"
bg-color="#ffffff"
select-bg-color="#2979ff"
select-color="#ffffff"
:border-width="2"
/>
卡片样式(card)
<zv-segmented
type="card"
shape="round"
:tabs="['未付款', '待评价', '已付款']"
:item-w="220"
:item-h="72"
bg-color="#f2f3f5"
select-bg-color="#ffffff"
select-color="#2979ff"
color="#333333"
/>
card 模式:select-bg-color = 滑块背景色,select-color = 选中文字色(勿与 slider 模式混淆)
文字样式(text)
<zv-segmented
type="text"
:tabs="['未付款', '待评价', '已付款']"
:item-w="220"
:item-h="72"
select-bg-color="#2979ff"
color="#666666"
/>
插槽
<zv-segmented type="card" :tabs="tabs" block :item-h="120">
<template #item="{ item, index, active, label }">
<view class="col center">
<image :src="item.icon" style="width:48rpx;height:48rpx;" />
<text :style="{ color: active ? '#2979ff' : '#333' }">{{ label }}</text>
</view>
</template>
</zv-segmented>
受控 / v-model
<zv-segmented v-model="current" :tabs="tabs" type="card" block />
<!-- 或使用 select -->
<zv-segmented :select="current" :tabs="tabs" @change="current = $event" />
主要参数
| 参数 |
说明 |
默认 |
| tabs / options |
选项,字符串或 { label, disabled } |
- |
| type |
slider / button / card / text |
slider |
| shape |
square / round |
square |
| block |
是否撑满宽度均分 |
false |
| itemW / itemH |
项宽高 rpx |
300 / 100 |
| select / v-model |
选中索引 |
0 |
| aTime |
动画 ms |
300 |
| radius |
圆角 rpx,0 时 round 形自动半高 |
0 |
| bgColor / color |
背景 / 文字色 |
- |
| selectBgColor / selectColor |
选中背景 / 文字 |
- |
| borderColor / borderWidth |
button 边框 |
主题色 / 2 |
| disableTouch |
禁止点击切换 |
false |
| customStyle / itemStyle / activeItemStyle |
自定义样式 |
- |
change 事件
(index, item) — index 为选中下标,item 为对应数据项。
实际效果请查看小程序或app
| 小程序示例 |
app示例 |
 |
 |