100 Days of SwiftUIのDay20です。
昨日のチャレンジデーはいかがでしたか?
あなたがまだ世に知られていないプログラミングの天才でない限り、途中でいくつかミスを犯した可能性が高く、もしかしたらまだ気づいていないバグがアプリに残っているかもしれません。
そして、ご存知ですか?それでいいんです。
スタンフォード大学の名誉教授であるドナルド・クヌースはかつてこう書いています。「上記のコードにはバグがあるかもしれないので注意してください。私はそれが正しいことを証明しただけで、実際に試したわけではありません。」ドナルド・クヌースでさえ潜在的なバグについて警告しているのだから、私たち自身のコードにいくつかバグがあっても問題ないと思います。
今日は2つ目のプロジェクトに取り掛かりますので、概要説明に戻り、新しいSwiftUIのテクニックをいくつか見ていきましょう。これも簡単なプロジェクトですが、今後何年も使い続けることになるSwiftUIのコアテクニックをたくさん学ぶことができます。
今日は6つのトピックに取り組みます。VStack、Image、LinearGradientなどについて学びます。
1. Guess the Flag: Introduction
この2つ目のSwiftUIプロジェクトでは、ユーザーが世界の多くの国旗を学ぶのに役立つ推測ゲームを作成します。
このプロジェクトは引き続き簡単で分かりやすいものですが、スタック、ボタン、画像、アラート、アセットカタログなど、SwiftUIのさまざまな新機能を紹介する機会にもなります。
最初のアプリは完全に標準的なiOSのルックアンドフィールを採用していましたが、今回はよりカスタマイズされたものを作成し、SwiftUIを使えばどれほど簡単にできるかをお見せします。
このプロジェクトに必要なファイルをダウンロードする必要があります。
GitHub からダウンロードできます: https://github.com/twostraws/HackingWithSwift – ファイルの SwiftUI セクションを確認してください。
それらが揃ったら、以前と同じ設定でXcodeに「GuessTheFlag」という名前の新しいアプリプロジェクトを作成してください。
前回と同様、アプリの構築に必要な様々なSwiftUIテクノロジーの概要から始めますので、早速見ていきましょう…
GithubのSwiftUI / project2に色々あるようです。
また以前と同じようにGuessTheFlagという名前でXcodeのプロジェクトを作成します。
2. Using stacks to arrange views
ボディに対して何らかのビューを返す場合、SwiftUIは画面に表示できる何らかのビューが返されることを期待します。
それはナビゲーションビュー、フォーム、テキストビュー、ピッカー、あるいは全く別のビューである可能性がありますが、画面に描画できるようにViewプロトコルに準拠している必要があります。
複数のデータをきれいに整理して返したい場合は、さまざまな方法がありますが、特に便利なのが次の3つです。HStack、VStack、ZStackで、それぞれ水平方向、垂直方向、そして、深さ方向の処理に対応しています。
それでは早速試してみましょう。デフォルトのテンプレートは以下のようになります。
var body: some View {
VStack {
Image(systemName: "globe")
.imageScale(.large)
.foregroundStyle(.tint)
Text("Hello, world!")
}
.padding()
}既にVStackが含まれているため、画像はテキストの上に表示されます。しかし、以下のようにもっとシンプルにすることもできます。
var body: some View {
Text("Hello, world!")
Text("This is another text view")
}私たちはそれがVStackであるとは言っていませんが、SwiftUIが自動的に判断してくれます。そのため、2つのテキストビューをこのようにゆるやかに配置することも、明示的にVStackに配置することもできます。
var body: some View {
VStack {
Text("Hello, world!")
Text("This is inside a stack")
}
}はい、結果はここでも同じですが、重要な違いが3つあります。
- 明示的に指定することで、ビュー間の間隔をどれだけ空けるかを指定できます。
- また、ビューを互いに左、右、または中央に配置するかどうかなど、配置を指定することもできます。
- 明示的に垂直スタックを要求しない場合、SwiftUI はそれらのビューを別の方法で配置することができます。例えば、水平配置を使用するより大きなビューの中にあった場合、水平方向に表示される可能性があります。
デフォルトでは、VStack は2 つのビュー間に一定の間隔を自動的に配置しますが、スタックを作成する際に次のようにパラメータを指定することで間隔を制御できます。
VStack(spacing: 20) {
Text("Hello, world!")
Text("This is inside a stack")
}デフォルトでは、VStack はビューを中央揃えにしますが、alignmentプロパティでそれを制御できます。
たとえば、これはテキスト ビューを先頭のエッジに揃えます。英語のような左から右に書く言語では、テキスト ビューは左揃えになります。
VStack(alignment: .leading) {
Text("Hello, world!")
Text("This is inside a stack")
}VStackに加えて、水平方向に要素を配置するためのHStackもあります。これはVStackと同じ構文を持ち、間隔や配置を追加する機能も備えています。
HStack(spacing: 20) {
Text("Hello, world!")
Text("This is inside a stack")
}垂直スタックと水平スタックは、コンテンツに合わせて自動的に調整され、利用可能なスペースの中央に配置される傾向があります。
これを変更するには、1つまたは複数のSpacerビューを使用して、スタックのコンテンツを片側に寄せることができます。Spacerビューは残りのスペースを自動的に占有するため、VStackの最後にSpacerビューを追加すると、すべてのビューが画面上部に押し上げられます。
VStack {
Text("First")
Text("Second")
Text("Third")
Spacer()
}スペーサーを複数追加すると、スペーサー同士で利用可能なスペースが分割されます。例えば、上部に3分の1、下部に3分の2のスペースを割り当てることができます。
VStack {
Spacer()
Text("First")
Text("Second")
Text("Third")
Spacer()
Spacer()
}また、要素を深さ順に並べるためのZStackもあります。これはビューが重なり合うように配置します。2つのテキストビューの場合、これは読みにくくするでしょう。
ZStack {
Text("Hello, world!")
Text("This is inside a stack")
}ZStack にはビューが重なり合うため間隔の概念はありませんが、配置はあります。
そのため、ZStack 内に大きなものと小さなものが 1 つある場合、次のように両方のビューを上部に揃えることができます: ZStack(alignment: .top) {
ZStackは、上から下、奥から手前の順にコンテンツを描画します。つまり、画像とその後にテキストがある場合、ZStackはそれらをその順序で描画し、テキストを画像の上に配置します。
複数の水平方向の積み重ねを1つの垂直方向の積み重ねの中に配置してみてください。3×3のグリッドを作ることができますか?
3. Colors and frames
SwiftUIは、色をレンダリングするための幅広い機能を提供してくれるだけでなく、シンプルさと強力さを両立させている。これは難しい組み合わせだが、彼らは見事にそれを成し遂げた。
これを試すために、テキストラベルが1つだけのZStackを作成してみましょう。
ZStack {
Text("Your content")
}テキストの背後に何かを配置したい場合は、ZStack 上でテキストの上に配置する必要があります。
では、その背後に赤色を配置したい場合はどうすればよいでしょうか?
一つの方法として、background() 修飾子を使用する方法があります。この修飾子には、以下のように描画する色を指定できます。
ZStack {
Text("Your content")
}
.background(.red)それはあなたの予想通りだったかもしれませんが、意外な結果だった可能性も十分にあります。ZStack全体に背景色を設定するように指示したにもかかわらず、テキストビューにしか背景色が適用されなかったのです。
実際、そのコードとこのコードに違いはありません。
ZStack {
Text("Your content")
.background(.red)
}テキストの背景領域全体を赤色で塗りつぶしたい場合は、その色をZStackに配置する必要があります。つまり、ZStackを独立したビューとして扱います。
ZStack {
Color.red
Text("Your content")
}実際、Color.redはそれ自体がビューであり、そのため図形やテキストのように使用できます。
ヒント
background()修飾子を使用していたときは、SwiftUIは.redが実際にはColor.redを意味することを認識できました。しかし、色を独立したビューとして使用する場合、Swiftは.redの意味を理解するためのコンテキストを持たないため、Color.redであることを明示的に指定する必要があります。
色は自動的に利用可能なスペース全体を占有しますが、frame() 修飾子を使用して特定のサイズを指定することもできます。たとえば、次のように 200x200 の赤い正方形を指定できます。
Color.red
.frame(width: 200, height: 200)レイアウトに応じて、最小および最大幅と高さを指定することもできます。
たとえば、高さが200ポイント以下で、幅は少なくとも200ポイント以上で、他の要素で使用されていない利用可能な幅全体に広がる色を指定したい場合などです。
Color.red
.frame(minWidth: 200, maxWidth: .infinity, maxHeight: 200)SwiftUIには、Color.blue、Color.green、Color.indigoなど、多くの組み込みカラーが用意されています。また、セマンティックカラーと呼ばれる、色相ではなく用途を表すカラーもあります。
例えば、Color.primaryはSwiftUIにおけるテキストのデフォルトカラーで、ユーザーのデバイスがライトモードかダークモードかによって黒または白になります。
Color.secondaryもあり、これもデバイスによって黒または白になりますが、わずかに透明度が加わり、背後の色が少し透けて見えるようになっています。
特定の色が必要な場合は、赤、緑、青に0から1の間の値を渡すことで、カスタムカラーを作成できます。
Color(red: 1, green: 0.8, blue: 0)画面全体を占める場合でも、Color.red を使用すると、白い余白が残ることがわかります。
白い部分の範囲はデバイスによって異なりますが、Face IDを搭載したiPhone(例えばiPhone 15)では、ダイナミックアイランドエリア(上部のカプセル型の領域)とホームインジケーター(下部の横縞)の両方が着色されていないことがわかります。
このスペースは意図的に空白にされています。Appleは、重要なコンテンツが他のUI機能やデバイスの角の丸みによって隠れてしまうことを望んでいないからです。
そのため、残りの部分、つまり中央のスペース全体はセーフエリアと呼ばれ、iPhoneのノッチによって切り取られることを心配することなく、自由に描画できます。
補足
実画面はこうなります、上の白い部分が「ダイナミックアイランドエリア」で下の白い部分が「ホームインジケーター」で真ん中の赤いところが「セーフエリア」になります。
コンテンツをセーフエリア内に収めたい場合は、.ignoresSafeArea() 修飾子を使用して、画面のどの端まで表示させるかを指定できます。何も指定しない場合は、自動的に画面の端から端まで表示されます。たとえば、これは画面全体を赤色で塗りつぶし、その上にテキストを描画する ZStack を作成します。
ZStack {
Color.red
Text("Your content")
}
.ignoresSafeArea() 補足
この説明は間違っています。
.ignoresSafeArea() を指定すると端から端までが対象になります。
セーフエリア内に収めたい場合という説明と矛盾します。
以下のように全ての領域が赤くなります。
また以下のようにすると
VStack {
Text("Your content")
Spacer()
}
.ignoresSafeArea() テキストはダイナミックアイランドエリアのところまで来ます。そのため、コンテンツをセーフエリア内に納めたいのであれば、.ignoresSafeArea() を指定しない。
が正しいです。
重要なコンテンツはセーフエリア外に配置しないことが非常に重要です。
なぜなら、ユーザーがコンテンツを確認することが困難、あるいは不可能になる可能性があるからです。リストビューなど一部のビューでは、コンテンツがセーフエリア外にスクロールしても問題ありませんが、その場合は追加のインセットが追加されるため、ユーザーはスクロールしてコンテンツを表示させることができます。
追加のインセットとは「コンテンツがダイナミックアイランドエリアやホームインジケーターに隠れないように自動的、または手動で調整される余白(パディング)」のことです。
List などのスクロールビューは、デフォルトでは「セーフエリアを無視して、画面の一番端(ノッチやホームインジケータの裏側)まで広がりながらスクロールする」という仕様になっています。
そのため余分な余白をいれることで、コンテンツがダイナミックアイランドエリアやホームインジケーターに隠れないようになります。
イメージ
★追加のインセット(ダイナミックアイランドエリア)
★追加のインセット(ホームインジケーター)
という感じになります。
コンテンツが単なる装飾的なものであれば(例えば、ここでの背景色のように)、セーフエリア外に拡張しても問題ありません。
マテリアルを指定すると、その下にあるオブジェクトに曇りガラスのような効果が適用され、美しい奥行き感を演出できます。
ZStack {
VStack(spacing: 0) {
Color.red
Color.blue
}
Text("Your content")
.foregroundStyle(.secondary)
.padding(50)
.background(.ultraThinMaterial)
}
.ignoresSafeArea()求める効果に応じて、他にも様々な素材の厚みを選択できますが、さらに素晴らしいものをお見せしたいと思います。ただし、これは微妙な違いなので、SwiftUIプレビューの下部にある小さな虫眼鏡アイコンをクリックして、「Your content」というテキストを拡大してご覧ください。
テキストが単なる灰色ではなく、背景の赤と青の色が少し透けて見えることに気づくかもしれません。ほんのわずかですが、効果的に使うことで、背景色に関わらずテキストが際立つ美しい効果を生み出します。iOSではこの効果を「鮮やかさ」と呼び、システム全体で広く使われています。
4. Gradients
SwiftUIでは、4種類のグラデーションを使用できます。色と同様に、そのほとんどはUIに描画できるビューです。
グラデーションは、いくつかのコンポーネントで構成されています。
- 色とりどりのディスプレイ
- サイズと方向に関する情報
- 使用するグラデーションの種類
LinearGradient(colors: [.white, .black], startPoint: .top, endPoint: .bottom)グラデーションストップ機能を使えば、色と、その色がグラデーションのどの位置で使用されるかを指定できます。例えば、グラデーションの開始位置から使用可能なスペースの45%までは白、55%以降は黒と指定できます。
LinearGradient(stops: [
Gradient.Stop(color: .white, location: 0.45),
Gradient.Stop(color: .black, location: 0.55),
], startPoint: .top, endPoint: .bottom)そうすることで、よりシャープなグラデーションが生まれます。中央の狭い空間に色が圧縮されるからです。
ヒント
Swiftはここでグラデーションストップを作成していることを認識しているので、ショートカットとしてGradient.Stopの代わりに.initと記述するだけで済みます。
LinearGradient(stops: [
.init(color: .white, location: 0.45),
.init(color: .black, location: 0.55),
], startPoint: .top, endPoint: .bottom)代替案として、放射状グラデーションは円状に外側に向かって移動するため、方向を指定する代わりに、円の中心から色の変化を開始および停止する半径(開始半径と終了半径)を指定します。
RadialGradient(colors: [.blue, .black], center: .center, startRadius: 20, endRadius: 200)最後に紹介する、ビューでもあるグラデーションは、角度グラデーションと呼ばれます。円錐グラデーションや円錐状グラデーションと呼ばれることもありますが、これは色が外側に放射状に広がるのではなく、円周に沿って循環するため、美しい効果を生み出すことができます。
例えば、これは単一のグラデーション内の様々な色を、グラデーションの中央を中心に順番に変化させます。
AngularGradient(colors: [.red, .yellow, .green, .blue, .purple, .red], center: .center)これらのグラデーションタイプはすべて、単純な色ではなくストップを指定できます。
さらに、レイアウト内で独立したビューとして使用することも、モディファイアの一部として使用することもできます。
たとえば、テキストビューの背景として使用できます。
SwiftUIには、これら最初の3種類よりもシンプルな4つ目のグラデーションタイプが用意されています。ただし、このグラデーションは制御できず、個々のビューではなく、背景や前景のスタイルとしてのみ使用できます。
このグラデーションは、任意の色の後に .gradient を追加するだけで作成できます。SwiftUI が自動的に色を非常に滑らかな線形グラデーションに変換します。
次のように試してみてください。
Text("Your content")
.frame(maxWidth: .infinity, maxHeight: .infinity)
.foregroundStyle(.white)
.background(.red.gradient)この種のグラデーションは非常に微妙ですが、ほとんど手間をかけずにデザインを格段に向上させるのに役立ちます。私がこれをよく使うのがお分かりいただけるでしょう!
5. Buttons and images
以前にもSwiftUIのボタンについて簡単に触れましたが、それらは非常に柔軟性が高く、幅広い用途に対応できます。
ボタンを作成する最も簡単な方法は、以前にも説明した方法です。
つまり、ボタンにテキストだけが含まれている場合は、ボタンのタイトルと、ボタンがタップされたときに実行されるクロージャを渡します。
Button("Delete selection") {
print("Now deleting…")
}もちろん、それはクロージャだけでなく、どんな関数でも構わないので、このような形式でも問題ありません。
struct ContentView: View {
var body: some View {
Button("Delete selection", action: executeDelete)
}
func executeDelete() {
print("Now deleting…")
}
}ボタンの外観をカスタマイズする方法はいくつかあります。
まず、ボタンに役割を割り当てることができます。iOS はこの役割を使って、ボタンの見た目とスクリーンリーダーの表示を調整します。
たとえば、削除ボタンに次のような破壊的な役割を割り当てることができます。
Button("Delete selection", role: .destructive, action: executeDelete)
次に、ボタン用の組み込みスタイルである .bordered と .borderedProminent のいずれかを使用できます。これらは単独で使用することも、ロールと組み合わせて使用することもできます。
VStack {
Button("Button 1") { }
.buttonStyle(.bordered)
Button("Button 2", role: .destructive) { }
.buttonStyle(.bordered)
Button("Button 3") { }
.buttonStyle(.borderedProminent)
Button("Button 4", role: .destructive) { }
.buttonStyle(.borderedProminent)
}枠付きボタンの色をカスタマイズしたい場合は、次のようにtint()修飾子を使用します。
Button("Button 3") { }
.buttonStyle(.borderedProminent)
.tint(.mint)重要:Appleは、目立つボタンを多用することを明確に推奨していません。なぜなら、すべてが目立つと、何も目立たなくなるからです。
完全にカスタマイズされたものが必要な場合は、2つ目の末尾クロージャを使用してカスタムラベルを渡すことができます。
Button {
print("Button was tapped")
} label: {
Text("Tap me!")
.padding()
.foregroundStyle(.white)
.background(.red)
}SwiftUIには、アプリ内で画像を扱うための専用のImage型があり、それらを作成する主な方法は3つあります。
- Image("pencil") は、プロジェクトに追加した「Pencil」という名前の画像を読み込みます。
- Image(decorative: "pencil") は同じ画像を読み込みますが、スクリーンリーダーを有効にしているユーザーに対しては読み上げません。これは、重要な追加情報を提供しない画像に便利です。
- Image(systemName: "pencil") は、iOS に組み込まれている鉛筆アイコンを読み込みます。これは Apple の SF Symbols アイコンコレクションを使用しており、お好みのアイコンを検索できます。すべてのアイコンセットを表示するには、Apple の無料 SF Symbols アプリをウェブからダウンロードしてください。
デフォルトでは、スクリーンリーダーが有効になっている場合、画像名が読み上げられます。そのため、ユーザーを混乱させないように、画像には分かりやすい名前を付けてください。また、画像が画面上の他の場所に既に表示されている情報以外に追加情報を提供しない場合は、Image(decorative:) イニシャライザを使用してください。
ボタンの長い形式にはあらゆる種類のビューを含めることができるため、次のような画像を使用できます。
Button {
print("Edit button was tapped")
} label: {
Image(systemName: "pencil")
}テキストと画像を同時に表示したい場合は、2つの方法があります。1つ目は、以下のように両方をボタンに直接渡す方法です。Button("Edit", systemImage: "pencil") {
print("Edit button was tapped")
}しかし、よりカスタマイズされたものが必要な場合は、SwiftUIにはLabelという専用の型があります。
Button {
print("Edit button was tapped")
} label: {
Label("Edit", systemImage: "pencil")
.padding()
.foregroundStyle(.white)
.background(.red)
}どちらの場合も、鉛筆アイコンと「Edit」という文字が並んで表示されます。
一見すると、シンプルなHStackを使った場合と全く同じように見えます。
しかし、SwiftUIは非常に賢く、レイアウト内での使用状況に応じてアイコン、テキスト、またはその両方を表示するかどうかを自動的に判断します。そのため、このオプションは非常に優れた選択肢となります。
6. Showing alert messages
重要な出来事が発生した場合、ユーザーに通知する一般的な方法はアラートを使用することです。
アラートとは、タイトル、メッセージ、そして必要に応じて1つまたは2つのボタンを含むポップアップウィンドウです。
しかし、よく考えてみてください。
アラートはいつ、どのように表示すべきでしょうか?
ビューはプログラムの状態に依存する関数であり、アラートも例外ではありません。そのため、「アラートを表示する」と直接指示するのではなく、アラートを作成し、表示する条件を設定するのです。
基本的な SwiftUI アラートにはタイトルとそれを閉じるボタンがありますが、より興味深いのは、そのアラートをどのように表示するかです。
アラートを変数に代入してから myAlert.show() のようなコードを書くのではなく、そうすると古い「一連のイベント」という考え方に戻ってしまうからです。
代わりに、アラートが表示されているかどうかを追跡する状態を作成します。例えば、次のようになります。
@State private var showingAlert = false次に、アラートをユーザーインターフェースのどこかにアタッチし、その状態に基づいてアラートを表示するかどうかを判断するように指示します。SwiftUIはshowingAlertを監視し、状態がtrueになるとすぐにアラートを表示します。
これらをまとめると、ボタンがタップされたときにアラートを表示するサンプルコードは以下のようになります。
struct ContentView: View {
@State private var showingAlert = false
var body: some View {
Button("Show Alert") {
showingAlert = true
}
.alert("Important message", isPresented: $showingAlert) {
Button("OK") { }
}
}
}これによりアラートがボタンに添付されますが、正直なところ、alert() 修飾子がどこで使用されているかは重要ではありません。
私たちがしていることは、アラートが存在し、showingAlert が true の場合に表示されることを示しているだけです。
alert() 修飾子をよく見てみましょう。
alert("Important message", isPresented: $showingAlert)最初の部分はアラートのタイトルで、これは非常に単純ですが、アラートが閉じられると SwiftUI が自動的に showingAlert を false に戻すため、もう 1 つの双方向データバインディングがあります。
それでは、ボタンを見てください。
Button("OK") { }これは空のクロージャです。
つまり、ボタンが押されたときに実行される機能は何も割り当てられていません。しかし、アラート内のボタンは自動的にアラートを閉じるので問題ありません。このクロージャは、アラートを閉じる以外の追加機能を追加するために存在します。
アラートにボタンを追加することもできます。特に、各ボタンの機能を明確にするために、役割を追加するのに最適な場所です。
.alert("Important message", isPresented: $showingAlert) {
Button("Delete", role: .destructive) { }
Button("Cancel", role: .cancel) { }
}最後に、タイトルの横にメッセージテキストを追加するには、次のように末尾に2つ目の閉じタグを付けます。
Button("Show Alert") {
showingAlert = true
}
.alert("Important message", isPresented: $showingAlert) {
Button("OK", role: .cancel) { }
} message: {
Text("Please read this.")
}補足
まず、alert()修飾子に関して、なんの説明がないので、修飾子(modifier)とは何か?、何をモディファイ(修飾)しているのか?
答えは、「ビュー(UI部品)に見た目や機能を追加・変更するための『あと付けの装飾パーツ』」です。
今回はButtonに対して追加していますが、var body: some View { ... }の中のViewであれあれば、何でも(例:Text, VStack)追加できます。
また今回はButtonに追加していますが、オブジェクトの依存関係はありません。
Buttonを押下したときにアラートを表示しますが、それを実現しているのは「showingAlert = true」の部分です。
アラートの仕様として、isPresenedでバンドした変数がtrueであればアラートメッセージを表示します。
そしてボタン押下時に「showingAlert = true」を設定しているので、ボタンを押下するとアラートメッセージを表示するという挙動になります。
alert("Important message", isPresented: $showingAlert)isPresented
修飾子のコンテンツクロージャで作成したアラートを表示するかどうかを決定するブール値へのバインディング。ユーザーが「OK」を押すかタップすると、システムは isPresented を false に設定し、アラートを閉じます。
これでプロジェクトの概要説明は最終回です。いよいよ実際のコードに取り掛かりましょう。作成したサンプルコードを保存したい場合は、プロジェクトディレクトリを別の場所にコピーしてください。
準備ができたら、ContentView.swift をプロジェクトを最初に作成した時の状態に戻してください。そうすれば、まっさらな状態から作業を開始できます。






0 件のコメント:
コメントを投稿