속성 · 이름·설명 · 전역
aria-braillelabel
점자 디스플레이에 표시할 점자용 이름을 따로 정합니다. WAI-ARIA 1.3 초안에 추가된 속성입니다.
한눈에 보기
- 구분
- 속성 (Property)
- 분류
- 이름·설명
- 값 형식
- 문자열 (string)
- 기본값
없음- 적용 범위
- 모든 요소 (전역 속성)
- HTML 대체
- 없음
설명
aria-braillelabel은 점자 디스플레이(화면낭독기의 출력을 점자로 보여 주는 장치)에 접근 가능한 이름 대신 표시할 문자열을 정합니다. 음성으로는 기존 이름이 그대로 읽히고, 점자 출력에서만 이 값이 쓰입니다.
WAI-ARIA 1.3 작업 초안 속성입니다
이 속성은 현재 권고안(WAI-ARIA 1.2)에는 없고 WAI-ARIA 1.3 작업 초안에 정의되어 있습니다. 일부 최신 브라우저와 화면낭독기가 지원을 시작했지만 지원 범위가 좁고, 특히 한국어 점자에서의 동작은 충분히 검증되지 않았습니다. 일반적인 웹 서비스에서는 쓸 일이 거의 없습니다.
명세가 상정하는 경우는 이름을 그대로 점자로 옮기면 오히려 이해하기 어려운 경우입니다. 예를 들어 이모지나 기호로 된 이름, 점자 사용자에게 통용되는 기호나 약어가 따로 있는 경우입니다. 점자 디스플레이는 한 번에 표시할 수 있는 칸 수가 적어 짧은 표현이 도움이 되기도 합니다.
명세는 이 속성을 이미 접근 가능한 이름이 있는 요소에만 쓰고, 점자 사용자를 위해 꼭 필요한 경우에만 쓰라고 안내합니다. 값이 비어 있거나 이름을 그대로 반복하면 의미가 없습니다. 점자 사용자를 대상으로 실제로 검증하지 않은 값은 오히려 혼란을 줄 수 있습니다.
테스트에는 실제 점자 디스플레이(또는 화면낭독기의 점자 뷰어)가 필요합니다. NVDA의 점자 뷰어(도구 메뉴)로 출력 내용을 확인할 수 있습니다. 음성 출력은 바뀌지 않아야 하며, 지원하지 않는 환경에서는 원래 이름이 그대로 점자로 표시됩니다.
값
| 값 | 의미 |
|---|---|
문자열 | 점자 출력에 접근 가능한 이름 대신 표시할 텍스트입니다. |
사용 예
기호로 된 이름을 점자 표현으로
<button type="button" aria-label="별점 5점 만점에 4점" aria-braillelabel="★4/5">★★★★☆</button>음성은 “별점 5점 만점에 4점, 버튼”, 점자에는 지원 환경에서 “★4/5”가 표시됩니다. 실제로는 점자 사용자와 함께 표현을 검증한 뒤에 씁니다.
이름이 없는 요소에 사용 (비권장)
<div aria-braillelabel="알림">…</div>접근 가능한 이름이 있는 요소에만 씁니다. 역할 없는 <div>는 이름 자체를 가질 수 없습니다.
화면낭독기에서는
| 상황 | 들리는 안내 (예) |
|---|---|
aria-braillelabel이 있는 버튼에 포커스 (음성) | 별점 5점 만점에 4점, 버튼 |
| 같은 버튼의 점자 출력 (지원 환경) | ★4/5 btn |
사용 지침
이렇게 쓰세요
- 접근 가능한 이름이 이미 있는 요소에만 씁니다.
- 점자 사용자에게 실제로 도움이 되는지 검증한 값만 씁니다.
- 지원하지 않는 환경에서도 기존 이름만으로 이해할 수 있게 둡니다.
이렇게 쓰지 마세요
- 이름을 그대로 반복하는 값을 넣지 않습니다.
- 빈 문자열이나 공백을 넣지 않습니다.
- 음성 이름을 바꾸려는 목적으로 쓰지 않습니다. 이 속성은 점자 출력에만 영향을 줍니다.
사용할 수 있는 역할
전역 속성이므로 모든 역할과 HTML 요소에 쓸 수 있습니다. 특히 다음 역할과 자주 함께 씁니다.