鸿蒙HarmonyOS NEXT开发：Checkbox（基础组件）

Checkbox

提供多选框组件，通常用于某选项的打开或关闭。

说明：

API version 11开始，Checkbox默认样式由圆角方形变为圆形。

该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

子组件

无

接口

Checkbox(options?: CheckboxOptions)

多选框组件。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	描述
options	CheckboxOptions	否	配置复选框的参数。

CheckboxOptions对象说明

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

名称	类型	必填	描述
name	string	否	用于指定多选框名称。
group	string	否	用于指定多选框所属群组的名称（即所属CheckboxGroup的名称）。 说明： 未配合使用CheckboxGroup组件时，此值无用。
indicatorBuilder12+	CustomBuilder	否	配置多选框的选中样式为自定义组件。自定义组件与Checkbox组件为中心点对齐显示。indicatorBuilder设置为undefined/null时，默认为indicatorBuilder未设置状态。

属性

除支持通用属性外，还支持以下属性：

select

select(value: boolean)

设置多选框是否选中。

从API version 10开始，该属性支持$$双向绑定变量。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	描述
value	boolean	是	多选框是否选中。 默认值：false

selectedColor

selectedColor(value: ResourceColor)

设置多选框选中状态颜色。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full