accessibilityDirectTouch
Explicitly 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.
View ModifieriOS 17.0+macOS 14.0+tvOS 17.0+watchOS 10.0+accessibilityDirectTouch(_:options:) in SwiftUI
Declaration
compose().accessibilityDirectTouch(
isDirectTouchArea?: boolean,
options?: {
options?: SwiftUI.AccessibilityDirectTouchOptions;
}
)nonisolated func accessibilityDirectTouch(
_ isDirectTouchArea: Bool = true,
options: AccessibilityDirectTouchOptions = []
) -> ModifiedContent<Self, AccessibilityAttachmentModifier>Parameters
isDirectTouchAreabooleanoptions.optionsSwiftUI.AccessibilityDirectTouchOptions
Discussion
For example, this is how a direct touch area would allow a VoiceOver
user to interact with a view with a rotationEffect controlled by a
RotationGesture. The direct touch area would require a user to
activate the area before using the direct touch area.
var body: some View {
Rectangle()
.frame(width: 200, height: 200, alignment: .center)
.rotationEffect(angle)
.gesture(rotation)
.accessibilityDirectTouch(options: .requiresActivation)
}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.
- 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.
- accessibilityFocusedModifies this view by binding its accessibility element's focus state to the given boolean state value.