Document.getElementsByName()

Returns a nodelist collection with a given name (en-US) in the (X)HTML document.

Sintaxis

js
elements = document.getElementsByName(name);
  • elements es una colección existente de NodeList
  • name es el valor del atributo name del elemento.

Ejemplo

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); // returns "FORM"
    </script>
  </body>
</html>

Notas

El atributo name (en-US) es solamente aplicable al documento (X)HTML. El método retorna una colección existente de NodeList que contiene todos los elementos con el valor dado para el atributo name, tanto <meta> o <object> o en caso que name sea colocado en elementos que no soportan un atributo de atributo del todo.

El método getElementsByName trabaja de diferente manera en diferentes navegadires. En IE < 10, el método getElementsByName() tambipen retornará elementos que tienen un atributo id con el valor especificado. Entonces, debería tener cuidado de no usar el mismo string como name y ID.

Especificaciones

Specification
HTML Standard
# dom-document-getelementsbyname-dev

Compatibilidad del Navegador

BCD tables only load in the browser

Mira también