Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

maxlength — največja dolžina besedila

Atribut maxlength omejuje dolžino besedila v textarea in izbranih vrstah input. Šteje kodne enote UTF-16, ne znakov, kot jih zaznava uporabnik. Ne omejuje številske vrednosti in ne skrajša samodejno besedila, ki ga dodeli skript.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

maxlength="N"

maxlength="N" določa največjo dolžino besedila. N mora biti ne-negativno celo število; 0 je dovoljen. Atribut velja za textarea in te vrste input: text, search, tel, url, email in password. Za number ne velja: max omejuje številsko vrednost, ne števila njenih števk.

Dolžina se meri v kodnih enotah UTF-16, ne v znakih, kot jih zaznava uporabnik: nekateri emodžiji zavzamejo dve enoti. V textarea se vsak normalizirani prelom vrstice šteje kot ena enota.

Če atributa ni, te omejitve ni. Če je določen tudi minlength, njegova vrednost ne sme presegati maxlength. Sam maxlength ne zahteva, da je polje izpolnjeno; za to uporabite required.

Brskalnik lahko prepreči vnos predolgega besedila. Stanje validity.tooLong zahteva preseženo omejitev, nastavljeno zastavico spremenjene vrednosti in zadnjo spremembo, ki jo je izvedel uporabnik. Dodelitev .value s skriptom besedila ne skrajša in sama ne nastavi te napake, kot kaže primer. Omejitve na strani odjemalca ne nadomestijo preverjanja na strani strežnika.

Primeri

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>maxlength</title>
<label for="tag">Tag (maximum 4 UTF-16 code units)</label>
<input id="tag" type="text" maxlength="4">
<pre id="result"></pre>
<script>
const tag = document.getElementById('tag');
tag.value = 'ABCDE';
document.getElementById('result').textContent =
  `${tag.maxLength}\n${tag.value}\n${tag.validity.tooLong}`;
</script>
</html>

Rezultat

4
ABCDE
false

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri