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

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

## 使う理由

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

## 例

```dart
@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 なメンバーはそこからオーバーライドできないからです。そうでなければ、ビルドはメンバーを示して失敗します ([ビルドがチェックするもの](build-checks.md) を参照)。

## @Signal

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

- フィールドは普通のフィールドのままです。ラッパー型も `.value` もありません。
- 変化とは代入です。`List`、`Set`、`Map`、`Queue` では、その場での変化も変化です ([コレクション](collections.md) を参照)。
- そこにある値と等しい値を代入しても、誰にも伝えられません。
- 誰も読んでいないフィールドは、まだ追跡されていません。最初に読まれたときに、フィールド自体から写し取られます。
- `@Signal(hidden: true)` は、値をデバッグタブとログに出しません ([デバッグタブとログ](debug-tab.md) を参照)。

## @Computed

| 付ける場所 | ルール |
|---|---|
| コンポーネントのゲッター、またはパラメーターのないメソッド | public、static でない、値を返す |

```dart
@Computed()
bool isEmpty() => items.isEmpty;
```

- 最初に読まれたときに計算され、その後は、読んだ `@Signal` フィールドや別の計算された値が変わった後にだけ、もう一度計算されます。
- 変化なしにもう一度読むと、同じ値を返し、計算し直されません。
- `Future` や `Stream` を返すゲッターは、非同期の状態です。[非同期の状態](async-state.md) を参照してください。

## 関連項目

- [コレクション](collections.md)
- [エフェクト](effects.md)
- [ウィジェットの中で](widgets.md)
- [ビルドがチェックするもの](build-checks.md)
