SpatialTapGesture
A gesture that recognizes one or more taps and reports their location.
Declaration
type SpatialTapGesture = { count?: number; coordinateSpace?: CoordinateSpaceProtocol; } | { count?: number; coordinateSpace?: CoordinateSpaceProtocol; inputKinds?: GestureInputKinds; };nonisolated struct SpatialTapGestureOverview
To recognize a tap gesture on a view, create and configure the gesture, and
then add it to the view using the View.gesture(_:including:) modifier.
The following code adds a tap gesture to a Circle that toggles the color
of the circle based on the tap location:
struct TapGestureView: View {
@State private var location: CGPoint = .zero
var tap: some Gesture {
SpatialTapGesture()
.onEnded { event in
self.location = event.location
}
}
var body: some View {
Circle()
.fill(self.location.y > 50 ? Color.blue : Color.red)
.frame(width: 100, height: 100, alignment: .center)
.gesture(tap)
}
}From Apple’s SwiftUI documentation. Code samples there are Swift.
See also
More in Gestures and input.
- AutomaticHoverEffectThe default hover effect based on the surrounding context.
- CustomHoverEffectA type that represents how a view should change when a pointer hovers over a view, or when someone looks at the view.
- DragConfigurationThe behavior of the drag, proposed by the dragging source. A value that describes the drag operations a drag source supports.
- DragConfigurationOperationsOutsideAppDescribes the suggested drag operations to other applications.
- DragConfigurationOperationsWithinAppDescribes the drag operations suggested to destinations within the app.
- DragGestureA dragging motion that invokes an action as the drag-event sequence changes.
- DragGestureValueThe attributes of a drag gesture.
- DragSessionDescribes the ongoing dragging session.
- DragSessionIDThe identifier of a drag session.
- DragSessionPhaseThe phase of the current drag session
- GestureAn instance that matches a sequence of events to a gesture, and returns a stream of values for each of its states.
- GestureChainGesture with chained calls: SwiftUI.Gesture.exclusively(...).