更新记录

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 为对应数据项。

实际效果可进入小程序查看

示例

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

暂无用户评论。