Accessible Navigation

Enable users to navigate to specific user interface elements.

Overview 概要

An accessibility rotor is a shortcut that enables users to quickly navigate to specific elements of the user interface, and optionally to specific ranges of text within those elements. The system automatically provides rotors for many navigable elements, but you can supply additional rotors for specific purposes, or replace system rotors when they don’t automatically pick up off-screen elements, like those far down in a LazyVStack or a List.

Topics 話題

Creating Rotors

func accessibilityRotor<Content>(LocalizedStringKey, entries: () -> Content) -> some View
Create an Accessibility Rotor with the specified user-visible label, and entries generated from the content closure.
func accessibilityRotor<Content>(Text, entries: () -> Content) -> some View
Create an Accessibility Rotor with the specified user-visible label, and entries generated from the content closure.
func accessibilityRotor<L, Content>(L, entries: () -> Content) -> some View
Create an Accessibility Rotor with the specified user-visible label, and entries generated from the content closure.
protocol AccessibilityRotorContent
Content within an accessibility rotor.
struct AccessibilityRotorContentBuilder
Result builder you use to generate rotor entry content.
struct AccessibilityRotorEntry
A struct representing an entry in an Accessibility Rotor.

Creating Rotors from a Collection

func accessibilityRotor<EntryModel, ID>(LocalizedStringKey, entries: [EntryModel], entryID: KeyPath<EntryModel, ID>, entryLabel: KeyPath<EntryModel, String>) -> some View
Create an Accessibility Rotor with the specified user-visible label and entries.
func accessibilityRotor<EntryModel, ID>(Text, entries: [EntryModel], entryID: KeyPath<EntryModel, ID>, entryLabel: KeyPath<EntryModel, String>) -> some View
Create an Accessibility Rotor with the specified user-visible label and entries.
func accessibilityRotor<L, EntryModel, ID>(L, entries: [EntryModel], entryID: KeyPath<EntryModel, ID>, entryLabel: KeyPath<EntryModel, String>) -> some View
Create an Accessibility Rotor with the specified user-visible label and entries.

Creating Rotors with a Label

func accessibilityRotor<EntryModel>(LocalizedStringKey, entries: [EntryModel], entryLabel: KeyPath<EntryModel, String>) -> some View
Create an Accessibility Rotor with the specified user-visible label and entries.
func accessibilityRotor<EntryModel>(Text, entries: [EntryModel], entryLabel: KeyPath<EntryModel, String>) -> some View
Create an Accessibility Rotor with the specified user-visible label and entries.
func accessibilityRotor<L, EntryModel>(L, entries: [EntryModel], entryLabel: KeyPath<EntryModel, String>) -> some View
Create an Accessibility Rotor with the specified user-visible label and entries.

Creating Rotors for Text Ranges

func accessibilityRotor(LocalizedStringKey, textRanges: [Range<String.Index>]) -> some View
Create an Accessibility Rotor with the specified user-visible label and entries for each of the specified ranges. The Rotor will be attached to the current Accessibility element, and each entry will go the specified range of that element.
func accessibilityRotor(Text, textRanges: [Range<String.Index>]) -> some View
Create an Accessibility Rotor with the specified user-visible label and entries for each of the specified ranges. The Rotor will be attached to the current Accessibility element, and each entry will go the specified range of that element.
func accessibilityRotor<L>(L, textRanges: [Range<String.Index>]) -> some View
Create an Accessibility Rotor with the specified user-visible label and entries for each of the specified ranges. The Rotor will be attached to the current Accessibility element, and each entry will go the specified range of that element.

Replacing System Rotors

func accessibilityRotor<Content>(AccessibilitySystemRotor, entries: () -> Content) -> some View
Create an Accessibility Rotor replacing the specified system-provided Rotor.
func accessibilityRotor<EntryModel, ID>(AccessibilitySystemRotor, entries: [EntryModel], entryID: KeyPath<EntryModel, ID>, entryLabel: KeyPath<EntryModel, String>) -> some View
Create an Accessibility Rotor replacing the specified system-provided Rotor.
func accessibilityRotor<EntryModel>(AccessibilitySystemRotor, entries: [EntryModel], entryLabel: KeyPath<EntryModel, String>) -> some View
Create an Accessibility Rotor replacing the specified system-provided Rotor.
func accessibilityRotor(AccessibilitySystemRotor, textRanges: [Range<String.Index>]) -> some View
Create an Accessibility Rotor replacing the specified system-provided Rotor. The Rotor will be attached to the current Accessibility element, and each entry will go the specified range of that element.
struct AccessibilitySystemRotor
Designates a Rotor that replaces one of the automatic, system-provided Rotors with a developer-provided Rotor.

Configuring Rotors

func accessibilityRotorEntry<ID>(id: ID, in: Namespace.ID) -> some View
Defines an explicit identifier tying an Accessibility element for this view to an entry in an Accessibility Rotor.
func accessibilityLinkedGroup<ID>(id: ID, in: Namespace.ID) -> some View
Links multiple accessibility elements so that the user can quickly navigate from one element to another, even when the elements are not near each other in the accessibility hierarchy. 複数のアクセシビリティ要素を連結します、それでユーザは素早く一方の要素から他のものへと進んで行けます、それら要素がアクセシビリティ要素階層において互いに近くない時でさえ。
func accessibilitySortPriority(Double) -> ModifiedContent<Self, AccessibilityAttachmentModifier>
Sets the sort priority order for this view’s accessibility element, relative to other elements at the same level. このビューのもつアクセシビリティ要素に対してソート優先順位を設定します、同じ水準での他の要素に相対して。