ARIA: thuộc tính aria-posinset

Mô tả

Viết tắt của "position in set", thuộc tính aria-posinset xác định vị trí của phần tử trong toàn bộ tập listitem hoặc treeitem khi chỉ có một phần các mục hiện diện trong DOM.

Nếu tất cả các mục trong danh sách đều có trong DOM, trình duyệt có thể tự tính tổng số và vị trí của từng mục, nên aria-posinset là không cần thiết. Khi chỉ có một phần của tập nằm trong DOM, hãy thêm aria-posinset để cung cấp thông tin về vị trí của phần tử trong tập cùng với aria-setsize để cho người dùng biết toàn bộ tập có bao nhiêu mục.

Ví dụ sau cho thấy một listbox với bốn tùy chọn trên tổng số 118 nguyên tố trong bảng tuần hoàn.

<h2 id="periodic-table">Periodic table of chemical elements</h2>
<ul role="listbox" aria-labelledby="periodic-table">
  <li role="option" aria-setsize="118" aria-posinset="1">Hydrogen</li>
  <li role="option" aria-setsize="118" aria-posinset="3">Lithium</li>
  <li role="option" aria-setsize="118" aria-posinset="11">Sodium</li>
  <li role="option" aria-setsize="118" aria-posinset="19">Potassium</li>
</ul>

Giá trị của mỗi aria-posinset là một số nguyên lớn hơn hoặc bằng 1, và nhỏ hơn hoặc bằng kích thước của tập khi kích thước đó đã biết.

Với menuitem, menuitemcheckbox, hoặc menuitemradio, hãy đặt giá trị aria-posinset theo tổng số mục trong menu, không tính các separator.

Trong một feed, mỗi phần tử <article> có aria-posinset được đặt thành một giá trị biểu thị vị trí của nó trong feed, cùng với aria-setsize được đặt bằng số bài viết đã tải hoặc tổng số bài viết trong feed, tùy giá trị nào hữu ích hơn cho người dùng.

Giá trị

<integer>

Số nguyên lớn hơn hoặc bằng 1, và nhỏ hơn hoặc bằng giá trị của aria-setsize.

Giao diện liên quan

Element.ariaPosInSet

Thuộc tính ariaPosInSet, thuộc giao diện Element, phản ánh giá trị của thuộc tính aria-posinset.

ElementInternals.ariaPosInSet

Thuộc tính ariaPosInSet, thuộc giao diện ElementInternals, phản ánh giá trị của thuộc tính aria-posinset.

Vai trò liên quan

Được dùng trong các vai trò:

• article
• associationlistitemkey
• associationlistitemvalue
• comment
• listitem
• menuitem
• option
• radio
• row
• tab

Kế thừa vào các vai trò:

• comment
• menuitemcheckbox
• menuitemradio
• treeitem

Thông số kỹ thuật

Xem thêm

• aria-setsize