0Pricing
React Academy · 강의

모달의 포커스 및 키보드 트랩 처리

useRef와 이벤트 리스너로 접근성을 위해 열린 모달 내부에 포커스를 유지합니다.

모달의 포커스 및 키보드 트랩 처리은(는) CoddyKit의 무료 React Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 React Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

환영합니다

이 레슨에서는 모달 내부에 포커스 트랩을 구현하여 키보드 사용자가 열린 모달 밖으로 Tab 이동할 수 없게 합니다. 이는 중요한 접근성 요구 사항입니다(WCAG 2.4.3).

포커스 트랩이 필요한 이유

모달이 열리면 키보드 사용자는 모달 콘텐츠하고만 상호 작용할 수 있어야 합니다. 포커스 트랩이 없으면 Tab을 눌렀을 때 모달 오버레이 뒤의 요소로 포커스가 이동합니다. 이러한 요소는 시각적으로 숨겨져 있지만 여전히 접근할 수 있습니다.

포커스 트랩이란 무엇입니까

포커스 트랩은 Tab 및 Shift+Tab 키 이벤트를 가로챕니다. 포커스가 모달을 벗어나게 되면 모달 내부의 첫 번째 또는 마지막 포커스 가능한 요소로 다시 순환시킵니다.

포커스 가능한 요소 찾기

모든 상호 작용 요소를 포함하는 선택자와 함께 querySelectorAll을 사용하십시오. 비활성화되었거나 숨겨진 요소는 걸러 내십시오.
const FOCUSABLE = [
  'a[href]', 'button:not([disabled])',
  'input:not([disabled])', 'select', 'textarea',
  '[tabindex]:not([tabindex="-1"])'
].join(',');

const focusable = Array.from(
  modalRef.current.querySelectorAll(FOCUSABLE)
);

트랩 구현하기

모달 컨테이너에서 keydown 이벤트를 수신하십시오. Tab을 누를 때 포커스가 마지막 요소에 있으면 첫 번째 요소로 이동시키십시오. Shift+Tab을 누를 때 포커스가 첫 번째 요소에 있으면 마지막 요소로 이동시키십시오.
function handleTab(e) {
  const focusable = /* array of focusable elements */;
  const first = focusable[0];
  const last = focusable[focusable.length - 1];
  if (e.key !== 'Tab') return;
  if (e.shiftKey) {
    if (document.activeElement === first) {
      e.preventDefault(); last.focus();
    }
  } else {
    if (document.activeElement === last) {
      e.preventDefault(); first.focus();
    }
  }
}

열릴 때 포커스 이동하기

모달이 열리면 모달 내부의 첫 번째 포커스 가능한 요소로 포커스를 이동시키십시오. 또는 `tabIndex=-1`을 사용하여 모달 컨테이너 자체로 이동시킬 수 있습니다. 이렇게 하면 모달을 연 버튼에 포커스가 계속 남아 있는 것을 방지할 수 있습니다.
useEffect(() => {
  if (isOpen) {
    const first = modalRef.current?.querySelector(FOCUSABLE);
    first?.focus();
  }
}, [isOpen]);

닫을 때 포커스 복원하기

모달이 닫히면 모달이 열리기 전에 활성화되어 있던 요소로 포커스를 되돌리십시오. 모달이 열리는 시점에 `document.activeElement`를 ref에 저장하십시오.
const previousFocus = useRef(null);

useEffect(() => {
  if (isOpen) {
    previousFocus.current = document.activeElement;
  } else {
    previousFocus.current?.focus();
  }
}, [isOpen]);

focus-trap-react 라이브러리 사용하기

프로덕션 환경에서는 **focus-trap-react** 라이브러리 사용을 고려하십시오. 이 라이브러리는 shadow DOM, iframe, 동적으로 추가된 포커스 가능한 요소, Escape 키를 통한 비활성화 등 모든 예외 상황을 처리합니다.
import FocusTrap from 'focus-trap-react';

{isOpen && (
  <FocusTrap>
    <div role="dialog" aria-modal="true">
      {children}
    </div>
  </FocusTrap>
)}

모달을 위한 ARIA 속성

모달 컨테이너에 `role="dialog"`와 `aria-modal="true"`를 추가하십시오. 모달의 제목을 가리키는 `aria-labelledby`도 추가하십시오. 이렇게 하면 스크린 리더가 해당 대화 상자가 모달임을 인식하고 올바르게 안내할 수 있습니다.
<div
  role="dialog"
  aria-modal="true"
  aria-labelledby="modal-title"
>
  <h2 id="modal-title">Confirm Delete</h2>
  ...
</div>

배경을 위한 inert 속성

컨테이너의 HTML `inert` 속성은 해당 컨테이너의 모든 요소를 포커스 순서와 스크린 리더 접근성에서 제외합니다. 모달이 열려 있는 동안 `document.getElementById('root').inert = true`로 설정하면 배경을 확실하게 차단할 수 있습니다.
useEffect(() => {
  const root = document.getElementById('root');
  if (isOpen) root.setAttribute('inert', '');
  else root.removeAttribute('inert');
}, [isOpen]);

빠른 확인

포커스 트랩이 적용된 모달 내부의 마지막 포커스 가능한 요소에서 키보드 사용자가 Tab을 누르면 어떻게 되어야 합니까?

정리

포커스 트랩을 구현했습니다. 포커스 가능한 요소를 찾고, Tab/Shift+Tab을 가로채며, 열릴 때 포커스를 이동하고, 닫힐 때 포커스를 복원했습니다. 프로덕션에서는 focus-trap-react를 사용하고 스크린 리더를 위해 role='dialog'와 aria-modal을 추가하십시오.

다음 학습 내용

다음 레슨에서는 **포털을 사용한 툴팁 및 드롭다운 메뉴**를 다룹니다. createPortal을 사용하여 overflow-hidden 컨테이너 밖으로 벗어나는 툴팁과 드롭다운을 렌더링해 봅니다.

자주 묻는 질문

“모달의 포커스 및 키보드 트랩 처리” 강의는 무료인가요?

네 — “모달의 포커스 및 키보드 트랩 처리” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 React Academy 강의 전체를 잠금 해제할 수 있습니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“모달의 포커스 및 키보드 트랩 처리”에서 뭘 배우나요?

useRef와 이벤트 리스너로 접근성을 위해 열린 모달 내부에 포커스를 유지합니다. 브라우저에서 직접 실행하는 실습 코드로 React Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

React Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 React Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“모달의 포커스 및 키보드 트랩 처리” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 React Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 React Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. React Portal이란 무엇인가요
  2. Portal로 모달 구성 요소 만들기
  3. 모달의 포커스 및 키보드 트랩 처리
  4. Portal로 툴팁 및 드롭다운 메뉴 만들기
← React Academy(으)로 돌아가기