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

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

View in English Always switch to English

HTMLTextAreaElement: setCustomValidity() メソッド

Baseline 広く利用可能

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

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

構文

js
setCustomValidity(string)

引数

string

エラーメッセージが格納されている文字列。空文字列を指定すると、独自の検証エラーがすべて除去されます。

返値

なし (undefined)。

例

この例では、もし <textarea> が制約検証を合格しなかった場合、検証を通らなかった制約に基づいて独自エラーを指定します。値が有効な場合は、独自エラーを空文字列に設定します。

js
const comment = document.getElementById("comment");
if (comment.validity.valueMissing) {
  comment.setCustomValidity("空のコメントを送信することはできません。");
} else if (comment.validity.tooShort) {
  comment.setCustomValidity("もっと伝えてください。コメントが短すぎます。");
} else if (comment.validity.tooLong) {
  comment.setCustomValidity(
    "おしゃべり好きですか？ 800 文字以内に収めてください！",
  );
} else {
  comment.setCustomValidity("");
}

仕様書

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

ブラウザーの互換性

関連情報

MDN の改良に協力

協力方法を知る

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

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