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

瀏覽器相容性

另見