文章目录前言案例效果和学习目标从布局读到状态重点代码解释完整代码我的小建议前言这组案例开始进入选择类和调节类组件写业务页面时会经常遇到。这个案例围绕Checkbox 综合使用展开重点不是把属性背下来而是弄清楚状态、组件和用户操作之间怎么连起来。这篇我会把重点放在组合案例上尽量说清楚它在真实页面里有什么用。案例效果和学习目标如果把它放到真实项目里常见位置可能是设置页、筛选页、编辑页或者某个需要快速操作的工具面板。用户点一下、选一下、拖一下页面就应该给出明确反馈。维度内容案例主题Checkbox 综合使用核心 APIselectedColor使用场景综合选择| 文章侧重点 | 组合案例 |从布局读到状态代码结构可以按三层读外层负责页面背景和留白中间卡片承载主要内容内部组件处理具体交互。这样的层级不花哨但维护起来比较舒服。我比较推荐先把状态字段命名清楚。选中项、开关状态、滑块数值最好都能从名字看出用途比随手写flag、value后面省心很多。重点代码解释先看一段连续代码基本能判断这个案例的运行方式。它包含入口组件、状态字段以及一部分核心 UI。EntryComponentstruct CheckboxCompletePanel{StateisShow:booleantrueStateallChecked:booleanfalseStateindeterminate:booleanfalseStateitems:boolean[][false,false,false,false,false]StatedisabledItem:booleanfalseupdateAllState(){constcountthis.items.filter(ii).lengthif(count0){this.allCheckedfalse;this.indeterminatefalse}elseif(countthis.items.length){this.allCheckedtrue;this.indeterminatefalse}else{this.allCheckedfalse;this.indeterminatetrue}}build(){Column(){这段代码可以拆成几块看State保存当前页面状态用户操作之后会触发 UI 更新。selectedColor是案例的关键入口真正的行为通常由它和事件回调一起完成。布局属性服务于业务表达选中、禁用、拖动这些状态最好都能在视觉上看出来。完整代码下面是整理后的完整代码。组件名已经改成CheckboxCompletePanel共享颜色也内置到当前文件里单独复制出来读会更方便。constCOLOR_OPTIONS:Array{name:string;value:string}[{name:蓝色,value:#4D96FF},{name:绿色,value:#6BCB77},{name:黄色,value:#FFD93D},{name:红色,value:#FF6B6B},{name:紫色,value:#9B59B6},{name:橙色,value:#FFA500},{name:青色,value:#00BCD4},{name:粉色,value:#FF69B4},{name:灰蓝,value:#607D8B},{name:深色,value:#333333}]constPAGE_BG_COLOR:string#F5F6FAconstCARD_BG_COLOR:string#FFFFFFconstTHEME_COLOR:string#4D96FFconstSUBTEXT_COLOR:string#8A8A8AEntryComponentstruct CheckboxCompletePanel{StateisShow:booleantrueStateallChecked:booleanfalseStateindeterminate:booleanfalseStateitems:boolean[][false,false,false,false,false]StatedisabledItem:booleanfalseupdateAllState(){constcountthis.items.filter(ii).lengthif(count0){this.allCheckedfalse;this.indeterminatefalse}elseif(countthis.items.length){this.allCheckedtrue;this.indeterminatefalse}else{this.allCheckedfalse;this.indeterminatetrue}}build(){Column(){if(this.isShow){Scroll(){Column(){Text(Checkbox 综合演示).fontSize(16).fontWeight(FontWeight.Bold).margin({bottom:12})Row(){Checkbox().select(this.allChecked).onChange((v:boolean){this.allCheckedvthis.indeterminatefalsefor(leti0;ithis.items.length;i)this.items[i]v})Text(全选所有任务).fontSize(15).fontWeight(FontWeight.Bold).margin({left:8})}.width(100%).padding(10).margin({bottom:8}).backgroundColor(THEME_COLOR10).borderRadius(6)ForEach([0,1,2,3,4],(i:number){Row(){Checkbox().select(this.items[i]).selectedColor(COLOR_OPTIONS[i%COLOR_OPTIONS.length].value).enabled(i!4||!this.disabledItem).onChange((v:boolean){this.items[i]vthis.updateAllState()})Text(任务${i1}${[写代码,写测试,CodeReview,部署上线,写文档][i]}).fontSize(14).margin({left:8})if(i4this.disabledItem){Text(禁用).fontSize(10).fontColor(SUBTEXT_COLOR).padding({left:4,right:4}).borderRadius(3).backgroundColor(#F0F0F0)}}.margin({bottom:10})})Divider().margin({top:8,bottom:8})Row(){Checkbox().select(this.disabledItem).onChange((v:boolean){this.disabledItemv})Text(禁用最后一项任务).fontSize(14).margin({left:8})}}.width(100%).padding(16).backgroundColor(CARD_BG_COLOR).borderRadius(12)}}Text(复选框综合面板Checkbox 综合 - 全选/不确定态/禁用/多色).fontSize(12).fontColor(SUBTEXT_COLOR).margin({top:12})}.width(100%).height(100%).backgroundColor(PAGE_BG_COLOR).padding(16)}}我的小建议继续扩展的话我会把静态选项抽成接口返回的数据再补上空状态和异常状态。示例页面先把核心交互跑通就够了到了业务页面状态边界才是真正容易出问题的地方。