ARIA: các vai trò cấu trúc tài liệu
Các vai trò cấu trúc tài liệu ARIA được dùng để cung cấp mô tả cấu trúc cho một phần nội dung.
Các vai trò cấu trúc ARIA ban đầu được tạo ra như một cầu nối để báo cho công nghệ hỗ trợ về các phần tử HTML5 chưa được trình duyệt hỗ trợ đầy đủ. Một số vai trò, như presentation, toolbar và tooltip, cung cấp thông tin về cấu trúc tài liệu cho công nghệ hỗ trợ trong các trường hợp không có phần tử HTML gốc tương đương. Các vai trò khác, bao gồm những vai trò được liệt kê trong bảng bên dưới, không cần thiết vì đã có các phần tử HTML ngữ nghĩa với cùng ý nghĩa. Trong nhiều trường hợp, các phần tử HTML tương đương này vốn đã được hỗ trợ.
Warning: Tất cả các vai trò cấu trúc này đều có phần tử HTML ngữ nghĩa tương đương. Chúng được đưa vào đây chỉ để hoàn chỉnh tài liệu. Tốt nhất là tác giả web không nên dùng chúng. Hãy ưu tiên các phần tử HTML ngữ nghĩa thay thế.
Một số vai trò cấu trúc, như suggestion, không có phần tử HTML tương đương, vì vậy có tài liệu riêng. Một số vai trò cấu trúc có phần tử HTML tương đương, như heading, lại có các yêu cầu về thuộc tính ARIA. Chúng được liệt kê bên dưới cùng với liên kết đến tài liệu riêng của từng vai trò.
Phần lớn các vai trò sau đây vốn không bao giờ cần thiết nhưng đã được thêm vào ARIA để hoàn chỉnh. Chúng tôi cũng đưa chúng vào đây để hoàn chỉnh tài liệu.
Các vai trò cấu trúc có phần tử HTML tương đương
Các vai trò cấu trúc có phần tử HTML tương đương được liệt kê bên dưới:
| Vai trò ARIA & mô tả | Phần tử HTML tương đương |
|---|---|
associationlist Chỉ chứa các phần tử con associationlistitemkey và phần tử anh em associationlistitemvalue của chúng. |
<dl> |
associationlistitemkey Phải được chứa trong một associationlist. |
<dt> |
associationlistitemvalue Luôn là một phần tử anh em theo sau associationlistitemkey. |
<dd> |
blockquote Một phần nội dung được trích dẫn từ nguồn khác. |
<blockquote> |
caption Nội dung hiển thị dùng để đặt tên, và cũng có thể mô tả, một figure, table, grid, hoặc treegrid.Chỉ có trong 4 vai trò này. id của caption thường được aria-labelledby của figure, grid, table, hoặc treegrid tham chiếu tới.Thuộc tính bị cấm: aria-label và aria-labelledby. |
<caption> <figcaption> |
code Một phần đại diện cho một đoạn mã máy tính. Thuộc tính bị cấm: aria-label và aria-labelledby. |
<code> |
deletion Nội dung được đánh dấu là đã bị xóa hoặc được đề xuất để xóa. Thuộc tính bị cấm: aria-label và aria-labelledby. |
<del> |
emphasis Dùng để nhấn mạnh nội dung, nhưng không nhằm gợi ý mức độ quan trọng. Thuộc tính bị cấm: aria-label và aria-labelledby. |
<em> |
figure Vùng chứa cho tài liệu đồ họa, hình ảnh, đoạn mã, hoặc văn bản ví dụ. |
<figure> |
heading Một tiêu đề cho một phần của trang. Thuộc tính aria-level là bắt buộc để chỉ mức lồng nhau.Xem thêm heading role để biết thêm thông tin. |
h1, h2, h3, h4, h5, và h6 |
image Vùng chứa cho một tập hợp các phần tử tạo thành một hình ảnh. Từ đồng nghĩa với vai trò img. |
<img> |
img Vùng chứa cho một tập hợp các phần tử tạo thành một hình ảnh. Bắt buộc phải có tên truy cập được. Xem thêm img role để biết thêm thông tin. |
<img> |
insertion Nội dung được đánh dấu là đã thêm hoặc nội dung đang được đề xuất để thêm. Thuộc tính bị cấm: aria-label và aria-labelledby. |
<ins> |
listMột phần chứa các phần tử listitem.Xem thêm list role để biết thêm thông tin |
<ol><ul> |
listitemMột mục đơn trong list hoặc directory.Phải được chứa trong một list (giống như <li>).Xem thêm listitem role để biết thêm thông tin. |
<li> |
markĐược đánh dấu hoặc tô sáng cho mục đích tham chiếu hoặc ghi chú. Xem thêm mark role để biết thêm thông tin. |
<mark> |
meter Một phép đo vô hướng trong một khoảng đã biết, hoặc một giá trị phân số. Bắt buộc phải có tên truy cập được. Bắt buộc aria-valuenow.Xem thêm meter role để biết thêm thông tin. |
<meter> |
paragraph Một đoạn nội dung. Thuộc tính bị cấm: aria-label và aria-labelledby. |
<p> |
strong Nội dung quan trọng, nghiêm trọng, hoặc khẩn cấp. Thuộc tính bị cấm: aria-label và aria-labelledby. |
<strong> |
subscript Một hoặc nhiều ký tự chỉ số dưới. Chỉ dùng nếu việc bỏ vai trò này sẽ làm thay đổi ý nghĩa nội dung. Thuộc tính bị cấm: aria-label và aria-labelledby. |
<sub> |
superscript Một hoặc nhiều ký tự chỉ số trên. Chỉ dùng nếu việc bỏ vai trò này sẽ làm thay đổi ý nghĩa nội dung. Thuộc tính bị cấm: aria-label và aria-labelledby. |
<sup> |
termTừ hoặc cụm từ với một định nghĩa tương ứng tùy chọn. Thuộc tính bị cấm: aria-label và aria-labelledby.Xem thêm term role để biết thêm thông tin. |
<dfn> |
time Một định dạng chuỗi ngày hoặc giờ hợp lệ chỉ một thời điểm cụ thể. Thuộc tính bị cấm: aria-label và aria-labelledby. |
<time> |
Note:
Các thuộc tính aria-label và aria-labelledby bị cấm trên code, caption, deletion, emphasis, generic, insertion, mark, paragraph, presentation, none, strong, subscript, superscript, suggestion, term, và time, và chỉ nên được dùng trên nội dung tương tác.
Thông số kỹ thuật
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # document_structure_roles |