ARIA: thuộc tính aria-haspopup

Mô tả

Khi một phần tử tương tác như button, link, hoặc menuitem mở ra một phần tử giao diện người dùng khác, thuộc tính aria-haspopup giúp công nghệ hỗ trợ biết rằng có một phần tử bật lên liên quan. Điều này có thể là menu, listbox, tree, grid, hoặc dialog.

Giá trị của aria-haspopup nên phản ánh loại popup được mở. Giá trị mặc định là false, nghĩa là phần tử không có popup liên quan. Khi một popup tồn tại nhưng chưa mở, vẫn có thể khai báo thuộc tính này để công nghệ hỗ trợ có thể báo trước cho người dùng.

Nếu popup là một menu, hãy dùng aria-haspopup="menu" hoặc true. Đối với các popup khác, dùng vai trò tương ứng của popup làm giá trị.

Ví dụ, một button có thể mở một menu ngữ cảnh:

<button aria-haspopup="menu" aria-controls="menu1">Tùy chọn</button>

Khi popup được hiển thị, aria-expanded thường được dùng cùng với aria-haspopup để cho biết trạng thái mở hay đóng.

Giá trị

false (mặc định)

Phần tử không kích hoạt popup.

true

Phần tử kích hoạt một menu popup.

menu

Phần tử kích hoạt một menu popup.

listbox

Phần tử kích hoạt một listbox popup.

tree

Phần tử kích hoạt một tree popup.

grid

Phần tử kích hoạt một grid popup.

dialog

Phần tử kích hoạt một dialog popup.

Giao diện liên quan

Element.ariaHasPopup

Thuộc tính ariaHasPopup, là một phần của giao diện Element, phản ánh giá trị của thuộc tính aria-haspopup.

ElementInternals.ariaHasPopup

Thuộc tính ariaHasPopup, là một phần của giao diện ElementInternals, phản ánh giá trị của thuộc tính aria-haspopup.

Vai trò liên quan

Được dùng trong hầu hết các vai trò tương tác.

Đặc tả

Xem thêm

• aria-expanded
• aria-controls
• aria-activedescendant