HTMLTextAreaElement:checkValidity() 方法

Baseline 已广泛支持

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

checkValidity() 方法是 HTMLTextAreaElement 接口的一部分,它返回一个布尔值,指示该元素是否满足应用于它的任何 约束验证 规则。如果返回 false,该方法还会在该元素上触发一个 invalid 事件。由于 checkValidity() 没有默认的浏览器行为,因此取消此 invalid 事件无效。

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

语法

js
checkValidity()

参数

无。

返回值

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

示例

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

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

规范

规范
HTML
# dom-cva-checkvalidity-dev

浏览器兼容性

另见