構造体

Text

1 行以上の読み取り専用テキストを表示するビュー。

iOS 13.0+ iPadOS 13.0+ macOS 10.15+ Mac Catalyst 13.0+

tvOS 13.0+ WatchOS 6.0+ VisionOS 1.0+

@frozen
struct Text

概観

テキストビューは、現在のプラットフォームに適した body フォントを使用して、あなたのアプリのユーザインターフェイスに文字列を描画します。font(_:) ビュー修飾子を使用して、title や caption などの別の標準フォントを選択できます。

Text("Hamlet")
.font(.title)

テキストのスタイルをより細かく制御する必要がある場合は、同じ修飾子を使用してシステムフォントを構成するか、カスタムフォントを選択できます。また、bold() や italic() などのビュー修飾子を適用して、書式設定をさらに調整することもできます。

Text("by William Shakespeare")
.font(.system(size: 12, weight: .light, design: .serif))
.italic()

テキストの特定の部分にスタイルを適用するには、AttributedString からテキストビューを作成します。これにより、Markdown を使用して一連のテキストのスタイルを設定できるようになります。文字列属性と SwiftUI 修飾子を混在させることができますが、文字列属性が優先されます。

let attributedString = try! AttributedString(
markdown: "_Hamlet_ by William Shakespeare")
var body: some View {
Text(attributedString)
.font(.system(size: 12, weight: .light, design: .serif))
}

テキストビューは、そのレンダリングされたコンテンツを表示するために必要なスペースの量を常に正確に使用しますが、ビューのレイアウトに影響を与えることができます。たとえば、frame(width:height:alignment:) 修飾子を使用して、ビューに特定の寸法を提案できます。ビューが提案を受け入れてもテキストが利用可能なスペースに収まらない場合、ビューは折り返し、締め付け、拡大縮小、及び切り捨てを組み合わせてテキストを適合させます。幅が 100 ポイントで高さの制約がない場合、テキストビューは長い文字列を折り返します。

Text("To be, or not to be, that is the question:")
.frame(width: 100)

lineLimit(_:)、allowsTightening(_:)、minimumScaleFactor(_:)、truncationMode(_:) などの修飾子を使用して、ビューがスペース制約を処理する方法を構成します。たとえば、固定幅と 1 行制限を組み合わせると、そのスペースに収まらないテキストが切り捨てられます。

Text("Brevity is the soul of wit.")
.frame(width: 100)
.lineLimit(1)

文字列のローカライズ

文字列リテラルでテキストビューを初期化する場合、ビューは init(_:tableName:bundle:comment:) イニシャライザを使用しますが、これは、文字列をローカライズキーとして解釈し、あなたの指定した表内または指定していない場合はデフォルトの表内でキーを検索します。

Text("pencil") // Searches the default table in the main bundle.

英語とスペイン語の両方にローカライズされたアプリの場合、上のビューでは、英語ユーザとスペイン語ユーザに対してそれぞれ "pencil" と "lápiz" が表示されます。ビューがローカライズを実行できない場合は、代わりにキーが表示されます。たとえば、同じアプリにデンマーク語のローカライズがない場合、ビューにはそのロケールのユーザに対して "pencil" が表示されます。同様に、ローカライズ情報が不足しているアプリでは、どのロケールでも "pencil" が表示されます。

文字列リテラルのローカライズを明示的にバイパスするには、init(verbatim:) イニシャライザを使用します。

Text(verbatim: "pencil") // Displays the string "pencil" in any locale.

変数値でテキストビューを初期化する場合、ビューは文字列をローカライズしない init(_:) イニシャライザを使用します。ただし、最初に LocalizedStringKey インスタンスを作成することでローカリゼーションをあなたはリクエストでき、これにより、代わりに init(_:tableName:bundle:comment:) イニシャライザが引き起こされます。