recursal/MDN huggingface dataset:
document.getElementsByTagNameNS
===============================

### Resumen

Devuelve una lista de elementos cuyo nombre pertenece a un determinado 'namespace'. La búsqueda se realiza en todo el documento, incluyendo el elemento raíz.

### Sintaxis


```js
elements = document.getElementsByTagNameNS(namespace, name);
```


* `elements` es una lista del tipo `NodeList` de los elementos encontrados, en el orden en el que aparecen en el árbol.
* `namespace` es el nombre URI en el que buscamos. (Véase `element.namespaceURI`).
* `name` es bien el nombre local por el que buscamos, o bien el valor especial `"*"`, que representa todos los elementos (véase `element.localName`).
### Ejemplo

En el siguiente ejemplo, `getElementsByTagNameNS` comienza por un elemento padre determinado y busca recurrentemente, hacia abajo, por los elementos que tienen el parámetro `name` que concuerda.

Es importante tener en cuenta que cuando el nodo en el que se invoca `getElementsByTagName`, no es el nodo `document`, en realidad estamos usando el método element.getElementsByTagNameNS.

Para usar el siguiente ejemplo, copia y pega en un documento con la extensión xhtml.


```html
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <title>ejemplo de getElementsByTagNameNS</title>

    <script type="text/javascript">
 function getAllParaElems() {
 var allParas = document.getElementsByTagNameNS(
 "http://www.w3.org/1999/xhtml",
 "p",
 );

 var num = allParas.length;

 alert("Hay " + num + " &lt;p&gt; elementos en este documento");
 }

 function div1ParaElems() {
 var div1 = document.getElementById("div1");
 var div1Paras = div1.getElementsByTagNameNS(
 "http://www.w3.org/1999/xhtml",
 "p",
 );

 var num = div1Paras.length;

 alert("Hay " + num + " &lt;p&gt; elementos en el elemento div1");
 }

 function div2ParaElems() {
 var div2 = document.getElementById("div2");
 var div2Paras = div2.getElementsByTagNameNS(
 "http://www.w3.org/1999/xhtml",
 "p",
 );

 var num = div2Paras.length;

 alert("Hay " + num + " &lt;p&gt; elementos en el elemento div2");
 }
 </script>
  </head>

  <body style="border: solid green 3px">
    <p>Algo de texto exterior</p>
    <p>Algo de texto exterior</p>

    <div id="div1" style="border: solid blue 3px">
      <p>Algo de texto en div1</p>
      <p>Algo de texto en div1</p>
      <p>Algo de texto en div1</p>

      <div id="div2" style="border: solid red 3px">
        <p>Algo de texto en div2</p>
        <p>Algo de texto en div2</p>
      </div>
    </div>

    <p>Algo de texto exterior</p>
    <p>Algo de texto exterior</p>

    <button onclick="getAllParaElems();">
      muestra todos los elementos p en el documento</button
 ><br />

    <button onclick="div1ParaElems();">
      muestra todos los elementos p en el div1</button
 ><br />

    <button onclick="div2ParaElems();">
      muestra todos los elementos p en el div2
    </button>
  </body>
</html>
```

Especificaciones
----------------

| Specification |
| --- |
| DOM Standard # ref-for-dom-document-getelementsbytagnamens① |

Compatibilidad del Navegador
----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Document.embeds
===============

**`embeds`** es una propiedad de sólo lectura de la interfaz de `Document`. Devuelve una lista con los elementos `<object>` incrustados dentro del documento actual.

Sintaxis
--------


```js
nodeList = document.embeds;
```

### Valor

Una `HTMLCollection`.

Especificaciones
----------------

| Specification |
| --- |
| HTML Standard # dom-document-embeds-dev |

Compatibilidad del Navegador
----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Document.clear()
================

**Obsoleto:** Esta característica ya no se recomienda. Aunque es posible que algunos navegadores aún lo admitan, probablemente ya se ha eliminado de los estándares web relevantes, está en proceso de eliminación o solo se conserva por motivos de compatibilidad. Evite usarlo y actualice el código existente si es posible; consulte la tabla de compatibilidad en la parte inferior de esta página para orientar su decisión. Tenga en cuenta que esta característica puede dejar de funcionar en cualquier momento.

Método que se usa en versiones anterior a las 1.0 de Mozilla para para limpiar el documento completo.

No hace nada en versiones más recientes basado en Mozilla así como en Internet Explorer y Netscape 4.

Síntaxis
--------


```js
document.clear();
```

Especificaciones
----------------

| Specification |
| --- |
| HTML Standard # dom-document-clear |

Compatibilidad del Navegador
----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Document.pointerLockElement
===========================

La propiedad `pointerLockElement` conserva el elemento adquirido, para el evento del mouse, mientras el bloqueo se encuentre activo . Es `null` si el bloqueo se encuentra en estado pendiente para bloqueo, o si el bloqueo se ha liberado, es decir ya no se encuentra en estado bloqueado, o si el elemento bloqueado se encuentra en otro documento.

Sintaxis
--------


```js
var elemento = document.pointerLockElement;
```

### Valor retornado

Un `Element` o `null`.

Especificaciones
----------------

| Specification |
| --- |
| Pointer Lock 2.0 # dom-documentorshadowroot-pointerlockelement |

Compatibilidad del Navegador
----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Véase también
-------------

* `Document.exitPointerLock()` (en-US)
* `Element.requestPointerLock()` (en-US)
* Pointer Lock
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 with JavaScript enabled. Enable JavaScript to view data.

Mira también
------------

* `document.getElementById()` para retornar una referencia de un elemento por su `id`
* `document.getElementsByTagName()` para retornar referencias de elementos por el nombre de sus etiquetas
* `document.querySelector()` for powerful selectors via queries like `'div.myclass'`
Document.createElement()
========================

En un documento HTML, el método **`Document.createElement()`** crea un elemento HTML especificado por su `tagName`, o un `HTMLUnknownElement` (en-US) si su `tagName` no se reconoce. En un documento XUL, crea el elemento XUL especificado. En otros documentos, crea un elemento con un namespace URI `null`.

Para declarar el namespace URI del elemento, utiliza `document.createElementNS()`.

Sintaxis
--------


```js
var element = document.createElement(tagName, [options]);
```

### Parámetros

`tagName`

Cadena que especifica el tipo de elemento a crear. El `nodeName` del elemento creado se inicializa con el valor de `tagName`. No utilizar nombres reservados (como "html:a") con este método. Al ser invocado en un documento HTML, `createElement()` convierte `tagName` a minúsculas antes de crear el elemento. En Firefox, Opera, y Chrome, `createElement(null)` funciona como `createElement("null")`.

`options`Opcional

Un objeto opcional `ElementCreationOptions` que contiene una única propiedad llamada `is`, cuyo valor es el de la etiqueta name de un elemento personalizado definido previamente utilizando `customElements.define()`. Para compatibilidad con versiones anteriores de Elements specification, algunos navegadores podrían permitir pasar una cadena aquí en vez de un objeto, donde el valor de la cadena es la etiqueta name del elemento creado. Ver Extending native HTML elements para más información sobre como usar este parámetro.

El nuevo elemento recibirá el atributo cuyo valor es la etiqueta name del elemento personalizado. Los elementos personalizados son una característica experimental solo disponible en algunos navegadores.

### Retorna

El nuevo `Element`.

Ejemplo
-------

Crea un nuevo `<div>` y lo inserta antes del elemento con ID "`div1`".

### HTML


```html
<!doctype html>
<html>
  <head>
    <title>||Trabajando con elementos||</title>
  </head>
  <body>
    <div id="div1">El texto superior se ha creado dinámicamente.</div>
  </body>
</html>
```

### JavaScript


```js
document.body.onload = addElement;

function addElement() {
  // crea un nuevo div
  // y añade contenido
  var newDiv = document.createElement("div");
  var newContent = document.createTextNode("Hola!¿Qué tal?");
  newDiv.appendChild(newContent); //añade texto al div creado.

  // añade el elemento creado y su contenido al DOM
  var currentDiv = document.getElementById("div1");
  document.body.insertBefore(newDiv, currentDiv);
}
```

Especificaciones
----------------

| Specification |
| --- |
| DOM Standard # ref-for-dom-document-createelement① |

Compatibilidad del Navegador
----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Ver también
-----------

* `Node.removeChild()`
* `Node.replaceChild()`
* `Node.appendChild()`
* `Node.insertBefore()`
* `Node.hasChildNodes()`
document.alinkColor
===================

**Obsoleto:** Esta característica ya no se recomienda. Aunque es posible que algunos navegadores aún lo admitan, probablemente ya se ha eliminado de los estándares web relevantes, está en proceso de eliminación o solo se conserva por motivos de compatibilidad. Evite usarlo y actualice el código existente si es posible; consulte la tabla de compatibilidad en la parte inferior de esta página para orientar su decisión. Tenga en cuenta que esta característica puede dejar de funcionar en cualquier momento.

Devuelve o define el color que tendrán los vínculos activos en el cuerpo (elemento `body` del documento. Un vínculo está activo durante el tiempo entre los eventos `mousedown` (cuando se presiona el botón izquierdo del "mouse" sobre el vínculo) y `mouseup` (cuando se deja de presionar el vínculo al soltar el botón izquierdo del "mouse").

Sintaxis
--------


```js
color = document.alinkColor;
document.alinkColor = color;
```


`color` es un texto que deberá llevar el nombre del color en inglés(e.g., `"blue"`, `"darkblue"`, etc.) o el valor hexadecimal del color (e.g., `#0000FF`)

Notas
-----

El valor por defecto de esta propiedad en Mozilla es rojo (`#ee0000` en hexadecimal).

`document.alinkColor` es obsoleto en DOM Level 2 HTML. Una alternativa es el selector CSS `:active`.

Otra alternativa es `document.body.aLink`, sin embargo éste es desaprobado en HTML 4.01 a favor de la alternativa CSS.

Gecko soporta tanto `alinkColor`/`:active` como `:focus`. Internet Explorer 6 y 7 soportan `alinkColor`/`:active` sólo para vínculos de ancla (<a>) HTML y el comportamiento es el mismo que `:focus` bajo Gecko. En IE (Internet Explorer) no hay soporte para `:focus`.

Especificaciones
----------------

| Specification |
| --- |
| HTML Standard # dom-document-alinkcolor |

Compatibilidad del Navegador
----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Document.scripts
================

Devuelve una lista de elementos `<script>` (en-US) ubicados en el documento. El objeto devuelto es una colección `HTMLCollection`.

Sintáxis
--------


```js
var scriptList = document.scripts;
```


El objeto `scriptList` devuelto es una `HTMLCollection`. Se puede utilizar como un array corriente para acceder a sus elementos.

Ejemplo
-------

Este ejemplo busca demostrar la existencia de objetos `<script>` (en-US) en el documento.


```js
var scripts = document.scripts;

if (scripts.length) {
  alert("This page has scripts!");
}
```

Especificaciones
----------------

| Specification |
| --- |
| HTML Standard # dom-document-scripts-dev |

Compatibilidad del Navegador
----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Document.head
=============

Devuelve el elemento `<head>` del documento actual. Si hay más de un elemento `<head>`, devuelve el primero de estos.

Sintaxis
--------


```js
var objRef = document.head;
```

Ejemplo
-------


```js
// en el HTML: <head id="my-document-head">
var aHead = document.head;

alert(aHead.id); // "my-document-head";

alert(document.head === document.querySelector("head")); // true
```

Notas
-----

`document.head` is de sólo lectura. Cualquier intento de asignar un valor a esta propiedad fallará silenciosamente o, en caso de que se encuentre en Modo estricto de ECMAScript (en-US) en un navegador Gecko, lanzará un `TypeError`.

Especificaciones
----------------

| Specification |
| --- |
| HTML Standard # dom-document-head-dev |

Compatibilidad del Navegador
----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Document.createAttribute()
==========================

El método **`Document.createAttribute()`** crea un nuevo nodo de tipo atributo (attr), y lo retorna. El objeto crea un nodo implementando la interfaz `Attr`. El DOM no impone que tipo de atributos pueden ser agregados a un particular elemento de esta forma.

**Nota:** El texto pasado como parametro es convertido a minusculas.

Sintaxis
--------


```js
atributo = document.createAttribute(nombre);
```

### Parametros

* `nombre` es un string conteniendo el nombre del atributo.
### Valor que retorna

Un nodo `Attr` nodo.

### Excepciones

* `INVALID_CHARACTER_ERR` si el parametro contiene caracteres invalidos para un atributo XML .
Ejemplo
-------


```js
var nodo = document.getElementById("div1");
var a = document.createAttribute("miAtributo");
a.value = "nuevoVal";
nodo.setAttributeNode(a);
console.log(nodo.getAttribute("miAtributo")); // "nuevoVal"
```

Especificaciones
----------------

| Specification |
| --- |
| DOM Standard # dom-document-createattribute |

Compatibilidad del Navegador
----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Ver ademas
----------

* `Document.createElement()`
Document.write()
================

Escribe una cadena de texto dentro del hilo de un `document` abierto por document.open() (en-US).

**Nota:** Dado que `document.write` escribe directo al hilo **(stream**) de un documento, la llamada a `document.write` en un documento ya cargado automáticamente ejecuta `document.open`, lo cual limpiará todo el contenido del documento en cuestión (en-US).

Sintaxis
--------


```js
document.write(texto);
```


`texto` es una cadena de texto que contiene el texto a ser impreso en el documento.

### Example


```html
<html>
  <head>
    <title>Ejemplo de write</title>

    <script>
 function nuevoContenido() {
 alert("carga el contenido nuevo");
 document.open();
 document.write(
 "<h1>Quita el contenido viejo - Agrega el contenido nuevo!</h1>",
 );
 document.close();
 }
 </script>
  </head>

  <body onload="nuevoContenido();">
    <p>Algo de contenido original del documento</p>
  </body>
</html>
```

Notas
-----

Escribir a un documento que ya tiene contenido cargado previamente sin llamar a `document.open()` (en-US), automáticamente hará una llamada a document.open(). Después de haber finalizado la escritura del documento, es recomendable llamar a `document.close()` (en-US), para informar al navegador que la carga de la página ya ha terminado. El texto que escribas allí es convertido a la estructura tipificada de HTML dentro del modelo estructural del documento. En el ejemplo de más arriba, el elemento h1 se convierte en un nodo dentro del documento.

Si la llamada a document.write() se ejecuta dentro de una etiqueta `<script>` incluído en el HTML, entonces la llamada a document.open() nunca ocurrirá. Por ejemplo:


```html
<script>
 document.write("<h1>Título Principal</h1>");
</script>
```


**Nota:** `document.write` y `document.writeln` no funcionan dentro de un documento XHTML (obtendrás un mensaje de error que dice "Operación no soportada" ("Operation is not supported") [`NS_ERROR_DOM_NOT_SUPPORTED_ERR`] en la consola). Esto sucede cuando abrimos un archivo local de extensión .xhtml o para cualquier document servido con un MIME del tipo (en-US) `application/xhtml+xml`. Hay más información disponible en W3C XHTML FAQ.

**Nota:** `document.write` en scripts de modo diferido (en-US) o asyncrónico (en-US) serán ignorados, y recibirás un mensaje de error en la consola del tipo "Una llamada a document.write() desde un script cargado asincrónicamente fue ignorado" ("A call to `document.write()` from an asynchronously-loaded external script was ignored").

Especificaciones
----------------

| Specification |
| --- |
| HTML Standard # dom-document-write-dev |

Compatibilidad del Navegador
----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

También puedes ver
------------------

* `element.innerHTML`
* `document.createElement()`
document.bgColor
================

**Obsoleto:** Esta característica ya no se recomienda. Aunque es posible que algunos navegadores aún lo admitan, probablemente ya se ha eliminado de los estándares web relevantes, está en proceso de eliminación o solo se conserva por motivos de compatibilidad. Evite usarlo y actualice el código existente si es posible; consulte la tabla de compatibilidad en la parte inferior de esta página para orientar su decisión. Tenga en cuenta que esta característica puede dejar de funcionar en cualquier momento.

`bgColor` da/define el color de fondo (bgColor) del documento actual.

### Sintaxis


```js
color = document.bgColor;
document.bgColor = color;
```

### Parámetros

* `color` es un texto representando el color como una palabra en inglés (e.j., "red") o en valor hexadecimal (e.j., "`#ff0000`").
### Ejemplos


```js
document.bgColor = "darkblue";
document.bgColor = "#ff00ff";
```

### Notas

El valor por defecto de esta propiedad en Mozilla Firefox es blanco (`#ffffff` en hexadecimal).

`document.bgColor` está desaprobado en DOM Level 2 HTML. La alternativa recomendada es el uso del estilo background-color de CSS el cual puede ser accesado a través del DOM con `document.body.style.backgroundColor`. Otra alternativa es `document.body.bgColor`, sin embargo, ésta última también está desaprobada en HTML 4.01 a favor de la alternativa CSS.

Especificaciones
----------------

| Specification |
| --- |
| HTML Standard # dom-document-bgcolor |

Compatibilidad del Navegador
----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
document.createRange
====================

### Resumen

Retorna un nuevo objeto `Rango`.

### Sintáxis


```js
range = document.createRange();
```


En este ejemplo, `range` es el nuevo objeto rango creado.

### Ejemplo


```js
var range = document.createRange();
range.setStart(startNode, startOffset);
range.setEnd(endNode, endOffset);
```

### Notas

Una vez que se ha creado un objeto `Rango`, se necesita configurar sus puntos límites antes de hacer uso de la mayoría de sus métodos.

Especificaciones
----------------

| Specification |
| --- |
| DOM Standard # dom-document-createrange |

Compatibilidad del Navegador
----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
document.applets
================

**Obsoleto:** Esta característica ya no se recomienda. Aunque es posible que algunos navegadores aún lo admitan, probablemente ya se ha eliminado de los estándares web relevantes, está en proceso de eliminación o solo se conserva por motivos de compatibilidad. Evite usarlo y actualice el código existente si es posible; consulte la tabla de compatibilidad en la parte inferior de esta página para orientar su decisión. Tenga en cuenta que esta característica puede dejar de funcionar en cualquier momento.

### Resumen

`applets` Devuelve una lista ordenada de los
 *applets*
 del documento.

### Sintaxis


```js
nodeList = document.applets;
```

### Ejemplo


```js
// ( Cuando sabes que el segundoapplet es el que quieres )
my_java_app = document.applets[1];
```

Especificaciones
----------------

| Specification |
| --- |
| HTML Standard # dom-document-applets |

Compatibilidad del Navegador
----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Document.writeln()
==================

Escribe una cadena de texto en el documento, seguida de una nueva línea.

**Nota:** Dado que `document.writeln` (al igual que `document.write)` escribe directo al hilo (`stream`) de un documento, la llamada a `document.write` en un documento ya cargado automáticamente ejecuta `document.open`, lo cual limpiará todo el contenido del documento en cuestión (en-US).

Sintaxis
--------


```js
document.writeln(línea);
```

### Parámetros

* `línea` es la cadena conteniendo una línea de texto.
Ejemplo
-------


```js
document.writeln("<p>¡Hola mundo!</p>");
```

Notas
-----

**document.writeln** actúa igual que document.write exepto que agrega un carácter de nueva línea (`\n`) al final del texto a escribir.

**Nota:** `document.write` y `document.writeln` no funcionan dentro de un documento XHTML (obtendrás un mensaje de error que dice "Operación no soportada" ("Operation is not supported") [`NS_ERROR_DOM_NOT_SUPPORTED_ERR`] en la consola). Esto sucede cuando abrimos un archivo local de extensión .xhtml o para cualquier document servido con un MIME del tipo (en-US) `application/xhtml+xml`. Hay más información disponible en W3C XHTML FAQ.

**Nota:** `document.writeln` y `document.write` en scripts de modo diferido (en-US) o asyncrónico (en-US) serán ignorados, y recibirás un mensaje de error en la consola del tipo "Una llamada a document.write() desde un script cargado asincrónicamente fue ignorado" ("A call to `document.write()` from an asynchronously-loaded external script was ignored").

Especificaciones
----------------

| Specification |
| --- |
| HTML Standard # dom-document-writeln-dev |

Compatibilidad del Navegador
----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.