
# 言語

`spring.flutter.navigation.languages` は各言語に独自のアドレスを与えます。最初の言語がデフォルトでプレフィックスを持たず、他の言語は `/<language>` の下に置かれます。`/ja/catalog` は、アプリのロケールを日本語にして `/catalog` の画面を開きます。そのため `context.message`、画面のタイトル、Flutter 自身のウィジェットが追従します。

## 使う理由

Web では言語はアドレスの一部であるべきです。日本語で共有されたリンクは日本語で開き、検索エンジンは各言語のページを掲載し、戻るボタンは元の言語に戻ります。アプリ自身のコードはプレフィックスなしでパスを書き、現在の言語は保たれるため、どの画面もそれを知る必要がありません。

## 例

```yaml
# lib/resources/application.yml
spring:
  flutter:
    navigation:
      languages: [en, ja]
```

```dart
// 現在の言語は保たれる: 英語では /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`) は、テキストが変わる前に読み込まれます。最初のアドレスの言語は、最初のフレームの前にそれを持ちます ([アセットとフォント](../spring-boot-starter-flutter/assets-and-fonts.md#フォント)を見てください)。
- Markdown の画面 (`content:`) は、`/ja` の下ではファイルの隣の `<file>.ja.md` を、翻訳がなければデフォルトのファイルを表示します。
- ビルドは、検索エンジンのためのページを、`hreflang` の代替リンク付きですべての言語で書き出します ([検索エンジン向けのページ](../spring-core-dart-generator/flutter/seo.md) を参照)。

## LanguageChangedEvent

ナビゲーションは、アドレスまたは `switchLanguage` によって言語が切り替わると `LanguageChangedEvent` を発行します。

```dart
// 新しい言語のカタログを読み込む。
@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` から来ます ([メッセージと言語](../spring-boot-starter-flutter/messages.md) を参照)。

## 関連項目

- [メッセージと言語](../spring-boot-starter-flutter/messages.md)
- [Markdown の画面](markdown-screens.md)
- [Web とディープリンク](web-and-deep-links.md)
