SwiftUIコンテナリファレンス
スタック、グリッド、アウトライン、スクロール拡張機能。iOS 14からiOS 26まで。
出典: WWDC 2020-10031, 2022-10056, 2023-10148, 2024-10144, 2025-256
クイックデシジョン
| ユースケース | コンテナ | iOS |
|---|---|---|
| 固定ビューの垂直/水平 | VStack / HStack | 13+ |
| 重なり合うビュー | ZStack | 13+ |
| 大きなスクロール可能なリスト | LazyVStack / LazyHStack | 14+ |
| マルチカラムグリッド | LazyVGrid | 14+ |
| マルチローグリッド(水平) | LazyHGrid | 14+ |
| 静的グリッド、精密な配置 | Grid | 16+ |
| 階層データ(ツリー) | List(children: 付き) | 14+ |
| カスタム階層 | OutlineGroup | 14+ |
| コンテンツの表示/非表示 | DisclosureGroup | 14+ |
パート1: スタック
VStack, HStack, ZStack
VStack(alignment: .leading, spacing: 12) {
Text("タイトル")
Text("サブタイトル")
}
HStack(alignment: .top, spacing: 8) {
Image(systemName: "star")
Text("評価")
}
ZStack(alignment: .bottomTrailing) {
Image("photo")
Badge()
}
ZStackの配置: .center(デフォルト)、.top、.bottom、.leading、.trailing、.topLeading、.topTrailing、.bottomLeading、.bottomTrailing
Spacer
HStack {
Text("左")
Spacer()
Text("右")
}
Spacer(minLength: 20) // 最小サイズ
LazyVStack, LazyHStack(iOS 14+)
子ビューを可視時のみレンダリングします。ScrollView内で使用します。
ScrollView {
LazyVStack(spacing: 0) {
ForEach(items) { item in
ItemRow(item: item)
}
}
}
ピン留めセクションヘッダー
ScrollView {
LazyVStack(pinnedViews: [.sectionHeaders]) {
ForEach(sections) { section in
Section(header: SectionHeader(section)) {
ForEach(section.items) { item in
ItemRow(item: item)
}
}
}
}
}
パート2: グリッド
Grid(iOS 16+)
精密な配置が可能な非遅延グリッド。すべてのビューを一度に読み込みます。
Grid(alignment: .leading, horizontalSpacing: 10, verticalSpacing: 10) {
GridRow {
Text("名前")
TextField("名前を入力", text: $name)
}
GridRow {
Text("メール")
TextField("メールを入力", text: $email)
}
}
モディファイア:
gridCellColumns(_:)— 複数列にまたがるgridColumnAlignment(_:)— 列の配置をオーバーライド
Grid {
GridRow {
Text("ヘッダー").gridCellColumns(2)
}
GridRow {
Text("左")
Text("右").gridColumnAlignment(.trailing)
}
}
LazyVGrid(iOS 14+)
垂直スクロールグリッド。列を定義し、行は無制限に伸びます。
let columns = [
GridItem(.flexible()),
GridItem(.flexible()),
GridItem(.flexible())
]
ScrollView {
LazyVGrid(columns: columns, spacing: 16) {
ForEach(items) { item in
ItemCard(item: item)
}
}
}
LazyHGrid(iOS 14+)
水平スクロールグリッド。行を定義し、列は無制限に伸びます。
let rows = [GridItem(.fixed(100)), GridItem(.fixed(100))]
ScrollView(.horizontal) {
LazyHGrid(rows: rows, spacing: 16) {
ForEach(items) { item in
ItemCard(item: item)
}
}
}
GridItem.Size
| サイズ | 動作 |
|---|---|
.fixed(CGFloat) | 正確な幅/高さ |
.flexible(minimum:maximum:) | スペースを均等に埋める |
.adaptive(minimum:maximum:) | 収まる数だけ作成 |
// Adaptive: レスポンシブな列数
let columns = [GridItem(.adaptive(minimum: 150))]
パート3: アウトライン
階層データを持つList(iOS 14+)
struct FileItem: Identifiable {
let id = UUID()
var name: String
var children: [FileItem]? // nil = リーフ
}
List(files, children: \.children) { file in
Label(file.name, systemImage: file.children != nil ? "folder" : "doc")
}
.listStyle(.sidebar)
OutlineGroup(iOS 14+)
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("詳細オプション", isExpanded: $isExpanded) {
Toggle("機能を有効にする", isOn: $feature)
Slider(value: $intensity)
}
パート4: 共通パターン
フォトグリッド
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()
}
}
}
水平カルーセル
ScrollView(.horizontal, showsIndicators: false) {
LazyHStack(spacing: 16) {
ForEach(items) { item in
CarouselCard(item: item).frame(width: 280)
}
}
.padding(.horizontal)
}
ファイルブラウザ
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)
パート5: パフォーマンス
Lazyを使用するタイミング
| サイズ | スクロール可能? | 使用するもの |
|---|---|---|
| 1-20 | いいえ | VStack/HStack |
| 1-20 | はい | ScrollView内のVStack/HStack |
| 20-100 | はい | LazyVStack/LazyHStack |
| 100+ | はい | LazyVStack/LazyHStackまたはList |
| グリッド <50 | いいえ | Grid |
| グリッド 50+ | はい | LazyVGrid/LazyHGrid |
GridItem配列をキャッシュ — bodyの外部で定義:
struct ContentView: View {
let columns = [GridItem(.adaptive(minimum: 150))] // ✅
var body: some View {
LazyVGrid(columns: columns) { ... }
}
}
iOS 26のパフォーマンス
- 10万件以上のアイテムで6倍高速なリスト読み込み
- 16倍高速なリスト更新
- スクロール時のドロップフレーム低減
- LazyスタックをネストしたScrollViewが適切に読み込みを遅延:
ScrollView(.horizontal) {
LazyHStack {
ForEach(photoSets) { set in
ScrollView(.vertical) {
LazyVStack {
ForEach(set.photos) { PhotoView(photo: $0) }
}
}
}
}
}
パート6: スクロール拡張機能
containerRelativeFrame(iOS 17+)
ビューのサイズをスクロールコンテナに相対的に設定します。
ScrollView(.horizontal) {
LazyHStack {
ForEach(cards) { card in
CardView(card: card)
.containerRelativeFrame(.horizontal, count: 3, span: 1, spacing: 16)
}
}
}
scrollTargetLayout(iOS 17+)
スナップを有効にします。
ScrollView(.horizontal) {
LazyHStack {
ForEach(items) { ItemCard(item: $0) }
}
.scrollTargetLayout()
}
.scrollTargetBehavior(.viewAligned)
scrollPosition(iOS 17+)
先頭に表示されているアイテムを追跡します。各アイテムに .id() が必要です。
@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()
}
リソース
WWDC: 2020-10031, 2022-10056, 2023-10148, 2024-10144, 2025-256
ドキュメント: /swiftui/lazyvstack, /swiftui/lazyvgrid, /swiftui/lazyhgrid, /swiftui/grid, /swiftui/outlinegroup, /swiftui/disclosuregroup
スキル: axiom-swiftui-layout, axiom-swiftui-layout-ref, axiom-swiftui-nav, axiom-swiftui-26-ref