HTMLButtonElement: setCustomValidity() 方法

Baseline 已廣泛支援

此特性已相當成熟，可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來，各瀏覽器均已提供此特性。

setCustomValidity() 方法是 HTMLButtonElement 介面的一部分，用於為 <button> 元素設定自定義的有效性訊息。使用空字串表示該元素沒有自定義的有效性錯誤。

語法

setCustomValidity(string)

引數

string: 包含錯誤訊息的字串。空字串會移除任何自定義有效性錯誤。

返回值

無（undefined）。

示例

const errorButton = document.getElementById("checkErrors");
const errors = issuesToReport();
if (errors) {
  errorButton.setCustomValidity("There is an error");
} else {
  errorButton.setCustomValidity("");
}

規範

規範
HTML # dom-cva-setcustomvalidity-dev

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改時間為 2025年4月10日，由 MDN 貢獻者修改。

在 GitHub 上檢視此頁面 • 報告此內容的問題