根据焦点方向在 Swift 中自定义辅助功能文本

iOS 中基于焦点方向的动态辅助文本

该解决方案专注于 Swift 编程，利用 UIKit 的辅助功能来根据焦点方向动态调整 UI 元素的辅助功能标签。

// Approach 1: Using Accessibility Focus Delegates
import UIKit
class AccessibleCollectionViewCell: UICollectionViewCell {
    override var accessibilityLabel: String? {
        get {
            return customAccessibilityLabel
        }
        set {
            customAccessibilityLabel = newValue
        }
    }
    private var customAccessibilityLabel: String?
}
class ViewController: UIViewController, UICollectionViewDelegate {
    @IBOutlet weak var topLabel: UILabel!
    @IBOutlet weak var collectionView: UICollectionView!
    @IBOutlet weak var bottomLabel: UILabel!
    override func viewDidLoad() {
        super.viewDidLoad()
        collectionView.delegate = self
    }
    func collectionView(_ collectionView: UICollectionView,
                        didUpdateFocusIn context: UICollectionViewFocusUpdateContext,
                        with coordinator: UIFocusAnimationCoordinator) {
        if let nextFocusedCell = context.nextFocusedView as? AccessibleCollectionViewCell {
            let direction = context.previouslyFocusedView is UILabel ? "table with n Rows, n Columns" : ""
            nextFocusedCell.accessibilityLabel = "\(nextFocusedCell.customAccessibilityLabel ?? ""), \(direction)"
        }
    }
}

通过通知观察器进行动态焦点调整

此方法使用 Swift 的通知中心来侦听 VoiceOver 焦点更改并动态更新辅助功能标签。

// Approach 2: Using Notification Center
import UIKit
class ViewController: UIViewController {
    @IBOutlet weak var collectionView: UICollectionView!
    private var lastFocusedElement: UIView?
    override func viewDidLoad() {
        super.viewDidLoad()
        NotificationCenter.default.addObserver(self,
                                               selector: #selector(handleFocusChange),
                                               name: UIAccessibility.elementFocusedNotification,
                                               object: nil)
    }
    @objc private func handleFocusChange(notification: Notification) {
        guard let userInfo = notification.userInfo,
              let focusedElement = userInfo[UIAccessibility.focusedElementUserInfoKey] as? UIView else { return }
        if let cell = focusedElement as? UICollectionViewCell,
           lastFocusedElement is UILabel {
            cell.accessibilityLabel = "\(cell.accessibilityLabel ?? ""), table with n Rows, n Columns"
        }
        lastFocusedElement = focusedElement
    }
}

有关动态辅助功能标签的常见问题

1. 如何检测 VoiceOver 焦点变化？
2. 您可以使用 UIAccessibility.elementFocusedNotification 监听焦点的变化。
3. 更新辅助功能标签的最佳方法是什么？
4. 使用组合 accessibilityLabel 和自定义属性，例如 customAccessibilityLabel，对于动态更新有效。
5. 动态标签能否提高非标准 UI 布局的可用性？
6. 是的，通过定制网格、表格或自定义视图的描述，您可以让用户更好地理解 UI 结构。
7. 上下文感知标签会带来哪些挑战？
8. 确保焦点转换的一致性可能很棘手。在不同的导航场景中进行测试至关重要。
9. 如何使这些技术可以跨项目重用？
10. 创建用于管理焦点感知更新的实用程序或基类是可重用性的有效解决方案。

使用上下文标签增强可访问性

动态辅助功能文本丰富了导航体验，尤其是在网格或集合视图等复杂布局中。通过为焦点转换添加上下文（例如宣布行和列），用户可以更清楚地了解自己在界面中的位置。这种方法确保了更广泛受众的包容性和可用性。

将这些技术应用于现实世界的应用程序（例如教育平台或画廊）可以提升它们的功能。适应用户导航模式体现了深思熟虑的设计。开发人员应从头开始优先考虑可访问性，确保符合 世界煤气协会 标准和制作满足不同用户需求的应用程序。 🌍