ElementInternals: reportValidity() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2023.

Phương thức reportValidity() của giao diện ElementInternals kiểm tra xem phần tử có đáp ứng bất kỳ quy tắc xác thực ràng buộc nào được áp dụng cho nó hay không.

Nếu reportValidity trả về false, một sự kiện invalid có thể hủy bỏ sẽ được kích hoạt trên phần tử.

Phương thức này hoạt động theo cách tương tự như ElementInternals.checkValidity(), tuy nhiên nó còn gửi thêm giá trị của ElementInternals.validationMessage đến tác nhân người dùng để hiển thị.

Cú pháp

reportValidity()

Giá trị trả về

Một giá trị boolean, true nếu phần tử đáp ứng tất cả các ràng buộc xác thực.

Ngoại lệ

NotSupportedError DOMException: Được ném ra nếu phần tử không có thuộc tính formAssociated được đặt thành true.

Trong ví dụ sau, ElementInternals.setValidity() được sử dụng để chỉ ra rằng phần tử không đáp ứng các quy tắc xác thực. Gọi reportValidity() trả về false, và giá trị "my message" được gửi đến tác nhân người dùng để hiển thị.

Sau khi gọi setValidity lần nữa, lần này chỉ ra rằng tất cả các quy tắc đều được đánh dấu là false, reportValidity() trả về true.

let element = document.getElementById("join-checkbox");
element.internals_.setValidity({ valueMissing: true }, "my message");
console.log(element.internals_.reportValidity()); // false
element.internals_.setValidity({});
console.log(element.internals_.reportValidity()); // true