ページビューの合計

2026年10月9日金曜日

iOSアプリの開発(100 Days of SwiftUI) Day 16 – Project 1, part one

100 Days of SwiftUIのDay16です。

Swift言語の基本をマスターした今、最初のプロジェクトで実際のコードにスキルを応用してみましょう。

このプロジェクトは、人数とチップの額に基づいて割り勘を計算するアプリです。プロジェクト自体は複雑ではありませんが、これらの基本がどのように組み合わさるのかをじっくりと理解していただけるよう、時間をかけて進めていきます。

このように基本に立ち返ることは、ある意味で奇妙に感じるかもしれません。
クロージャ、オプショナル、例外処理関数について学んだ後、SwiftUIの基本を見ていくことで、少しリセットされたような感覚になるからです。
しかし、希望を持ちましょう。新しいトピックに新鮮な気持ちで取り組めることは、非常に価値のあることです。
マイスター・エックハルトが言ったように、「毎朝、初心者の気持ちでいなさい」――そうすれば、はるかに速く学ぶことができるでしょう。

今日はプロジェクト概要の説明日です。
プロジェクトを構築するために理解しておくべき、個々のコードについて見ていきます。
明日は実装日となり、そこで学んだ新しい技術をアプリで実際に使ってみます。

今日は7つのトピックに取り組みます。フォーム、ナビゲーションスタック、@Stateなどについて学びます。

1. WeSplit: Introduction

このプロジェクトでは、レストランで食事をした後に使える割り勘アプリを開発します。
食事代を入力し、チップの金額と同行者の人数を選択すると、一人当たりの支払額が表示されます。
このプロジェクトは複雑なものを作ることを目的としているわけではありません。
その真の目的は、SwiftUIの基本を実用的な方法で教えるとともに、必要に応じてさらに発展させることができる実践的なプロジェクトを提供することです。
UIデザインの基本、ユーザーが値を入力したりオプションを選択したりする方法、そしてプログラムの状態を追跡する方法を学びます。
これが最初のプロジェクトなので、ゆっくりと進めながら、一つ一つ丁寧に説明していきます。
今後のプロジェクトでは徐々にスピードを上げていきますが、今はまだ焦らずじっくりと進めていきましょう。

このプロジェクトは、完全なアプリを構築するすべてのプロジェクトと同様に、3つの段階に分かれています。

  1. これから学ぶすべてのテクニックを実践的に紹介します。
  2. プロジェクトを構築するためのステップバイステップガイド。
  3. プロジェクトをさらに発展させるために、あなた自身で取り組むべき課題です。
どれも重要なので、どれも飛ばさずにじっくりと取り組んでください。

最初のステップでは、新しいコンポーネントをそれぞれ個別に解説し、それぞれの動作原理を理解していただきます。
コードはたくさんありますが、説明も併せて行うので、各コンポーネントが単体でどのように動作するのかを理解できるでしょう。
このステップは概要説明です。これから使用するコンポーネント、その動作原理、そして使用方法について説明します。

第2段階では、これらの概念を実際のプロジェクトに適用していきます。
ここでは、物事が実際にどのように機能するかを目にするだけでなく、より深い背景情報も得られます。
つまり、なぜそれらを使用したいのか、そして他のコンポーネントとどのように連携するのかといった点です。

最終段階では、学習内容を要約し、理解度を確認するための簡単なテストを実施します。
さらに、学習したスキルを応用できるかどうかを確認するため、3つの課題(全く新しいタスク)を自力で完了していただきます。
これらの課題には解答を提供しません(解答を求めるメールは送らないでください!)。
これは、解答例に従うのではなく、あなたの理解度を試すためのものです。

さて、おしゃべりはこれくらいにして、最初のプロジェクトに取り掛かりましょう。
小切手共有アプリを構築するために必要な技術を学び、それを実際のプロジェクトで活用していきます。

それでは、Xcodeを起動して、「新しいXcodeプロジェクトを作成」を選択してください。
オプションの一覧が表示されるので、「iOSとApp」を選択し、「次へ」を押してください。
次の画面で、以下の操作を行ってください。
  • 製品名には「WeSplit」と入力してください。
  • 組織識別子には任意の文字列を入力できますが、ウェブサイトをお持ちの場合は、各要素を逆にして入力してください。「hackingwithswift.com」の場合は「com.hackingwithswift」となります。ドメインをお持ちでない場合は、任意のドメイン名を作成してください。「me.yourlastname.yourfirstname」で問題ありません。
  • インターフェースにはSwiftUIを選択してください。
  • 言語設定では、必ずSwiftが選択されていることを確認してください。
  • ストレージについては「なし」を選択してください。
  • 下部にあるすべてのチェックボックスがオフになっていることを確認してください。

こんな感じですね。
組織識別子はデフォルトのcom.exampleのままにしました。


組織識別子についてご興味をお持ちの場合は、すぐ下の「バンドル識別子」をご覧ください。Appleはすべてのアプリを一意に識別できるようにする必要があるため、組織識別子(ウェブサイトのドメイン名を逆にしたもの)とプロジェクト名を組み合わせています。
例えば、Appleの組織識別子が「com.apple」の場合、AppleのKeynoteアプリのバンドル識別子は「com.apple.keynote」となる可能性があります。

準備ができたら「次へ」をクリックし、プロジェクトの保存場所を選択して「作成」をクリックします。Xcodeが1~2秒ほど処理した後、プロジェクトが作成され、編集可能なコードが開きます。

後々、このプロジェクトを使って小切手分割アプリを開発する予定ですが、今のところは、コードを試せるサンドボックスとして使用します。

では、始めましょう!

2. Understanding the basic structure of a SwiftUI app

新しいSwiftUIアプリを作成すると、いくつかのファイルと、おそらく合計20行程度のコードが生成されます。
Xcode内では、左側のプロジェクトナビゲーターと呼ばれる領域に、以下のファイルが表示されます。

  • WeSplitApp.swiftには、アプリを起動するためのコードが含まれています。アプリの起動時に何かを作成し、それを起動中ずっと維持したい場合は、ここに記述します。
  • ContentView.swiftには、プログラムの初期ユーザーインターフェース(UI)が含まれており、このプロジェクトにおけるすべての作業はこのファイルで行います。
  • Assets.xcassetsはアセットカタログです。アプリで使用したい画像のコレクションです。ここには、色、アプリのアイコン、iMessageステッカーなども追加できます。
  • プレビューコンテンツはグループであり、その中にプレビューアセット.xcassetsが含まれています。これは別のアセットカタログで、今回はユーザーインターフェースを設計する際に使用したいサンプル画像専用です。プログラムの実行時にどのように表示されるかを把握するのに役立ちます。
ヒント:Xcodeの設定によっては、プロジェクトナビゲーターにファイル拡張子が表示される場合と表示されない場合があります。
これは、Xcodeの環境設定を開き、「一般」タブを選択して、「ファイル拡張子」オプションを調整することで制御できます。

このプロジェクトに関する作業はすべて ContentView.swift で行います。
このファイルは Xcode によって既に開かれています。ファイルの先頭にはコメント(先頭にスラッシュが2つ付いている部分)がありますが、Swift では無視されるため、コードの動作に関する説明を追加するために使用できます。コメントの下には、おそらく 15 行程度のコードがあります。

import SwiftUI

struct ContentView: View {
    var body: some View {
        VStack {
            Image(systemName: "globe")
                .imageScale(.large)
                .foregroundStyle(.tint)
            Text("Hello, world!")
        }
        .padding()
    }
}

#Preview {
    ContentView()
}

独自のコードを書き始める前に、それらが何をするのかを改めて確認しておく価値があります。なぜなら、いくつか新しいことが登場するからです。

まず、`import SwiftUI` は、SwiftUI フレームワークが提供するすべての機能を使用したいことを Swift に伝えます。
Apple は、機械学習、オーディオ再生、画像処理など、さまざまな用途に対応するフレームワークを多数提供しているので、プログラムがそれらすべてを使用するのではなく、使用したい部分を明示的に指定して読み込むようにします。

次に、struct ContentView: View は ContentView という新しい構造体を作成し、View プロトコルに準拠していることを示します。View は SwiftUI から来ており、画面上に描画したいものすべて (テキスト、ボタン、画像などすべて、および他のビューを組み合わせた独自のレイアウトを含む) が採用しなければならない基本プロトコルです。

3つ目に、`var body: some View` は、`body` という新しい計算プロパティを定義します。このプロパティの型は `some View` です。これは、View プロトコルに準拠した値、つまりレイアウトを返すことを意味します。
実際には、レイアウト内のすべての要素に基づいて非常に複雑なデータ型が返されますが、`some View` のおかげで、そのことを気にする必要はありません。

Viewプロトコルには、Viewを返すbodyという名前の計算プロパティが存在することという、たった1つの要件しかありません。ビュー構造体には、さらに多くのプロパティやメソッドを追加できます(そして実際に追加されるでしょう)が、bodyは必須の要素です。

第四に、VStackとその中のコードには、地球儀の画像の下に「Hello, world!」というテキストが表示されます。
この地球儀の画像はAppleのSF Symbolsアイコンセットのもので、iOSには何千ものアイコンが組み込まれています。
テキストビューは、画面に描画されるシンプルな静的テキストで、必要に応じて自動的に複数行に折り返されます。

5つ目に、imageScale()、foregroundStyle()、padding()は、画像とVStackに対して呼び出されるメソッドです。
これらはSwiftUIでモディファイアと呼ばれるもので、通常のメソッドと少し異なる点があります。
それは、元のデータに加えて、要求した追加の変更を加えた新しいビューを常に返すことです。この場合、地球儀の画像はより大きく青色で表示され、bodyプロパティは、通常のテキストビューではなく、パディングされたテキストビューを返します。

ContentView構造体の下には、ContentView()を含む#Previewが表示されています。
これは、App Storeに公開する最終アプリには実際には含まれない特別なコードで、XcodeがUIデザインのプレビューをコードと並べて表示するために使用するものです。

これらのプレビューは、Xcodeの「キャンバス」と呼ばれる機能を使用します。キャンバスは通常、コードのすぐ右側に表示されます。必要に応じてプレビューコードをカスタマイズできますが、変更はキャンバス上でのレイアウトの表示方法のみに影響し、実際に実行されるアプリには影響しません。

キャンバスは、iPhone 15 ProやiPadなど、特定のAppleデバイスを使用して自動的にプレビューされます。これを変更するには、Xcodeウィンドウの上部中央にある現在のデバイスを確認し、それをクリックして別のデバイスを選択してください。
この変更は、後で仮想iOSシミュレーターでコードを実行する方法にも影響します。

重要:Xcodeウィンドウにキャンバスが表示されない場合は、エディターメニューから「キャンバス」を選択してください

コードのエラーによってXcodeのキャンバスが更新されなくなることはよくあります。
「プレビューが一時停止しました」といったメッセージが表示され、更新ボタンを押すと解決します。
このような操作を頻繁に行うことになるので、便利なショートカットキーをご紹介します。Option+Cmd+Pを押すと、更新ボタンをクリックするのと同じ動作になります。

3. Creating a form

多くのアプリでは、ユーザーに何らかの入力を求めます。
例えば、設定の変更を求められたり、車の迎え場所の確認を求められたり、メニューから食べ物を注文させられたり、その他同様のことが起こります。

SwiftUIでは、この目的のために専用のビュータイプである「フォーム」が用意されています。
フォームは、テキストや画像などの静的なコントロールをスクロール表示するリストですが、テキストフィールド、トグルスイッチ、ボタンなど、ユーザーが操作できるコントロールを含めることもできます。

テキストビューをフォームで囲む​​だけで、基本的なフォームを作成できます。

var body: some View {
    Form {
        Text("Hello, world!")
    }
}

Xcodeのキャンバスを使用している場合、画面が劇的に変化するのがわかります。以前は「Hello World」が白い画面の中央に表示されていましたが、今は画面が薄い灰色になり、「Hello World」が左上に白で表示されます。

ここに表示されているのは、設定アプリで表示されるようなデータリストの初期段階です。データには「Hello World」というテキストが1行だけありますが、自由にテキストを追加して、すぐにフォームに表示させることができます。

Form {
    Text("Hello, world!")
    Text("Hello, world!")
    Text("Hello, world!")
}

実際、フォーム内にはいくつでも要素を配置できます。例えば、このコードは10行のテキストを問題なく表示します

Form {
    Text("Hello, world!")
    Text("Hello, world!")
    Text("Hello, world!")
    Text("Hello, world!")
    Text("Hello, world!")
    Text("Hello, world!")
    Text("Hello, world!")
    Text("Hello, world!")
    Text("Hello, world!")
    Text("Hello, world!")
}

設定アプリのようにフォームを視覚的に分割したい場合は、次のようにセクションを使用できます。

Form {
    Section {
        Text("Hello, world!")
    }

    Section {
        Text("Hello, world!")
        Text("Hello, world!")
    }
}

フォームをセクションに分割するタイミングに厳密なルールはありません。
単に、関連する項目を視覚的にグループ化するためのものです。

4. Adding a navigation bar

iOSでは、要求すれば画面上のどこにでもコンテンツを配置できます。
画面上部のシステムクロックの下や画面下部のホームインジケーターの下にも配置できます。しかし、これは見た目が良くないため、SwiftUIはデフォルトで、コンポーネントがシステムUIやデバイスの角丸によって隠れない領域(セーフエリアと呼ばれる領域)に配置されるようにしています。

iPhone 15では、セーフエリアはダイナミックアイランドのすぐ下からホームインジケーターのすぐ上までの領域に広がります。以下のようなユーザーインターフェースで実際に確認できます。

struct ContentView: View {
    var body: some View {
        Form {
            Section {
                Text("Hello, world!")
            }
        }
    }
}

iOSシミュレーターで実行してみてください。
Xcodeウィンドウの左上にある再生ボタンを押すか、Cmd+Rを押してください。

ご覧のとおり、フォームは動的なアイランドの下から始まるため、デフォルトではフォームの行全体が表示されます。
しかし、フォームはスクロールすることもできるため、シミュレーターでスワイプすると、行を上に移動させて時計の下に隠すことができ、両方とも読みにくくなります。

この問題を解決する一般的な方法は、画面上部にナビゲーションバーを配置することです。
ナビゲーションバーにはタイトルやボタンを設定でき、SwiftUIではユーザーが何らかのアクションを実行した際に新しいビューを表示する機能も備えています。

ボタンや新しいビューについては後のプロジェクトで説明しますが、少なくともナビゲーションバーを追加してタイトルを付ける方法をお見せしたいと思います。
そうすることで、スクロール時のフォームの見栄えが良くなるからです。

テキストビューをSection要素で囲むことで、テキストビューをセクション内に配置できること、そして同様の方法でセクションをForm内に配置できることは既に説明しました。
ナビゲーションバーも全く同じ方法で追加できますが、ここではNavigationStackという名称を使用します。

var body: some View {
    NavigationStack {
        Form {
            Section {
                Text("Hello, world!")
            }
        }
    }
}

見た目は同じになりますが、通常はナビゲーションバーに何らかのタイトルを付けたいものです。そのためには、中に配置した要素に修飾子を付加します。
フォームのナビゲーションタイトルを設定するために、修飾子を追加してみましょう。

NavigationStack {
    Form {
        Section {
            Text("Hello, world!")
        }
    }
    .navigationTitle("SwiftUI")
}


フォームに .navigationTitle() 修飾子を付けると、Swift は実際にナビゲーション タイトルと、指定した既存のコンテンツすべてを含む新しいフォームを作成します。

ナビゲーションバーにタイトルを追加すると、そのタイトルに大きなフォントが使用されることに気づくでしょう。小さなフォントにするには、別の修飾子を追加します。

.navigationBarTitleDisplayMode(.inline)

Appleがこれらの大小のタイトルをどのように使い分けているかは、設定​​アプリで確認できます。最初の画面では「設定」と大きな文字で表示され、それ以降の画面ではタイトルが小さな文字で表示されます。

5. Modifying program state

SwiftUI開発者の間では「ビューは状態の関数である」という格言がありますが、これはほんの数語なので、最初は全く意味が分からないかもしれません。

格闘ゲームをプレイしていたとしたら、何度かライフを失ったり、ポイントを獲得したり、宝物を集めたり、強力な武器を手に入れたりしたかもしれません。
プログラミングでは、これらを「状態」と呼びます。
状態とは、ゲームが現在どのような状態にあるかを表す、アクティブな設定の集合のことです。

SwiftUIのビューは状態によって変化する、とは、ユーザーインターフェースの外観、つまりユーザーが見ることができるものや操作できるものが、プログラムの状態によって決まるという意味です。
例えば、ユーザーはテキストフィールドに名前を入力するまで、「続行」ボタンをタップすることはできません。

それでは、ボタンを使ってこれを実践してみましょう。SwiftUIでは、タイトル文字列と、ボタンがタップされたときに実行されるアクションクロージャを使ってボタンを作成できます。

struct ContentView: View {
    var tapCount = 0

    var body: some View {
        Button("Tap Count: \(tapCount)") {
            tapCount += 1
        }
    }
}

そのコードは十分に理にかなっているように見えます。
「タップ数」と表示されたボタンを作成し、そのボタンがタップされた回数を加算し、ボタンがタップされるたびに「タップ数」に1を加算する、というものです。

しかし、これではビルドできません。これは有効なSwiftコードではないからです。ContentViewは構造体であり、定数として作成されている可能性があります。
構造体について学んだことを思い出せば、これは不変であることを意味します。つまり、その値を自由に変更することはできません。

プロパティを変更したい構造体メソッドを作成する場合、mutating キーワードを追加する必要があります。
たとえば、mutating func doSomeWork() のように記述します。しかし、Swift では計算プロパティを mutating にすることはできません。
つまり、mutating var body: some View のように記述することはできません。

これは行き詰まりのように思えるかもしれません。プログラムの実行中に値を変更できるようにしたいのですが、ビューが構造体であるため、Swiftではそれができません。

幸いなことに、Swiftにはプロパティラッパーと呼ばれる特別な解決策があります。これはプロパティの前に配置できる特別な属性で、プロパティに強力な機能を与えます。
ボタンがタップされた回数など、単純なプログラムの状態を保存する場合、SwiftUIのプロパティラッパーである@Stateを次のように使用できます。

struct ContentView: View {
    @State var tapCount = 0

    var body: some View {
        Button("Tap Count: \(tapCount)") {
            self.tapCount += 1
        }
    }
}

その小さな変更だけでプログラムが動作するようになるので、これでビルドして試すことができます。
@State を使うことで、構造体の制限を回避できます。
構造体は固定されているためプロパティを変更できないことはわかっていますが、@State を使うことで、その値を SwiftUI が変更可能な場所に別々に保存できるようになります。

確かに、少しズルをしているように感じるかもしれませんし、自由に変更できるクラスを使わないのはなぜだろうと思うかもしれません。
しかし、信じてください、これは価値のある方法です。学習を進めるにつれて、SwiftUIが構造体を頻繁に破棄して再作成することを知るでしょう。
そのため、構造体を小さくシンプルに保つことはパフォーマンスにとって重要です。

ヒント:SwiftUIでプログラムの状態を保存する方法はいくつかあり、それらすべてを学習します。@Stateは、1つのビューに格納されるシンプルなプロパティ向けに特別に設計されています。
そのため、Apple は、次のようにこれらのプロパティにプライベート アクセス制御を追加することを推奨しています: @State private var tapCount = 0.

追記

なんか話がいきなり飛びましたね。
まず整理すると、
ContentViewは構造体で、プロトコル:Viewに準拠します。
Viewに準拠するには、bodyという計算プロパティを実装します。

クラスではなくて構造体を使っているのは軽量化のためです。
またクラスだとインスタンスが複数あるとあちこちからプロパティを書き換えることができてバグの温床になるためです。

画面(View)は、状態(State)の関数である。
画面の状態(データ)が変わると、SwiftUI システムは古い View の一部を書き換えるのではなく、破棄してView 構造体そのものを再度インスタンス化します。
Viewは何度も再作成されます、そのためただの固定的な「設計図」であり、システム内では定数として扱われます。何度再作成されても軽量であるためパフォーマンスに影響がありません。

bodyが計算プロパティである理由
body の役割は「現在のデータに基づいて最新の View(設計図)を返して組み立てるだけ」です。
そのため、アクセスされるたびに最新状態が評価される計算プロパティになっています。
また、この body処理の中で自身(View構造体)のプロパティを書き換えることはできません。
それはSwiftUI 側が Viewプロトコルの定義として var body: some View { get } (読み取り専用・非 mutating)と定めているためです。
またView構造体はシステムによって定数(let)として扱われるため、自身の状態を変更するような処理(mutating)が禁止されているからです。

ここまで来ると、さっきのボタンを押すたびに数値がカウントアップするような実装ができないことになります。
それを解決するのがプロパティラッパーです。
SwiftUIが提供するプロパティラッパーの@Stateは、値の保持を構造体の外(SwiftUI が管理する特殊な領域)に追い出すことができます。

再描画時に View が再作成された際、システムは@State指定で外側に退避しておいた最新のデータを自動的に読み込んでView に注入します。

このため、View(構造体)自体は何度も作っては捨てられても、ユーザーから見ると「データが保持されたまま画面が更新されている」状態が作れます。

6. Binding state to user interface controls

SwiftUIの@Stateプロパティラッパーを使用すると、ビュー構造を自由に変更できます。つまり、プログラムが変更されると、それに合わせてビューのプロパティを更新できます。

しかし、ユーザーインターフェースのコントロールに関しては、もう少し複雑になります。たとえば、ユーザーが入力できる編集可能なテキストボックスを作成したい場合は、次のようなSwiftUIビューを作成するかもしれません。

struct ContentView: View {
    var body: some View {
        Form {
            TextField("Enter your name")
            Text("Hello, world!")
        }
    }
}

これは、テキストフィールドとテキストビューを含むフォームを作成しようとするものです。
しかし、SwiftUIはテキストフィールド内のテキストをどこに保存するかを知る必要があるため、このコードはコンパイルされません。

ビューは状態に依存する関数であることを覚えておいてください。
つまり、テキストフィールドは、プログラムに保存されている値を反映している場合にのみ何かを表示できます。
SwiftUIが必要としているのは、テキストフィールド内に表示でき、ユーザーがテキストフィールドに入力した内容も保存できる、構造体内の文字列プロパティです。

そこで、コードを次のように変更できます。

struct ContentView: View {
    var name = ""

    var body: some View {
        Form {
            TextField("Enter your name", text: name)
            Text("Hello, world!")
        }
    }
}

これは、name プロパティを追加し、それを使用してテキストフィールドを作成します。しかし、Swift はユーザーがテキスト フィールドに入力した内容に合わせて name プロパティを更新する必要があるため、このコードでは動作しません。そのため、次のように @State を使用することをお勧めします。

@State private var name = ""

しかし、それだけでは不十分で、私たちのコードはまだコンパイルできません。

問題は、Swiftが「このプロパティの値をここに表示する」と「このプロパティの値をここに表示するが、変更があればプロパティに書き戻す」を区別している点です。

テキストフィールドの場合、Swiftはテキストの内容がnameプロパティにも含まれていることを確認する必要があります。そうすることで、ビューは状態の関数であるという約束、つまりユーザーが見ることができるものはすべてコード内の構造体とプロパティの視覚的な表現であるという約束を果たすことができるのです。

これは双方向バインディングと呼ばれるものです。テキストフィールドにプロパティの値が表示されるようにバインドするだけでなく、テキストフィールドへの変更がプロパティも更新されるようにバインドします。

Swiftでは、このような双方向バインディングを区別するために特別な記号を使用します。具体的には、その前にドル記号($)を付けます。これにより、Swiftはプロパティの値を読み取るだけでなく、変更があった場合にはその値を書き戻すように指示されます。

したがって、正しい構造体のバージョンは次のとおりです。

struct ContentView: View {
    @State private var name = ""

    var body: some View {
        Form {
            TextField("Enter your name", text: $name)
            Text("Hello, world!")
        }
    }
}

今すぐそのコードを実行してみてください。期待どおり、テキストフィールドをタップして名前を入力できるはずです。

先に進む前に、テキストビューを変更して、ユーザーの名前がテキストフィールドのすぐ下に表示されるようにしましょう。

Text("Your name is \(name)")

$nameではなくnameを使用していることに注目してください。
これは、ここでは双方向バインディングを必要としないためです。
値を読み取ることは必要ですが、テキストビューは変更されないため、何らかの方法で書き戻す必要はありません。
したがって、プロパティ名の前にドル記号が付いている場合は、双方向のバインディングが作成されることを覚えておいてください。
つまり、プロパティの値は読み取られるだけでなく、書き込まれるのです。

まとめ

初回時
1. nameプロパティは""です。
2. テキストフィールドは””を表示します。プレースホルダーとして"Enter your name"を表示します。
→nameプロパティの内容をテキストフィールドに反映します。

テキストフィールドに値を入力
1. テキストフィールドをクリックして文字を入力します。
2. 入力した内容がViewの外で保存領域(@State privete var nameの実態)へ反映されます。
→テキストフィールドの値をnameプロパティに反映します。(間接的)
3. システムがデータが変更になったことを検知して、Viewを再作成します。
4. Viewの外の保存領域から値をnameプロパティへ読み込みます。
5. nameプロパティの値をテキストフィールドに反映します

7. Creating views in a loop

ループ内で複数のSwiftUIビューを作成したい場合がよくあります。
例えば、名前の配列をループ処理して、それぞれをテキストビューにしたり、メニュー項目の配列をループ処理して、それぞれを画像として表示したりしたい場合などです。

SwiftUIには、この目的のために専用のビュータイプであるForEachが用意されています。これは配列や範囲をループ処理し、必要な数のビューを作成できます。

ForEach は、ループする項目ごとにクロージャを一度実行し、現在のループ項目を渡します。たとえば、0 から 100 までループする場合、0、1、2、…というように渡されます。
例えば、これは100行のフォームを作成します。

Form {
    ForEach(0..<100) { number in
        Text("Row \(number)")
    }
}

ForEachはクロージャを渡すため、パラメータ名には次のような省略形構文を使用できます。

Form {
    ForEach(0 ..< 100) {
        Text("Row \($0)")
    }
}

ForEachは、SwiftUIのPickerビューを扱う際に特に便利です。Pickerビューでは、ユーザーが選択できるさまざまなオプションを表示できます。

これを実証するために、次のようなビューを定義します。

  1. 生徒の名前には様々な候補があります。
  2. 現在選択されている学生を格納する@Stateプロパティを持っています。
  3. @State プロパティへの双方向バインディングを使用して、ユーザーにお気に入りのものを選択するよう求める Picker ビューを作成します。
  4. ForEachを使用して考えられるすべての学生名をループ処理し、テキストビューに変換します。

struct ContentView: View {
    let students = ["Harry", "Hermione", "Ron"]
    @State private var selectedStudent = "Harry"

    var body: some View {
        NavigationStack {
            Form {
                Picker("Select your student", selection: $selectedStudent) {
                    ForEach(students, id: \.self) {
                        Text($0)
                    }
                }
            }
        }
    }
}

コードはそれほど多くありませんが、いくつか明確にしておくべき点があります。

  1. 学生配列は定数なので、@Stateでマークする必要はありません。変更されることはありません。
  2. selectedStudentプロパティは「Harry」という値から始まりますが、変更される可能性があるため、@State でマークされています。
  3. Pickerには「生徒を選択してください」というラベルが付いており、その機能についてユーザーに説明するとともに、スクリーンリーダーが読み上げるための説明文も提供しています。
  4. PickerはselectedStudentと双方向バインディングを行っているため、最初は「Harry」が選択されている状態から開始されますが、ユーザーが別の項目を選択するとプロパティが更新されます。
  5. ForEachループの中では、すべての生徒を順番に処理します。
  6. 各生徒ごとに、その生徒の名前を表示するテキストビューを1つ作成します。


唯一分かりにくいのは、ForEach(students, id: \.self) の部分です。これはstudents配列をループ処理して各studentsのテキストビューを作成するものですが、id: \.self の部分が重要です。これは、SwiftUIが画面上のすべてのビューを一意に識別できるようにすることで、変更を検出できるようにするためです。

例えば、配列を並べ替えて「Ron」を先頭にすると、SwiftUI は同時にテキストビューを移動します。そのため、文字列配列内の各項目を一意に識別する方法、つまり各文字列のどのような特徴が一意性を保つのかを SwiftUI に伝える必要があります。

構造体の配列であれば、「この構造体には常に一意なタイトル文字列がある」とか、「この構造体には常に一意なID整数がある」などと言うかもしれません。しかし、ここでは単純な文字列の配列しかなく、文字列の一意性は文字列自体にしかありません。配列内の各文字列は異なるため、文字列は自然に一意になります。

つまり、ForEach を使用して多数のビューを作成する際に、SwiftUI が文字列配列内の各項目を一意にする識別子を尋ねてきた場合、答えは \.self となります。
これは「文字列自体が一意である」という意味です。もちろん、students配列に重複する文字列を追加すると問題が発生する可能性がありますが、ここでは問題ありません。

いずれにせよ、今後はForEachの他の使い方についても見ていく予定ですが、今回のプロジェクトについてはこれで十分でしょう。

これでプロジェクトの概要説明は最終回です。
いよいよ実際のコードに取り掛かりましょう。作成したサンプルコードを保存したい場合は、プロジェクトディレクトリを別の場所にコピーしてください。

準備ができたら、ContentView.swift を以下のコードに戻して、まっさらな状態から作業を開始できるようにしてください。

import SwiftUI

struct ContentView: View {
    var body: some View {
        Text("Hello, world!")
    }
}

#Preview {
    ContentView()
}


0 件のコメント:

コメントを投稿

iOSアプリの開発(100 Days of SwiftUI) Day 26 – Project 4, part one

100 Days of SwiftUIの Day26 です。 今日から新しいプロジェクトを始めます。SwiftUIのスキルをさらに磨きながら、プログラミングの魅力的な分野である機械学習にも挑戦していきます。 オックスフォード大学で教鞭を執るスウェーデン人教授、ニック・ボストロムは...