如何控制星级按钮选中时VoiceOver播报内容而非重复其accessibilityLabel

一、解决VoiceOver重复播报问题 #

核心原理 #

系统默认的VoiceOver播报逻辑为accessibilityLabel（元素描述） + accessibilityValue（元素状态/值） + accessibilityTraits（元素特性），你之前仅设置了固定的accessibilityLabel，选中状态变化时系统会重复播报标签内容，所以只需要拆分描述和状态，或者接管激活事件即可。

可选实现方案 #

• 方案1：拆分无障碍属性（最低改造成本）
  把固定的星级描述放到accessibilityLabel，选中状态放到accessibilityValue，无需修改其他逻辑，系统会自动拼接播报内容：

  // 未选中状态
  cell.button2.accessibilityLabel = @"五颗星中的第二颗";
  cell.button2.accessibilityValue = @"未选中";
  // 选中状态
  cell.button2.accessibilityValue = @"已选中";
  

  播报效果为五颗星中的第二颗，已选中，按钮，无重复内容。注意移除你之前添加的UIAccessibilityTraitStartsMediaSession特性，该特性适用于媒体播放类元素，星级选择场景不需要。
• 方案2：完全自定义播报内容
  如果你希望完全自定义选中后的播报文案，可以在按钮点击事件触发后，直接发送VoiceOver系统公告，优先级高于默认播报：

  UIAccessibilityPostNotification(UIAccessibilityAnnouncementNotification, @"你已选中第2颗星");
  

  如果要彻底禁用系统默认的激活播报，可以在自定义按钮类中重写accessibilityActivate方法，返回true告知系统已自行处理激活事件：

  override func accessibilityActivate() -> Bool {
      // 触发原有点击逻辑
      sendActions(for: .touchUpInside)
      // 自定义播报
      let notice = isSelected ? "你已选中第\(starIndex)颗星" : "你已取消选中第\(starIndex)颗星"
      UIAccessibility.post(notification: .announcement, argument: notice)
      return true
  }
  

二、Swift自定义UIButton集成到ObjC项目步骤 #

1. 新建Swift自定义按钮类，添加@objcMembers修饰符暴露所有属性方法给OC调用，示例代码：

import UIKit

@objcMembers class RatingStarButton: UIButton {
    /// 星级序号，从1开始计数
    var starIndex: Int = 1
    /// 总星级数
    var totalStars: Int = 5
    
    override var isSelected: Bool {
        didSet {
            accessibilityLabel = "\(totalStars)颗星中的第\(starIndex)颗"
            accessibilityValue = isSelected ? "已选中" : "未选中"
        }
    }
    
    override func accessibilityActivate() -> Bool {
        sendActions(for: .touchUpInside)
        let notice = isSelected ? "你已选中第\(starIndex)颗星" : "你已取消选中第\(starIndex)颗星"
        UIAccessibility.post(notification: .announcement, argument: notice)
        return true
    }
}

2. 打开项目Build Settings，确认Defines Module配置为Yes，记住Objective-C Generated Interface Header Name的默认值，一般为你的项目名称-Swift.h
3. 在需要使用该Swift按钮的OC文件头部，导入自动生成的桥接头文件：

#import "你的项目名称-Swift.h"

4. 后续即可在OC代码中正常使用该Swift自定义类，用法和原生OC类完全一致：

RatingStarButton *starButton = [[RatingStarButton alloc] init];
starButton.starIndex = 2;
starButton.totalStars = 5;

内容的提问来源于stack exchange，提问作者Frederick C. Lee