diff --git a/files/es/web/api/document/adoptnode/index.html b/files/es/web/api/document/adoptnode/index.html deleted file mode 100644 index cba685afd92a97..00000000000000 --- a/files/es/web/api/document/adoptnode/index.html +++ /dev/null @@ -1,61 +0,0 @@ ---- -title: Document.adoptNode() -slug: Web/API/Document/adoptNode -tags: - - API - - DOM - - DOM Reference - - Referencia - - metodo -translation_of: Web/API/Document/adoptNode ---- -
{{ ApiRef("DOM") }}
- -

Document.adoptNode() transfiere un {{Glossary("node/dom", "node")}} desde otro {{domxref("Document", "document", "", "1")}} al documento del método. El nodo adoptado y sus subnodos se eliminan del documento original (si lo hubiera), encuentra y su {{domxref("Node.ownerDocument", "ownerDocument")}} se cambia por el documento actual. El nodo puede entoces ser insertado en el documento actual.

- -

Sintaxis

- -
node = document.adoptNode(externalNode);
-
- -
-
node
-
El nodo adoptado que ahora tiene este documento como su {{domxref("Node.ownerDocument", "ownerDocument")}}. El {{domxref("Node.parentNode", "parentNode")}} del nodo es null, esto se debe a que aún no a sido insertado en el árbol del documento. Tenga en cuenta que node y externalNode son el mismo objeto después de esta llamada.
-
externalNode
-
El nodo a ser adoptado desde otro documento.
-
- -

Ejemplo

- -
var iframe = document.querySelector('iframe');
-var iframeImages = iframe.contentDocument.querySelectorAll('img');
-var newParent = document.getElementById('images');
-
-iframeImages.forEach(function(imgEl) {
-  newParent.appendChild(document.adoptNode(imgEl));
-});
-
- -

Notas

- -

Los nodos de documentos externos deberían ser clonados utilizando {{domxref("document.importNode()")}} (o adoptado utilizando document.adoptNode()) antes de que puedan ser insertados en el documento actual. Para más incidencias sobre {{domxref("Node.ownerDocument")}}, vea el W3C DOM FAQ.

- -

Firefox actualmente no obliga a cumplir esta regla (lo hizo un tiempo durante el desarrollo de Firefox 3, pero muchos sitios se rompían cuando esta regla era obligatoria). Animamos a los desarrolladores web a que corrijan su código para seguir esta regla con el fin de mejorar la compatibilidad futura.

- -

Epecificación

- - - -

Compatibilidad con navegadores

- - - -

{{Compat("api.Document.adoptNode")}}

- -

Vea también

- - diff --git a/files/es/web/api/document/adoptnode/index.md b/files/es/web/api/document/adoptnode/index.md new file mode 100644 index 00000000000000..3e71e29c510a29 --- /dev/null +++ b/files/es/web/api/document/adoptnode/index.md @@ -0,0 +1,55 @@ +--- +title: Document.adoptNode() +slug: Web/API/Document/adoptNode +tags: + - API + - DOM + - DOM Reference + - Referencia + - metodo +translation_of: Web/API/Document/adoptNode +--- +{{ ApiRef("DOM") }} + +**`Document.adoptNode()`** transfiere un {{Glossary("node/dom", "node")}} desde otro {{domxref("Document", "document", "", "1")}} al documento del método. El nodo adoptado y sus subnodos se eliminan del documento original (si lo hubiera), encuentra y su {{domxref("Node.ownerDocument", "ownerDocument")}} se cambia por el documento actual. El nodo puede entoces ser insertado en el documento actual. + +## Sintaxis + +```js +node = document.adoptNode(externalNode); +``` + +- `node` + - : El nodo adoptado que ahora tiene este documento como su {{domxref("Node.ownerDocument", "ownerDocument")}}. El {{domxref("Node.parentNode", "parentNode")}} del nodo es `null`, esto se debe a que aún no a sido insertado en el árbol del documento. Tenga en cuenta que `node` y `externalNode` son el mismo objeto después de esta llamada. +- `externalNode` + - : El nodo a ser adoptado desde otro documento. + +## Ejemplo + +```js +var iframe = document.querySelector('iframe'); +var iframeImages = iframe.contentDocument.querySelectorAll('img'); +var newParent = document.getElementById('images'); + +iframeImages.forEach(function(imgEl) { + newParent.appendChild(document.adoptNode(imgEl)); +}); +``` + +## Notas + +Los nodos de documentos externos deberían ser clonados utilizando {{domxref("document.importNode()")}} (o adoptado utilizando `document.adoptNode()`) antes de que puedan ser insertados en el documento actual. Para más incidencias sobre {{domxref("Node.ownerDocument")}}, vea el [W3C DOM FAQ](https://www.w3.org/DOM/faq.html#ownerdoc). + +Firefox actualmente no obliga a cumplir esta regla (lo hizo un tiempo durante el desarrollo de Firefox 3, pero muchos sitios se rompían cuando esta regla era obligatoria). Animamos a los desarrolladores web a que corrijan su código para seguir esta regla con el fin de mejorar la compatibilidad futura. + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + +## Vea también + +- {{domxref("document.importNode")}} diff --git a/files/es/web/api/document/alinkcolor/index.html b/files/es/web/api/document/alinkcolor/index.html deleted file mode 100644 index f270799c53a04d..00000000000000 --- a/files/es/web/api/document/alinkcolor/index.html +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: document.alinkColor -slug: Web/API/Document/alinkColor -translation_of: Web/API/Document/alinkColor ---- -

{{APIRef("DOM")}}

- -
-

Desaprobado

-
- -

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

- -
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 {{ Cssxref(":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 {{ Cssxref(":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.

- -

Especificación

- -

DOM Nivel 0. No es parte de ningún estándar.

- -

MSDN: alinkColor property

diff --git a/files/es/web/api/document/alinkcolor/index.md b/files/es/web/api/document/alinkcolor/index.md new file mode 100644 index 00000000000000..5f38b11b2dc378 --- /dev/null +++ b/files/es/web/api/document/alinkcolor/index.md @@ -0,0 +1,35 @@ +--- +title: document.alinkColor +slug: Web/API/Document/alinkColor +translation_of: Web/API/Document/alinkColor +--- +{{APIRef("DOM")}}{{ Deprecated_header() }} + +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](https://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-26809268). Una alternativa es el selector CSS {{ Cssxref(":active") }}. + +Otra alternativa es `document.body.aLink`, sin embargo éste es [desaprobado en HTML 4.01](https://www.w3.org/TR/html401/struct/global.html#adef-alink) a favor de la alternativa CSS. + +[Gecko](es/Gecko) soporta tanto `alinkColor`/`:active` como {{ Cssxref(":focus") }}. Internet Explorer 6 y 7 soportan `alinkColor`/`:active` sólo para [vínculos de ancla (\) HTML](es/HTML/Element/a) y el comportamiento es el mismo que `:focus` bajo Gecko. En IE (Internet Explorer) no hay soporte para `:focus`. + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/anchors/index.html b/files/es/web/api/document/anchors/index.html deleted file mode 100644 index fbcd8eea0e5aac..00000000000000 --- a/files/es/web/api/document/anchors/index.html +++ /dev/null @@ -1,95 +0,0 @@ ---- -title: document.anchors -slug: Web/API/Document/anchors -tags: - - API - - Desaprobado - - Documento - - HTML DOM - - Propiedad - - Referencia -translation_of: Web/API/Document/anchors ---- -
{{APIRef("DOM")}}{{deprecated_header()}}
- -
La propiedad de solo lectura anchors de la interfaz {{domxref("Document")}} devuelve una lista de todas las anclas (anchors) del documento.
- -

Sintaxis

- -
nodeList = document.anchors;
-
- -

Valor

- -

Una {{domxref("HTMLCollection")}}.

- -

Ejemplo

- -
if ( document.anchors.length >= 5 ) {
-    dump("dump found too many anchors");
-    window.location = "http://www.google.com";
-}
-
- -

Lo siguiente es un ejemplo que puebla una Tabla de Contenido con cada ancla en la página:

- -
<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8" />
-<title>Test</title>
-<script>
-function init() {
-  var toc = document.getElementById("toc");
-  var i, li, newAnchor;
-  for (i = 0; i < document.anchors.length; i++) {
-    li = document.createElement("li");
-    newAnchor = document.createElement('a');
-    newAnchor.href = "#" + document.anchors[i].name;
-    newAnchor.innerHTML = document.anchors[i].text;
-    li.appendChild(newAnchor);
-    toc.appendChild(li);
-  }
-}
-</script>
-</head>
-<body onload="init()">
-
-<h1>Title</h1>
-<h2><a name="contents">Contents</a></h2>
-<ul id="toc"></ul>
-
-<h2><a name="plants">Plants</a></h2>
-<ol>
-  <li>Apples</li>
-  <li>Oranges</li>
-  <li>Pears</li>
-</ol>
-
-<h2><a name="veggies">Veggies</a></h2>
-<ol>
-  <li>Carrots</li>
-  <li>Celery</li>
-  <li>Beats</li>
-</ol>
-
-</body>
-</html>
- -

Ver en JSFiddle

- -

Notas

- -

Por razones de retrocompatibilidad, el conjunto de anclas devuelto sólo contiene aquellas anclas creadas con el atribuo name, y no aquellas creadas con el atributo id.

- -

Especificaciones

- -

DOM Level 2 HTML: anchors

- -

{{ languages( { "en": "en/DOM/document.anchors", "pl": "pl/DOM/document.anchors", "ja": "ja/DOM/document.anchors" } ) }}

- -

Compatibilidad de navegadores

- - - -
{{Compat("api.Document.anchors")}}
diff --git a/files/es/web/api/document/anchors/index.md b/files/es/web/api/document/anchors/index.md new file mode 100644 index 00000000000000..beff960ff1d661 --- /dev/null +++ b/files/es/web/api/document/anchors/index.md @@ -0,0 +1,94 @@ +--- +title: document.anchors +slug: Web/API/Document/anchors +tags: + - API + - Desaprobado + - Documento + - HTML DOM + - Propiedad + - Referencia +translation_of: Web/API/Document/anchors +--- +{{APIRef("DOM")}}{{deprecated_header()}}La propiedad de solo lectura **`anchors`** de la interfaz {{domxref("Document")}} devuelve una lista de todas las anclas (anchors) del documento. + +## Sintaxis + +```js +nodeList = document.anchors; +``` + +### Valor + +Una {{domxref("HTMLCollection")}}. + +## Ejemplo + +```js +if ( document.anchors.length >= 5 ) { + dump("dump found too many anchors"); + window.location = "http://www.google.com"; +} +``` + +Lo siguiente es un ejemplo que puebla una Tabla de Contenido con cada ancla en la página: + +```html + + + + +Test + + + + +

Title

+

Contents

+ + +

Plants

+
    +
  1. Apples
  2. +
  3. Oranges
  4. +
  5. Pears
  6. +
+ +

Veggies

+
    +
  1. Carrots
  2. +
  3. Celery
  4. +
  5. Beats
  6. +
+ + + +``` + +[Ver en JSFiddle](https://jsfiddle.net/S4yNp) + +## Notas + +Por razones de retrocompatibilidad, el conjunto de anclas devuelto sólo contiene aquellas anclas creadas con el atribuo `name`, y no aquellas creadas con el atributo `id`. + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + diff --git a/files/es/web/api/document/applets/index.html b/files/es/web/api/document/applets/index.html deleted file mode 100644 index e6ecf71b60c9d9..00000000000000 --- a/files/es/web/api/document/applets/index.html +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: document.applets -slug: Web/API/Document/applets -translation_of: Web/API/Document/applets ---- -

{{APIRef("DOM")}}

- -

Resumen

- -

applets Devuelve una lista ordenada de los - - applets - del documento.

- -

Sintaxis

- -
nodeList = document.applets
-
- -

Ejemplo

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

Especificación

- -

DOM Level 2 HTML: applets

- -

{{ languages( { "en": "en/DOM/document.applets", "pl": "pl/DOM/document.applets" } ) }}

diff --git a/files/es/web/api/document/applets/index.md b/files/es/web/api/document/applets/index.md new file mode 100644 index 00000000000000..27cfd480c53b15 --- /dev/null +++ b/files/es/web/api/document/applets/index.md @@ -0,0 +1,35 @@ +--- +title: document.applets +slug: Web/API/Document/applets +translation_of: Web/API/Document/applets +--- +{{APIRef("DOM")}}{{ Deprecated_header() }} + +### 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 + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + diff --git a/files/es/web/api/document/bgcolor/index.html b/files/es/web/api/document/bgcolor/index.html deleted file mode 100644 index 7baf9c893b3ba3..00000000000000 --- a/files/es/web/api/document/bgcolor/index.html +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: document.bgColor -slug: Web/API/Document/bgColor -translation_of: Web/API/Document/bgColor ---- -

{{APIRef("DOM")}}{{ Deprecated_header() }}

- -

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

- -

Sintaxis

- -
color = document.bgColor
-document.bgColor =
-color
-
- -

Parámetros

- - - -

Ejemplos

- -
# 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.

- -

Especificación

- -

DOM Nivel 0. No es parte de ningún estándar.

- -

{{ languages( { "en": "en/DOM/document.bgColor", "pl": "pl/DOM/document.bgColor" } ) }}

diff --git a/files/es/web/api/document/bgcolor/index.md b/files/es/web/api/document/bgcolor/index.md new file mode 100644 index 00000000000000..86c0d145866c40 --- /dev/null +++ b/files/es/web/api/document/bgcolor/index.md @@ -0,0 +1,42 @@ +--- +title: document.bgColor +slug: Web/API/Document/bgColor +translation_of: Web/API/Document/bgColor +--- +{{APIRef("DOM")}}{{ Deprecated_header() }} + +`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](https://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-26809268). La alternativa recomendada es el uso del estilo [background-color](es/CSS/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 + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/body/index.html b/files/es/web/api/document/body/index.html deleted file mode 100644 index 724ee899b2d216..00000000000000 --- a/files/es/web/api/document/body/index.html +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: document.body -slug: Web/API/Document/body -translation_of: Web/API/Document/body ---- -
{{APIRef("DOM")}}
- -

Resumen

- -

Devuelve el nodo del <body> o el nodo del <frameset> del documento.

- -

Sintaxis

- -
objRef = document.body
-document.body =
-objRef
-
- -

Ejemplo

- -
// en HTML: <body id="oldBodyElement"></body>
-alert(document.body.id); // "oldBodyElement"
-var aNewBodyElement = document.createElement("body");
-aNewBodyElement.id = "newBodyElement";
-document.body = aNewBodyElement;
-alert(document.body.id); // "newBodyElement"
-
- -

Notas

- -

document.body es el elemento que contiene el contenido para el documento. En documentos con contenidos <body>, devuelven el elemento <body>, y en documentos de marco de sistema, esto devuelve el elemento extremo <frameset>.

- -

Aunque body es programable, colocando un nuevo cuerpo en un documento efectivamente quitará a todos los hijos actuales del elemento existente <body>.

- -

Especificación

- -

DOM Level 2 HTML: HTMLDocument.body

- -

{{ languages( { "en": "en/DOM/document.body", "pl": "pl/DOM/document.body" } ) }}

diff --git a/files/es/web/api/document/body/index.md b/files/es/web/api/document/body/index.md new file mode 100644 index 00000000000000..5dbe442d853305 --- /dev/null +++ b/files/es/web/api/document/body/index.md @@ -0,0 +1,42 @@ +--- +title: document.body +slug: Web/API/Document/body +translation_of: Web/API/Document/body +--- +{{APIRef("DOM")}} + +### Resumen + +Devuelve el nodo del `` o el nodo del `` del documento. + +### Sintaxis + +```js +objRef = document.body +document.body = objRef +``` + +### Ejemplo + +```js +// en HTML: +alert(document.body.id); // "oldBodyElement" +var aNewBodyElement = document.createElement("body"); +aNewBodyElement.id = "newBodyElement"; +document.body = aNewBodyElement; +alert(document.body.id); // "newBodyElement" +``` + +### Notas + +`document.body` es el elemento que contiene el contenido para el documento. En documentos con contenidos ``, devuelven el elemento ``, y en documentos de marco de sistema, esto devuelve el elemento extremo ``. + +Aunque `body` es programable, colocando un nuevo cuerpo en un documento efectivamente quitará a todos los hijos actuales del elemento existente ``. + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/characterset/index.html b/files/es/web/api/document/characterset/index.html deleted file mode 100644 index 69a4ff144bc77d..00000000000000 --- a/files/es/web/api/document/characterset/index.html +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: document.characterSet -slug: Web/API/Document/characterSet -translation_of: Web/API/Document/characterSet ---- -

{{ ApiRef("DOM") }}

- -

Resumen

- -

Devuelve la codificación de caracteres (conjunto de caracteres) usado en el documento.

- -

Sintaxis

- -
string = document.characterSet
-
- -

Ejemplo

- -
<button onclick="alert(document.characterSet);"
->Mostrar conjunto de caracteres</button>
-// devuelve el conjunto de caracteres del documento, por ejemplo "ISO-8859-1 o UTF-8"
-
- -

Notas

- -

La codificación de caracteres es el conjunto de caracteres usados para interpretar el documento, el cual puede ser diferente a la codificación especificada por la página (el usuario puede omitir la codificación).

- -

Para una lista completa de juegos/conjuntos de caracteres, visite: http://www.iana.org/assignments/character-sets.

- -

Especificación

- -

DOM Nivel 0. No es parte de ningún estándar.

- -
- -

{{ languages( { "en": "en/DOM/document.characterSet", "pl": "pl/DOM/document.characterSet" } ) }}

diff --git a/files/es/web/api/document/characterset/index.md b/files/es/web/api/document/characterset/index.md new file mode 100644 index 00000000000000..44c0199e2ccd76 --- /dev/null +++ b/files/es/web/api/document/characterset/index.md @@ -0,0 +1,39 @@ +--- +title: document.characterSet +slug: Web/API/Document/characterSet +translation_of: Web/API/Document/characterSet +--- +{{ ApiRef("DOM") }} + +### Resumen + +Devuelve la codificación de caracteres (conjunto de caracteres) usado en el documento. + +### Sintaxis + +```js +string = document.characterSet +``` + +### Ejemplo + +```html + +// devuelve el conjunto de caracteres del documento, por ejemplo "ISO-8859-1 o UTF-8" +``` + +### Notas + +La codificación de caracteres es el conjunto de caracteres usados para interpretar el documento, el cual puede ser diferente a la codificación especificada por la página (el usuario puede omitir la codificación). + +Para una lista completa de juegos/conjuntos de caracteres, visite: . + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/clear/index.html b/files/es/web/api/document/clear/index.html deleted file mode 100644 index 025cba97d49a57..00000000000000 --- a/files/es/web/api/document/clear/index.html +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Document.clear() -slug: Web/API/Document/clear -tags: - - API - - Document - - HTML DOM - - Method - - NeedsCompatTable - - NeedsExample - - NeedsMarkupWork - - NeedsSpectTable - - Referencia -translation_of: Web/API/Document/clear ---- -

{{APIRef("DOM")}}{{ Deprecated_header() }}

- -

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

- -
document.clear()
-
- -

Especificación

- - diff --git a/files/es/web/api/document/clear/index.md b/files/es/web/api/document/clear/index.md new file mode 100644 index 00000000000000..d0d037ed76f791 --- /dev/null +++ b/files/es/web/api/document/clear/index.md @@ -0,0 +1,34 @@ +--- +title: Document.clear() +slug: Web/API/Document/clear +tags: + - API + - Document + - HTML DOM + - Method + - NeedsCompatTable + - NeedsExample + - NeedsMarkupWork + - NeedsSpectTable + - Referencia +translation_of: Web/API/Document/clear +--- +{{APIRef("DOM")}}{{ Deprecated_header() }} + +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 + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/close/index.html b/files/es/web/api/document/close/index.html deleted file mode 100644 index 3f03083a258fb7..00000000000000 --- a/files/es/web/api/document/close/index.html +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Document.close() -slug: Web/API/Document/close -translation_of: Web/API/Document/close ---- -

{{APIRef("DOM")}}

- -

El método document.close() finaliza la escritura de un documento abierta con document.open().

- -

Sintaxis

- -
document.close();
-
- -

Ejemplo

- -
// Abrir un documento.
-// Escribir contenido en el documento.
-// Cerrar el documento.
-document.open();
-document.write("<p>El único contenido.</p>");
-document.close();
-
- -

Especificación

- -

DOM Level 2 HTML: close() Method

diff --git a/files/es/web/api/document/close/index.md b/files/es/web/api/document/close/index.md new file mode 100644 index 00000000000000..1d46d2d9f5812f --- /dev/null +++ b/files/es/web/api/document/close/index.md @@ -0,0 +1,33 @@ +--- +title: Document.close() +slug: Web/API/Document/close +translation_of: Web/API/Document/close +--- +{{APIRef("DOM")}} + +El método `document.close()` finaliza la escritura de un documento abierta con [document.open()](/en/DOM/document.open "en/DOM/document.open"). + +## Sintaxis + +```js +document.close(); +``` + +## Ejemplo + +```js +// Abrir un documento. +// Escribir contenido en el documento. +// Cerrar el documento. +document.open(); +document.write("

El único contenido.

"); +document.close(); +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/contenttype/index.html b/files/es/web/api/document/contenttype/index.html deleted file mode 100644 index 2a0fbf86c9ce6c..00000000000000 --- a/files/es/web/api/document/contenttype/index.html +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Document.contentType -slug: Web/API/Document/contentType -translation_of: Web/API/Document/contentType ---- -

{{ ApiRef("DOM") }}{{Non-standard_header}}

- -

Devuelve el tipo MIME con el que el documento está siendo renderizado. Puede obtenerlo a partir de los encabezados HTTP (Headers) o de otras fuentes de información MIME, y puede ser afectado por conversiones automáticas inferidas tanto por el navegador como por cualquiera de sus extensiones.

- -

Sintáxis

- -
contentType = document.contentType;
-
- -

contentType es una propiedad de sólo lectura.

- -

Notas

- -

Esta propiedad no es afectada por los tags meta.

- -

Especificaciones

- -

No estándar, sólo soportada por Gecko.

- -

diff --git a/files/es/web/api/document/contenttype/index.md b/files/es/web/api/document/contenttype/index.md new file mode 100644 index 00000000000000..fdffa57751c2ca --- /dev/null +++ b/files/es/web/api/document/contenttype/index.md @@ -0,0 +1,29 @@ +--- +title: Document.contentType +slug: Web/API/Document/contentType +translation_of: Web/API/Document/contentType +--- +{{ ApiRef("DOM") }} + +Devuelve el tipo MIME con el que el documento está siendo renderizado. Puede obtenerlo a partir de los encabezados HTTP (Headers) o de otras fuentes de información MIME, y puede ser afectado por conversiones automáticas inferidas tanto por el navegador como por cualquiera de sus extensiones. + +## Sintáxis + +```js +contentType = document.contentType; +``` + +`contentType` es una propiedad de sólo lectura. + +## Notas + +Esta propiedad no es afectada por los tags meta. + + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/cookie/index.html b/files/es/web/api/document/cookie/index.html deleted file mode 100644 index ebbedf985bd685..00000000000000 --- a/files/es/web/api/document/cookie/index.html +++ /dev/null @@ -1,118 +0,0 @@ ---- -title: document.cookie -slug: Web/API/Document/cookie -tags: - - NeedsContent -translation_of: Web/API/Document/cookie -original_slug: DOM/document.cookie ---- -

{{ApiRef("DOM")}}

- -

Resumen

- -

Con document.cookie se obtienen y definen las cookies asociadas con el documento.

- -

Sintaxis

- -

Leer todas las cookies accesibles desde una localización

- -
todasLasCookies = document.cookie;
-
- -

En el código anterior todasLasCookies es una cadena que contiene una lista de todas las cookies separadas por punto y coma (en pares clave=valor). Tenga en cuenta que clave y valor pueden estar rodeadas por espacios en blanco (caracteres espacio y tabulación): de hecho RFC 6265 especifica que debe haber un espacio en blanco después de cada punto y coma (;), pero algunos agentes de usuario no son muy estrictos con esto.

- - - -
document.cookie = nuevaCookie;
- -

En el código anterior, nuevacookie es una cadena de la forma clave=valor. Tenga en cuenta que solo se puede crear o actualizar una cookie de cada vez mediante este método. Considere también que:

- - - -
Nótese que previamente a Gecko 6.0 {{ geckoRelease("6.0") }}, rutas que contenían comillas eran tratadas como si las comillas fueran parte de la cadena, en lugar de considerarse como un delimitador de la ruta actual. Esto ya ha sido arreglado.
- -

Ejemplos

- -

Ejemplo # 1: Uso sencillo

- -
document.cookie = "nombre=oeschger";
-document.cookie = "comida_preferida=tripa";
-function alertCookie() {
-  alert(document.cookie); // visualizar: nombre=oeschger;comida favorita=tripa
-
-}
- -
<button onclick="alertCookie()">Mostrar cookies</button>
- -

{{EmbedLiveSample('Example_1_Simple_usage', 200, 36)}}

- - - -
document.cookie = "test1=Hola";
-document.cookie = "test2=Mundo";
-
-var cookieValor = document.cookie.replace(/(?:(?:^|.*;\s*)test2\s*\=\s*([^;]*).*$)|^.*$/, "$1");
-
-function alertCookieValue() {
-  alert(cookieValor);
-}
-
- -
<button onclick="alertCookieValue()">Mostrar valor de cookie</button>
- -

{{EmbedLiveSample('Example_2_Get_a_sample_cookie_named_test2', 200, 36)}}

- -

Ejemplo #3: Hacer algo una sola vez

- -

De manera a usar el siguiente código, favor remplace todas las veces la palabra hacerAlgoUnaSolaVez (el nombre de la cookie) con un nombre personalizado.

- -
function hazUnaVez() {
-  if (document.cookie.replace(/(?:(?:^|.*;\s*)hacerAlgoUnaSolaVez\s*\=\s*([^;]*).*$)|^.*$/, "$1") !== "true") {
-    alert("Hacer algo aquí!");
-    document.cookie = "hacerAlgoUnaSolaVez=true; expires=Fri, 31 Dec 9999 23:59:59 GMT";
-  }
-}
- -
<button onclick="dhacerUnaVez()">Solo hacer algo una vez</button>
- -

{{EmbedLiveSample('Example_3_Do_something_only_once', 200, 36)}}

- -

Seguridad

- -

Es importante mencionar que la restricción path no protege contra la lectura no autorizada de cookies de una ruta distinta. Puede ser fácilmente resuelto mediante DOM (por ejemplo creando un iframe oculto con la ruta de la cookie y accediendo a la propiedad contentDocument.cookie del iframe). La única manera de proteger el acceso a cookies es ocupando un dominio o subdominio diferente, debido a la política de mismo origen.

- -

Notas

- - - -

Especificación

- -

DOM Level 2: HTMLDocument.cookie

diff --git a/files/es/web/api/document/cookie/index.md b/files/es/web/api/document/cookie/index.md new file mode 100644 index 00000000000000..e9479f82878e25 --- /dev/null +++ b/files/es/web/api/document/cookie/index.md @@ -0,0 +1,127 @@ +--- +title: document.cookie +slug: Web/API/Document/cookie +tags: + - NeedsContent +translation_of: Web/API/Document/cookie +original_slug: DOM/document.cookie +--- +{{ApiRef("DOM")}} + +### Resumen + +Con `document.cookie` se obtienen y definen las `cookies` asociadas con el documento. + +## Sintaxis + +### Leer todas las cookies accesibles desde una localización + +```js +todasLasCookies = document.cookie; +``` + +En el código anterior _`todasLasCookies`_ es una cadena que contiene una lista de todas las cookies separadas por punto y coma (en pares _`clave=valor`_). Tenga en cuenta que _clave_ y _valor_ pueden estar rodeadas por espacios en blanco (caracteres espacio y tabulación): de hecho [RFC 6265](https://tools.ietf.org/html/rfc6265) especifica que debe haber un espacio en blanco después de cada punto y coma (;), pero algunos agentes de usuario no son muy estrictos con esto. + +### Escribir una nueva cookie + +```js +document.cookie = nuevaCookie; +``` + +En el código anterior, _`nuevacookie`_ es una cadena de la forma _`clave=valor`_. Tenga en cuenta que solo se puede crear o actualizar una cookie de cada vez mediante este método. Considere también que: + +- Cualquiera de los siguientes atributos opcionales se puede escribir después del par clave-valor, especificando la cookie que se va a crear o actualizar, precedidos de un punto y coma. + + - `;path=path` (p. ej.: '/'. '/midir'). Si no se especifica, por defecto corresponde a la ruta del documento actual. + La ruta debe ser **absoluta** (ver [RFC 6265](https://tools.ietf.org/html/rfc6265)). Para más información sobre cómo utilizar rutas relativas, ir a [este párrafo](/es/docs/DOM/document.cookie$edit#Using_relative_URLs_in_the_path_parameter). + - `;domain=domain` (p. ej. 'example.com', 'subdomain.example.com'). Si no se especifica, su valor por defecto es la porción de la dirección web de la ubicación actual del archivo. A diferencia de lo que ocurría en las primeras especificaciones, los puntos iniciales de los nombre de dominio se ignoran, pero los navegadores pueden impedir crear cookies que contengan dichos puntos. Si se especifica un dominio, los subdominios siempre son incluidos. + - `;max-age=duración-máxima-en-segundos` Por ejemplo: 60\*60\*24\*365 para un año. + - `;expires=fecha-en-formato-GMTString` Si no se especifica `max-age` ni `expires`, la cookie expirará al terminar la sesión actual. + - `;secure` La cookie sólo será transmitida en un protocolo seguro (HTTPS, SSL). Antes de Chrmoe 52, este atributo podía aparecer con cookes de dominios http. + - `;samesite` Este atributo impide al navegador enviar esta cookie a través de peticiones cross-site. Los valores posibles son lax o strict. El soporte de este atributo se añadió en Chrome 51. + + - El valor _`strict`_ impide que la cookie sea enviada por el navegador al sitio destino en contexto de navegador cross-site, incluso cuando sigue un enlace regular. + - El valor _`lax`_ sólo envía cookies a las peticiones de GET de ALTO NIVEL. Es suficiente para seguir al usuario, pero evitará muchos ataques CSRF. + +- El valor de la cookie puede ser evaluado mediante [encodeURIComponent()](/es/Referencia_de_JavaScript_1.5/Funciones_globales/encodeURIComponent "encodeURIComponent") para asegurarse de que dicha cadena no incluya comas, punto y coma, ni espacios en blanco (lo cual no está permitido en el valor de una cookie). +- Algunas implementaciones de agente de usuario soporta los siguientes prefijos de cookie: + + - `__Secure-` Señales para el navegador que solo deben incluirse en las perticiones de cookie transmitidas por un canal seguro. + - `__Host-` Señales del navegador que además de la restricción de uso de cookies que provienen de un origen serugo, el ámbito de la cookie está limitado a un atributo path que proporciona el servidor. Si el servidor omite el atributo path, el directorio de las petición URI está en uso. Tabién las señales del atributo dominio no deben estar presentes, lo cual previene que la cookie sea usada en otros dominis. Para Chrome, el atributo path debe tener el mismo origen. + +> **Nota:** Nótese que previamente a Gecko 6.0 {{ geckoRelease("6.0") }}, rutas que contenían comillas eran tratadas como si las comillas fueran parte de la cadena, en lugar de considerarse como un delimitador de la ruta actual. Esto ya ha sido arreglado. + +## Ejemplos + +### Ejemplo # 1: Uso sencillo + +```js +document.cookie = "nombre=oeschger"; +document.cookie = "comida_preferida=tripa"; +function alertCookie() { + alert(document.cookie); // visualizar: nombre=oeschger;comida favorita=tripa + +} +``` + +```html + +``` + +{{EmbedLiveSample('Example_1_Simple_usage', 200, 36)}} + +### Ejemplo #2: Obtener una cookie de ejemplo llamada _test2_ + +```js +document.cookie = "test1=Hola"; +document.cookie = "test2=Mundo"; + +var cookieValor = document.cookie.replace(/(?:(?:^|.*;\s*)test2\s*\=\s*([^;]*).*$)|^.*$/, "$1"); + +function alertCookieValue() { + alert(cookieValor); +} +``` + +```html + +``` + +{{EmbedLiveSample('Example_2_Get_a_sample_cookie_named_test2', 200, 36)}} + +### Ejemplo #3: Hacer algo una sola vez + +De manera a usar el siguiente código, favor remplace todas las veces la palabra `hacerAlgoUnaSolaVez` (el nombre de la cookie) con un nombre personalizado. + +```js +function hazUnaVez() { + if (document.cookie.replace(/(?:(?:^|.*;\s*)hacerAlgoUnaSolaVez\s*\=\s*([^;]*).*$)|^.*$/, "$1") !== "true") { + alert("Hacer algo aquí!"); + document.cookie = "hacerAlgoUnaSolaVez=true; expires=Fri, 31 Dec 9999 23:59:59 GMT"; + } +} +``` + +```html + +``` + +{{EmbedLiveSample('Example_3_Do_something_only_once', 200, 36)}} + +### Seguridad + +Es importante mencionar que la restricción path no protege contra la lectura no autorizada de cookies de una ruta distinta. Puede ser fácilmente resuelto mediante DOM (por ejemplo creando un [iframe](/en/HTML/Element/iframe "en/HTML/Element/iframe") oculto con la ruta de la cookie y accediendo a la propiedad contentDocument.cookie del iframe). La única manera de proteger el acceso a cookies es ocupando un dominio o subdominio diferente, debido a la [política de mismo origen](/en/Same_origin_policy_for_JavaScript "Same origin policy for JavaScript"). + +### Notas + +- Empezando con Firefox 2, está disponible un mejor mecanismo de almacenamiento en cliente - [WHATWG DOM Storage](/es/DOM/Storage "es/DOM/Storage"). +- Puedes eliminar una cookie simplemente estableciendo su fecha de expiración a cero. +- Cabe mencionar que entre más cookies se tengan, mayor cantidad de datos serán transferidos entre el servidor y el cliente en cada solicitud. Esto reducirá el tiempo entre cada solicitud. Es altamente recomendado que se utilice [WHATWG DOM Storage](/es/DOM/Storage "es/DOM/Storage") si se van a mantener los datos solamente en el cliente. + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/createattribute/index.html b/files/es/web/api/document/createattribute/index.html deleted file mode 100644 index ec7c1713339f1b..00000000000000 --- a/files/es/web/api/document/createattribute/index.html +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: Document.createAttribute() -slug: Web/API/Document/createAttribute -tags: - - Atributos - - Crear Atributo - - JavaScript - - Métodos -translation_of: Web/API/Document/createAttribute -original_slug: Web/API/Document/crearAtributo ---- -
{{ ApiRef("DOM") }}
- -

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

- -
-

El texto pasado como parametro es convertido a minusculas.

-
- -

Sintaxis

- -
atributo = document.createAttribute(nombre)
-
- -

Parametros

- - - -

Valor que retorna

- -

Un nodo {{domxref("Attr")}} nodo.

- -

Excepciones

- - - -

Ejemplo

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

Especificaciones

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
EspecificaciónEstatusComentario
{{SpecName('DOM WHATWG','#dom-document-createattribute','Document.createAttribute()')}}{{Spec2("DOM WHATWG")}}Comportamiento preciso con caracteres en mayuscula
{{SpecName('DOM3 Core','core.html#ID-1084891198','Document.createAttribute()')}}{{Spec2('DOM3 Core')}}Sin cambios
{{SpecName('DOM2 Core','core.html#ID-1084891198','Document.createAttribute()')}}{{Spec2('DOM2 Core')}}Sin cambios
{{SpecName('DOM1','level-one-core.html#ID-1084891198','Document.createAttribute()')}}{{Spec2('DOM1')}}Definición inicial
- -

Compatibilidad del buscador

- - - -

{{Compat("api.Document.createAttribute")}}

- -

Ver ademas

- - diff --git a/files/es/web/api/document/createattribute/index.md b/files/es/web/api/document/createattribute/index.md new file mode 100644 index 00000000000000..4746ec5c387d85 --- /dev/null +++ b/files/es/web/api/document/createattribute/index.md @@ -0,0 +1,57 @@ +--- +title: Document.createAttribute() +slug: Web/API/Document/createAttribute +tags: + - Atributos + - Crear Atributo + - JavaScript + - Métodos +translation_of: Web/API/Document/createAttribute +original_slug: Web/API/Document/crearAtributo +--- +{{ ApiRef("DOM") }} + +El método **`Document.createAttribute()`** crea un nuevo nodo de tipo atributo (attr), y lo retorna. El objeto crea un nodo implementando la interfaz {{domxref("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 {{domxref("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 + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + + +## Ver ademas + +- {{domxref("Document.createElement()")}} diff --git a/files/es/web/api/document/createdocumentfragment/index.html b/files/es/web/api/document/createdocumentfragment/index.html deleted file mode 100644 index 4aaf091a78b673..00000000000000 --- a/files/es/web/api/document/createdocumentfragment/index.html +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: Document.createDocumentFragment() -slug: Web/API/Document/createDocumentFragment -translation_of: Web/API/Document/createDocumentFragment ---- -
{{ ApiRef("DOM") }}
- - - -

Crea un nuevo DocumentFragment vacio, dentro del cual un nodo del DOM puede ser adicionado para construir un nuevo arbol DOM fuera de pantalla.

- -

Sintaxis

- -
var fragment = document.createDocumentFragment();
-
- -

Se crea un objeto DocumentFragment vacio, el cual queda listo para que pueda insertarseles nodos en el.

- -

Notas de uso

- -

DocumentFragment son Nodos del DOM que nunca forman parte del arbol DOM. El caso de uso mas comun es crear un document fragment, agregar elementos al document fragment y luego agregar dicho document fragment al arbol del DOM. En el arbol del DOM, el document fragment es remplazado por todos sus hijos.

- -

Dado que el document fragment es generado en memoria y no como parte del arbol del DOM, agregar elementos al mismo no causan reflow (computo de la posicion y geometria de los elementos) en la pagina. Como consecuencia, usar document fragments usualmente resultan en mejor performance.

- -

Tambien puede utilizarse el constructor {{domxref("documentFragment")}} para crear un nuevo fragmento:

- -
let fragment = new DocumentFragment();
- -

Ejemplo

- -

Este ejemplo crea una lista de los principales navegadores web en un DocumentFragment, y luego adiciona el nuevo subarbol DOM al document para ser mostrado.

- -

HTML

- -
<ul id="ul">
-</ul>
- -

JavaScript

- -
var element  = document.getElementById('ul'); // assuming ul exists
-var fragment = document.createDocumentFragment();
-var browsers = ['Firefox', 'Chrome', 'Opera',
-    'Safari', 'Internet Explorer'];
-
-browsers.forEach(function(browser) {
-    var li = document.createElement('li');
-    li.textContent = browser;
-    fragment.appendChild(li);
-});
-
-element.appendChild(fragment);
- -

Resultado

- -

{{EmbedLiveSample("Example", 600, 140)}}

- -

Compatibilidad de navegadores

- -{{Compat("api.Document.createDocumentFragment")}} - -

Especificaciónes

- - - -

Vea También

- - diff --git a/files/es/web/api/document/createdocumentfragment/index.md b/files/es/web/api/document/createdocumentfragment/index.md new file mode 100644 index 00000000000000..d2f9b796fc11d7 --- /dev/null +++ b/files/es/web/api/document/createdocumentfragment/index.md @@ -0,0 +1,73 @@ +--- +title: Document.createDocumentFragment() +slug: Web/API/Document/createDocumentFragment +translation_of: Web/API/Document/createDocumentFragment +--- +{{ ApiRef("DOM") }} + +Crea un nuevo [`DocumentFragment`](/en-US/docs/DOM/DocumentFragment "DOM/DocumentFragment") vacio, dentro del cual un nodo del DOM puede ser adicionado para construir un nuevo arbol DOM fuera de pantalla. + +## Sintaxis + +```js +var fragment = document.createDocumentFragment(); +``` + +Se crea un objeto[ DocumentFragment](/es/docs/DOM/DocumentFragment "DOM/DocumentFragment") vacio, el cual queda listo para que pueda insertarseles nodos en el. + +## Notas de uso + +[`DocumentFragment`](/es/docs/DOM/DocumentFragment "DOM/DocumentFragment") son Nodos del DOM que nunca forman parte del arbol DOM. El caso de uso mas comun es crear un _document fragment_, agregar elementos al _document fragment_ y luego agregar dicho _document fragment_ al arbol del DOM. En el arbol del DOM, el _document fragment_ es remplazado por todos sus hijos. + +Dado que el _document fragment_ es generado en memoria y no como parte del arbol del DOM, agregar elementos al mismo no causan [reflow](http://code.google.com/speed/articles/reflow.html) (computo de la posicion y geometria de los elementos) en la pagina. Como consecuencia, usar _document fragments_ usualmente resultan en [mejor performance](http://ejohn.org/blog/dom-documentfragments/). + +Tambien puede utilizarse el constructor {{domxref("documentFragment")}} para crear un nuevo fragmento: + +```js +let fragment = new DocumentFragment(); +``` + +## Ejemplo + +Este ejemplo crea una lista de los principales navegadores web en un _DocumentFragment_, y luego adiciona el nuevo subarbol DOM al document para ser mostrado. + +HTML + +```html + +``` + +JavaScript + +```js +var element = document.getElementById('ul'); // assuming ul exists +var fragment = document.createDocumentFragment(); +var browsers = ['Firefox', 'Chrome', 'Opera', + 'Safari', 'Internet Explorer']; + +browsers.forEach(function(browser) { + var li = document.createElement('li'); + li.textContent = browser; + fragment.appendChild(li); +}); + +element.appendChild(fragment); +``` + +Resultado + +{{EmbedLiveSample("Example", 600, 140)}} + +## Especificaciones + +{{Specifications}} + +## Compatibilidad con navegadores + +{{Compat}} + +## Vea También + +- {{domxref("DOMImplementation.createDocument", "document.implementation.createDocument()")}} +- {{domxref("documentFragment")}} diff --git a/files/es/web/api/document/createelement/index.html b/files/es/web/api/document/createelement/index.html deleted file mode 100644 index e3550aec56b3d1..00000000000000 --- a/files/es/web/api/document/createelement/index.html +++ /dev/null @@ -1,105 +0,0 @@ ---- -title: Document.createElement() -slug: Web/API/Document/createElement -tags: - - API - - DOM - - Documento - - Referencia - - metodo -translation_of: Web/API/Document/createElement ---- -
{{APIRef("DOM")}}
- -

En un documento HTML, el método Document.createElement() crea un elemento HTML especificado por su tagName, o un {{domxref("HTMLUnknownElement")}} 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

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

Parámetros

- -
-
tagName
-
- -

Cadena que especifica el tipo de elemento a crear. El {{domxref("Node.nodeName", "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{{optional_inline}}
-
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

- -
<!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

- -
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);
-}
- -

{{EmbedLiveSample("Example", 500, 50)}}

- -

Especificaciones

- - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName('DOM WHATWG', "#dom-document-createelement", "Document.createElement")}}{{Spec2('DOM WHATWG')}}
- -

Compatibilidad con navegadores

- -{{Compat("api.Document.createElement")}} - -

Ver también

- - diff --git a/files/es/web/api/document/createelement/index.md b/files/es/web/api/document/createelement/index.md new file mode 100644 index 00000000000000..dfc77f67278423 --- /dev/null +++ b/files/es/web/api/document/createelement/index.md @@ -0,0 +1,91 @@ +--- +title: Document.createElement() +slug: Web/API/Document/createElement +tags: + - API + - DOM + - Documento + - Referencia + - metodo +translation_of: Web/API/Document/createElement +--- +{{APIRef("DOM")}} + +En un documento [HTML](/es/docs/Web/HTML), el método **`Document.createElement()`** crea un elemento HTML especificado por su `tagName`, o un {{domxref("HTMLUnknownElement")}} si su `tagName` no se reconoce. En un documento [XUL](/es/docs/Mozilla/Tech/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()`](/es/docs/Web/API/Document/createElementNS "Creates an element with the specified namespace URI and qualified name."). + +## Sintaxis + +```js +var element = document.createElement(tagName, [options]); +``` + +### Parámetros + +- `tagName` + - : Cadena que especifica el tipo de elemento a crear. El {{domxref("Node.nodeName", "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`{{optional_inline}} + + - : 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](https://www.w3.org/TR/custom-elements/), 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](https://developers.google.com/web/fundamentals/primers/customelements/#extendhtml) 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`](/es/docs/Web/API/Element "The Element interface represents an object of a Document. This interface describes methods and properties common to all kinds of elements. Specific behaviors are described in interfaces which inherit from Element but add additional functionality."). + +## Ejemplo + +Crea un nuevo `
` y lo inserta antes del elemento con ID "`div1`". + +### HTML + +```html + + + + ||Trabajando con elementos|| + + +
El texto superior se ha creado dinámicamente.
+ + +``` + +### 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); +} +``` + +{{EmbedLiveSample("Example", 500, 50)}} + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + + +## Ver también + +- {{domxref("Node.removeChild()")}} +- {{domxref("Node.replaceChild()")}} +- {{domxref("Node.appendChild()")}} +- {{domxref("Node.insertBefore()")}} +- {{domxref("Node.hasChildNodes()")}} diff --git a/files/es/web/api/document/createelementns/index.html b/files/es/web/api/document/createelementns/index.html deleted file mode 100644 index 96b40666abc28d..00000000000000 --- a/files/es/web/api/document/createelementns/index.html +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: Document.createElementNS() -slug: Web/API/Document/createElementNS -translation_of: Web/API/Document/createElementNS ---- -
{{ApiRef("DOM")}}
- -

Crea un elemento del DOM con el espacio de nombres URI y un nombre calificado.

- -

Para crear un elemento sin especificar un espacio de nombre URI usa el método createElement.

- -

Sintaxis

- -
var element = document.createElementNS(namespaceURI, qualifiedName[, options]);
-
- -

Parámetros

- -
-
namespaceURI
-
String que especifica el namespace URI a asociar con el elemento. La propiedad namespaceURI del elemento creado es inicializada con el valor del namespaceURI. Ver Namespace URIs válidos.
-
qualifiedName
-
String que especifica el tipo del elemento a ser creado. La propiedad nodeName del elemento creado es inicializada con el valor qualifiedName.
-
optionsOpcional
-
Un objeto opcional ElementCreationOptions que contiene una sola propiedad llamada is, cuyo valor es el nombre de la etiqueta para un elemento personalizado previamente definido usando customElements.define(). Para retro compatibilidad con versiones previas de la Especificación de Elementos Personalizados, algunos navegadores te permitirán pasar un String aquí en lugar de un Objeto, donde el valor del String es el nombre de la etiqueta del elemento personalizado. Ver Extendiendo elementos HTML nativos para más información sobre como usar este parámetro.
-
Al nuevo elemento le será dado un atributo is cuyo valor es el nombre de la etiqueta del elemento personalizado. Los elementos personalizados son una característica experimental disponible solo en algunos navegadores.
-
- -

Valor de Retorno

- -

El nuevo Elemento.

- -

Namespace URIs válidos

- - - -

Ejemplo

- -

El código siguiente crea un elemento <div> nuevo en el namespace XHTML y lo agrega al elemento vbox. Aunque no es un documento XUL extremamente útil esto demuestra el uso de los elementos de dos namespaces distintos dentro de un solo documento:

- -
<?xml version="1.0"?>
-<page xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"
-      xmlns:html="http://www.w3.org/1999/xhtml"
-      title="||Trabajando con elementos||"
-      onload="init()">
-
-<script type="text/javascript"><![CDATA[
- var container;
- var newdiv;
- var txtnode;
-
- function init(){
-   container = document.getElementById("ContainerBox");
-   newdiv = document.createElementNS("http://www.w3.org/1999/xhtml","div");
-   txtnode = document.createTextNode("Este es el texto que fue construido dinámicamente con createElementNS y createTextNode y luego insertado dentro del documento usando appendChild.");
-   newdiv.appendChild(txtnode);
-   container.appendChild(newdiv);
- }
-
-]]></script>
-
- <vbox id='ContainerBox' flex='1'>
-  <html:div>
-   El script en esta página agregará contenido dinámico debajo:
-  </html:div>
- </vbox>
-
-</page>
-
- -
-

El ejemplo dado arriba usa script en linea lo cúal no es recomendable en documentos XHTML. Este ejemplo en particular es un documento XUL con XHTML embedido, de cualquier forma la recomendación aplica.

-
- -

Especificaciones

- - - - - - - - - - - - - - -
EspecificaciónEstatusComentario
{{SpecName('DOM WHATWG', "#dom-document-createelementns", "Document.createElement")}}{{Spec2('DOM WHATWG')}}
- -

Compatibilidad con navegadores

- -{{Compat("api.Document.createElementNS")}} - -

Ver también

- - diff --git a/files/es/web/api/document/createelementns/index.md b/files/es/web/api/document/createelementns/index.md new file mode 100644 index 00000000000000..dafafdfc43eaa3 --- /dev/null +++ b/files/es/web/api/document/createelementns/index.md @@ -0,0 +1,91 @@ +--- +title: Document.createElementNS() +slug: Web/API/Document/createElementNS +translation_of: Web/API/Document/createElementNS +--- +{{ApiRef("DOM")}} + +Crea un elemento del DOM con el espacio de nombres URI y un nombre calificado. + +Para crear un elemento sin especificar un espacio de nombre URI usa el método [createElement](createElement). + +## Sintaxis + +```js +var element = document.createElementNS(namespaceURI, qualifiedName[, options]); +``` + +### Parámetros + +- `namespaceURI` + - : _String_ que especifica el [namespace URI](https://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/glossary.html#dt-namespaceURI) a asociar con el elemento. La propiedad [namespaceURI](/es/docs/DOM/element.namespaceURI) del elemento creado es inicializada con el valor del `namespaceURI`. Ver [Namespace URIs válidos](/es/docs/Web/API/Document/createElementNS#Valid_Namespace_URI's). +- `qualifiedName` + - : _String_ que especifica el tipo del elemento a ser creado. La propiedad [nodeName](/es/docs/DOM/element.nodeName) del elemento creado es inicializada con el valor `qualifiedName`. +- `options`{{optional_inline}} + + - : Un objeto opcional `ElementCreationOptions` que contiene una sola propiedad llamada `is`, cuyo valor es el nombre de la etiqueta para un elemento personalizado previamente definido usando `customElements.define()`. Para retro compatibilidad con versiones previas de la [Especificación de Elementos Personalizados](https://www.w3.org/TR/custom-elements/), algunos navegadores te permitirán pasar un _String_ aquí en lugar de un _Objeto_, donde el valor del _String_ es el nombre de la etiqueta del elemento personalizado. Ver [Extendiendo elementos HTML nativos](https://developers.google.com/web/fundamentals/primers/customelements/#extendhtml) para más información sobre como usar este parámetro. + + Al nuevo elemento le será dado un atributo `is` cuyo valor es el nombre de la etiqueta del elemento personalizado. Los elementos personalizados son una característica experimental disponible solo en algunos navegadores. + +### Valor de Retorno + +El nuevo [`Elemento`](https://developer.mozilla.org/en-US/docs/Web/API/Element). + +## Namespace URIs válidos + +- HTML - Usa `http://www.w3.org/1999/xhtml` +- SVG - Usa `http://www.w3.org/2000/svg` +- XBL - Usa `http://www.mozilla.org/xbl` +- XUL - Usa `http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul` + +## Ejemplo + +El código siguiente crea un elemento \
nuevo en el namespace [XHTML](/es/docs/XHTML "XHTML") y lo agrega al elemento vbox. Aunque no es un documento [XUL](/es/docs/XUL "XUL") extremamente útil esto demuestra el uso de los elementos de dos namespaces distintos dentro de un solo documento: + +```xml + + + + + + + + El script en esta página agregará contenido dinámico debajo: + + + + +``` + +> **Nota:** El ejemplo dado arriba usa script en linea lo cúal no es recomendable en documentos XHTML. Este ejemplo en particular es un documento XUL con XHTML embedido, de cualquier forma la recomendación aplica. + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + +## Ver también + +- [document.createElement](createElement) +- [document.createTextNode](createTextNode) +- [Node.namespaceURI](../Node/namespaceURI) +- [Namespaces in XML](https://www.w3.org/TR/1999/REC-xml-names-19990114) diff --git a/files/es/web/api/document/createevent/index.html b/files/es/web/api/document/createevent/index.html deleted file mode 100644 index a87d7b9165de3a..00000000000000 --- a/files/es/web/api/document/createevent/index.html +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Event.createEvent() -slug: Web/API/Document/createEvent -tags: - - API - - DOM - - Evento - - metodo -translation_of: Web/API/Document/createEvent -translation_of_original: Web/API/Event/createEvent -original_slug: Web/API/Event/createEvent ---- -

{{APIRef("DOM")}}

- -

Crea un nuevo evento, que debe ser inicializado llamando a su método init().

- -

Sintaxis

- -
document.createEvent(tipo);
- -
-
tipo
-
Una string indicando el tipo de evento a crear.
-
- -

Este método devuelve un nuevo objeto {{ domxref("Event") }} del DOM del tipo indicado, que debe ser inicializado antes de su uso.

- -

Ejemplo

- -
var nuevoEvento = document.createEvent("UIEvents");
- -

Especificación

- - diff --git a/files/es/web/api/document/createevent/index.md b/files/es/web/api/document/createevent/index.md new file mode 100644 index 00000000000000..f193e41b432878 --- /dev/null +++ b/files/es/web/api/document/createevent/index.md @@ -0,0 +1,40 @@ +--- +title: Event.createEvent() +slug: Web/API/Document/createEvent +tags: + - API + - DOM + - Evento + - metodo +translation_of: Web/API/Document/createEvent +translation_of_original: Web/API/Event/createEvent +original_slug: Web/API/Event/createEvent +--- +{{APIRef("DOM")}} + +Crea un nuevo evento, que debe ser inicializado llamando a su método `init()`. + +### Sintaxis + +```js +document.createEvent(tipo); +``` + +- `tipo` + - : Una string indicando el tipo de evento a crear. + +Este método devuelve un nuevo objeto {{ domxref("Event") }} del DOM del tipo indicado, que debe ser inicializado antes de su uso. + +### Ejemplo + +```js +var nuevoEvento = document.createEvent("UIEvents"); +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/createrange/index.html b/files/es/web/api/document/createrange/index.html deleted file mode 100644 index 8c0cc633911508..00000000000000 --- a/files/es/web/api/document/createrange/index.html +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: document.createRange -slug: Web/API/Document/createRange -tags: - - Rango - - Referencia_DOM_de_Gecko - - crear rango -translation_of: Web/API/Document/createRange ---- -

{{ ApiRef() }}

- -

Resumen

- -

Retorna un nuevo objeto Rango.

- -

Sintáxis

- -
range = document.createRange();
-
- -

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

- -

Ejemplo

- -
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.

- -

Especificación

- -

DOM Level 2 Range: DocumentRange.createRange

- - - -
- -

{{ languages( { "en": "en/DOM/document.createRange", "pl": "pl/DOM/document.createRange" } ) }}

diff --git a/files/es/web/api/document/createrange/index.md b/files/es/web/api/document/createrange/index.md new file mode 100644 index 00000000000000..e51a3ea8928dd7 --- /dev/null +++ b/files/es/web/api/document/createrange/index.md @@ -0,0 +1,42 @@ +--- +title: document.createRange +slug: Web/API/Document/createRange +tags: + - Rango + - Referencia_DOM_de_Gecko + - crear rango +translation_of: Web/API/Document/createRange +--- +{{ ApiRef() }} + +### Resumen + +Retorna un nuevo objeto [`Rango`](https://developer.mozilla.org/es/docs/Web/API/Range). + +### Sintáxis + +```js +range = document.createRange(); +``` + +En este ejemplo, `range` es el nuevo objeto [rango](/es/docs/Web/API/Range) 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 + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/createtextnode/index.html b/files/es/web/api/document/createtextnode/index.html deleted file mode 100644 index c1d69aabcb46b6..00000000000000 --- a/files/es/web/api/document/createtextnode/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: Document.createTextNode() -slug: Web/API/Document/createTextNode -tags: - - API - - DOM - - Documento - - Referencia - - createTextNode - - metodo -translation_of: Web/API/Document/createTextNode ---- -
{{APIRef("DOM")}}
- -

Crea un nuevo nodo de texto. Este método puede ser usado para escapar caracteres HTML.

- -

Sintaxis

- -
var text = document.createTextNode(data);
-
- -
    -
  • text es un nodo Text.
  • -
  • data es una cadena de texto string que contiene los datos a poner en el nodo de texto.
  • -
- -

Ejemplo

- -
<!DOCTYPE html>
-<html lang="en">
-<head>
-<title>createTextNode example</title>
-<script>
-function addTextNode(text) {
-  var newtext = document.createTextNode(text),
-      p1 = document.getElementById("p1");
-
-  p1.appendChild(newtext);
-}
-</script>
-</head>
-
-<body>
-  <button onclick="addTextNode('YES! ');">YES!</button>
-  <button onclick="addTextNode('NO! ');">NO!</button>
-  <button onclick="addTextNode('WE CAN! ');">WE CAN!</button>
-
-  <hr />
-
-  <p id="p1">First line of paragraph.</p>
-</body>
-</html>
-
- -

Especificaciones

- - - - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName('DOM WHATWG', '#dom-document-createtextnode', 'Document: createTextNode')}}{{Spec2('DOM WHATWG')}}
- -

Compatibilidad con navegadores

- - - -

{{Compat("api.Document.createTextNode")}}

diff --git a/files/es/web/api/document/createtextnode/index.md b/files/es/web/api/document/createtextnode/index.md new file mode 100644 index 00000000000000..bced3fe3a42c4d --- /dev/null +++ b/files/es/web/api/document/createtextnode/index.md @@ -0,0 +1,61 @@ +--- +title: Document.createTextNode() +slug: Web/API/Document/createTextNode +tags: + - API + - DOM + - Documento + - Referencia + - createTextNode + - metodo +translation_of: Web/API/Document/createTextNode +--- +{{APIRef("DOM")}} + +Crea un nuevo nodo de texto. Este método puede ser usado para escapar caracteres HTML. + +## Sintaxis + +```js +var text = document.createTextNode(data); +``` + +- _text_ es un nodo Text. +- _data_ es una cadena de texto [string](/es/docs/Web/JavaScript/Reference/Global_Objects/String) que contiene los datos a poner en el nodo de texto. + +## Ejemplo + +```html + + + +createTextNode example + + + + + + + + +
+ +

First line of paragraph.

+ + +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/defaultview/index.html b/files/es/web/api/document/defaultview/index.html deleted file mode 100644 index 4326f3573ee192..00000000000000 --- a/files/es/web/api/document/defaultview/index.html +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Document.defaultView -slug: Web/API/Document/defaultView -tags: - - API - - Document - - HTML DOM - - NeedsUpdate - - Property - - Reference -translation_of: Web/API/Document/defaultView ---- -
{{ ApiRef() }}
- -

Resumen

- -

En los navegadores devuelve el objeto window asociado con el document o null si no está disponible.

- -

Sintaxis

- -
var win = document.defaultView;
- -

Esta propiedad es de solo lectura.

- -

Notas

- -

De acuerco con quirksmode, defaultView no está soportado en IE hasta su version 9.

- -

Especificación

- - diff --git a/files/es/web/api/document/defaultview/index.md b/files/es/web/api/document/defaultview/index.md new file mode 100644 index 00000000000000..83cc8f66ac2710 --- /dev/null +++ b/files/es/web/api/document/defaultview/index.md @@ -0,0 +1,37 @@ +--- +title: Document.defaultView +slug: Web/API/Document/defaultView +tags: + - API + - Document + - HTML DOM + - NeedsUpdate + - Property + - Reference +translation_of: Web/API/Document/defaultView +--- +{{ ApiRef() }} + +## Resumen + +En los navegadores devuelve el objeto [window](/es/docs/DOM/window "DOM/window") asociado con el `document `o `null` si no está disponible. + +## Sintaxis + +```js +var win = document.defaultView; +``` + +Esta propiedad es de solo lectura. + +## Notas + +De acuerco con [quirksmode](http://www.quirksmode.org/dom/w3c_html.html), `defaultView` no está soportado en IE hasta su version 9. + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/designmode/index.html b/files/es/web/api/document/designmode/index.html deleted file mode 100644 index 20e648dd7f4aae..00000000000000 --- a/files/es/web/api/document/designmode/index.html +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: Document.designMode -slug: Web/API/Document/designMode -tags: - - API - - Documento - - HTML DOM - - Propiedad - - Referencia - - editor -translation_of: Web/API/Document/designMode ---- -
{{ ApiRef() }}
- -

document.designMode controla la posibilidad de editar un documento entero. Los valores válidos son "on" y "off". De acuerdo a las especificaciones, el valor predeterminado de esta propiedad es "off". Firefox sigue este estándar. El valor predeterminado de versiones anteriores de Chrome y IE es "inherit". En IE6-10, el valor se escribe con mayúscula.

- -

Sintaxis

- -
var mode = document.designMode;
-document.designMode = "on" || "off";
- -

Ejemplo

- -

Hacer un documento {{HTMLElement("iframe")}} editable:

- -
iframeNode.contentDocument.designMode = "on";
-
- -

Especificaciones

- - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName('HTML WHATWG', '#making-entire-documents-editable:-the-designmode-idl-attribute', 'designMode')}}{{Spec2('HTML WHATWG')}}Definición inicial.
- -

Compatibilidad de Navegadores

- -

{{Compat("api.Document.designMode")}}

- -

Ver también

- - diff --git a/files/es/web/api/document/designmode/index.md b/files/es/web/api/document/designmode/index.md new file mode 100644 index 00000000000000..3988ea8f0d9a48 --- /dev/null +++ b/files/es/web/api/document/designmode/index.md @@ -0,0 +1,44 @@ +--- +title: Document.designMode +slug: Web/API/Document/designMode +tags: + - API + - Documento + - HTML DOM + - Propiedad + - Referencia + - editor +translation_of: Web/API/Document/designMode +--- +{{ ApiRef() }} + +**`document.designMode`** controla la posibilidad de editar un documento entero. Los valores válidos son `"on"` y `"off"`. De acuerdo a las especificaciones, el valor predeterminado de esta propiedad es `"off"`. Firefox sigue este estándar. El valor predeterminado de versiones anteriores de Chrome y IE es `"inherit"`. En IE6-10, el valor se escribe con mayúscula. + +## Sintaxis + +```js +var mode = document.designMode; +document.designMode = "on" || "off"; +``` + +## Ejemplo + +Hacer un documento {{HTMLElement("iframe")}} editable: + +```js +iframeNode.contentDocument.designMode = "on"; +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + +## Ver también + +- [Editando text enriquecido en Mozilla](/es/docs/Rich-Text_Editing_in_Mozilla) +- {{domxref("HTMLElement.contentEditable")}} +- [propiedad designMode]() en MSDN diff --git a/files/es/web/api/document/dir/index.html b/files/es/web/api/document/dir/index.html deleted file mode 100644 index c8b5f96b713664..00000000000000 --- a/files/es/web/api/document/dir/index.html +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Document.dir -slug: Web/API/Document/dir -translation_of: Web/API/Document/dir ---- -

{{ApiRef("")}}{{non-standard_header}}

- -

La propiedad Document.dir es una {{domxref("DOMString")}} que representa la dirección del texto del documento, ya sea de izquierda a derecha o de derecha a izquierda, siendo la primera el valor por defecto. Sus valores posibles son rtl (Right To Left) o ltr (Left To Right).

- -

Sintáxis

- -
dirStr = document.dir;
-document.dir = dirStr;
-
- -

Especificaciones

- -

HTML5 WHATWG

- -

Compatibilidad de Navegadores

- -{{Compat("api.Document.dir")}} - -

Véase también

- - diff --git a/files/es/web/api/document/dir/index.md b/files/es/web/api/document/dir/index.md new file mode 100644 index 00000000000000..c29ec71c2d1751 --- /dev/null +++ b/files/es/web/api/document/dir/index.md @@ -0,0 +1,27 @@ +--- +title: Document.dir +slug: Web/API/Document/dir +translation_of: Web/API/Document/dir +--- +{{ApiRef("DOM")}} + +La propiedad **`Document.dir`** es una {{domxref("DOMString")}} que representa la dirección del texto del documento, ya sea de izquierda a derecha o de derecha a izquierda, siendo la primera el valor por defecto. Sus valores posibles son _rtl_ (Right To Left) o _ltr_ (Left To Right). + +## Sintáxis + +```js +dirStr = document.dir; +document.dir = dirStr; +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + +## Véase también + +- diff --git a/files/es/web/api/document/doctype/index.html b/files/es/web/api/document/doctype/index.html deleted file mode 100644 index 1ccb202c23b3de..00000000000000 --- a/files/es/web/api/document/doctype/index.html +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Document.doctype -slug: Web/API/Document/doctype -tags: - - API - - DOCTYPE - - DOM - - Document - - Propiedad - - Referencia -translation_of: Web/API/Document/doctype ---- -
{{ApiRef("DOM")}}
- -

Devuelve la Declaración de tipo de documento (Document Type Declaration (DTD)), asociada al documento actual. El objeto devuelto implementa la interfaz {{domxref("DocumentType")}}. Utilice {{domxref("DOMImplementation.createDocumentType()")}} para crear un DocumentType.

- -

Sintaxis

- -
doctype = document.doctype;
-
- -
    -
  • doctype es una propiedad de sólo lectura.
  • -
- -

Ejemplo

- -
var doctypeObj = document.doctype;
-
-console.log(
-  "doctypeObj.name: "           + doctypeObj.name            + "\n" +
-  "doctypeObj.internalSubset: " + doctypeObj.internalSubset  + "\n" +
-  "doctypeObj.publicId: "       + doctypeObj.publicId        + "\n" +
-  "doctypeObj.systemId: "       + doctypeObj.systemId
-);
- -

Notas

- -

La propiedad devuelve null si no hay DTD asociada al documento actual.

- -

El nivel 2 de DOM no soporta la edición de la declaración de tipo de documento.

- -

Especificaciones

- - - - - - - - - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName("DOM3 Core", "core.html#ID-B63ED1A31", "Document.doctype")}}{{Spec2("DOM3 Core")}}Cambiado el valor de retorno para documentos HTML sin el elemento {{HTMLElement("html")}}. Define que el tipo de documento puede ser modificado.
{{SpecName("DOM2 Core", "core.html#ID-B63ED1A31", "Document.doctype")}}{{Spec2("DOM2 Core")}}Definición inicial
diff --git a/files/es/web/api/document/doctype/index.md b/files/es/web/api/document/doctype/index.md new file mode 100644 index 00000000000000..6cce623218faab --- /dev/null +++ b/files/es/web/api/document/doctype/index.md @@ -0,0 +1,49 @@ +--- +title: Document.doctype +slug: Web/API/Document/doctype +tags: + - API + - DOCTYPE + - DOM + - Document + - Propiedad + - Referencia +translation_of: Web/API/Document/doctype +--- +{{ApiRef("DOM")}} + +Devuelve la Declaración de tipo de documento (Document Type Declaration (DTD)), asociada al documento actual. El objeto devuelto implementa la interfaz {{domxref("DocumentType")}}. Utilice {{domxref("DOMImplementation.createDocumentType()")}} para crear un `DocumentType`. + +## Sintaxis + +```js +doctype = document.doctype; +``` + +- `doctype` es una propiedad de sólo lectura. + +## Ejemplo + +```js +var doctypeObj = document.doctype; + +console.log( + "doctypeObj.name: " + doctypeObj.name + "\n" + + "doctypeObj.internalSubset: " + doctypeObj.internalSubset + "\n" + + "doctypeObj.publicId: " + doctypeObj.publicId + "\n" + + "doctypeObj.systemId: " + doctypeObj.systemId +); +``` + +## Notas + +La propiedad devuelve `null` si no hay DTD asociada al documento actual. + +El nivel 2 de DOM no soporta la edición de la declaración de tipo de documento. +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/documentelement/index.html b/files/es/web/api/document/documentelement/index.html deleted file mode 100644 index 30453050f736b7..00000000000000 --- a/files/es/web/api/document/documentelement/index.html +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: document.documentElement -slug: Web/API/Document/documentElement -tags: - - Referencia_DOM_de_Gecko -translation_of: Web/API/Document/documentElement ---- -

{{ ApiRef("DOM") }}

- -

Resumen

- -

Solo-lectura

- -

Devuelve el Element que es el elemento raíz de document (por ejemplo, devuelve el elemento <html> en los documentos HTML).

- -

Sintaxis

- -
varelement = document.documentElement;
-
- -

Ejemplo

- -
var rootElement = document.documentElement;
-var firstTier = rootElement.childNodes;
-// firstTier el la NodeList de los hijos directos del elemento raízof the direct children of the root element
-for (var i = 0; i < firstTier.length; i++) {
-   // hacer algo con cada uno de los hijos directos del elemento raíz
-   // como firstTier[i]
-}
-
- -

Notas

- -

Esta propiedad es de sólo-lectura, facilitada para obtener el elemento raíz de cualquier documento.

- -

Los documentos HTML contienen normalmente un único hijo directo, <html>, quizá con una declaración DOCTYPE antes que él. Los documento XML contienen a menudo, múltiples hijos: el elemento raíz, la declaración DOCTYPE y processing instructions.

- -

Por tanto, deberías usar document.documentElement en lugar de {{ Domxref("document.firstChild") }} para obtener el elemento raíz.

- -

Especificación

- -

DOM Level 2 Core: Document.documentElement

diff --git a/files/es/web/api/document/documentelement/index.md b/files/es/web/api/document/documentelement/index.md new file mode 100644 index 00000000000000..812e747eb8898c --- /dev/null +++ b/files/es/web/api/document/documentelement/index.md @@ -0,0 +1,48 @@ +--- +title: document.documentElement +slug: Web/API/Document/documentElement +tags: + - Referencia_DOM_de_Gecko +translation_of: Web/API/Document/documentElement +--- +{{ ApiRef("DOM") }} + +### Resumen + +**Solo-lectura** + +Devuelve el [`Element`](es/DOM/element) que es el elemento raíz de [document](es/DOM/document) (por ejemplo, devuelve el elemento `` en los documentos HTML). + +### Sintaxis + +```js +varelement = document.documentElement; +``` + +### Ejemplo + +```js +var rootElement = document.documentElement; +var firstTier = rootElement.childNodes; +// firstTier el la NodeList de los hijos directos del elemento raízof the direct children of the root element +for (var i = 0; i < firstTier.length; i++) { + // hacer algo con cada uno de los hijos directos del elemento raíz + // como firstTier[i] +} +``` + +### Notas + +Esta propiedad es de sólo-lectura, facilitada para obtener el elemento raíz de cualquier documento. + +Los documentos HTML contienen normalmente un único hijo directo, ``, quizá con una declaración DOCTYPE antes que él. Los documento XML contienen a menudo, múltiples hijos: el elemento raíz, la declaración DOCTYPE y [processing instructions](es/DOM/ProcessingInstruction). + +Por tanto, deberías usar `document.documentElement` en lugar de {{ Domxref("document.firstChild") }} para obtener el elemento raíz. + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/documenturi/index.html b/files/es/web/api/document/documenturi/index.html deleted file mode 100644 index 0d8fc85d56de3c..00000000000000 --- a/files/es/web/api/document/documenturi/index.html +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: Document.documentURI -slug: Web/API/Document/documentURI -tags: - - API - - ContenidoNecesario - - DOM - - EjemploNecesario - - Propiedad - - Referencia - - UbicaciónDocumento -translation_of: Web/API/Document/documentURI ---- -
{{ApiRef("DOM")}}
- -

La propiedad documentURI de la interfaz del documento ({{domxref("Document")}}) devuelve la ubicación del documento como un string.

- -

Originalmente DOM3 fue definido como un atributo de lectura/escritura. En DOM4 se especifica unicamente como de lectura.

- -

Sintaxis

- -
var string = document.documentURI;
-
- -

Notas

- -

Los documentos HTML tienen una propiedad {{domxref("document.URL")}} la cual devuelve el mismo valor (ubicación del documento). A diferencia de URL, documentURI está disponible para todos los tipos de documentos web.

- -

Especificaciones

- - - - - - - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName('DOM4', '#dom-document-documenturi','documentURI')}}{{Spec2('DOM4')}}
{{SpecName('DOM3 Core', '#Document3-documentURI', 'documentURI')}}{{Spec2('DOM3 Core')}}Definición inicial
- -

Compatibilidad de navegadores

- -{{Compat("api.Document.documentURI")}} diff --git a/files/es/web/api/document/documenturi/index.md b/files/es/web/api/document/documenturi/index.md new file mode 100644 index 00000000000000..15ad93c30f1100 --- /dev/null +++ b/files/es/web/api/document/documenturi/index.md @@ -0,0 +1,36 @@ +--- +title: Document.documentURI +slug: Web/API/Document/documentURI +tags: + - API + - ContenidoNecesario + - DOM + - EjemploNecesario + - Propiedad + - Referencia + - UbicaciónDocumento +translation_of: Web/API/Document/documentURI +--- +{{ApiRef("DOM")}} + +La propiedad **`documentURI`** de la interfaz del documento ({{domxref("Document")}}) devuelve la ubicación del documento como un _string_. + +Originalmente DOM3 fue definido como un atributo de lectura/escritura. En DOM4 se especifica unicamente como de lectura. + +## Sintaxis + +```js +var string = document.documentURI; +``` + +## Notas + +Los documentos HTML tienen una propiedad {{domxref("document.URL")}} la cual devuelve el mismo valor (ubicación del documento). A diferencia de `URL`, `documentURI` está disponible para todos los tipos de documentos web. + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/embeds/index.html b/files/es/web/api/document/embeds/index.html deleted file mode 100644 index e60f43772711f2..00000000000000 --- a/files/es/web/api/document/embeds/index.html +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Document.embeds -slug: Web/API/Document/embeds -tags: - - API - - Documento - - Ejemplo - - HTML DOM - - Propiedad -translation_of: Web/API/Document/embeds ---- -
{{ApiRef}}
- -

embeds es una propiedad de sólo lectura de la interfaz de {{domxref("Document")}}. Devuelve una lista con los elementos {{htmlelement("object")}} incrustados dentro del documento actual.

- -

Sintaxis

- -
nodeList = document.embeds
-
- -

Valor

- -

Una {{domxref("HTMLCollection")}}.

- -

Especificaciones

- - - - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName('HTML WHATWG', '#dom-document-embeds', 'Document.embeds')}}{{ Spec2('HTML WHATWG') }}
- -

Compatibilidad con Navegadores

- - - -
{{Compat("api.Document.embeds")}}
diff --git a/files/es/web/api/document/embeds/index.md b/files/es/web/api/document/embeds/index.md new file mode 100644 index 00000000000000..c5dd5e9ce29640 --- /dev/null +++ b/files/es/web/api/document/embeds/index.md @@ -0,0 +1,32 @@ +--- +title: Document.embeds +slug: Web/API/Document/embeds +tags: + - API + - Documento + - Ejemplo + - HTML DOM + - Propiedad +translation_of: Web/API/Document/embeds +--- +{{ApiRef}} + +**`embeds`** es una propiedad de sólo lectura de la interfaz de {{domxref("Document")}}. Devuelve una lista con los elementos {{htmlelement("object")}} incrustados dentro del documento actual. + +## Sintaxis + +```js +nodeList = document.embeds +``` + +### Valor + +Una {{domxref("HTMLCollection")}}. + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/execcommand/index.html b/files/es/web/api/document/execcommand/index.html deleted file mode 100644 index 5a1c168c68ab8a..00000000000000 --- a/files/es/web/api/document/execcommand/index.html +++ /dev/null @@ -1,226 +0,0 @@ ---- -title: Document.execCommand() -slug: Web/API/Document/execCommand -tags: - - API - - DOM - - Método(2) - - NecesitaEjemplo - - Referencia - - editor -translation_of: Web/API/Document/execCommand ---- -
{{ApiRef("DOM")}}
- -

Resumen

- -

Cuando un documento HTML se ha cambiado a designMode, el objeto de documento expone el método execCommand lo que permite ejecutar comandos para manipular el contenido de la región editable. La mayoría de los comandos afectan a la selección de documento (negrita, cursiva, etc.), mientras que otros insertar nuevos elementos (añadiendo un enlace) o afectan a toda una línea (sangría). Al usar contentEditable, la llamada a execCommand afectará el elemento editable activo actual.

- -

Sintaxis

- -
execCommand(aCommandName, aShowDefaultUI, aValueArgument)
-
- -

Parámetros

- -
-
aCommandName
-
Una {{domxref("DOMString")}} que especifica el nombre del comando a ejecutar. Vea Comandos para una lista de posibles comandos.
-
aShowDefaultUI
-
Un {{jsxref("Boolean")}} que indica si la interfaz de usuario por defecto se debe mostrar. Esto no se ha implementado en Mozilla.
-
aValueArgument
-
Una {{domxref("DOMString")}} representando algunos comandos (como insertImage) requiere un argumento valor extra (url de la imagen). Pasar un argumento de null si no se necesita ningún argumento.
-
- -

Comandos

- -
-
backColor
-
Cambia el color de fondo del documento. En el modo styleWithCss, afecta el color de fondo del bloque que contiene. Esto requiere una cadena con el valor del color de fondo que se pasa como un valor de argumento. (Internet Explorer utiliza esta opción para definir el color de fondo del texto.)
-
bold
-
Pone las negritas o las quita para la selección o en el punto de inserción. (Internet Explorer utiliza la etiqueta STRONG en lugar de B.)
-
contentReadOnly
-
Hace que el documento de contenido, ya sea de sólo lectura o editable. Esto requiere un booleano verdadero / falso que se pasa como un valor de argumento. (No es compatible con Internet Explorer.)
-
copy
-
Copia la selección actual en el portapapeles. Capacidad del Portapapeles debe estar habilitado en el archivo de preferencias user.js. Vea
-
createLink
-
Crea un vínculo de anclaje a partir de la selección, sólo si hay una selección. Esto requiere la cadena HREF URI que se pasa como un argumento de valor. El URI debe contener al menos un solo carácter, el cual puede ser un espacio en blanco. (Internet Explorer creará un enlace con un nulo valor URI.)
-
cut
-
Corta la selección y lo copia en el portapapeles actual. Capacidad del Portapapeles debe estar habilitado en el archivo de preferencias user.js. Vea
-
decreaseFontSize
-
Añade una etiqueta SMALL alrededor de la selección o en el punto de inserción. (No es compatible con Internet Explorer.)
-
delete
-
Elimina la selección actual.
-
enableInlineTableEditing
-
Activa o desactiva la fila de la tabla y los controles de inserción y supresión de columna. (No es compatible con Internet Explorer.)
-
enableObjectResizing
-
Activa o desactiva los controladores de tamaño en imágenes y otros objetos de tamaño variable. (No es compatible con Internet Explorer.)
-
fontName
-
Cambia el nombre de la fuente para la selección o en el punto de inserción. Esto requiere una cadena de nombre de la fuente ("Arial", por ejemplo) que se pasa como un valor de argumento.
-
fontSize
-
Cambia el tamaño de fuente para la selección o en el punto de inserción. Esto requiere un tamaño de fuente HTML (1-7) que se pasa como un valor de argumento.
-
foreColor
-
Cambia un color de fuente para la selección o en el punto de inserción. Esto requiere una cadena de valor de color que se pasa como un valor de argumento.
-
formatBlock
-
Añade una etiqueta HTML de estilo bloque alrededor de la línea que contiene la selección actual, reemplazando el elemento de bloque que contiene la línea si existe (en Firefox, BLOCKQUOTE es la excepción - que envolverá cualquier elemento de bloque que contiene). Requiere una cadena de etiqueta-nombre que se pasa como un argumento de valor. Prácticamente todas las etiquetas de estilo bloque se pueden utilizar (por ejemplo. "H1", "P", "DL", "BLOCKQUOTE"). (Internet Explorer sólo admite etiquetas de título H1 - H6, dirección y PRE, que también debe incluir los delimitadores de etiquetas <>, como "<H1>".)
-
forwardDelete
-
Elimina el character delante de la posición del cursor cursor. Es lo mismo que pulsar la tecla suprimir.
-
heading
-
Añade una etiqueta de encabezado en torno a una selección, o la línea en el punto de inserción. Requiere la cadena de nombre de etiqueta que se pasa como un valor de argumento (es decir, "H1", "H6"). (No es compatible con Internet Explorer y Safari.)
-
hiliteColor
-
Cambia el color de fondo para la selección o el punto de inserción. Requiere una cadena de valores de color que se pasa como un valor de argumento. UseCSS debe estar encendido para que esto funcione. (No es compatible con Internet Explorer.)
-
increaseFontSize
-
Añade una etiqueta BIG alrededor de la selección o en el punto de inserción. (No es compatible con Internet Explorer.)
-
indent
-
Indenta la línea que contiene el punto de selección o inserción. En Firefox, si la selección abarca varias líneas en los diferentes niveles de indentación serán indentadas sólo las líneas menos indentadas en la selección.
-
insertBrOnReturn
-
Controla si la tecla Intro inserta una etiqueta br o divide el elemento de bloque actual en dos. (No es compatible con Internet Explorer.)
-
insertHorizontalRule
-
Inserta una regla horizontal en el punto de inserción (borra la selección).
-
insertHTML
-
Inserta una cadena HTML en el punto de inserción (borra la selección). Requiere una cadena HTML válido que se ha pasado como un valor de argumento. (No es compatible con Internet Explorer.)
-
insertImage
-
Inserta una imagen en el punto de inserción (borra la selección). Requiere la cadena de imagen SRC URI que se pasa como un argumento de valor. El URI debe contener al menos un solo carácter, que puede ser un espacio en blanco. (Internet Explorer creará un enlace con un nulo valor URI.)
-
insertOrderedList
-
Crea una lista ordenada con números para la selección o en el punto de inserción.
-
insertUnorderedList
-
Crea una lista desordenada con viñetas para la selección o en el punto de inserción.
-
insertParagraph
-
Inserta un párrafo en torno a la selección o la línea actual. (Internet Explorer inserta un párrafo en el punto de inserción y elimina la selección.)
-
insertText
-
Inserta el texto plano expedido en el punto de inserción (borra la selección).
-
italic
-
Alterna cursiva para la selección o el punto de inserción. (Internet Explorer utiliza la etiqueta de EM en lugar de I.)
-
justifyCenter
-
Centra el punto de selección o inserción.
-
justifyFull
-
Justifica el punto de selección o inserción.
-
justifyLeft
-
Justifica la selección o inserción punto a la izquierda.
-
justifyRight
-
Justifica la selección o el punto de inserción a la derecha.
-
outdent
-
Anula la sangría de la línea que contiene la selección o el punto de inserción.
-
paste
-
Pega el contenido del portapapeles en el punto de inserción (reemplaza la selección actual). Capacidad del Portapapeles debe estar habilitado en el archivo de preferencias user.js. Ver
-
redo
-
Rehace el anterior comando deshecho.
-
removeFormat
-
Quita todo el formato de la selección actual.
-
selectAll
-
Selecciona todo el contenido de la región editable.
-
strikeThrough
-
Alterna tachado para la selección o el punto de inserción.
-
subscript
-
Alterna subíndice para la selección o el punto de inserción.
-
superscript
-
Alterna exponente para la selección o el punto de inserción.
-
underline
-
Alterna subrayado para la selección o el punto de inserción.
-
undo
-
Deshace el último comando ejecutado.
-
unlink
-
Elimina la etiqueta de ancla de un enlace ancla seleccionado.
-
useCSS {{ Deprecated_inline() }}
-
Alterna el uso de etiquetas HTML o CSS para el marcado generado. Requiere un booleano verdadero / falso como valor del argumento. NOTA: Este argumento es lógicamente hacia atrás (es decir, si se usa falso a usar CSS, entonces es verdadero a usar HTML). (No compatible con Internet Explorer.) Esto ha quedado obsoleto; utilice el comando styleWithCSS en su lugar.
-
styleWithCSS
-
Reemplaza el comando useCSS; el argumento funciona como se esperaba, es decir, si es verdadero modifica / genera atributos de estilo en el marcado, falso genera elementos de formato.
-
- -

Ejemplo

- -

(Este artículo está actualmente incompleto y carece de un ejemplo.)

- -

Compatibilidad del navegador

- -{{Compat("api.Document.execCommand")}} - -

Especificación

- - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName('HTML Editing','#execcommand()','execCommand')}}{{Spec2('HTML Editing')}}
- -

Vea también

- - diff --git a/files/es/web/api/document/execcommand/index.md b/files/es/web/api/document/execcommand/index.md new file mode 100644 index 00000000000000..9e175247471aa3 --- /dev/null +++ b/files/es/web/api/document/execcommand/index.md @@ -0,0 +1,142 @@ +--- +title: Document.execCommand() +slug: Web/API/Document/execCommand +tags: + - API + - DOM + - Método(2) + - NecesitaEjemplo + - Referencia + - editor +translation_of: Web/API/Document/execCommand +--- +{{ApiRef("DOM")}}{{ Deprecated_header() }} + +## Resumen + +Cuando un documento HTML se ha cambiado a `designMode`, el objeto de documento expone el método `execCommand` lo que permite ejecutar comandos para manipular el contenido de la región editable. La mayoría de los comandos afectan a la selección de documento (negrita, cursiva, etc.), mientras que otros insertar nuevos elementos (añadiendo un enlace) o afectan a toda una línea (sangría). Al usar `contentEditable`, la llamada a `execCommand` afectará el elemento editable activo actual. + +## Sintaxis + +```js +execCommand(aCommandName, aShowDefaultUI, aValueArgument) +``` + +### Parámetros + +- `aCommandName` + - : Una {{domxref("DOMString")}} que especifica el nombre del comando a ejecutar. Vea [Comandos](#comandos) para una lista de posibles comandos. +- `aShowDefaultUI` + - : Un {{jsxref("Boolean")}} que indica si la interfaz de usuario por defecto se debe mostrar. Esto no se ha implementado en Mozilla. +- `aValueArgument` + - : Una {{domxref("DOMString")}} representando algunos comandos (como `insertImage`) requiere un argumento valor extra (url de la imagen). Pasar un argumento de `null` si no se necesita ningún argumento. + +### Comandos + +- backColor + - : Cambia el color de fondo del documento. En el modo styleWithCss, afecta el color de fondo del bloque que contiene. Esto requiere una cadena con el valor del color de fondo que se pasa como un valor de argumento. (Internet Explorer utiliza esta opción para definir el color de fondo del texto.) +- bold + - : Pone las negritas o las quita para la selección o en el punto de inserción. (Internet Explorer utiliza la etiqueta STRONG en lugar de B.) +- contentReadOnly + - : Hace que el documento de contenido, ya sea de sólo lectura o editable. Esto requiere un booleano verdadero / falso que se pasa como un valor de argumento. (No es compatible con Internet Explorer.) +- copy + - : Copia la selección actual en el portapapeles. Capacidad del Portapapeles debe estar habilitado en el archivo de preferencias user.js. Vea +- createLink + - : Crea un vínculo de anclaje a partir de la selección, sólo si hay una selección. Esto requiere la cadena HREF URI que se pasa como un argumento de valor. El URI debe contener al menos un solo carácter, el cual puede ser un espacio en blanco. (Internet Explorer creará un enlace con un nulo valor URI.) +- cut + - : Corta la selección y lo copia en el portapapeles actual. Capacidad del Portapapeles debe estar habilitado en el archivo de preferencias user.js. Vea +- decreaseFontSize + - : Añade una etiqueta SMALL alrededor de la selección o en el punto de inserción. (No es compatible con Internet Explorer.) +- delete + - : Elimina la selección actual. +- enableInlineTableEditing + - : Activa o desactiva la fila de la tabla y los controles de inserción y supresión de columna. (No es compatible con Internet Explorer.) +- enableObjectResizing + - : Activa o desactiva los controladores de tamaño en imágenes y otros objetos de tamaño variable. (No es compatible con Internet Explorer.) +- fontName + - : Cambia el nombre de la fuente para la selección o en el punto de inserción. Esto requiere una cadena de nombre de la fuente ("Arial", por ejemplo) que se pasa como un valor de argumento. +- fontSize + - : Cambia el tamaño de fuente para la selección o en el punto de inserción. Esto requiere un tamaño de fuente HTML (1-7) que se pasa como un valor de argumento. +- foreColor + - : Cambia un color de fuente para la selección o en el punto de inserción. Esto requiere una cadena de valor de color que se pasa como un valor de argumento. +- formatBlock + - : Añade una etiqueta HTML de estilo bloque alrededor de la línea que contiene la selección actual, reemplazando el elemento de bloque que contiene la línea si existe (en Firefox, BLOCKQUOTE es la excepción - que envolverá cualquier elemento de bloque que contiene). Requiere una cadena de etiqueta-nombre que se pasa como un argumento de valor. Prácticamente todas las etiquetas de estilo bloque se pueden utilizar (por ejemplo. "H1", "P", "DL", "BLOCKQUOTE"). (Internet Explorer sólo admite etiquetas de título H1 - H6, dirección y PRE, que también debe incluir los delimitadores de etiquetas <>, como "\

".) +- forwardDelete + - : Elimina el character delante de la posición del cursor [cursor](http://en.wikipedia.org/wiki/Cursor_%28computers%29 "Cursor (computers)"). Es lo mismo que pulsar la tecla suprimir. +- heading + - : Añade una etiqueta de encabezado en torno a una selección, o la línea en el punto de inserción. Requiere la cadena de nombre de etiqueta que se pasa como un valor de argumento (es decir, "H1", "H6"). (No es compatible con Internet Explorer y Safari.) +- hiliteColor + - : Cambia el color de fondo para la selección o el punto de inserción. Requiere una cadena de valores de color que se pasa como un valor de argumento. UseCSS debe estar encendido para que esto funcione. (No es compatible con Internet Explorer.) +- increaseFontSize + - : Añade una etiqueta BIG alrededor de la selección o en el punto de inserción. (No es compatible con Internet Explorer.) +- indent + - : Indenta la línea que contiene el punto de selección o inserción. En Firefox, si la selección abarca varias líneas en los diferentes niveles de indentación serán indentadas sólo las líneas menos indentadas en la selección. +- insertBrOnReturn + - : Controla si la tecla Intro inserta una etiqueta br o divide el elemento de bloque actual en dos. (No es compatible con Internet Explorer.) +- insertHorizontalRule + - : Inserta una regla horizontal en el punto de inserción (borra la selección). +- insertHTML + - : Inserta una cadena HTML en el punto de inserción (borra la selección). Requiere una cadena HTML válido que se ha pasado como un valor de argumento. (No es compatible con Internet Explorer.) +- insertImage + - : Inserta una imagen en el punto de inserción (borra la selección). Requiere la cadena de imagen SRC URI que se pasa como un argumento de valor. El URI debe contener al menos un solo carácter, que puede ser un espacio en blanco. (Internet Explorer creará un enlace con un nulo valor URI.) +- insertOrderedList + - : Crea una lista ordenada con números para la selección o en el punto de inserción. +- insertUnorderedList + - : Crea una lista desordenada con viñetas para la selección o en el punto de inserción. +- insertParagraph + - : Inserta un párrafo en torno a la selección o la línea actual. (Internet Explorer inserta un párrafo en el punto de inserción y elimina la selección.) +- insertText + - : Inserta el texto plano expedido en el punto de inserción (borra la selección). +- italic + - : Alterna cursiva para la selección o el punto de inserción. (Internet Explorer utiliza la etiqueta de EM en lugar de I.) +- justifyCenter + - : Centra el punto de selección o inserción. +- justifyFull + - : Justifica el punto de selección o inserción. +- justifyLeft + - : Justifica la selección o inserción punto a la izquierda. +- justifyRight + - : Justifica la selección o el punto de inserción a la derecha. +- outdent + - : Anula la sangría de la línea que contiene la selección o el punto de inserción. +- paste + - : Pega el contenido del portapapeles en el punto de inserción (reemplaza la selección actual). Capacidad del Portapapeles debe estar habilitado en el archivo de preferencias user.js. Ver +- redo + - : Rehace el anterior comando deshecho. +- removeFormat + - : Quita todo el formato de la selección actual. +- selectAll + - : Selecciona todo el contenido de la región editable. +- strikeThrough + - : Alterna tachado para la selección o el punto de inserción. +- subscript + - : Alterna subíndice para la selección o el punto de inserción. +- superscript + - : Alterna exponente para la selección o el punto de inserción. +- underline + - : Alterna subrayado para la selección o el punto de inserción. +- undo + - : Deshace el último comando ejecutado. +- unlink + - : Elimina la etiqueta de ancla de un enlace ancla seleccionado. +- useCSS {{ Deprecated_inline() }} + - : Alterna el uso de etiquetas HTML o CSS para el marcado generado. Requiere un booleano verdadero / falso como valor del argumento. NOTA: Este argumento es lógicamente hacia atrás (es decir, si se usa falso a usar CSS, entonces es verdadero a usar HTML). (No compatible con Internet Explorer.) Esto ha quedado obsoleto; utilice el comando _styleWithCSS_ en su lugar. +- styleWithCSS + - : Reemplaza el comando _useCSS_; el argumento funciona como se esperaba, es decir, si es verdadero modifica / genera atributos de estilo en el marcado, falso genera elementos de formato. + +## Ejemplo + +(Este artículo está actualmente incompleto y carece de un ejemplo.) + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} +## Vea también + +- {{domxref("document.contentEditable")}} +- {{domxref("document.designMode")}} +- [Edición de texto enriquecido en Mozilla](/es/docs/Rich-Text_Editing_in_Mozilla) diff --git a/files/es/web/api/document/exitfullscreen/index.html b/files/es/web/api/document/exitfullscreen/index.html deleted file mode 100644 index c64933da849e0d..00000000000000 --- a/files/es/web/api/document/exitfullscreen/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: Document.exitFullscreen() -slug: Web/API/Document/exitFullscreen -translation_of: Web/API/Document/exitFullscreen ---- -
{{ApiRef("Fullscreen API")}}
- -

El método exitFullscreen() de {{domxref("Document")}} solicita que el elemento de este documento que se presenta actualmente en modo de pantalla completa se retire del modo de pantalla completa, restaurando el estado anterior de la pantalla. Esto generalmente revierte los efectos de una llamada previa a {{domxref("Element.requestFullscreen()")}}.

- -

La excepción es si otro elemento ya estaba en modo de pantalla completa cuando el elemento actual se colocó en modo de pantalla completa usando requestFullscreen(). En ese caso, el elemento de pantalla completa anterior se restaura al estado de pantalla completa. En esencia, se mantiene un {{interwiki("wikipedia", "Stack_(abstract_data_type)", "stack")}} de elementos de pantalla completa.

- -

Sintaxis

- -
exitPromise = document.exitFullscreen();
-
- -

Parámetros

- -

Ninguno.

- -

Valor de retorno

- -

Un {{jsxref("Promise")}} que se resuelve una vez que el {{Glossary("user agent")}} a terminado de salir del modo de pantalla completa. Si se produce un error al intentar salir del modo de pantalla completa, se llama al controlador catch() para la promesa.

- -

Ejemplo

- -

Este ejemplo hace que el documento actual entre y salga de una presentación a pantalla completa cada vez que se hace clic dentro del botón del mouse.

- -
document.onclick = function (event) {
-  if (document.fullscreenElement) {
-    document.exitFullscreen()
-  } else {
-    document.documentElement.requestFullscreen()
-  }
-};
- -
-

Nota: Para un ejemplo más completo, vea {{SectionOnPage("/en-US/docs/Web/API/Element/requestFullScreen", "Example")}}.

-
- -

Especificaciones

- - - - - - - - - - - - - - - - -
EspecificaciónEstadoComentarios
{{SpecName("Fullscreen", "#dom-document-exitfullscreen", "Document.exitFullscreen()")}}{{Spec2("Fullscreen")}}Definición inicial
- -

Compatibilidad del navegador

- - - -

{{Compat("api.Document.exitFullscreen")}}

- -

Ver también

- -
    -
  • Fullscreen API
  • -
  • Guide to the Fullscreen API
  • -
  • {{ domxref("Element.requestFullscreen()") }}
  • -
  • {{ domxref("Document.fullscreenElement") }}
  • -
  • {{ cssxref(":fullscreen") }} and {{cssxref("::backdrop")}}
  • -
  • The {{HTMLElement("iframe")}} {{ HTMLAttrXRef("allowfullscreen", "iframe") }} attribute
  • -
diff --git a/files/es/web/api/document/exitfullscreen/index.md b/files/es/web/api/document/exitfullscreen/index.md new file mode 100644 index 00000000000000..820d70471a8b7c --- /dev/null +++ b/files/es/web/api/document/exitfullscreen/index.md @@ -0,0 +1,57 @@ +--- +title: Document.exitFullscreen() +slug: Web/API/Document/exitFullscreen +translation_of: Web/API/Document/exitFullscreen +--- +{{ApiRef("Fullscreen API")}} + +El método **`exitFullscreen()`** de {{domxref("Document")}} solicita que el elemento de este documento que se presenta actualmente en modo de pantalla completa se retire del modo de pantalla completa, restaurando el estado anterior de la pantalla. Esto generalmente revierte los efectos de una llamada previa a {{domxref("Element.requestFullscreen()")}}. + +La excepción es si otro elemento ya estaba en modo de pantalla completa cuando el elemento actual se colocó en modo de pantalla completa usando `requestFullscreen()`. En ese caso, el elemento de pantalla completa anterior se restaura al estado de pantalla completa. En esencia, se mantiene un {{interwiki("wikipedia", "Stack_(abstract_data_type)", "stack")}} de elementos de pantalla completa. + +## Sintaxis + +```js +exitPromise = document.exitFullscreen(); +``` + +### Parámetros + +Ninguno. + +### Valor de retorno + +Un {{jsxref("Promise")}} que se resuelve una vez que el {{Glossary("user agent")}} a terminado de salir del modo de pantalla completa. Si se produce un error al intentar salir del modo de pantalla completa, se llama al controlador `catch()` para la promesa. + +## Ejemplo + +Este ejemplo hace que el documento actual entre y salga de una presentación a pantalla completa cada vez que se hace clic dentro del botón del mouse. + +```js +document.onclick = function (event) { + if (document.fullscreenElement) { + document.exitFullscreen() + } else { + document.documentElement.requestFullscreen() + } +}; +``` + +> **Nota:** Para un ejemplo más completo, vea {{SectionOnPage("/en-US/docs/Web/API/Element/requestFullScreen", "Example")}}. + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + +## Ver también + +- [Fullscreen API](/es/docs/Web/API/Fullscreen_API) +- [Guide to the Fullscreen API](/es/docs/Web/API/Fullscreen_API/Guide) +- {{ domxref("Element.requestFullscreen()") }} +- {{ domxref("Document.fullscreenElement") }} +- {{ cssxref(":fullscreen") }} and {{cssxref("::backdrop")}} +- The {{HTMLElement("iframe")}} {{ HTMLAttrXRef("allowfullscreen", "iframe") }} attribute diff --git a/files/es/web/api/document/getelementbyid/index.html b/files/es/web/api/document/getelementbyid/index.html deleted file mode 100644 index 1581422dedb071..00000000000000 --- a/files/es/web/api/document/getelementbyid/index.html +++ /dev/null @@ -1,154 +0,0 @@ ---- -title: document.getElementById -slug: Web/API/Document/getElementById -tags: - - API - - DOM - - Documento - - Elementos - - Referencia - - Web - - id - - metodo -translation_of: Web/API/Document/getElementById ---- -
{{ ApiRef("DOM") }}
- -
- -

Devuelve una referencia al elemento por su ID.

- -

Sintaxis

- -
elemento = document.getElementById(id);
-
- -

Parámetros

- -
-
id
-
Es una cadena sensible a mayúsculas referida al ID único del elemento buscado.
-
- -

Valor Retornado

- -
-
element
-
Es una referencia a un objeto {{domxref("Element")}}, o null si un elemento con el ID especificado no se encuentra en el documento.
-
-

Ejemplo

- -

HTML

- -
<html>
-<head>
-   <title>Ejemplo getElementById</title>
-</head>
-<body>
-   <p id="para">Cualquier texto acá</p>
-   <button onclick="changeColor('blue');">Azul</button>
-   <button onclick="changeColor('red');">Rojo</button>
-</body>
-</html>
-
- -

JavaScript

- -
function changeColor(newColor) {
-   var elem = document.getElementById('para');
-   elem.style.color = newColor;
-}
-
- -

Resultado

- -

{{EmbedLiveSample('Ejemplo', 250, 100)}}

-
-
- -

Notas

- -

Los usuarios nuevos deberían notar que escribir en mayúsculas 'Id' en el nombre de este método debe ser corregida para que el código sea válido - 'getElementByID' no funcionará a pesar de que parezca natural.

- -

A diferencia de otros métodos similares, getElementById sólo está disponible como un método del objeto global document, y no se encuentra disponible como un método en todos los objetos del DOM. Como los valores ID deben ser únicos a traves del documento, no existe necesidad para versiones "locales" de la función.

- -

Ejemplo

- -
<!doctype html>
-<html>
-<head>
-    <meta charset="UTF-8">
-    <title>Documento</title>
-</head>
-<body>
-    <div id="parent-id">
-        <p>Hola Mundo 1</p>
-        <p id="test1">Hola Mundo 2</p>
-        <p>Hola palabra 3</p>
-        <p>Hola palabra 4</p>
-    </div>
-    <script>
-        var parentDOM = document.getElementById('parent-id');
-        var test1=parentDOM.getElementById('test1');
-        //lanza error
-        //Uncaught TypeError: parentDOM.getElementById is not a function
-    </script>
-</body>
-</html>
- -

Si no existe un elemento con la id solicitada, esta función devuelve null. Note que el parámetro id es sensible a mayúsculas, así que document.getElementById("Main") devolverá null dentro del elemento <div id="main"> porque "M" y "m" son diferentes para los propósitos de este método.

- -

Elementos que no se encuentren en el documento no serán buscados por getElementById(). Cuando se cree un elemento y se le asigne un ID, debe insertar el elemento dentro del árbol del documento con {{domxref("Node.insertBefore()")}} u otro método similar antes de que se pueda acceder a el con getElementById():

- -
-
var element = document.createElement("div");
-element.id = 'testqq';
-var el = document.getElementById('testqq'); // el será null!
-
- -

Documentos no-HTML. La implementación de DOM debe tener información que diga que atributos son del tipo ID. Los atributos con el nombre "id" son son del tipo ID a menos que se los defina en el DTD del documento. El atributo id es definido para ser del tipo ID en los casos comunes de XHTML, XUL, y otros. Las implementaciones que no sepan si los atributos son o no del tipo ID se espera que retornen null.

- -

Especificación

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
EspecificaciónStatusComentarios
{{SpecName('DOM1','level-one-html.html#method-getElementById','getElementById')}}{{Spec2('DOM1')}}Definición inicial para la interfase
{{SpecName('DOM2 Core','core.html#ID-getElBId','getElementById')}}{{Spec2('DOM2 Core')}}Supersede DOM 1
{{SpecName('DOM3 Core','core.html#ID-getElBId','getElementById')}}{{Spec2('DOM3 Core')}}Supersede DOM 2
{{SpecName('DOM WHATWG','#interface-nonelementparentnode','getElementById')}}{{Spec2('DOM WHATWG')}}Intend to supersede DOM 3
- -

Compatibilidad con navegadores

- -{{Compat("api.Document.getElementById")}} - -

Ver también

- -
    -
  • La referencia document para otros métodos y propiedades que se pueden usar para obtener referencias a elementos en el documento.
  • -
  • document.querySelector() para selectores via consultas como 'div.myclass'
  • -
  • xml:id - tiene un método utilitario para permitir que getElementById() obtenga 'xml:id' en documentos XML documents (como los retornados por llamadas Ajax.
  • -
-
diff --git a/files/es/web/api/document/getelementbyid/index.md b/files/es/web/api/document/getelementbyid/index.md new file mode 100644 index 00000000000000..bdacd0b824bcc4 --- /dev/null +++ b/files/es/web/api/document/getelementbyid/index.md @@ -0,0 +1,121 @@ +--- +title: document.getElementById +slug: Web/API/Document/getElementById +tags: + - API + - DOM + - Documento + - Elementos + - Referencia + - Web + - id + - metodo +translation_of: Web/API/Document/getElementById +--- +{{ ApiRef("DOM") }} + +Devuelve una referencia al elemento por su [ID](/es/docs/DOM/element.id "en-US/docs/DOM/element.id"). + +## Sintaxis + +```js +elemento = document.getElementById(id); +``` + +### Parámetros + +- **`id`** + - : Es una cadena sensible a mayúsculas referida al ID único del elemento buscado. + +### Valor Retornado + +- **`element`** + - : Es una referencia a un objeto {{domxref("Element")}}, o `null` si un elemento con el ID especificado no se encuentra en el documento. + +## Ejemplo + +### HTML + +```html + + + Ejemplo getElementById + + +

Cualquier texto acá

+ + + + +``` + +### JavaScript + +```js +function changeColor(newColor) { + var elem = document.getElementById('para'); + elem.style.color = newColor; +} +``` + +### Resultado + +{{EmbedLiveSample('Ejemplo', 250, 100)}} + +## Notas + +Los usuarios nuevos deberían notar que escribir en mayúsculas 'Id' en el nombre de este método _debe ser corregida_ para que el código sea válido - 'getElementByID' no funcionará a pesar de que parezca natural. + +A diferencia de otros métodos similares, getElementById sólo está disponible como un método del objeto global document, y no se encuentra disponible como un método en todos los objetos del DOM. Como los valores ID deben ser únicos a traves del documento, no existe necesidad para versiones "locales" de la función. + +## Ejemplo + +```html + + + + + Documento + + +
+

Hola Mundo 1

+

Hola Mundo 2

+

Hola palabra 3

+

Hola palabra 4

+
+ + + +``` + +Si no existe un elemento con la `id` solicitada, esta función devuelve `null`. Note que el parámetro `id` es sensible a mayúsculas, así que `document.getElementById("Main")` devolverá `null` dentro del elemento `
` porque "M" y "m" son diferentes para los propósitos de este método. + +**Elementos que no se encuentren** en el documento no serán buscados por `getElementById()`. Cuando se cree un elemento y se le asigne un ID, debe insertar el elemento dentro del árbol del documento con {{domxref("Node.insertBefore()")}} u otro método similar antes de que se pueda acceder a el con `getElementById()`: + +```js +var element = document.createElement("div"); +element.id = 'testqq'; +var el = document.getElementById('testqq'); // el será null! +``` + +**Documentos no-HTML**. La implementación de DOM debe tener información que diga que atributos son del tipo ID. Los atributos con el nombre "id" son son del tipo ID a menos que se los defina en el DTD del documento. El atributo `id` es definido para ser del tipo ID en los casos comunes de [XHTML](/es/docs/XHTML), [XUL](/es/docs/Mozilla/Tech/XUL), y otros. Las implementaciones que no sepan si los atributos son o no del tipo ID se espera que retornen null. + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + +## Ver también + +- La referencia [document](/es/docs/DOM/document "en-US/docs/DOM/document") para otros métodos y propiedades que se pueden usar para obtener referencias a elementos en el documento. +- [document.querySelector()](/es/docs/Web/API/document.querySelector) para selectores via consultas como `'div.myclass'` +- [xml:id](/es/docs/xml/xml:id "en-US/docs/xml/id") - tiene un método utilitario para permitir que `getElementById()` obtenga 'xml:id' en documentos XML documents (como los retornados por llamadas Ajax. diff --git a/files/es/web/api/document/getelementsbyclassname/index.html b/files/es/web/api/document/getelementsbyclassname/index.html deleted file mode 100644 index 541d21eb42980c..00000000000000 --- a/files/es/web/api/document/getelementsbyclassname/index.html +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Document.getElementsByClassName() -slug: Web/API/Document/getElementsByClassName -translation_of: Web/API/Document/getElementsByClassName ---- -

{{APIRef("DOM")}}

- -

Retorna un objecto similar a un array de los elementos hijos que tengan todos los nombres de clase indicados. Cuando es llamado sobre el objeto document , la busqueda se realiza en todo el document, incluido el nodo raíz. También puedes llamar {{domxref("Element.getElementsByClassName", "getElementsByClassName()")}} sobre cualquier elemento; en ese caso retornara sólo los elementos hijos del elemento raíz indicado que contengan los nombres de clase indicados.

- -

Sintaxis

- -
var elementos = document.getElementsByClassName(nombres); // ó :
-var elementos = elementoRaiz.getElementsByClassName(nombres);
- -
    -
  • elementos es una {{ domxref("HTMLCollection") }} de los elementos encontrados.
  • -
  • nombres es un string que representa la lista de nombres de clase a buscar; los nombres de clase se separan con un espacio.
  • -
  • getElementsByClassName se puede llamar sobre cualquier elemento, no solo sobre document. El elemento sobre el que se llama será usado como la raíz de la busqueda.
  • -
- -

Ejemplos

- -

Obtener todos los elementos de la clase 'prueba'

- -
document.getElementsByClassName('prueba');
- -

Obtener todos los elementos que tengan al mismo tiempo las clases 'rojo' y 'prueba'

- -
document.getElementsByClassName('rojo prueba');
- -

Obtener todos los elementos que tengan la clase 'prueba' y que estén dentro de un elemento de ID 'principal'

- -
document.getElementById('principal').getElementsByClassName('prueba');
- -

También podemos usar los metodos de Array.prototype en cualquier {{ domxref("HTMLCollection") }} pasando el HTMLCollection como el valor this del método. Aquí buscaremos todos los elementos div de la clase 'test':

- -
var testElements = document.getElementsByClassName('test');
-var testDivs = Array.prototype.filter.call(testElements, function(testElement){
-    return testElement.nodeName === 'DIV';
-});
- -

Compatibilidad con navegadores

- -{{Compat("api.Document.getElementsByClassName")}} - -

Especifiación

- - diff --git a/files/es/web/api/document/getelementsbyclassname/index.md b/files/es/web/api/document/getelementsbyclassname/index.md new file mode 100644 index 00000000000000..590b4239b025d8 --- /dev/null +++ b/files/es/web/api/document/getelementsbyclassname/index.md @@ -0,0 +1,56 @@ +--- +title: Document.getElementsByClassName() +slug: Web/API/Document/getElementsByClassName +translation_of: Web/API/Document/getElementsByClassName +--- +{{APIRef("DOM")}} + +Retorna un objecto similar a un array de los elementos hijos que tengan todos los nombres de clase indicados. Cuando es llamado sobre el objeto document , la busqueda se realiza en todo el document, incluido el nodo raíz. También puedes llamar {{domxref("Element.getElementsByClassName", "getElementsByClassName()")}} sobre cualquier elemento; en ese caso retornara sólo los elementos hijos del elemento raíz indicado que contengan los nombres de clase indicados. + +## Sintaxis + +```js +var elementos = document.getElementsByClassName(nombres); // ó : +var elementos = elementoRaiz.getElementsByClassName(nombres); +``` + +- _elementos es una_ {{ domxref("HTMLCollection") }} de los elementos encontrados. +- _nombres es un string que representa la lista de nombres de clase a buscar; los nombres de clase se separan con un espacio._ +- getElementsByClassName se puede llamar sobre cualquier elemento, no solo sobre document. El elemento sobre el que se llama será usado como la raíz de la busqueda. + +## Ejemplos + +Obtener todos los elementos de la clase 'prueba' + +```js +document.getElementsByClassName('prueba'); +``` + +Obtener todos los elementos que tengan al mismo tiempo las clases 'rojo' y 'prueba' + +```js +document.getElementsByClassName('rojo prueba'); +``` + +Obtener todos los elementos que tengan la clase 'prueba' y que estén dentro de un elemento de ID 'principal' + +```js +document.getElementById('principal').getElementsByClassName('prueba'); +``` + +También podemos usar los metodos de Array.prototype en cualquier {{ domxref("HTMLCollection") }} pasando el _HTMLCollection_ como el valor _this_ del método. Aquí buscaremos todos los elementos div de la clase 'test': + +```js +var testElements = document.getElementsByClassName('test'); +var testDivs = Array.prototype.filter.call(testElements, function(testElement){ + return testElement.nodeName === 'DIV'; +}); +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/getelementsbyname/index.html b/files/es/web/api/document/getelementsbyname/index.html deleted file mode 100644 index 68503568add801..00000000000000 --- a/files/es/web/api/document/getelementsbyname/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Document.getElementsByName() -slug: Web/API/Document/getElementsByName -translation_of: Web/API/Document/getElementsByName ---- -
{{APIRef("DOM")}}
- -

Returns a nodelist collection with a given {{domxref("element.name","name")}} in the (X)HTML document.

- -

Sintaxis

- -
elements = document.getElementsByName(name)
-
- -
    -
  • elements es una colección existente de {{domxref("NodeList")}}
  • -
  • name es el valor del atributo name del elemento.
  • -
- -

Ejemplo

- -
<!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 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 name, tanto {{htmlelement("meta")}} o {{htmlelement("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

- - - -

Especificaciones

- - - - - - - - - - - - - - - - - - - -
EspecificacionesestadoComentario
{{SpecName('HTML WHATWG', '#dom-document-getelementsbyname', "Document.getElementsByName()")}}{{ Spec2('HTML WHATWG') }}
{{SpecName("DOM2 HTML", "html.html#ID-71555259", "Document.getElementsByName()")}}{{Spec2("DOM2 HTML")}}Initial definition
- -

Mira también

- -
    -
  • {{domxref("document.getElementById()")}} para retornar una referencia de un elemento por su id
  • -
  • {{domxref("document.getElementsByTagName()")}} para retornar referencias de elementos por el nombre de sus etiquetas
  • -
  • {{domxref("document.querySelector()")}} for powerful selectors via queries like 'div.myclass'
  • -
diff --git a/files/es/web/api/document/getelementsbyname/index.md b/files/es/web/api/document/getelementsbyname/index.md new file mode 100644 index 00000000000000..11f0bd2b7d157b --- /dev/null +++ b/files/es/web/api/document/getelementsbyname/index.md @@ -0,0 +1,58 @@ +--- +title: Document.getElementsByName() +slug: Web/API/Document/getElementsByName +translation_of: Web/API/Document/getElementsByName +--- +{{APIRef("DOM")}} + +Returns a nodelist collection with a given {{domxref("element.name","name")}} in the (X)HTML document. + +## Sintaxis + +```js +elements = document.getElementsByName(name) +``` + +- `elements` es una colección existente de {{domxref("NodeList")}} +- `name` es el valor del atributo `name` del elemento. + +## Ejemplo + +```html + + + + ... + + + +
+
+ + + + +``` + +## Notas + +El atributo [`name`](/es/docs/DOM/element.name) 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 `name`, tanto {{htmlelement("meta")}} o {{htmlelement("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 + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + +## Mira también + +- {{domxref("document.getElementById()")}} para retornar una referencia de un elemento por su `id` +- {{domxref("document.getElementsByTagName()")}} para retornar referencias de elementos por el nombre de sus etiquetas +- {{domxref("document.querySelector()")}} for powerful selectors via queries like `'div.myclass'` diff --git a/files/es/web/api/document/getelementsbytagname/index.html b/files/es/web/api/document/getelementsbytagname/index.html deleted file mode 100644 index 7be48858c0cde2..00000000000000 --- a/files/es/web/api/document/getelementsbytagname/index.html +++ /dev/null @@ -1,104 +0,0 @@ ---- -title: document.getElementsByTagName -slug: Web/API/Document/getElementsByTagName -tags: - - Referencia_DOM_de_Gecko -translation_of: Web/API/Document/getElementsByTagName ---- -

{{ ApiRef("DOM") }}

- -

Resumen

- -

Devuelve una lista de elementos con un nombre determinado. Se busca en todo el documento, incluyendo el nodo raíz.

- -

Sintaxis

- -
elements = document.getElementsByTagName(name)
-
- -
    -
  • elements es una lista 'viva' (NodeList) de los elementos encontrados en el orden en que han aparecido en el árbol.
  • -
  • name es una cadena que representa el nombre de los elementos. La cadena especial "*" representa a todos los elementos.
  • -
- -

Ejemplo

- -

En el siguiente ejemplo, getElementsByTagName empieza por el elemento padre y busca hacia abajo recurrentemente a lo largo de todo el DOM por ese elemento padre, buscando por hijos que cumplan con el criterio: nombre = name.

- -

Ten en cuenta que cuando el nodo en el que se invoca getElementsByTagName, no es el nodo document, en realidad se está usando el método element.getElementsByTagName.

- -
<html>
-
-<head>
-<title>ejemplo de getElementsByTagName</title>
-
-<script type="text/javascript">
-
-function getAllParaElems()
-{
-  var allParas = document.getElementsByTagName("p");
-
-  var num = allParas.length;
-
-  alert("Hay " + num + " <p> elementos en este documento");
-}
-
-
-function div1ParaElems()
-{
-  var div1 = document.getElementById("div1")
-  var div1Paras = div1.getElementsByTagName("p");
-
-  var num = div1Paras.length;
-
-  alert("Hay " + num + " <p> elementos en el elemento div1");
-}
-
-
-function div2ParaElems()
-{
-  var div2 = document.getElementById("div2")
-  var div2Paras = div2.getElementsByTagName("p");
-
-  var num = div2Paras.length;
-
-  alert("Hay " + num + " <p> elementos en el elemento div2");
-}
-
-</script>
-</head>
-
-<body style="border: solid green 3px">
-<p>Algo de texto</p>
-<p>Algo de texto</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</p>
-<p>Algo de texto</p>
-
-<button onclick="getAllParaElems();">
- muestra todos los elementos p en el documento</button><br />
-
-<button onclick="div1ParaElems();">
- muestra todos los elementos p en div1</button><br />
-
-<button onclick="div2ParaElems();">
- muestra todos los elementos p en div2</button>
-
-</body>
-</html>
-
- -

Especificación

- -

DOM Level 2 Core: Document.getElementsByTagName

diff --git a/files/es/web/api/document/getelementsbytagname/index.md b/files/es/web/api/document/getelementsbytagname/index.md new file mode 100644 index 00000000000000..1fad566a88c1f5 --- /dev/null +++ b/files/es/web/api/document/getelementsbytagname/index.md @@ -0,0 +1,108 @@ +--- +title: document.getElementsByTagName +slug: Web/API/Document/getElementsByTagName +tags: + - Referencia_DOM_de_Gecko +translation_of: Web/API/Document/getElementsByTagName +--- +{{ ApiRef("DOM") }} + +### Resumen + +Devuelve una lista de elementos con un nombre determinado. Se busca en todo el documento, incluyendo el nodo raíz. + +### Sintaxis + +```js +elements = document.getElementsByTagName(name) +``` + +- `elements` es una lista 'viva' (`NodeList`) de los elementos encontrados en el orden en que han aparecido en el árbol. +- `name` es una cadena que representa el nombre de los elementos. La cadena especial "\*" representa a todos los elementos. + +### Ejemplo + +En el siguiente ejemplo, `getElementsByTagName` empieza por el elemento padre y busca hacia abajo recurrentemente a lo largo de todo el DOM por ese elemento padre, buscando por hijos que cumplan con el criterio: nombre = `name`. + +Ten en cuenta que cuando el nodo en el que se invoca `getElementsByTagName`, no es el nodo `document`, en realidad se está usando el método [element.getElementsByTagName](es/DOM/element.getElementsByTagName). + +```html + + + +ejemplo de getElementsByTagName + + + + + +

Algo de texto

+

Algo de texto

+ +
+

Algo de texto en div1

+

Algo de texto en div1

+

Algo de texto en div1

+ +
+

Algo de texto en div2

+

Algo de texto en div2

+
+
+ +

Algo de texto

+

Algo de texto

+ +
+ +
+ + + + + +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/getelementsbytagnamens/index.html b/files/es/web/api/document/getelementsbytagnamens/index.html deleted file mode 100644 index d97657647be6c4..00000000000000 --- a/files/es/web/api/document/getelementsbytagnamens/index.html +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: document.getElementsByTagNameNS -slug: Web/API/Document/getElementsByTagNameNS -tags: - - Referencia_DOM_de_Gecko -translation_of: Web/API/Document/getElementsByTagNameNS ---- -

{{ ApiRef() }}

- -

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

- -
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 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>
-
- -

Especificación

- -

DOM Level 2 Core: Document.getElementsByTagNameNS

diff --git a/files/es/web/api/document/getelementsbytagnamens/index.md b/files/es/web/api/document/getelementsbytagnamens/index.md new file mode 100644 index 00000000000000..8e7cc50d72445c --- /dev/null +++ b/files/es/web/api/document/getelementsbytagnamens/index.md @@ -0,0 +1,111 @@ +--- +title: document.getElementsByTagNameNS +slug: Web/API/Document/getElementsByTagNameNS +tags: + - Referencia_DOM_de_Gecko +translation_of: Web/API/Document/getElementsByTagNameNS +--- +{{ ApiRef() }} + +### 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`](es/DOM/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`](es/DOM/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](es/DOM/element.getElementsByTagNameNS). + +Para usar el siguiente ejemplo, copia y pega en un documento con la extensión xhtml. + +```html + + + +ejemplo de getElementsByTagNameNS + + + + + +

Algo de texto exterior

+

Algo de texto exterior

+ +
+

Algo de texto en div1

+

Algo de texto en div1

+

Algo de texto en div1

+ +
+

Algo de texto en div2

+

Algo de texto en div2

+
+
+ +

Algo de texto exterior

+

Algo de texto exterior

+ +
+ +
+ + + + + +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/getselection/index.html b/files/es/web/api/document/getselection/index.html deleted file mode 100644 index 465c75bc53e725..00000000000000 --- a/files/es/web/api/document/getselection/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Document.getSelection() -slug: Web/API/Document/getSelection -tags: - - Referencia - - Selección - - metodo -translation_of: Web/API/DocumentOrShadowRoot/getSelection -translation_of_original: Web/API/Document/getSelection -original_slug: Web/API/DocumentOrShadowRoot/getSelection ---- -

{{APIRef("DOM")}}

- -

Este método funciona exactamente igual que {{domxref("Window.getSelection()")}}; devuelve un objeto {{domxref("Selection")}} que representa el texto que se ha seleccionado en el documento.

diff --git a/files/es/web/api/document/getselection/index.md b/files/es/web/api/document/getselection/index.md new file mode 100644 index 00000000000000..452c4562d76f82 --- /dev/null +++ b/files/es/web/api/document/getselection/index.md @@ -0,0 +1,22 @@ +--- +title: Document.getSelection() +slug: Web/API/Document/getSelection +tags: + - Referencia + - Selección + - metodo +translation_of: Web/API/DocumentOrShadowRoot/getSelection +translation_of_original: Web/API/Document/getSelection +original_slug: Web/API/DocumentOrShadowRoot/getSelection +--- +{{APIRef("DOM")}} + +Este método funciona exactamente igual que {{domxref("Window.getSelection()")}}; devuelve un objeto {{domxref("Selection")}} que representa el texto que se ha seleccionado en el documento. + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/hasfocus/index.html b/files/es/web/api/document/hasfocus/index.html deleted file mode 100644 index a3f4a7ce9e1cd9..00000000000000 --- a/files/es/web/api/document/hasfocus/index.html +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: element.hasFocus -slug: Web/API/Document/hasFocus -tags: - - Referencia_DOM_de_Gecko -translation_of: Web/API/Document/hasFocus ---- -

{{ ApiRef() }}

- -

Resumen

- -

El atributo hasFocus devuelve true si el foco está en en algún sitio del documento activo. Este atributo es parte de la especificación HTML 5 actualmente en desarrollo.

- -

Sintaxis

- -
focused = element.hasFocus
-
- -

Ejemplo

- -

Especificación

- -

Focus management

diff --git a/files/es/web/api/document/hasfocus/index.md b/files/es/web/api/document/hasfocus/index.md new file mode 100644 index 00000000000000..7c68c9f5be9bf4 --- /dev/null +++ b/files/es/web/api/document/hasfocus/index.md @@ -0,0 +1,26 @@ +--- +title: element.hasFocus +slug: Web/API/Document/hasFocus +tags: + - Referencia_DOM_de_Gecko +translation_of: Web/API/Document/hasFocus +--- +{{ ApiRef() }} + +### Resumen + +El atributo `hasFocus` devuelve `true` si el foco está en en algún sitio del documento activo. Este atributo es parte de la especificación HTML 5 actualmente en desarrollo. + +### Sintaxis + +```js +focused = element.hasFocus +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/head/index.html b/files/es/web/api/document/head/index.html deleted file mode 100644 index 2b72bbce272126..00000000000000 --- a/files/es/web/api/document/head/index.html +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Document.head -slug: Web/API/Document/head -translation_of: Web/API/Document/head ---- -

{{APIRef("DOM")}}

- -

Devuelve el elemento {{HTMLElement("head")}} del documento actual. Si hay más de un elemento <head>, devuelve el primero de estos.

- -

Sintaxis

- -
var objRef = document.head;
-
- -

Ejemplo

- -
// 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 un navegador Gecko, lanzará un TypeError.

- -

Compatibilidad con navegadores

- -{{Compat("api.Document.head")}} - -

Especificación

- - diff --git a/files/es/web/api/document/head/index.md b/files/es/web/api/document/head/index.md new file mode 100644 index 00000000000000..62708edfe43981 --- /dev/null +++ b/files/es/web/api/document/head/index.md @@ -0,0 +1,37 @@ +--- +title: Document.head +slug: Web/API/Document/head +translation_of: Web/API/Document/head +--- +{{APIRef("DOM")}} + +Devuelve el elemento {{HTMLElement("head")}} del documento actual. Si hay más de un elemento ``, devuelve el primero de estos. + +## Sintaxis + +```js +var objRef = document.head; +``` + +## Ejemplo + +```js +// en el HTML: +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](/es/docs/Web/JavaScript/Reference/Functions_and_function_scope/Strict_mode) en un navegador Gecko, lanzará un [`TypeError`](/es/docs/Web/JavaScript/Reference/Global_Objects/TypeError). + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/hidden/index.html b/files/es/web/api/document/hidden/index.html deleted file mode 100644 index b57337d2f3b3b7..00000000000000 --- a/files/es/web/api/document/hidden/index.html +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: Document.hidden -slug: Web/API/Document/hidden -translation_of: Web/API/Document/hidden ---- -

{{ ApiRef("DOM") }}

- -

El Document.hidden Es una propiedad solo de lectura, retorna un valor Booleano que indica si la pagina esta conciderada oculta o no.

- -

Sintaxis

- -
var boolean = document.hidden
- -

Ejemplo

- -
document.addEventListener("visibilitychange", function() {
-  console.log( document.hidden );
-  // Modify behavior...
-});
-
- -

Especificaciones

- - - - - - - - - - - - - - -
EspecificacionEstadoComentario
{{SpecName('Page Visibility API','#dom-document-hidden', 'Document.hidden')}}{{Spec2('Page Visibility API')}}definicion inicial
- -

Compatibilidad con Navegadores

- - - -

{{Compat("api.Document.hidden")}}

diff --git a/files/es/web/api/document/hidden/index.md b/files/es/web/api/document/hidden/index.md new file mode 100644 index 00000000000000..32100b47e20d82 --- /dev/null +++ b/files/es/web/api/document/hidden/index.md @@ -0,0 +1,31 @@ +--- +title: Document.hidden +slug: Web/API/Document/hidden +translation_of: Web/API/Document/hidden +--- +{{ ApiRef("DOM") }} + +El **`Document.hidden`** Es una propiedad solo de lectura, retorna un valor Booleano que indica si la pagina esta conciderada oculta o no. + +## Sintaxis + +```js +var boolean = document.hidden +``` + +## Ejemplo + +```js +document.addEventListener("visibilitychange", function() { + console.log( document.hidden ); + // Modify behavior... +}); +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/importnode/index.html b/files/es/web/api/document/importnode/index.html deleted file mode 100644 index 8b7ea431b74481..00000000000000 --- a/files/es/web/api/document/importnode/index.html +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: Document.importNode() -slug: Web/API/Document/importNode -translation_of: Web/API/Document/importNode ---- -

{{APIRef("DOM")}}

- -

Crea una copia de un nodo desde un documento externo para ser insertado en el documento actual.

- -

Sintaxis

- -
var node = document.importNode(externalNode, deep);
-
- -
-
node
-
El nuevo nodo importado al documento actual. El parentNode del nuevo nodo es null, ya que aun no ha sido insertado en el arbol del documento.
-
externalNode
-
El nodo externo a ser importado
-
deep
-
Un booleano que indica si los descendientes del nodo deben ser importados también.
-
- -
-

Nota: En la especificación DOM4 (tal y como se ha implementado en Gecko 13.0 {{geckoRelease(13)}}), deep es un argumento opcional. En el caso de ser omitido, adopta el valor de true, por lo que se hace una deep copy por defecto. Para realizar una copia superficial (shallow copy), deep debe ser false.

- -

Este comportamiento ha cambiado en la ultima especificación, por lo que si se omite el parámetro deep, éste adopta el valor false. Aunque aún es opcional, debería ser siempre provisto por razones de compatibilidad. Con Gecko 28.0 {{geckoRelease(28)}}, la consola advertia a los desarrolladores de no omitir el argumento. Empezando con Gecko 29.0 {{geckoRelease(29)}}), se realiza una copia superficial (shallow copy) por defecto.

-
- -

Ejemplo

- -
var iframe = document.getElementsByTagName("iframe")[0];
-var oldNode = iframe.contentWindow.document.getElementById("myNode");
-var newNode = document.importNode(oldNode, true);
-document.getElementById("container").appendChild(newNode);
-
- -

Notas

- -

El nodo original no se borra del documento. El nodo importado es un clon del original.

- -

- -

Nodes from external documents should be cloned using document.importNode() (or adopted using document.adoptNode()) before they can be inserted into the current document. For more on the Node.ownerDocument issues, see the W3C DOM FAQ.

- -

Firefox doesn't currently enforce this rule (it did for a while during the development of Firefox 3, but too many sites break when this rule is enforced). We encourage Web developers to fix their code to follow this rule for improved future compatibility.

- -

- -

Especificaciones

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName("DOM WHATWG", "#dom-document-importnode", "document.importNode()")}}{{Spec2("DOM WHATWG")}}
{{SpecName("DOM2 Core", "core.html#Core-Document-importNode", "document.importNode()")}}{{Spec2("DOM2 Core")}}Initial definition
- -

Compatibilidad navegadores

- -
- - -

{{Compat("api.Document.importNode")}}

-
- -

See also

- -
    -
  • {{domxref("document.adoptNode()")}}
  • -
diff --git a/files/es/web/api/document/importnode/index.md b/files/es/web/api/document/importnode/index.md new file mode 100644 index 00000000000000..676d5dee0dd2d4 --- /dev/null +++ b/files/es/web/api/document/importnode/index.md @@ -0,0 +1,54 @@ +--- +title: Document.importNode() +slug: Web/API/Document/importNode +translation_of: Web/API/Document/importNode +--- +{{APIRef("DOM")}} + +Crea una copia de un nodo desde un documento externo para ser insertado en el documento actual. + +## Sintaxis + +```js +var node = document.importNode(externalNode, deep); +``` + +- `node` + - : El nuevo nodo importado al documento actual. El [`parentNode`](/en-US/docs/DOM/Node.parentNode "DOM/Node.parentNode") del nuevo nodo es `null`, ya que aun no ha sido insertado en el arbol del documento. +- `externalNode` + - : El nodo externo a ser importado +- `deep` + - : Un booleano que indica si los descendientes del nodo deben ser importados también. + +> **Nota:** En la especificación DOM4 (tal y como se ha implementado en Gecko 13.0 {{geckoRelease(13)}}), `deep` es un argumento opcional. En el caso de ser omitido, adopta el valor de **`true`**, por lo que se hace una _deep copy_ por defecto. Para realizar una copia superficial (_shallow copy_), _deep_ debe ser **`false`**. +> +> Este comportamiento ha cambiado en la ultima especificación, por lo que si se omite el parámetro _deep,_ éste adopta el valor **`false`**. Aunque aún es opcional, debería ser siempre provisto por razones de compatibilidad. Con Gecko 28.0 {{geckoRelease(28)}}, la consola advertia a los desarrolladores de no omitir el argumento. Empezando con Gecko 29.0 {{geckoRelease(29)}}), se realiza una copia superficial (_shallow copy_) por defecto. + +## Ejemplo + +```js +var iframe = document.getElementsByTagName("iframe")[0]; +var oldNode = iframe.contentWindow.document.getElementById("myNode"); +var newNode = document.importNode(oldNode, true); +document.getElementById("container").appendChild(newNode); +``` + +## Notas + +El nodo original no se borra del documento. El nodo importado es un clon del original. + +Nodes from external documents should be cloned using [`document.importNode()`](/es/docs/Web/API/Document/importNode "Crea una copia de un nodo desde un documento externo para ser insertado en el documento actual.") (or adopted using [`document.adoptNode()`](/es/docs/Web/API/Document/adoptNode "Adopta un nodo extreno. El nodo y sub subnodos son quitados del documento en que se encuentra y su nuevo ownerDocument se cambia por el actual. El nodo puede entoces ser insertado en el documento actual.")) before they can be inserted into the current document. For more on the [`Node.ownerDocument`](/es/docs/Web/API/Node/ownerDocument "La propiedad de lectura Nodo.ownerDocument devuelve el objecto Document de más alto nivel/jerarquia para ese nodo.") issues, see the [W3C DOM FAQ](https://www.w3.org/DOM/faq.html#ownerdoc). + +Firefox doesn't currently enforce this rule (it did for a while during the development of Firefox 3, but too many sites break when this rule is enforced). We encourage Web developers to fix their code to follow this rule for improved future compatibility. + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + +## See also + +- {{domxref("document.adoptNode()")}} diff --git a/files/es/web/api/document/open/index.html b/files/es/web/api/document/open/index.html deleted file mode 100644 index 452cf58a890118..00000000000000 --- a/files/es/web/api/document/open/index.html +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Document.open() -slug: Web/API/Document/open -translation_of: Web/API/Document/open -original_slug: Web/API/Document/abrir ---- -
{{APIRef("DOM")}}
- -

El método Document.open() abre un documento para escritura (writing)

- -

Esto viene con algunos efectos secundarios. Por ejemplo:

- -
    -
  • Todos las atenciones de eventos actualmente registrados en el documento, los nodos dentro del documento o la ventana del documento son eliminados.
  • -
  • Todos los nodos existentes se eliminan del documento.
  • -
- -

Sintaxis

- -
document.open();
-
- -

Parametros

- -

Ninguno.

- -

Valor devuelto

- -

Una instancia del objeto Document (Document).

- -

Ejemplos

- -

El código simple a continuación abre el documento y reemplaza su contenido con un número de diferentes fragmentos HTML antes de cerrarlo nuevamente.

- -
document.open();
-document.write("<p>Hola mundo!</p>");
-document.write("<p>Soy un pez</p>");
-document.write("<p>El numero es 42</p>");
-document.close();
- -

Notas

- -
-

Traducción pendiente para el texto que sigue

-
- -

An automatic document.open() call happens when {{domxref("document.write()")}} is called after the page has loaded.

- -

For years Firefox and Internet Explorer additionally erased all JavaScript variables, etc., in addition to removing all nodes. This is no longer the case.document non-spec'ed parameters to document.open

- -

Gecko-specific notes

- -

Starting with Gecko 1.9, this method is subject to the same same-origin policy as other properties, and does not work if doing so would change the document's origin.

- -

Starting with Gecko 1.9.2, document.open() uses the principal of the document whose URI it uses, instead of fetching the principal off the stack. As a result, you can no longer call {{domxref("document.write()")}} into an untrusted document from chrome, even using wrappedJSObject. See Security check basics for more about principals.

- -

Three-argument document.open()

- -

There is a lesser-known and little-used three-argument version of document.open() , which is an alias of {{domxref("Window.open()")}} (see its page for full details).

- -

This call, for example opens github.com in a new window, with its opener set to null:

- -
document.open('https://www.github.com','', 'noopener=true')
- -

Two-argument document.open()

- -

Browsers used to support a two-argument document.open(), with the following signature:

- -
document.open(type, replace)
- -

Where type specified the MIME type of the data you are writing (e.g. text/html) and replace if set (i.e. a string of "replace") specified that the history entry for the new document would replace the current history entry of the document being written to.

- -

This form is now obsolete; it won't throw an error, but instead just forwards to document.open() (i.e. is the equivalent of just running it with no arguments). The history-replacement behavior now always happens.

- -

Specifications

- - - - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName("HTML WHATWG", "#dom-document-open", "document.open()")}}{{Spec2("HTML WHATWG")}}
{{SpecName("DOM2 HTML", "html.html#ID-72161170", "document.open()")}}{{Spec2("DOM2 HTML")}}
- -

Browser compatibility

- - - -

{{Compat("api.Document.open")}}

- -

See also

- -
    -
  • {{domxref("Document")}}
  • -
  • {{domxref("Window.open()")}}
  • -
diff --git a/files/es/web/api/document/open/index.md b/files/es/web/api/document/open/index.md new file mode 100644 index 00000000000000..d0a52daea2003c --- /dev/null +++ b/files/es/web/api/document/open/index.md @@ -0,0 +1,89 @@ +--- +title: Document.open() +slug: Web/API/Document/open +translation_of: Web/API/Document/open +original_slug: Web/API/Document/abrir +--- +{{APIRef("DOM")}} + +El método **`Document.open()`** abre un documento para escritura ([writing](/es/docs/Web/API/Document/write "en/DOM/document.write")) + +Esto viene con algunos efectos secundarios. Por ejemplo: + +- Todos las atenciones de eventos actualmente registrados en el documento, los nodos dentro del documento o la ventana del documento son eliminados. +- Todos los nodos existentes se eliminan del documento. + +## Sintaxis + +```js +document.open(); +``` + +### Parametros + +Ninguno. + +### Valor devuelto + +Una instancia del objeto Document (`Document)`. + +## Ejemplos + +El código simple a continuación abre el documento y reemplaza su contenido con un número de diferentes fragmentos HTML antes de cerrarlo nuevamente. + +```js +document.open(); +document.write("

Hola mundo!

"); +document.write("

Soy un pez

"); +document.write("

El numero es 42

"); +document.close(); +``` + +## Notas + +> **Nota:** Traducción pendiente para el texto que sigue + +An automatic `document.open()` call happens when {{domxref("document.write()")}} is called after the page has loaded. + +For years Firefox and Internet Explorer additionally erased all JavaScript variables, etc., in addition to removing all nodes. This is no longer the case.document non-spec'ed parameters to document.open + +### Gecko-specific notes + +Starting with Gecko 1.9, this method is subject to the same same-origin policy as other properties, and does not work if doing so would change the document's origin. + +Starting with Gecko 1.9.2, `document.open()` uses the [principal](/docs/Security_check_basics) of the document whose URI it uses, instead of fetching the principal off the stack. As a result, you can no longer call {{domxref("document.write()")}} into an untrusted document from chrome, even using [`wrappedJSObject`](/en/wrappedJSObject). See [Security check basics](/en/Security_check_basics "en/Security check basics") for more about principals. + +## Three-argument document.open() + +There is a lesser-known and little-used three-argument version of `document.open()` , which is an alias of {{domxref("Window.open()")}} (see its page for full details). + +This call, for example opens github.com in a new window, with its opener set to `null`: + +```js +document.open('https://www.github.com','', 'noopener=true') +``` + +## Two-argument document.open() + +Browsers used to support a two-argument `document.open()`, with the following signature: + +```js +document.open(type, replace) +``` + +Where `type` specified the MIME type of the data you are writing (e.g. `text/html`) and replace if set (i.e. a string of `"replace"`) specified that the history entry for the new document would replace the current history entry of the document being written to. + +This form is now obsolete; it won't throw an error, but instead just forwards to `document.open()` (i.e. is the equivalent of just running it with no arguments). The history-replacement behavior now always happens. + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + +## See also + +- {{domxref("Document")}} +- {{domxref("Window.open()")}} diff --git a/files/es/web/api/document/pointerlockelement/index.html b/files/es/web/api/document/pointerlockelement/index.html deleted file mode 100644 index b8f33cc545f136..00000000000000 --- a/files/es/web/api/document/pointerlockelement/index.html +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Document.pointerLockElement -slug: Web/API/Document/pointerLockElement -translation_of: Web/API/DocumentOrShadowRoot/pointerLockElement -original_slug: Web/API/DocumentOrShadowRoot/pointerLockElement ---- -
{{APIRef("DOM")}}
- -

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

- -
var elemento = document.pointerLockElement;
-
- -

Valor retornado

- -

Un {{domxref("Element")}} o null.

- -

Especificaciones

- - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName('Bloquear puntero','l#extension-to-the-document-interface','Document')}}{{Spec2('Pointer lock')}}Extiende de la interfaz Document
- -

Compatibilidad del Navegador

- -{{Compat("api.Document.pointerLockElement")}} - -

Véase también:

- -
    -
  • {{ domxref("Document.exitPointerLock()") }}
  • -
  • {{ domxref("Element.requestPointerLock()") }}
  • -
  • Pointer Lock
  • -
diff --git a/files/es/web/api/document/pointerlockelement/index.md b/files/es/web/api/document/pointerlockelement/index.md new file mode 100644 index 00000000000000..cf37672557a396 --- /dev/null +++ b/files/es/web/api/document/pointerlockelement/index.md @@ -0,0 +1,33 @@ +--- +title: Document.pointerLockElement +slug: Web/API/Document/pointerLockElement +translation_of: Web/API/DocumentOrShadowRoot/pointerLockElement +original_slug: Web/API/DocumentOrShadowRoot/pointerLockElement +--- +{{APIRef("DOM")}} + +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 {{domxref("Element")}} o `null`. + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + +## Véase también: + +- {{ domxref("Document.exitPointerLock()") }} +- {{ domxref("Element.requestPointerLock()") }} +- [Pointer Lock](/es/docs/WebAPI/Pointer_Lock) diff --git a/files/es/web/api/document/queryselector/index.html b/files/es/web/api/document/queryselector/index.html deleted file mode 100644 index 1ad54ba0915b75..00000000000000 --- a/files/es/web/api/document/queryselector/index.html +++ /dev/null @@ -1,136 +0,0 @@ ---- -title: Document.querySelector() -slug: Web/API/Document/querySelector -tags: - - API - - Consulta - - DOM - - Referencias(2) - - Referências - - Selectores - - metodo -translation_of: Web/API/Document/querySelector ---- -
{{ ApiRef("DOM") }}
- -
Devuelve el primer elemento del documento (utilizando un recorrido primero en profundidad pre ordenado de los nodos del documento) que coincida con el grupo especificado de selectores.
- -
- -

Sintaxis

- -
element = document.querySelector(selectores);
-
- -

Donde:

- -
    -
  • element es un objeto de tipo element.
  • -
  • selectores es una cadena de caracteres que contiene uno o más selectores CSS separados por coma.
  • -
- -

Ejemplo

- -

En este ejemplo, obtendremos el primer elemento del documento con la clase "miClase":

- -
var el = document.querySelector(".miClase");
-
- -

Ejemplo más útil

- -

Los Selectores pueden ser muy útiles como se demostrará en el siguiente ejemplo. Aquí, será retornado el primer elemento <input name="login" /> dentro de <div class="user-panel main">.

- -
var el = document.querySelector("div.user-panel.main input[name='login']");
- -

Notas

- -
    -
  • Devuelve null si no se encuentran coincidencias, de lo contrario, retorna el primer elemento encontrado.
  • -
  • Si el selector coincide con un ID y este ID es usado erróneamente varias veces en el documento, devuelve el primer elemento encontrado.
  • -
  • Lanza una excepción de tipo SYNTAX_ERR si el grupo de selectores especificado no es válido.
  • -
  • querySelector() se introdujo en la API Selectors.
  • -
  • La cadena de caracteres que se pasa como argumento a querySelector debe seguir la sintaxis CSS.
  • -
  • Las Pseudo-clases CSS nunca devolverán elementos, tal y como está especificado en la AP​I Selectors.
  • -
  • Para que coincidan ID's o selectores que no siguen la sintáxis CSS (usando inapropiadamente dos puntos o un espacio por ejemplo), se debe 'escapar' el carácter con una barra invertida (\). Como la barra invertida es un carácter de 'escape' en JavaScript, si estás indicando una cadena de caracteres literal, debes 'escaparla' dos veces (una para la cadena de caracteres JavaScript y otra para el querySelector):
  • -
- -
<div id="foo\bar"></div>
-<div id="foo:bar"></div>
-
-<script>
-  console.log('#foo\bar');               // "#fooar"
-  document.querySelector('#foo\bar');    // No coincide con nada
-
-  console.log('#foo\\bar');              // "#foo\bar"
-  console.log('#foo\\\\bar');            // "#foo\\bar"
-  document.querySelector('#foo\\\\bar'); // Coincide con el primer div
-
-  document.querySelector('#foo:bar');    // No coincide con nada
-  document.querySelector('#foo\\:bar');  // Coincide con el segundo div
-</script>
-
- -

Compatibilidad en los navegadores

- -
- - - - - - - - - - - - - - - - - - - -
PlataformaChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Soporte Basico13.5 (1.9.1)
- {{bug(416317)}}
8103.2 (525.3)
- {{Webkitbug("16587")}}
-
- -
- - - - - - - - - - - - - - - - - - - -
PlataformaAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Soporte Basico2.1Si910.03.2
-
- -

Especificaciones

- - - -

Vea también

- -
    -
  • {{domxref("document.querySelectorAll()")}}
  • -
  • {{domxref("element.querySelector()")}}
  • -
  • {{domxref("element.querySelectorAll()")}}
  • -
  • Snippets para querySelector
  • -
diff --git a/files/es/web/api/document/queryselector/index.md b/files/es/web/api/document/queryselector/index.md new file mode 100644 index 00000000000000..d33d106f9a087e --- /dev/null +++ b/files/es/web/api/document/queryselector/index.md @@ -0,0 +1,83 @@ +--- +title: Document.querySelector() +slug: Web/API/Document/querySelector +tags: + - API + - Consulta + - DOM + - Referencias(2) + - Referências + - Selectores + - metodo +translation_of: Web/API/Document/querySelector +--- +{{ ApiRef("DOM") }}Devuelve el primer elemento del documento (utilizando un [recorrido primero en profundidad pre ordenado](http://en.wikipedia.org/wiki/Tree_traversal#Pre-order_2) de los nodos del documento) que coincida con el grupo especificado de selectores. + +## Sintaxis + +```js +element = document.querySelector(selectores); +``` + +Donde: + +- `element` es un objeto de tipo [element](/es/docs/DOM/element "en-US/docs/DOM/element"). +- `selectores` es una cadena de caracteres que contiene uno o más [selectores CSS](/es/docs/Web/Guide/CSS/Getting_Started/Selectors) separados por coma. + +## Ejemplo + +En este ejemplo, obtendremos el primer elemento del documento con la clase "miClase": + +```js +var el = document.querySelector(".miClase"); +``` + +## Ejemplo más útil + +Los _Selectores_ pueden ser muy útiles como se demostrará en el siguiente ejemplo. Aquí, será retornado el primer elemento `` dentro de `
`. + +```js +var el = document.querySelector("div.user-panel.main input[name='login']"); +``` + +## Notas + +- Devuelve `null` si no se encuentran coincidencias, de lo contrario, retorna el primer elemento encontrado. +- Si el selector coincide con un ID y este ID es usado erróneamente varias veces en el documento, devuelve el primer elemento encontrado. +- Lanza una excepción de tipo SYNTAX_ERR si el grupo de selectores especificado no es válido. +- querySelector() se introdujo en la [API Selectors](https://www.w3.org/TR/selectors-api/). +- La cadena de caracteres que se pasa como argumento a `querySelector debe seguir la sintaxis CSS.` +- Las Pseudo-clases CSS nunca devolverán elementos, tal y como está especificado en la [`AP​I Selectors`](https://www.w3.org/TR/selectors-api/#grammar). +- Para que coincidan ID's o selectores que no siguen la sintáxis CSS (usando inapropiadamente dos puntos o un espacio por ejemplo), se debe 'escapar' el carácter con una barra invertida (\\). Como la barra invertida es un carácter de 'escape' en JavaScript, si estás indicando una cadena de caracteres literal, debes 'escaparla' dos veces (una para la cadena de caracteres JavaScript y otra para el querySelector): + +```html +
+
+ + +``` + +## Compatibilidad en los navegadores + +{{Compat}} + +## Especificaciones + +{{Specifications}} + +## Vea también + +- {{domxref("document.querySelectorAll()")}} +- {{domxref("element.querySelector()")}} +- {{domxref("element.querySelectorAll()")}} +- [Snippets para querySelector](/es/docs/Code_snippets/QuerySelector "en-US/docs/Code snippets/QuerySelector") diff --git a/files/es/web/api/document/queryselectorall/index.html b/files/es/web/api/document/queryselectorall/index.html deleted file mode 100644 index a0e4ca0b3cfc71..00000000000000 --- a/files/es/web/api/document/queryselectorall/index.html +++ /dev/null @@ -1,179 +0,0 @@ ---- -title: Document.querySelectorAll() -slug: Web/API/Document/querySelectorAll -tags: - - API - - Buscando Elementos - - DOM - - Document - - Encontrando Elementos - - Localizando Elementos - - Métodos - - Referencia - - Seleccionando Elementos - - Selectores - - Selectores CSS - - querySelectorAll -translation_of: Web/API/Document/querySelectorAll ---- -
{{ ApiRef("DOM") }}
- -

El método querySelectorAll() de un {{domxref("Element")}} devuelve una {{domxref("NodeList")}} estática (no viva) que representa una lista de elementos del documento que coinciden con el grupo de selectores indicados.

- -
-

Nota: Esto método se implementa en base al método {{domxref("ParentNode.querySelectorAll", "querySelectorAll()")}} del mixin {{domxref("ParentNode")}}.

-
- -

Sintaxis

- -
elementList = parentNode.querySelectorAll(selectors);
-
- -

Parámetros

- -
-
selectors
-
Un {{domxref("DOMString")}} que contiene uno o más selectores para buscar coincidencias. Esta cadena de texto debe ser una cadena CSS selector válida; si no lo es, se lanzará una excepción SyntaxError. Vea Locating DOM elements using selectors para más información acerca de utilizar selectores para identificar elementos. Se pueden especificar varios selectores separándolos utilizando comas.
-
- -
-

Nota: Los caracteres que no son parte de la sintaxis estándar de CSS deben ser escapados utilizando el caracter de barra invertida. Dado que JavaScript también utiliza el escapado por retroceso, se debe tener especial cuidado al escribir cadenas de texto literales utilizando estos caracteres. Vea Escapando caracteres especiales para más información.

-
- -

Valor devuelto

- -

Una {{domxref("NodeList")}} no viva que contenga un objeto {{domxref("Element")}} para cada elemento que coincida con al menos uno de los selectores especificados o una {{domxref("NodeList")}} vacía en caso de que no haya coincidencias.

- -
-

Nota: Si los selectores indicados incluyen un pseudo-elemento CSS, la lista devuelta siempre estará vacía.

-
- -

Excepciones

- -
-
SyntaxError
-
La sintaxis de la cadena de texto selectors no es válida.
-
- -

Ejemplos

- -

Obteniendo una lista de coincidencias

- -

Para obtener una {{domxref("NodeList")}} de todos los elementos {{HTMLElement("p")}} en el documento:

- -
var matches = document.querySelectorAll('p');
- -

Este ejemplo devuelve una lista de todos los elementos {{HTMLElement("div")}} del documento con una clase "nota" o "alerta":

- -
var matches = document.querySelectorAll('div.nota, div.alerta');
-
- -

Aquí, se obtiene una lista de elementos <p> cuyo elemento padre inmediato es un {{domxref("div")}} con la clase "highlighted" y que está ubicado dentro de un contenedor cuyo ID es "test".

- -
var container = document.querySelector('#test');
-var matches = container.querySelectorAll('div.highlighted > p');
- -

Este ejemplo usa un selector de atributos para devolver una lista de elementos {{domxref("iframe")}} en el documento que contienen un atributo llamado "data-src":

- -
var matches = document.querySelectorAll('iframe[data-src]');
- -

Aquí, un selector de atributo se utiliza para devolver una lista de los elementos de una lista cuyo ID es "userlist" que tiene un atributo "data-active" cuyo valor es "1":

- -
var container = document.querySelector('#userlist');
-var matches = container.querySelectorAll('li[data-active="1"]');
- -

Accediendo a las coincidencias

- -

Una vez que se devuelve la {{domxref("NodeList")}} de los elementos que coinciden, se puede examinar como cualquier array. Si el array está vacío (lo que significa que su propiedad length es 0), entonces es que no se encontraron coincidencias.

- -

En cualquier caso, se puede simplemente utilizar la notación estándar de los arrays para acceder al contenido de la lista. Se puede usar cualquier sentencia de iteración, como por ejemplo:

- -
var highlightedItems = userList.querySelectorAll('.highlighted');
-
-highlightedItems.forEach(function(userItem) {
-  deleteUser(userItem);
-});
- -

Notas de usuario

- -

querySelectorAll() se comporta de forma diferente que la mayoría de librerías DOM de JavaScript, que pueden llevar a resultados inesperados.

- -

HTML

- -

Considere este HTML, con sus tres bloques anidados {{HTMLElement("div")}}.

- -
<div class="outer">
-  <div class="select">
-    <div class="inner">
-    </div>
-  </div>
-</div>
- -

JavaScript

- -
var select = document.querySelector('.select');
-var inner = select.querySelectorAll('.outer .inner');
-inner.length; // 1, not 0!
-
- -

En este ejemplo, cuando se selecciona ".outer .inner" en el contexto el <div> con la clase "select", el elemento con la clase ".inner" todavía es encontrado, aun sabiendo que .outer no es descendiente del elemento base sobre el que se realiza la búsqueda (".select"). Por defecto, querySelectorAll() sólo verifica que el último elemento en el selector se encuentra dentro del rango de búsqueda.

- -

La pseudo-clase {{cssxref(":scope")}} recupera el comportamiento esperado, encontrando coincidencias sólo en selectores descendientes del elemento base:

- -
var select = document.querySelector('.select');
-var inner = select.querySelectorAll(':scope .outer .inner');
-inner.length; // 0
-
- -

Especificaciones

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName("DOM WHATWG", "#dom-parentnode-queryselectorall", "ParentNode.querySelectorAll()")}}{{Spec2("DOM WHATWG")}}Estándar vivo
{{SpecName("Selectors API Level 2", "#dom-parentnode-queryselectorall", "ParentNode.querySelectorAll()")}}{{Spec2("Selectors API Level 2")}}Sin cambios
{{SpecName("DOM4", "#dom-parentnode-queryselectorall", "ParentNode.querySelectorAll()")}}{{Spec2("DOM4")}}Definición inicial
{{SpecName("Selectors API Level 1", "#interface-definitions", "document.querySelector()")}}{{Spec2("Selectors API Level 1")}}Definición original
- -

Compatibilidad en navegadores

- -
- - -

{{Compat("api.Document.querySelectorAll")}}

-
- -

Ver también

- - diff --git a/files/es/web/api/document/queryselectorall/index.md b/files/es/web/api/document/queryselectorall/index.md new file mode 100644 index 00000000000000..af5b7021067e92 --- /dev/null +++ b/files/es/web/api/document/queryselectorall/index.md @@ -0,0 +1,151 @@ +--- +title: Document.querySelectorAll() +slug: Web/API/Document/querySelectorAll +tags: + - API + - Buscando Elementos + - DOM + - Document + - Encontrando Elementos + - Localizando Elementos + - Métodos + - Referencia + - Seleccionando Elementos + - Selectores + - Selectores CSS + - querySelectorAll +translation_of: Web/API/Document/querySelectorAll +--- +{{ ApiRef("DOM") }} + +El método **`querySelectorAll()`** de un {{domxref("Element")}} devuelve una {{domxref("NodeList")}} estática (no viva) que representa una lista de elementos del documento que coinciden con el grupo de selectores indicados. + +> **Nota:** Esto método se implementa en base al método {{domxref("ParentNode.querySelectorAll", "querySelectorAll()")}} del mixin {{domxref("ParentNode")}}. + +## Sintaxis + +```js +elementList = parentNode.querySelectorAll(selectors); +``` + +### Parámetros + +- `selectors` + - : Un {{domxref("DOMString")}} que contiene uno o más selectores para buscar coincidencias. Esta cadena de texto debe ser una cadena [CSS selector](/es/docs/Web/CSS/CSS_Selectors) válida; si no lo es, se lanzará una excepción `SyntaxError`. Vea [Locating DOM elements using selectors](/es/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors) para más información acerca de utilizar selectores para identificar elementos. Se pueden especificar varios selectores separándolos utilizando comas. + +> **Nota:** Los caracteres que no son parte de la sintaxis estándar de CSS deben ser escapados utilizando el caracter de barra invertida. Dado que JavaScript también utiliza el escapado por retroceso, se debe tener especial cuidado al escribir cadenas de texto literales utilizando estos caracteres. Vea [Escapando caracteres especiales](#escapando_caracteres_especiales) para más información. + +### Valor devuelto + +Una {{domxref("NodeList")}} _no viva_ que contenga un objeto {{domxref("Element")}} para cada elemento que coincida con al menos uno de los selectores especificados o una {{domxref("NodeList")}} vacía en caso de que no haya coincidencias. + +> **Nota:** Si los selectores indicados incluyen un [pseudo-elemento CSS](/es/docs/Web/CSS/Pseudo-elements), la lista devuelta siempre estará vacía. + +### Excepciones + +- `SyntaxError` + - : La sintaxis de la cadena de texto `selectors` no es válida. + +## Ejemplos + +### Obteniendo una lista de coincidencias + +Para obtener una {{domxref("NodeList")}} de todos los elementos {{HTMLElement("p")}} en el documento: + +```js +var matches = document.querySelectorAll('p'); +``` + +Este ejemplo devuelve una lista de todos los elementos {{HTMLElement("div")}} del documento con una clase "`nota`" o "`alerta`": + +```js +var matches = document.querySelectorAll('div.nota, div.alerta'); +``` + +Aquí, se obtiene una lista de elementos `

` cuyo elemento padre inmediato es un {{domxref("div")}} con la clase `"highlighted"` y que está ubicado dentro de un contenedor cuyo ID es `"test"`. + +```js +var container = document.querySelector('#test'); +var matches = container.querySelectorAll('div.highlighted > p'); +``` + +Este ejemplo usa un [selector de atributos](es/docs/Web/CSS/Selectores_atributo) para devolver una lista de elementos {{domxref("iframe")}} en el documento que contienen un atributo llamado `"data-src"`: + +```js +var matches = document.querySelectorAll('iframe[data-src]'); +``` + +Aquí, un selector de atributo se utiliza para devolver una lista de los elementos de una lista cuyo ID es `"userlist"` que tiene un atributo `"data-active"` cuyo valor es `"1"`: + +```js +var container = document.querySelector('#userlist'); +var matches = container.querySelectorAll('li[data-active="1"]'); +``` + +### Accediendo a las coincidencias + +Una vez que se devuelve la {{domxref("NodeList")}} de los elementos que coinciden, se puede examinar como cualquier `array`. Si el array está vacío (lo que significa que su propiedad `length` es 0), entonces es que no se encontraron coincidencias. + +En cualquier caso, se puede simplemente utilizar la notación estándar de los arrays para acceder al contenido de la lista. Se puede usar cualquier sentencia de iteración, como por ejemplo: + +```js +var highlightedItems = userList.querySelectorAll('.highlighted'); + +highlightedItems.forEach(function(userItem) { + deleteUser(userItem); +}); +``` + +## Notas de usuario + +`querySelectorAll()` se comporta de forma diferente que la mayoría de librerías DOM de JavaScript, que pueden llevar a resultados inesperados. + +### HTML + +Considere este HTML, con sus tres bloques anidados {{HTMLElement("div")}}. + +```html +

+
+
+
+
+
+``` + +### JavaScript + +```js +var select = document.querySelector('.select'); +var inner = select.querySelectorAll('.outer .inner'); +inner.length; // 1, not 0! +``` + +En este ejemplo, cuando se selecciona `".outer .inner"` en el contexto el `
` con la clase `"select"`, el elemento con la clase `".inner"` todavía es encontrado, aun sabiendo que `.outer` no es descendiente del elemento base sobre el que se realiza la búsqueda (`".select"`). Por defecto, `querySelectorAll()` sólo verifica que el último elemento en el selector se encuentra dentro del rango de búsqueda. + +La pseudo-clase {{cssxref(":scope")}} recupera el comportamiento esperado, encontrando coincidencias sólo en selectores descendientes del elemento base: + +```js +var select = document.querySelector('.select'); +var inner = select.querySelectorAll(':scope .outer .inner'); +inner.length; // 0 +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + +## Ver también + +- [Localizando elementos DOM utilizando selectores](/es/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors) +- [Selectores de atributo](/es/docs/Web/CSS/Selectores_atributo) +- [Selectores de atributo](/es/docs/Learn/CSS/Introduction_to_CSS/Selectores_de_Atributos) en el área de aprendizaje de MDN +- {{domxref("Element.querySelector()")}} y {{domxref("Element.querySelectorAll()")}} +- {{domxref("Document.querySelector()")}} +- {{domxref("DocumentFragment.querySelector()")}} y {{domxref("DocumentFragment.querySelectorAll()")}} +- {{domxref("ParentNode.querySelector()")}} y {{domxref("ParentNode.querySelectorAll()")}} +- [Snippets de código para `querySelector()`](/es/docs/Code_snippets/QuerySelector "Code_snippets/QuerySelector") diff --git a/files/es/web/api/document/readystate/index.html b/files/es/web/api/document/readystate/index.html deleted file mode 100644 index 0c0fa5cc2c4a4e..00000000000000 --- a/files/es/web/api/document/readystate/index.html +++ /dev/null @@ -1,104 +0,0 @@ ---- -title: Document.readyState -slug: Web/API/Document/readyState -translation_of: Web/API/Document/readyState ---- -
{{APIRef("DOM")}} {{ gecko_minversion_header("1.9.2") }}
- -

Resumen

- -

La propiedad Document.readyState de un {{ domxref("document") }} describe el estado de carga del documento.

- -

Valores

- -

El readyState de un documento puede tener uno de los siguientes valores:

- -
-
loading
-
El {{ domxref("document") }} todavía esta cargando.
-
interactive
-
El documento ha terminado de cargar y ha sido analizado pero los sub-recursos como imágenes, estilos y frames aún siguen cargando. El estado indica que el evento {{event("DOMContentLoaded")}} ha sido disparado.
-
complete
-
El documento y todos los sub-recursos han cargado completamente. El estado indica que el evento {{event("load")}} ha sido disparado.
-
- -

Cuando el valor de esta propiedad cambia, un evento {{event("readystatechange")}} se dispara en el objecto {{ domxref("document") }}.

- -

Sintaxis

- -
var string = document.readyState;
-
- -

Ejemplos

- -

Diferentes estados del readyState

- -
switch (document.readyState) {
-  case "loading":
-    // The document is still loading.
-    break;
-  case "interactive":
-    // The document has finished loading. We can now access the DOM elements.
-    var span = document.createElement("span");
-    span.textContent = "A <span> element.";
-    document.body.appendChild(span);
-    break;
-  case "complete":
-    // The page is fully loaded.
-    console.log("The first CSS rule is: " + document.styleSheets[0].cssRules[0].cssText);
-    break;
-}
-
- -

readystatechange como alternativa al evento DOMContentLoaded

- -
// alternative to DOMContentLoaded event
-document.onreadystatechange = function () {
-  if (document.readyState == "interactive") {
-    initApplication();
-  }
-}
- -

readystatechange como alternativa al evento load

- -
// alternative to load event
-document.onreadystatechange = function () {
-  if (document.readyState == "complete") {
-    initApplication();
-  }
-}
- -

Especificación

- - - - - - - - - - - - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName("HTML WHATWG", "#current-document-readiness", "Document readiness")}}{{Spec2('HTML WHATWG')}}
{{SpecName("HTML5.1", "#current-document-readiness", "Document readiness")}}{{Spec2('HTML5.1')}}
{{SpecName("HTML5 W3C", "#current-document-readiness", "Document readiness")}}{{Spec2('HTML5 W3C')}}Especificación inicial.
- -

Ver también

- -
    -
  • Evento {{event("readystatechange")}}
  • -
  • Evento {{event("DOMContentLoaded")}}
  • -
  • Evento {{event("load")}}
  • -
diff --git a/files/es/web/api/document/readystate/index.md b/files/es/web/api/document/readystate/index.md new file mode 100644 index 00000000000000..c310be799a4612 --- /dev/null +++ b/files/es/web/api/document/readystate/index.md @@ -0,0 +1,86 @@ +--- +title: Document.readyState +slug: Web/API/Document/readyState +translation_of: Web/API/Document/readyState +--- +{{APIRef("DOM")}} {{ gecko_minversion_header("1.9.2") }} + +## Resumen + +La propiedad **Document.readyState** de un {{ domxref("document") }} describe el estado de carga del documento. + +### Valores + +El readyState de un documento puede tener uno de los siguientes valores: + +- loading + - : El {{ domxref("document") }} todavía esta cargando. +- interactive + - : El documento ha terminado de cargar y ha sido analizado pero los sub-recursos como imágenes, estilos y frames aún siguen cargando. El estado indica que el evento {{event("DOMContentLoaded")}} ha sido disparado. +- complete + - : El documento y todos los sub-recursos han cargado completamente. El estado indica que el evento {{event("load")}} ha sido disparado. + +Cuando el valor de esta propiedad cambia, un evento {{event("readystatechange")}} se dispara en el objecto {{ domxref("document") }}. + +## Sintaxis + +```js +var string = document.readyState; +``` + +## Ejemplos + +### Diferentes estados del readyState + +```js +switch (document.readyState) { + case "loading": + // The document is still loading. + break; + case "interactive": + // The document has finished loading. We can now access the DOM elements. + var span = document.createElement("span"); + span.textContent = "A element."; + document.body.appendChild(span); + break; + case "complete": + // The page is fully loaded. + console.log("The first CSS rule is: " + document.styleSheets[0].cssRules[0].cssText); + break; +} +``` + +### readystatechange como alternativa al evento DOMContentLoaded + +```js +// alternative to DOMContentLoaded event +document.onreadystatechange = function () { + if (document.readyState == "interactive") { + initApplication(); + } +} +``` + +### readystatechange como alternativa al evento load + +```js +// alternative to load event +document.onreadystatechange = function () { + if (document.readyState == "complete") { + initApplication(); + } +} +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} +## Ver también + +- Evento {{event("readystatechange")}} +- Evento {{event("DOMContentLoaded")}} +- Evento {{event("load")}} diff --git a/files/es/web/api/document/registerelement/index.html b/files/es/web/api/document/registerelement/index.html deleted file mode 100644 index 9e74c264a49fd3..00000000000000 --- a/files/es/web/api/document/registerelement/index.html +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: Document.registerElement() -slug: Web/API/Document/registerElement -translation_of: Web/API/Document/registerElement ---- -

{{APIRef("DOM")}}{{Deprecated_header}}

- -

El Document.registerElement() registra un nuevo elemento personalizado en el navegador y devuelve un constructor para el nuevo elemento.

- -
-

Nota: Esta es una tecnología experimental. El navegador que utilice debe ser compatible con Web Components. Ver Web Components habilitados en Firefox.

-
- -

Sintaxis

- -
var constructor = document.registerElement(tag-name, options);
- -

Parámetros

- -
-
tag-name
-
El nombre del elemento personalizado. El nombre debe contener un guión (-), por ejemplo my-tag.
-
options {{optional_inline}}
-
Un objeto que da nombre al prototipo que sirve de base para el elemento personalizado, y una etiqueta existente para extender. Ambos son opcionales.
-
- -

Ejemplo

- -

Aquí hay un ejemplo muy simple:

- -
var Mytag = document.registerElement('my-tag');
-
- -

Ahora el nuevo tag se ha registrado en el navegador. La variable MyTag contiene un constructor que lo puedes usar para crear un elemento my-tag en el documento de la siguiente manera:

- -
document.body.appendChild(new Mytag());
- -

Esto inserta un elemento my-tag vacío que será visible si utiliza las herramientas de desarrollo del navegador. No será visible si usa la capacidad de ver el código fuente del navegador. Y no será visible en el navegador a menos que agregue algún contenido para la etiqueta. Esta es la manera de agregar contenido a la nueva etiqueta:

- -
var mytag = document.getElementsByTagName("my-tag")[0];
-mytag.textContent = "I am a my-tag element.";
-
- -

Especificaciones

- - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName('Custom Elements')}}{{Spec2('Custom Elements')}}Definición inicial
- -

Compatibilidad del navegador

- -{{Compat("api.Document.registerElement")}} - -

Ver también

- - diff --git a/files/es/web/api/document/registerelement/index.md b/files/es/web/api/document/registerelement/index.md new file mode 100644 index 00000000000000..f411144d2c81fe --- /dev/null +++ b/files/es/web/api/document/registerelement/index.md @@ -0,0 +1,56 @@ +--- +title: Document.registerElement() +slug: Web/API/Document/registerElement +translation_of: Web/API/Document/registerElement +--- +{{APIRef("DOM")}}{{Deprecated_header}} + +El **`Document.registerElement()`** registra un nuevo [elemento personalizado](/es/docs/Web/Web_Components/Custom_Elements) en el navegador y devuelve un constructor para el nuevo elemento. + +> **Nota:** Esta es una tecnología experimental. El navegador que utilice debe ser compatible con Web Components. Ver [Web Components habilitados en Firefox](/es/docs/Web/Web_Components#Enabling_Web_Components_in_Firefox). + +## Sintaxis + +```js +var constructor = document.registerElement(tag-name, options); +``` + +### Parámetros + +- _tag-name_ + - : El nombre del elemento personalizado. El nombre debe contener un guión (-), por ejemplo `my-tag`. +- _options {{optional_inline}}_ + - : Un objeto que da nombre al prototipo que sirve de base para el elemento personalizado, y una etiqueta existente para extender. Ambos son opcionales. + +## Ejemplo + +Aquí hay un ejemplo muy simple: + +```js +var Mytag = document.registerElement('my-tag'); +``` + +Ahora el nuevo tag se ha registrado en el navegador. La variable MyTag contiene un constructor que lo puedes usar para crear un elemento my-tag en el documento de la siguiente manera: + +```js +document.body.appendChild(new Mytag()); +``` + +Esto inserta un elemento my-tag vacío que será visible si utiliza las herramientas de desarrollo del navegador. No será visible si usa la capacidad de ver el código fuente del navegador. Y no será visible en el navegador a menos que agregue algún contenido para la etiqueta. Esta es la manera de agregar contenido a la nueva etiqueta: + +```js +var mytag = document.getElementsByTagName("my-tag")[0]; +mytag.textContent = "I am a my-tag element."; +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + +## Ver también + +- [Custom Elements](/es/docs/Web/Web_Components/Custom_Elements) diff --git a/files/es/web/api/document/scripts/index.html b/files/es/web/api/document/scripts/index.html deleted file mode 100644 index fd25bc40a98c22..00000000000000 --- a/files/es/web/api/document/scripts/index.html +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: Document.scripts -slug: Web/API/Document/scripts -translation_of: Web/API/Document/scripts ---- -
{{APIRef("DOM")}}
- -

Devuelve una lista de elementos {{HTMLElement("script")}} ubicados en el documento. El objeto devuelto es una colección {{domxref("HTMLCollection")}}.

- -

Sintáxis

- -
var scriptList = document.scripts;
-
- -

El objeto scriptList devuelto es una {{domxref("HTMLCollection")}}. Se puede utilizar como un array corriente para acceder a sus elementos.

- -

Ejemplo

- -

Este ejemplo busca demostrar la existencia de objetos {{HTMLElement("script")}} en el documento.

- -
var scripts = document.scripts;
-
-if (scripts.length) {
-  alert("This page has scripts!");
-}
-
- -

Compatibilidad de navegadores

- -{{Compat("api.Document.scripts")}} - -

- -

Especificaciones

- -
    -
  • {{spec("http://www.whatwg.org/specs/web-apps/current-work/multipage/dom.html#dom-document-scripts", "DOM: document scripts")}}
  • -
diff --git a/files/es/web/api/document/scripts/index.md b/files/es/web/api/document/scripts/index.md new file mode 100644 index 00000000000000..a7ca79b5345607 --- /dev/null +++ b/files/es/web/api/document/scripts/index.md @@ -0,0 +1,36 @@ +--- +title: Document.scripts +slug: Web/API/Document/scripts +translation_of: Web/API/Document/scripts +--- +{{APIRef("DOM")}} + +Devuelve una lista de elementos {{HTMLElement("script")}} ubicados en el documento. El objeto devuelto es una colección {{domxref("HTMLCollection")}}. + +## Sintáxis + +```js +var scriptList = document.scripts; +``` + +El objeto `scriptList` devuelto es una {{domxref("HTMLCollection")}}. Se puede utilizar como un array corriente para acceder a sus elementos. + +## Ejemplo + +Este ejemplo busca demostrar la existencia de objetos {{HTMLElement("script")}} en el documento. + +```js +var scripts = document.scripts; + +if (scripts.length) { + alert("This page has scripts!"); +} +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/scroll_event/index.html b/files/es/web/api/document/scroll_event/index.html deleted file mode 100644 index a5a590ec74febd..00000000000000 --- a/files/es/web/api/document/scroll_event/index.html +++ /dev/null @@ -1,104 +0,0 @@ ---- -title: scroll -slug: Web/API/Document/scroll_event -translation_of: Web/API/Document/scroll_event ---- -

El evento scroll se produce cuando la vista del documento o un elemento es deslizado.

- -

Información General

- -
-
Especificación
-
DOM L3, CSSOM View
-
Interfaz
-
UIEvent
-
Bubbles
-
No en elementos, pero burbujea a la vista default cuando se ejecuta en el documento
-
Cancelable
-
No
-
Objetivo
-
defaultView, Document, Element
-
Acción por defecto
-
Ninguna
-
-
- -

Propiedades

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PropertyTypeDescription
target {{readonlyInline}}EventTargetEl objetivo de evento (el objetivo superior en el árbol DOM).
type {{readonlyInline}}DOMStringEl tipo de evento.
bubbles {{readonlyInline}}BooleanSi el evento burbujea o no.
cancelable {{readonlyInline}}BooleanSi el evento puede ser cancelado o no.
view {{readonlyInline}}WindowProxydocument.defaultView (window de el documento)
detail {{readonlyInline}}long (float)0.
- -

Ejemplo

- -

Dado que los eventos scroll pueden ejecutarse a un ritmo elevado, el event handler no debería ejecutar operaciones computacionalmente costosas como modificaciones en el DOM. En cambio, se recomienda acelerar el evento utilizando requestAnimationFrame, setTimeout or customEvent, de este modo:

- -

Optimización de Scroll con window.requestAnimationFrame

- -
// Referencia: http://www.html5rocks.com/en/tutorials/speed/animations/
-
-var last_known_scroll_position = 0;
-var ticking = false;
-
-function doSomething(scroll_pos) {
-  // Hacer algo con la posición del scroll
-}
-
-window.addEventListener('scroll', function(e) {
-  last_known_scroll_position = window.scrollY;
-  if (!ticking) {
-    window.requestAnimationFrame(function() {
-      doSomething(last_known_scroll_position);
-      ticking = false;
-    });
-  }
-  ticking = true;
-});
- - - -

Más ejemplos se pueden ver en el evento resize.

- -

Compatibilidad en navegadores

- -

iOS UIWebView

- -

En iOS UIWebViews, los eventos scroll no se ejecutan mientras el escroleo/deslizamiento se lleva a cabo; solo son ejecutados cuando el deslizamiento terminó. Ver Bootstrap issue #16202. Safari y WKWebViews no se ven afectados por este bug.

diff --git a/files/es/web/api/document/scroll_event/index.md b/files/es/web/api/document/scroll_event/index.md new file mode 100644 index 00000000000000..650d8a8c505ac6 --- /dev/null +++ b/files/es/web/api/document/scroll_event/index.md @@ -0,0 +1,70 @@ +--- +title: scroll +slug: Web/API/Document/scroll_event +translation_of: Web/API/Document/scroll_event +--- +{{ ApiRef() }} + +El evento **`scroll`** se produce cuando la vista del documento o un elemento es deslizado. + +## Información General + +- Interfaz + - : UIEvent +- Bubbles + - : No en elementos, pero burbujea a la vista default cuando se ejecuta en el documento +- Cancelable + - : No +- Objetivo + - : defaultView, Document, Element +- Acción por defecto + - : Ninguna + +## Propiedades + +| Property | Type | Description | +| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `target` {{readonlyInline}} | [`EventTarget`](/es/docs/Web/API/EventTarget "EventTarget is an interface implemented by objects that can receive events and may have listeners for them.") | El objetivo de evento (el objetivo superior en el árbol DOM). | +| `type` {{readonlyInline}} | [`DOMString`](/es/docs/Web/API/DOMString "DOMString is a UTF-16 String. As JavaScript already uses such strings, DOMString is mapped directly to a String.") | El tipo de evento. | +| `bubbles` {{readonlyInline}} | [`Boolean`](/es/docs/Web/API/Boolean "The Boolean object is an object wrapper for a boolean value.") | Si el evento burbujea o no. | +| `cancelable` {{readonlyInline}} | [`Boolean`](/es/docs/Web/API/Boolean "The Boolean object is an object wrapper for a boolean value.") | Si el evento puede ser cancelado o no. | +| `view` {{readonlyInline}} | [`WindowProxy`](/es/docs/Web/API/WindowProxy "The documentation about this has not yet been written; please consider contributing!") | [`document.defaultView`](/es/docs/Web/API/Document/defaultView "In browsers, document.defaultView returns the window object associated with a document, or null if none is available.") (`window` de el documento) | +| `detail` {{readonlyInline}} | `long` (`float`) | 0. | + +## Ejemplo + +Dado que los eventos `scroll` pueden ejecutarse a un ritmo elevado, el _event handler_ no debería ejecutar operaciones computacionalmente costosas como modificaciones en el DOM. En cambio, se recomienda acelerar el evento utilizando [requestAnimationFrame](/es/docs/DOM/window.requestAnimationFrame), [setTimeout](/es/docs/Web/API/WindowTimers/setTimeout) or [customEvent](/es/docs/Web/API/CustomEvent), de este modo: + +#### Optimización de Scroll con window\.requestAnimationFrame + +```js +// Referencia: http://www.html5rocks.com/en/tutorials/speed/animations/ + +var last_known_scroll_position = 0; +var ticking = false; + +function doSomething(scroll_pos) { + // Hacer algo con la posición del scroll +} + +window.addEventListener('scroll', function(e) { + last_known_scroll_position = window.scrollY; + if (!ticking) { + window.requestAnimationFrame(function() { + doSomething(last_known_scroll_position); + ticking = false; + }); + } + ticking = true; +}); +``` + +Más ejemplos se pueden ver en el evento [resize](/es/docs/Web/Events/resize#Example). + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/stylesheets/index.html b/files/es/web/api/document/stylesheets/index.html deleted file mode 100644 index f17c721fda8f04..00000000000000 --- a/files/es/web/api/document/stylesheets/index.html +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Document.styleSheets -slug: Web/API/Document/styleSheets -translation_of: Web/API/DocumentOrShadowRoot/styleSheets -translation_of_original: Web/API/Document/styleSheets -original_slug: Web/API/DocumentOrShadowRoot/styleSheets ---- -

{{ ApiRef() }}

-

Resumen

-

Devuelve una lista de objetos de tipo stylesheet para las hojas de estilo que están específicamente enlazadas o contenidas en el documento.

-

Propiedades

-

styleSheetList.length - devuelve el número de objetos de tipo stylesheet contenidos en el objeto.

-

Sintaxis

-
styleSheetList = document.styleSheets
-
-

El objeto devuelto es del tipo StyleSheetList.

-

Es una colección ordenada de objetos de tipo stylesheet. styleSheetList.item(index) o simplemente styleSheetList{{ mediawiki.external(' - - index - ') }} devuelve un único objeto de tipo stylesheet con el índice especificado (el índice es de origen 0).

-

Especificación

-

DOM Level 2 Style: styleSheets

-

{{ languages( { "ja": "ja/DOM/document.styleSheets", "pl": "pl/DOM/document.styleSheets" } ) }}

diff --git a/files/es/web/api/document/stylesheets/index.md b/files/es/web/api/document/stylesheets/index.md new file mode 100644 index 00000000000000..f504b11609f332 --- /dev/null +++ b/files/es/web/api/document/stylesheets/index.md @@ -0,0 +1,37 @@ +--- +title: Document.styleSheets +slug: Web/API/Document/styleSheets +translation_of: Web/API/DocumentOrShadowRoot/styleSheets +translation_of_original: Web/API/Document/styleSheets +original_slug: Web/API/DocumentOrShadowRoot/styleSheets +--- +{{ ApiRef() }} + +### Resumen + +Devuelve una lista de objetos de tipo [stylesheet](/es/DOM/stylesheet "es/DOM/stylesheet") para las hojas de estilo que están específicamente enlazadas o contenidas en el documento. + +### Propiedades + +`styleSheetList.length` - devuelve el número de objetos de tipo stylesheet contenidos en el objeto. + +### Sintaxis + +```js +styleSheetList = document.styleSheets +``` + +El objeto devuelto es del tipo [StyleSheetList](https://www.w3.org/TR/DOM-Level-2-Style/stylesheets.html#StyleSheets-DocumentStyle-styleSheets). + +Es una colección ordenada de objetos de tipo [stylesheet](/es/DOM/stylesheet "es/DOM/stylesheet"). `styleSheetList.item(index)` o simplemente `styleSheetList{{ mediawiki.external(' + + index + ') }}` devuelve un único objeto de tipo stylesheet con el índice especificado (el índice es de origen 0). + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/url/index.html b/files/es/web/api/document/url/index.html deleted file mode 100644 index 3d125432ef0d48..00000000000000 --- a/files/es/web/api/document/url/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: document.URL -slug: Web/API/Document/URL -tags: - - API - - Documento - - HTML DOM - - Propiedad - - Referencia -translation_of: Web/API/Document/URL ---- -
{{APIRef("DOM")}}
- -

La propiedad de sólo lectura URL de la interfaz {{domxref("Document")}} devuelve la ubicación del documento como una cadena de texto.

- -

Sintaxis

- -
var string = document.URL
- -

Ejemplo

- -

JavaScript

- -
document.getElementById("url").textContent = document.URL;
- -

HTML

- -
<p id="urlText">
-  URL:<br/>
-  <span id="url">La URL va aquí</span>
-</p>
- -

Resultado

- -

{{EmbedLiveSample("Example", "100%", 100)}}

- -

Especificaciones

- - - - - - - - - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName("DOM WHATWG", "#dom-document-url", "Document.URL")}}{{Spec2("DOM WHATWG")}}Define que la propiedad es una {{domxref("USVString")}} en lugar de un {{domxref("DOMString")}}.
{{SpecName("DOM1", "level-one-html.html#attribute-URL", "Document.URL")}}{{Spec2("DOM1")}}Definición inicial
- -

Compatibilidad con navegadores

- -
-

{{Compat("api.Document.URL")}}

-
- -

Ver también

- -
    -
  • {{domxref("HTMLDocument")}}
  • -
diff --git a/files/es/web/api/document/url/index.md b/files/es/web/api/document/url/index.md new file mode 100644 index 00000000000000..7bb5ba89b3521e --- /dev/null +++ b/files/es/web/api/document/url/index.md @@ -0,0 +1,53 @@ +--- +title: document.URL +slug: Web/API/Document/URL +tags: + - API + - Documento + - HTML DOM + - Propiedad + - Referencia +translation_of: Web/API/Document/URL +--- +{{APIRef("DOM")}} + +La propiedad de sólo lectura **`URL`** de la interfaz {{domxref("Document")}} devuelve la ubicación del documento como una cadena de texto. + +## Sintaxis + +```js +var string = document.URL +``` + +## Ejemplo + +### JavaScript + +```js +document.getElementById("url").textContent = document.URL; +``` + +### HTML + +```html +

+ URL:
+ La URL va aquí +

+``` + +### Resultado + +{{EmbedLiveSample("Example", "100%", 100)}} + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + +## Ver también + +- {{domxref("HTMLDocument")}} diff --git a/files/es/web/api/document/write/index.html b/files/es/web/api/document/write/index.html deleted file mode 100644 index 1c88dff68f36d3..00000000000000 --- a/files/es/web/api/document/write/index.html +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: Document.write() -slug: Web/API/Document/write -tags: - - API - - DOM - - Documentación - - Referencia - - metodo -translation_of: Web/API/Document/write ---- -
{{ ApiRef("DOM") }}
- -


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

- -
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.
- -

Sintaxis

- -
document.write(texto);
-
- -

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

- -

Example

- -
<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(), automáticamente hará una llamada a document.open(). Después de haber finalizado la escritura del documento, es recomendable llamar a document.close(), 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:

- -
<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 application/xhtml+xml. Hay más información disponible en W3C XHTML FAQ.
- -
Nota: document.write en scripts de modo diferido o asyncrónico 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

- - - -

También puedes ver

- -
    -
  • {{ domxref("element.innerHTML") }}
  • -
  • {{ domxref("document.createElement()") }}
  • -
diff --git a/files/es/web/api/document/write/index.md b/files/es/web/api/document/write/index.md new file mode 100644 index 00000000000000..0420d589dff2c9 --- /dev/null +++ b/files/es/web/api/document/write/index.md @@ -0,0 +1,77 @@ +--- +title: Document.write() +slug: Web/API/Document/write +tags: + - API + - DOM + - Documentación + - Referencia + - metodo +translation_of: Web/API/Document/write +--- +{{ ApiRef("DOM") }} + +Escribe una cadena de texto dentro del hilo de un `document `abierto por [document.open()](/es/docs/Web/API/document.open). + +> **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](/es/docs/Web/API/document.open#Notes). + +## Sintaxis + +```js +document.write(texto); +``` + +`texto` es una cadena de texto que contiene el texto a ser impreso en el documento. + +### Example + +```html + + + + Ejemplo de write + + + + + +

Algo de contenido original del documento

+ + + +``` + +## Notas + +Escribir a un documento que ya tiene contenido cargado previamente sin llamar a [`document.open()`](/es/docs/Web/API/document.open), automáticamente hará una llamada a document.open(). Después de haber finalizado la escritura del documento, es recomendable llamar a [`document.close()`](/es/docs/Web/API/document.close), 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 ` +``` + +> **Nota:** `document.write` y `document.writeln` [no funcionan dentro de un documento XHTML](/es/docs/Archive/Web/Writing_JavaScript_for_HTML) (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 ](/es/docs/Glossary/MIME_type)`application/xhtml+xml`. Hay más información disponible en [W3C XHTML FAQ](https://www.w3.org/MarkUp/2004/xhtml-faq#docwrite). + +> **Nota:** `document.write` en scripts de modo [diferido](/es/docs/Web/HTML/Element/script#attr-defer) o [asyncrónico](/es/docs/Web/HTML/Element/script#attr-async) 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 + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} +## También puedes ver + +- {{ domxref("element.innerHTML") }} +- {{ domxref("document.createElement()") }} diff --git a/files/es/web/api/document/writeln/index.html b/files/es/web/api/document/writeln/index.html deleted file mode 100644 index be9910a516e928..00000000000000 --- a/files/es/web/api/document/writeln/index.html +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Document.writeln() -slug: Web/API/Document/writeln -translation_of: Web/API/Document/writeln ---- -

{{ ApiRef("DOM") }}

- -

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.

-
- -

Sintaxis

- -
document.writeln(línea);
-
- -

Parámetros

- -
    -
  • línea es la cadena conteniendo una línea de texto.
  • -
- -

Ejemplo

- -
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 application/xhtml+xml. Hay más información disponible en W3C XHTML FAQ.
- -
Nota: document.writeln y document.write en scripts de modo diferido o asyncrónico 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").
- -

Especificación

- -

writeln

diff --git a/files/es/web/api/document/writeln/index.md b/files/es/web/api/document/writeln/index.md new file mode 100644 index 00000000000000..6f0405616bc3fd --- /dev/null +++ b/files/es/web/api/document/writeln/index.md @@ -0,0 +1,42 @@ +--- +title: Document.writeln() +slug: Web/API/Document/writeln +translation_of: Web/API/Document/writeln +--- +{{ ApiRef("DOM") }} + +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](/es/docs/Web/API/document.open#Notes). + +## Sintaxis + +```js +document.writeln(línea); +``` + +### Parámetros + +- `línea` es la cadena conteniendo una línea de texto. + +## Ejemplo + +```js +document.writeln("

¡Hola mundo!

"); +``` + +## Notas + +**document.writeln** actúa igual que [document.write](/es/DOM/document.write "en/DOM/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](/es/docs/Archive/Web/Writing_JavaScript_for_HTML) (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 ](/es/docs/Glossary/MIME_type)`application/xhtml+xml`. Hay más información disponible en [W3C XHTML FAQ](https://www.w3.org/MarkUp/2004/xhtml-faq#docwrite). + +> **Nota:** `document.writeln` y `document.write` en scripts de modo [diferido](/es/docs/Web/HTML/Element/script#attr-defer) o [asyncrónico](/es/docs/Web/HTML/Element/script#attr-async) 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 + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}}