Element: thuộc tính ariaBrailleLabel

Baseline 2024
Newly available

Since September 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Thuộc tính ariaBrailleLabel của giao diện Element phản chiếu giá trị của thuộc tính aria-braillelabel, định nghĩa nhãn braille ARIA của phần tử.

Nhãn phần tử này có thể được sử dụng bởi các công nghệ hỗ trợ có thể trình bày nội dung dưới dạng chữ braille, nhưng chỉ nên thiết lập nếu nhãn dành riêng cho chữ braille sẽ cải thiện trải nghiệm người dùng. Thuộc tính aria-braillelabel chứa thêm thông tin về thời điểm nên thiết lập property này.

Giá trị

<string>

Giá trị là một chuỗi, một kiểu giá trị không ràng buộc, được dự định chuyển đổi thành chữ braille.

Ví dụ

Lấy và thiết lập ariaBrailleLabel

Ví dụ này cho thấy cách lấy và thiết lập property ariaBrailleLabel.

HTML

Đầu tiên chúng ta định nghĩa một nút bấm với văn bản nhãn "3 out of 5 stars" và thuộc tính aria-braillelabel với giá trị "\*\*\*". Điều này cho phép màn hình braille hiển thị "btn ***" dưới dạng chữ braille thay vì "btn gra 3 out of 5 stars" dài dòng hơn.

html
<button id="button" aria-braillelabel="\*\*\*">3 out of 5 stars</button>

JavaScript

Đoạn mã sau đó sử dụng property ariaBrailleLabel của nút bấm để trước tiên lấy và ghi lại nhãn braille. Sau đó thiết lập nhãn braille thành "3*" và ghi lại giá trị một lần nữa.

js
const button = document.getElementById("button");
log(button.ariaBrailleLabel);
button.ariaBrailleLabel = "3*";
log(button.ariaBrailleLabel);

Kết quả

Đặc tả kỹ thuật

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-ariabraillelabel

Tương thích trình duyệt