ElementInternals: ariaChecked property

Baseline 2023
Newly available

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

Thuộc tính ariaChecked của giao diện ElementInternals phản ánh giá trị của thuộc tính aria-checked, cho biết trạng thái "đã chọn" hiện tại của các hộp kiểm, nút radio và các widget khác có trạng thái được chọn.

Note: Việc đặt thuộc tính aria trên ElementInternals cho phép xác định ngữ nghĩa mặc định trên một phần tử tùy chỉnh. Chúng có thể bị ghi đè bởi các thuộc tính do tác giả định nghĩa, nhưng đảm bảo rằng ngữ nghĩa mặc định được duy trì trong trường hợp tác giả xóa các thuộc tính đó, hoặc không thêm chúng vào. Để biết thêm thông tin, xem giải thích về Mô hình Đối tượng Truy cập.

Giá trị

Một chuỗi với một trong các giá trị sau:

"true"

Phần tử đã được chọn.

"mixed"

Cho biết giá trị chế độ hỗn hợp cho hộp kiểm ba trạng thái hoặc menuitemcheckbox.

"false"

Phần tử hỗ trợ được chọn nhưng hiện chưa được chọn.

"undefined"

Phần tử không hỗ trợ được chọn.

Ví dụ

Trong ví dụ này, giá trị của ariaChecked được đặt thành "true".

js
class CustomControl extends HTMLElement {
  constructor() {
    super();
    this.internals_ = this.attachInternals();
    this.internals_.ariaChecked = "true";
  }
  // …
}

Thông số kỹ thuật

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

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

Xem thêm