ElementInternals: ariaRelevant property

Non-standard: This feature is not standardized. We do not recommend using non-standard features in production, as they have limited browser support, and may change or be removed. However, they can be a suitable alternative in specific cases where no standard option exists.

Thuộc tính ariaRelevant của giao diện ElementInternals phản ánh giá trị của thuộc tính aria-relevant, cho biết những thông báo nào tác nhân người dùng sẽ kích hoạt khi cây truy cập trong vùng trực tiếp bị sửa đổi. Điều này được sử dụng để mô tả những thay đổi nào trong vùng aria-live là liên quan và cần được thông báo.

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 chứa một hoặc nhiều giá trị sau, phân cách bằng dấu cách:

"additions"

Việc thêm các nút Phần tử trong vùng trực tiếp nên được coi là liên quan.

"removals"

Việc xóa các nút khỏi vùng trực tiếp nên được coi là liên quan.

"text"

Các thay đổi về nội dung văn bản của các nút hiện có nên được coi là liên quan.

"all"

Tương đương với "additions removals text".

Ví dụ

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

js
class CustomEl extends HTMLElement {
  constructor() {
    super();
    this.internals_ = this.attachInternals();
    this.internals_.ariaRelevant = "all";
  }
  // …
}

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