Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

minlength — longitud mínima del texto

El atributo minlength establece la longitud mínima de un valor no vacío introducido por el usuario en un textarea o en un campo input compatible. No hace que el campo sea obligatorio; para eso se usa required.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

minlength="N"

minlength="N" establece una longitud mínima para textarea y para input de tipo text, search, tel, url, email o password. No se aplica a input de tipo number: min limita el valor numérico, no la longitud del texto.

N debe ser un entero no negativo. Si también se especifica maxlength, el mínimo no puede superar el máximo. La longitud se mide en unidades de código UTF-16, no en caracteres visibles. En textarea, un salto de línea normalizado cuenta como una unidad.

minlength no sustituye a required: un valor vacío no incumple el mínimo. Un valor no vacío que sea demasiado corto después de que el usuario lo edite hace que validity.tooShort === true. Asignar únicamente a value en JavaScript no activa esta infracción; no equivale a escribir.

El ejemplo muestra el estado mediante validity.tooShort y checkValidity(). Escribe abc, añade d y luego borra el campo. Otras restricciones, como la validez de una dirección en type="email", siguen aplicándose de forma independiente.

Ejemplos

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

Resultado

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes