<!--
{
  "availability" : [
    "iOS: 27.1.0 -",
    "iPadOS: 27.1.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/GeometryProxy/reservedRegions(kind:options:layoutDirectionBehavior:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI13GeometryProxyV15reservedRegions4kind7options23layoutDirectionBehaviorSayAA14ReservedRegionVGAI4KindV_AI12QueryOptionsVAA06LayoutjK0OtF"
  },
  "title" : "reservedRegions(kind:options:layoutDirectionBehavior:)"
}
-->

# reservedRegions(kind:options:layoutDirectionBehavior:)

Returns an array of reserved regions that match the selection options you specify.

```
func reservedRegions(kind: ReservedRegion.Kind, options: ReservedRegion.QueryOptions = [], layoutDirectionBehavior: LayoutDirectionBehavior = .mirrors) -> [ReservedRegion]
```

## Discussion

A reserved region indicates an area within a view’s coordinate space that an entity, such as the device hardware, reserves. Arrange the view’s content to account for this region. Each region describes a frame, margins, active state, and an identifier.

There are two categories of reserved regions:

- [`occlusion`](/documentation/SwiftUI/ReservedRegion/Kind-swift.struct/occlusion): An area where an element, such as the Dynamic Island, a camera, or window controls, occludes content.
- [`division`](/documentation/SwiftUI/ReservedRegion/Kind-swift.struct/division): An area where content splits into separate regions, such as at the fold of a hinge.

Read reserved regions using the [`reservedRegions(kind:options:layoutDirectionBehavior:)`](/documentation/SwiftUI/GeometryProxy/reservedRegions(kind:options:layoutDirectionBehavior:)) method, which returns all of the reserved regions that currently intersect your view regardless of whether they are currently active.

In the example below, a custom [`Layout`](/documentation/SwiftUI/Layout) uses the reserved regions from a [`GeometryProxy`](/documentation/SwiftUI/GeometryProxy) instance to handle positioning its subviews away from any regions that intersect it.

```swift
GeometryReader { proxy in
    RegionAvoidingLayout(
        regions: proxy.reservedRegions(kind: .occlusion)
    ) {
        ForEach(items) { item in
            ItemView(item)
        }
    }
}    
```

When you manually position your content to incorporate reserved regions, take care to consider right-to-left layout directions. Reserved regions are typically in a fixed coordinate space; the absolute location of the camera of a device doesn’t flip depending on a person’s preferred language. By default, the system mirrors the geometry of these regions automatically before it provides them to SwiftUI APIs.

For example, a [`Layout`](/documentation/SwiftUI/Layout) automatically flips the geometry of the subviews you place. By mirroring the geometry of the reserved regions, your layout doesn’t need to account for the layout direction when determining whether a subview intersects the region.

There may be cases when you need to make more manual adjustments for the frames of reserved regions for right-to-left layout directions. In these cases, you can provide the [`LayoutDirectionBehavior.fixed`](/documentation/SwiftUI/LayoutDirectionBehavior/fixed) value to the method and the system doesn’t mirror the frames of the regions.

---

Copyright &copy; 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)