CKTIS / HTML
minlength — minimale tekstlengte
Het attribuut minlength stelt de minimale lengte in van een niet-lege, door de gebruiker ingevoerde waarde in een textarea of een ondersteund input-veld. Het maakt het veld niet verplicht; gebruik daarvoor required.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
minlength="N"minlength="N" stelt een minimale lengte in voor textarea en voor input met het type text, search, tel, url, email of password. Het geldt niet voor input met het type number: min begrenst de numerieke waarde, niet de tekstlengte.
N moet een niet-negatief geheel getal zijn. Als ook maxlength is opgegeven, mag het minimum niet groter zijn dan het maximum. De lengte wordt gemeten in UTF-16-code-eenheden, niet in zichtbare tekens. In textarea telt een genormaliseerde regeleinde als één eenheid.
minlength vervangt required niet: een lege waarde schendt het minimum niet. Een niet-lege waarde die na bewerking door de gebruiker te kort is, zorgt voor validity.tooShort === true. Alleen een waarde toekennen aan value in JavaScript veroorzaakt deze overtreding niet; dat is niet hetzelfde als typen.
Het voorbeeld toont de status via validity.tooShort en checkValidity(). Typ abc, voeg d toe en maak het veld daarna leeg. Andere beperkingen, zoals de geldigheid van een adres bij type="email", blijven onafhankelijk van toepassing.
Voorbeelden
<!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>Resultaat
Initial: tooShort=false; valid=true Type abc: tooShort=true; valid=false Append d: tooShort=false; valid=true Clear: tooShort=false; valid=true
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.