1. ウェブ
  2. Web API
  3. HTMLOutputElement
  4. setCustomValidity()

このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

HTMLOutputElement: setCustomValidity() メソッド

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2016年8月以降、すべてのブラウザーで利用可能です。

setCustomValidity() は HTMLOutputElement インターフェイスのメソッドで、この <output> 要素の独自の検証メッセージを設定します。要素に独自の有効性エラーがないことを示すには、空文字列を使用します。

<output> 要素は、制約の妥当性検証の対象外です。reportValidity() メソッドを実行しても、ユーザーにカスタムエラーメッセージは表示されませんが、要素の ValidityState の customError プロパティを true に、valid プロパティを false に設定します。

構文

js
setCustomValidity(string)

引数

string

エラーメッセージを含む文字列。空文字列を指定すると、独自の有効性エラーがすべて削除されます。

返値

なし (undefined)。

例

この例では、<output> の value が 0 以外の数値でない場合、独自のエラーメッセージを設定します。数値である場合は、独自のエラーを空文字列に設定します。

js
const cart = document.getElementById("cart-form");
const total = cart.elements("total");
if (parseFloat(total.value)) {
  errorOutput.setCustomValidity("");
} else {
  errorOutput.setCustomValidity("エラーがあります");
}

仕様書

仕様書
HTML
# dom-cva-setcustomvalidity-dev

ブラウザーの互換性

関連情報

MDN の改良に協力

協力方法を知る

このページは MDN の貢献者によって に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告