HTML 属性: minlength
minlength
属性は、ユーザーが <input>
または <textarea>
に入力できる最小文字列長を(UTF-16 コード単位で)定義します。この属性は 0 以上の整数値である必要があります。
長さは UTF-16 コードユニットで測定され、(多くの文字体系では)文字数と等しくなります。 minlength
が指定されなかった場合、または無効な値が指定された場合は、入力欄には最小文字数が設定されません。この値は maxlength の値以下である必要があります。そうでなければどちらの条件にも合わせることができないので、この値が有効になることはありません。
フィールドのテキスト値の長さが minlength を UTF-16 コード単位の長さで下回った場合、入力欄は制約検証に失敗し、 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);
}
仕様書
Specification |
---|
HTML Standard # attr-input-minlength |
HTML Standard # attr-textarea-minlength |
ブラウザーの互換性
html.elements.input.minlength
BCD tables only load in the browser
html.elements.textarea.minlength
BCD tables only load in the browser