accessibilityShowsLargeContentViewer
Adds a custom large content view to be shown by the large content viewer.
Overloads
2 ways to call compose().accessibilityShowsLargeContentViewer(). Each is one SwiftUI overload, picked by the arguments you pass.
compose().accessibilityShowsLargeContentViewer(
largeContentView: ReactNode
)nonisolated func accessibilityShowsLargeContentViewer<V>(
@ContentBuilder _ largeContentView: () -> V
) -> some View
where V : ViewParameters
largeContentView*ReactNode
Discussion
Rely on the large content viewer only in situations where items must remain small due to unavoidable design constraints. For example, buttons in a tab bar remain small to leave more room for the main app content.
The following example shows how to add a custom large content view:
var body: some View {
Button(action: newMessage) {
Image(systemName: "plus")
}
.accessibilityShowsLargeContentViewer {
Label("New Message", systemImage: "plus")
}
}Don’t use the large content viewer as a replacement for proper Dynamic Type support. For example, Dynamic Type allows items in a list to grow or shrink vertically to accommodate the user’s preferred font size. Rely on the large content viewer only in situations where items must remain small due to unavoidable design constraints.
For example, views that have their Dynamic Type size constrained
with View.dynamicTypeSize(_:) may require a
large content view.
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.