<!--
{
  "availability" : [
    "iOS: -",
    "iPadOS: -",
    "macOS: 26.0.0 -",
    "visionOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/ImmersionStyle/progressive(aspectRatio:)",
  "metadataVersion" : "0.1.0",
  "role" : "Type Method",
  "symbol" : {
    "kind" : "Type Method",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI14ImmersionStylePA2A011ProgressivecD0VRszrlE11progressive11aspectRatioAeA0ec6AspectH0V_tFZ"
  },
  "title" : "progressive(aspectRatio:)"
}
-->

# progressive(aspectRatio:)

An immersion style that displays unbounded content that partially
replaces passthrough video.

```
static func progressive(aspectRatio: ProgressiveImmersionAspectRatio) -> ProgressiveImmersionStyle
```

## Parameters

`aspectRatio`

The aspect ratio of the portal.

## Discussion

Use the [`immersionStyle(selection:in:)`](/documentation/SwiftUI/Scene/immersionStyle(selection:in:)) scene modifier to
specify this style for an [`ImmersiveSpace`](/documentation/SwiftUI/ImmersiveSpace).

The immersion style affects how windows interact with virtual objects
in the environment. In `progressive` immersion, windows always render
in front of virtual content, no matter how someone positions the window
or the content. This helps people to avoid losing track of windows
behind virtual content when passthrough is off.

The system initially uses a portal effect that replaces
passthrough in a portion of the field of view. People can
interactively adjust the size of the portal by rotating the Digital
Crown, including down to a minimum amount of immersion defined by the
app and up to the defined maximum amount of immersion.

---

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)