HTMLButtonElement: checkValidity() 方法

基线 广泛可用

此功能已经很成熟,并且在许多设备和浏览器版本中都能正常工作。它从 2018 年 12 月.

报告反馈

checkValidity() 方法是 HTMLButtonElement 接口的方法,它返回一个布尔值,表示元素是否符合应用于它的任何 约束验证 规则。如果为 false,该方法还会在元素上触发 invalid 事件。由于 checkValidity() 没有默认的浏览器行为,因此取消此 invalid 事件不会产生任何影响。

语法

注意:HTML <button> 元素如果具有非空 validationMessage,则被视为无效,将匹配 CSS :invalid 伪类,并将导致 checkValidity() 返回 false。使用 HTMLButtonElement.setCustomValidity() 方法将 HTMLButtonElement.validationMessage 设置为空字符串,以将 validity 状态设置为有效。
checkValidity()

js

参数

无。

返回值

示例

如果元素的值没有有效性问题,则返回 true;否则,返回 false

注意:HTML <button> 元素如果具有非空 validationMessage,则被视为无效,将匹配 CSS :invalid 伪类,并将导致 checkValidity() 返回 false。使用 HTMLButtonElement.setCustomValidity() 方法将 HTMLButtonElement.validationMessage 设置为空字符串,以将 validity 状态设置为有效。
const element = document.getElementById("myButton");
console.log(element.checkValidity());

规范

在下面的示例中,调用 checkValidity() 将返回 truefalse
规范
# HTML 标准

浏览器兼容性

dom-cva-checkvalidity-dev

另请参阅