Référence des conteneurs SwiftUI
Stacks, grilles, plans et améliorations de défilement. iOS 14 à iOS 26.
Sources : WWDC 2020-10031, 2022-10056, 2023-10148, 2024-10144, 2025-256
Décision rapide
| Cas d'utilisation | Conteneur | iOS |
|---|---|---|
| Vues fixes verticales/horizontales | VStack / HStack | 13+ |
| Vues superposées | ZStack | 13+ |
| Grande liste défilante | LazyVStack / LazyHStack | 14+ |
| Grille multi-colonnes | LazyVGrid | 14+ |
| Grille multi-lignes (horizontale) | LazyHGrid | 14+ |
| Grille statique, alignement précis | Grid | 16+ |
| Données hiérarchiques (arbre) | List avec children: | 14+ |
| Hiérarchies personnalisées | OutlineGroup | 14+ |
| Afficher/masquer du contenu | DisclosureGroup | 14+ |
Partie 1 : Stacks
VStack, HStack, ZStack
VStack(alignment: .leading, spacing: 12) {
Text("Titre")
Text("Sous-titre")
}
HStack(alignment: .top, spacing: 8) {
Image(systemName: "star")
Text("Note")
}
ZStack(alignment: .bottomTrailing) {
Image("photo")
Badge()
}
Alignements ZStack : .center (défaut), .top, .bottom, .leading, .trailing, .topLeading, .topTrailing, .bottomLeading, .bottomTrailing
Spacer
HStack {
Text("Gauche")
Spacer()
Text("Droite")
}
Spacer(minLength: 20) // Taille minimale
LazyVStack, LazyHStack (iOS 14+)
Rendent les enfants uniquement lorsqu'ils sont visibles. Utilisation à l'intérieur d'un ScrollView.
ScrollView {
LazyVStack(spacing: 0) {
ForEach(items) { item in
ItemRow(item: item)
}
}
}
En-têtes de section épinglés
ScrollView {
LazyVStack(pinnedViews: [.sectionHeaders]) {
ForEach(sections) { section in
Section(header: SectionHeader(section)) {
ForEach(section.items) { item in
ItemRow(item: item)
}
}
}
}
}
Partie 2 : Grilles
Grid (iOS 16+)
Grille non paresseuse avec alignement précis. Charge toutes les vues à la fois.
Grid(alignment: .leading, horizontalSpacing: 10, verticalSpacing: 10) {
GridRow {
Text("Nom")
TextField("Saisir le nom", text: $name)
}
GridRow {
Text("Email")
TextField("Saisir l'email", text: $email)
}
}
Modificateurs :
gridCellColumns(_:)— Étend sur plusieurs colonnesgridColumnAlignment(_:)— Remplace l'alignement de colonne
Grid {
GridRow {
Text("En-tête").gridCellColumns(2)
}
GridRow {
Text("Gauche")
Text("Droite").gridColumnAlignment(.trailing)
}
}
LazyVGrid (iOS 14+)
Grille à défilement vertical. Définit les colonnes ; les lignes croissent sans limite.
let columns = [
GridItem(.flexible()),
GridItem(.flexible()),
GridItem(.flexible())
]
ScrollView {
LazyVGrid(columns: columns, spacing: 16) {
ForEach(items) { item in
ItemCard(item: item)
}
}
}
LazyHGrid (iOS 14+)
Grille à défilement horizontal. Définit les lignes ; les colonnes croissent sans limite.
let rows = [GridItem(.fixed(100)), GridItem(.fixed(100))]
ScrollView(.horizontal) {
LazyHGrid(rows: rows, spacing: 16) {
ForEach(items) { item in
ItemCard(item: item)
}
}
}
GridItem.Size
| Taille | Comportement |
|---|---|
.fixed(CGFloat) | Largeur/hauteur exacte |
.flexible(minimum:maximum:) | Remplit l'espace équitablement |
.adaptive(minimum:maximum:) | Crée autant d'éléments que possible |
// Adaptatif : nombre de colonnes réactif
let columns = [GridItem(.adaptive(minimum: 150))]
Partie 3 : Plans
List avec données hiérarchiques (iOS 14+)
struct FileItem: Identifiable {
let id = UUID()
var name: String
var children: [FileItem]? // nil = feuille
}
List(files, children: \.children) { file in
Label(file.name, systemImage: file.children != nil ? "folder" : "doc")
}
.listStyle(.sidebar)
OutlineGroup (iOS 14+)
Pour des mises en page hiérarchiques personnalisées en dehors de List.
List {
ForEach(canvases) { canvas in
Section(header: Text(canvas.name)) {
OutlineGroup(canvas.graphics, children: \.children) { graphic in
GraphicRow(graphic: graphic)
}
}
}
}
DisclosureGroup (iOS 14+)
@State private var isExpanded = false
DisclosureGroup("Options avancées", isExpanded: $isExpanded) {
Toggle("Activer la fonctionnalité", isOn: $feature)
Slider(value: $intensity)
}
Partie 4 : Modèles courants
Grille de photos
let columns = [GridItem(.adaptive(minimum: 100), spacing: 2)]
ScrollView {
LazyVGrid(columns: columns, spacing: 2) {
ForEach(photos) { photo in
AsyncImage(url: photo.thumbnailURL) { image in
image.resizable().aspectRatio(1, contentMode: .fill)
} placeholder: { Color.gray }
.aspectRatio(1, contentMode: .fill)
.clipped()
}
}
}
Carrousel horizontal
ScrollView(.horizontal, showsIndicators: false) {
LazyHStack(spacing: 16) {
ForEach(items) { item in
CarouselCard(item: item).frame(width: 280)
}
}
.padding(.horizontal)
}
Navigateur de fichiers
List(selection: $selection) {
OutlineGroup(rootItems, children: \.children) { item in
Label {
Text(item.name)
} icon: {
Image(systemName: item.children != nil ? "folder.fill" : "doc.fill")
}
}
}
.listStyle(.sidebar)
Partie 5 : Performances
Quand utiliser Lazy
| Taille | Défilable ? | Utilisation |
|---|---|---|
| 1-20 | Non | VStack/HStack |
| 1-20 | Oui | VStack/HStack dans ScrollView |
| 20-100 | Oui | LazyVStack/LazyHStack |
| 100+ | Oui | LazyVStack/LazyHStack ou List |
| Grille <50 | Non | Grid |
| Grille 50+ | Oui | LazyVGrid/LazyHGrid |
Mettre en cache les tableaux GridItem — définir en dehors du body :
struct ContentView: View {
let columns = [GridItem(.adaptive(minimum: 150))] // ✅
var body: some View {
LazyVGrid(columns: columns) { ... }
}
}
Performances iOS 26
- Chargement de liste 6x plus rapide pour 100k+ éléments
- Mises à jour de liste 16x plus rapides
- Réduction des images sautées lors du défilement
- ScrollViews imbriqués avec stacks paresseux diffèrent désormais correctement le chargement :
ScrollView(.horizontal) {
LazyHStack {
ForEach(photoSets) { set in
ScrollView(.vertical) {
LazyVStack {
ForEach(set.photos) { PhotoView(photo: $0) }
}
}
}
}
}
Partie 6 : Améliorations du défilement
containerRelativeFrame (iOS 17+)
Dimensionne les vues par rapport au conteneur de défilement.
ScrollView(.horizontal) {
LazyHStack {
ForEach(cards) { card in
CardView(card: card)
.containerRelativeFrame(.horizontal, count: 3, span: 1, spacing: 16)
}
}
}
scrollTargetLayout (iOS 17+)
Active l'accrochage.
ScrollView(.horizontal) {
LazyHStack {
ForEach(items) { ItemCard(item: $0) }
}
.scrollTargetLayout()
}
.scrollTargetBehavior(.viewAligned)
scrollPosition (iOS 17+)
Suivre l'élément visible le plus en haut. Nécessite .id() sur chaque élément.
@State private var position: Item.ID?
ScrollView {
LazyVStack {
ForEach(items) { item in
ItemRow(item: item).id(item.id)
}
}
}
.scrollPosition(id: $position)
scrollTransition (iOS 17+)
.scrollTransition { content, phase in
content
.opacity(1 - abs(phase.value) * 0.5)
.scaleEffect(phase.isIdentity ? 1.0 : 0.75)
}
onScrollGeometryChange (iOS 18+)
.onScrollGeometryChange(for: Bool.self) { geo in
geo.contentOffset.y < geo.contentInsets.top
} action: { _, isTop in
showBackButton = !isTop
}
onScrollVisibilityChange (iOS 18+)
VideoPlayer(player: player)
.onScrollVisibilityChange(threshold: 0.2) { visible in
visible ? player.play() : player.pause()
}
Ressources
WWDC : 2020-10031, 2022-10056, 2023-10148, 2024-10144, 2025-256
Docs : /swiftui/lazyvstack, /swiftui/lazyvgrid, /swiftui/lazyhgrid, /swiftui/grid, /swiftui/outlinegroup, /swiftui/disclosuregroup
Compétences : axiom-swiftui-layout, axiom-swiftui-layout-ref, axiom-swiftui-nav, axiom-swiftui-26-ref