Interactive previews iPhone Duo

Overlay Arrangement ZIndex

The z-index for a view within an overlay arrangement view.

Overlay Arrangement ZIndex - Preview Not Available

Platform Compatibility

iOS 27.1+ iPadOS 27.1+

Tags

SwiftUI Code

Docs
var body: some View {
    ArrangementView {
        SecondaryView()
    } secondary: {
        Color.orange
    }
    .arrangementViewStyle(.overlay)
}

struct SecondaryView: View {
    @Environment(\.overlayArrangementZIndex) var zIndex

    var body: some View {
        Color.blue
            .frame(width: 210, height: 210)
            .opacity(zIndex == 0 ? 1.0 : 0)
    }
}

Found an issue or have a suggestion?

Created: September 28, 2026Updated: October 20, 2026

More ArrangementView Components

View all
Overlay Arrangement Edge - iOS on iPhone Duo - Landscape - Partially Open - Liquid Glass - Light Mode - Preview
modifier

Overlay Arrangement Edge

The horizontal edge a view in an overlay arrangement occupies when the arrangement transitions to a horizontal layout. In this case, the primary view overlays the secondary view at the trailing edge when the screen is partially open in landscape.

Overlay Arrangement Style - iOS on iPhone Duo - Landscape - Fully Open - Liquid Glass - Light Mode - Preview
style

Overlay Arrangement Style

An arrangement view style that layers the primary view over the secondary view in z-order.

Only Horizontal Split Arrangement Style - iOS on iPhone Duo - Portrait - Fully Open - Liquid Glass - Light Mode - Preview
style

Only Horizontal Split Arrangement Style

Creates a horizontal split arrangement only in portrait orientation. In landscape orientation, no split is applied.

Split Arrangement Layout Ratio - iOS on iPhone Duo - Landscape - Fully Open - Liquid Glass - Light Mode - Preview
modifier

Split Arrangement Layout Ratio

Sets the preferred size ratio for an arrangement view in a split style. Use this modifier when you want to customize the size of the view compared to its other views in the split layout.

ArrangementView - iOS on iPhone Duo - Landscape - Fully Open - Liquid Glass - Light Mode - Preview
initializer

ArrangementView

Creates an arrangement view with a primary and secondary view.

Explore Other Components

Browse all
Custom Header Subscription Store View - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
initializer

Custom Header Subscription Store View

Creates a view that loads all the subscriptions in a subscription group from the App Store, and merchandises them with custom marketing content.

GroupBox - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
initializer

GroupBox

A simple GroupBox

Delete Disabled - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview
modifier

Delete Disabled

Adds a condition for whether the view’s view hierarchy is deletable.

Button Sizing - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
modifier

Button Sizing

The preferred sizing behavior of buttons in the view hierarchy.

GroupBox With Label - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
initializer

GroupBox With Label

A GroupBox with Label

InsetGroupedListStyle - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview
style

InsetGroupedListStyle

The list style that describes the behavior and appearance of an inset grouped list.

UIKit Separator Colors - iOS on iPhone - Portrait - Flat Design - Light Mode - Preview
type

UIKit Separator Colors

The UIKit separator colors that are also used in other components, such as the TextField

Button Tint - iOS on iPhone - Portrait - Liquid Glass - Light Mode - Preview
style

Button Tint

Sets the buttons tint color