Reactでアプリを組んでいるとき、DOM要素へのアクセスを管理したり、レンダリングとは関係ないけど監視したい値をキープしたりしたい場面があります。そんなときに使われるのがuseRefですが、DOM参照か値の保持か、その違いを理解して用途に応じて使い分ける必要があります。本記事ではReactのuseRefがどう動くか、DOM参照との使い方の違い、値を保持するケース、stateとの比較、そしてパフォーマンスや注意点までじっくり説明します。
React useref DOM 参照 値 保持 違い
まずはuseRefがReactでDOMの参照として使われるケースと、値を保持するケースの違いを明確に理解することが重要です。以下ではそれぞれの特徴や使いどころを解説します。
useRefとは何か
useRefはReactのフックで、ミュータブルなオブジェクトを返し、その中のcurrentプロパティを通じて値やDOMノードを保持します。初回レンダーで渡した初期値がcurrentにセットされ、以後レンダーが更新されてもこのrefオブジェクト自体は再作成されません。これは変数ではなく、レンダー外の記憶領域として機能するものです。
DOM参照としてのuseRefの役割
DOM参照として使う場合、useRefに初期値nullを渡し、JSXのref属性でDOM要素を指定します。レンダー後にcurrentが実際のDOMノードになるため、フォーカス操作やスクロール、サイズ計測などのブラウザAPIとのやりとりが可能です。また要素がアンマウントされるときにはcurrentがnullに戻るため、安全に参照を管理できます。
レンダリングと値の保持としての使い方
値の保持という側面では、useRefはレンダー間で変化してほしいがレンダリングを引き起こしたくないデータに最適です。例えば前回の状態を保存したり、タイマーIDやアニメーションフレームIDを貯めたり、外部の変数を保持したりする場合に使われます。stateとは違い、currentが変更されても再レンダーは起きません。
共通点と相違点: DOM参照 vs 値保持
使いどころは似ているようで、DOM参照としての利用と値保持としての利用には明確な違いがあります。ここではそれらを比較しながら整理します。
DOM参照と値保持の類似点
どちらもuseRefで実装され、refオブジェクトがレンダー間で一定である点が共通しています。また、関数コンポーネント内で定義してもそのインスタンス固有であり、他のコンポーネントインスタンスとは共有されません。さらに変更によって再描画が発生しないことも同じ特徴です。
DOM参照と値保持の相違点
DOM参照は実際のHTML要素やブラウザのノードへのアクセスを扱い、主に表示と操作に関するものです。一方、値保持は表示には直接表れないがロジックで必要なデータを保存する用途です。DOM参照ではcurrentにDOMノードが入るが、値保持ではプリミティブ型やオブジェクト・関数など任意の値が入ります。
いつ使い分けるべきか
DOM操作(フォーカス、スクロール、measureなど)を行う必要があるときはDOM参照を使うべきです。一方、レンダー回数を増やしたくないけれど途中の情報を残したいとき、例えば前のprops値やカウンター、タイマーIDなどは値保持に使うのが適切です。
React useRefとuseStateなど他の手段との違い
useRefだけでなく、useStateやローカル変数、contextなど他の手段と比較することでも理解が深まります。こちらでは複数の手法とuseRefとの比較を行います。
useRef vs useState
useStateは値が変わるとReactによってコンポーネントが再レンダリングされ、UIに反映されます。useRefはcurrentを変えてもレンダーは起こりません。UIに見える部分を更新したいときはstateを、見えないデータを保持したいときはrefを使います。過剰なstateの使いすぎはパフォーマンス低下を招くため、useRefはこの点で有利となる場合があります。
useRef vs ローカル変数
関数コンポーネント内で宣言する通常の変数はレンダーのたびに再初期化されてしまいます。useRefは初回のみ初期値が設定され、以後そのインスタンスでcurrentプロパティがそのまま保持され続けます。つまりレンダーごとにリセットされてほしくない値にはローカル変数ではなくuseRefが必要です。
他のAPIとの併用: useEffectやuseCallbackとの組み合わせ
DOM参照を使って操作を行うのはレンダー後なので、通常useEffect内やイベントハンドラ内で行います。currentプロパティを読み書きする処理はレンダリングフェーズではなく、commitフェーズや副作用フェースで行うのがReactのルールです。useCallbackで関数をメモ化する際にもrefを使えば最新の値を参照できるなどのパターンがあります。
具体例で学ぶDOM参照と値保持のコード比較
これまでの理論をコードで比較すると理解がより確かになります。以下に典型的なDOM参照の使い方と値保持の使い方の実例を示します。
DOM参照を使う例
例えば入力欄にフォーカスを当てるUIの場合、useRefでinput要素を参照し、ある操作時にcurrent.focusを呼び出します。レンダー前はcurrentがnullで、その後実際のDOMノードが入り、buttonのクリックハンドラからフォーカス操作が可能になります。Reactが要素をアンマウントするとcurrentはまたnullになります。
値保持を使う例
前回の状態を保持するケースとして、stateで持つ現在の値と、useRefで持つ過去の値を比較する例があります。useEffectで現在値が更新されるたびにref.currentに保存し、レンダーでは表示されないがログ等で確認できるようにします。またアニメーションIDやタイマーIDなど、表示とは無関係な値を保持して制御するのに使います。
コード比較: DOM参照と値保持の表
| 用途 | DOM参照 | 値保持 |
|---|---|---|
stored in ref.current |
DOMノード | プリミティブ/オブジェクト等 |
| レンダーによる更新 | current が変わっても再レンダーなし | current が変わっても再レンダーなし |
| 初期値セットタイミング | 初回レンダー時に null または初期値 | 初回レンダー時に初期値 |
| レンダリング中の読み書き | 基本的には禁止/不安定になる可能性あり | 同様に描画中の読み書きは非推奨 |
| 用途が適しているケース | フォーカス、スクロール、計測などのDOM操作 | 過去値の保持、タイマーやIDの持続、mutableな値 |
パフォーマンスと注意点
useRefは便利ですが使い方を誤るとバグやパフォーマンス問題の原因になります。ここでは最新情報も踏まえて、安全かつ効率的に使うための注意点を紹介します。
レンダリングの発生をコントロールする
ref.currentを変更してもコンポーネントは再レンダリングされないため、UIと値にずれが生じる可能性があります。UIに反映すべき値はstateで管理し、refには表示に不要な値のみを置くように設計することが大切です。また、誤ってrenderフェーズ中にrefを書き換えたり読み込んだりするとReactの純粋関数モデルを破り、将来的なバグにつながる可能性があります。
初期値の扱いとStrict Modeの影響
useRefに渡す初期値は初回レンダー時のみ評価されます。もし初期化が高コストな処理であれば、currentがnullから始まって必要時に初めて作成する遅延初期化のパターンが推奨されます。また開発モードでStrict Modeが有効だとコンポーネントを2回呼び出すため、refの初期化コードが重複して走らないよう注意が必要です。
nullチェックとアンマウント後の安全性
DOMノードを参照するrefではアンマウント後にcurrentがnullになることがあります。そのためevent handlerやEffect内でcurrentを使う際はnullチェックを必ず行うことが安全です。アンマウント後の操作やDOM操作を続けるとエラーの原因になります。
過剰使用による設計の問題
refを安易に使いすぎる設計はコードの可読性や保守性を低くすることがあります。UIを制御する以上にrefにロジックを詰め込みすぎると、どこで値が変わっているか追いにくくなります。state中心の設計を基本とし、refは例外的・補助的な利用と考えるのがよいです。
最新情報に基づく更新されたベストプラクティス
Reactやフックのエコシステムは進化し続けており、最近のバージョンでもuseRef周りには改善や明確化されたガイドラインがあります。ここでは最新の動向を紹介します。
初期値は最小限に・必要時に遅延生成
currentに高コストなオブジェクトを初期値として渡すと、初回レンダーが重くなることがあります。そのため、初期値をnullにして必要になったときに初めてオブジェクトを生成するパターンが広まりつつあります。これにより不要な処理を避け、初期ロードを軽く保てます。
DOM参照更新タイミングの明確化
ReactはcommitフェーズでDOM参照を設定します。レンダリング中ではcurrentがnullであることが前提です。表示該当タイミングで焦ってcurrentをアクセスしないよう、Effectやイベントハンドラ内で参照することが推奨されています。
useRefを使ったパターンの変化
prevState保持や前回の値を比較するケース、タイマーID管理、スクロール位置などのパフォーマンス最適化用途に加え、最近では関数やオブジェクトキャッシュのためのrefの利用、あるいはアニメーションフックとの併用などが一般的になってきています。また、フックの設計ガイドにおいてref相互の依存関係を明確にするようなスタイルガイドも整備されつつあります。
開発モードと問題の早期発見
開発中はStrict Modeが有効の場合が多く、useRef初期化コードが複数回実行されることがあります。初期化で副作用を伴う処理があるとこの挙動が問題になるため、useRef初期時の処理は副作用を含まないようにするのが最近の推奨事項です。
まとめ
ReactのuseRefは、DOM要素への参照と値の保持という二つの用途において非常に有用なフックです。DOM参照では要素操作やフォーカス管理、スクロール計測が可能であり、値保持では表示に影響しないがロジック上必要なデータをレンダー間で維持できます。
stateとは異なりrefのcurrentを変えてもレンダリングされない点が大きな特徴であり、UIに関する値はstateで管理すべきです。ローカル変数とは違い、refはレンダー間で値を保存する性質を持ちます。
設計の際には、初期値の設定、nullチェック、DOMアクセスのタイミング、過剰なref利用の回避といった注意点を守ることで、バグやパフォーマンス問題を防げます。
最終的には、DOMの参照として使うのか、値を保持するために使うのか、その目的を明確にすることでReact開発におけるuseRefの力を最大限に活かせます。
コメント