4 无障碍描述

原文链接: https://developer.apple.com/documentation/swiftui/accessible-descriptions

4 无障碍描述

描述界面元素，帮助人们理解它们代表什么。

概述

SwiftUI 通常可以推断出关于用户界面元素的一些信息，但你可以使用辅助功能修饰符，为需要这些信息的用户提供更多内容。

关于设计指导，请参阅 Human Interface Guidelines 辅助功能部分中的 辅助功能。

应用标签

• accessibilityLabel(_:) — 为视图添加一个描述其内容的标签。
• accessibilityLabel(_:isEnabled:) — 为视图添加一个描述其内容的标签。
• accessibilityLabel(content:) — 为视图添加一个描述其内容的标签。
• accessibilityInputLabels(_:) — 设置用户用来标识某个视图的备用输入标签。
• accessibilityInputLabels(_:isEnabled:) — 设置用户用来标识某个视图的备用输入标签。
• accessibilityLabeledPair(role:id:in:) — 把表示标签的辅助功能元素与对应内容的元素配对。
• AccessibilityLabeledPairRole — 辅助功能元素在标签/内容配对中的角色。

描述值

• accessibilityValue(_:) — 添加对视图所含值的文本描述。
• accessibilityValue(_:isEnabled:) — 添加对视图所含值的文本描述。

描述内容

• accessibilityTextContentType(_:) — 设置辅助功能文本内容类型。
• accessibilityHeading(_:) — 设置该标题的辅助功能层级。
• AccessibilityHeadingLevel — 某个标题相对于其他标题的层级。
• AccessibilityTextContentType — 辅助技术可用来改善朗读文本呈现效果的文本上下文。

描述图表

• accessibilityChartDescriptor(_:) — 为一个表示图表的 View 添加描述符，让图表的内容对所有用户都可访问。
• AXChartDescriptorRepresentable — 用于生成 AXChartDescriptor 对象的类型，你用它为 VoiceOver 等辅助技术提供关于图表及其数据的可访问体验。

添加自定义描述

• accessibilityCustomContent(::importance:) — 为视图添加额外的辅助功能信息。
• AccessibilityCustomContentKey — 用于指定附加辅助功能信息条目所关联标识符和标签的键。

为内容分配特征

• accessibilityAddTraits(_:) — 为视图添加给定的特征。
• accessibilityRemoveTraits(_:) — 从该视图移除给定的特征。
• AccessibilityTraits — 一组描述元素行为的辅助功能特征。

提供提示

• accessibilityHint(_:) — 告知用户执行该视图的动作之后会发生什么。
• accessibilityHint(_:isEnabled:) — 告知用户执行该视图的动作之后会发生什么。

配置 VoiceOver

• speechAdjustedPitch(_:) — 提高或降低朗读文本的音高。
• speechAlwaysIncludesPunctuation(_:) — 设置 VoiceOver 是否应始终读出文本视图中的所有标点符号。
• speechAnnouncementsQueued(_:) — 控制待播报内容是排在已有朗读内容之后，而不是打断正在进行的朗读。
• speechSpellsOutCharacters(_:) — 设置 VoiceOver 是否应逐字符读出文本视图的内容。