https://ko.react.dev/reference/react/useRef

๋ Œ๋”๋ง์— ํ•„์š”ํ•˜์ง€ ์•Š์€ ๊ฐ’์„ ์ฐธ์กฐํ•  ์ˆ˜ ์žˆ๋Š” Hook

const ref = useRef(initialValue)

Caveats

  • ref.current ๋Š” mutate ๊ฐ€๋Šฅํ•˜๋‹ค. ํ•˜์ง€๋งŒ ๋ Œ๋”๋ง์— ์‚ฌ์šฉ๋˜๋Š” ๊ฐ์ฒด(state์˜ ์ผ๋ถ€)๋ฅผ ํฌํ•จํ•˜๋Š” ๊ฒฝ์šฐ mutateํ•ด์„œ๋Š” ์•ˆ๋œ๋‹ค.
  • ref.current๋Š” ๋ณ€๊ฒฝํ•ด๋„ ์ปดํฌ๋„ŒํŠธ๊ฐ€ ๋ฆฌ๋ Œ๋”๋ง๋˜์ง€ ์•Š๋Š”๋‹ค. React๋Š” ํ•ด๋‹น ๊ฐ’์ด ์–ธ์ œ ๋ฐ”๋€Œ์—ˆ๋Š”์ง€ ์•Œ์ง€ ๋ชปํ•œ๋‹ค.
  • ์ดˆ๊ธฐํ™”๋ฅผ ์ œ์™ธํ•˜๊ณ  ๋ Œ๋”๋ง ์ค‘์— ref.current๋ฅผ ์“ฐ๊ฑฐ๋‚˜ ์ฝ์œผ๋ฉด ์•ˆ๋œ๋‹ค.
  • Strict Mode ์—์„œ๋Š” React๋Š” ์ปดํฌ๋„ŒํŠธ ํ•จ์ˆ˜๋ฅผ ๋‘๋ฒˆ ํ˜ธ์ถœํ•œ๋‹ค. useRef๋„ ๋งˆ์ฐฌ๊ฐ€์ง€๋ผ ref ๊ฐ์ฒด๋Š” ๋‘ ๋ฒˆ ์ƒ์„ฑ๋˜๊ณ  ํ•˜๋‚˜๋Š” ๋ฒ„๋ ค์ง„๋‹ค.

Usage

Referencing a value with a ref

ref๋Š” ๋ณ€๊ฒฝ ์‹œ ๋ฆฌ๋ Œ๋”๋ง์„ ์ด‰๋ฐœํ•˜์ง€ ์•Š๋Š”๋‹ค. ๋”ฐ๋ผ์„œ UI์— ์˜ํ–ฅ์„ ๋ฏธ์น˜๋Š” ์ •๋ณด๋ฅผ ์ €์žฅํ•˜๋ฉด ์•ˆ๋˜๊ณ , intervalId ๊ฐ™์ด UI์— ์˜ํ–ฅ์„ ๋ฏธ์น˜์ง€ ์•Š๋Š” ๊ฐ’์„ ์ €์žฅํ•ด์•ผํ•œ๋‹ค.

ref๋Š” ๋˜ํ•œ ๋‹ค์Œ์„ ๋ณด์žฅํ•œ๋‹ค.

  • ๋ฆฌ๋ Œ๋”๋ง ์‚ฌ์ด์— ์ •๋ณด๋ฅผ ์ €์žฅํ•  ์ˆ˜ ์žˆ๋‹ค.
  • ๋ฆฌ๋ Œ๋”๋ง์„ ์ด‰๋ฐœํ•˜์ง€ ์•Š๋Š”๋‹ค.
  • ๊ฐ๊ฐ์˜ ์ปดํฌ๋„ŒํŠธ์— ๋กœ์ปฌ๋กœ ์ €์žฅ๋œ๋‹ค.

Do not write or read ref.current during rendering

React๋Š” ์ปดํฌ๋„ŒํŠธ ๋ณธ๋ฌธ์ด ์ˆœ์ˆ˜ํ•จ์ˆ˜์ฒ˜๋Ÿผ ๋™์ž‘ํ•˜๊ธฐ๋ฅผ ์›ํ•œ๋‹ค. ์ž…๋ ฅ๊ฐ’(props, state, context)๊ฐ€ ๋˜‘๊ฐ™์œผ๋ฉด ๋˜‘๊ฐ™์€ JSX๊ฐ€ ๋‚˜์™€์•ผํ•œ๋‹ค. ๋ Œ๋”๋ง ์ค‘์— ref๋ฅผ ์ฝ๊ฑฐ๋‚˜ ์“ฐ๋ฉด ์ด๋Ÿฌํ•œ ๊ธฐ๋Œ€๊ฐ€ ๊นจ์ง„๋‹ค.

function MyComponent() {  
	// ๐Ÿšฉ ๋ Œ๋”๋ง ์ค‘์— ref๋ฅผ ์ž‘์„ฑํ•˜์ง€ ๋งˆ์„ธ์š”.  
	myRef.current = 123;  
	
	// ๐Ÿšฉ ๋ Œ๋”๋ง ์ค‘์— ref๋ฅผ ์ฝ์ง€ ๋งˆ์„ธ์š”.  
	return <h1>{myOtherRef.current}</h1>;  
}

๋Œ€์‹  ์ด๋ฒคํŠธ ํ•ธ๋“ค๋Ÿฌ๋‚˜ Effect์—์„œ๋Š” ์ฝ๊ฑฐ๋‚˜ ์“ธ ์ˆ˜ ์žˆ๋‹ค.

function MyComponent() {  
	// ...  
	useEffect(() => {  
		// โœ… Effect์—์„œ ref๋ฅผ ์ฝ๊ฑฐ๋‚˜ ์“ธ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.  
		myRef.current = 123;  
	});  
	
	// ...  
	function handleClick() {  
		// โœ… ์ด๋ฒคํŠธ ํ•ธ๋“ค๋Ÿฌ์—์„œ ref๋ฅผ ์ฝ๊ฑฐ๋‚˜ ์“ธ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.  
		doSomething(myOtherRef.current);  
	}  
}

Avoiding recreating the ref contents

ref ์ดˆ๊ธฐ ๊ฐ’์€ ํ•œ๋ฒˆ ์ €์žฅํ•˜๊ณ  ๋‹ค์Œ ๋ Œ๋”๋ง๋ถ€ํ„ฐ๋Š” ๋ฌด์‹œํ•˜์ง€๋งŒ, ์•„๋ž˜์™€ ๊ฐ™์€ ๊ฒฝ์šฐ ํ˜ธ์ถœ ์ž์ฒด๋Š” ๋งค๋ฒˆ ์ด๋ฃจ์–ด์ง„๋‹ค.

function Video() {  
	const playerRef = useRef(new VideoPlayer());

๋”ฐ๋ผ์„œ ๋‹ค์Œ๊ณผ ๊ฐ™์ด ์ดˆ๊ธฐํ™”์ธ ๊ฒฝ์šฐ์— ํ•œํ•˜์—ฌ ๋ Œ๋”๋ง ์ค‘์— ref.current๋ฅผ ์ฝ๊ณ  ์“ฐ๋Š” ์ž‘์—…์„ ํ†ตํ•ด ๋‚ญ๋น„๋ฅผ ์ค„์ผ ์ˆ˜ ์žˆ๋‹ค.

function Video() {  
	const playerRef = useRef(null);  
	if (playerRef.current === null) {  
		playerRef.current = new VideoPlayer();  
	}

์ด๊ฒฝ์šฐ ๊ฒฐ๊ณผ๊ฐ€ ํ•ญ์ƒ ๋™์ผํ•˜๊ณ , ์ดˆ๊ธฐํ™” ์ค‘์—๋งŒ ์กฐ๊ฑด์ด ์‹คํ–‰๋˜๋ฏ€๋กœ ์˜ˆ์ƒ๊ฐ€๋Šฅํ•˜์—ฌ ๊ดœ์ฐฎ๋‹ค.

get ref to a custom component

๊ธฐ๋ณธ์ ์œผ๋กœ ์ปดํฌ๋„ŒํŠธ๋Š” ๋‚ด๋ถ€์˜ DOM ๋…ธ๋“œ์— ๋Œ€ํ•œ ref๋ฅผ ์™ธ๋ถ€๋กœ ๋…ธ์ถœํ•˜์ง€ ์•Š๋Š”๋‹ค. ๋”ฐ๋ผ์„œ ์ปค์Šคํ…€ ์ปดํฌ๋„ŒํŠธ์— ๋Œ€ํ•œ ref๋ฅผ ์‚ฌ์šฉํ•˜๋ ค๋ฉด ๋‹ค์Œ๊ณผ ๊ฐ™์ด forwardRef๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‹ค.

import { forwardRef } from 'react';  
 
const MyInput = forwardRef(({ value, onChange }, ref) => {  
	return (  
		<input  
			value={value}  
			onChange={onChange}  
			ref={ref}  
		/>  
	);  
});