Checkbox多选框

多选框

何时使用

  • 在一组可选项中进行多项选择时;
  • 单独使用可以表示两种状态之间的切换,和 switch 类似。区别在于切换 switch 会直接触发状态改变,而 checkbox 一般用于状态标记,需要和提交操作配合。

    代码演示

基本用法

简单的checkbox

expand code expand code

全选

在实现全选效果时,你可能会用到indeterminate属性

expand code expand code

不可用

checkbox 不可用

expand code expand code

受控的checkbox

联动checkbox

expand code expand code



Checkbox组

方便的从数组生成checkbox

expand code expand code

布局

Checkbox.Group内嵌Checkbox并与Grid组件一起使用,可以实现灵活的布局

expand code expand code

API

属性

Checkbox

参数 说明 类型 默认值
autoFocus 自动获取焦点 boolean false
checked 指定当前是否选中 boolean false
defaultChecked 初始是否选中 boolean false
disabled 失效状态 boolean false
indeterminate 设置 indeterminate 状态,只负责样式控制 boolean false

事件

事件名称 说明 回调参数
change 变化时回调函数 Function(e:Event)

Checkbox Group

参数 说明 类型 默认值
defaultValue 默认选中的选项 string[] []
disabled 整组失效 boolean false
options 指定可选项,可以通过 slot="label" slot-scope="option" 定制label string[] | Array<{ label: string value: string disabled?: boolean, onChange?: function }> []
value 指定选中的选项 string[] []

事件

事件名称 说明 回调参数
change 变化时回调函数 Function(checkedValue)

方法

Checkbox

名称 描述
blur() 移除焦点
focus() 获取焦点
  Cascader 级联选择DatePicker 日期选择框