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

CKTIS / HTML

required — campo obligatorio del formulario

El atributo booleano `required` exige que se complete un control de formulario compatible. Se aplica a `input`, `select` y `textarea`; la forma de cumplir el requisito depende del tipo de control.

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

Sintaxis

input: required
select: required
textarea: required
Boolean forms: required | required="" | required="required"

required es un atributo booleano: su presencia activa el requisito y eliminarlo lo desactiva. Las formas required, required="" y required="required" son equivalentes. Escribir required="false" no es conforme y aun así activa el requisito.

En los controles input de entrada de texto compatibles y en textarea, un valor vacío provoca validity.valueMissing. En un campo de texto normal, los espacios por sí solos pueden satisfacer required; el atributo no comprueba que el contenido tenga sentido. Una checkbox obligatoria debe estar marcada. En un grupo radio, debe marcarse un elemento si alguno tiene required, y un control file necesita un archivo. required no se aplica a los tipos hidden, range, color ni a los botones.

En select, si no se selecciona ninguna opción o solo se selecciona la opción que sirve de marcador de posición, se considera que falta un valor. Un select obligatorio sin multiple y con tamaño de visualización 1 debe tener esa opción. El primer elemento option de la lista de opciones debe tener un valor vacío y ser hijo directo de select, no estar dentro de un optgroup. Una opción con valor vacío que aparezca más adelante en la lista no sirve de marcador de posición.

Los controles disabled, así como los controles que admiten readonly y tienen ese atributo, no participan en la validación de restricciones. Los controles no válidos bloquean el envío normal del formulario, pero novalidate, formnovalidate o form.submit() pueden omitir ese paso. Valida también los datos en el servidor e indica el requisito en una etiqueta visible.

El ejemplo llama a checkValidity() antes y después de rellenar los tres controles. El resultado esperado es primero false y después true; no depende del idioma de los mensajes de validación del navegador.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>required</title>
<form id="form">
  <label>Name (required): <input id="name" name="name" required></label>
  <label>Plan (required):
    <select id="plan" name="plan" required>
      <option value="">Choose</option>
      <option value="basic">Basic</option>
    </select>
  </label>
  <label>Note (required): <textarea id="note" name="note" required></textarea></label>
</form>
<pre id="result"></pre>
<script>
  const form = document.getElementById('form');
  const before = form.checkValidity();
  document.getElementById('name').value = 'Ada';
  document.getElementById('plan').value = 'basic';
  document.getElementById('note').value = 'Hello';
  const after = form.checkValidity();
  document.getElementById('result').textContent = before + '\n' + after;
</script>
</html>

Resultado

false
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