屏幕切换（推送、呈现及SplitViewController场景）时的VoiceOver焦点处理

我来给你拆解这两个VoiceOver焦点的问题，都是iOS无障碍开发里经常碰到的实际场景：

一、推送/模态呈现UIViewController时的焦点逻辑与自定义方法 #

默认情况下，VoiceOver会自动聚焦到新控制器的第一个可访问元素：

• 如果是通过UINavigationControllerpush的控制器，默认焦点会落在导航栏的返回按钮上；
• 如果是模态呈现的控制器，通常会聚焦到页面的标题、第一个可交互控件（比如确认/取消按钮），或者页面的根视图（如果没有更优先的可访问元素）。

如果想自定义这个焦点行为，有两种常用的方式：

• 直接指定焦点元素：在新控制器的viewDidAppear(_:)方法里，调用UIAccessibility.post(notification: .screenChanged, argument: targetElement)，把你希望优先聚焦的元素传进去。比如新页面的核心是一个列表，就直接传这个列表控件。注意必须在viewDidAppear里调用，这时候视图才完全加载完成，元素是可访问的。
  示例代码：

  override func viewDidAppear(_ animated: Bool) {
      super.viewDidAppear(animated)
      // 让焦点直接跳到核心内容的UITableView
      UIAccessibility.post(notification: .screenChanged, argument: mainTableView)
  }
  

• 调整可访问元素顺序：如果需要整体改变页面的VoiceOver遍历顺序，可以在控制器的viewDidLoad里自定义accessibilityElements数组，把你希望优先被访问的元素放在数组最前面。这个方法会影响整个页面的遍历逻辑，适合需要全局调整的场景。
  示例代码：

  override func viewDidLoad() {
      super.viewDidLoad()
      // 自定义可访问元素顺序，核心内容优先
      accessibilityElements = [mainContentLabel, mainTableView, navigationItem.leftBarButtonItem]
  }
  

二、iPad SplitViewController中，主视图选项目后跳转副视图焦点的处理 #

默认情况下，SplitViewController在主视图选中项目、副视图更新内容后，VoiceOver不会自动跳转焦点——因为系统不知道你要聚焦副视图的哪个具体元素，这时候需要我们手动触发焦点切换：

当主视图的选中事件触发（比如tableView(_:didSelectRowAt:)），在副视图的内容更新完成后，调用UIAccessibility.post(notification: .layoutChanged, argument: targetElement)。这里用.layoutChanged而不是.screenChanged，因为是同一个屏幕内的布局更新，而非新页面跳转。

举个实际场景的代码示例：

// 主视图控制器的选中事件
func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
    let selectedData = dataSource[indexPath.row]
    // 通知副视图更新内容
    if let detailVC = splitViewController?.viewControllers.last as? DetailViewController {
        detailVC.updateContent(with: selectedData)
    }
}

// 副视图控制器的内容更新方法
func updateContent(with data: DataModel) {
    // 先完成UI更新
    detailTitleLabel.text = data.title
    detailContentTableView.reloadData()
    
    // 触发VoiceOver焦点跳转到副视图的核心元素
    UIAccessibility.post(notification: .layoutChanged, argument: detailTitleLabel)
}

另外要注意，如果副视图是通过SplitViewController的showDetailViewController(_:sender:)方法更新的，那可以在副视图的viewDidAppear(_:)或者内容更新完成的回调里执行焦点触发的代码。

备注：内容来源于stack exchange，提问作者iroh