多选框组件
提供多选框组件，通常用于某选项的打开或关闭。
说明
该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
接口
Checkbox(options?: {name?: string, group?: string })
从API version 9开始，该接口支持在ArkTS卡片中使用。
参数:
参数名 | 参数类型 | 必填 | 参数描述 |
|---|---|---|---|
name | string | 否 | 多选框名称。 |
group | string | 否 | 多选框的群组名称。 说明： 未配合使用CheckboxGroup组件时，此值无用。 |
属性
除支持通用属性外，还支持以下属性：
名称 | 参数类型 | 描述 |
|---|---|---|
select | boolean | 设置多选框是否选中。 默认值：false 从API version 9开始，该接口支持在ArkTS卡片中使用。 |
selectedColor | 设置多选框选中状态颜色。 从API version 9开始，该接口支持在ArkTS卡片中使用。 |
事件
支持通用事件外，还支持以下事件：
名称 | 功能描述 |
|---|---|
onChange(callback: (value: boolean) => void) | 当选中状态发生变化时，触发该回调。 - value为true时，表示已选中。 - value为false时，表示未选中。 从API version 9开始，该接口支持在ArkTS卡片中使用。 |
示例
- // xxx.ets
- @Entry
- @Component
- struct CheckboxExample {
- build() {
- Row() {
- Checkbox({name: 'checkbox1', group: 'checkboxGroup'})
- .select(true)
- .selectedColor(0xed6f21)
- .onChange((value: boolean) => {
- console.info('Checkbox1 change is'+ value)
- })
- Checkbox({name: 'checkbox2', group: 'checkboxGroup'})
- .select(false)
- .selectedColor(0x39a2db)
- .onChange((value: boolean) => {
- console.info('Checkbox2 change is'+ value)
- })
- }
- }
- }
