鸿蒙5.0开发进阶:UI框架-ArkTS组件(CheckboxGroup)

鸿蒙HarmonyOS NEXT开发:CheckboxGroup(基础组件) 多选框群组,用于控制多选框全选或者不全选状态。 阅读详情

往期鸿蒙全套实战文章必看:(文中附带全栈鸿蒙学习资料)


CheckboxGroup

多选框群组,用于控制多选框全选或者不全选状态。

说明

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

子组件

无

接口

CheckboxGroup(options?: CheckboxGroupOptions)

创建多选框群组,可以控制群组内的Checkbox全选或者不全选,group值相同的Checkbox和CheckboxGroup为同一群组。

在结合带缓存组件使用时(如List),未被创建的Checkbox选中状态需要应用手动控制。

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

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

参数:

参数名类型必填说明
optionsCheckboxGroupOptions否配置多选框群组参数。

CheckboxGroupOptions对象说明

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

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

名称类型必填说明
groupstring否

群组名称。

说明:

多个相同群组名称的CheckboxGroup,仅第一个CheckboxGroup生效。

属性

除支持通用属性外,还支持以下属性:

selectAll

selectAll(value: boolean)

设置是否全选。若同组的Checkbox显式设置了select属性,则Checkbox的优先级高。

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

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

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

参数:

参数名类型必填说明
valueboolean是

是否全选。

默认值:false

selectedColor

selectedColor(value: ResourceColor)

设置被选中或部分选中状态的颜色。

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

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

参数:

参数名类型必填说明
valueResourceColor是

被选中或部分选中状态的颜色。

默认值:$r('sys.color.ohos_id_color_text_primary_activated')

异常值按照默认值处理。

unselectedColor10+

unselectedColor(value: ResourceColor)

设置非选中状态边框颜色。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

参数:

参数名类型必填说明
valueResourceColor是

非选中状态边框颜色。

默认值:$r('sys.color.ohos_id_color_switch_outline_off')。

mark10+

mark(value: MarkStyle)

设置多选框内部图标样式。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

参数:

参数名类型必填说明
valueMarkStyle是多选框内部图标样式。

checkboxShape12

checkboxShape(value: CheckBoxShape)

设置CheckboxGroup组件形状, 包括圆形和圆角方形。

卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

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

参数:

参数名类型必填说明
valueCheckBoxShape是

设置CheckboxGroup组件形状, 包括圆形和圆角方形。

默认值:CheckBoxShape.CIRCLE。

说明:

CheckboxGroup组件形状按照设置显示。

CheckboxGroup内所有没有单独设置shape类型的Checkbox形状和CheckboxGroup的保持一致。

CheckboxGroup内有单独设置shape类型的Checkbox形状则优先于CheckboxGroup,按照设置形状显示。

事件

除支持通用事件外,还支持以下事件:

onChange

onChange(callback: (event: CheckboxGroupResult) => void )

CheckboxGroup的选中状态或群组内的Checkbox的选中状态发生变化时,触发回调。

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

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

参数:

参数名类型必填说明
eventCheckboxGroupResult是多选框群组的信息。

CheckboxGroupResult对象说明

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

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

名称类型只读可选说明
nameArray<string>否否群组内所有被选中的多选框名称。
statusSelectStatus否否选中状态。

SelectStatus枚举说明

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

元服务API: 从API version 11开始,该接口支持在元服务中使用。

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

名称描述
All群组多选择框全部选择。
Part群组多选择框部分选择。
None群组多选择框全部没有选择。

示例

示例1(设置多选框群组)

该示例用于控制多选框全选或者不全选状态。

// xxx.ets
@Entry
@Component
struct CheckboxExample {
  build() {
    Scroll() {
      Column() {
        // 全选按钮
        Flex({ justifyContent: FlexAlign.Start, alignItems: ItemAlign.Center }) {
          CheckboxGroup({ group: 'checkboxGroup' })
            .checkboxShape(CheckBoxShape.ROUNDED_SQUARE)
            .selectedColor('#007DFF')
            .onChange((itemName: CheckboxGroupResult) => {
              console.info("checkbox group content" + JSON.stringify(itemName))
            })
          Text('Select All').fontSize(14).lineHeight(20).fontColor('#182431').fontWeight(500)
        }

        // 选项1
        Flex({ justifyContent: FlexAlign.Start, alignItems: ItemAlign.Center }) {
          Checkbox({ name: 'checkbox1', group: 'checkboxGroup' })
            .selectedColor('#007DFF')
            .shape(CheckBoxShape.ROUNDED_SQUARE)
            .onChange((value: boolean) => {
              console.info('Checkbox1 change is' + value)
            })
          Text('Checkbox1').fontSize(14).lineHeight(20).fontColor('#182431').fontWeight(500)
        }.margin({ left: 36 })

        // 选项2
        Flex({ justifyContent: FlexAlign.Start, alignItems: ItemAlign.Center }) {
          Checkbox({ name: 'checkbox2', group: 'checkboxGroup' })
            .selectedColor('#007DFF')
            .shape(CheckBoxShape.ROUNDED_SQUARE)
            .onChange((value: boolean) => {
              console.info('Checkbox2 change is' + value)
            })
          Text('Checkbox2').fontSize(14).lineHeight(20).fontColor('#182431').fontWeight(500)
        }.margin({ left: 36 })

        // 选项3
        Flex({ justifyContent: FlexAlign.Start, alignItems: ItemAlign.Center }) {
          Checkbox({ name: 'checkbox3', group: 'checkboxGroup' })
            .selectedColor('#007DFF')
            .shape(CheckBoxShape.ROUNDED_SQUARE)
            .onChange((value: boolean) => {
              console.info('Checkbox3 change is' + value)
            })
          Text('Checkbox3').fontSize(14).lineHeight(20).fontColor('#182431').fontWeight(500)
        }.margin({ left: 36 })
      }
    }
  }
}

示例2(自定义勾选样式)

该示例通过配置mark实现自定义多选框群组的勾选样式。

// xxx.ets
@Entry
@Component
struct Index {

  build() {
    Row() {
      Column() {
        Flex({ justifyContent: FlexAlign.Center, alignItems: ItemAlign.Center }) {
          CheckboxGroup({ group: 'checkboxGroup' })
            .checkboxShape(CheckBoxShape.ROUNDED_SQUARE)
            .selectedColor(Color.Orange)
            .onChange((itemName: CheckboxGroupResult) => {
              console.info("checkbox group content" + JSON.stringify(itemName))
            })
            .mark({
              strokeColor:Color.Black,
              size: 40,
              strokeWidth: 5
            })
            .unselectedColor(Color.Red)
            .width(30)
            .height(30)
          Text('Select All').fontSize(20)
        }.margin({right:15})
        Flex({ justifyContent: FlexAlign.Center, alignItems: ItemAlign.Center }) {
          Checkbox({ name: 'checkbox1', group: 'checkboxGroup' })
            .selectedColor(0x39a2db)
            .shape(CheckBoxShape.ROUNDED_SQUARE)
            .onChange((value: boolean) => {
              console.info('Checkbox1 change is'+ value)
            })
            .mark({
              strokeColor:Color.Black,
              size: 50,
              strokeWidth: 5
            })
            .unselectedColor(Color.Red)
            .width(30)
            .height(30)
          Text('Checkbox1').fontSize(20)
        }
        Flex({ justifyContent: FlexAlign.Center, alignItems: ItemAlign.Center }) {
          Checkbox({ name: 'checkbox2', group: 'checkboxGroup' })
            .selectedColor(0x39a2db)
            .shape(CheckBoxShape.ROUNDED_SQUARE)
            .onChange((value: boolean) => {
              console.info('Checkbox2 change is' + value)
            })
            .width(30)
            .height(30)
          Text('Checkbox2').fontSize(20)
        }
        Flex({ justifyContent: FlexAlign.Center, alignItems: ItemAlign.Center }) {
          Checkbox({ name: 'checkbox3', group: 'checkboxGroup' })
            .selectedColor(0x39a2db)
            .shape(CheckBoxShape.ROUNDED_SQUARE)
            .onChange((value: boolean) => {
              console.info('Checkbox3 change is' + value)
            })
            .width(30)
            .height(30)
          Text('Checkbox3').fontSize(20)
        }
      }
      .width('100%')
    }
    .height('100%')
  }
}

鸿蒙(HarmonyOS)项目方舟框架(ArkUI)之CheckboxGroup组件 鸿蒙(HarmonyOS)项目方舟框架(ArkUI)之CheckboxGroup组件。 阅读详情

相关推荐

鸿蒙Harmony应用开发—ArkTS声明式开发(基础手势:Checkbox)

ArkTS声明式开发(基础手势:Checkbox)

m0_64420071的博客 2450

写给初学者的 HarmonyOS 教程 -- ArkTS 容器组件(List)

使用列表可以轻松高效地显示结构化、可滚动的信息。通过在 List 组件中按垂直或者水平方向线性排列子组件 ListItemGroup 或 ListItem,为列表中的行或列提供单个视图,或使用ForEach 迭代一组行或列,或混合任意数量的单个视图和 ForEach 结构,构建一个列表。

Fucking Android & Compose & Harmony & Spring Boot ... 7614

OpenHarmony实战开发-如何删除多选框选项

本例中是通过以下方式实现删除操作的:将选中的水果项从flexNameList中删除(为方便展示,本文直接将数据存储在数组中,实际开发需要对接数据库),由于flexNameList被@State修饰,所以其发生变化时会重新执行Build(),从而完成UI刷新,展示删除后的选项。通常情况下,我们使用多选框都会伴随对选项的操作,比较常见的操作是选中后删除,比如删除购物车的商品、删除账单、删除图片等等。当点击删除按钮时,触发删除操作,所以给Button添加onClick事件,并添加删除逻辑。4.添加删除确认框。

m0_70749039的博客 1016

鸿蒙应用开发ArkTS容器组件的使用

{space?Row(value?:{space?List(value?: {space?Flex(value?

码小白. 2184

鸿蒙Harmony应用开发—ArkTS声明式开发(基础手势:CheckboxGroup)

ArkTS声明式开发(基础手势:CheckboxGroup)

m0_64420071的博客 1403

鸿蒙HarmonyOS NEXT开发:Checkbox(基础组件)

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

shudaoshanBBQ的博客 3103

鸿蒙 ArkUI Checkbox 复选框组件:多选管理、全选反选与协议确认

状态单一来源选中数据(数组或行字段)是唯一真相源,全选框与统计都由它推导,任何操作路径最终都写入同一份数据。三态用统计表达ArkUI 复选框没有原生半选图形,用"已选 x/n"与 All/Part/None 徽标表达部分选中。点击与勾选分离协议文本的阅读点击不改变勾选,勾选是承诺、点击是阅读,注册按钮用 enabled 做门禁。多选即可多可少可多选、可取消的场景归 Checkbox,必选其一的场景归 Radio,二态开关归 Toggle。

2301_82266567的博客 361

鸿蒙5.0版开发:ArkTS容器组件(Navigator)

路由容器组件,提供路由跳转能力。

m0_69424697的博客 1078

【精通篇】打造React Native鸿蒙跨平台开发高级复合组件库开发系列:基于HarmonyOS API 24,Checkbox 复选框(用于在选中和非选中状态之间进行切换)

幸运的是,Python 标准库内置的 collections 模块提供了更多的选择。• defaultdict:字典子类,可以通过调用用户自定义的工厂函数来设置缺失值。• deque:双端队列,类似列表,是栈和队列的一般化,可以在两端快速添加或取出。法元素,我们会讲到这样的元素,它们不与任何特定的内置类型直接相关,而且在刚开始。迭代器本身是一个底层的特性和概念,在程序中可以不用它。• ChainMap:类似字典的类,用于创建多个映射的单一视图。• OrderedDict:字典子类,可以保存元素的添加顺序。

2301_77888392的博客 392

如何使用命令行对RK开发板进行OpenHarmony版本烧录?

开发版烧录

m0_64420071的博客 2317

告别Visual Studio!用MSYS2+GCC+CMake在Windows上打造Linux式C++开发环境(保姆级避坑)

本文详细介绍了如何在Windows上使用MSYS2+GCC+CMake搭建Linux式C++开发环境,替代Visual Studio。从MSYS2的安装配置、MinGW-w64 GCC工具链的部署,到CMake项目的创建与构建,提供了保姆级教程和常见问题解决方案,帮助开发者高效过渡到命令行开发模式。

weixin_30298497的博客 327

【每日学点HarmonyOS Next知识】弹窗组件、对象传递、获取当前路由对应组件实例、不规则多边形绘制、选择框

【每日学点HarmonyOS Next知识】弹窗组件、对象传递、获取当前路由对应组件实例、不规则多边形绘制、选择框

轻口味的专栏 181

华大HC32F460从零到200MHz:手把手教你配置时钟系统(附避坑指南)

本文详细解析了华大HC32F460 MCU的时钟系统配置,从启动过程、时钟树分析到实战配置200MHz系统时钟。文章手把手指导开发者如何正确配置外部晶振、MPLL锁相环及总线分频,并提供了硬件检查、代码解读及常见问题排查的避坑指南,帮助用户从零构建稳定可靠的高性能时钟环境。

net55的博客 298

React Native鸿蒙跨平台使用闭包中的 groups/members,HarmonyOS ArkTS API 24 高并发交互下建议改为函数式更新

本文分析的是一个基于React Native构建的群组管理应用,集成了群组创建、成员管理、权限控制等核心功能。该应用采用了多层级的模态框设计、复杂的状态联动和精细的权限管理机制,展现了社交管理类应用的典型技术架构。在鸿蒙OS的跨端适配场景中,这种涉及多层级交互和复杂状态管理的应用具有重要的技术参考价值。

2401_86113894的博客 666

告别机载网络通信混乱:利用ARINC825的LCC与带宽管理机制构建高可靠CAN总线

本文深入探讨了ARINC825规范如何通过逻辑通信通道(LCC)和带宽管理机制解决机载CAN总线通信的混乱问题。文章详细解析了ARINC825的核心架构设计、LCC工程实现、时间触发带宽管理等关键技术,展示了其在提升航空电子系统可靠性和实时性方面的显著效果,为现代飞机通信系统提供了高可靠解决方案。

weixin_26878995的博客 241

随机森林文本分类

随机森林原理及代码实现 提示:这里可以添加系列文章的所有文章的目录,目录需要自己手动添加 例如:第一章 Python 机器学习入门之pandas的使用 提示:写完文章后,目录可以自动生成,如何生成可参考右边的帮助文档 文章目录随机森林原理及代码实现前言一、集成算法是什么?二、随机森林是什么三、 数据预处理3.1 先来看一下我们的文本数据3.2 预处理3.3 统计评论情感值积极与消极的占比二、使用步骤参数介绍(4个)属性1.引入库2.参数调参方法总结 前言 提示:这里可以添加本文要记录的大概内容: 例如

m0_46579176的博客 5811

React Native鸿蒙跨平台使用闭包中的 groups/members,基于HarmonyOS API 24 高并发交互下建议改为函数式更新

如果你需要更简单的东西,那么 RQ(参见 http://pythonrq.org/)可能是一个很好的选择。的任务队列框架,支持多个消息服务器,也允许计划执行任务(它可以替代您的 cron 作业)。你不能简单地跳过你正在等待的答复的时间。在这种情况下,增加的响应时间可能不一定是由你的实现导致。间的主要贡献者,并且你没有其他更快的解决方案可以使用,当然,你无法进一步的加快。作时,只需将其添加到处理它的工作队列中,并立即响应接受请求的用户即可。幸运的是,已经有一些流行的工具可以用于构建分布式任务队列。

2401_86113894的博客 453

基于WebRTC的现代在线视频会议系统设计与实现

本文详细介绍了如何使用Java和WebRTC技术构建一个完整的在线视频会议系统。我们将从WebRTC的基础原理讲起,逐步深入到信令服务器设计、媒体服务器配置、前后端实现以及高级功能的开发。文章包含大量代码示例和架构图,旨在为开发者提供一套完整的视频会议解决方案。关键词:WebRTC、视频会议、Java、Spring Boot、信令服务器、STUN/TURN、媒体服务器:获取摄像头和麦克风访问权限:处理点对点连接和流传输:实现浏览器之间的任意数据交换。

2201_76125393的博客 189

鸿蒙入门10-CheckBoxGroup组件

复选框群组用于控制多个复选框全选或者不全选状态。

qq_42660453的博客 1210

MicroCap声学仿真介绍(六)-入耳式耳机仿真

从上图可以看出,后腔开了泄声孔后,振膜的最大位移从4.8um提升到了10um,振膜位移增加了一倍。在实际应用中,一般耳机的前腔和后腔都需要开泄声孔,开孔的大小和调音网布的阻尼需要根据客户的要求以及仿真的结果进行权衡选择。接着在主界面放置电阻、电感、电容,电阻值为Rms,电感值为Mms,电容值为Cms,如下图。假设后腔泄声孔的直径为1.2mm,宽度为0.3mm,对应调音网的阻抗为5.5e8欧姆。假设前腔泄声孔的直径为1.2mm,宽度为0.3mm,对应调音网的阻抗为5.5e8欧姆。

山无忧的博客 1806

Holosoma 开源人形机器人强化学习训练部署框架

Holosoma是一个综合性人形机器人框架,支持强化学习策略的训练、部署和动作重定位。该框架兼容多种模拟器(IsaacGym、IsaacSim、MuJoCo等)和机器人(Unitree G1、Booster T1),提供运动控制和全身追踪功能。主要特性包括:跨模拟器训练评估、Wandb集成、多GPU支持、自定义奖励权重和观测噪声配置。推理模块支持实体机器人部署和MuJoCo仿真测试。动作重定位工具可将人体动作数据转换为机器人动作,支持单序列和批量处理。文档详细介绍了训练配置、评估方法和高级功能,如课程学习和

2506_90492529的博客 1829

【鸿蒙软件开发】ArkTS常见组件之单选框Radio和切换按钮Toggle

Radio是单选框组件,通常用于提供相应的用户交互选择项,同一组的Radio中只有一个可以被选中。具体用法请参考Radio。Toggle组件提供状态按钮样式,勾选框样式及开关样式,一般用于两种状态之间的切换。具体用法请参考Toggle。其中对于Toggle独特的属性是,他是当Toggle选中后,所呈现的颜色以上就是今天要讲的内容,本文介绍了单选框Radio和切换按钮Toggle的使用,使用这些组件可以帮助我们快速构建ArkTS的界面。

m0_62599305的博客 6420

请尽可能地详细说明一个VLA项目的立项训练到落地的全流程

一个机器人VLA项目的全流程是一个复杂的系统工程,它深度融合了机器人学 (Robotics)计算机视觉 (CV)和自然语言处理 (NLP)。其核心挑战在于高质量数据的获取和从仿真到现实的有效迁移。与纯粹的软件AI项目相比,它增加了硬件、物理交互和安全性的维度,但其最终能让AI走出虚拟世界、在物理世界中产生实际价值,这也是其巨大的魅力所在。

具身机器人和通用AI 306

ArkTS的常用组件

Swiper(){...Indicator.dot() // 设置小圆点的相关属性.itemWidth(20) // 未选中时候的高.itemHeight(20) // 未选中时候的宽.color(Color.Black) // 未选中时候的颜色.selectedItemWidth(30) // 选中时候的宽.selectedItemHight(30) // 选中时候的高.selectedColor(Color.White) // 选中时候的颜色。

2301_80263861的博客 1325

精雕软件(JDpaint) 5.5 绿色版

精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版

复分析 阿尔福斯(Ahlfors) 第三版答案 英文

答案分为十章,有部分习题没有答案,全英文复分析阿尔福斯(Ahlfors) 第三版答案

鸿蒙 harmonyOS笔记: CheckboxGroup多选框群组

CheckboxGroup多选框群组

2401_87008233的博客 746

TMS_WebGMaps_1.9.8.0_Full_Source

TMS_WebGMaps_1.9.8.0_Full_Source 全源码 delphi cbuilder

ArkTS基础知识【含示例源码】

@Link装饰的变量可以父组件的@State装饰的变量建立双向数据绑定,因此对子组件的变量值修改,会同步修改父组件对应的@State修饰的变量,这里对应的就是父组件里的isSwitchDataSource变量,从而自动触发父组件的UI刷新。对应页面的入口组件,也就是被@Entry装饰器修饰的自定义组件,系统还提供了另外的三个生命周期函数,分别是:页面展示时刻的onPageShow(),进行返回的时候的onBackPress(),页面消失时刻的onPageHide();

当你发现自己的才华撑不起野心时,就请安静下来学习~ 7956

蓝牙模块HM-10手册

蓝牙模块HM-10手册,该手册对蓝牙模块HM-10进行了详细的介绍和使用方法以及一些AT指令。

上一篇: 鸿蒙5.0开发进阶:UI框架-ArkTS组件(Checkbox)
下一篇: 鸿蒙5.0开发进阶:UI框架-ArkTS组件(CalendarPicker)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值