Foundationの新機能

Foundationの新機能

Foundationの最新のアップデートが、Appのローカリゼーションと国際化のサポートの改善にどのように役立つかをご確認ください。Swift専用に設計された新しいAttributedStringを紹介します。Markdownを使用して各言語に対応したテキストにスタイルを適用する方法を確認しましょう。各言語に対応したテキストを自動的に修正して文法的性と複数形表記に合致させる文法準拠エンジンを検証します。日付と数値のフォーマット設定に関する改良点をお伝えします。これらの改良点により、パフォーマンスが向上すると共に複雑な要件がシンプル化されます。

リソース
- Foundation
- - HDビデオ
  - SDビデオ
関連ビデオ

WWDC23
- 文法的一致の活用法
WWDC22
- Swift Regex: 上級編
WWDC21
ダウンロード

こんにちは Tonyです Foundationチームのエンジニアですこのセッションへようこそ FoundationフレームワークはAppとフレームワークの基本機能を提供しファイル操作からネットワーク通知機能まで豊富な機能を備えています今回は Appに必要な国際化とローカライズに焦点を当てます今年のリリースはこのAPIにおいて過去最大の進歩を遂げていますまず SwiftにおけるAttributedStringを再考する最下層の作業から始めました Swiftのためにformatterを再構築しより速く使いやすくし新機能を追加しました最後にオート･グラマー･アグリーメントという新機能がありローカライズされた文字列を劇的に減らすことができ同時にコードもシンプルになりますではAttributedStringsから AttributedStringはキャラクタ範囲のセットおよびディクショナリの組み合わせです属性を持つ文字列ではキーと値のペアである属性を文字列の特定の範囲に関連付けることができます一般的な属性はSDKで定義されますが独自に作成することも可能ですリッチテキストをサポートするAPIでは AttributedStringsをよく見かけます例を見てみましょうこれは私が作ったカフェというAppでシンプルなメニューです食べたいものそしてサイズや量を選びます最後にレシートに注文したもののリストが表示されますサンキューメッセージを一番下に入れましたこれがAttributedStringです太字の部分と斜体の部分がありますリンクもついていますこのように属性が重なることもあります Foundationの初期から NSAttributedStringという参照型がありました今年は新しい構造体AttributedStringを導入し Swiftが提供するすべての機能を最大限に活用しますまず第一に値型であることまた Swift Stringと同じ文字カウントの動作をしますソフトウェアを簡単に書けるという取り組みの一環で AttributedStringは完全にローカライズできます最後に安全と安心を考えて作られていますそれは強力な型付けによるコンパイル時と Codableによるアンアーカイブ時を含みます新しいAttributedStringを早速見てみましょう
サンキューのメッセージを作りますまずはシンプルに AttributedStringを作りますこの文字列全体に属性を設定しますフォントの設定並にシンプルにできます AttributedStringの構築ではすべての属性が直接利用でき正しい型を使用しています例えばこれはSwiftUIフォントです次に別の部分を作りますこれはリンクがつくので URLをつけますフォントとリンクを属性全体に設定しました部分的に変える方法は後ほど説明します AttributeContainerという便利ツールもあります文字列がなくても属性や値を単独で保持できる場所ですここではメッセージの重要性に応じて Containerを作成しいくつか属性を設定しますそしてその属性を両方のAttributedStringsにマージします先程も言った通りAttributedStringはキャラクタ範囲ディクショナリの組合せです AttributedStringはそのどれか１つのコレクションではありません代わりにこれらのプロパティにアクセスする viewと呼ばれるものがあります最も重要なview２つは文字列へのアクセスを提供するcharactersと属性へのアクセスを提供するrunsですこれらのviewはSwiftのコレクションですつまりArrayなどの型でおなじみの機能がここでも利用できます別の例を見てみましょうデザイナーの指示で句読点をオレンジ色にして華やかさを演出したとしますまずAttributedStringのどこに句読点があるか調べる必要があります他のSwiftコレクション同様 AttributedStringのViewは indicesを使用しますインデックスによる反復処理には標準ライブラリのindices関数を使います次にisPunctuationという関数を使い変更が必要な文字か確認します最後にAttributedStringの機能スライシングで文字列のサブレンジのみに属性を適用します範囲はこのindexから次のindexまで続く１つのキャラクタです句読点がオレンジになりましたもう１つのviewであるrunsを見てみましょう runは特定の属性の開始位置長さ値ですまずメッセージ内のrunを数えます文字列内の属性値の連続した範囲を反復しますこの文字列にはrunが４つあります runは各属性の値またはnilが設定されています rangeのcharactersとrunは交換可能なので属性に対する文字列を探したりその逆も可能ですここではcharactersのサブスクリプトに属性のrangeを使用し結果を独立した文字列に変換しています
特定の属性に焦点を当てrunを見るのが有効であることが多いですここではキーパスのリンクを使って link属性だけのために合体させていますコレクションの各要素は文字列に設定されている可能性のある他の属性を考慮せずにlink属性の値を提供しますリンクだけを見ると３つの流れがあります最初は設定されていない状態２番目は値が設定されている状態３番目はピリオドで設定されていない状態です Runを反復すると値と範囲のtupleが得られます値がタイプセーフなのでキャストしたり間違ったタイプになる心配がなく URL上のschemeのようなAPIを使用できますここではAttributedStringに含まれるリンクがhttpsか確認していますまた部分文字列を探してその範囲を使って文字や属性を編集するという便利なテクニックもあります例えば“visit”をスローバックな雰囲気に置き換えてみますまず部分文字列の範囲を探します次にその範囲を使いそのサブレンジだけに属性や文字を設定します結果６つのrunを持つ AttributedStringになります続いてローカライズについて説明します AttributedStringは完全にローカライズできますまたObjective-CのNSAttributedStringにローカライズサポートを追加しました AttributedStringsは通常の文字列と同様 Appの文字列ファイルに配置されます Swiftでは SwiftUIのTextViewのように文字列補間で文字列とAttributedStringのローカライズフォーマットをサポートします簡単な例を挙げますこの関数はドキュメント名でカスタマイズされたローカライズされた文字列を返します %@や%dのようなフォーマット指定子やフォーマット関数の代わりに値を直接渡すことができます AttributedStringでも同様の方法が使えます
Xcodeではこれらの新しいイニシャライザからコンパイラで文字列ファイルを生成できますこれをオンにするにはBuild settingsで Localization settingsを探し Use Compiler to extract Swift StringsをオンローカライズされたAttributedStringがどう属性を取得するか気になりますね AttributedStringにMarkdownのサポートが追加されましたローカライズされたAttributedStringを SwiftUIのTextで使用する例を紹介しますまずシンプルなストリングから始めますテキストにアステリスクを追加し SwiftUIが太字としてレンダリングすることで文字を強調しますリンクのサポートも提供しています別の言語用にカスタマイズされたURLを提供する絶好の機会です取り消し線やコードボイスなどその他のインラインスタイルにも対応します最後にAttributedStringsのアーカイブを説明しますまずNSAttributedStringの参照型との間で変換する機能が必要です AttributedStringsはデータモデルになる可能性がありエンコードやデコードできる必要があります最後にMarkdownでカスタム属性を指定する方法ですこれらの操作はすべて関連していますまずはコンバージョンから見てみましょう
NSAttributedStringを使用するコードをたくさん書いてきたので構造体からクラス型への変換が簡単にできるようにしました NSAttributedStringプロパティのViewです NSAttributedStringイニシャライザに AttributedString構造体を渡して変換します SDKに含まれる属性についてはこれで十分ですではエンコードとデコードを見てみましょうカフェAppのレシートを格納する構造体を紹介しますここでもSwiftUI UIKit AppKit Foundation が提供する属性を利用しています AttributedStringのデフォルトの Codable実装があればいいわけです ReceiptにCodableの適合性を追加するだけで完了ですもう少し踏み込んでカスタム属性のエンコーディングに対応してみましょうまずは属性そのものの話から属性はキーと値の２つの部分で構成されますキーは新しいAttributedStringKey プロトコルに準拠した型ですどのようなタイプの値が必要なのかまたアーカイブの名前を定義しますこのキーは他のプロトコルに準拠して値のエンコードやデコード方法をカスタマイズできます AttributedStringの範囲を定義して色を付けたいとしますこのレインボーエフェクトにはプレーンファンエクストリームの３つのレベルがありますその値を表すためにenumを使用し名前をrainbowに設定しますタイプと名前を定義することがこのプロトコルの唯一の要件ですこの属性をCodableにしてエンコードされた AttributedStringの一部にします Codable適合性を追加するだけです最後にレインボーレベルをローカライズされた文字列の一部にします文字列のどこにあってもどんな言語でも正しい部分に適用できるのですオプトインするためのプロトコル適合性が必要です属性がMarkdownデコード可能であると言うことは Markdownから直接デコードして AttributedStringに挿入できますその値がCodableであることだけが必要です次にMarkdownのカスタム属性構文を見てみましょう最初の例ではリンクへの参照がありますリンクテキストを角括弧で囲みリンク先のURLを括弧で囲みます２つ目の例では画像への参照があります感嘆符で始まり角括弧で画像の説明を括弧で画像のソースを表していますこの最初の２つの例はMarkdownでは一般的です３つ目の例ではカスタム属性の構文を示していますキャレットで始まり角括弧でテキストを括弧で属性を表します属性はJSON 5で表されます JSON 5はJSONとの互換性があり引用符のないキーやコメントその他の機能が使用できますこのように人に易しい文字列との相性が良いのですまたFoundationのもう１つのJSON APIに JSON 5のサポートを追加しましたカスタム属性はJSONを使用しているため JSONDecoderでデコードできるものは自動的に新しいカスタムMarkdown構文に対応しますここでは単一の属性文字列と数値の２つの属性そして複数のプロパティを持つ単一の属性がありますここではMarkdownの名前をどのように Swiftのタイプに接続するかという追加要素がありますその部分をアトリビュートスコープといいますスコープは属性キーのグループですスコープはJSONやMarkdownからデコードする際にどの属性を見つけるのかその名前やデコード方法を教えてくれるので便利です Foundation UIKit AppKit SwiftUIにそれぞれスコープを定義します独自のスコープを定義することもできますカフェAppのスコープを定義しましょうスコープをAttributeScopesに入れ子にして AttributeScopeプロトコルに適合させますあとはスコープ内の属性を letでリストアップするだけですここまではRainbowAttributeだけです次にSwiftUIのスコープを私たちのスコープに入れますそうすると私たちの属性に加えそれらすべての属性を許容しますスコープは再帰的にネストするので Foundationの属性も含まれます新しいスコープにプロパティを定義するのに便利ですスコープを引数とする関数でキーパス構文を使用できます最後にローカライズされたAttributedStringをカスタムMarkdownから読み込むことができますアーカイブやNSAttributedStringへの変換などのスコープ機能も備えておりすべてのステップで動作をカスタマイズできますカフェAppの最初の画面ではタイトルにカスタムのレインボー属性が表示されていますローカライズされた文字列がMarkdownから AttributedStringに変換された後属性を見つけ文字列の範囲だけに効果を適用します
この属性はローカライズされた文字列ファイルから来るのでスペイン語などカフェがサポートするすべての言語で正しく動作しますまだまだこれからですけどね全く新しいFormatterAPIもあります Formatterも前からあるFoundationの機能です数字や日付時刻などのデータをローカライズされた文字列に変換する役割を担っています Formatterはかなりの量の設定データに支えられるのでキャッシュして再利用するのはよくあるパターンですしかしAppはさまざまなコードで構成されています formatterをすべての機種で共有することが意味があるとは限りませんまた日付や時刻の読み方は人によって様々で Appの作者としてはデザインに合った方法でデータを表示したいのでエッジケースが多く発生します今年はFormatter APIを見直しパフォーマンスとユーザビリティを向上しましたつまり新しいAPIはフォーマット重視です Earthquakesのコードを見てみましょうキャッシュパターンの動作が確認できます２段階のプロセスがありますまずformatterの作成と設定を行います次にformatterに日付を加え文字列を取得します簡単でしょう？まず独自の日付formatterを作成する必要性をなくしますこれがキャッシュされる必要だと忘れがちでテーブルのすべてのセルに同じformatterを作り直すことになっていました続いてフォーマットのステップです日付をformatterに渡すのではなく日付そのものを使ってみますもうたった１行のコードです好みにフォーマットを指定して終わりですこの数値のフォーマットについて詳しく説明しますコードは多くありませんが複雑な部分があり注意すべき落とし穴がいくつかあります引数が浮動小数点数でない場合ここでは全く間違った出力が得られます浮動小数点数をフォーマットするための特殊な構文や単なる文字列定数である修飾子のセットに注意する必要がありますこのコードは理解しやすくメンテナンスしやすく読みやすいはずですこれはSwiftの正規関数を使用して数値のフォーマットを正確に指定しますオートコンプリートやタイプセーフも実現しますこの新しいアプローチを Foundationの10種類のformatterに適用しましたインターフェイスを整理してシンプルにしよくある落とし穴を回避するため変更を加えさらに多くの新機能を追加しました代表的な書式である日付と数値について詳しく紹介します日付のフォーマットとはカレンダーとタイムゾーンを使って時間のポイントを人が理解できる日付に変換することですさらに“日付をどのように見せたいか” という人それぞれの好みもすべて考慮していますそのような環境をロケールと呼びます日付をフォーマットするために必要な短いコードを見てみましょうまずDate.nowを使って現在の時刻を取得します次にフォーマットされた関数を呼び出しますこれだけですもちろん先ほどのように日付の書式設定には選択肢が多くありますではこれを少し広げてみます
フォーマット機能では日付または時刻のみを表示する設定が可能ですそのどちらもいくつかの選択肢から選べますこの新しいフォーマットAPIの重要な目標は正しいフォーマットを作成するためにコンパイル時にできるだけ支援を提供することですマジックストリング値を使ったフォーマットは通常の環境では正しく見えるのに年末のようなエッジケースでは全く間違った値を生成するという落とし穴がありますここにもデフォルトのフォーマットがありますこれは日付と時刻のスタイルを求める短いバージョンで次のようなものです引数なしシンプルスタイルバージョンともにデフォルトのフォーマットを選んでいますが日付をカスタマイズしたいのであれば気になるフィールドを追加していくだけですこの例ではスタイルにフィールドを追加してフォーマットを構築しています年月日だけにします時分秒を入れることもできます出力形式はユーザーのロケールに合わせて自動的に調整されますこれらのフィールドも設定可能ですこの場合月をワイドフォーマットに変更すると月名が略されずに表示されます日付の一部をフォーマットすることも簡単にできますここでは平日のみを取得します日付も様々なスタイルにフォーマットできますここではISO8601形式とISO8601を選択していますが年月日のみダッシュで区切っていますこれらの例でフォーマットのパターンが明確になりますまずフォーマットしたい値を入力します format関数を呼び出し引数がそのスタイルですタイプごとに複数のスタイルがある場合もあります例えばDateはdateTimeとISO8601の両方ですこのスタイルはデフォルト設定で使用することもカスタマイズもできますこのフォーマットAPIはフィールドのリストを指定して動作しますが追加オプションもあります提供するフィールドの順序は関係ありません各フィールドは最終出力のどこかに含まれるべき値を formatterに伝えるだけです APIの最も短いバージョンつまり引数がないものやスタイル名だけのものはデフォルトを選択しますそこにフィールドを追加していくと出力がカスタマイズされ表示するものだけが反映されるようになります
２つの日付を相対的にフォーマットするための新しいAPIもありますこちらが例です
まず範囲内の２つの日付をフォーマットします２つの日付では通常のSwiftの範囲構文を使用することができますフォーマットの範囲では単一の日付同様日付と時刻の表示を設定できますこの範囲は期間コンポーネントまたは今を基準とした単一の日付としてフォーマットできますフォーマットのもう一つの新機能は属性付き出力ですこれによりユーザーの好みに合わせフォーマットされた値の特定の部分を再配置後に formatterがどこに置いたか見つけることができます AttributedStringを使用していますフォーマットされた出力のスタイリングの適用はよく見られます watchOSでは多くのコンプリケーションがフォーマットされた文字列です Apple Watchはパーソナルデバイスなのでユーザーの好みを考慮することは大切ですが日付の一部をユーザーの好みの色にするなどある種のデザイン言語を適用したいところでもありますこれをSwiftUIで設定するのは楽しいことですデモで見てみましょう次の無料コーヒーの時間を表示するカフェAppの開始点がありますフォーマットされた日付を表示するだけの SwiftUIビューを使っています
SwiftUIのプレビューでコントロールできるようにフォーマットにロケールを設定しています
なかなか良いですがもう少しカスタマイズしたいですね私のAppに合わせてもう少し具体的に説明しましょう必要なのは分時間そして平日だけですいいですねでは色を足しましょうリターンタイプをAttributedStringに変更して属性付きの出力を求めます
次にAttributeContainerを使用します文字列内の特定の文字に関連付けられていない属性を保持することができます日付フォーマットが出力する weekday属性用を作成します曜日を含む文字列の範囲に設定されます
次に設定したいカラー属性のコンテナを作ります
最後にAttributedString関数を使って１つ目のコンテナにある属性と一致する属性を２つ目のコンテナにある値で AttributedStringに置き換えます
AttributedStringは値型であるため mutating functionを置き換えるのでletをvarに
いいですねロケールすべてに適用されますプレビューに少し追加してダブルチェックします
これらのロケールのフォーマットされた日付のどこにあっても平日がオレンジ色ですさらにformatter APIについて学んでいきましょう日付を文字列に変換しましたが今度は文字列を日付に変換する方法を説明します日付がstrategy引数を取るイニシャライザを持ちます strategyはパーサーに入力でどのフィールドを期待するかを伝えるために使われます日付の場合フォーマットは一種のstrategyですこれは出力を表示と同時に新しい日付を入力できるテキストフィールドのように日付をラウンドトリップさせる場合に便利ですラウンドトリップの例ですパースが投げられることわかります入力によってはパースが失敗することがあるからです strategyによっては高度なパースオプションがありますここでは固定フォーマットを解析していますこれは日付フォーマットがサーバーから受信したものである場合に便利ですフォーマット文字列でstrategyを初期化しますマジックナンバーを使うのではなく文字列補間を使いますここでは年月日形式の文字列を想定しています各補間はフィールドごとに明確に識別されておりどんなフォーマットを期待するか示していますここでとてもいいのがオートコンプリートです別の日のフォーマットを使用したい場合はオートコンプリートがオプションを表示しそれぞれの意味を説明してくれます年号のパースに何個のYを使うか考える必要はありません続いて数値です数値フォーマットは整数や浮動小数点の値を人が読めるように変換します他のフォーマット同様数字の表示方法の好みが考慮されますこれには使用する数字の種類や数字をグループ化する文字などが含まれます日付のフォーマット同様追加パラメータは不要で出力を簡単に得られます
オプションやアウトプットには様々な種類がありますここではパーセンテージ科学的記数法および通貨を表示します最後にフォーマットをまとめてみましょうリストの書式設定が単なる配列の書式設定になりましたこのメンバースタイル引数は配列の各要素のフォーマットスタイルを指定しますこれは数字なのでパーセンテージで表しますどのユーザーのロケールも正しい出力が得られます値を直接フォーマットすることに重点を置いてきました TextFieldにフォーマットスタイルもサポートしますフォーマットスタイルは値の種類のtype情報を持っているのでここではレシートのチップを読み易くかつ安全な構文で表現することができますカフェAppを見てフォーマットが表示される場所の数を確認してみましょうリスト形式で表記しています価格には通貨形式を採用しています数量は数値フォーマットを使用し注文ボタンのカウントをローカライズするためにも使用していますここで忘れてはならないのがいつも隅にある日付のフォーマットですフォーマットされた出力はどこにでもありますがこの新しいAPIを使えば簡単に楽しく使えますローカライズされた文字列やformatterについては他にもたくさんのリソースがあります “Localize yourSwiftUI App”と “Streamline yourlocalized strings”もこのテーマですのでご覧ください次にオート･グラマー･アグリーメントについて説明しますスペイン語などにローカライズする場合自然な翻訳には限界がありぎこちない文章になることもありましたこれらの言語では異なる品詞間での性や複数形の一致を実現するための変換が必要でユーザーが好む呼びかけ語を知る必要もあります英語にもこの機能があり単数形と複数形の形が異なる名詞を識別します多くの言語専門用語を投げかけたので例を見てみましょうカフェAppではフードサイズ数量を選ぶことができますスモールサイズのサラダを１つ選びました
友人も一緒に食べることになり追加して２つにします２つになったので“salad”が複数形になりましたこれがアグリーメントですつまり文章内の単語がお互いにマッチしていなければならないということです英語では複数化による単語の修正はよくあるアグリーメントの１つですではAppをスペイン語に切り替えますスモールサイズのサラダを１つ選びます
友人分を追加すると英語では名詞が複数形ですがスペイン語の場合は形容詞と名詞両方が複数形にならなければなりませんそのため“ensaladapequeña”ではなく “ensaladas pequeñas”になります次はドリンクですここでは複数形だけでなく文法上の性も修正する必要があります “jugo”（ジュース）は男性名詞です形容詞の修正も必要ですこのようにテキストを正しくローカライズする組み合わせでつまづきますフードサイズ数量それぞれ組み合わせごとに異なる文字列が必要になりますコードではこのようになりがちですアイテムごとに切り替えサイズごとに切り替えとなってしまいますまたstringsdictファイルもあり数に合わせて正しく複数形にしてくれますキーボードのサジェスト機能と同じ技術を利用してこれらのケースに簡単に対応できる新しいAPIを開発しましたこの機能がオート･グラマー･アグリーメントですローカライズされた文字列を自動で修正し正しい文法にしてくれますこれでコードがシンプルになります１つの文字列に数量サイズフードをまとめられますオート･グラマー･アグリーメントは inflectionという処理で文字列を修正します細かく見てみましょうどの文字列に修正が必要か見つけます運良くSwiftがそれをやってくれます MarkdownのAttributedStringとカスタム属性ですこの文字列にその構文を使いフードサイズ数に inflect属性を適用します値はtrueですこのプロジェクトのローカリゼーションをエクスポートすると注釈付きの文字列とフードやサイズなどソースコード内の他のローカライズを含む文字列ファイルが得られます中南米のスペイン語の文字列ですスペイン語では形容詞が名詞の前に来るのでローカリゼーションでは引数の並べ替え構文 %1 %3 %2が使用されました文字列のこの領域をinflectionするためのカスタム属性構文を保持しフードやサイズの翻訳を提供しますあとは自動で修正してくれます言語によってはローカライズされたテキストの単語間だけでなくテキストと読み手との間にも一致が見られますこの機能はそれにも役立ちます例えばこのNotesのウェルカム画面を見てみましょう英語では“Welcometo Notes”ですスペイン語では“Te damosla bienvenida a Notas” となりますスペイン語でも英語と同じ使い勝手になるようにしたいしかしスペイン語の“bienvenido”は読み手が好む呼びかけ語と一致しなくてはなりませんこの単語は選択肢の１つでありテキストに影響します正しい呼びかけ語を使うことでよりユーザーに寄り添うものとなります今年のリリースでスペイン語を使う方は呼びかけ語を指定できるようになりました言語と地域の設定で新しく呼びかけ語のオプションがありますそのオプションから好みの呼びかけ語を選ぶとすべてのAppで使えるようになります女性で設定するとこのような画面になりますこちらは男性の場合です特に指定がない場合はオリジナルの文字列が使用されます先ほどと同じinflection属性がローカライズされた文字列にも使われています今回の“welcome to”では“bienvenido”という単語にinflection属性を適用します英語の文字列を変更する必要はありません inflection属性も追加できますユーザーの好みに関する情報がない場合にエンジンが使用する代替文字列です今年はスペイン語と英語のオート･アグリーメントに対応しています Notesのウェルカム画面などOS全体で採用しています Appにも適用できます必要なコードの変更は異なる文字列を選ぶため多くのロジックを削除するだけです inflectionの指示はローカライズされた文字列に含まれるためその言語での文字列の表示方法をより細かくコントロールできますカフェAppでのオート･グラマー･アグリーメントの動作を見てみましょうカフェAppを英語で起動しますピザを注文しますラージサイズを１つ注文しましょうボタンのテキストが“0 large pizzas”から “1 large pizza”に変わりました自動で修正されました２にするとまた修正されます１つにしておきます画面の下のボタンに注文数が反映されますドリンクも注文してみましょうスモールを１つ注文します “item”が“items”に変わりました文字列が自動で修正されました精算します
レシートです注文内容と合計金額が表示されます下部にはAttributedStringでカスタマイズしたメッセージが表示されます Xcodeに戻りソースを見てみましょう最初にフードのviewです
これはサイズを選ぶviewですサイズを追加してみますフードの種類サイズ数に応じた文字列を追加せずスペイン語に合わせてローカライズされた文字列を１つ追加するだけで済むことがわかりますこの行はリストですモデルオブジェクトからきています見てみましょう
スモールとラージサイズがあるのでお腹ペコペコな人のために “huge”（特大）を追加しましょうローカライズの文字列も併せ caseを追加します
あとは値段を追加するだけです今回のデモではイニシャライザに入れました
viewをもう一度見てみましょう
これがプレビューです英語の文字列はありますがスペイン語も必要です新しい文字列の生成はコンパイラを使い “huge”のローカライズされた文字列を見つけます ProductからExportLocalizationsを選びスペイン語の文字列を保存します
ではスペイン語訳を追加しましょう
新しい文字列を検索しスペイン語訳を入力します
そしてAppにインポートします
スペイン語でAppを起動してみましょう ProductからSchemeそしてEdit Schemeを選択 Optionsでテストしたい言語を選択し
そして起動しますヘッダーでスペイン語だとわかりますね注文してみましょうまずはサラダから数を変えるとボタンも変わりますね特大サイズも正しく複数形になりました “ensalada”の文法上の性にも対応しており１つの文字列でカバーしています今年 Foundationには多くの優れた機能が加わり今日にでも皆さんのAppで利用できます AttributedStringは文字列の範囲にキーと値のペアを追加するための高速で使いやすい Swift初のインターフェースを提供しますテキストでSwiftUIと一緒に使うことができローカライズされた文字列でMarkdownを使えます新しいFormatter APIフォーマットに重点を置きコードを簡素化しパフォーマンスを上げました App内のデータすべてで使用できるフォーマットです最後はオート･グラマー･アグリーメントですローカライズされた文字列を知性的に修正し文法上の性数呼びかけ語に一致するようにします皆さんに気に入っていただければ幸いです皆さんのAppで確認できる日を楽しみにしていますありがとうございました [音楽]

func attributedStringBasics(important: Bool) {
    var thanks = AttributedString("Thank you!")
    thanks.font = .body.bold()

    var website = AttributedString("Please visit our website.")
    website.font = .body.italic()
    website.link = URL(string: "http://www.example.com")

    var container = AttributeContainer()
    if important {
        container.foregroundColor = .red
        container.underlineColor = .primary
    } else {
        container.foregroundColor = .primary
    }

    thanks.mergeAttributes(container)
    website.mergeAttributes(container)

    print(thanks)
    print(website)
}

4:24 - Attributed String Characters

func attributedStringCharacters() {
    var message = AttributedString(localized: "Thank you! _Please visit our [website](http://www.example.com)._")
    let characterView = message.characters
    for i in characterView.indices where characterView[i].isPunctuation {
        message[i..<characterView.index(after: i)].foregroundColor = .orange
    }

    print(message)
}

5:12 - Attributed String Runs (Part 1)

func attributedStringRuns() {
    let message = AttributedString(localized: "Thank you! _Please visit our [website](http://www.example.com)._")
    let runCount = message.runs.count
    // runCount is 4
    print(runCount)

    let firstRun = message.runs.first!
    let firstString = String(message.characters[firstRun.range])
    // firstString is "Thank you!"
    print(firstString)
}

5:49 - Attributed String Runs (Part 2)

func attributedStringRuns2() {
    let message = AttributedString(localized: "Thank you! _Please visit our [website](http://www.example.com)._")

    let linkRunCount = message.runs[\.link].count
    // linkRunCount is 3
    print(linkRunCount)

    var insecureLinks: [URL] = []
    for (value, range) in message.runs[\.link] {
        if let v = value, v.scheme != "https" {
            insecureLinks.append(v)
        }
    }
    // insecureLinks is [http://www.example.com]
    print(insecureLinks)
}

6:36 - Attributed String Mutation

func attributedStringMutation() {
    var message = AttributedString(localized: "Thank you! _Please visit our [website](http://www.example.com)._")

    if let range = message.range(of: "visit") {
        message[range].font = .body.italic().bold()
        message.characters.replaceSubrange(range, with: "surf")
    }

    print(message)
}

7:29 - Localized Strings

func prompt(for document: String) -> String {
    String(localized: "Would you like to save the document “\(document)”?")
}

func attributedPrompt(for document: String) -> AttributedString {
    AttributedString(localized: "Would you like to save the document “\(document)”?")
}

9:34 - Codable Attributed Strings

struct FoodItem: Codable {
    // Placeholder type to demonstrate concept
    var name: String
}

struct Receipt: Codable {
    var items: [FoodItem]
    var thankYouMessage: AttributedString
}

func codableBasics() {
    let message = AttributedString(localized: "Thank you! _Please visit our [website](http://www.example.com)._")
    let receipt = Receipt(items: [FoodItem(name: "Juice")], thankYouMessage: message)

    let encoded = try! JSONEncoder().encode(receipt)
    let decodedReceipt = try! JSONDecoder().decode(Receipt.self, from: encoded)

    print("\(decodedReceipt.thankYouMessage)")
}

10:42 - Markdown Decodable Attribute

enum RainbowAttribute : CodableAttributedStringKey, MarkdownDecodableAttributedStringKey {
    enum Value : String, Codable {
        case plain
        case fun
        case extreme
    }

    public static var name = "rainbow"
}

11:30 - Custom Markdown Syntax

This text contains [a link](http://www.example.com).

This text contains ![an image](http://www.example.com/my_image.gif).

This text contains ^[an attribute](rainbow: 'extreme').

12:27 - Custom Markdown Attributes

This text contains ^[an attribute](rainbow: 'extreme').

This text contains ^[two attributes](rainbow: 'extreme', otherValue: 42).

This text contains ^[an attribute with 2 properties](someStuff: {key: true, key2: false}).

13:15 - Attribute Scopes

extension AttributeScopes {
    struct CaffeAppAttributes : AttributeScope {
        let rainbow: RainbowAttribute

        let swiftUI: SwiftUIAttributes
    }

    var caffeApp: CaffeAppAttributes.Type { CaffeAppAttributes.self }
}

func customAttributesFromMarkdown() {
    let header = AttributedString(localized: "^[Fast & Delicious](rainbow: 'extreme') Food", including: \.caffeApp)

    print(header)
}

17:28 - Formatting Dates

func formattingDates() {
    // Note: This will use your current date & time plus current locale. Example output is for en_US locale.
    let date = Date.now

    let formatted = date.formatted()
    // example: "6/7/2021, 9:42 AM"
    print(formatted)

    let onlyDate = date.formatted(date: .numeric, time: .omitted)
    // example: "6/7/2021"
    print(onlyDate)

    let onlyTime = date.formatted(date: .omitted, time: .shortened)
    // example: "9:42 AM"
    print(onlyTime)
}

18:16 - Formatting Dates With Styles

func formattingDatesWithStyles() {
    // Note: This will use your current date & time plus current locale. Example output is for en_US locale.
    let date = Date.now

    let formatted = date.formatted(.dateTime)
    // example: "6/7/2021, 9:42 AM"
    print(formatted)
}

18:36 - Formatting Dates - More Examples

func formattingDatesMoreExamples() {
    // Note: This will use your current date & time plus current locale. Example output is for en_US locale.
    let date = Date.now

    let formatted = date.formatted(.dateTime.year().day().month())
    // example: "Jun 7, 2021"
    print(formatted)

    let formattedWide = date.formatted(.dateTime.year().day().month(.wide))
    // example: "June 7, 2021"
    print(formattedWide)

    let formattedWeekday = date.formatted(.dateTime.weekday(.wide))
    // example: "Monday"
    print(formattedWeekday)

    let logFormat = date.formatted(.iso8601)
    // example: "20210607T164200Z"
    print(logFormat)

    let fileNameFormat = date.formatted(.iso8601.year().month().day().dateSeparator(.dash))
    // example: "2021-06-07"
    print(fileNameFormat)
}

20:30 - Formatting Intervals

func formattingIntervals() {
    // Note: This will use your current date & time plus current locale. Example output is for en_US locale.
    let now = Date.now
    // Note on time calculations: This represents the absolute point in time 5000 seconds from now. For calculations that are in terms of hours, days, etc., please use Calendar API.
    let later = now + TimeInterval(5000)

    let range = (now..<later).formatted()
    // example: "6/7/21, 9:42 – 11:05 AM"
    print(range)

    let noDate = (now..<later).formatted(date: .omitted, time: .complete)
    // example: "9:42:00 AM PDT – 11:05:20 AM PDT"
    print(noDate)

    let timeDuration = (now..<later).formatted(.timeDuration)
    // example: "1:23:20"
    print(timeDuration)

    let components = (now..<later).formatted(.components(style: .wide))
    // example: "1 hour, 23 minutes, 20 seconds"
    print(components)

    let relative = later.formatted(.relative(presentation: .named, unitsStyle: .wide))
    // example: "in 1 hour"
    print(relative)
}

21:39 - Demo - SwiftUI and AttributedString

import SwiftUI

struct ContentView: View {
    @State var date = Date.now
    @Environment(\.locale) var locale

    var dateString : AttributedString {
        var str = date.formatted(.dateTime
                                    .minute()
                                    .hour()
                                    .weekday()
                                    .locale(locale)
                                    .attributed)

        let weekday = AttributeContainer
            .dateField(.weekday)

        let color = AttributeContainer
            .foregroundColor(.orange)

        str.replaceAttributes(weekday, with: color)

        return str
    }


    var body: some View {
        VStack {
            Text("Next free coffee")
            Text(dateString).font(.title2)
        }
        .multilineTextAlignment(.center)
    }
}

struct ContentView_Previews: PreviewProvider {
    static var previews: some View {
        ContentView()
            .environment(\.locale, Locale(identifier: "en_US"))
        ContentView()
            .environment(\.locale, Locale(identifier: "he_IL"))
        ContentView()
            .environment(\.locale, Locale(identifier: "es_ES"))
    }
}

23:53 - Parsing Dates

func parsingDates() {
    let date = Date.now

    let format = Date.FormatStyle().year().day().month()
    let formatted = date.formatted(format)
    // example: "Jun 7, 2021"
    print(formatted)

    if let date = try? Date(formatted, strategy: format) {
        // example: 2021-06-07 07:00:00 +0000
        print(date)
    }
}

24:23 - Parsing Dates - Strategies

func parsingDatesStrategies() {
    let strategy = Date.ParseStrategy(
        format: "\(year: .defaultDigits)-\(month: .twoDigits)-\(day: .twoDigits)",
        timeZone: TimeZone.current)

    if let date = try? Date("2021-06-07", strategy: strategy) {
        // date is 2021-06-07 07:00:00 +0000
        print(date)
    }
}

25:30 - Formatting Numbers

func formattingNumbers() {
    // Note: This will use your current locale. Example output is for en_US locale.
    let value = 12345

    let formatted = value.formatted()
    // formatted is "12,345"
    print(formatted)
}

25:36 - Formatting Numbers With Styles

func formattingNumbersWithStyles() {
    // Note: This will use your current locale. Example output is for en_US locale.
    let percent = 25
    let percentFormatted = percent.formatted(.percent)
    // percentFormatted is "25%"
    print(percentFormatted)

    let scientific = 42e9
    let scientificFormatted = scientific.formatted(.number.notation(.scientific))
    // scientificFormatted is "4.2E10"
    print(scientificFormatted)

    let price = 29
    let priceFormatted = price.formatted(.currency(code: "usd"))
    // priceFormatted is "$29.00"
    print(priceFormatted)
}

25:47 - Formatting Lists

func formattingLists() {
    // Note: This will use your current locale. Example output is for en_US locale.
    let list = [25, 50, 75].formatted(.list(memberStyle: .percent, type: .or))
    // list is "25%, 50%, or 75%"
    print(list)
}

26:05 - Receipt Tip View

struct ReceiptTipView: View {
    @State var tip = 0.15

    var body: some View {
        HStack {
            Text("Tip")
            Spacer()
            TextField("Amount",
                      value: $tip,
                      format: .percent)
        }
    }
}

29:41 - Automatic Grammar Agreement

func addToOrderEnglish() {
    // Note: This will use your current locale. Example output is for en_US locale.
    let quantity = 2
    let size = "large"
    let food = "salad"

    let message = AttributedString(localized: "Add ^[\(quantity) \(size) \(food)](inflect: true) to your order")
    print(message)
}

特定のトピックをお探しの場合は、上にトピックを入力すると、関連するトピックにすばやく移動できます。

クエリの送信中にエラーが発生しました。インターネット接続を確認して、もう一度お試しください。

リソース

関連ビデオ

WWDC23

WWDC22

WWDC21