Element: thuộc tính ariaInvalid
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 ariaInvalid của giao diện Element phản chiếu giá trị của thuộc tính aria-invalid. Liên quan đến các vai trò application, checkbox, combobox, gridcell, listbox, radiogroup, slider, spinbutton, textbox, và tree, nó cho biết API hỗ trợ tiếp cận liệu giá trị đã nhập có không phù hợp với định dạng mà ứng dụng mong đợi hay không.
Nếu thuộc tính không có mặt, hoặc được đặt thành chuỗi rỗng, công nghệ hỗ trợ sẽ xử lý giá trị như thể nó được đặt thành false. Nếu thuộc tính có mặt nhưng được đặt thành giá trị khác false, grammar, spelling hoặc chuỗi rỗng (""), công nghệ hỗ trợ xử lý giá trị như true. Property phản chiếu giá trị thuộc tính đã được thiết lập, không phải cách xử lý bởi công nghệ hỗ trợ.
Giá trị
Một chuỗi với một trong các giá trị sau:
"true"-
Phần tử không hợp lệ.
"false"(mặc định)-
Phần tử không ở trạng thái không hợp lệ.
"grammar"-
Phần tử ở trạng thái không hợp lệ vì lỗi ngữ pháp được phát hiện.
"spelling"-
Phần tử ở trạng thái không hợp lệ vì lỗi chính tả được phát hiện.
Ví dụ
Trong ví dụ này, thuộc tính aria-invalid trên phần tử có ID quote bị bỏ qua, trả về null và được xử lý như false. Sử dụng ariaInvalid chúng ta cập nhật giá trị thành grammar (vì có hai lỗi).
<div id="quote" role="textbox" contenteditable>you are your best thing..</div>
const el = document.getElementById("quote");
log(`Initial value: ${el.ariaInvalid}`);
el.ariaInvalid = "grammar";
log(`Updated value: ${el.ariaInvalid}`);
Đặc tả kỹ thuật
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariainvalid |