更新记录

1.0.5(2024-06-24)

shape属性bug修复

1.0.4(2024-06-22)

更改说明

1.0.3(2024-06-22)

适配r-config-provider

查看更多

平台兼容性

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

r-checkbox

r-checkbox复选框,在一组备选项中进行多选。

示例

<r-checkbox v-model:value="checked">复选框</r-checkbox>
<r-checkbox v-model:value="checked" disabled>复选框</r-checkbox>
<r-checkbox-group v-model:value="checkList" shape="square">
      <r-checkbox name="a">复选框 a</r-checkbox>
      <r-checkbox name="b">复选框 b</r-checkbox>
    </r-checkbox-group>
<r-checkbox-group
  v-model:value="checkList"
  direction="horizontal"
  shape="round"
>
      <r-checkbox name="check1">复选框</r-checkbox>
      <r-checkbox name="check2">复选2</r-checkbox>
    </r-checkbox-group>
<r-checkbox v-model:value="checked" checked-color="#ee0a24">复选框</r-checkbox>
<r-checkbox v-model:value="checked" icon-size="24px">复选框</r-checkbox>

<r-checkbox v-model:value="checked">
      自定义图标
      <template #icon="props">
        <image
          style="height: 20px; width: 20px"
          :src="
            props.checked
              ? 'https://fastly.jsdelivr.net/npm/@vant/assets/user-active.png'
              : 'https://fastly.jsdelivr.net/npm/@vant/assets/user-inactive.png'
          "
        />
      </template>
    </r-checkbox>

<r-checkbox v-model:value="checked" label-position="left">复选框</r-checkbox>
<r-checkbox v-model:value="checked" label-disabled>复选框</r-checkbox>

<r-checkbox-group v-model:value="checkList" direction="vertical">
      <r-checkbox name="a">复选框 a</r-checkbox>
      <r-checkbox name="b">复选框 b</r-checkbox>
    </r-checkbox-group>

API

Checkbox Props

名称 说明 类型 默认值 可选值
value 是否为选中状态 Boolean false -
name 标识符,通常为一个唯一的字符串或数字 any - -
shape 形状 String round square dot
disabled 是否为禁用状态 Boolean false true
labelPosition 文本位置 String right left
iconSize 图标大小 String 40rpx
checkedColor 选中状态颜色 String #1989fa
bindGroup 是否与复选框组绑定 Boolean true
themeName r-theme的主题名称 String default

CheckboxGroup Props

名称 说明 类型 默认值 可选值
value 所有选中项的标识符 any - -
disabled 是否禁用所有单选框 Boolean false true
direction 排列方向 String vertical horizontal
shape 形状 String square round dot
iconSize 所有单选框的图标大小 String 40rpx
checkedColor 所有单选框的选中状态颜色 String #1989fa
themeName r-theme的主题名称 String default

Checkbox Slots

名称 说明 参数
default 自定义文本 -
icon 自定义图标 { checked: boolean, disabled: boolean }

Checkbox Events

名称 说明 回调参数
update:value 当绑定值变化时触发的事件 value
click 点击单选框时触发 e

CheckboxGroup Events

名称 说明 回调参数
update:value 当绑定值变化时触发的事件 value

隐私、权限声明

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

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

插件不采集任何数据

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

许可协议

MIT协议

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