document.getElementsByName()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Renvoie une liste des éléments portant un name donné dans le document (X)HTML.

Syntaxe

js
elements = document.getElementsByName(name);
  • elements est une collection de NodeList
  • name est la valeur de l'attribut name des éléments.

Exemple

html
<!doctype html>
<html lang="en">
  <head>
    ...
  </head>

  <body>
    <form name="up"><input type="text" /></form>
    <div name="down"><input type="text" /></div>

    <script>
      var up_forms = document.getElementsByName("up");
      console.log(up_forms[0].tagName); // retourne "FORM"
    </script>
  </body>
</html>

Notes

L'attribut name est uniquement applicable aux documents (X) HTML. La méthode renvoie une collection NodeList en cours qui contient tous les éléments avec une valeur donnée pour l'attribut name, tels que <meta> ou <object> ou même si le nom est placé sur des éléments qui ne supportent pas du tout un attribut name.

La méthode getElementsByName fonctionne différemment dans différents navigateurs. Dans IE <10, la méthode getElementsByName () renvoie également les éléments qui ont un attribut id avec la valeur spécifiée. Vous devriez donc faire attention à ne pas utiliser la même chaîne pour le nom et l'identifiant.

Spécifications

Specification
HTML Standard
# dom-document-getelementsbyname-dev

Voir aussi