ARIA 접근성 가이드

역할 · 문서 구조

role="definition"

용어나 개념의 정의(뜻풀이)를 나타냅니다. 짝이 되는 용어는 term 역할입니다.

중급HTML 요소 우선

한눈에 보기

분류
문서 구조
대응 HTML
<dd>
이름 정하는 방법
작성자 (author)
이름 필수
아니요
필수 상위 요소
없음
필수 하위 요소
없음

설명

definition은 용어의 정의입니다. 명세는 정의되는 단어에 term 역할을 주고, definition 요소에서 aria-labelledby로 그 용어를 참조하거나 term을 definition 안에 넣으라고 권장합니다.

HTML에서는 설명 목록 <dl>의 <dd>가 definition, <dt>가 term으로 대응합니다. 용어집처럼 용어와 뜻이 짝을 이루는 내용은 <dl>을 쓰는 것이 가장 간단합니다. 문장 안에서 용어를 처음 정의할 때는 <dfn>을 씁니다.

함께 쓰는 속성

전역 속성(이름·설명 등)은 모든 역할에 쓸 수 있어 생략했습니다.

사용 예

설명 목록 (권장)

권장HTML
<dl>
  <dt>랜드마크</dt>
  <dd>페이지의 큰 영역을 나타내 빠르게 이동하게 하는 역할입니다.</dd>
</dl>

문장 속 정의

HTML
<p role="definition" aria-labelledby="t-aria">
  <dfn id="t-aria">WAI-ARIA</dfn>는 보조기술에 역할·상태를 알리는 W3C 명세입니다.
</p>

화면낭독기에서는

화면낭독기 안내 예시 (표현은 화면낭독기·브라우저·버전에 따라 조금씩 다릅니다)
상황들리는 안내 (예)
설명 목록 읽기설명 목록 1개 항목, 랜드마크, 페이지의 큰 영역을 나타내…

사용 지침

이렇게 쓰세요

  • 용어와 뜻이 짝이면 <dl>/<dt>/<dd>를 씁니다.

이렇게 쓰지 마세요

  • 일반 문단에 이유 없이 definition 역할을 붙이지 않습니다.

참고 자료