構造体
Label
タイトル付きのアイコンで構成される、ユーザインターフェイス項目の標準ラベル。
宣言
struct Label<Title, Icon> where Title : View, Icon : View
概観
最も一般的で認識可能なユーザーインターフェイスコンポーネントの 1 つは、アイコンとラベルの組み合わせです。この慣用句は、多くの種類のアプリに表示され、ほんの数例を挙げると、コレクション、リスト、アクション項目のメニュー、及び開示可能なリストに表示されます。
SF Symbols コレクションからのアイコンなど、イメージのタイトルと名前を提供して、最も単純な形式でラベルを作成して下さい:
Label("Lightning", systemImage: "bolt.fill")
いくつかの方法でラベルにスタイルを適用することもできます。デバイスの回転後のビューへの動的な変更またはウィンドウサイズへの変更の場合、titleOnly ラベルスタイルを使用してラベルのテキスト部分のみを表示したい場合があるでしょう:
Label("Lightning", systemImage: "bolt.fill")
逆に、アイコンのみのラベルスタイルもあります。
Label("Lightning", systemImage: "bolt.fill")
一部のコンテナは、macOS および iOS 上のツールバー内にアイコンのみを表示するなど、異なるデフォルトのラベルスタイルを適用する場合があります。タイトルとアイコンの両方を表示するように選択するには、titleAndIcon ラベルスタイルを適用できます。
Label("Lightning", systemImage: "bolt.fill")
既存のスタイルを変更して、カスタマイズされたラベルスタイルを作成することもできます。この例では、デフォルトのラベルスタイルに赤い境界線を追加します。
struct RedBorderedLabelStyle: LabelStyle {
}
より広範なカスタマイズを行う場合、またはまったく新しいラベルスタイルを作成する場合は、 LabelStyle プロトコルを採用し、新しいスタイルの LabelStyleConfiguration を実装する必要があります。
共通のラベルスタイルをラベルのグループに適用するには、ラベルを含むビュー階層にスタイルを適用します。
VStack {
}
.labelStyle(.iconOnly)
事前に作成されたイメージを使用する代わりに、ビューを使用してラベルを作成し、プログラムでラベルのアイコンを作成することもできます。この例では、ラベルのアイコン部分は、ユーザのイニシャルが重複された、塗りつぶされた Circle を使用しています。
Label {
} icon: {
}
トピックス
テキストとイメージからラベルを作成
init(LocalizedStringKey, image: String)
ローカライズされた文字列から生成されたアイコンのイメージとタイトルでラベルを作成します。
Title が Text で Icon が Image の時使用できます。
文字列から生成されたアイコンのイメージとタイトルでラベルを作成します。
Title が Text で Icon が Image の時使用できます。
テキストと SF Symbol からラベルを作成
init(LocalizedStringKey, systemImage: String)
ローカライズされた文字列から生成されたタイトルとシステムアイコンイメージでラベルを作成します。
Title が Text で Icon が Image の時使用できます。
init<S>(S, systemImage: String)
文字列から生成されたタイトルとシステムアイコンイメージでラベルを作成します。
Title が Text で Icon が Image の時使用できます。
タイトルとアイコンからラベルを作成
init(title: () -> Title, icon: () -> Icon)
カスタムのタイトルとアイコンでラベルを作成します。
構成からラベルを作成
スタイルの構成を表すラベルを作成します。
Title が LabelStyleConfiguration.Title で Icon が LabelStyleConfiguration.Icon の時使用できます。
struct LabelStyleConfiguration
ラベルのプロパティ。
ファミリーアクティビティ用のラベルの作成
ファミリーアクティビティアプリケーションを表すラベルを作成します。
Title が FamilyActivityTitleView で Icon が FamilyActivityIconView の時利用可能です。
ファミリーアクティビティの Web ドメインを表すラベルを作成します。
Title が FamilyActivityTitleView で Icon が FamilyActivityIconView の時利用可能です。
ファミリーアクティビティカテゴリを表すラベルを作成します。
Title が FamilyActivityTitleView で Icon が FamilyActivityIconView の時利用可能です。
ラベルのスタイル化
func labelStyle<S>(S) -> some View
このビュー内のラベルのスタイルを設定します。
ビュー内のすべてのラベルにカスタムの外観を適用する型。
標準修飾子の適用
View の修飾子
標準の修飾子を適用して、このビューとそれに含まれるビューを構成します。
デフォルトの実装
View の実装
関連
以下への準拠
以下も見よ
値の指標
タスクの完了に向けた進捗状況を示すビュー。
範囲内の値を表示するビュー。