言語
spring.flutter.navigation.languages は各言語に独自のアドレスを与えます。最初の言語がデフォルトでプレフィックスを持たず、他の言語は /<language> の下に置かれます。/ja/catalog は、アプリのロケールを日本語にして /catalog の画面を開きます。そのため context.message、画面のタイトル、Flutter 自身のウィジェットが追従します。
使う理由
Web では言語はアドレスの一部であるべきです。日本語で共有されたリンクは日本語で開き、検索エンジンは各言語のページを掲載し、戻るボタンは元の言語に戻ります。アプリ自身のコードはプレフィックスなしでパスを書き、現在の言語は保たれるため、どの画面もそれを知る必要がありません。
例
# lib/resources/application.yml
spring:
flutter:
navigation:
languages: [en, ja]
// 現在の言語は保たれる: 英語では /catalog、日本語では /ja/catalog。
context.route.go('/catalog');
// 同じ画面を別の言語で表示するメニュー。
TextButton(
onPressed: () => context.route.switchLanguage('ja'),
child: const Text('日本語'),
);
ルール
/ja/catalogは、アプリのロケールを日本語にして/catalogの画面を開きます。context.message、@ScreenRoute(title: '#{key}')、Flutter 自身のウィジェットが追従します。- アプリのコードはプレフィックスなしでパスを書きます (
go('/catalog'))。現在の言語は保たれ、ブラウザーのバーには/ja/catalogが表示されます。プレフィックス付きのパス (go('/ja/catalog')) は言語を変えます。 - プラットフォームからのプレフィックスのないアドレス (ブラウザーのバー、リンク) は、デフォルトの言語のものです。
context.route.languageは現在の言語です。context.route.switchLanguage('en')は同じ画面を別の言語で表示します。その言語のために宣言したフォント (spring.flutter.fonts.families.<family>.languages) は、テキストが変わる前に読み込まれます。最初のアドレスの言語は、最初のフレームの前にそれを持ちます (アセットとフォントを見てください)。- Markdown の画面 (
content:) は、/jaの下ではファイルの隣の<file>.ja.mdを、翻訳がなければデフォルトのファイルを表示します。 - ビルドは、検索エンジンのためのページを、
hreflangの代替リンク付きですべての言語で書き出します (検索エンジン向けのページ を参照)。
LanguageChangedEvent
ナビゲーションは、アドレスまたは switchLanguage によって言語が切り替わると LanguageChangedEvent を発行します。
// 新しい言語のカタログを読み込む。
@Component()
class CatalogLanguage {
CatalogLanguage(this.catalog);
final Catalog catalog;
@EventListener()
void changed(LanguageChangedEvent event) => catalog.reload(event.to);
}
| フィールド | 意味 |
|---|---|
from |
以前の言語。最初の言語が設定される前は null |
to |
現在の言語 |
画面のテキストもそれとともに変わります。Flutter スターターの ThemeText は、テーマの方法 (motion.text-change) でそれらを変えます。
プロパティ
| キー | 型 | デフォルト | 意味 |
|---|---|---|---|
spring.flutter.navigation.languages |
言語タグのリスト | なし: 一つの言語、プレフィックスなし | 独自のアドレスを持つ言語。デフォルトを最初に書く |
spring.flutter.app.locales と異なり、このキーは本当のリストです。YAML では [en, ja]、.properties では en,ja です。アプリのロケールは、引き続きメッセージファイルか spring.flutter.app.locales から来ます (メッセージと言語 を参照)。