Checkbox 多选框

用于从多个选项中选择一个或多个结果,支持样式切换、全选和卡片态。

演示

9:41

代码示例

<re-checkbox-group :value="baseValue" @change="onBaseChange">
  <re-checkbox label="多选" value="checkbox1" />
  <re-checkbox label="多选" value="checkbox2" />
  <re-checkbox label="多选标题多行多选标题多行多选标题多行多选标题多行多选标题多行" value="checkbox3" />
  <re-checkbox label="多选" content="描述信息描述信息描述信息描述信息描述信息描述信息描述信息描述信息" value="checkbox4" borderless />
  <re-checkbox-group :value="horizontalValue" borderless customStyle="flex-direction:row;flex-wrap:wrap;justify-content:space-between;padding-top:16px;padding-right:16px;padding-bottom:16px;padding-left:16px;background-color:#ffffff;" @change="onHorizontalChange">
  <re-checkbox class="demo-inline-checkbox" :block="false" :borderless="true" label="多选标题" value="checkbox1" />
  <re-checkbox class="demo-inline-checkbox" :block="false" :borderless="true" label="多选标题" value="checkbox2" />
  <re-checkbox class="demo-inline-checkbox" :block="false" :borderless="true" label="上限四字" value="checkbox3" />
  <re-checkbox-group :value="checkAllValue" @change="onCheckAllChange">
  <re-checkbox label="全选" :checkAll="true" value="all" />
  <re-checkbox label="多选" value="1" />
  <re-checkbox label="多选" value="2" />
  <re-checkbox label="多选" content="描述信息描述信息描述信息描述信息描述信息描述信息描述信息" value="3" borderless />
  <re-checkbox-group :value="disabledValue" :disabled="true">
  <re-checkbox label="选项禁用-已选" value="checkbox1" />
  <re-checkbox label="选项禁用-默认" value="checkbox2" borderless />
  <re-checkbox :checked="lineChecked" icon="line" label="多选" @change="onLineChange" />
  <re-checkbox :checked="rectangleChecked" icon="rectangle" label="多选" @change="onRectangleChange" />
  <re-checkbox :checked="imageChecked" :icon="imageIcons" label="图片图标" borderless @change="onImageChange" />
  <re-checkbox :checked="leftChecked" label="多选" @change="onLeftCheckedChange" />
  <re-checkbox :checked="rightChecked" label="多选" placement="right" borderless @change="onRightCheckedChange" />
  <re-checkbox-group :value="cardValue" @change="onCardChange" customStyle="border-radius:12px;overflow:hidden;">
  <re-checkbox label="多选" value="1" />
  <re-checkbox label="多选" value="2" />
  <re-checkbox label="多选标题多行多选标题多行多选标题多行多选标题多行多选标题" value="3" borderless />
  <re-checkbox-group :value="specialValue" borderless icon="none" @change="onSpecialChange">
  <re-checkbox label="多选" content="描述信息描述信息描述信息描述信息描述信息" value="0" icon="none" :borderless="true" />
  <re-checkbox label="多选" content="描述信息描述信息描述信息描述信息描述信息" value="1" icon="none" :borderless="true" />
  <re-checkbox label="多选" content="描述信息描述信息描述信息描述信息描述信息" value="2" icon="none" :borderless="true" />
  <re-checkbox-group :value="specialHorizontalValue" borderless icon="none" customStyle="flex-direction:row;flex-wrap:wrap;justify-content:space-between;margin-top:16px;" @change="onSpecialHorizontalChange">
  <re-checkbox label="多选" value="0" icon="none" :borderless="true" />
  <re-checkbox label="多选" value="1" icon="none" :borderless="true" />
  <re-checkbox label="多选" value="2" icon="none" :borderless="true" />

引入

推荐使用 easycom 模式,配置后无需手动 import 即可直接使用 <re-checkbox />。

API

Checkbox Props

名称类型默认值描述必传
checkedbooleanfalse-N
disabledbooleanfalse是否禁用N
labelstring''-N
contentstring''内容文字N
valuestring | number''当前值N
namestring''标识名称N
blockbooleantrue是否为块级元素,占满父容器宽度N
borderlessbooleanfalse-N
placementstring''-N
iconstring | Array<string>'circle'图标,支持字体图标名称或图片地址N
indeterminatebooleanfalse-N
readonlybooleanfalse-N
checkAllbooleanfalse-N
iconSizenumber | string20-N
iconGapnumber | string8-N
customStylestring''自定义样式N

Checkbox Events

名称参数描述
changechecked: boolean, value: string值变化时触发
click-点击时触发

Checkbox Slots

名称描述
default默认插槽
label-
content-

CheckboxGroup Props

名称类型默认值描述必传
valueArray<string>(): Array<string> => as Array<string>当前值N
disabledbooleanfalse是否禁用N
readonlybooleanfalse-N
borderlessbooleanfalse-N
placementstring'left'-N
iconstring | Array<string>'circle'图标,支持字体图标名称或图片地址N
maxnumber0-N
optionsArray<UTSJSONObject>null as unknown as Array<UTSJSONObject>-N
customStylestring''自定义样式N

CheckboxGroup Events

名称参数描述
changevalue: Array<string>值变化时触发

CheckboxGroup Slots

名称描述
default默认插槽