前言:
控制单个或者多个选项的选中状态,就可以使用 多选框组件
- Checkbox:多选框组件
- CheckboxGroup:多选框组,控制多个多选框
Checkbox:
参数CheckboxOptions说明
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| name | string | 否 | 用于指定多选框名称。一般结合CheckboxGroup一起使用 |
| group | string | 否 | 用于指定多选框所属群组的名称(即所属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卡片中使用。 |
| unselectedColor | ResourceColor | 设置多选框非选中状态边框颜色。 |
| shape | CheckBoxShape | 设置CheckBox组件形状, 包括圆形和圆角方形。 说明: 默认值:CheckBoxShape.CIRCLE。 |
@Entry
@Component
struct Index {
@State isChecked:boolean = false
build() {
Column(){
Text('选中状态:'+this.isChecked)
Row(){
Checkbox()
.borderWidth(0)
.selectedColor('#ab8b53')
.select($$this.isChecked)
Text(){
Span('已阅读并同意')
.fontColor(Color.Gray)
Span('《用户协议》')
Span('《隐私协议》')
}
.fontSize(14)
.fontColor('#0094ff')
}
Button('切换选中状态')
.onClick(()=>{
this.isChecked=!this.isChecked
})
}
.padding(20)
}
}