Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

minlength — minimální délka textu

Atribut minlength určuje minimální délku neprázdné hodnoty zadané uživatelem v prvku textarea nebo podporovaném poli input. Pole tím není povinné; k tomu slouží required.

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

minlength="N"

minlength="N" nastavuje minimální délku pro textarea a input typu text, search, tel, url, email nebo password. Nevztahuje se na input typu number: min omezuje číselnou hodnotu, nikoli délku textu.

N musí být nezáporné celé číslo. Pokud je uvedeno také maxlength, minimum nesmí být větší než maximum. Délka se měří v jednotkách kódu UTF-16, nikoli v zobrazovaných znacích. V prvku textarea se normalizovaný konec řádku počítá jako jedna jednotka.

minlength nenahrazuje required: prázdná hodnota minimum neporušuje. Neprázdná hodnota, která je po úpravě uživatelem příliš krátká, způsobí validity.tooShort === true. Pouhé přiřazení hodnoty do value v JavaScriptu toto porušení nevyvolá; nejde o totéž jako psaní.

Příklad zobrazuje stav pomocí validity.tooShort a checkValidity(). Napište abc, přidejte d a potom pole vymažte. Ostatní omezení, například platnost adresy u type="email", se nadále uplatňují nezávisle.

Příklady

<!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>

Výsledek

Initial: tooShort=false; valid=true
Type abc: tooShort=true; valid=false
Append d: tooShort=false; valid=true
Clear: tooShort=false; valid=true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje