KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

maxlength — maximale tekstlengte

Het attribuut maxlength beperkt de tekstlengte in textarea en bepaalde input-typen. Het telt UTF-16-code-eenheden, niet de tekens zoals gebruikers die ervaren. Het beperkt geen numerieke waarde en kort tekst die een script toewijst niet automatisch af.

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

Syntax

maxlength="N"

maxlength="N" geeft de maximale tekstlengte aan. N moet een niet-negatief geheel getal zijn; 0 is toegestaan. Het attribuut geldt voor textarea en de volgende input-typen: text, search, tel, url, email en password. Het geldt niet voor number: max beperkt een numerieke waarde, niet het aantal cijfers.

De lengte wordt gemeten in UTF-16-code-eenheden, niet in tekens zoals gebruikers die ervaren: sommige emoji nemen twee eenheden in beslag. In textarea telt elke genormaliseerde regeleinde als één eenheid.

Als het attribuut ontbreekt, geldt deze beperking niet. Als ook minlength is opgegeven, mag de waarde daarvan niet groter zijn dan maxlength. maxlength alleen vereist niet dat een veld is ingevuld; gebruik daarvoor required.

De browser kan voorkomen dat te lange tekst wordt ingevoerd. De status validity.tooLong vereist dat de limiet is overschreden, dat de dirty-value-vlag is ingesteld en dat de laatste wijziging door de gebruiker is gedaan. .value via een script instellen kort de tekst niet af en activeert deze fout niet vanzelf, zoals het voorbeeld laat zien. Beperkingen aan de clientzijde vervangen validatie aan de serverzijde niet.

Voorbeelden

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

Resultaat

4
ABCDE
false

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen