속성 · 이름·설명 · 전역
aria-brailleroledescription
aria-roledescription으로 바꾼 역할 이름의 점자용 짧은 표현을 정합니다. WAI-ARIA 1.3 초안에 추가된 속성입니다.
한눈에 보기
- 구분
- 속성 (Property)
- 분류
- 이름·설명
- 값 형식
- 문자열 (string)
- 기본값
없음- 적용 범위
- 모든 요소 (전역 속성)
- HTML 대체
- 없음
설명
aria-brailleroledescription은 점자 디스플레이에서 역할 설명 대신 표시할 문자열을 정합니다. 화면낭독기는 점자 출력에서 역할을 “btn”, “lnk”처럼 줄여서 보여 주는데, aria-roledescription으로 만든 사용자 정의 역할 이름에는 이런 약어가 없어 전체 문구가 그대로 표시됩니다. 이 속성은 그 약어를 작성자가 제공하게 합니다.
WAI-ARIA 1.3 작업 초안 속성입니다
이 속성은 현재 권고안(WAI-ARIA 1.2)에는 없고 WAI-ARIA 1.3 작업 초안에 정의되어 있습니다. 지원하는 브라우저·화면낭독기가 아직 적고, 한국어 점자 환경에서의 동작은 충분히 검증되지 않았습니다.
명세는 aria-roledescription이 함께 있는 요소에만 이 속성을 쓰라고 안내합니다. 원래 역할에는 화면낭독기가 이미 표준 약어를 갖고 있기 때문입니다. 또한 값은 비어 있지 않아야 하고, aria-roledescription과 같은 값을 반복해서는 안 됩니다.
음성 출력에는 영향이 없으며, 지원하지 않는 환경에서는 aria-roledescription 값이 그대로 점자로 표시됩니다. 따라서 이 속성이 없어도 정보 손실은 없고, 점자 화면 공간을 아끼는 보조적인 역할만 합니다.
테스트에는 점자 디스플레이나 NVDA 점자 뷰어 같은 점자 출력 확인 도구가 필요합니다. 값이 점자 사용자에게 의미가 통하는 약어인지 점자 사용자와 함께 검증하는 것이 좋습니다.
값
| 값 | 의미 |
|---|---|
문자열 | 점자 출력에서 역할 설명 대신 표시할 짧은 텍스트입니다. |
사용 예
슬라이드 역할 설명의 점자 약어
<div role="group" aria-roledescription="슬라이드" aria-brailleroledescription="sld" aria-label="1 / 3">…</div>음성은 “1 / 3, 슬라이드”, 점자에는 지원 환경에서 “1 / 3 sld”처럼 표시됩니다.
aria-roledescription 없이 사용 (비권장)
<button type="button" aria-brailleroledescription="b">저장</button>표준 역할에는 화면낭독기가 이미 약어를 제공합니다. aria-roledescription이 있을 때만 씁니다.
화면낭독기에서는
| 상황 | 들리는 안내 (예) |
|---|---|
| 슬라이드 그룹으로 이동 (음성) | 1 / 3, 슬라이드 |
| 같은 그룹의 점자 출력 (지원 환경) | 1 / 3 sld |
사용 지침
이렇게 쓰세요
aria-roledescription이 있는 요소에만 함께 씁니다.- 점자 사용자에게 통하는 짧은 표현인지 검증하고 씁니다.
- 지원하지 않는 환경에서도 문제없도록 보조 수단으로만 다룹니다.
이렇게 쓰지 마세요
aria-roledescription과 같은 값을 반복하지 않습니다.- 빈 문자열이나 공백을 넣지 않습니다.
- 표준 역할(버튼·링크 등)의 점자 약어를 바꾸려고 쓰지 않습니다.
사용할 수 있는 역할
전역 속성이므로 모든 역할과 HTML 요소에 쓸 수 있습니다. 특히 다음 역할과 자주 함께 씁니다.
관련 속성·패턴
이 속성을 쓰는 패턴