画面やブランチごとの Bean
二つの Bean のスコープがナビゲーションに従います。route の Bean は、その画面が開くときに作られ、閉じるときに、その退場アニメーションの後で破棄されます。branch の Bean は、そのブランチを初めて訪れたときに作られ、シェルが閉じるとき (タブを離れる、ログアウト) に破棄されます。
使う理由
フォームの状態はその画面に属します。画面が開くたびに新しく、閉じると消えるべきです。タブの状態 (検索、フィルター) はタブに属します。シングルトンにすると訪問から次の訪問へ漏れ、State のフィールドにするとサービスと共有できません。スコープ付きの Bean はその両方を満たします。他の Bean と同じく注入され、画面やタブと同じだけ短命です。
例
// 本の編集画面が開くたびに新しいフォーム。
@ChangeNotifierComponent()
@Scope(NavigationScopes.route)
class BookForm {
String title = '';
void rename(String value) => title = value;
}
// カタログタブの検索。ユーザーがタブを切り替えても保たれる。
@ChangeNotifierComponent()
@Scope(NavigationScopes.branch)
class CatalogSearch {
String query = '';
void search(String value) => query = value;
}
@ScreenRoute('/catalog/books/{isbn}/edit')
class EditBookPage extends SpringStatelessWidget<(BookForm,)> {
const EditBookPage({super.key});
@override
Widget build(BuildContext context) {
final (form,) = beans; // この画面自身のフォーム
return TextField(onChanged: form.rename);
}
}
スコープ
| スコープ | 作られる時 | 破棄される時 |
|---|---|---|
NavigationScopes.route ('route') |
その画面が開くとき | 画面が閉じるとき、その退場アニメーションの後 |
NavigationScopes.branch ('branch') |
そのブランチを初めて訪れたとき | シェルが閉じるとき |
ウィジェットからの検索は、そのウィジェットの画面とブランチの Bean を受け取ります。スタック上の同じルートの二つの画面は、それぞれ独自のものを持ちます。それ以外の検索 (シングルトン、サービス) は、一番上の画面のものを受け取ります。スターターは、すべての画面の周りの BeanLookupScope でこれを行います。
Spring (Java) との対応
Spring Web には request と session のスコープがあります。これらは画面とタブについての同じ考え方です。