3 无障碍控件
3 分钟阅读
原文链接: https://developer.apple.com/documentation/swiftui/accessible-controls
3 无障碍控件
让应用可以执行的各种操作更易于访问。
概述
帮助使用辅助技术的用户访问应用中的控件。

关于设计指导,请参阅 Human Interface Guidelines 辅助功能部分中的 辅助功能。
为视图添加动作
- accessibilityAction(::) — 为视图添加一个辅助功能动作。动作让 VoiceOver 等辅助技术可以通过调用该动作来与视图交互。
- accessibilityActions(_:) — 为视图添加多个辅助功能动作。
- accessibilityAction(named:_:) — 为视图添加一个辅助功能动作。动作让 VoiceOver 等辅助技术可以通过调用该动作来与视图交互。
- accessibilityAction(action:label:) — 为视图添加一个辅助功能动作。动作让 VoiceOver 等辅助技术可以通过调用该动作来与视图交互。
- accessibilityAction(intent:label:) — 为视图添加一个由
label内容标记的辅助功能动作。动作让 VoiceOver 等辅助技术可以通过调用该动作来与视图交互。当该动作执行时,会调用intent。 - accessibilityAction(_:intent:) — 为视图添加一个表示
actionKind的辅助功能动作。动作让 VoiceOver 等辅助技术可以通过调用该动作来与视图交互。当该动作执行时,会调用intent。 - accessibilityAction(named:intent:) — 为视图添加一个标记为
name的辅助功能动作。动作让 VoiceOver 等辅助技术可以通过调用该动作来与视图交互。当该动作执行时,会调用intent。 - accessibilityAdjustableAction(_:) — 为视图添加一个可调节的辅助功能动作。动作让 VoiceOver 等辅助技术可以通过调用该动作来与视图交互。
- accessibilityScrollAction(_:) — 为视图添加一个辅助功能滚动动作。动作让 VoiceOver 等辅助技术可以通过调用该动作来与视图交互。
- accessibilityActions(category:_:) — 为视图添加多个属于特定类别的辅助功能动作。动作让 VoiceOver 等辅助技术可以通过调用该动作来与视图交互,并按类别分组。当多个类别相同的动作修饰符应用于同一视图时,这些动作会合并在一起。
- AccessibilityActionKind — 定义可用辅助功能动作种类的结构体。
- AccessibilityAdjustmentDirection — 进行辅助功能调整时使用的方向指示。
- AccessibilityActionCategory — 指定由系统提供并命名的辅助功能动作类别。
向大家提供快速操作
- accessibilityQuickAction(style:content:) — 添加一个在激活时由系统显示的快速操作。
- accessibilityQuickAction(style:isActive:content:) — 添加一个在激活时由系统显示的快速操作。
- AccessibilityQuickActionStyle — 描述辅助功能快速操作呈现样式的类型。
让手势可访问
- accessibilityActivationPoint(_:) — 元素的激活点是辅助技术用来发起手势的位置。
- accessibilityActivationPoint(_:isEnabled:) — 元素的激活点是辅助技术用来发起手势的位置。
- accessibilityDragPoint(_:description:) — 辅助技术应使用哪个点来开始拖拽交互。
- accessibilityDragPoint(_:description:isEnabled:) — 辅助技术应使用哪个点来开始拖拽交互。
- accessibilityDropPoint(_:description:) — 辅助技术应使用哪个点来结束拖拽交互。
- accessibilityDropPoint(_:description:isEnabled:) — 辅助技术应使用哪个点来结束拖拽交互。
- accessibilityDirectTouch(_:options:) — 显式设置该辅助功能元素是否为直接触摸区域。直接触摸区域会把触摸事件直接传递给应用,而不是通过 VoiceOver 等辅助技术来处理。该修饰符接受一个可选的
AccessibilityDirectTouchOptions选项集合,用来定制直接触摸区域的功能。 - accessibilityZoomAction(_:) — 为视图添加一个辅助功能缩放动作。动作让 VoiceOver 等辅助技术可以通过调用该动作来与视图交互。
- AccessibilityDirectTouchOptions — 一个选项集合,定义视图直接触摸区域的功能。
- AccessibilityZoomGestureAction — 用户借助 VoiceOver 等辅助技术执行缩放手势时的位置和方向信息。
控制焦点
- accessibilityFocused(_:) — 把该视图辅助功能元素的焦点状态绑定到给定的布尔状态值,从而修改这个视图。
- accessibilityFocused(_:equals:) — 把该视图辅助功能元素的焦点状态绑定到给定的状态值,从而修改这个视图。
- AccessibilityFocusState — 一种属性包装器类型,可以读写一个由 SwiftUI 在 VoiceOver 等任何活跃辅助技术的焦点变化时更新的值。
管理交互性
- accessibilityRespondsToUserInteraction(_:) — 显式设置该辅助功能元素是否响应用户交互,从而会被切换控制、语音控制或全键盘控制等技术与之交互。
- accessibilityRespondsToUserInteraction(_:isEnabled:) — 显式设置该辅助功能元素是否响应用户交互,从而会被切换控制、语音控制或全键盘控制等技术与之交互。