できない.dev

useState

別名: useState フック / 状態フック

関数コンポーネントにローカルな状態変数を持たせ、その更新で再レンダリングを引き起こす React 標準フック。

公開: 更新:

定義

useState は、関数コンポーネントに状態変数を追加する React フックである。
const [state, setState] = useState(initial) の形で、現在値と更新関数のペアを返す。

詳細

setState を呼ぶと値が更新され、コンポーネントが再レンダリングされる。
更新はその場では即時反映されず、次のレンダリングで新しい値になる。

直前の状態をもとに更新するときは、setState(prev => prev + 1) のように更新関数を渡す。
初期値は初回レンダリング時にだけ使われる。
重い計算なら、useState(() => compute()) と遅延初期化できる。

よくある誤解

  • setState の直後に、変数へ反映されるわけではない。
    同じレンダリング内の state は古いままで、更新は次のレンダリングに現れる。
  • オブジェクトを直接書き換えるだけでは足りない。
    新しい参照を渡さないと、React は変化に気づかず、再レンダリングしない。

関連

更新が反映されない症状は setState しても画面が更新されない で、フックの呼び出し位置の規則は Invalid Hook Call で扱っている。