Skip to main content
← Glossary

React ref

React ref

화면 출력과 별개로 값을 보관하거나 현재 렌더된 대상의 직접 실행 함수에 접근하는 React의 참조다.

같은 뜻으로 쓰는 말

  • ref
  • 리액트 ref

마지막 검증

React ref는 화면에 표시할 state가 아니라 렌더링 사이에 유지할 값이나 현재 렌더된 대상의 직접 실행 함수를 가리키는 참조다. useRef(initialValue)가 돌려주는 객체의 current에 현재 참조가 들어간다. 이 값을 바꿔도 그 자체만으로 다시 Render되지는 않는다.

React Native WebView처럼 컴포넌트가 postMessage, reload 같은 직접 실행 함수를 제공하면 ref를 통해 현재 렌더된 WebView에 접근할 수 있다. ref가 아직 null이거나 이미 제거된 시점도 있으므로, 명령을 호출하기 전에 현재 대상과 실행 준비 상태를 함께 확인해야 한다.

출처와 검증 범위

아래 날짜는 링크를 마지막으로 열어 본 날입니다. 문서 상단의 검증일은 글의 설명과 적용 범위를 다시 확인한 날입니다.

  1. useRefReact · 공식 문서 · 확인 2026-08-09
  2. Manipulating the DOM with RefsReact · 공식 문서 · 확인 2026-08-09