ウィジェットの中で
ウィジェットは、build が読んだ状態のために再構築され、それ以外では再構築されません。Spring のウィジェットは自分の build を追跡します。通常のウィジェットは Watch を使います。AsyncView は非同期の値を表示します。
使う理由
Bean 全体のための一つの通知では、バスケットを聞くすべてのウィジェットが、バスケットの何が変わっても再構築されます。ここでは、合計を表示するバッジは合計が変わったときに、クーポンを表示するラベルはクーポンが変わったときに再構築されます。
例
class BasketBadge extends SpringStatelessWidget<(Basket,)> {
const BasketBadge({super.key});
@override
Widget build(BuildContext context) {
final (basket,) = beans;
return Text('${basket.total}'); // 合計が変わると再構築される
}
}
Spring のウィジェット
SpringStatelessWidget と SpringState は、自分の build をフィールド単位で追跡します。上のバッジは、total が変わると再構築され、バスケットの他のものが変わっても再構築されません。メソッドの呼び出し (onPressed: basket.clear) は何も読まず、再構築のコストはかかりません。
Spring のウィジェットについては ウィジェットの中の Bean を参照してください。
Watch
通常のウィジェットは Watch を使います。大きな build の中で再構築を小さく保つ方法でもあります。
Watch((context) => Text('${context.bean<Basket>().total}'))
ビルダーが読んだ追跡される状態が変わったときに、そのときだけ再構築されます。一つのメソッドの中の二つの代入は、一度の構築です。画面を去った Watch は、再構築されません。
AsyncView
AsyncView は、非同期の @Computed の値を表示します。そのデータ、読み込み、または失敗です。
AsyncView(
() => context.bean<Catalog>().books,
loading: (context) => const Spinner(),
data: (context, books) => BookList(books),
)
値はビューの中で読まれます (そのため関数です)。そのため、読み込みが進んだときと Future が変わったときに、ビューは自分で再構築されます。その周りのウィジェットは再構築されません。
| パラメーター | 型 | 意味 |
|---|---|---|
| 値 (位置引数) | Future<T> Function() |
Future を与える。AsyncView.stream は Stream<T> Function() を受け取り、Stream の最後のイベントを表示する |
data |
Widget Function(BuildContext, T) |
値を組み立てる。必須 |
loading |
WidgetBuilder? |
最初の読み込みを組み立てる。デフォルトでは何もなし |
error |
Widget Function(BuildContext, Object, StackTrace?)? |
失敗を組み立てる。デフォルトではそのテキスト |
refresh() で値をもう一度求めている間、最後の値は画面に残ります。
AsyncView.stream(
() => catalog.price,
data: (context, price) => Text('$price'),
)