How to control which screen edges trigger system gestures using preferredScreenEdgesDeferringSystemGestures
Swift version: 5.6
iOS 11.0 was the first to showcase complex system gestures based around the iPhone X, and it’s the point now where all edges of the screen do different things on different devices.
Historically, iOS apps automatically delayed system gestures from the top and bottom edges if they were run as full screen apps – if they hid the status bar – but as of iOS 11 you should now make your view controllers override the preferredScreenEdgesDeferringSystemGestures property to tell the system which edges should delay the built-in system gestures.
For example, if you main view controller uses the bottom screen edge you might give it code like this:
override func preferredScreenEdgesDeferringSystemGestures() -> UIRectEdge {
return [.bottom]
}That will allow iOS to use left, right, and top edge swipes freely, but defer the system gesture for bottom swipes.
SAVE 50% To celebrate WWDC23, all our books and bundles are half price, so you can take your Swift knowledge further without spending big! Get the Swift Power Pack to build your iOS career faster, get the Swift Platform Pack to builds apps for macOS, watchOS, and beyond, or get the Swift Plus Pack to learn advanced design patterns, testing skills, and more.
Available from iOS 11.0 – learn more in my book Advanced iOS: Volume Two
Similar solutions…
- How to stop system gestures from interfering with your own
- How to control which view is shown when your app launches
- How to make two gestures recognize at the same time using simultaneousGesture()
- How to disable undo, redo, copy, and paste gestures using editingInteractionConfiguration
- How to let users share content using the system share sheet
About the Swift Knowledge Base
This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.
