更新记录

1.0.0(2025-02-25) 下载此版本

发布初版


平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
app-vue × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序 鸿蒙元服务
× × × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari

Checkbox 复选框

组件名: xt-checkbox

适配情况需自行尝试,开发时只测试了H5、APP、微信小程序

安装方式

本组件符合 easycom 规范,HBuilderX 3.1.0 起,只需将本组件导入项目,在页面 template 中即可直接使用,无需在页面中 import 和注册 components

基本用法

<template>
    <view class="xt">
        <xt-checkbox v-model="list">
            <xt-checkbox-item value="1">选项1</xt-checkbox-item>
            <xt-checkbox-item value="2">选项2</xt-checkbox-item>
        </xt-checkbox>
        <xt-button style="margin-top: 60rpx;" @click="log">打印</xt-button>
        <xt-button style="margin-top: 60rpx;" @click="off">禁用</xt-button>
    </view>
</template>

<script>
    export default {
        data() {
            return {
                list: [],
                no: false
            }
        },
        methods: {
            log() {
                console.log(this.list);
            },
            off() {
                this.no = !this.no
                console.log(this.no);
            }
        }
    }
</script>

<style lang="scss">
    .xt {
        padding: 0 20rpx;
        padding-top: 50rpx;
        display: flex;
        flex-direction: column;
        gap: 15rpx;
    }
</style>

xt-checkbox API

属性名 类型 说明 默认值
value Array 绑定选择值
placement String 布局方式, 可选 column row
disabled Boolean 是否禁用所有 radio false
round Boolean 是否圆形框 false
activeColor String 选中时的颜色,应用到所有子组件 #2979ff
inactiveColor String 未选中的颜色 #fff
size String | Number 组件整体的大小 36rpx
labelColor String label 的颜色 #000
labelAlign String 文字布局方向 right
endAlignment Boolean 是否两端对齐 false
iconColor String 图标颜色 #ffffff
borderBottom Boolean placement 为 row 时,是否显示下边框 false

xt-checkbox Events

方法名 说明
change 选择值改变时触发

xt-checkbox-item API

属性名 类型 说明 默认值
value String | Number | Boolean 选中值
label String 提示文字
disabled Boolean 是否禁用 false

隐私、权限声明

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

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

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

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问