diff options
Diffstat (limited to 'files/es/web/api/document/getelementsbyname/index.html')
| -rw-r--r-- | files/es/web/api/document/getelementsbyname/index.html | 81 |
1 files changed, 81 insertions, 0 deletions
diff --git a/files/es/web/api/document/getelementsbyname/index.html b/files/es/web/api/document/getelementsbyname/index.html new file mode 100644 index 0000000000..50350fe0ec --- /dev/null +++ b/files/es/web/api/document/getelementsbyname/index.html @@ -0,0 +1,81 @@ +--- +title: Document.getElementsByName() +slug: Web/API/Document/getElementsByName +translation_of: Web/API/Document/getElementsByName +--- +<div>{{APIRef("DOM")}}</div> + +<p>Returns a nodelist collection with a given {{domxref("element.name","name")}} in the (X)HTML document.</p> + +<h2 id="Syntax" name="Syntax">Sintaxis</h2> + +<pre class="syntaxbox"><em>elements</em> = document.getElementsByName(<em>name</em>) +</pre> + +<ul> + <li><code>elements</code> es una colección existente de {{domxref("NodeList")}}</li> + <li><code>name</code> es el valor del atributo <code>name</code> del elemento.</li> +</ul> + +<h2 id="Example" name="Example">Ejemplo</h2> + +<pre class="brush: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> +</pre> + +<h2 id="Notes" name="Notes">Notas</h2> + +<p>El atributo <a href="/en-US/docs/DOM/element.name"><code>name</code></a> es solamente aplicable al documento (X)HTML. El método retorna una colección existente de {{domxref("NodeList")}} que contiene todos los elementos con el valor dado para el atributo <code>name</code>, tanto {{htmlelement("meta")}} o {{htmlelement("object")}} o en caso que <code>name</code> sea colocado en elementos que no soportan un atributo de atributo del todo.</p> + +<p>El método <strong>getElementsByName</strong> trabaja de diferente manera en diferentes navegadires. En IE < 10, el método getElementsByName() tambipen retornará elementos que tienen un atributo <code>id</code> con el valor especificado. Entonces, debería tener cuidado de no usar el mismo string como <code>name</code> y <code>ID</code>.</p> + +<h2 id="Specifications" name="Specifications">Especificaciones</h2> + +<ul> + <li><a href="http://www.w3.org/TR/DOM-Level-2-HTML/">DOM Level 2 HTML: getElementsByName</a></li> + <li><a href="http://www.whatwg.org/html/#dom-document-getelementsbyname" title="http://www.whatwg.org/html/">HTML5: getElementsByName</a></li> +</ul> + +<h2 id="Especificaciones">Especificaciones</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Especificaciones</th> + <th scope="col">estado</th> + <th scope="col">Comentario</th> + </tr> + <tr> + <td>{{SpecName('HTML WHATWG', '#dom-document-getelementsbyname', "Document.getElementsByName()")}}</td> + <td>{{ Spec2('HTML WHATWG') }}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName("DOM2 HTML", "html.html#ID-71555259", "Document.getElementsByName()")}}</td> + <td>{{Spec2("DOM2 HTML")}}</td> + <td>Initial definition</td> + </tr> + </tbody> +</table> + +<h2 id="See_also" name="See_also">Mira también</h2> + +<ul> + <li>{{domxref("document.getElementById()")}} para retornar una referencia de un elemento por su <code>id</code></li> + <li>{{domxref("document.getElementsByTagName()")}} para retornar referencias de elementos por el nombre de sus etiquetas</li> + <li>{{domxref("document.querySelector()")}} for powerful selectors via queries like <code>'div.myclass'</code></li> +</ul> |