ラベル
ラベルは、人々が読み取り、多くの場合コピーすることはできますが、編集することはできない静的なテキストです。
ラベルは、インターフェイス全体を通して、ボタン、メニュー項目、およびビュー内でテキストを表示し、人々が現在のコンテキストと次にできることを理解するのに役立ちます。
ラベル という用語は、さまざまな場所に表示される編集不可能なテキストを指します。例えば：
以下のガイダンスは、ラベルを使用してテキストを表示するのに役立ちます。場合によっては、特定のコンポーネント (ボタン、メニュー、リスト など) のガイダンスに、テキストの使用に関する追加の推奨事項が含まれています。
ベストプラクティス
ラベルを使用して、人々が編集する必要のない少量のテキストを表示します。 人々が少量のテキストを編集できるようにする必要がある場合は、テキストフィールド を使用します。大量のテキストを表示する必要があり、必要に応じて人々が編集できるようにする場合は、テキストビュー を使用します。
システムフォントが望ましい。 ラベルはプレーンテキストまたはスタイル付きテキストを表示でき、デフォルトで動的タイプ (利用可能な場合) をサポートします。ラベルのスタイルを調整したり、カスタムフォントを使用したりする場合は、テキストが読みやすいままであることを確認してください。
システムが提供するラベルの色を使用して、相対的な重要性を伝えます。 システムは、テキストにさまざまなレベルの視覚的重要性を与えるのに役立つように、外観が異なる 4 つのラベルの色を定義しています。追加のガイダンスについては、色 を参照してください。
| システムカラー | 使用例 | iOS,iPadOS,tvOS | macOS |
| ラベル | 一次情報 | labelColor | labelColor |
| 二次ラベル | 小見出しまたは補足テキスト | secondaryLabelColor | secondaryLabelColor |
| 三次ラベル | 利用できないアイテムまたは動作を説明するテキスト | tertiaryLabelColor | tertiaryLabelColor |
| 四次ラベル | 透かしのテキスト | quaternaryLabelColor | quaternaryLabelColor |
便利なラベルテキストを選択可能にします。 ラベルに有用な情報 (エラーメッセージ、場所、IP アドレスなど) が含まれている場合は、他の場所にペーストするために人々が選択してコピーできるようにご検討ください。
プラットフォームの考慮事項
iOS、iPadOS、または tvOS に関する追加の考慮事項はありません。
macOS
watchOS
watchOS アプリで SwiftUI の Label (Label) と Text (Text) コンポーネントを使用するだけでなく、WatchKit の日付とタイマーのラベルを使用してリアルタイムの値を表示できます。
日付ラベル (WKInterfaceDate) (下の左側に表示) には、現在の日付、現在の時刻、または両方の組み合わせが表示されます。さまざまな形式、カレンダー、およびタイムゾーンを使用するように日付ラベルを構成できます。構成後、日付ラベルはあなたのアプリからの入力なしでその値を更新します。タイマーラベル (WKInterfaceTimer) (下の右側に表示) には、正確なカウントダウンまたはカウントアップタイマーが表示されます。タイマーラベルを構成して、そのカウント値をさまざまな形式で表示できます。構成後、タイマーラベルはあなたのアプリからの入力なしでカウントダウンまたはカウントアップします。
日付ラベル
タイマーラベル
複雑化で日付とタイマーのラベルを使用することを検討してください。 システムが提供する日付ラベルとタイマー ラベルを使用すると、watchOS は使用可能なスペースに合わせてラベルコンテンツの表示を自動的に調整します。ガイダンスについては、複雑化 を参照してください。開発者向けガイダンスについては、CLKRelativeDateTextProvider 廃止 を参照してください。
リソース
関連
開発者用文書
Label — SwiftUI (Label)
Text - SwiftUI (Text)
UILabel — UIKit (UILabel)
NSTextField — AppKit (NSTextField)