
# コレクション

`List`、`Set`、`Map`、`Queue` を持つ `@Signal` フィールドは、その場での変化を読み手に伝えるコレクションとして渡されます。

## 使う理由

リストが代入されることはまれです。追加され、並べ替えられ、空にされます。代入だけが変化だとすると、すべてのメソッドが `items = [...items]` で終わることになり、一つ忘れると画面が古いままになります。

## 例

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

void add(Book book) => items.add(book);     // 代入なしで伝えられる
```

## 何が変化か

- **その場での変化**: `items.add(book)`、`items.clear()`、並べ替え。Bean の外からでも同じです: `basket.items.add(book)`。
- **別のコレクションの代入**:

```dart
void remove(String title) => items = [
  for (final book in items)
    if (book.title != title) book,
];
```

- **ゲッターが渡したものを代入し直す**: `items = items..sort()`。フィールドは同じリストを保ちます。

その場での一つの変化は、いくつの要素が動いても、一度だけ伝えられます。`Set` は、それを実際に変えたものだけを伝えます。すでにある要素の追加は、誰にも伝えられません。

## 変わらないもの

フィールドはコレクション自体を保ち、その型は書かれたとおりのままです。`basket.items` は `List<Book>` です。

## 関連項目

- [フィールドと計算された値](fields-and-computed.md)
- [エフェクト](effects.md): メソッドは一つの変化
