更新记录
1.1.1(2024-08-06)
下载此版本
修改文档
1.1.0(2024-07-30)
下载此版本
适配r-config-provider
1.0.9(2024-07-23)
下载此版本
修复控制台警告
查看更多
平台兼容性
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
复选框,在一组备选项中进行多选。
示例
<template>
<view class="content">
<!-- <r-badge :content="20" /> -->
<r-config-provider>
<view style="padding: 20px">
<r-divider content-position="left">基础使用</r-divider>
<r-checkbox v-model:value="checked">复选框</r-checkbox>
<r-divider content-position="left">禁用状态</r-divider>
<r-checkbox v-model:value="checked" disabled>复选框</r-checkbox>
<r-divider content-position="left">自定义形状</r-divider>
<r-checkbox-group v-model:value="checked2" shape="round">
<r-checkbox name="a">复选框 a</r-checkbox>
<r-checkbox name="b">复选框 b</r-checkbox>
</r-checkbox-group>
<r-divider content-position="left">自定义颜色</r-divider>
<r-checkbox v-model:value="checked" checked-color="#ee0a24"
>复选框</r-checkbox
>
<r-divider content-position="left">自定义大小</r-divider>
<r-checkbox v-model:value="checked" icon-size="24px">复选框</r-checkbox>
<r-divider content-position="left">自定义图标</r-divider>
<r-checkbox v-model:value="checked">
自定义图标
<template #icon="props">
<r-image
width="20px"
height="20px"
:src="props.checked ? activeIcon : inactiveIcon"
/>
</template>
</r-checkbox>
<r-divider content-position="left">左侧文本</r-divider>
<r-checkbox v-model:value="checked" label-position="left"
>复选框</r-checkbox
>
<r-divider content-position="left">复选框组</r-divider>
<r-checkbox-group v-model:value="checked2">
<r-checkbox name="a">复选框 a</r-checkbox>
<r-checkbox name="b">复选框 b</r-checkbox>
</r-checkbox-group>
<r-divider content-position="left">水平排列</r-divider>
<r-checkbox-group v-model:value="checked2" direction="horizontal">
<r-checkbox name="a">复选框 a</r-checkbox>
<r-checkbox name="b">复选框 b</r-checkbox>
</r-checkbox-group>
</view>
<view style="padding: 20px"></view>
</r-config-provider>
</view>
</template>
<script setup>
import { ref } from "vue";
const activeIcon = ref(
"https://fastly.jsdelivr.net/npm/@vant/assets/user-active.png"
);
const inactiveIcon = ref(
"https://fastly.jsdelivr.net/npm/@vant/assets/user-inactive.png"
);
const checked = ref(false);
const checked2 = ref([]);
</script>
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 |
change |
当绑定值变化后触发的事件 |
value |
click |
点击单选框时触发 |
e |
CheckboxGroup Events
名称 |
说明 |
回调参数 |
update:value |
当绑定值变化时触发的事件 |
value |
change |
当绑定值变化后触发的事件 |
value |
更多组件,请前往rainui