鸿蒙Harmony应用开发—ArkTS声明式开发（基础手势：Checkbox）

最新推荐文章于 2025-06-20 16:03:11 发布

代码与思维

最新推荐文章于 2025-06-20 16:03:11 发布

阅读量2.2k

点赞数 22

CC 4.0 BY-SA版权

分类专栏：鸿蒙鸿蒙-ArkTS 文章标签： harmonyos 华为 ArkTS ArkUI android 鸿蒙鸿蒙系统

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

说明：

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

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

无

Checkbox(options?: CheckboxOptions)

多选框组件。

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

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

参数:

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

名称	类型	必填	描述
name	string	否	用于指定多选框名称。
group	string	否	用于指定多选框所属群组的名称（即所属CheckboxGroup的名称）。说明：未配合使用CheckboxGroup组件时，此值无用。

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

名称	参数类型	描述
select	boolean	设置多选框是否选中。默认值：false 从API version 9开始，该接口支持在ArkTS卡片中使用。从API version 10开始，该属性支持$$双向绑定变量。
selectedColor	ResourceColor	设置多选框选中状态颜色。说明：默认值：$r('sys.color.ohos_id_color_text_primary_activated')。异常值按照默认值处理。从API version 9开始，该接口支持在ArkTS卡片中使用。