Communitygithub.com

SwiftUI アダプティブレイアウト

レイアウトをさまざまな画面サイズ、iPadのマルチタスク、iOS 26の自由形式ウィンドウに適応させる必要がある場合に使用します。ViewThatFits対AnyLayout対onGeometryChangeの決定木、サイズクラスの制限、デバイスベースのレイアウトミスを防ぐアンチパターンを提供します。

SwiftUI アダプティブレイアウト とは?

このスキルは、デバイスを前提とせず、利用可能なスペースに応答するSwiftUIレイアウトを構築するための規律を強化するものです。ViewThatFits、AnyLayout、onGeometryChange、Layoutプロトコルといった主要なツールの適切な選択基準を、意思決定木を用いて明確に示します。特に、iPadのサイズクラスが実質的に`.regular`のみであり、マルチタスキングやiOS 26のウィンドウリサイズでは不十分であることを解説し、実際のジオメトリに基づく解決策を推奨します。デバイスの向きやモデルに依存するアンチパターンとその修正方法を具体的に示し、将来のデバイスやOSアップデートでも壊れないレイアウトを作成するためのベストプラクティスを提供します。このスキルは、Claude Code、Cursor、CodexなどのAIエージェントがSwiftUIのレイアウト関連の質問に答える際に、正確で実践的なアドバイスを与えることを可能にします。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/CharlesWiltgen/Axiom/axiom-swiftui-layout

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

SwiftUI アダプティブレイアウト は何をしますか?

概要

デバイスの想定ではなく、利用可能なスペースに応答するレイアウトを構築するための規律を強化するスキルです。ツールの選択、サイズクラスの制限、iOS 26の自由形式ウィンドウ、および一般的なアンチパターンをカバーします。

核となる原則: あなたのレイアウトは、Appleが明日新しいデバイスを出荷したり、iPadOSが来年新しいマルチタスクモードを追加したりしても、正しく動作する必要があります。デバイスに関する仮定ではなく、コンテナに応答してください。

このスキルを使用するタイミング

  • 「このレイアウトをiPadとiPhoneで動作させるにはどうすればいいですか?」
  • 「GeometryReaderとViewThatFits、どちらを使うべきですか?」
  • 「分割ビュー/ステージマネージャでレイアウトが崩れます」
  • 「サイズクラスでは必要なものが得られません」
  • 「デザイナーが縦向きと横向きで異なるレイアウトを求めています」
  • 「iOS 26のウィンドウリサイズにアプリを準備しています」

決定木

「私のレイアウトを適応させる必要がある...」
│
├─ 利用可能なスペースに(コンテナ駆動)
│   │
│   ├─ 「最適なバリアントを選ぶ」
│   │   → ViewThatFits
│   │
│   ├─ 「H↔V間のアニメーション切り替え」
│   │   → AnyLayout + 条件
│   │
│   ├─ 「計算のためにサイズを読み取る」
│   │   → onGeometryChange (iOS 16+)
│   │
│   └─ 「カスタムレイアウトアルゴリズム」
│       → Layout プロトコル
│
├─ プラットフォーム特性に
│   │
│   ├─ 「コンパクト vs レギュラー幅」
│   │   → horizontalSizeClass (⚠️ iPadの制限)
│   │
│   ├─ 「アクセシビリティテキストサイズ」
│   │   → dynamicTypeSize.isAccessibilitySize
│   │
│   └─ 「プラットフォームの違い」
│       → #if os() / Environment
│
└─ ウィンドウ形状に(アスペクト比)
    │
    ├─ 「縦向き vs 横向きのセマンティクス」
    │   → Geometry + カスタムしきい値
    │
    ├─ 「列の自動表示/非表示」
    │   → NavigationSplitView (iOS 26で自動化)
    │
    └─ 「ウィンドウライフサイクル」
        → @Environment(\.scenePhase)

ツール選択

クイック決定

計算された値(幅、高さ)が必要ですか?
├─ はい → onGeometryChange
└─ いいえ → アニメーション遷移が必要ですか?
         ├─ はい → AnyLayout + 条件
         └─ いいえ → ViewThatFits

各ツールを使用するタイミング

必要なことこれを使うこれを使わない
2~3つのレイアウトバリアントから選択ViewThatFitsif size > X
H↔Vをアニメーションで切り替えAnyLayout条件付き HStack/VStack
コンテナサイズの読み取りonGeometryChangeGeometryReader
アクセシビリティテキストへの適応dynamicTypeSize固定のブレークポイント
コンパクト幅の検出horizontalSizeClassUIDevice.idiom
iPadの狭いウィンドウの検出Geometry + しきい値サイズクラスのみ
サイドバーの表示/非表示NavigationSplitView手動の列ロジック
カスタムレイアウトアルゴリズムLayout プロトコルネストされたGeometryReader

パターン 1: ViewThatFits

使用タイミング: 2~3つのレイアウトバリアントがあり、最初に収まるものをSwiftUIに選択させたい場合。

ViewThatFits {
    // 最初の選択: 水平
    HStack {
        Image(systemName: "star")
        Text("お気に入り")
        Spacer()
        Button("追加") { }
    }

    // フォールバック: 垂直
    VStack {
        HStack {
            Image(systemName: "star")
            Text("お気に入り")
        }
        Button("追加") { }
    }
}

制限: ViewThatFitsはどのバリアントが選択されたかを公開しません。他のビューでその状態が必要な場合は、代わりにAnyLayoutを使用してください。


パターン 2: アニメーション切り替えのためのAnyLayout

使用タイミング: レイアウト間のアニメーション遷移が必要な場合、または現在のレイアウト状態を知る必要がある場合。

struct AdaptiveStack<Content: View>: View {
    @Environment(\.horizontalSizeClass) var sizeClass

    let content: Content

    var layout: AnyLayout {
        sizeClass == .compact
            ? AnyLayout(VStackLayout(spacing: 12))
            : AnyLayout(HStackLayout(spacing: 20))
    }

    var body: some View {
        layout {
            content
        }
        .animation(.default, value: sizeClass)
    }
}

Dynamic Typeの場合:

@Environment(\.dynamicTypeSize) var dynamicTypeSize

var layout: AnyLayout {
    dynamicTypeSize.isAccessibilitySize
        ? AnyLayout(VStackLayout())
        : AnyLayout(HStackLayout())
}

パターン 3: onGeometryChange(ジオメトリには推奨)

使用タイミング: 計算に実際の寸法が必要な場合。GeometryReaderよりも推奨されます。

struct ResponsiveGrid: View {
    @State private var columnCount = 2

    var body: some View {
        LazyVGrid(columns: Array(repeating: GridItem(.flexible()), count: columnCount)) {
            ForEach(items) { item in
                ItemView(item: item)
            }
        }
        .onGeometryChange(for: Int.self) { proxy in
            max(1, Int(proxy.size.width / 150))
        } action: { newCount in
            columnCount = newCount
        }
    }
}

アスペクト比検出(iPadの「向き」)の場合:

struct WindowShapeReader: View {
    @State private var isWide = true

    var body: some View {
        content
            .onGeometryChange(for: Bool.self) { proxy in
                proxy.size.width > proxy.size.height * 1.2
            } action: { newValue in
                isWide = newValue
            }
    }
}

パターン 4: GeometryReader(必要な場合)

使用タイミング: ジオメトリが必要で、かつiOS 15以前を使用している場合、またはレイアウトフェーズ中にジオメトリが必要な場合(副作用としてだけでなく)。

// ✅ 正しい: 制約付きGeometryReader
VStack {
    GeometryReader { geo in
        Text("幅: \(geo.size.width)")
    }
    .frame(height: 44)  // 必ず制約を付ける!

    Button("次へ") { }
}

// ❌ 間違い: 制約なし(貪欲)
VStack {
    GeometryReader { geo in
        Text("幅: \(geo.size.width)")
    }
    // すべての利用可能なスペースを取り、兄弟要素を押しつぶす
    Button("次へ") { }
}

サイズクラス Truth Table(iPad)

設定水平垂直
全画面ポートレート.regular.regular
全画面ランドスケープ.regular.regular
70% 分割ビュー.regular.regular
50% 分割ビュー.regular.regular
33% 分割ビュー.compact.regular
スライドオーバー.compact.regular
キーボード表示時(変更なし)(変更なし)

重要な洞察: サイズクラスがiPadで.compactになるのは、幅が約33%またはスライドオーバーの場合のみです。より細かい制御が必要な場合は、ジオメトリを使用してください。


iOS 26 自由形式ウィンドウ

変更点

iOS 26以前iOS 26+
固定分割ビューサイズ自由形式のドラッグリサイズ
UIRequiresFullScreen 許可非推奨
iPadにメニューバーなし.commands によるメニューバー
手動の列表示NavigationSplitView 自動適応

Appleのガイドライン

「アプリのリサイズは、そのレイアウトを恒久的に変更すべきではありません。可能な限り、開始状態に戻ることを常に考慮してください。」

解釈: ウィンドウサイズに基づいてレイアウト状態を保存しないでください。ウィンドウが元のサイズに戻ったとき、レイアウトも元に戻るべきです。

NavigationSplitView 自動適応

// iOS 26: 列が自動的に表示/非表示
NavigationSplitView {
    Sidebar()
} content: {
    ContentList()
} detail: {
    DetailView()
}
// 手動の columnVisibility 管理は不要

移行チェックリスト

  • Info.plistから UIRequiresFullScreen を削除
  • 任意のウィンドウサイズでテスト(33/50/66%だけでなく)
  • リサイズ後にレイアウトが「固着」しないことを確認
  • 一般的なアクションにメニューバーコマンドを追加
  • ウィンドウコントロールがツールバーアイテムと重ならないことをテスト

アンチパターン

❌ デバイス向きオブザーバー

// ❌ 間違い: デバイスを報告するが、ウィンドウは報告しない
NotificationCenter.default.addObserver(
    forName: UIDevice.orientationDidChangeNotification, ...
)

let orientation = UIDevice.current.orientation
if orientation.isLandscape { ... }

なぜ失敗するか: 物理的なデバイスの向きを報告し、ウィンドウの形状は報告しません。分割ビュー、ステージマネージャ、iOS 26で誤動作します。

修正: onGeometryChange を使用して実際のウィンドウ寸法を読み取ります。

❌ スクリーンバウンド

// ❌ 間違い: 自分のウィンドウではなく、フルスクリーンを返す
let width = UIScreen.main.bounds.width
if width > 700 { useWideLayout() }

なぜ失敗するか: マルチタスクでは、あなたのアプリは画面の40%しか持っていないかもしれません。

修正: ビューの実際のコンテナサイズを読み取ります。

❌ デバイスモデルチェック

// ❌ 間違い: 新しいデバイスで壊れ、マルチタスクで誤動作
if UIDevice.current.userInterfaceIdiom == .pad {
    useWideLayout()
}

なぜ失敗するか: 1/3分割ビューのiPadは、iPhone 14 Pro Maxのランドスケープよりも狭いです。

修正: デバイスの識別情報ではなく、利用可能なスペースに応答します。

❌ 制約なしGeometryReader

// ❌ 間違い: GeometryReaderは貪欲
VStack {
    GeometryReader { geo in
        Text("サイズ: \(geo.size)")
    }
    Button("次へ") { }  // 押しつぶされる
}

修正: .frame() で制約するか、onGeometryChange を使用します。

❌ 向きプロキシとしてのサイズクラス

// ❌ 間違い: iPadは両方の向きで .regular
var isLandscape: Bool {
    horizontalSizeClass == .regular  // iPadでは常にtrue!
}

修正: アスペクト比が必要な場合は、実際のジオメトリから計算します。


プレッシャーシナリオ

「デザイナーがiPhone固有のレイアウトを要求」

誘惑: if UIDevice.current.userInterfaceIdiom == .phone

対応: 「これらを'コンパクト'と'レギュラー'のレイアウトとして実装し、利用可能なスペースに基づいて切り替えます。iPhoneのレイアウトは、ウィンドウが狭いときにiPadに表示されます。これにより、ステージマネージャとiOS 26に将来対応できます。」

「GeometryReaderを使えばいい、大丈夫だ」

誘惑: すべてをGeometryReaderでラップする。

対応: 「GeometryReaderには既知のレイアウト副作用があります。貪欲に拡張されます。onGeometryChange は同じデータをレイアウトに影響を与えずに読み取ります。iOS 16にバックポートされています。」

「サイズクラスは以前は機能していた」

誘惑: すべてをサイズクラスに強制する。

対応: 「サイズクラスは粗いです。iPadは両方の向きで.regularです。広いカテゴリにはサイズクラスを、正確なしきい値にはジオメトリを使用します。」

「iPadのマルチタスクはサポートしていない」

誘惑: UIRequiresFullScreen = true

対応: 「AppleはiOS 26でフルスクリーンのみを非推奨にしました。アクティブな分割ビューのサポートがなくても、アプリはリサイズ時に壊れてはいけません。スペースベースのレイアウトは同じコストです。」


リソース

WWDC: 2025-208, 2024-10074, 2022-10056

スキル: axiom-swiftui-layout-ref, axiom-swiftui-debugging, axiom-liquid-glass

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

関連スキル