웹 dialog를 닫은 뒤 포커스가 사라질 때: 취소·결과·복귀 시점

웹앱에서 확인 창을 닫았더니 키보드 위치를 잃거나, 이전에 “확인”을 누른 뒤 다음 취소도 확인으로 처리된다면 모달 표시, 닫기 요청, 최종 선택, 닫힌 뒤 이동할 위치를 따로 확인하세요. 창이 보인다는 것만으로 모달과 포커스 처리가 완성된 것은 아닙니다.

이 글은 네이티브 HTML dialog 한 개를 재사용하는 단순 선택 화면을 대상으로 합니다. 저장·삭제·결제는 실행하지 않습니다. Flutter Navigator의 대화상자는 Flutter 나가기 확인 글이 다루며, HTML 폼 수집의 submitter 문제는 FormData 필드 수집 글과 구분합니다.

보임·취소·선택·포커스를 분리하세요

증상 첫 확인 다음 판단
창은 보이지만 배경도 조작됨 open 속성·show·CSS 표시 중 무엇으로 열었는가 모달이 필요한 흐름인지 정하고 showModal 사용 검토
한 번 확인한 뒤 다음 Esc도 확인으로 처리 returnValue를 열 때 초기화하는가 새 선택과 남아 있던 문자열 분리
닫기 버튼인데 입력 오류가 먼저 뜸 버튼 type·form 소유자·required 검증 취소 동작과 폼 제출 검증을 구분
닫은 뒤 키보드 위치를 잃음 열었던 요소가 아직 연결·활성 상태인가 없어진 경우 논리적인 대체 위치 지정
닫기 직후 다시 열면 결과가 섞임 open=false와 close 이벤트 처리 시점 이번 close 처리가 끝날 때까지 재열기 경계 유지
iframe 안에서는 바깥 페이지도 눌림 dialog를 소유한 문서 범위 현재 문서의 모달을 전체 탭 잠금으로 오해하지 않기

showModal과 닫기 이벤트의 계약을 확인하세요

showModal 문서는 top layer와 같은 문서의 나머지 콘텐츠가 inert가 되는 범위를 설명합니다. open 속성만 붙이거나 show로 연 비모달 창을 같은 방식으로 취급하지 마세요. 이미 비모달로 열린 dialog에서 모달 열기를 시도하는 경우도 별도로 확인합니다.

cancel은 Esc 같은 닫기 요청을 다루고 기본 동작을 막을 수 있습니다. close는 닫힌 뒤 통지되며 취소 가능한 이벤트가 아닙니다. 두 이벤트가 모든 경로에서 반드시 한 쌍이라고 가정하지 않습니다. 직접 close를 부르는 버튼은 닫기 요청 차단 로직과 다른 경로일 수 있습니다.

returnValue 문서의 예처럼 매번 열 때 이전 결과를 비웁니다. close(‘accept’)처럼 값을 명시한 경로와 값 없는 취소 경로가 섞이면, 문자열이 남아 있는지를 확인해야 합니다. 이 글에서는 accept만 긍정 선택이고 빈 문자열·cancel·다른 값은 모두 머물기로 분류합니다.

선택만 안내하는 단일 dialog 예제

아래 HTML과 JavaScript는 복사해 검토하는 설명용 코드이며 이 사이트에서 실행되는 기능이 아닙니다. 첫 코드가 HTML, 나머지 두 JavaScript 블록을 순서대로 합친 파일이 choice.js입니다. 요소를 다시 마운트하지 않는 단일 화면에서 한 번만 연결하고, 다른 코드가 dialog를 열거나 returnValue를 바꾸지 않는 소유권 조건입니다.

처음 포커스를 둘 “계속 머물기”에 autofocus를 두고, 제목·짧은 설명을 연결했습니다. dialog 자체에 tabindex를 붙이지 않았습니다. 바깥 items-title의 tabindex=-1은 필요한 경우 코드로 복귀할 위치이며 일반 Tab 순서에 새 정지점을 추가하려는 용도가 아닙니다.

<h2 id="items-title" tabindex="-1">샘플 선택</h2>
<button id="open-choice" type="button">다음 단계 확인</button>
<p id="choice-status" role="status">아직 선택하지 않았습니다.</p>
<dialog id="choice" aria-labelledby="choice-title" aria-describedby="choice-note">
  <h2 id="choice-title">다음 단계로 이동할까요?</h2>
  <p id="choice-note">선택만 안내합니다. 저장·삭제·전송은 실행하지 않습니다.</p>
  <button id="cancel-choice" type="button" autofocus>계속 머물기</button>
  <button id="accept-choice" type="button">이동 선택</button>
</dialog>
<script src="choice.js" defer></script>
function bindChoiceDialog({ dialog, openButton, cancelButton,
                            acceptButton, fallback, onDecision }) {
  let active = false;
  let opener = null;

  function openFrom(button) {
    if (active || dialog.open) return false;
    dialog.returnValue = ''; // 이전 선택을 이번 취소에 이어 붙이지 않습니다.
    opener = button;
    active = true;
    try {
      dialog.showModal();
      return true;
    } catch (error) {
      active = false;
      opener = null;
      throw error;
    }
  }

  openButton.addEventListener('click', () => openFrom(openButton));
  cancelButton.addEventListener('click', () => dialog.close('cancel'));
  acceptButton.addEventListener('click', () => dialog.close('accept'));
  dialog.addEventListener('close', () => {
    if (!active) return;
    const target = opener;
    opener = null;
    try {
      onDecision(dialog.returnValue === 'accept');
    } finally {
      active = false;
      // 열기 버튼이 사라지거나 비활성이면 정해 둔 다음 위치로 갑니다.
      if (!dialog.open && (!target?.isConnected || target.disabled)) {
        fallback.focus();
      }
    }
  });
  return { openFrom };
}
const dialog = document.querySelector('#choice');
const openButton = document.querySelector('#open-choice');
const status = document.querySelector('#choice-status');
if (typeof dialog.showModal !== 'function') {
  openButton.disabled = true;
  status.textContent = '이 환경에서는 확인 창을 지원하지 않습니다. 별도 안내를 이용하세요.';
} else {
  bindChoiceDialog({
    dialog, openButton,
    cancelButton: document.querySelector('#cancel-choice'),
    acceptButton: document.querySelector('#accept-choice'),
    fallback: document.querySelector('#items-title'),
    onDecision(accepted) {
      status.textContent = accepted ? '이동을 선택했습니다. 아직 이동하지 않았습니다.'
                                    : '계속 머물기로 했습니다.';
    },
  });
}

openFrom은 이미 열렸거나 이전 선택 처리 중이면 false입니다. showModal이 실패하면 내부 상태를 풀고 오류를 호출자에게 그대로 전달합니다. 실제 제품은 그 오류를 사용자에게 안내할 경로도 마련해야 합니다. close 핸들러는 동기 onDecision이 끝날 때까지 이번 회차를 소유하고 finally에서 풀어, 중간 재열기가 이전 결과를 덮지 않게 했습니다.

Esc는 브라우저의 닫기 요청에 맡깁니다. 버튼에서 명시한 결과는 close에서 읽습니다. 다른 리스너의 preventDefault나 중첩 dialog를 쓰면 별도 동작 확인이 필요합니다. callback에서 같은 dialog를 즉시 다시 여는 것도 허용하지 않으며, 필요하면 이전 close 처리가 끝난 다음 별도의 사용자 동작으로 여는 계약을 정하세요.

열었던 버튼이 없어지면 어디로 갈지 정하세요

W3C APG 모달 패턴은 열린 뒤 내부로 포커스가 이동하고, 닫힌 뒤에는 연 요소 또는 다음 작업에 맞는 위치로 돌아가도록 안내합니다. 네이티브 dialog에 기본 동작이 있어도 닫힌 다음 목록을 다시 그려 버튼을 제거하면 그 위치가 사라질 수 있습니다.

이 예제는 연결돼 있고 활성인 열기 버튼의 기본 복귀를 건드리지 않습니다. onDecision 뒤 버튼이 제거됐거나 disabled라면 항상 남아 있을 것으로 정한 제목을 대체 위치로 사용합니다. 이는 모든 포커스 실패를 탐지하는 코드가 아닙니다. 숨겨짐·inert·다른 모달·동적 레이아웃·보조기술의 실제 읽기 위치는 별도로 확인해야 합니다.

HTML 닫기 절차에서 open 상태 변경·이전 포커스 복귀·close 통지는 구분됩니다. 그래서 단순히 open=false만 보고 즉시 다음 열기를 허용하면 처리 중인 이벤트가 새 회차의 returnValue를 읽는 구조가 될 수 있습니다. 원본 예제는 하나의 active 상태로 이 간격을 보수적으로 막습니다.

fallback은 문서에 연결돼 있고 보이며 프로그램으로 포커스할 수 있어야 합니다. 화면이 제거될 수 있는 SPA라면 리스너 해제와 회차 종료 처리를 추가해야 하며 이 예제를 매 재렌더마다 다시 연결하지 않습니다. 포커스 이동을 했다는 함수 호출 기록만으로 실제 포커스가 도착했다는 관찰로 바꾸지 마세요.

폼 제출 방식으로 확장할 때 달라지는 것

dialog 요소 안내처럼 method=dialog인 폼은 dialog를 닫고 버튼 값을 결과에 반영하는 경로가 될 수 있지만 서버 저장이 완료됐다는 의미는 아닙니다. required 필드가 있다면 폼 제출 취소 버튼까지 검증에 막히는지 확인하세요. 예제는 입력 필드 없는 type=button 두 개로 이 경계를 분리했습니다.

실제 저장을 추가한다면 “이동을 선택함”, “저장 요청 중”, “서버 저장 성공”을 각각 구분하고, 실패 때 편집값을 유지할지 결정해야 합니다. close가 발생했거나 returnValue가 accept였다는 사실만으로 저장·삭제 작업 성공을 표시하지 않습니다. light dismiss나 requestClose·closedby 같은 기능은 브라우저 지원과 제품 의도를 확인한 뒤 추가하며, 이 코드에는 쓰지 않았습니다.

모의 검사 15건의 결과와 실제 브라우저 확인표

2026년 11월 1일 Node.js v24.22.1에서 당시 연결 함수 원문을 실행해 모의 검사 15건을 통과했습니다. dialog·버튼·focus를 대체하고 close 콜백을 직접 대기열에 넣어 처리했습니다. 실제 HTMLDialogElement, Esc 키 입력, Tab 이동, inert, 기본 포커스 복귀나 스크린 리더를 실행한 결과는 아닙니다.

검사 묶음 모의 관찰 남은 실제 확인
확인·명시 취소·취소 요청 모의 accept만 true, 다음 취소는 false Esc·닫기 버튼·모바일 동작의 실제 이벤트
중복 열기·닫기 직후 재열기 close 처리 완료 전 재열기 거부 빠른 조작·애니메이션·프레임워크 수명
열기 실패·callback 오류 내부 잠금 해제, 오류를 성공으로 처리하지 않음 해당 브라우저 오류 안내와 회복 동작
열기 버튼 유지·제거·비활성 유지 시 대체 focus 0회, 제거·비활성 시 1회 document.activeElement와 실제 읽기 위치
회차 없는 close 통지 결과 callback 추가 실행 없음 외부 코드가 같은 dialog를 다루지 않는지

Chrome에서 Esc와 닫힌 뒤 초점을 확인했습니다

2026년 11월 17일 Chrome 157.0.8103.78 헤드리스에서 로컬 예제를 실행했습니다. 기존 코드에서는 Esc의 cancel 처리기가 결과를 바꿨지만, 창이 닫힌 뒤 읽은 값은 빈 문자열이었습니다. 위 코드는 그 대입을 제거했습니다. 열기 직전에 값을 비우고 close에서 accept만 긍정으로 처리합니다.

수정 뒤 조작 관찰 결과
열기 버튼에 초점을 두고 Enter 모달이 열리고 계속 머물기 버튼에 초점이 이동했습니다.
이동 선택 클릭 close가 발생했고 결과는 accept였습니다. 열기 버튼에 초점이 돌아갔습니다.
다시 열고 Esc cancel 뒤 close가 발생했습니다. 결과는 빈 문자열이었고 초점은 열기 버튼으로 돌아갔습니다.
계속 머물기 클릭 close가 발생했고 명시적 결과는 cancel이었습니다. 열기 버튼에 초점이 돌아갔습니다.
창이 열린 동안 열기 버튼 비활성화 또는 제거 비활성화 뒤 Esc로 닫거나 제거 뒤 이동 선택을 누르면 초점이 샘플 선택 제목으로 갔습니다.

시험에서는 열기 버튼을 프로그램으로 비활성화하거나 제거했습니다. 제품에 적용한 뒤에는 Tab·Shift+Tab 이동, 숨겨진 열기 버튼, 작은 화면과 스크린리더에서도 확인하세요.

확인한 원문과 이어서 볼 글

2026년 11월 1일 아래 MDN·HTML 표준·W3C 자료를 직접 읽고 이벤트·결과·포커스 계약을 대조했습니다. 2026년 11월 17일에는 HTML의 닫기 절차와 W3C의 복귀 위치 안내를 다시 읽고 Chrome에서 수정한 예제를 실행했습니다.