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

CKTIS / HTML

maxlength — longitud máxima del texto

El atributo maxlength limita la longitud del texto en textarea y en determinados tipos de input. Cuenta unidades de código UTF-16, no caracteres percibidos por el usuario. No limita un valor numérico ni trunca automáticamente el texto asignado por un script.

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

Sintaxis

maxlength="N"

maxlength="N" especifica la longitud máxima del texto. N debe ser un número entero no negativo; se permite 0. El atributo se aplica a textarea y a estos tipos de input: text, search, tel, url, email y password. No se aplica a number: max limita un valor numérico, no la cantidad de sus dígitos.

La longitud se mide en unidades de código UTF-16, no en caracteres percibidos por el usuario: algunos emojis ocupan dos unidades. En textarea, cada salto de línea normalizado cuenta como una unidad.

Si se omite el atributo, no se aplica este límite. Si también se especifica minlength, su valor no debe superar maxlength. maxlength por sí solo no exige que el campo esté completo; para eso se usa required.

El navegador puede impedir que se introduzca texto demasiado largo. El estado validity.tooLong requiere que se supere el límite, que esté activada la marca de valor modificado y que el último cambio lo haya realizado el usuario. Asignar .value mediante un script no trunca el texto ni activa por sí solo este error, como muestra el ejemplo. Las restricciones del lado del cliente no sustituyen la validación del lado del servidor.

Ejemplos

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

Resultado

4
ABCDE
false

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