フィールドと計算された値
@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 でない |
- フィールドは普通のフィールドのままです。ラッパー型も
.valueもありません。 - 変化とは代入です。
List、Set、Map、Queueでは、その場での変化も変化です (コレクション を参照)。 - そこにある値と等しい値を代入しても、誰にも伝えられません。
- 誰も読んでいないフィールドは、まだ追跡されていません。最初に読まれたときに、フィールド自体から写し取られます。
@Signal(hidden: true)は、値をデバッグタブとログに出しません (デバッグタブとログ を参照)。
@Computed
| 付ける場所 | ルール |
|---|---|
| コンポーネントのゲッター、またはパラメーターのないメソッド | public、static でない、値を返す |
@Computed()
bool isEmpty() => items.isEmpty;
- 最初に読まれたときに計算され、その後は、読んだ
@Signalフィールドや別の計算された値が変わった後にだけ、もう一度計算されます。 - 変化なしにもう一度読むと、同じ値を返し、計算し直されません。
FutureやStreamを返すゲッターは、非同期の状態です。非同期の状態 を参照してください。