useRef
別名: useRef フック / ref オブジェクト
再レンダリングを起こさずに値を保持し、DOM 要素への参照も受け取れる React フック。
値は current プロパティに入る。
公開: 更新:
定義
useRef は、再レンダリングをまたいで値を保持する React フックである。const ref = useRef(initialValue) と書くと { current: initialValue } という 1 つのオブジェクトが返り、以降のレンダリングでも同じオブジェクトが使われる。ref.current を書き換えても、再レンダリングは起きない。
詳細
用途は大きく 2 つある。
1 つは、タイマー ID や直前の値のように「保持したいが画面には出さない」データの置き場である。
もう 1 つは DOM 操作である。<input ref={ref} /> のように JSX の ref 属性へ渡すと、マウント後に ref.current へ実際の DOM 要素が入り、focus() などを呼べる。
ref.current は、レンダリング中に読み書きしないのが原則である。
レンダリングの結果に影響する値は useState で持ち、画面に反映しない値だけを useRef に置く。
よくある誤解
useRefに入れた値を変えても、画面は更新されない。
表示を変えたいなら useState を使う。ref.currentが常に DOM 要素とは限らない。
初期値はuseRefに渡した値で、DOM が入るのはマウント後である。
初回レンダリング中や条件付き描画では、nullのままになる。
関連
current が null になる原因は React useRef の current が null で参照できない で扱っている。
状態を持つフックは useState の項で、副作用は useEffect の項で説明している。