--- title: 'HTML 属性: minlength' slug: Web/HTML/Attributes/minlength tags: - Attribute - Input - Reference - minlength - textarea translation_of: Web/HTML/Attributes/minlength ---
{{HTMLSidebar}}
minlength
属性は、ユーザーが {{htmlelement('input')}} または {{htmlelement('textarea')}} に入力できる最小文字数を (UTF-16 コード単位で) 定義します。 0 以上の整数値である必要があります。 minlength が指定されなかった場合、または無効な値が指定された場合は、 input や textarea には最小文字数が設定されません。この値は maxlength の値以下である必要があります。そうでなければどちらの条件にも合わせることができないので、この値が有効になることはありません。
フィールドのテキスト値の長さが minlength を UTF-16 コード単位の長さで下回った場合、入力欄は制約検証に失敗し、 {{domxref('validityState.tooShort')}} が true
を返します。制約検証は、ユーザーが値を変更した場合にのみ適用されます。送信に失敗すると、ブラウザーによっては必要な最小文字列と現在の長さを示してエラーメッセージを表示します。
minlength="5"
を追加すると、値は空か5文字以上でないと有効にはならなくなります。
<label for="fruit">Enter a fruit name that is at least 5 letters long</label> <input type="text" minlength="5" id="fruit">
擬似クラスを使用すると、要素を値が有効かどうかによってスタイル付けすることができます。この値は null (空欄) または5文字以上であれば有効になります。ライム色は無効であり、レモン色は有効です。
input { border: 2px solid currentcolor; } input:invalid { border: 2px dashed red; } input:invalid:focus { background-image: linear-gradient(pink, lightgreen); }
{{EmbedLiveSample('Examples', '100%', 200)}}
仕様書 | 状態 |
---|---|
{{SpecName('HTML WHATWG', 'input.html#attr-input-minlength', 'minlength attribute')}} | {{Spec2('HTML WHATWG')}} |
{{SpecName('HTML5.1', 'input.html#attr-minlength-accept', 'minlength attribute')}} | {{Spec2('HTML5.1')}} |
{{Compat("html.elements.attribute.minlength")}}