CKTIS / HTML
minlength — minimalna długość tekstu
Atrybut minlength określa minimalną długość niepustej wartości wpisanej przez użytkownika w textarea lub obsługiwanym polu input. Sam nie wymaga wypełnienia pola; do tego służy required.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
minlength="N"minlength="N" ustala minimum długości dla textarea oraz input o typie text, search, tel, url, email lub password. Nie dotyczy input typu number: min ogranicza wartość liczbową, a nie długość tekstu.
N musi być nieujemną liczbą całkowitą; jeśli podano też maxlength, minimum nie może przekraczać maksimum. Długość mierzy się w jednostkach kodowych UTF-16, nie w widocznych znakach. W textarea znormalizowany koniec wiersza liczy się jako jedna jednostka.
minlength nie zastępuje required: pusta wartość nie narusza minimum. Zbyt krótka, niepusta wartość po edycji przez użytkownika powoduje validity.tooShort === true. Samo przypisanie do value w JavaScript nie uruchamia tego naruszenia; nie jest równoważne wpisywaniu.
Przykład pokazuje stan przez validity.tooShort i checkValidity(). Wpisz abc, dopisz d, a następnie wyczyść pole. Inne ograniczenia, na przykład poprawność adresu w type="email", nadal obowiązują niezależnie.
Przykłady
<!doctype html>
<meta charset="utf-8">
<title>minlength</title>
<label for="code">Code (min. 4)</label>
<input id="code" type="text" minlength="4">
<pre id="result">tooShort=false; valid=true</pre>
<script>
const field = document.getElementById('code');
const result = document.getElementById('result');
field.addEventListener('input', () => {
result.textContent = `tooShort=${field.validity.tooShort}; valid=${field.checkValidity()}`;
});
</script>Wynik
Initial: tooShort=false; valid=true Type abc: tooShort=true; valid=false Append d: tooShort=false; valid=true Clear: tooShort=false; valid=true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.