# gesture(_:including:) Attaches a gesture to the view with a lower precedence than gestures defined by the view. ``` nonisolated func gesture(_ gesture: T, including mask: GestureMask = .all) -> some View where T : Gesture ``` ## Parameters `gesture` A gesture to attach to the view. `mask` A value that controls how adding this gesture to the view affects other gestures recognized by the view and its subviews. Defaults to [`all`](/documentation/SwiftUI/GestureMask/all). ## Discussion Use this method when you need to attach a gesture to a view. The example below defines a custom gesture that prints a message to the console and attaches it to the view’s [`VStack`](/documentation/SwiftUI/VStack). Inside the [`VStack`](/documentation/SwiftUI/VStack) a red heart [`Image`](/documentation/SwiftUI/Image) defines its own [`TapGesture`](/documentation/SwiftUI/TapGesture) handler that also prints a message to the console, and blue rectangle with no custom gesture handlers. Tapping or clicking the image prints a message to the console from the tap gesture handler on the image, while tapping or clicking the rectangle inside the [`VStack`](/documentation/SwiftUI/VStack) prints a message in the console from the enclosing vertical stack gesture handler. ``` struct GestureExample: View { @State private var message = "Message" let newGesture = TapGesture().onEnded { print("Tap on VStack.") } var body: some View { VStack(spacing:25) { Image(systemName: "heart.fill") .resizable() .frame(width: 75, height: 75) .padding() .foregroundColor(.red) .onTapGesture { print("Tap on image.") } Rectangle() .fill(Color.blue) } .gesture(newGesture) .frame(width: 200, height: 200) .border(Color.purple) } } ``` --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)