イニシャライザ


init(_:tableName:bundle:comment:)


キーによって識別される、ローカライズされたコンテンツを表示するテキストビューを作成します。


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

tvOS 13.0+ WatchOS 6.0+ VisionOS 1.0+


init(

tableName: String? = nil,
bundle: Bundle? = nil,
comment: StaticString? = nil
)





パラメータ


key

tableName で識別される表内の文字列のキー。


tableName

検索すべき文字列表の名前。nil の場合は、Localizable.strings ファイル内の表を使用します。


bundle

文字列ファイルを含むバンドル。nil の場合は、main バンドルを使用します。


comment

このキーと値のペアに関するコンテキスト情報。



議論


このイニシャライザを使用して、ローカライズ表で key パラメータを検索し、初期化されたテキストビューに関連する文字列値を表示します。イニシャライザが表内でキーを見つけられない場合、または表が存在しない場合は、代わりにテキストビューにキーの文字列表現が表示されます。


Text("pencil") // Localizes the key if possible, or displays "pencil" if not.


文字列リテラルでテキストビューを初期化すると、上記の例のように表を明示的に指定していない場合でも、文字列をローカライズする必要があると想定されるため、ビューはこのイニシャライザを引き起こします。特定の文字列のローカライズをあなたが提供していない場合でも、イニシャライザによってキーが表示されるため、通常はローカライズされていない文字列が含まれるため、適切な動作が得られます。


文字列リテラルではなく文字列変数でテキストビューをあなたが初期化すると、ビューは代わりに init(_:) イニシャライザを引き起こします。これは、この場合、ローカライズが必要ないと想定されるためです。文字列変数内に格納されている値をローカライズしたい場合は、最初に文字列変数から LocalizedStringKey インスタンスを作成することで、init(_:tableName:bundle:comment:) イニシャライザを呼び出すことを選択できます。


Text(LocalizedStringKey(someString)) // Localizes the contents of `someString`.


ローカライズしたくない文字列リテラルがある場合は、代わりに init(verbatim:) イニシャライザを使用してください。



マークダウンでローカライズした文字列のスタイル設定


ローカライズした文字列またはフォールバックキーに Markdown が含まれている場合、ビューには適切なスタイルでテキストが表示されます。たとえば、スペイン語ローカライズファイルに以下のエントリがあるアプリについて考えてみましょう。


"_Please visit our [website](https://www.example.com)._" = "_Visita nuestro [sitio web](https://www.example.com)._";


以下のように、Markdown 形式の基本言語バージョンの文字列をローカライズキーとして使用して、Text ビューをあなたは作成できます。


Text("_Please visit our [website](https://www.example.com)._")


スペイン語ロケールで表示すると、ビューは文字列ファイルからスペイン語テキストを使用し、Markdown スタイルを適用します。




重要


Text は、Markdown で可能なすべてのスタイルをレンダリングするわけではありません。改行、ソフトブレーク、リスト、ブロック引用符、コードブロック、表などの段落ベースまたはブロックベースの書式設定のスタイルはサポートされていません。また、imageURL 属性もサポートしていません。SwiftUI を使用した解析では、AttributedString.MarkdownParsingOptions.InterpretedSyntax.inlineOnlyPreservingWhitespace 解析オプションで説明されているように、Markdown 文字列内の空白が処理されます。





以下も見よ


文字列からテキストビューを作成


init(LocalizedStringResource)

ローカライズされた文字列リソースを表示するテキストビューを作成します。


init<S>(S)

ローカライズせずに保存された文字列を表示するテキストビューを作成します。


init(verbatim: String)

ローカライズせずに文字列リテラルを表示するテキストビューを作成します。















トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ