Checkbox Group

::: sourceCode

checkbox-group

:::

组件类型：UniCheckboxGroupElement

多选框组

给checkbox-group设置name属性后，内部包含的多个checkbox将以数组的方式统一提交表单。详见form

兼容性

Web	微信小程序	Android	iOS	HarmonyOS	HarmonyOS(Vapor)
4.0	4.41	3.9	4.11	4.61	5.0

属性

名称	类型	默认值	兼容性	描述
name	string	-	Web: 4.0; 微信小程序: 4.41; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61; HarmonyOS(Vapor): 5.0	表单的控件名称，作为键值对的一部分与表单(form组件)一同提交
@change	(event: UniCheckboxGroupChangeEvent) => void	-	Web: 4.0; 微信小程序: 4.41; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61; HarmonyOS(Vapor): 5.0	checkbox-group中选中项发生改变是触发 change 事件，detail = {value:[选中的checkbox的value的数组]

事件

UniCheckboxGroupChangeEvent

mermaid

graph LR
  
UniCheckboxGroupChangeEvent -- Extends --> UniCustomEvent&ltUniCheckboxGroupChangeEventDetail&gt
  style UniCustomEvent&ltUniCheckboxGroupChangeEventDetail&gt color:#42b983
  click UniCustomEvent&ltUniCheckboxGroupChangeEventDetail&gt "https://doc.dcloud.net.cn/uni-app-x/component/common.html#unicustomevent"

UniCheckboxGroupChangeEventDetail

UniCheckboxGroupChangeEventDetail 的属性值

名称	类型	必填	默认值	兼容性	描述
value	Array<string>	是	-	-	-

子组件 @children-tags

子组件	兼容性
*	Web: 4.0; 微信小程序: 4.41; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61; HarmonyOS(Vapor): 5.0

checkbox-group

兼容性

属性

事件

UniCheckboxGroupChangeEvent

UniCheckboxGroupChangeEventDetail

UniCheckboxGroupChangeEventDetail 的属性值

子组件 @children-tags

参见