Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła