言語

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('日本語'),
);

ルール

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 から来ます (メッセージと言語 を参照)。

関連項目