如何通过代码修改UIButton的Voiceover值？UISwitch无障碍朗读异常排查

一、修改UIButton的VoiceOver内容 #

要自定义UIButton的VoiceOver朗读内容，核心是利用UIKit的辅助功能属性，主要用到这几个：

• accessibilityLabel：描述按钮的基本功能（比如“播放音频”）
• accessibilityValue：描述按钮的当前状态（比如切换类按钮的“已开启”/“已关闭”）
• accessibilityHint：补充说明按钮的操作效果（可选，比如“双击切换状态”）

举个Swift代码示例：

// 假设你有一个控制音频的切换按钮
let audioToggleButton = UIButton(type: .system)
audioToggleButton.setTitle("音频", for: .normal)

// 设置基础朗读标签
audioToggleButton.accessibilityLabel = "音频控制"
// 初始化状态对应的朗读值
audioToggleButton.accessibilityValue = "已关闭"

// 按钮状态切换时更新accessibilityValue
@objc func toggleAudioState(_ sender: UIButton) {
    sender.isSelected = !sender.isSelected
    sender.accessibilityValue = sender.isSelected ? "已开启" : "已关闭"
}

如果用Objective-C，代码逻辑类似：

UIButton *audioToggleButton = [UIButton buttonWithType:UIButtonTypeSystem];
[audioToggleButton setTitle:@"音频" forState:UIControlStateNormal];

audioToggleButton.accessibilityLabel = @"音频控制";
audioToggleButton.accessibilityValue = @"已关闭";

// 状态切换时更新值
- (void)toggleAudioState:(UIButton *)sender {
    sender.selected = !sender.isSelected;
    sender.accessibilityValue = sender.isSelected ? @"已开启" : @"已关闭";
}

二、修复UISwitch VoiceOver朗读“0/1”的问题 #

你遇到的UISwitch朗读数字而非状态词，大概率是辅助属性设置错误或代码未正确触发更新，这里给你可靠的解决方式和排查点：

方式1：动态绑定状态更新 #

UISwitch默认的accessibilityValue应该对应isOn状态朗读“On/Off”，如果没生效，手动监听状态变化并设置即可：

// 关联IB中的UISwitch
@IBOutlet weak var audioSwitch: UISwitch!

override func viewDidLoad() {
    super.viewDidLoad()
    // 设置开关的功能描述（让VoiceOver先说明这是什么）
    audioSwitch.accessibilityLabel = "音频开关"
    // 初始化状态对应的朗读值
    audioSwitch.accessibilityValue = audioSwitch.isOn ? "On" : "Off"
    // 添加状态变化监听
    audioSwitch.addTarget(self, action: #selector(switchValueChanged(_:)), for: .valueChanged)
}

@objc func switchValueChanged(_ sender: UISwitch) {
    // 每次状态切换时更新朗读内容
    sender.accessibilityValue = sender.isOn ? "On" : "Off"
}

常见错误排查 #

• 有没有误把accessibilityLabel设成了数值（0/1）？accessibilityLabel应该是开关的功能描述，accessibilityValue才是状态值。
• 检查switchValueChanged方法是否真的被触发？可以加断点确认逻辑是否执行。
• 测试时是否真的开启了VoiceOver？去设备设置-辅助功能里打开VoiceOver再测试，模拟器可用快捷键Command + F5开启。

内容的提问来源于stack exchange，提问作者Manelion