accessibilityLinkedGroup
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.
Declaration
compose().accessibilityLinkedGroup<ID>({
id: ID,
in: string,
})nonisolated func accessibilityLinkedGroup<ID>(
id: ID,
in namespace: Namespace.ID
) -> some View
where ID : HashableParameters
options.id*IDA hashable identifier used to separate sets of linked elements within the same namespace. Elements with matching
namespaceandidwill be linked together.options.in*string
Discussion
This can be useful to allow quickly jumping between content in a list and
the same content shown in a detail view, for example. All elements marked
with accessibilityLinkedGroup with the same namespace and identifier will be
linked together.
When all elements in the linked group are text views (Text, TextEditor,
or TextField), VoiceOver treats the group as a single text element — line,
word, and character navigation moves across element boundaries as if the views
form one continuous text region. On macOS, this unified text navigation uses
shared text UI elements. If any element in the group is not a text view, the
standard linking behavior applies.
See also
More in Accessibility.
- accessibilityActionAdds an accessibility action to the view. Actions allow assistive technologies, such as the VoiceOver, to interact with the view by invoking the action.
- accessibilityActionsAdds multiple accessibility actions to the view.
- accessibilityActivationPointThe activation point for an element is the location assistive technologies use to initiate gestures.
- accessibilityAddTraitsAdds the given traits to the view.
- accessibilityAdjustableActionAdds an accessibility adjustable action to the view. Actions allow assistive technologies, such as the VoiceOver, to interact with the view by invoking the action.
- accessibilityChildrenReplaces the existing accessibility element's children with one or more new synthetic accessibility elements.
- accessibilityCustomContentAdd additional accessibility information to the view.
- accessibilityDefaultFocusDefines a region in which default accessibility focus is evaluated by assigning a value to a given accessibility focus state binding.
- accessibilityDirectTouchExplicitly set whether this accessibility element is a direct touch area. Direct touch areas passthrough touch events to the app rather than being handled through an assistive technology, such as VoiceOver. The modifier accepts an optional AccessibilityDirectTouchOptions option set to customize the functionality of the direct touch area.
- accessibilityDragPointThe point an assistive technology should use to begin a drag interaction.
- accessibilityDropPointThe point an assistive technology should use to end a drag interaction.
- accessibilityElementCreates a new accessibility element, or modifies the AccessibilityChildBehavior of the existing accessibility element.