CKTIS / HTML
required — champ obligatoire du formulaire
L’attribut booléen `required` exige qu’un contrôle de formulaire compatible soit renseigné. Il s’applique à `input`, `select` et `textarea` ; la manière de satisfaire cette exigence dépend du type de contrôle.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
input: required
select: required
textarea: required
Boolean forms: required | required="" | required="required"required est un attribut booléen : sa présence active l’obligation et sa suppression la désactive. Les formes required, required="" et required="required" sont équivalentes. Écrire required="false" n’est pas conforme et active tout de même l’obligation.
Pour les contrôles input de saisie de texte compatibles et pour textarea, une valeur vide entraîne validity.valueMissing. Dans un champ de texte ordinaire, des espaces seuls peuvent satisfaire required ; l’attribut ne vérifie pas que le contenu est pertinent. Une checkbox obligatoire doit être cochée. Dans un groupe radio, un élément doit être coché si l’un des éléments porte required, et un contrôle file doit contenir un fichier. required ne s’applique pas aux types hidden, range, color ni aux boutons.
Pour select, si aucune option n’est sélectionnée ou si seule l’option servant de libellé indicatif est sélectionnée, la valeur est considérée comme manquante. Un select obligatoire sans multiple, dont la taille d’affichage est 1, doit contenir une telle option. Le premier élément option de la liste des options doit avoir une valeur vide et être un enfant direct de select, et non être imbriqué dans un optgroup. Une option à valeur vide située plus loin dans la liste ne peut pas servir de libellé indicatif.
Les contrôles disabled, ainsi que ceux qui prennent en charge readonly et possèdent cet attribut, ne participent pas à la validation des contraintes. Une soumission ordinaire du formulaire est bloquée par les contrôles invalides, mais novalidate, formnovalidate ou form.submit() peuvent contourner cette étape. Vérifiez aussi les données côté serveur et indiquez l’obligation dans un libellé visible.
L’exemple appelle checkValidity() avant et après avoir rempli les trois contrôles. Le résultat attendu est d’abord false, puis true ; il ne dépend pas de la langue des messages de validation du navigateur.
Exemples
<!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>Résultat
false true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.