ページビューの合計

2026年10月13日火曜日

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

100 Days of SwiftUIのDay17です。

イマヌエル・カントが言ったように、「理論なき経験は盲目だが、経験なき理論は単なる知的遊戯に過ぎない」。
昨日はこのアプリを構築するために必要な技術のほとんどすべてを網羅したので、今度はその知識を実際の、実用的なアプリへと具現化する時が来ました。

SwiftUIの好きな点のひとつは、理論から実践への移行が非常に容易なことです。
予期せぬ問題が潜んでいることもなく、途中で新たに学ぶべき壮大な事柄もありません。

もちろん、気を引き締めてもらうために、いくつか小さなヒントをこっそり忍ばせておくつもりですが、基本的にはこのプロジェクトを構築するために必要なことはすべて既にご存知でしょうから、あとはそれらがどのように組み合わさるかを確認するだけです。

今日は4つのトピックに取り組みます。
これらのトピックでは、フォーム、@State、ピッカーなどに関する知識を応用します。

1. Reading text from the user with TextField

私たちは割り勘アプリを開発しています。
つまり、ユーザーが自分の会計金額、割り勘する人数、そしてチップの金額を入力できるようにする必要があるということです。

既にお分かりいただけたと思いますが、これはつまり、ユーザーがアプリに入力することを想定しているデータが3つあるため、@Stateプロパティを3つ追加する必要があるということです。

それでは、まずContentView構造体に以下の3つのプロパティを追加しましょう。

@State private var checkAmount = 0.0
@State private var numberOfPeople = 2
@State private var tipPercentage = 20

ご覧のとおり、これにより、会計金額のデフォルト値は0.0、人数のデフォルト値は2、チップの割合のデフォルト値は20となります。
これらのプロパティにはそれぞれ妥当なデフォルト値が設定されています。
会計金額がいくらになるかはわかりませんが、2人という人数と20%のチップという前提は、アプリにとって適切な出発点と言えるでしょう。

もちろん、チップの割合を人によって変えたい場合もあるので、あらかじめ用意したチップ額の配列から選択できるようにします。
可能なチップ額のリストをどこかに保存する必要があるので、前の3つのプロパティの下に次の4つ目のプロパティを追加してください。

let tipPercentages = [10, 15, 20, 25, 0]

これからフォームを段階的に作成していきます。
まずは、ユーザーが小切手の金額を入力できるテキストフィールドから始めます。
皆さんが既に知っていることから始めますが、ご覧のとおり、それではうまく動作しません。
bodyプロパティを以下のように変更してください。

Form {
    Section {
        TextField("Amount", text: $checkAmount)
    }
}

これはうまくいきませんし、それで構いません。
問題は、SwiftUIではTextFieldはテキスト(つまり文字列)を入力するために使われることを想定している点です。
ここでそれを許可することもできますが、そうするとユーザーがどんな種類のテキストでも入力できてしまい、その文字列を扱いやすい数値に慎重に変換する必要が出てきます。

追記
Xcodeでは、Cannot convert value of type 'Binding<Double>' to expected argument type 'Binding<String>'
と表示します。
上記のようにTextFieldは「文字列」を入力するために使うけど、checkAmountは「Double」であるためです。

幸いなことに、もっと良い方法があります。Double型の値をTextFieldに渡して、入力値を通貨として扱うように指示することができます。
例えば、次のように記述します。

TextField("Amount", value: $checkAmount, format: .currency(code: "USD"))

これは改善ではありますが、さらに良くすることができます。
つまり、これはSwiftUIに対して通貨を米ドル(略してUSD)としてフォーマットするように指示しているのですが、世界の人口の95%以上が米ドルを通貨として使用していないことを考えると、彼らに「USD」を強制すべきではないでしょう。

より良い解決策は、iOSに現在のユーザーの通貨コード(存在する場合)を問い合わせることです。
これはUSD(米ドル)かもしれませんが、CAD(カナダドル)、AUD(オーストラリアドル)、JPY(日本円)などである可能性もあります。
また、ユーザーが通貨を設定していない場合は、現時点では値が存在しない可能性もあります。
したがって、より良い形式は次のとおりです。

.currency(code: Locale.current.currency?.identifier ?? "USD"))

LocaleはiOSに組み込まれた巨大な構造体で、ユーザーの地域設定(使用するカレンダー、数字の千の位の区切り方、メートル法の使用の有無など)をすべて保存する役割を担っています。
今回のケースでは、ユーザーに希望する通貨コードがあるかどうかを尋ね、ない場合は「USD」にフォールバックすることで、少なくとも何らかの通貨コードが利用できるようにします。

これまでのコードでは、1つのセクションからなるスクロール可能な入力フォームを作成しています。
このセクションには、テキストフィールドという1行が含まれています。
フォームにテキストフィールドを作成する際、最初のパラメータはプレースホルダーとして使用される文字列です。
プレースホルダーとは、テキストフィールド内に表示される灰色のテキストで、ユーザーに入力すべき内容の概要を示すものです。
2番目のパラメータは、checkAmountプロパティへの双方向バインディングです。つまり、ユーザーが入力すると、そのプロパティが更新されます。
3番目のパラメータは、テキストの書式設定方法を制御し、それを通貨にするものです。

@State プロパティラッパーの優れた点の 1 つは、変更を自動的に監視し、何らかの変更が発生すると自動的にbody プロパティを再呼び出しすることです。
それはつまり、UIを再読み込みして変更された状態を反映させるということであり、SwiftUIの基本的な動作原理の一つです。
これを実証するために、checkAmount の値を表示するテキスト ビューを含む第 2 セクションを追加できます

Form {
    Section {
        TextField("Amount", value: $checkAmount, format: .currency(code: Locale.current.currency?.identifier ?? "USD"))
    }

    Section {
        Text(checkAmount, format: .currency(code: Locale.current.currency?.identifier ?? "USD"))
    }
}

これは、私たちの TextField とほぼ同じことを行います。
つまり、SwiftUI に対して数値を通貨としてフォーマットするように要求し、システムデフォルトまたは他に利用できない場合は USD を使用します。
このプロジェクトの後半では、パーセンテージを表示するために別の書式スタイルを使用します。これらのテキストフォーマッターは本当に便利です!

あとでそれに別のものを表示するようにしますが、ひとまずはご自身で試せるよう、シミュレーターでアプリを実行してみてください。

小切手金額入力欄をタップし、例えば50などの金額を入力してください。入力すると、2番目のセクションのテキスト表示に、入力内容が自動的かつ即座に反映されます。
この同期が発生する理由は以下のとおりです。

  1. テキストフィールドは、checkAmountプロパティと双方向バインディングされています。
  2. checkAmountプロパティには@State が付与されており、値の変更を自動的に監視します。
  3. @Stateプロパティが変更されると、SwiftUIはbodyプロパティを再呼び出しします(つまり、UIを再読み込みします)。
  4. したがって、テキストビューにはcheckAmountの更新された値が取得されます。
最終的なプロジェクトでは、そのテキストビューにcheckAmountは表示されませんが、今のところはこれで十分です。
先に進む前に、重要な問題点を一つ指摘しておきたいと思います。テキストフィールドに文字を入力するためにタップすると、ユーザーには通常のアルファベットキーボードが表示されます。
確かに、キーボードのボタンをタップすれば数字入力画面にアクセスできるが、それは面倒だし、実際には必要ありません。
幸いなことに、テキストフィールドには、別の種類のキーボードを強制的に使用できる修飾子があります、それが keyboardType() です。

使用するキーボードの種類を指定するパラメータを指定できます。
この場合、.numberPad または .decimalPad のどちらでも構いません。
どちらのキーボードも、ユーザーがタップできるように0から9までの数字を表示しますが、.decimalPadは小数点も表示するので、ユーザーは整数だけでなく、$32.50のような小切手金額を入力できます。
それでは、テキストフィールドを以下のように変更してください。

TextField("Amount", value: $checkAmount, format: .currency(code: Locale.current.currency?.identifier ?? "USD"))
    .keyboardType(.decimalPad)

.keyboardType の前に改行を追加し、TextField よりも一段階深くインデントしたことに気づくでしょう。
これは必須ではありませんが、どの修飾子がどのビューに適用されるかを把握するのに役立ちます。
さあ、今すぐアプリを実行してみてください。すると、テキストフィールドには数字しか入力できなくなっていることに気づくはずです。

追記
エミュレータ上では普通にmacOSの物理キーボードからアルファベットが入力できてしまいました。
エミュレータのメニューで以下の設定変更を行いました。

  • I/O→keyboard→Toggle Software Keyboardを選択します。
  • I/O→keyboard→Connect Hardware Keyboardを非選択にします。
これで数字(テンキー)のみの入力制限ができます。


ちなみに.keyboardType(.decimalPad)をコメントアウトすると、以下のような通常のアルファベットキーボードを表示します。
ようやく何がしたかったか分かりました。



ヒント:.numberPad と .decimalPad キーボードタイプは、SwiftUI に 0 から 9 までの数字と、必要に応じて小数点を表示するように指示しますが、ユーザーが他の値を入力できないわけではありません。
たとえば、ハードウェアキーボードを使用している場合は好きなように入力できますし、他の場所からテキストをコピーした場合は、そのテキストの内容に関係なく、テキストフィールドに貼り付けることができます。
ただし、これは問題ありません。テキストフィールドは、Return キーを押すと、不正な値を自動的にフィルタリングします。

2. Creating pickers in a form

SwiftUIのピッカーは複数の用途があり、その表示方法は使用しているデバイスやピッカーが使用される状況によって異なります。

私たちのプロジェクトでは、ユーザーに会計金額を入力してもらうフォームがありますが、そこに人数を選択して会計を分け合うことができる機能を追加したいと考えています。
ピッカーは、テキストフィールドと同様に、その値を追跡できるように、プロパティとの双方向バインディングが必要です。
既にこの目的のために@StateプロパティとしてnumberOfPeopleという名前を作成済みなので、次の作業は2から99までのすべての数字をループ処理し、ピッカー内に表示することです。
フォームの最初のセクションを次のように変更して、ピッカーを追加してください。

Section {
    TextField("Amount", value: $checkAmount, format: .currency(code: Locale.current.currency?.identifier ?? "USD"))
        .keyboardType(.decimalPad)

    Picker("Number of people", selection: $numberOfPeople) {
        ForEach(2..<100) {
            Text("\($0) people")
        }
    }
}

それでは、シミュレーターでプログラムを実行して試してみてください。何か気づくことはありますか?
うまくいけば、いくつか気づく点があるはずです。

  1. 左側に「人数」、右側に「4人」と書かれた新しい行が追加されました。
  2. 右端に2つの灰色の矢印が表示されていますが、これはiOSでは、その行をタップするとオプションメニューが表示されることを示す方法です。
  3. この行には「4人」と表示されていますが、numberOfPeopleプロパティにはデフォルト値として2を設定しました。

つまり、「二歩進んで二歩下がる」ようなもので、良い結果は得られたものの、うまく機能せず、正しい情報も表示されていないのです。

両方とも修正しましょう。まずは簡単な方から。numberOfPeopleにデフォルト値の2を設定したのに、なぜ4人と表示されるのでしょうか? 実は、ピッカーを作成する際に、次のようなForEachビューを使用していたのです。

ForEach(2 ..< 100) {

これは2から100まで数え、行を作成します。
つまり、最初に作成される0行目には「2人」が含まれているため、numberOfPeopleに2という値を指定した場合、実際には3行目である「4人」に設定されていることになります。

ですから、少し分かりにくいかもしれませんが、UIに「2人」ではなく「4人」と表示されるのはバグではありません。

追記
少しじゃなくて全くわからんw
ピッカーの仕様として上記のように書くとインデックスを渡されたと判断します。

data[0] : 2人
data[1] : 3人
data[2] : 4人←numberOfPeople=2はこのデータを指すと判断している。

ピッカーには、動作方法に応じてさまざまなスタイルが用意されています。たとえば、後ほどチップの割合を選択するピッカーにはセグメントスタイルを使用しますが、これは選択肢が少ないため適しています。

よく使われるピッカーのスタイルの1つにナビゲーションリンクと呼ばれるものがあり、これはユーザーがオプションを選択するために新しい画面に移動します。
ここで試すには、次のようにピッカーに .pickerStyle(.navigationLink) 修飾子を追加します。

Picker("Number of people", selection: $numberOfPeople) {
    ForEach(2 ..< 100) {
        Text("\($0) people")
    }
}
.pickerStyle(.navigationLink)

しかし、期待通りには動作しません。
今回は右端に灰色の表示インジケーターが表示されますが、行全体が灰色表示になり、タップしても何も表示されません。

SwiftUI がやりたいこと、つまり行の右端に灰色の開示インジケーターを追加した理由は、ピッカーのオプションを含む新しいビューを表示することです。
そのためには、ナビゲーションスタックを追加する必要があります。ナビゲーションスタックには2つの機能があります。
1つは、上部にタイトルを配置するためのスペースを確保すること、もう1つは、iOSが必要に応じて新しいビューをスライドインできるようにすることです。

したがって、フォームの直前に NavigationStack { を追加し、フォームの閉じ括弧の後にもう一つ閉じ括弧を追加してください。正しく行えば、コードは次のようになります。

var body: some View {
    NavigationStack {
        Form {
            // everything inside your form
        }
    }
}

アプリを再度起動すると、「人数」の行をタップすると、他のすべての選択肢が表示される新しい画面がスライドインして表示されることがわかります。

「4人」の横にチェックマークが付いているのは、それが選択された値だからです。しかし、別の数字をタップすることもできます。画面は自動的にスライドして消え、ユーザーは新しい選択内容が表示された前の画面に戻ります。

ここでご覧いただいているのは、宣言型ユーザーインターフェース設計と呼ばれるものの重要性です。
これは、どのように行うべきかを指示するのではなく、何が欲しいかを指示することを意味します。
私たちは、いくつかの値を含むナビゲーションリンクピッカーが欲しいと言いましたが、「すべてのアイテムのリストを作成し、現在選択されているアイテムにチェックマークを表示する」と指示する必要はありませんでした。

メニューピッカーとナビゲーションリンクピッカー、どちらがお好みですか?
これはあなたのアプリですから、お好きな方をお選びください!デフォルト設定のメニューピッカーを使用しますが、お好きな方をお選びください。

この手順を完了する前に、新しいナビゲーションバーにタイトルを追加しましょう。フォームに次の修飾子を付けてください。

.navigationTitle("WeSplit")

ヒント:修飾子を NavigationStack の末尾に付けるように考えがちですが、実際には Form の末尾に付ける必要があります。その理由は、ナビゲーションスタックはプログラムの実行中に多くのビューを表示できるため、ナビゲーションスタック内の要素にタイトルを付けることにより、iOS がタイトルを自由に変更できるようになるからです。

追記

.navigationLinkなしの場合


インラインで下にドロップダウンリストを表示します。


.navigationLinkありの場合
右端に >(開示インジケーター)がついた表示になります。


タップすると、別画面にスライドして選択肢を表示します。


選択肢が数個なら.navigationLinkなしで十分です。
しかし今回のように98個もの選択肢をドロップダウンで表示するのは不便なので
.navigationLinkを付けて、選択肢をスライドインさせるほうが使いやすいですね。

3. Adding a segmented control for tip percentages

次に、アプリに2つ目のピッカービューを追加しますが、今回は少し違ったもの、つまりセグメントコントロールを使用します。
これは、少数のオプションを水平方向にリスト表示する特殊なタイプのピッカーで、選択肢が少ない場合に非常に便利です。

フォームには既に2つのセクションがあります。1つは金額と人数を入力するセクション、もう1つは最終結果を表示するセクションです。現在はcheckAmountのみが表示されていますが、近いうちに修正する予定です。

その2つのセクションの間に、チップの割合を示す3つ目のセクションを追加してください。

Section {
    Picker("Tip percentage", selection: $tipPercentage) {
        ForEach(tipPercentages, id: \.self) {
            Text($0, format: .percent)
        }
    }
}

これは、tipPercentages配列内のすべてのオプションをループ処理し、それぞれを.percent形式のテキストビューに変換します。
前のピッカーと同様に、SwiftUIはそれをリストの1行に変換し、タップするとオプションのポップアップメニューを表示します。

しかしここでは、セグメントコントロールを使う方法をご紹介します。
セグメントコントロールの方が見た目がずっと良いからです。それでは、チップピッカーに次の修飾子を追加してください。

.pickerStyle(.segmented)

コードの変更は小さいですが、最終的な結果ははるかに良くなったと思います。テキストが、その直下にあるセグメントコントロールへのプロンプトのように見えるようになりました。

追記
セグメントコントロールにすると水平方向へボタンが並び、1つだけが選択できます。
まあラジオボタンですよね。


4. Calculating the total per person

これまでのところ、フォームの最後のセクションには、ユーザーが入力した小切手金額がシンプルなテキストビューで表示されていましたが、ここからがこのプロジェクトの重要な部分です。
各人が支払いにいくら負担する必要があるかを、そのテキストビューに表示させたいのです。

この問題を解決する方法はいくつかありますが、最も簡単な方法は最も簡潔な方法でもあります。つまり、明確で理解しやすいコードが得られるということです。
合計を計算する計算プロパティを追加します。

これには簡単な計算が必要です。一人当たりの支払総額は、注文金額にチップの割合を加えたものを人数で割った値になります。

しかし、その段階に到達する前に、まず人数、チップの割合、注文金額の値を取り出す必要があります。
それは簡単そうに聞こえるかもしれませんが、既にお分かりのように、numberOfPeople は 2 ずれています。つまり、3 という値が格納されている場合、それは 5 人を意味します。

そこで、totalPerPersonという新しい計算プロパティを作成します。
これは Double 型で、まず入力データの準備から始めます。つまり、正しい人数は誰か、そしてチップとしていくら渡したいのか、といったデータです。

まず、計算プロパティ自体を、bodyプロパティの直前に追加します。

var totalPerPerson: Double {
    // calculate the total per person here
    return 0
}

これは0を返すので、コードが壊れることはありません。
しかし、// calculate the total per person hereというコメントを、私たちの計算式に置き換えます。
次に、numberOfPeopleの値を読み取って2を加えることで、人数を把握できます。
この値は2から100までの範囲ですが、0から数え始めるため、2を加える必要があることを覚えておいてください。
それでは、まず // calculate the total per person here を次のものに置き換えてください。

let peopleCount = Double(numberOfPeople + 2)

同じ理由で、チップの割合をダブルに変換する必要があります。

let tipSelection = Double(tipPercentage)

これは非常に筋の悪い実装です。
numberOfPeopleにマジックナンバーの2を足して人数を求める。

そもそもは元の実装は以下のようになっています。
numberOfPeopleはデータのインデックスとして認識されるようです(解せない)
data[0] : 2人
data[1] : 3人
data[2] : 4人←初期値のnumberOfPeople=2はこのデータを指すと判断している。
なので正しいnumberOfPeopleを得るには、numberOfPeople + 2とかしないといけない。
Picker("Number of people", selection: $numberOfPeople) {
    ForEach(2 ..< 100) {
        Text("\($0) people")
    }
}

それを以下のように値自体をnumberOfPeopleに割り当てるようにすれば、わざわざ2を足すなんてことしなくても済みます。
今後はこのコードをベースで進めます。
Picker("Number of people", selection: $numberOfPeople) {
    ForEach(2 ..< 100, id: \.self) { number in
Text("\(number) people") } }

入力値が揃ったので、次は計算です。これにはさらに3つのステップが必要です。
  1. チップの金額は、checkAmountを100で割ってtipSelectionを掛けることで計算できます。
  2. チップの金額をcheckAmountに加算することで、合計金額を計算できます。
  3. 合計金額を人数で割ることで、一人当たりの金額を算出できます
それが終われば、一人当たりの金額を返して完了です。
プロパティ内の return 0 を次のものに置き換えてください。
let tipValue = checkAmount / 100 * tipSelection
let grandTotal = checkAmount + tipValue
let amountPerPerson = grandTotal / peopleCount

return amountPerPerson

すべて正しく実行していれば、コードは次のようになっているはずです。
var totalPerPerson: Double {
    let peopleCount = Double(numberOfPeople + 2)
    let tipSelection = Double(tipPercentage)

    let tipValue = checkAmount / 100 * tipSelection
    let grandTotal = checkAmount + tipValue
    let amountPerPerson = grandTotal / peopleCount

    return amountPerPerson
}

totalPerPerson が正しい値を返すようになったので、表の最後のセクションを変更して正しいテキストを表示させることができます。
Section {
    Text(checkAmount, format: .currency(code: Locale.current.currencyCode ?? "USD"))
}
を以下のように修正します。
Section {
    Text(totalPerPerson, format: .currency(code: Locale.current.currency?.identifier ?? "USD"))
}

今すぐアプリを実行して、感想を聞かせてください。合計値を構成するすべての値には@Stateが付与されているため、いずれかの値を変更すると、合計値が自動的に再計算されることがわかるはずです。

これで、SwiftUIのビューがその状態の関数であるという意味がお分かりいただけたかと思います。つまり、状態が変化すると、ビューもそれに合わせて自動的に更新されるということです。

5. Hiding the keyboard
プロジェクトもほぼ完了に近づいていますが、一つ気になる点にお気づきかもしれません。小切手金額を入力するためのキーボードが表示されると、それが消えなくなってしまうのです!

これは、小数点キーと数字キーパッドの問題です。
通常のアルファベットキーボードには、キーボードを閉じるためのリターンキーが付いているからです。しかし、少し工夫すればこの問題を解決できます。

  1. SwiftUIに、金額ボックスにフォーカスがあるべきかどうか、つまりユーザーからのテキスト入力を受け取るべきかどうかを判断する方法を与える必要があります。
  2. ユーザーがフォーカスを解除したいときに、それを解除するためのボタンを追加する必要があります。そうすることで、キーボードも非表示になります。

最初の問題を解決するには、2つ目のプロパティラッパーである@FocusStateを理解する必要があります。これは通常の@Stateプロパティと全く同じですが、UIの入力フォーカスを処理するために特別に設計されています。

ContentViewにこの新しいプロパティを追加します。

@FocusState private var amountIsFocused: Bool

これで、テキストフィールドにこれを適用できます。テ
キストフィールドにフォーカスが当たっているときは amountIsFocused が true になり、そうでない場合は false になります。この修飾子を TextField に追加してください。

これで問題の最初の部分は解決しました。画面上では何も変化が見られませんが、SwiftUIは少なくともテキストフィールドにフォーカスを当てるべきかどうかを暗黙のうちに認識しているのです。

解決策の2つ目は、テキストフィールドがアクティブになったときにツールバーボタンを追加することです。これをうまく機能させるには、いくつかの新しいSwiftUIビューを理解する必要があるため、まずはコードをお見せしてから、その動作を説明するのが最善だと思います。
既存の navigationTitle() 修飾子の下に、この新しい修飾子をフォームに追加してください。

.toolbar {
    if amountIsFocused {
        Button("Done") {
            amountIsFocused = false
        }
    }
}

詳しく見ていきましょう。

  1. toolbar() 修飾子を使用すると、ビューのツールバー項目を指定できます。これらのツールバー項目は、画面上のさまざまな場所に表示されます。たとえば、上部のナビゲーションバー、下部の専用ツールバー領域などです。
  2. この条件は、amountIsFocusedが現在trueであるかどうかをチェックし、テキストフィールドがアクティブな場合にのみボタンを表示します。
  3. ここで使用しているButtonビューには、タップ可能なテキストが表示されます。この例では「完了」と表示されています。また、ボタンが押されたときに実行されるコードも必要です。このコードでは、amountIsFocusedをfalseに設定してキーボードを非表示にします。

今後、このような問題に遭遇する機会は増えるでしょうが、まずはプログラムを実行して試してみることをお勧めします。大きな改善が見られるはずです!

これでこのプロジェクトの最後のステップは完了です。よく頑張りましたね!

0 件のコメント:

コメントを投稿

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

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