目录

基于单选框的深浅色模式切换失败

问题现象

在通过单选框交互实现深浅色主题实时切换的过程中,界面行为异常。具体操作和现象如下:从浅色模式时切换到深色模式时,浅色模式的Radio仍显示为选中状态,而深色模式的Radio无法选中,但实际已经切换成深色模式了。

问题代码如下:

import { hilog } from '@kit.PerformanceAnalysisKit';
import { ConfigurationConstant } from '@kit.AbilityKit';

@Entry
@Component
struct RadioButton {
  build() {
    Column() {
      List() {
        ListItem({ style: ListItemStyle.CARD }) {
          Row() {
            Column() {
              Text('使用浅色模式')
                .fontColor(Color.White);
            };

            Column() {
              Radio({ value: 'lightMode', group: 'colorModeRadioGroup' })
                .checked(true)
                .onChange((isChecked: boolean) => {
                  hilog.info(0x0002, '浅色模式Radio', 'isChecked:%{public}s', isChecked);
                  this.onColorModeCheckboxStateChange(!isChecked);
                });
            };
          };
        }.width('92%')
        .margin({ top: 16 })
        .backgroundColor('#0A59F7')
        .borderRadius(20);

        ListItem({ style: ListItemStyle.CARD }) {
          Row() {
            Column() {
              Text('使用深色模式')
                .fontColor(Color.White);
            };

            Column() {
              Radio({ value: 'darkMode', group: 'colorModeRadioGroup' })
                .checked(false)
                .onChange((isChecked: boolean) => {
                  hilog.info(0x0002, '深色模式Radio', 'isChecked:%{public}s', isChecked);
                });
            };
          };
        }
        .width('92%')
        .margin({ top: 16 })
        .backgroundColor('#0A59F7')
        .borderRadius(20);
      };
    }
    .height('100%')
    .width('100%');
  }

  onColorModeCheckboxStateChange(changedPropertyName: boolean) {
    hilog.info(0x0002, 'onColorModeCheckboxStateChange', '颜色模式即将改为:%{public}s', changedPropertyName);
    if (changedPropertyName) {
      this.getUIContext()
        .getHostContext()?.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT);
    } else {
      this.getUIContext()
        .getHostContext()?.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_DARK);
    }
  }
}

问题现象如下:

背景知识

Radio是单选框组件,通常用于提供相应的用户交互选择项,同一组的Radio中只有一个可以被选中。

问题定位

通过分析问题代码可知:

代码逻辑分析:
  • 硬编码的checked属性:Radio.checked的值始终为固定值,未与颜色模式状态动态绑定。组件重新渲染时,checked被强制重置为硬编码值,导致状态冲突。
    Radio({ value: 'lightMode', group: 'colorModeRadioGroup' }).checked(true)
    Radio({ value: 'darkMode', group: 'colorModeRadioGroup' }).checked(false)
  • onChange回调逻辑错误:!isChecked导致逻辑反转,用户点击浅色模式的Radio会切换到深色模式,但界面刷新后checked被重置为true,形成状态冲突。onChange回调被反复触发,导致无限循环。
    .onChange((isChecked: boolean) => {
      this.onColorModeCheckboxStateChange(!isChecked);
    })

分析结论

由于调用this.getUIContext().getHostContext()?.getApplicationContext().setColorMode()刷新界面深浅模式时,会触发组件重新渲染;而Radio组件的check()属性被硬编码为固定值,导致其选中状态在界面刷新后被强制重置,从而引发onChange回调频繁触发,切换深色模式后浅色模式的Radio组件状态同步异常。

修改建议

原始问题的核心是Radio的属性checked被硬编码,导致状态无法同步。可通过@State装饰器将isChecked与UI动态绑定,代码如下:

Radio({ value: 'lightMode', group: 'colorModeRadioGroup' })
  .checked(this.isChecked)
Radio({ value: 'darkMode', group: 'colorModeRadioGroup' })
  .checked(!this.isChecked)

完整代码如下:

import { hilog } from '@kit.PerformanceAnalysisKit';
import { ConfigurationConstant } from '@kit.AbilityKit';

@Entry
@Component
struct RadioButton {
  @State isChecked: boolean = true;

  onColorModeCheckboxStateChange(changedPropertyName: boolean) {
    hilog.info(0x0002, 'onColorModeCheckboxStateChange', '颜色模式即将改为:%{public}s', changedPropertyName);
    if (changedPropertyName) {
      this.getUIContext()
        .getHostContext()?.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT);
    } else {
      this.getUIContext()
        .getHostContext()?.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_DARK);
    }
  }

  build() {
    RelativeContainer() {
      List() {
        ListItem({ style: ListItemStyle.CARD }) {
          Row() {
            Column() {
              Text('使用浅色模式')
                .fontColor(Color.White);
            };

            Column() {
              Radio({ value: 'lightMode', group: 'colorModeRadioGroup' })
                .checked(this.isChecked)
                .onChange((isChecked: boolean) => {
                  this.isChecked = isChecked;
                  hilog.info(0x0002, '浅色模式Radio', 'isChecked:%{public}s', isChecked);
                  this.onColorModeCheckboxStateChange(isChecked);
                });
            };
          };
        }
        .margin({ top: 16 })
        .width('92%')
        .backgroundColor(this.isChecked ? '#0A59F7' : '#317AF7')
        .borderRadius(35);

        ListItem({ style: ListItemStyle.CARD }) {
          Row() {
            Column() {
              Text('使用深色模式')
                .fontColor(Color.White);
            };

            Column() {
              Radio({ value: 'darkMode', group: 'colorModeRadioGroup' })
                .checked(!this.isChecked)
                .onChange((isChecked: boolean) => {
                  hilog.info(0x0002, '深色模式Radio', 'isChecked:%{public}s', isChecked);
                });
            };
          };
        }
        .width('92%')
        .margin({ top: 16 })
        .backgroundColor(this.isChecked ? '#0A59F7' : '#317AF7')
        .borderRadius(35);
      };
    }
    .height('100%')
    .width('100%');
  }
}

修正效果如下: