多选框组件
2024-01-22 17:05 更新
提供多选框组件,通常用于某选项的打开或关闭。
说明
该组件从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)
- })
- }
- }
- }
以上内容是否对您有帮助:
← 按钮组件
更多建议: