Menu

React Hooksとは:すべてのフックをライブ例で解説

フックは名前がuseで始まる関数で、コンポーネントがstate、コンテキスト、ref、エフェクトなどのReactの機能を使えるようにします。用途別にまとめたすべての組み込みフック、すべてのフックが守る2つのルール、そして自作フックの書き方を紹介します。

このページのコードはエディタで実行できます - 編集してすぐに結果を確認できます。

React Hooksは名前が use で始まる関数で、関数コンポーネントがReactの機能を使えるようにします。値を覚えておく useState、レンダリングの後にコードを実行する useEffect、DOMノードを持っておく useRef、共有データを読む useContext などです。コンポーネントの先頭で呼ぶと、Reactはレンダリングの間でその値を保ちます。

ここでは4つのフックが一緒に動いています。useState がテキストを保存し、useRef が入力欄を指してボタンがフォーカスできるようにし、useMemo が検索語が変わるまでフィルター済みのリストを保ち、useEffect が検索語が変わったレンダリングの後にログを出します。an と入力してコンソールを見てください。リストが更新された後、キーを押すごとに1行ずつ出ます。

フックが存在する理由

React 16.8より前は、stateやライフサイクルのコードが必要なコンポーネントはクラスでなければなりませんでした。1つの機能のロジックが componentDidMount、componentDidUpdate、componentWillUnmount に分かれ、それをコンポーネント間で共有するには、ミックスイン(クラス構文では一度も動きませんでした)、高階コンポーネント、レンダープロップを使う必要があり、どれもツリーを余分な層で包むものでした。

// The class way: one feature, three methods
class Clock extends React.Component {
    state = { now: new Date() };
    componentDidMount() {
        this.id = setInterval(() => this.setState({ now: new Date() }), 1000);
    }
    componentWillUnmount() {
        clearInterval(this.id);
    }
    render() {
        return <p>{this.state.now.toLocaleTimeString()}</p>;
    }
}

フックなら同じ機能が1か所にまとまります。エフェクトがタイマーを始め、そのクリーンアップが止めます。

時計を隠すと、コンソールに timer stopped と出ます。Clock が画面から消えたときにReactがクリーンアップを実行したのです。もう一度表示すると、新しいタイマーが始まります。クラスコンポーネントはReact 19でも動きますが、新しいコードではフックを使います。

すべての組み込みフック

React 19.2のフックは、コンポーネントに何を与えるかでグループ分けできます。最初の2つのグループは毎日使い、それ以外は特定の問題が起きたときに使います。

フック与えてくれるものページ
useStateレンダリングをまたいで残る値と、再レンダリングを起こすセッターuseState
useReducerreducer関数とdispatchされたアクションで更新されるstateuseReducer
useContextpropsを渡さずに、親が提供する値useContext
useRefレンダリングをまたいで残る変更可能な箱。DOMノードによく使うuseRef
useImperativeHandle親が自分のrefを通じて何を見るかを選ぶforwardRef
useEffect通常は描画の後に実行されるコード:タイマー、購読、データ取得useEffect
useLayoutEffectDOMの更新後、描画の前に実行されるコードuseLayoutEffect
useInsertionEffectレイアウトエフェクトより前に実行される。CSS-in-JSライブラリ用
useEffectEventエフェクトから呼べて、常に最新のpropsとstateを見る関数useEffect
useMemo計算した値をレンダリング間でキャッシュするuseMemo
useCallback関数をレンダリング間でキャッシュするuseCallback
useTransition更新を緊急でないものとして扱い、保留中かどうかを教えるuseTransition
useDeferredValue重いレンダリングの間は遅れてついてくる値のコピーuseDeferredValue
useIdサーバーとクライアントで一致する一意のIDuseId
useSyncExternalStoreReactの外にあるストアを購読するuseSyncExternalStore
useDebugValueReact DevToolsでカスタムフックに付けるラベル
usePromiseやコンテキストを読む。条件分岐の中に置けるuse
useActionStateフォームアクションが更新するstateと、保留中フラグuseActionState
useOptimisticサーバーが応答する前に、予想される結果を表示するuseOptimistic
useFormStatus親フォームの保留中の状態(react-dom から)

use、useActionState、useOptimistic、useFormStatus はReact 19で登場し、useEffectEvent は19.2で安定版になりました。一覧のそれ以外のフックはすべてReact 18でも動きます。

stateはレンダリングを起こし、refは起こさない

すべてのフックがレンダリングを起こすわけではありません。useState と useReducer は起こします。値を変えると、Reactはコンポーネントをもう一度描画します。useRef は current フィールドを自由に変えられるオブジェクトを渡し、Reactはそれが原因で再レンダリングすることはありません。そのため、タイマーのID、前回の値、画面に表示しないカウントを置くのに適しています。

useReducer がカートを、useState がメモを持っています。どちらも変わるとレンダリングを起こし、エフェクトはレンダリングごとに1行ログを出します。エフェクトは commits.current も変えますが、その変更が自分でレンダリングを起こすことはないので、ログはループしません。カウントをコンポーネント本体ではなくエフェクトで更新しているのは、本体はレンダリング中に何も変えるべきではないからです。

フックのルール

すべてのフックは2つのルールに従います。

  1. フックはコンポーネントのトップレベルで呼び、条件分岐、ループ、ネストした関数の中では決して呼ばない。
  2. フックは関数コンポーネントか、自作のカスタムフックからだけ呼ぶ。

Reactはフックを名前で区別していません。呼び出しの順番で区別し、その順番がすべてのレンダリングで同じであることを期待しています。if の中のフックは、その後のすべてのフックをずらしてしまいます。何が壊れ、どう直すかはフックのルールのページで紹介しています。use は唯一の例外で、条件分岐の中で呼べます。

最初のカスタムフック

2つのコンポーネントが同じstateを持つロジックを必要とするなら、それを名前が use で始まる関数に移します。その関数はほかのどんなフックでも呼べます。それを呼ぶ各コンポーネントは、自分のstateを持ちます。

どちらのカウンターも同じフックを実行していますが、一方をクリックしてももう一方は変わりません。カスタムフックが共有するのはロジックであって、stateではないのです。useCounter に decrement 関数と、それを呼ぶボタンを追加すると、両方のカウンターに一度に反映されます。ほかのパターン(useToggle、useDebounce、useLocalStorage)はカスタムフックのページにあります。

どのフックを使うか

  • 値が変わったら画面も変わるべき:useState、多くのイベントが同じstateを更新するなら useReducer。
  • Reactの外にあるもの(タイマー、購読、リクエスト)とやり取りする:useEffect。
  • DOMノードや、画面に表示しない値が必要:useRef。
  • ツリーの深いところにある多くのコンポーネントが同じ値を必要とする:useContext。
  • 1つの計算や、メモ化された子の再レンダリングのせいでレンダリングが遅い:useMemo と useCallback。React Compilerがこのメモ化を代わりに追加してくれますが、手で書く方法も今も動き、よく使われています。
  • 裏の更新が重くて入力がもたつく:useTransition か useDeferredValue。

よくある質問

Reactのフックとは何ですか?

フックは名前が use で始まる関数で、関数コンポーネントがReactの機能を使えるようにします。stateには useState、副作用には useEffect、コンテキストには useContext、レンダリングを起こさずにレンダリングをまたいで残る値には useRef などがあります。

Reactにフックが追加されたのはなぜですか?

フック以前(React 16.8より前)は、stateとライフサイクルメソッドはクラスコンポーネントにしかなく、stateを持つロジックを共有するにはミックスイン、高階コンポーネント、レンダープロップが必要でした。フックはそのロジックを、どの関数コンポーネントからも呼べて、カスタムフックとして共有できる普通の関数にまとめます。

Reactにはいくつのフックがありますか?

React 19.2では react パッケージに約20個の組み込みフックがあり、さらに react-dom に useFormStatus があります。ほとんどのアプリが日常的に使うのは、useState、useEffect、useRef、useContext、useMemo、useCallback などのいくつかです。

クラスコンポーネントでフックを使えますか?

いいえ。フックが動くのは関数コンポーネントとほかのフックの中だけです。それでも関数コンポーネントの隣にクラスコンポーネントを描画できますし、クラスがフックを使う関数コンポーネントを描画することもできます。

カスタムフックとは何ですか?

名前が use で始まり、ほかのフックを呼ぶ自作の関数です。複数のコンポーネントが同じstateを持つロジックを再利用でき、それを呼ぶ各コンポーネントは別々のstateを持ちます。

Coddyのプログラミング言語のイラスト

Coddyでコードを学ぼう

始める