You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
ant-design-vue/components/checkbox/index.zh-CN.md

2.2 KiB

category subtitle type title cover
Components 多选框 数据录入 Checkbox https://gw.alipayobjects.com/zos/alicdn/8nbVbHEm_/CheckBox.svg

多选框。

何时使用

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

API

属性

Checkbox

参数 说明 类型 默认值 版本
autofocus 自动获取焦点 boolean false
checked(v-model) 指定当前是否选中 boolean false
disabled 失效状态 boolean false
indeterminate 设置 indeterminate 状态,只负责样式控制 boolean false

事件

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

Checkbox Group

参数 说明 类型 默认值 版本
disabled 整组失效 boolean false
name CheckboxGroup 下所有 input[type="checkbox"]name 属性 string - 1.5.0
options 指定可选项,可以通过 slot="label" slot-scope="option" 定制label string[] | Array<{ label: string value: string disabled?: boolean, indeterminate?: boolean, onChange?: function }> []
value(v-model) 指定选中的选项 string[] []

事件

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

方法

Checkbox

名称 描述 版本
blur() 移除焦点
focus() 获取焦点