更新记录
1.0.0(2026-02-02)
下载此版本
- 网格布局显示选项
- 支持点击切换选中状态
- 可配置每行显示数量
- 支持多种数据类型
平台兼容性
uni-app(5.0)
| Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
Android |
iOS |
鸿蒙 |
| - |
√ |
√ |
- |
√ |
- |
- |
- |
- |
| 微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
小红书小程序 |
快应用-华为 |
快应用-联盟 |
| - |
- |
- |
- |
- |
- |
- |
- |
- |
- |
- |
- |
uni-app x(5.0)
| Chrome |
Safari |
Android |
iOS |
鸿蒙 |
微信小程序 |
| - |
- |
- |
- |
- |
- |
Check-Button 复选按钮组
网格布局的复选按钮组,支持单选和多选模式。

功能特性
- 网格布局显示选项
- 支持点击切换选中状态
- 可配置每行显示数量
- 支持多种数据类型
Props
| 属性名 |
类型 |
默认值 |
说明 |
| modelValue |
String/Number/Object |
"" |
选中的值 |
| list |
Array |
[] |
选项列表,格式:[{label: '', value: ''}] |
| row |
String |
"1" |
每行显示数量 |
Events
| 事件名 |
参数 |
说明 |
| update:modelValue |
- |
值变化时触发 |
| click |
- |
点击选项时触发 |
使用示例
<template>
<Check-Button
v-model="selectedId"
:list="cityList"
row="3"
@click="handleSelect"
/>
</template>
<script setup>
import { ref } from 'vue';
import CheckButton from '@/components/Check-Button.vue';
const selectedId = ref('');
const cityList = [
{ label: '广州市', value: '1' },
{ label: '深圳市', value: '2' },
{ label: '东莞市', value: '3' },
];
</script>