コレクション
List、Set、Map、Queue を持つ @Signal フィールドは、その場での変化を読み手に伝えるコレクションとして渡されます。
使う理由
リストが代入されることはまれです。追加され、並べ替えられ、空にされます。代入だけが変化だとすると、すべてのメソッドが items = [...items] で終わることになり、一つ忘れると画面が古いままになります。
例
@Signal()
List<Book> items = [];
void add(Book book) => items.add(book); // 代入なしで伝えられる
何が変化か
- その場での変化:
items.add(book)、items.clear()、並べ替え。Bean の外からでも同じです:basket.items.add(book)。 - 別のコレクションの代入:
void remove(String title) => items = [
for (final book in items)
if (book.title != title) book,
];
- ゲッターが渡したものを代入し直す:
items = items..sort()。フィールドは同じリストを保ちます。
その場での一つの変化は、いくつの要素が動いても、一度だけ伝えられます。Set は、それを実際に変えたものだけを伝えます。すでにある要素の追加は、誰にも伝えられません。
変わらないもの
フィールドはコレクション自体を保ち、その型は書かれたとおりのままです。basket.items は List<Book> です。
関連項目
- フィールドと計算された値
- エフェクト: メソッドは一つの変化