HTMLButtonElement: checkValidity() 方法

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

HTMLButtonElement 接口的 checkValidity() 方法返回一个布尔值,指示该元素是否满足应用于它的任何 约束验证 规则。如果为 false,则该方法还在该元素上触发一个 invalid 事件。由于 checkValidity() 没有默认的浏览器行为,因此取消此 invalid 事件没有效果。如果 <button> 元素的 type"button""reset",它将始终返回 true,因为此类按钮永远不是 约束验证 的候选对象。

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

语法

js
checkValidity()

参数

无。

返回值

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

示例

在以下示例中,调用 checkValidity() 将返回 truefalse

js
const element = document.getElementById("myButton");
console.log(element.checkValidity());

规范

规范
HTML
# dom-cva-checkvalidity-dev

浏览器兼容性

另见