HarmonyOS7 基础单选项:用 Radio 做好单项选择

发布时间:2026/7/21 8:26:33
HarmonyOS7 基础单选项:用 Radio 做好单项选择 文章目录前言先看这个案例解决什么状态为什么这样设计关键代码拆开看完整代码落地时我会怎么改前言这组案例开始进入选择类和调节类组件写业务页面时会经常遇到。这个案例围绕Radio 基础互斥选择展开重点不是把属性背下来而是弄清楚状态、组件和用户操作之间怎么连起来。这篇我会把重点放在组件入门上尽量说清楚它在真实页面里有什么用。先看这个案例解决什么如果把它放到真实项目里常见位置可能是设置页、筛选页、编辑页或者某个需要快速操作的工具面板。用户点一下、选一下、拖一下页面就应该给出明确反馈。维度内容案例主题Radio 基础互斥选择核心 APIRadio使用场景单项选择文章侧重点组件入门状态为什么这样设计代码结构可以按三层读外层负责页面背景和留白中间卡片承载主要内容内部组件处理具体交互。这样的层级不花哨但维护起来比较舒服。我比较推荐先把状态字段命名清楚。选中项、开关状态、滑块数值最好都能从名字看出用途比随手写flag、value后面省心很多。关键代码拆开看先看一段连续代码基本能判断这个案例的运行方式。它包含入口组件、状态字段以及一部分核心 UI。EntryComponentstruct BasicRadioChoice{StateisShow:booleantruebuild(){Column(){if(this.isShow){Column(){Text(Radio 基础).fontSize(16).fontWeight(FontWeight.Bold).margin({bottom:12})Text(RadioGroup 单选互斥行为).fontSize(12).fontColor(SUBTEXT_COLOR).margin({bottom:10})Column(){Row(){Radio({value:appleValue,group:fruitGroup});Text(苹果).fontSize(15).margin({left:8})}.margin({bottom:10})Row(){Radio({value:bananaValue,group:fruitGroup});Text(香蕉).fontSize(15).margin({left:8})}.margin({bottom:10})Row(){Radio({value:orangeValue,group:fruitGroup});Text(橙子).fontSize(15).margin({left:8})}这段代码可以拆成几块看State保存当前页面状态用户操作之后会触发 UI 更新。Radio是案例的关键入口真正的行为通常由它和事件回调一起完成。布局属性服务于业务表达选中、禁用、拖动这些状态最好都能在视觉上看出来。完整代码下面是整理后的完整代码。组件名已经改成BasicRadioChoice共享颜色也内置到当前文件里单独复制出来读会更方便。constPAGE_BG_COLOR:string#F5F6FAconstCARD_BG_COLOR:string#FFFFFFconstSUBTEXT_COLOR:string#8A8A8AEntryComponentstruct BasicRadioChoice{StateisShow:booleantruebuild(){Column(){if(this.isShow){Column(){Text(Radio 基础).fontSize(16).fontWeight(FontWeight.Bold).margin({bottom:12})Text(RadioGroup 单选互斥行为).fontSize(12).fontColor(SUBTEXT_COLOR).margin({bottom:10})Column(){Row(){Radio({value:appleValue,group:fruitGroup});Text(苹果).fontSize(15).margin({left:8})}.margin({bottom:10})Row(){Radio({value:bananaValue,group:fruitGroup});Text(香蕉).fontSize(15).margin({left:8})}.margin({bottom:10})Row(){Radio({value:orangeValue,group:fruitGroup});Text(橙子).fontSize(15).margin({left:8})}}}.width(100%).padding(16).backgroundColor(CARD_BG_COLOR).borderRadius(12)}Text(基础单选项Radio 基础 - RadioGroup 单选互斥).fontSize(12).fontColor(SUBTEXT_COLOR).margin({top:12})}.width(100%).height(100%).backgroundColor(PAGE_BG_COLOR).padding(16)}}落地时我会怎么改继续扩展的话我会把静态选项抽成接口返回的数据再补上空状态和异常状态。示例页面先把核心交互跑通就够了到了业务页面状态边界才是真正容易出问题的地方。