フィールドと計算された値

@Signal() は、変化が追跡されるフィールドを示します。代入されると、それを読んだもの (ウィジェットの build、@Computed の値、@Effect のメソッド) に伝えられます。@Computed() は、他の状態から作られる値を示します。読んだものが変わるまで保持されます。

使う理由

画面の状態は、いくつかのフィールドと、それらから作られる値です。手で書くと、それぞれの値はいつ計算し直すかを知る必要があり、それぞれの読み手はいつ見直すかを知る必要があります。ここでは、どちらも読んだものから決まります。

例

@Component()
class Basket {
  Basket(this.storage);              // 通常のインジェクション

  final BasketStorage storage;

  @Signal()
  List<Book> items = [];

  @Signal()
  String? coupon;

  @Computed()                        // items か coupon が変わるまで保持される
  double get total =>
      items.fold(0.0, (sum, book) => sum + book.price) *
      (coupon == null ? 1 : 0.9);

  void add(Book book) => items.add(book);
  void apply(String code) => coupon = code;
}

アノテーションを付ける場所

アノテーションは、コンポーネントのメンバーのためのものです。コンテナーが作るクラス (@Component、@Service など) です。@Configuration クラスのメンバーのためのものではありません。

メンバーは public でなければなりません。プロキシは別のライブラリに生成され、private なメンバーはそこからオーバーライドできないからです。そうでなければ、ビルドはメンバーを示して失敗します (ビルドがチェックするもの を参照)。

@Signal

付ける場所 ルール
コンポーネントのフィールド public、static でない、final でない

@Computed

付ける場所 ルール
コンポーネントのゲッター、またはパラメーターのないメソッド public、static でない、値を返す
@Computed()
bool isEmpty() => items.isEmpty;

関連項目