Skip to content

ARIA 역할 해설

ARIA 역할 값 치트시트: 랜드마크, 문서, 위젯, 라이브 리전 역할을 목적과 사용 사례와 함께 정리했습니다.

ARIA 역할은 요소가 하는 일을 선언합니다. 랜드마크 역할은 페이지 영역을 매핑합니다. 문서 역할은 콘텐츠를 구조화합니다. 위젯 역할은 인터랙티브 컨트롤을 표시합니다. 라이브 리전 역할은 동적 업데이트를 알립니다.

참고 표 · 77 항목
77 of 77 rows
랜드마크
페이지 상단의 사이트 헤더를 식별합니다.브랜드 로고, 주요 태그라인, 페이지 상단 마스트헤드.
탐색 링크 모음을 그룹화합니다.주 메뉴, 브레드크럼, 페이지 내 탐색.
문서의 지배적인 콘텐츠를 표시합니다.페이지의 유일한 본문.
main과 분리된 보조 콘텐츠를 표시합니다.사이드바, 관련 링크, 콜아웃.
부모 문서에 대한 푸터 메타데이터를 그룹화합니다.저작권 표기, 개인정보 링크, 법적 푸터.
검색 폼을 포함하는 영역을 표시합니다.사이트 검색, 필터 폼, 찾기 상자.
이름이 있는 지각 가능한 페이지 섹션을 표시합니다.접근성 이름을 가진 사용자 지정 섹션.
폼 필드 집합을 포함하는 영역을 표시합니다.이름 있는 검색 폼, 필터 패널, 설문 섹션.
소프트웨어 애플리케이션처럼 동작하는 영역을 표시합니다.전체 페이지 편집기, 지도, 게임 화면.
문서
자립적인 구성 단위를 표시합니다.블로그 게시물, 뉴스 항목, 제품 카드.
콘텐츠 섹션의 제목을 표시합니다.네이티브 h1-h6을 쓸 수 없을 때의 섹션 제목.
관련 항목의 목록을 그룹화합니다.사용자 지정 글머리 기호 또는 번호 목록.
목록 안의 단일 항목을 표시합니다.사용자 지정 목록의 한 행.
관련 폼 컨트롤 집합을 그룹화합니다.폼 필드셋, 라디오 그룹, 관련 입력.
캡션과 짝을 이루는 그래픽 콘텐츠를 표시합니다.레이블이 있는 이미지, 다이어그램, 차트.
행과 열로 배열된 데이터를 표시합니다.사용자 지정 요소로 만든 표 형식 데이터.
표, 그리드, 피겨의 보이는 레이블을 표시합니다.데이터 표 위의 제목, 그림 레이블.
표 안의 관련 행 집합을 그룹화합니다.표의 헤더, 본문, 푸터 밴드.
표 또는 그리드의 한 줄 셀을 표시합니다.사용자 지정 표의 단일 레코드 행.
표 열의 헤더 셀을 표시합니다.데이터 표의 상단 레이블.
표 행의 헤더 셀을 표시합니다.각 표 행의 앞쪽 레이블.
행 안의 단일 데이터 셀을 표시합니다.사용자 지정 표 행의 개별 값.
정의되는 단어나 구를 표시합니다.사전 키, 정의 목록 용어.
앞선 용어의 의미를 표시합니다.정의된 용어 아래의 설명.
본문 옆에 놓이는 짧은 기록을 표시합니다.팁, 별도 언급, 각주 스타일 메모.
그룹 구성원에 대한 참조 목록을 표시합니다.목차와 링크 인덱스(ARIA 1.2에서 폐기됨).
스크롤 가능한 문서 섹션 목록을 표시합니다.더 많은 콘텐츠를 불러오는 무한 스크롤 스트림.
수학 표기법으로 작성된 콘텐츠를 표시합니다.LaTeX 또는 MathML로 렌더링된 수식.
알려진 범위 안의 스칼라 값을 표시합니다.디스크 사용량 바, 점수, 강도 게이지.
특정 시점 또는 기간을 표시합니다.타임스탬프, 이벤트 날짜, 경과 시간.
산문 텍스트 블록을 표시합니다.네이티브 p 요소로 작성되지 않은 텍스트 블록.
다른 출처에서 가져온 인용문을 표시합니다.풀 인용과 출처가 있는 발췌.
컴퓨터 코드 조각을 표시합니다.본문 안의 인라인 스니펫과 명령어 이름.
강세를 담은 텍스트를 표시합니다.문장 안에서 강조하는 단어.
강한 중요도를 가진 텍스트를 표시합니다.경고, 핵심 구문, 필독 레이블.
기준선 아래에 렌더링되는 텍스트를 표시합니다.H2O 같은 화학식.
기준선 위에 렌더링되는 텍스트를 표시합니다.각주 표기와 지수.
특별한 의미 없는 단순 컨테이너를 표시합니다.레이아웃 래퍼와 스타일링 훅.
요소에서 의미론을 제거합니다.장식용 이미지, 레이아웃 표, 구분 요소.
요소를 단일 이미지로 표시합니다.아이콘 스프라이트, SVG 그룹, CSS로 그린 그래픽.
위젯
동작을 일으키는 클릭 가능한 컨트롤을 표시합니다.사용자 지정 버튼, 아이콘 버튼, 동작 트리거.
다른 리소스나 위치로 가는 링크를 표시합니다.사용자 지정 앵커와 앱 내 라우트 링크.
단일 옵션의 토글을 표시합니다.사용자 지정 체크박스, 약관 동의 토글.
상호 배타적 그룹의 한 선택지를 표시합니다.radiogroup 안의 사용자 지정 라디오.
이진 켜기/끄기 토글을 표시합니다.테마, 음소거, 설정 토글.
탭 집합의 레이블을 그룹화합니다.탭 패널의 탭 스트립.
tablist 안의 단일 레이블을 표시합니다.하나의 패널을 보여 주는 단일 탭.
한 탭의 콘텐츠 패널을 표시합니다.해당 탭이 활성일 때 표시되는 본문.
페이지 위에 겹쳐지는 오버레이 창을 표시합니다.모달, 드로어, 포커스를 잡는 팝오버.
사용자 응답을 요구하는 대화 상자를 표시합니다.삭제 확인, 저장되지 않은 변경 프롬프트.
선택지 팝업이 있는 입력을 표시합니다.자동 완성, 검색 선택, 타입어헤드 목록.
범위 안의 값을 설정하는 컨트롤을 표시합니다.음량, 가격, 불투명도, 범위 입력.
사용자에게 제시하는 선택지 목록을 표시합니다.드롭다운 메뉴, 컨텍스트 메뉴, 도구 팔레트.
메뉴 안의 단일 옵션을 표시합니다.드롭다운 메뉴의 한 행 또는 한 항목.
자유 형식 텍스트 입력 필드를 표시합니다.사용자 지정 입력, 검색 필드, 댓글 상자.
계층적 항목 목록을 표시합니다.파일 탐색기, 중첩 메뉴, 조직도.
선택 가능한 옵션 목록을 표시합니다.하나 또는 여러 선택을 위한 사용자 지정 피커.
listbox 안의 단일 선택지를 표시합니다.사용자 지정 listbox의 선택 가능한 한 항목.
상호 배타적 선택지 집합을 그룹화합니다.사용자 지정 라디오 세트, 요금제 선택, 척도 응답.
행과 열의 셀로 이루어진 위젯을 표시합니다.스프레드시트 레이아웃, 달력 월 보기.
행을 펼치고 접을 수 있는 그리드를 표시합니다.중첩 데이터 표, 메일 스레드 표.
트리 안의 펼칠 수 있는 한 옵션을 표시합니다.파일 탐색기의 파일 또는 폴더 노드.
컨트롤을 암시하는 팝업을 표시합니다.호버 힌트, 아이콘 버튼의 포커스 팁.
작업 진행률을 보여 주는 요소를 표시합니다.업로드 바와 로딩 인디케이터.
콘텐츠 뷰를 스크롤하는 컨트롤을 표시합니다.창과 캐러셀용 사용자 지정 스크롤 핸들.
값을 단계적으로 바꾸는 컨트롤을 표시합니다.수량 피커, 숫자 스테퍼.
검색어를 입력하는 텍스트 필드를 표시합니다.사용자 지정 검색창과 필터 필드.
자주 쓰는 컨트롤 그룹을 표시합니다.서식 바, 편집기 위의 동작 행.
항상 표시되는 메뉴 트리거 행을 표시합니다.앱 스타일의 파일/편집 메뉴 스트립.
켜고 끄는 메뉴 옵션을 표시합니다.드롭다운 메뉴 안의 보기 옵션 토글.
메뉴 안의 배타적 한 선택지를 표시합니다.메뉴 안의 정렬 순서와 테마 선택.
콘텐츠 그룹 사이의 구분선을 표시합니다.메뉴 구분선, 드래그 가능한 창 분할자.
라이브 리전
시간에 민감한 중요 메시지를 알립니다.폼 오류, 주의가 필요한 긴급 알림.
중단 없이 참고용 업데이트를 알립니다.저장 확인, 진행률, 가벼운 결과.
시간순 스트림의 새 항목을 알립니다.채팅 기록, 이벤트 로그, 활동 피드.
스크롤되거나 움직이는 텍스트 콘텐츠를 알립니다.티커, 스크롤 뉴스 바, 회전 배너.
라이브 타이머 또는 카운트다운을 알립니다.세션 시간 제한, 카운트다운, 스톱워치.