Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

form — formulaire HTML

L’élément form associe des contrôles à un formulaire et définit la manière dont leurs données sont envoyées. Il prend en charge l’envoi et la validation natifs ; JavaScript peut intercepter l’envoi.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<form action="/search" method="get">…</form>

form représente un formulaire dont les contrôles peuvent fournir des données à traiter. Les balises ouvrante et fermante sont nécessaires ; les formulaires ne doivent pas être imbriqués. Les contrôles compatibles situés en dehors du formulaire peuvent lui être associés au moyen d’un attribut form qui référence son id.

action indique la destination. method="get" (la valeur par défaut) place les données dans la requête de l’URL, tandis que method="post" les place dans le corps de la requête. Pour envoyer des fichiers avec POST, utilisez enctype="multipart/form-data". POST seul ne fournit pas de chiffrement.

Les clés des données proviennent de name, et non de id. Les contrôles désactivés et les cases non cochées sont omis. Les contrôles sans nom sont généralement omis, mais si le formulaire est envoyé au moyen d’un bouton d’envoi de type image (<input type="image">) sans nom, ce bouton ajoute aux données deux entrées de coordonnées nommées x et y. Associez les libellés aux champs. La validation du navigateur aide les utilisateurs, mais ne remplace pas la validation côté serveur.

Lors d’un envoi normal, la validation interactive a lieu avant le déclenchement de l’événement submit, sauf si elle est ignorée. Si la validation échoue, l’envoi est interrompu et l’événement submit n’est pas déclenché. L’attribut novalidate permet de passer outre la validation interactive. Dans les scripts, préférez requestSubmit() : contrairement à submit(), cette méthode conserve la validation et l’événement submit.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTML form example</title>
</head>
<body>
  <form id="search" method="get">
    <label for="query">Query</label>
    <input id="query" name="q" value="html" required>
    <button id="submit-query" type="submit">Submit query</button>
  </form>
  <output id="result" for="query" aria-live="polite"></output>
  <script>
    const form = document.getElementById('search');
    const submitButton = document.getElementById('submit-query');
    const result = document.getElementById('result');

    form.addEventListener('submit', (event) => {
      event.preventDefault();
      const data = new FormData(form);
      result.value = 'q=' + data.get('q');
      console.log(result.value);
    });

    form.requestSubmit(submitButton);
  </script>
</body>
</html>

Résultat

q=html

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.

Sources