← 返回首页

HTMLTextAreaElement: setCustomValidity() メソッド - Web API | MDN

サイドバーを切り替え

配色

OS のデフォルト
ライト
ダーク

日本語

言語を記憶もっと知る

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

ブラウザーの互換性

ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。

関連情報

MDN の改良に協力

このページは役に立ちましたか？

はいいいえ

協力方法を知る

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

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

HTML DOM API
HTMLTextAreaElement
インスタンスプロパティ
インスタンスメソッド
イベント
1. select
2. selectionchange
継承
HTML DOM に関連するページ
ガイド
1. JavaScript で queueMicrotask() によるマイクロタスクの使用
2. In depth: Microtasks and the JavaScript runtime environment