소프트웨어 및 오픈 소스

HTML, CSS 및 JavaScript를 사용하여 접근 가능한 모달 대화 상자 만들기

How to Create Accessible Modal Dialogs with HTML, CSS, and JavaScript

네이티브 HTML 대화 상자 요소를 사용하여 접근 가능한 모달 대화 상자를 만드세요. 팝업을 열고 닫는 방법, 키보드 포커스 관리, 배경 스타일링, JavaScript 라이브러리 없이 확인 대화 상자를 만드는 방법을 배워보세요.

HTML, CSS, 자바스크립트로 접근성 있는 모달 대화상자 만들기

방문자가 웹사이트의 버튼을 클릭합니다. 폼, 확인 메시지 또는 추가 정보가 담긴 팝업이 나타납니다.

시각적인 팝업을 만드는 것은 쉽습니다. 키보드, 스크린 리더, 모바일 브라우저에서 올바르게 작동하도록 만드는 것은 또 다른 문제입니다.

많은 커스텀 모달 구현은 포커스 관리, 페이지와의 상호작용 차단, Escape 키 처리를 위해 대량의 자바스크립트에 의존합니다.

최신 HTML은 더 간단한 접근 방식을 제공합니다. 바로 <dialog> 요소입니다.

브라우저에서 직접 모달 대화상자에 기대되는 동작 대부분을 제공합니다. 프레임워크나 플러그인을 설치하지 않고도 적은 양의 HTML, CSS, 자바스크립트로 작동하는 팝업을 만들 수 있습니다.

이 튜토리얼에서는 재사용 가능한 모달을 만들고, 스타일을 적용하고, 확인 대화상자를 추가하며, 실제 웹사이트에서 중요한 접근성 세부 사항을 살펴보겠습니다.

1. 모달 대화상자는 일반 팝업과 무엇이 다른가?

모달 대화상자는 방문자가 메인 페이지로 돌아가기 전에 인터페이스의 특정 부분과 상호작용하도록 일시적으로 요구합니다.

대표적인 예는 다음과 같습니다:

  • 항목 삭제를 확인하는 것.
  • 문의 폼을 표시하는 것.
  • 페이지를 떠나기 전에 확인을 요청하는 것.
  • 추가 제품 정보를 보여주는 것.
  • 애플리케이션 설정을 편집하는 것.

제대로 구현된 모달은 그 목적을 명확히 하고, 닫는 명백한 방법을 제공하며, 키보드 포커스를 적절히 관리해야 합니다.

<dialog> 요소는 모달 및 비모달 동작을 모두 지원합니다.

메서드 동작
showModal() 모달을 열고 문서의 나머지 부분을 inert 상태로 만듭니다
show() 비모달 대화상자를 엽니다
close() 대화상자를 닫습니다
method="dialog" 폼 버튼이 대화상자를 닫도록 허용합니다

모달 동작에는 브라우저가 제공하는 포커스 관리와 키보드 상호작용이 포함됩니다.

2. 첫 HTML 모달 만들기

간단한 예로 시작하겠습니다: 제목, 텍스트, 닫기 버튼이 포함된 대화상자를 여는 버튼입니다.

<button type="button" id="openDialog">
    View delivery information
</button>

<dialog id="deliveryDialog"
        aria-labelledby="deliveryTitle">

    <h2 id="deliveryTitle">
        Delivery information
    </h2>

    <p>
        Orders are prepared within two business days.
        You will receive a tracking link by email.
    </p>

    <form method="dialog">
        <button type="submit" autofocus>
            Close
        </button>
    </form>

</dialog>

<script>
const openButton = document.getElementById('openDialog');
const dialog = document.getElementById('deliveryDialog');

openButton.addEventListener('click', () => {
    dialog.showModal();
});
</script>

이것만으로 작동하는 모달 대화상자를 만들 수 있습니다.

방문자가 버튼을 클릭하면 showModal()이 페이지 콘텐츠 위에 대화상자를 엽니다.

브라우저는 다음과 같은 몇 가지 중요한 동작을 자동으로 처리합니다:

  • 대화상자가 일반 페이지 콘텐츠 위의 top layer로 진입합니다.
  • 문서의 나머지 부분이 inert 상태가 됩니다.
  • 키보드 포커스가 대화상자 안으로 이동합니다.
  • Escape를 누르면 보통 닫힙니다.
  • 대화상자가 닫히면 보통 포커스가 여는 버튼으로 돌아갑니다.

닫기 버튼은 method="dialog"을 사용하므로 자바스크립트 이벤트 핸들러가 필요하지 않습니다.

3. CSS로 대화상자 스타일링하기

기본 대화상자는 작동하지만, 그 appearance는 기본적입니다.

둥근 모서리, 편안한 간격, 반응형 너비, 배경을 줄 수 있습니다.

dialog {
    width: min(90vw, 520px);
    max-height: 85vh;
    box-sizing: border-box;
    padding: 2rem;
    border: 0;
    border-radius: 14px;
    background: #fff;
    color: #20242b;
    box-shadow: 0 20px 70px rgba(0, 0, 0, .2);
    overflow: auto;
}

dialog::backdrop {
    background: rgba(15, 23, 42, .65);
    backdrop-filter: blur(3px);
}

dialog h2 {
    margin-top: 0;
    font-size: 1.5rem;
}

dialog p {
    line-height: 1.6;
}

dialog button {
    padding: .75rem 1.25rem;
    border: 0;
    border-radius: 8px;
    background: #2458d3;
    color: #fff;
    font: inherit;
    cursor: pointer;
}

dialog button:focus-visible {
    outline: 3px solid #f59e0b;
    outline-offset: 3px;
}

::backdrop 유사 요소는 모달 대화상자 뒤의 레이어 스타일을 지정합니다.

showModal()을 통해서처럼 대화상자가 모달로 표시될 때만 나타납니다.

show()으로 열린 대화상자는 동일한 모달 배경 동작을 자동으로 받지 않습니다.

왜 top layer를 사용해야 하는가?

전통적인 커스텀 팝업은 점점 커지는 z-index 값에 의존하는 경우가 많습니다.

showModal()으로 열린 모달 대화상자는 브라우저의 top layer로 진입하므로 여러 stacking-context 문제를 피할 수 있습니다.

이것은 sticky header, 부유 위젯, 복잡한 페이지 빌더가 포함된 웹사이트에서 특히 유용합니다.

4. 키보드 접근성 이해하기

모달은 마우스 없이도 작동해야 합니다.

Tab 키로 웹사이트를 탐색하는 방문자를 상상해 보세요. 모달이 열릴 때 실수로 뒤의 페이지로 이동하지 않고 그 컨트롤과 상호작용할 수 있어야 합니다.

네이티브 모달 대화상자가 이 동작을 도와줍니다.

W3C는 HTML dialog 요소를 접근성 있는 모달 대화상자를 만드는 기법으로, 대화상자가 닫힐 때 포커스 격리 및 포커스 복귀를 포함하여 설명합니다.

대화상자에 접근성 있는 이름 지정하기

보이는 제목을 사용하고 aria-labelledby으로 참조하세요:

<dialog aria-labelledby="settingsTitle">
    <h2 id="settingsTitle">Account settings</h2>
    ...
</dialog>

이것은 보조 기술에 대화상자의 의미 있는 이름을 제공합니다.

초기 포커스 신중하게 선택하기

autofocus 속성은 모달이 열릴 때 포커스를 받아야 하는 컨트롤을 지정할 수 있습니다.

정보성 대화상자의 경우 닫기 버튼에 포커스하는 것이 적절할 수 있습니다.

Illustration of the article's main concept

폼의 경우 첫 번째 입력에 포커스하는 것이 더 합리적일 수 있습니다.

파괴적인 확인의 경우, Cancel과 같은 더 안전한 작업에 포커스하는 것이 종종 더 바람직합니다.

tabindex을 <dialog> 요소에 직접 배치하는 것은 피하세요. HTML 명세는 요소 자체에 해당 속성을 사용하는 것을 금지합니다.

항상 보이는 닫기 버튼 제공하기

Escape가 보통 모달 대화상자를 닫지만, 보이는 닫기 컨트롤은 여전히 필수적입니다.

모바일 방문자는 물리적 키보드가 없을 수 있고, 일부 사용자는 Escape로 팝업을 닫을 수 있다는 것을 모를 수 있습니다.

5. 두 개의 버튼으로 확인 대화상자 만들기

이제 더 유용한 예제를 만들어 보겠습니다: 저장된 항목의 삭제를 확인하는 것입니다.

방문자는 Cancel 또는 Delete를 선택할 수 있어야 합니다.

HTML은 method="dialog"과 대화상자의 returnValue 속성을 통해 편리한 메커니즘을 제공합니다.

<button type="button" id="deleteItem">
    Delete item
</button>

<dialog id="confirmDialog"
        aria-labelledby="confirmTitle">

    <h2 id="confirmTitle">
        Delete this item?
    </h2>

    <p>
        This action cannot be undone.
    </p>

    <form method="dialog">
        <button value="cancel" autofocus>
            Cancel
        </button>

        <button value="confirm">
            Delete
        </button>
    </form>

</dialog>

<script>
const deleteButton = document.getElementById('deleteItem');
const confirmDialog = document.getElementById('confirmDialog');

deleteButton.addEventListener('click', () => {
    confirmDialog.returnValue = 'cancel';
    confirmDialog.showModal();
});

confirmDialog.addEventListener('close', () => {
    if (confirmDialog.returnValue === 'confirm') {
        // Call your application deletion logic here.
        console.log('Deletion confirmed');
    }
});
</script>

중요한 세부 사항은 method="dialog" 폼 내부의 버튼을 클릭하면 대화상자가 닫히고 returnValue이 설정된다는 것입니다.

코드는 사용자가 confirm을 선택했는지 확인합니다.

열기 전에 값을 재설정하면 사용자가 Escape로 대화상자를 닫을 때 이전 확인이 새 확인으로 오인되는 것을 방지합니다.

예제는 의도적으로 아무것도 삭제하지 않습니다. 실제 애플리케이션에서는 확인된 작업이 필요한 인증 및 CSRF 보호와 함께 자체 PHP 엔드포인트나 애플리케이션 컨트롤러를 호출할 것입니다.

6. 확인 워크플로 테스트하기

유용한 시연은 각각 Delete 버튼이 있는 저장된 항목 목록입니다. Delete를 클릭하면 확인 대화상자가 열려야 합니다. Cancel은 항목을 그대로 두어야 하고, Confirm은 선택된 항목만 제거해야 합니다.

이것은 실제 웹사이트 데이터를 변경하지 않고 확인 흐름을 보여줍니다.

7. 대화상자 안에 문의 폼 추가하기

문의 폼은 또 다른 일반적인 사용 사례입니다.

하지만 대화상자를 닫는 것과 데이터를 서버에 제출하는 것 사이에는 중요한 차이가 있습니다.

method="dialog"이 있는 폼은 팝업을 닫습니다. PHP 백엔드로 일반적인 HTTP 요청을 보내지 않습니다.

실제 문의 폼의 경우 일반 폼 제출이나 AJAX 요청을 사용하세요.

예를 들어:

<dialog id="contactDialog"
        aria-labelledby="contactTitle">

    <h2 id="contactTitle">
        Contact us
    </h2>

    <form action="/contact-handler.php" method="post">
        <label for="contactEmail">
            Your email
        </label>

        <input
            type="email"
            id="contactEmail"
            name="email"
            required
            autocomplete="email"
            autofocus
        >

        <label for="contactMessage">
            Your message
        </label>

        <textarea
            id="contactMessage"
            name="message"
            required
        ></textarea>

        <button type="submit">
            Send message
        </button>

        <button type="button" id="closeContact">
            Cancel
        </button>
    </form>
</dialog>

Send 버튼은 폼을 정상적으로 제출합니다.

Cancel 버튼은 제출하지 않고 대화상자를 닫아야 합니다:

document.getElementById('closeContact')
    .addEventListener('click', () => {
        document.getElementById('contactDialog').close();
    });

PHP 핸들러는 여전히 제출된 데이터를 검증하고, 안티 스팸 보호를 구현하며, 의미 있는 성공 또는 오류 응답을 반환해야 합니다.

모달 대화상자는 인터페이스를 개선합니다. 서버 측 폼 보안을 대체하지 않습니다.

8. 사용자가 바깥을 클릭하여 대화상자를 닫을 수 있는가?

많은 웹사이트는 방문자가 배경을 클릭하여 팝업을 닫을 수 있도록 허용합니다.

이 동작은 종종 light dismiss라고 불립니다.

최신 HTML에는 대화상자가 바깥 상호작용, 플랫폼 종료 요청 또는 명시적 컨트롤을 통해 닫힐 수 있는지를 지정할 수 있는 closedby 속성이 포함되어 있습니다.

예를 들어:

<dialog id="infoDialog" closedby="any">
    <h2>More information</h2>
    <p>Additional details appear here.</p>

    <form method="dialog">
        <button>Close</button>
    </form>
</dialog>

closedby="any" 값은 이를 지원하는 브라우저에서 light-dismiss 동작을 허용합니다.

그러나 최신 대화상자 기능에 대한 지원은 대상 브라우저에 대해 확인해야 합니다. 기본적인 showModal() 및 close() API는 더 널리 확립되어 있습니다.

중요한 확인 대화상자의 경우 실수로 바깥을 눌러 닫히는 것은 바람직하지 않을 수 있습니다.

모든 경우에 보이는 닫기 또는 취소 컨트롤을 유지하세요.

9. 이러한 일반적인 구현 실수를 피하기

Technical workflow illustration

open 속성을 추가하여 모달 열기

이 코드:

dialog.setAttribute('open', '');

는 다음의 동일한 동작을 제공하지 않습니다:

dialog.showModal();

open 속성은 대화상자를 비모달로 표시합니다. 문서의 나머지 부분을 자동으로 inert 상태로 만들지 않습니다.

실제 모달이 필요할 때는 showModal()을 사용하세요.

open 속성을 제거하여 모달 닫기

활성 모달에서 open 속성을 수동으로 제거하는 것은 피하세요.

다음을 사용하세요:

dialog.close();

이것은 의도된 수명 주기를 따르고 적절한 종료 동작을 보장합니다.

버튼 대신 링크 사용하기

인터페이스 작업을 여는 컨트롤은 일반적으로 버튼이어야 합니다:

<button type="button">Open settings</button>

다른 리소스로의 탐색에는 링크를 사용하세요.

포커스 가시성 잊기

키보드로 탐색하는 사용자는 어떤 컨트롤이 활성 상태인지 보이는 표시가 필요합니다.

대체 없이 브라우저 포커스 윤곽선을 제거하는 대신 명확한 :focus-visible 스타일을 유지하세요.

대화상자를 숨겨진 컨테이너 안에 배치하기

부모 컨테이너가 숨겨져 있거나 CMS가 주변 마크업을 동적으로 교체하는 경우 대화상자가 예상치 않게 동작할 수 있습니다.

페이지 빌더 통합의 경우 안정적인 컨테이너를 사용하고 자바스크립트가 대화상자가 문서에 삽입된 후 실행되도록 하세요.

10. WordPress 또는 Joomla에 대화상자 통합하기

네이티브 dialog 요소를 사용하기 위해 확장 프로그램을 만들 필요는 없습니다.

간단한 웹사이트의 경우 통합은 세 부분으로 구성됩니다:

부분 위치
HTML 마크업 Custom HTML 블록, 모듈, 템플릿 또는 페이지 빌더 요소
CSS 테마 또는 템플릿 커스텀 CSS
자바스크립트 테마/템플릿 커스텀 자바스크립트 또는 지원되는 코드 주입 기능

WordPress

WordPress에서는 계정과 편집기 구성이 필요한 마크업을 허용하는 경우 Custom HTML 블록에 HTML을 배치할 수 있습니다.

테마의 지원되는 커스텀 CSS 메커니즘을 통해 스타일링을 추가하세요.

자바스크립트의 경우 테마에서 지원하는 스크립트 영역, 자식 테마 또는 자바스크립트를 올바르게 처리하는 평판 좋은 코드 삽입 확장 프로그램을 사용하세요.

일부 편집기와 보안 구성은 <script> 요소를 필터링합니다. 콘텐츠 블록에 직접 붙여넣은 자바스크립트가 실행된다고 가정하지 마세요.

Joomla

Joomla에서는 Custom 모듈이나 적절한 HTML 마크업을 허용하는 편집기가 대화상자를 포함할 수 있습니다.

Cassiopeia 기반 사이트의 user.css과 같은 템플릿의 커스텀 스타일시트에 CSS를 추가하세요.

템플릿의 지원되는 커스텀 스크립트 위치나 적절한 확장 프로그램을 통해 자바스크립트를 배치하세요.

구성된 편집기와 텍스트 필터에 따라 Joomla는 콘텐츠가 저장될 때 특정 요소나 속성을 제거할 수 있습니다.

마크업이 사라지면 동일한 코드를 반복해서 붙여넣는 대신 편집기 및 필터링 구성을 검사하세요.

페이지 빌더

동일한 원칙이 비주얼 페이지 빌더에도 적용됩니다: 그들의 HTML, CSS, 자바스크립트 통합 기능을 사용하세요.

동적으로 로드된 콘텐츠의 경우 관련 요소가 존재한 후에만 이벤트 리스너를 초기화하세요.

페이지에 여러 대화상자가 포함된 경우 각각에 고유한 ID를 지정하세요.

11. 게시 전에 모달 테스트하기

데스크톱에서 올바르게 보이는 대화상자도 여전히 사용성 문제가 있을 수 있습니다.

마우스, 키보드, 모바일 기기로 테스트하세요.

테스트 예상 결과
여는 버튼 클릭 대화상자 나타남
Tab 누르기 포커스가 모달의 컨트롤 내에 유지됨
Shift + Tab 누르기 역방향 키보드 탐색 작동
Escape 누르기 허용될 때 대화상자 닫힘
Close 또는 Cancel 클릭 대화상자 닫힘
대화상자 닫기 포커스가 적절히 복귀됨
모바일에서 열기 콘텐츠가 읽기 가능하고 스크롤 가능함
유효하지 않은 폼 제출 검증 피드백이 보임
유효한 폼 제출 애플리케이션이 데이터를 올바르게 처리함
스크린 리더 사용 대화상자에 이해 가능한 이름이 있음

W3C의 WCAG 기법 H102는 네이티브 모달 동작을 검증하는 데 유용한 지침을 제공합니다.

12. 플러그인 대신 대화상자를 언제 사용해야 하는가?

네이티브 대화상자는 소규모이고 집중된 상호작용, 즉 확인, 정보 패널, 간단한 폼에 특히 적합합니다.

다단계 마법사, 고급 갤러리 또는 CMS 워크플로와 깊이 통합된 대화상자와 같은 더 복잡한 요구사항의 경우 전용 컴포넌트나 확장 프로그램이 여전히 더 유지보수하기 쉬운 옵션일 수 있습니다.

네이티브 접근 방식의 장점은 또 다른 자바스크립트 의존성을 도입하지 않고 견고한 브라우저 지원 기반을 제공한다는 것입니다.

또한 직접 구현해야 하는 커스텀 포커스 및 키보드 관리의 양을 줄여줍니다.

결론: 브라우저의 기본 기능으로 시작하세요

모달 대화상자에 대규모 자바스크립트 라이브러리가 필요하지는 않습니다.

네이티브 HTML <dialog> 요소는 접근성 있는 팝업, 확인 메시지, 폼을 위한 효과적인 기반을 제공합니다.

showModal(), close(), method="dialog"과 몇 가지 CSS 규칙으로 최신 브라우저 전반에서 작동하고 기본 제공되는 포커스 및 키보드 동작의 이점을 누리는 인터페이스를 만들 수 있습니다.

WordPress, Joomla 및 커스텀 PHP 웹사이트의 경우 상대적으로 간단한 상호작용을 위해 또 다른 플러그인을 설치하는 것의 효율적인 대안이 될 수 있습니다.

핵심은 네이티브 동작을 올바르게 사용하고, 명확한 컨트롤을 제공하며, 실제 키보드 및 모바일 상호작용으로 결과를 테스트하는 것입니다.

공식 및 기술 참조