ARIA: thuộc tính aria-describedby

Mô tả

Thuộc tính aria-describedby liệt kê các giá trị id của những phần tử mô tả đối tượng. Nó được dùng để thiết lập mối quan hệ giữa widget hoặc nhóm phần tử và phần văn bản mô tả chúng.

Thuộc tính aria-describedby không chỉ giới hạn ở các điều khiển biểu mẫu. Nó cũng có thể được dùng để liên kết văn bản tĩnh với widget, nhóm phần tử, các vùng có tiêu đề, định nghĩa, và nhiều thứ khác. Thuộc tính aria-describedby có thể được dùng với các phần tử HTML ngữ nghĩa cũng như với các phần tử có vai trò ARIA.

Thuộc tính aria-describedby rất giống với thuộc tính aria-labelledby. Trong khi aria-labelledby liệt kê các id của nhãn hoặc các phần tử mô tả bản chất của một đối tượng, aria-describedby liệt kê các id của phần mô tả hoặc các phần tử cung cấp thêm thông tin mà người dùng có thể cần. Cả aria-labelledby lẫn aria-describedby đều tham chiếu các phần tử khác để tính toán một văn bản thay thế, nhưng nhãn nên ngắn gọn, còn mô tả nhằm cung cấp thông tin dài hơn; nhãn mô tả bản chất của một đối tượng, còn mô tả cung cấp thêm thông tin mà người dùng có thể cần.

Các phần tử được liên kết qua aria-describedby không cần phải hiển thị. Có thể tham chiếu tới một phần tử ngay cả khi phần tử đó bị ẩn. Ví dụ, một điều khiển biểu mẫu có thể có mô tả được ẩn theo mặc định và chỉ hiện ra khi người dùng yêu cầu bằng một widget mở rộng như biểu tượng "thêm thông tin". Người dùng nhìn thấy có thể nhấp vào biểu tượng để xem mô tả, trong khi người dùng công nghệ hỗ trợ có thể truy cập ngay mô tả đó vì phần tử điều khiển biểu mẫu tham chiếu nó qua aria-describedby.

Thuộc tính aria-describedby phù hợp khi nội dung liên kết chứa văn bản thuần túy. Nếu nội dung dài, chứa ngữ nghĩa hữu ích, hoặc có cấu trúc phức tạp cần điều hướng, hãy dùng aria-details thay thế. aria-details cho phép người dùng công nghệ hỗ trợ truy cập nội dung có cấu trúc liên quan và cung cấp các lệnh điều hướng bổ sung, giúp hiểu cấu trúc hoặc tiếp nhận thông tin thành từng phần nhỏ dễ hơn.

Ví dụ

<button aria-describedby="trash-desc">Move to trash</button>
…
<p id="trash-desc">
  Items in the trash will be permanently removed after 30 days.
</p>

Giá trị

Danh sách tham chiếu ID

id hoặc danh sách các id phần tử được phân tách bằng khoảng trắng mô tả phần tử hiện tại.

Giao diện liên quan

Element.ariaDescribedByElements

Thuộc tính ariaDescribedByElements là một phần của giao diện của mỗi phần tử. Giá trị của nó là một mảng các lớp con của Element phản ánh các tham chiếu id trong thuộc tính aria-describedby (với một số lưu ý).

ElementInternals.ariaDescribedByElements

Thuộc tính ariaDescribedByElements là một phần của giao diện của mỗi phần tử tùy chỉnh. Giá trị của nó là một mảng các lớp con của Element phản ánh các tham chiếu id trong thuộc tính aria-describedby (với một số lưu ý).

Vai trò liên quan

Được dùng trong tất cả vai trò. Cũng có thể dùng trên mọi phần tử HTML.

Đặc tả

Xem thêm

• aria-labelledby
• aria-description
• aria-details
• Browser and AT support for aria-describedby