CKTIS / HTML
Attribut form — association explicite à un formulaire
L’attribut form indique le formulaire propriétaire d’un contrôle, même si celui-ci se trouve en dehors du formulaire. Sa valeur est l’id du formulaire dans le même arbre, et non son name ni un sélecteur CSS.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
form="form-id"L’attribut form="form-id" indique explicitement le formulaire propriétaire d’un élément. Sa valeur doit correspondre à l’id d’un élément form dans le même arbre ; n’ajoutez pas #. Cette association ne déplace pas l’élément dans le DOM et permet de placer un contrôle en dehors de son formulaire.
L’attribut est pris en charge par button, fieldset, input, object, output, select, textarea et les éléments personnalisés associés aux formulaires. Ce n’est pas un attribut global. À elle seule, l’association ne signifie pas qu’un élément fournit une valeur lors de l’envoi du formulaire : fieldset et output, par exemple, n’en fournissent pas.
Sans cet attribut, le propriétaire est normalement l’élément form ancêtre le plus proche. Lorsque le formulaire propriétaire est redéterminé, l’identifiant indiqué dans l’attribut n’est recherché que si l’élément est rattaché à un document. Dans ce cas, si la recherche ne trouve aucun formulaire, l’élément reste sans propriétaire au lieu d’être associé au formulaire ancêtre. Une valeur vide ne rétablit pas alors l’association par défaut : supprimez plutôt l’attribut. Dans un sous-arbre détaché du document, l’élément peut tout de même être associé à l’élément form ancêtre le plus proche, même si l’attribut ne désigne aucun formulaire. Utilisez des identifiants uniques.
L’attribut n’est pas hérité : définir form sur un fieldset n’associe pas automatiquement ses contrôles au formulaire indiqué. Les éléments intégrés qui prennent en charge cet attribut exposent une propriété .form, qui renvoie le formulaire ou null. Dans l’exemple, l’input externe appartient à order, apparaît dans order.elements et fournit sa valeur à FormData(order).
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Explicit form association</title>
<form id="order"></form>
<label>Item <input id="item" name="item" value="book" form="order"></label>
<pre id="result"></pre>
<script>
const order = document.getElementById('order');
const item = document.getElementById('item');
document.getElementById('result').textContent = [
item.form === order,
order.elements.namedItem('item') === item,
new FormData(order).get('item')
].join('\n');
</script>
</html>Résultat
true true book
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.