更新记录
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 为对应数据项。
实际效果可进入小程序查看


收藏人数:
下载插件并导入HBuilderX
赞赏(0)
下载 52
赞赏 0
下载 12420951
赞赏 1934
赞赏
京公网安备:11010802035340号