# gesture(_:isEnabled:) Attaches a gesture to the view with a lower precedence than gestures defined by the view. ``` @export(implementation) nonisolated func gesture(_ gesture: T, isEnabled: Bool) -> some View where T : Gesture ``` ## Parameters `gesture` A gesture to attach to the view. `isEnabled` Whether the added gesture is enabled. ## 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. You can also use the `isEnabled` parameter to conditionally disable the gesture. ``` struct GestureExample: View { @State private var message = "Message" var isGestureEnabled: Bool 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, isEnabled: isGestureEnabled) .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)