ウィジェットの中で

ウィジェットは、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'),
)

関連項目