在 UIButton/UITableViewCell/UICollectionViewCell 选择上禁用 VoiceOver

Question

打开 VoiceOver 后，当焦点位于 UIButton/UITableViewCell/UICollectionViewCell 时，VoiceOver 会读取它的辅助功能标签一次。

然后，一旦用户双击以选择 UIButton/UITableViewCell/UICollectionViewCell，VoiceOver 会再次读取相同的可访问性标签，除了对 UIButton/UITableViewCell/@987654330 执行操作（导航等） @选择。

我进行了很多搜索，但无法找到一种方法来停止/禁用 VoiceOver 阅读 UIButton/UITableViewCell/UICollectionViewCell 选择上的辅助功能标签。

任何帮助将不胜感激。

Answer 1

斯威夫特 5

对我有用的是设置myElementIWantSilent.accessibilityTraits = .none

编辑：我应该注意到这些也存在：

viewContainingSilentElement.isAccessibilityElement = true
viewContainingSilentElement.accessibilityTraits = .image
viewContainingSilentElement.accessibilityLabel = "some text i want read aloud"

iPhone 8
iOS 14.5.1
XCode 12.5

Answer 2

让我们看看如何停止对 UIButton 和 UITableViewCell 元素的 VoiceOver 辅助功能阅读。

UIBUTTON：只需创建自己的按钮类并覆盖accessibilityActivate 方法。

class BoutonLabelDoubleTap: UIButton {

    override func accessibilityActivate() -> Bool {
        accessibilityLabel = ""
        return true
    }
}

UITABLEVIEWCELL：要遵循的两个步骤。

• 创建一个覆盖accessibilityActivate 方法的自定义UIAccessibilityElement。

  class TableViewCellLabelDoubleTap: UIAccessibilityElement {
  
      override init(accessibilityContainer container: Any) {
          super.init(accessibilityContainer: container)
      }
  
      override var accessibilityTraits: UIAccessibilityTraits {
          get { return UIAccessibilityTraitNone }
          set {   }
      }
  
      override func accessibilityActivate() -> Bool {
          accessibilityLabel = ""
          return true
      }
  }
  

• 使用之前创建的类在视图控制器中实现表格视图单元格。

  class TestButtonTableViewController: UIViewController,UITableViewDataSource,UITableViewDelegate {
  
      @IBOutlet weak var myTableView: UITableView!
      @IBOutlet weak var bottomButton: UIButton!
  
      override func viewDidLoad() {
          super.viewDidLoad()
          myTableView.delegate = self as UITableViewDelegate
          myTableView.dataSource = self as UITableViewDataSource
      }
  
      func numberOfSections(in tableView: UITableView) -> Int {
          return 1
      }
  
      func tableView(_ tableView: UITableView,
                     numberOfRowsInSection section: Int) -> Int {
          return 2
      }
  
      func tableView(_ tableView: UITableView,
                     cellForRowAt indexPath: IndexPath) -> UITableViewCell {
  
          let zeCell = tableView.dequeueReusableCell(withIdentifier: "myPersoCell",
                                                     for: indexPath)
  
          zeCell.accessibilityElements = nil
          var elements = [UIAccessibilityElement]()
  
          let a11yEltCell = TableViewCellLabelDoubleTap(accessibilityContainer: zeCell)
          a11yEltCell.accessibilityLabel = "cell number " + String(indexPath.row)
          a11yEltCell.accessibilityFrameInContainerSpace = CGRect(x: 0,
                                                                  y: 0,
                                                                  width: zeCell.contentView.frame.size.width,
                                                                  height: zeCell.contentView.frame.size.height)
          elements.append(a11yEltCell)
          zeCell.accessibilityElements = elements
  
          return zeCell
      }
  }
  

我没有尝试过UICollectionViewCell，但它应该与UITableViewCell 的基本原理相同。

按照这些代码 sn-ps，您现在可以决定 VoiceOver 是否应该在选择时停止读出所需的元素标签。