Ref로 값 참조하기

컴포넌트가 일부 정보를 “기억”하고 싶지만, 해당 정보가 렌더링을 유발하지 않도록 하려면 Ref를 사용하세요.

학습 내용

컴포넌트 Ref를 어떻게 추가하는가
Ref의 값이 어떻게 업데이트되는가
Ref가 State와 어떻게 다른가
Ref를 어떻게 안전하게 사용할까

컴포넌트에 Ref를 추가하기

React에서 useRef Hook을 가져와 컴포넌트에 Ref를 추가할 수 있습니다.

import { useRef } from 'react';

컴포넌트 내에서 useRef Hook을 호출하고 참조할 초깃값을 유일한 인자로 전달합니다. 예를 들어 다음은 값 0에 대한 Ref입니다.

const ref = useRef(0);

useRef는 다음과 같은 객체를 반환합니다.

{
  current: 0 // useRef에 전달한 값
}

An arrow with 'current' written on it stuffed into a pocket with 'ref' written on it.

ref.current 프로퍼티를 통해 해당 Ref의 current 값에 접근할 수 있습니다. 이 값은 의도적으로 변경할 수 있으므로 읽고 쓸 수 있습니다. React가 추적하지 않는 구성 요소의 비밀 주머니라 할 수 있습니다. (이것이 바로 React의 단방향 데이터 흐름에서 “탈출구”가 되는 것입니다. 아래에서 자세히 설명하고 있습니다!)

여기서 버튼은 클릭할 때마다 ref.current를 증가시킵니다.

포크

import { useRef } from 'react';

export default function Counter() {
  let ref = useRef(0);

  function handleClick() {
    ref.current = ref.current + 1;
    alert('You clicked ' + ref.current + ' times!');
  }

  return (
    <button onClick={handleClick}>
      Click me!
    </button>
  );
}

Ref는 숫자를 가리키지만, State처럼 문자열, 객체, 심지어 함수 등 모든 것을 가리킬 수 있습니다. State와 달리 Ref는 읽고 수정할 수 있는 current 프로퍼티를 가진 일반 자바스크립트 객체입니다.

컴포넌트는 모든 증가에 대하여 다시 렌더링 되지 않습니다. State와 마찬가지로 Ref도 React에 리렌더에 의해 유지됩니다. 그러나, State를 설정하면 컴포넌트가 다시 렌더링 됩니다. Ref를 변경하면 다시 렌더링 되지 않습니다!

예시: 스톱워치 작성하기

Ref와 State를 단일 컴포넌트로 결합할 수 있습니다. 예를 들어 사용자가 버튼을 눌러 시작하거나 중지할 수 있는 스톱워치를 만들어봅시다. 사용자가 “시작”을 누른 후 시간이 얼마나 지났는지 표시하려면 시작 버튼을 누른 시기와 현재 시각을 추적해야 합니다. 이 정보는 렌더링에 사용되므로 State를 유지합니다.

const [startTime, setStartTime] = useState(null);
const [now, setNow] = useState(null);

사용자가 “시작”을 누르면 setInterval을 사용하여 10밀리초마다 시간을 업데이트합니다.

포크

import { useState } from 'react';

export default function Stopwatch() {
  const [startTime, setStartTime] = useState(null);
  const [now, setNow] = useState(null);

  function handleStart() {
    // 카운팅을 시작합니다.
    setStartTime(Date.now());
    setNow(Date.now());

    setInterval(() => {
      // 10ms 마다 현재 시간을 업데이트 합니다.
      setNow(Date.now());
    }, 10);
  }

  let secondsPassed = 0;
  if (startTime != null && now != null) {
    secondsPassed = (now - startTime) / 1000;
  }

  return (
    <>
      <h1>Time passed: {secondsPassed.toFixed(3)}</h1>
      <button onClick={handleStart}>
        Start
      </button>
    </>
  );
}

”Stop” 버튼을 누르면 now State 변수의 업데이트를 중지하기 위해 기존 Interval을 취소해야 합니다. 이를 위해 clearInterval을 호출하면 됩니다. 그러나 이전에 사용자가 시작을 눌렀을 때 setInterval 호출로 반환된 interval ID를 제공해야 합니다. Interval ID는 어딘가에 보관해야 합니다. Interval ID는 렌더링에 사용하지 않으므로 Ref에 저장할 수 있습니다.

포크

import { useState, useRef } from 'react';

export default function Stopwatch() {
  const [startTime, setStartTime] = useState(null);
  const [now, setNow] = useState(null);
  const intervalRef = useRef(null);

  function handleStart() {
    setStartTime(Date.now());
    setNow(Date.now());

    clearInterval(intervalRef.current);
    intervalRef.current = setInterval(() => {
      setNow(Date.now());
    }, 10);
  }

  function handleStop() {
    clearInterval(intervalRef.current);
  }

  let secondsPassed = 0;
  if (startTime != null && now != null) {
    secondsPassed = (now - startTime) / 1000;
  }

  return (
    <>
      <h1>Time passed: {secondsPassed.toFixed(3)}</h1>
      <button onClick={handleStart}>
        Start
      </button>
      <button onClick={handleStop}>
        Stop
      </button>
    </>
  );
}

렌더링에 정보를 사용할 때 해당 정보를 State로 유지합니다. 이벤트 핸들러에게만 필요한 정보이고 변경이 일어날 때 리렌더링이 필요하지 않다면, Ref를 사용하는 것이 더 효율적일 수 있습니다.

Ref와 State의 차이

Ref가 State보다 덜 “엄격한” 것으로 생각될 수 있습니다. 예를 들어, 항상 State 설정 함수를 사용하지 않고 변경할 수 있습니다. 하지만 대부분은 State를 사용하고 싶을 것입니다. Ref는 자주 필요하지 않은 “탈출구”입니다. State와 Ref를 비교한 것은 다음과 같습니다.

Ref	State
`useRef(initialValue)` 는 `{ current: initialValue }`를 반환합니다.	`useState(initialValue)`는 State 변수의 현재 값과 Setter 함수 `[value, setValue]`를 반환합니다.
`current` 값을 바꿔도 리렌더링 하지 않습니다.	State를 바꾸면 리렌더링 합니다.
Mutable: 렌더링 프로세스 외부에서 `current` 값을 수정 및 업데이트할 수 있습니다.	Immutable: State를 수정하기 위해서는 State 설정 함수를 반드시 사용하여 리렌더링 대기열에 넣어야 합니다.
렌더링 중에는 `current` 값을 읽거나 쓰면 안 됩니다.	언제든지 State를 읽을 수 있습니다. 그러나 각 렌더링마다 변경되지 않는 자체적인 State의 Snapshot이 있습니다.

다음은 State와 함께 구현한 카운터 버튼입니다.

포크

import { useState } from 'react';

export default function Counter() {
  const [count, setCount] = useState(0);

  function handleClick() {
    setCount(count + 1);
  }

  return (
    <button onClick={handleClick}>
      You clicked {count} times
    </button>
  );
}

count 값을 표시하므로 State 값을 사용하는 것이 타당합니다. 카운터의 값을 setCount()로 설정하면 React는 컴포넌트를 다시 렌더링하고 새 카운트를 반영하도록 화면을 업데이트합니다.

이를 Ref와 함께 구현하려고 하면 React는 컴포넌트를 다시 렌더링하지 않으므로 카운트가 변경되는 것을 볼 수 없습니다! 이 버튼을 클릭해도 텍스트를 업데이트하지 않는 방법을 확인해봅시다.

포크

import { useRef } from 'react';

export default function Counter() {
  let countRef = useRef(0);

  function handleClick() {
    // 이것은 컴포넌트의 리렌더를 일으키지 않습니다!
    countRef.current = countRef.current + 1;
  }

  return (
    <button onClick={handleClick}>
      You clicked {countRef.current} times
    </button>
  );
}

이것이 렌더링 중에 ref.current를 출력하면 신뢰할 수 없는 코드가 나오는 이유입니다. 이 부분이 필요하면 State를 대신 사용해야 합니다.

자세히 살펴보기

`useRef`는 내부적으로 어떻게 동작하나요?

React가 useState와 useRef를 모두 제공하지만, 원칙적으로 useRef는 useState 위에 구현할 수 있습니다. React 내부에서 useRef를 이렇게 구현하는 것을 상상할 수 있습니다.

// Inside of React
function useRef(initialValue) {
  const [ref, unused] = useState({ current: initialValue });
  return ref;
}

첫 번째 렌더링 중에 useRef는 { current: initialValue }를 반환합니다. 이 객체는 React에 의해 저장되므로 다음 렌더링 중에 같은 객체를 반환합니다. 이 예시에서는 State Setter를 사용하지 않는 점에 주목하세요. useRef는 항상 동일한 객체를 반환해야 하므로 필요하지 않습니다!

React는 useRef가 실제로 충분히 일반적이기 때문에 built-in 버전을 제공합니다. setter가 없는 일반적인 state 변수라고 생각할 수 있습니다. 객체 지향 프로그래밍에 익숙하다면 Ref는 인스턴스 필드를 상기시킬 수 있습니다. 하지만 this.something 대신에 somethingRef.current 처럼 써야합니다.

Ref를 사용할 시기

일반적으로 컴포넌트가 React를 “외부”와 외부 API—컴포넌트의 형태에 영향을 미치지 않는 브라우저 API 와 통신해야 할 때 Ref를 사용합니다. 다음은 몇 가지 특별한 상황입니다.

Timeout ID를 저장
다음 페이지에서 다루는 DOM 엘리먼트 저장 및 조작
JSX를 계산하는 데 필요하지 않은 다른 객체 저장

컴포넌트가 일부 값을 저장해야 하지만 렌더링 로직에 영향을 미치지 않는 경우, Ref를 선택합니다.

Ref의 좋은 예시

다음 원칙을 따르면 컴포넌트를 보다 쉽게 예측할 수 있습니다.

Ref를 탈출구로 간주합니다. Ref는 외부 시스템이나 브라우저 API로 작업할 때 유용합니다. 애플리케이션 로직과 데이터 흐름의 상당 부분이 Ref에 의존한다면 접근 방식을 재고해 보는 것이 좋습니다.
렌더링 중에 ref.current를 읽거나 쓰지 마세요. 렌더링 중에 일부 정보가 필요한 경우 State를 대신 사용하세요. ref.current가 언제 변하는지 React는 모르기 때문에 렌더링할 때 읽어도 컴포넌트의 동작을 예측하기 어렵습니다. (if (!ref.current) ref.current = new Thing()과 같은 코드는 첫 번째 렌더링 중에 Ref를 한 번만 설정하는 경우라 예외입니다.)

React State의 제한은 Ref에 적용되지 않습니다. 예를 들어 State는 모든 렌더링에 대한 Snapshot 및 동기적으로 업데이트되지 않는 것과 같이 작동합니다. 그러나 Ref의 current 값을 변조하면 다음과 같이 즉시 변경됩니다.

ref.current = 5;
console.log(ref.current); // 5

그 이유는 Ref 자체가 일반 자바스크립트 객체처럼 동작하기 때문입니다.

또한 Ref로 작업할 때 Mutation 방지에 대해 걱정할 필요가 없습니다. 변형하는 객체를 렌더링에 사용하지 않는 한, React는 Ref 혹은 해당 콘텐츠를 어떻게 처리하든 신경 쓰지 않습니다.

Ref와 DOM

임의의 값을 Ref로 지정할 수 있습니다. 그러나 Ref의 가장 일반적인 사용 사례는 DOM 엘리먼트에 접근하는 것입니다. 예를 들어 프로그래밍 방식으로 입력창에 초점을 맞추려는 경우 유용합니다. <div ref={myRef}>와 같은 JSX의 ref 어트리뷰트에 Ref를 전달하면 React는 해당 DOM 엘리먼트를 myRef.current에 넣습니다. 만약 엘리먼트가 DOM 에서 사라지면, React 는 myRef.current 값을 null 로 업데이트 합니다. 이에 대한 자세한 내용은 Ref로 DOM 조작하기에서 확인할 수 있습니다.

요약

Ref는 렌더링에 사용되지 않는 값을 고정하기 위한 탈출구이며, 자주 필요하지는 않습니다.
Ref는 읽거나 설정할 수 있는 current라는 프로퍼티를 호출할 수 있는 자바스크립트 순수객체입니다.
useRef Hook을 호출해 Ref를 달라고 React에 요청할 수 있습니다.
State와 마찬가지로 Ref는 컴포넌트의 렌더링 간에 정보를 유지할 수 있습니다.
State와 달리 Ref의 current 값을 설정하면 리렌더링을 트리거하지 않습니다.
렌더링 중에 ref.current를 읽거나 쓰지 마세요. 컴포넌트를 예측하기 어렵게 만듭니다.

챌린지 도전하기

챌린지 1 of 4:
정상적으로 동작하지 않는 채팅 입력창 수정

메시지를 입력하고 “Send”를 클릭합니다. “Sent!” 경고창(alert)이 나타나기 전에 3초 정도 지연된다는 것을 알 수 있습니다. 이 지연된 시간 동안 “Undo” 버튼을 볼 수 있습니다. 누르세요. 이 “Undo” 버튼은 “Sent!” 메시지가 나타나지 않도록 합니다. handleSend 중 저장된 Timeout ID에 대해 clearTimeout을 호출하면 됩니다. 그러나 “Undo”를 클릭한 후에도 “Sent!” 메시지가 계속 나타납니다. 왜 작동하지 않는지 찾아서 고쳐봅시다.

포크

import { useState } from 'react';

export default function Chat() {
  const [text, setText] = useState('');
  const [isSending, setIsSending] = useState(false);
  let timeoutID = null;

  function handleSend() {
    setIsSending(true);
    timeoutID = setTimeout(() => {
      alert('Sent!');
      setIsSending(false);
    }, 3000);
  }

  function handleUndo() {
    setIsSending(false);
    clearTimeout(timeoutID);
  }

  return (
    <>
      <input
        disabled={isSending}
        value={text}
        onChange={e => setText(e.target.value)}
      />
      <button
        disabled={isSending}
        onClick={handleSend}>
        {isSending ? 'Sending...' : 'Send'}
      </button>
      {isSending &&
        <button onClick={handleUndo}>
          Undo
        </button>
      }
    </>
  );
}

이전탈출구

다음Ref로 DOM 조작하기