---
title: ArrangementView
framework: SwiftUI
role: symbol
role_heading: Structure
platforms: [iOS 27.1+, iPadOS 27.1+]
path: swiftui/arrangementview
---

# ArrangementView

A view that arranges primary and secondary content using an adaptive layout that responds to the environment.

## Declaration

```swift
nonisolated struct ArrangementView<Primary, Secondary> where Primary : View, Secondary : View
```

## Overview

Overview You create an arrangement view with a primary and secondary view. The arrangement view computes a layout for its content based on the context it is presented in, including the available size, size class, and hardware features. Use the arrangementViewStyle(_:) modifier to choose how the arrangement view lays out its content. The default style is AutomaticArrangementViewStyle, which resolves to a split arrangement. The other built-in styles are OverlayArrangementViewStyle and SplitArrangementViewStyle. Overlay arrangements An overlay arrangement layers the primary view on top of the secondary view in z-order. This layout is well-suited for full screen experiences like media players, where playback controls overlay a video surface: ArrangementView {     PlayerControls() } secondary: {     VideoPlayer() } .arrangementViewStyle(.overlay) When the environment changes, such as when a foldable device is folded, the overlay arrangement can transition its views from a layered layout into a side-by-side layout. Use axes(_:) to control which axes are supported. Split arrangements A split arrangement places the primary and secondary views side by side along one or more axes. Use this layout for experiences that display two distinct pieces of content simultaneously, such as a music player alongside its lyrics: ArrangementView {     NowPlayingView() } secondary: {     LyricsView() } .arrangementViewStyle(.split) The split arrangement adapts its axis based on the available size and size class. You can constrain which axes the split supports using axes(_:).

## Topics

### Creating an arrangement view

- [init(primary:secondary:)](swiftui/arrangementview/init(primary:secondary:).md)
- [init(_:)](swiftui/arrangementview/init(_:).md)
- [ArrangementViewStyleConfiguration](swiftui/arrangementviewstyleconfiguration.md)

### Configuring an arrangement view

- [arrangementViewStyle(_:)](swiftui/view/arrangementviewstyle(_:).md)

## Relationships

### Conforms To

- [View](swiftui/view.md)

## See Also

### Dynamically arranging a primary and secondary view

- [arrangementViewStyle(_:)](swiftui/view/arrangementviewstyle(_:).md)
- [ArrangementViewStyle](swiftui/arrangementviewstyle.md)
- [overlayArrangementEdge(_:)](swiftui/view/overlayarrangementedge(_:).md)
- [splitArrangementFixedLayoutSize(horizontal:vertical:)](swiftui/view/splitarrangementfixedlayoutsize(horizontal:vertical:).md)
- [splitArrangementLayoutRatio(_:)](swiftui/view/splitarrangementlayoutratio(_:).md)
- [splitArrangementLayoutRatio(minHorizontal:idealHorizontal:maxHorizontal:minVertical:idealVertical:maxVertical:)](swiftui/view/splitarrangementlayoutratio(minhorizontal:idealhorizontal:maxhorizontal:minvertical:idealvertical:maxvertical:).md)
- [splitArrangementLayoutSize(minWidth:idealWidth:maxWidth:minHeight:idealHeight:maxHeight:)](swiftui/view/splitarrangementlayoutsize(minwidth:idealwidth:maxwidth:minheight:idealheight:maxheight:).md)