From 2b2c323c4b60f586ba46815dffb389ca4c83d2e6 Mon Sep 17 00:00:00 2001 From: Craig Blaszczyk Date: Tue, 20 Sep 2022 13:54:24 +0100 Subject: [PATCH 1/4] chore: improve markdown conversion * remove unneeded brush class * replace syntaxbox class with js * add missing classes to pre blocks * minor content edits * remove unused languages macro * add missing ApiRef() block --- .../es/web/api/document/adoptnode/index.html | 4 +- files/es/web/api/document/anchors/index.html | 6 +- files/es/web/api/document/applets/index.html | 2 - files/es/web/api/document/bgcolor/index.html | 2 - files/es/web/api/document/body/index.html | 2 - .../web/api/document/characterset/index.html | 2 - files/es/web/api/document/close/index.html | 2 +- files/es/web/api/document/cookie/index.html | 46 +++++++------- .../api/document/createattribute/index.html | 6 +- .../createdocumentfragment/index.html | 4 +- .../web/api/document/createelement/index.html | 19 +++--- .../api/document/createelementns/index.html | 14 +++-- .../web/api/document/createevent/index.html | 4 +- .../web/api/document/createrange/index.html | 2 - .../api/document/createtextnode/index.html | 6 +- .../web/api/document/defaultview/index.html | 2 +- .../es/web/api/document/designmode/index.html | 6 +- files/es/web/api/document/dir/index.html | 2 +- files/es/web/api/document/doctype/index.html | 6 +- .../web/api/document/documenturi/index.html | 4 +- files/es/web/api/document/embeds/index.html | 4 +- .../web/api/document/execcommand/index.html | 4 +- .../api/document/exitfullscreen/index.html | 6 +- .../api/document/getelementbyid/index.html | 16 +++-- .../getelementsbyclassname/index.html | 10 +-- .../api/document/getelementsbyname/index.html | 6 +- .../document/getelementsbytagname/index.html | 2 +- .../getelementsbytagnamens/index.html | 2 +- files/es/web/api/document/head/index.html | 4 +- files/es/web/api/document/hidden/index.html | 6 +- .../es/web/api/document/importnode/index.html | 6 +- files/es/web/api/document/open/index.html | 8 +-- .../document/pointerlockelement/index.html | 4 +- .../web/api/document/queryselector/index.html | 61 +++---------------- .../api/document/queryselectorall/index.html | 22 +++---- .../es/web/api/document/readystate/index.html | 10 +-- .../api/document/registerelement/index.html | 10 +-- files/es/web/api/document/scripts/index.html | 4 +- .../web/api/document/scroll_event/index.html | 30 ++++----- .../web/api/document/stylesheets/index.html | 1 - files/es/web/api/document/url/index.html | 8 +-- files/es/web/api/document/write/index.html | 6 +- files/es/web/api/document/writeln/index.html | 2 +- 43 files changed, 156 insertions(+), 217 deletions(-) diff --git a/files/es/web/api/document/adoptnode/index.html b/files/es/web/api/document/adoptnode/index.html index cba685afd92a97..736e92d22039a4 100644 --- a/files/es/web/api/document/adoptnode/index.html +++ b/files/es/web/api/document/adoptnode/index.html @@ -15,7 +15,7 @@

Sintaxis

-
node = document.adoptNode(externalNode);
+
node = document.adoptNode(externalNode);
 
@@ -27,7 +27,7 @@

Sintaxis

Ejemplo

-
var iframe = document.querySelector('iframe');
+
var iframe = document.querySelector('iframe');
 var iframeImages = iframe.contentDocument.querySelectorAll('img');
 var newParent = document.getElementById('images');
 
diff --git a/files/es/web/api/document/anchors/index.html b/files/es/web/api/document/anchors/index.html
index fbcd8eea0e5aac..6c77ce14aff332 100644
--- a/files/es/web/api/document/anchors/index.html
+++ b/files/es/web/api/document/anchors/index.html
@@ -16,7 +16,7 @@
 
 

Sintaxis

-
nodeList = document.anchors;
+
nodeList = document.anchors;
 

Valor

@@ -33,7 +33,7 @@

Ejemplo

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

-
<!DOCTYPE html>
+
<!DOCTYPE html>
 <html lang="en">
 <head>
 <meta charset="UTF-8" />
@@ -86,8 +86,6 @@ 

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

diff --git a/files/es/web/api/document/applets/index.html b/files/es/web/api/document/applets/index.html index e6ecf71b60c9d9..233d2a56f01e6f 100644 --- a/files/es/web/api/document/applets/index.html +++ b/files/es/web/api/document/applets/index.html @@ -26,5 +26,3 @@

Ejemplo

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/bgcolor/index.html b/files/es/web/api/document/bgcolor/index.html index 7baf9c893b3ba3..1975b42dbe0dff 100644 --- a/files/es/web/api/document/bgcolor/index.html +++ b/files/es/web/api/document/bgcolor/index.html @@ -35,5 +35,3 @@

Notas

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/body/index.html b/files/es/web/api/document/body/index.html index 724ee899b2d216..241a06830d892e 100644 --- a/files/es/web/api/document/body/index.html +++ b/files/es/web/api/document/body/index.html @@ -35,5 +35,3 @@

Notas

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/characterset/index.html b/files/es/web/api/document/characterset/index.html index 69a4ff144bc77d..ca52b03dd3ebd8 100644 --- a/files/es/web/api/document/characterset/index.html +++ b/files/es/web/api/document/characterset/index.html @@ -32,5 +32,3 @@

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/close/index.html b/files/es/web/api/document/close/index.html index 3f03083a258fb7..f67f062861a7d2 100644 --- a/files/es/web/api/document/close/index.html +++ b/files/es/web/api/document/close/index.html @@ -14,7 +14,7 @@

Sintaxis

Ejemplo

-
// Abrir un documento.
+
// Abrir un documento.
 // Escribir contenido en el documento.
 // Cerrar el documento.
 document.open();
diff --git a/files/es/web/api/document/cookie/index.html b/files/es/web/api/document/cookie/index.html
index ebbedf985bd685..ac0b31774694fa 100644
--- a/files/es/web/api/document/cookie/index.html
+++ b/files/es/web/api/document/cookie/index.html
@@ -16,63 +16,63 @@ 

Sintaxis

Leer todas las cookies accesibles desde una localización

-
todasLasCookies = document.cookie;
+
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;
+
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:

+

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. +
  • 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.
      +
    • ;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). Para más información sobre cómo utilizar rutas relativas, ir a este párrafo.
    • -
    • ;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. +
    • ;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 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() 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: +
  • El valor de la cookie puede ser evaluado mediante 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.
    • +
    • __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.
-
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.
+
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 = "nombre=oeschger";
 document.cookie = "comida_preferida=tripa";
 function alertCookie() {
   alert(document.cookie); // visualizar: nombre=oeschger;comida favorita=tripa
 
 }
-
<button onclick="alertCookie()">Mostrar cookies</button>
+
<button onclick="alertCookie()">Mostrar cookies</button>

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

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

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

@@ -90,14 +90,14 @@

Ejemplo #3: Hacer algo una sola vezDe 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() {
+
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>
+
<button onclick="dhacerUnaVez()">Solo hacer algo una vez</button>

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

diff --git a/files/es/web/api/document/createattribute/index.html b/files/es/web/api/document/createattribute/index.html index ec7c1713339f1b..ea2918662b5273 100644 --- a/files/es/web/api/document/createattribute/index.html +++ b/files/es/web/api/document/createattribute/index.html @@ -19,7 +19,7 @@

Sintaxis

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

Parametros

@@ -40,7 +40,7 @@

Excepciones

Ejemplo

-
var nodo = document.getElementById("div1");
+
var nodo = document.getElementById("div1");
 var a = document.createAttribute("miAtributo");
 a.value = "nuevoVal";
 nodo.setAttributeNode(a);
@@ -49,7 +49,7 @@ 

Ejemplo

Especificaciones

- +
diff --git a/files/es/web/api/document/createdocumentfragment/index.html b/files/es/web/api/document/createdocumentfragment/index.html index 4aaf091a78b673..61ab2e03c3dfdc 100644 --- a/files/es/web/api/document/createdocumentfragment/index.html +++ b/files/es/web/api/document/createdocumentfragment/index.html @@ -11,7 +11,7 @@

Sintaxis

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

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

@@ -24,7 +24,7 @@

Notas de uso

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

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

Ejemplo

diff --git a/files/es/web/api/document/createelement/index.html b/files/es/web/api/document/createelement/index.html index e3550aec56b3d1..352cab19a78cec 100644 --- a/files/es/web/api/document/createelement/index.html +++ b/files/es/web/api/document/createelement/index.html @@ -17,21 +17,20 @@

Sintaxis

-
var element = document.createElement(tagName, [options]);
+
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").

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

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

@@ -44,7 +43,7 @@

Ejemplo

HTML

-
<!DOCTYPE html>
+
<!DOCTYPE html>
 <html>
 <head>
   <title>||Trabajando con elementos||</title>
@@ -57,7 +56,7 @@ 

HTML

JavaScript

-
document.body.onload = addElement;
+
document.body.onload = addElement;
 
 function addElement () {
   // crea un nuevo div
@@ -75,7 +74,7 @@ 

JavaScript

Especificaciones

-
Especificación
+
diff --git a/files/es/web/api/document/createelementns/index.html b/files/es/web/api/document/createelementns/index.html index 96b40666abc28d..c19b81ec0fcdf5 100644 --- a/files/es/web/api/document/createelementns/index.html +++ b/files/es/web/api/document/createelementns/index.html @@ -11,7 +11,7 @@

Sintaxis

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

Parámetros

@@ -21,9 +21,11 @@

Parámetros

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

@@ -43,7 +45,7 @@

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"?>
+
<?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||"
@@ -79,7 +81,7 @@ 

Ejemplo

Especificaciones

-
Especificación
+
diff --git a/files/es/web/api/document/createevent/index.html b/files/es/web/api/document/createevent/index.html index a87d7b9165de3a..6fde7218945229 100644 --- a/files/es/web/api/document/createevent/index.html +++ b/files/es/web/api/document/createevent/index.html @@ -16,7 +16,7 @@

Sintaxis

-
document.createEvent(tipo);
+
document.createEvent(tipo);
tipo
@@ -27,7 +27,7 @@

Sintaxis

Ejemplo

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

Especificación

diff --git a/files/es/web/api/document/createrange/index.html b/files/es/web/api/document/createrange/index.html index 8c0cc633911508..63a686e57e3932 100644 --- a/files/es/web/api/document/createrange/index.html +++ b/files/es/web/api/document/createrange/index.html @@ -38,5 +38,3 @@

Especificación

- -

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

diff --git a/files/es/web/api/document/createtextnode/index.html b/files/es/web/api/document/createtextnode/index.html index c1d69aabcb46b6..9a5393e01c4ad5 100644 --- a/files/es/web/api/document/createtextnode/index.html +++ b/files/es/web/api/document/createtextnode/index.html @@ -16,7 +16,7 @@

Sintaxis

-
var text = document.createTextNode(data);
+
var text = document.createTextNode(data);
 
    @@ -26,7 +26,7 @@

    Sintaxis

    Ejemplo

    -
    <!DOCTYPE html>
    +
    <!DOCTYPE html>
     <html lang="en">
     <head>
     <title>createTextNode example</title>
    @@ -54,7 +54,7 @@ 

    Ejemplo

    Especificaciones

    -
Especificación
+
diff --git a/files/es/web/api/document/defaultview/index.html b/files/es/web/api/document/defaultview/index.html index 4326f3573ee192..98686a97e93022 100644 --- a/files/es/web/api/document/defaultview/index.html +++ b/files/es/web/api/document/defaultview/index.html @@ -18,7 +18,7 @@

Resumen

Sintaxis

-
var win = document.defaultView;
+
var win = document.defaultView;

Esta propiedad es de solo lectura.

diff --git a/files/es/web/api/document/designmode/index.html b/files/es/web/api/document/designmode/index.html index 20e648dd7f4aae..5bf069d4b6c422 100644 --- a/files/es/web/api/document/designmode/index.html +++ b/files/es/web/api/document/designmode/index.html @@ -16,19 +16,19 @@

Sintaxis

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

Ejemplo

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

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

Especificaciones

-
Especificación
+
diff --git a/files/es/web/api/document/dir/index.html b/files/es/web/api/document/dir/index.html index c8b5f96b713664..b975f9b490ba21 100644 --- a/files/es/web/api/document/dir/index.html +++ b/files/es/web/api/document/dir/index.html @@ -9,7 +9,7 @@

Sintáxis

-
dirStr = document.dir;
+
dirStr = document.dir;
 document.dir = dirStr;
 
diff --git a/files/es/web/api/document/doctype/index.html b/files/es/web/api/document/doctype/index.html index 1ccb202c23b3de..96a3402b8ec982 100644 --- a/files/es/web/api/document/doctype/index.html +++ b/files/es/web/api/document/doctype/index.html @@ -16,7 +16,7 @@

Sintaxis

-
doctype = document.doctype;
+
doctype = document.doctype;
 
    @@ -25,7 +25,7 @@

    Sintaxis

    Ejemplo

    -
    var doctypeObj = document.doctype;
    +
    var doctypeObj = document.doctype;
     
     console.log(
       "doctypeObj.name: "           + doctypeObj.name            + "\n" +
    @@ -42,7 +42,7 @@ 

    Notas

    Especificaciones

    -
Especificación
+
diff --git a/files/es/web/api/document/documenturi/index.html b/files/es/web/api/document/documenturi/index.html index 0d8fc85d56de3c..f7c1786d174602 100644 --- a/files/es/web/api/document/documenturi/index.html +++ b/files/es/web/api/document/documenturi/index.html @@ -19,7 +19,7 @@

Sintaxis

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

Notas

@@ -28,7 +28,7 @@

Notas

Especificaciones

-
Especificación
+
diff --git a/files/es/web/api/document/embeds/index.html b/files/es/web/api/document/embeds/index.html index e60f43772711f2..f9a51dfab965d9 100644 --- a/files/es/web/api/document/embeds/index.html +++ b/files/es/web/api/document/embeds/index.html @@ -15,7 +15,7 @@

Sintaxis

-
nodeList = document.embeds
+
nodeList = document.embeds
 

Valor

@@ -24,7 +24,7 @@

Valor

Especificaciones

-
Especificación
+
diff --git a/files/es/web/api/document/execcommand/index.html b/files/es/web/api/document/execcommand/index.html index 5a1c168c68ab8a..4bcd7928920a61 100644 --- a/files/es/web/api/document/execcommand/index.html +++ b/files/es/web/api/document/execcommand/index.html @@ -19,7 +19,7 @@

Sintaxis

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

Parámetros

@@ -198,7 +198,7 @@

Especificación

-
Especificación
+
Sintaxis -
exitPromise = document.exitFullscreen();
+
exitPromise = document.exitFullscreen();
 

Parámetros

@@ -26,7 +26,7 @@

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) {
+
document.onclick = function (event) {
   if (document.fullscreenElement) {
     document.exitFullscreen()
   } else {
@@ -40,7 +40,7 @@ 

Ejemplo

Especificaciones

- +
diff --git a/files/es/web/api/document/getelementbyid/index.html b/files/es/web/api/document/getelementbyid/index.html index 1581422dedb071..b869432094080f 100644 --- a/files/es/web/api/document/getelementbyid/index.html +++ b/files/es/web/api/document/getelementbyid/index.html @@ -20,7 +20,7 @@

Sintaxis

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

Parámetros

@@ -30,17 +30,17 @@

Parámetros

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

Valor Retornado

+

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>
+ 
<html>
 <head>
    <title>Ejemplo getElementById</title>
 </head>
@@ -54,7 +54,7 @@ 

HTML

JavaScript

-
function changeColor(newColor) {
+ 
function changeColor(newColor) {
    var elem = document.getElementById('para');
    elem.style.color = newColor;
 }
@@ -63,8 +63,6 @@ 

JavaScript

Resultado

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

- -

Notas

@@ -74,7 +72,7 @@

Notas

Ejemplo

-
<!doctype html>
+
<!doctype html>
 <html>
 <head>
     <meta charset="UTF-8">
@@ -101,7 +99,7 @@ 

Ejemplo

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");
+
var element = document.createElement("div");
 element.id = 'testqq';
 var el = document.getElementById('testqq'); // el será null!
 
diff --git a/files/es/web/api/document/getelementsbyclassname/index.html b/files/es/web/api/document/getelementsbyclassname/index.html index 541d21eb42980c..11d6cae9e8cf21 100644 --- a/files/es/web/api/document/getelementsbyclassname/index.html +++ b/files/es/web/api/document/getelementsbyclassname/index.html @@ -9,7 +9,7 @@

Sintaxis

-
var elementos = document.getElementsByClassName(nombres); // ó :
+
var elementos = document.getElementsByClassName(nombres); // ó :
 var elementos = elementoRaiz.getElementsByClassName(nombres);
    @@ -22,19 +22,19 @@

    Ejemplos

    Obtener todos los elementos de la clase 'prueba'

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

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

    -
    document.getElementsByClassName('rojo 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');
    +
    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 testElements = document.getElementsByClassName('test');
     var testDivs = Array.prototype.filter.call(testElements, function(testElement){
         return testElement.nodeName === 'DIV';
     });
    diff --git a/files/es/web/api/document/getelementsbyname/index.html b/files/es/web/api/document/getelementsbyname/index.html index 68503568add801..988d91f3a0ea8e 100644 --- a/files/es/web/api/document/getelementsbyname/index.html +++ b/files/es/web/api/document/getelementsbyname/index.html @@ -9,7 +9,7 @@

    Sintaxis

    -
    elements = document.getElementsByName(name)
    +
    elements = document.getElementsByName(name)
     
      @@ -19,7 +19,7 @@

      Sintaxis

      Ejemplo

      -
      <!DOCTYPE html>
      +
      <!DOCTYPE html>
       <html lang="en">
       <head>
        ...
      @@ -52,7 +52,7 @@ 

      Especificaciones

      Especificaciones

      -
Especificación
+
diff --git a/files/es/web/api/document/getelementsbytagname/index.html b/files/es/web/api/document/getelementsbytagname/index.html index 7be48858c0cde2..f2b284bb78550b 100644 --- a/files/es/web/api/document/getelementsbytagname/index.html +++ b/files/es/web/api/document/getelementsbytagname/index.html @@ -27,7 +27,7 @@

Ejemplo

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>
+
<html>
 
 <head>
 <title>ejemplo de getElementsByTagName</title>
diff --git a/files/es/web/api/document/getelementsbytagnamens/index.html b/files/es/web/api/document/getelementsbytagnamens/index.html
index d97657647be6c4..9eadd399dee739 100644
--- a/files/es/web/api/document/getelementsbytagnamens/index.html
+++ b/files/es/web/api/document/getelementsbytagnamens/index.html
@@ -30,7 +30,7 @@ 

Ejemplo

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

-
<html xmlns="http://www.w3.org/1999/xhtml">
+
<html xmlns="http://www.w3.org/1999/xhtml">
 
 <head>
 <title>ejemplo de getElementsByTagNameNS</title>
diff --git a/files/es/web/api/document/head/index.html b/files/es/web/api/document/head/index.html
index 2b72bbce272126..bfeab2f6b012da 100644
--- a/files/es/web/api/document/head/index.html
+++ b/files/es/web/api/document/head/index.html
@@ -9,12 +9,12 @@
 
 

Sintaxis

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

Ejemplo

-
// en el HTML: <head id="my-document-head">
+
// en el HTML: <head id="my-document-head">
 var aHead = document.head;
 
 alert(aHead.id); // "my-document-head";
diff --git a/files/es/web/api/document/hidden/index.html b/files/es/web/api/document/hidden/index.html
index b57337d2f3b3b7..7842de6e441c04 100644
--- a/files/es/web/api/document/hidden/index.html
+++ b/files/es/web/api/document/hidden/index.html
@@ -9,11 +9,11 @@
 
 

Sintaxis

-
var boolean = document.hidden
+
var boolean = document.hidden

Ejemplo

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

Ejemplo

Especificaciones

-
Especificaciones
+
diff --git a/files/es/web/api/document/importnode/index.html b/files/es/web/api/document/importnode/index.html index 8b7ea431b74481..63920133fd2e15 100644 --- a/files/es/web/api/document/importnode/index.html +++ b/files/es/web/api/document/importnode/index.html @@ -9,7 +9,7 @@

Sintaxis

-
var node = document.importNode(externalNode, deep);
+
var node = document.importNode(externalNode, deep);
 
@@ -29,7 +29,7 @@

Sintaxis

Ejemplo

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

Notas

Especificaciones

-
Especificacion
+
diff --git a/files/es/web/api/document/open/index.html b/files/es/web/api/document/open/index.html index 452cf58a890118..7cd26e29c3cea1 100644 --- a/files/es/web/api/document/open/index.html +++ b/files/es/web/api/document/open/index.html @@ -17,7 +17,7 @@

Sintaxis

-
document.open();
+
document.open();
 

Parametros

@@ -60,13 +60,13 @@

Three-argument document.open()

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')
+
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)
+
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.

@@ -74,7 +74,7 @@

Specifications

-
Specification
+
diff --git a/files/es/web/api/document/pointerlockelement/index.html b/files/es/web/api/document/pointerlockelement/index.html index b8f33cc545f136..1c69bebd8c7082 100644 --- a/files/es/web/api/document/pointerlockelement/index.html +++ b/files/es/web/api/document/pointerlockelement/index.html @@ -10,7 +10,7 @@

Sintaxis

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

Valor retornado

@@ -19,7 +19,7 @@

Valor retornado

Especificaciones

-
Specification
+
diff --git a/files/es/web/api/document/queryselector/index.html b/files/es/web/api/document/queryselector/index.html index 1ad54ba0915b75..1ac664123ae52f 100644 --- a/files/es/web/api/document/queryselector/index.html +++ b/files/es/web/api/document/queryselector/index.html @@ -19,7 +19,7 @@

Sintaxis

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

Donde:

@@ -33,14 +33,14 @@

Ejemplo

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

-
var el = document.querySelector(".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']");
+
var el = document.querySelector("div.user-panel.main input[name='login']");

Notas

@@ -54,7 +54,7 @@

Notas

  • 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>
     <div id="foo:bar"></div>
     
     <script>
    @@ -72,59 +72,12 @@ 

    Notas

    Compatibilidad en los navegadores

    -
    -
    Especificación
    - - - - - - - - - - - - - - - - - - -
    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
    -
    +{{Compat}}

    Especificaciones

    - +{{Specifications}} +

    Vea también

    diff --git a/files/es/web/api/document/queryselectorall/index.html b/files/es/web/api/document/queryselectorall/index.html index a0e4ca0b3cfc71..3b6cb8d57fee2b 100644 --- a/files/es/web/api/document/queryselectorall/index.html +++ b/files/es/web/api/document/queryselectorall/index.html @@ -26,7 +26,7 @@

    Sintaxis

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

    Parámetros

    @@ -61,25 +61,25 @@

    Obteniendo una lista de coinciden

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

    -
    var matches = document.querySelectorAll('p');
    +
    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');
    +
    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 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]');
    +
    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 container = document.querySelector('#userlist');
     var matches = container.querySelectorAll('li[data-active="1"]');

    Accediendo a las coincidencias

    @@ -88,7 +88,7 @@

    Accediendo a las 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');
    +
    var highlightedItems = userList.querySelectorAll('.highlighted');
     
     highlightedItems.forEach(function(userItem) {
       deleteUser(userItem);
    @@ -102,7 +102,7 @@ 

    HTML

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

    -
    <div class="outer">
    +
    <div class="outer">
       <div class="select">
         <div class="inner">
         </div>
    @@ -111,7 +111,7 @@ 

    HTML

    JavaScript

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

    JavaScript

    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 select = document.querySelector('.select');
     var inner = select.querySelectorAll(':scope .outer .inner');
     inner.length; // 0
     

    Especificaciones

    - +
    diff --git a/files/es/web/api/document/readystate/index.html b/files/es/web/api/document/readystate/index.html index 0c0fa5cc2c4a4e..cee34853b354c2 100644 --- a/files/es/web/api/document/readystate/index.html +++ b/files/es/web/api/document/readystate/index.html @@ -26,14 +26,14 @@

    Valores

    Sintaxis

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

    Ejemplos

    Diferentes estados del readyState

    -
    switch (document.readyState) {
    +
    switch (document.readyState) {
       case "loading":
         // The document is still loading.
         break;
    @@ -52,7 +52,7 @@ 

    Diferentes estados del readyState

    readystatechange como alternativa al evento DOMContentLoaded -
    // alternative to DOMContentLoaded event
    +
    // alternative to DOMContentLoaded event
     document.onreadystatechange = function () {
       if (document.readyState == "interactive") {
         initApplication();
    @@ -61,7 +61,7 @@ 

    readystate

    readystatechange como alternativa al evento load

    -
    // alternative to load event
    +
    // alternative to load event
     document.onreadystatechange = function () {
       if (document.readyState == "complete") {
         initApplication();
    @@ -70,7 +70,7 @@ 

    readystatechange como

    Especificación

    -
    Especificación
    +
    diff --git a/files/es/web/api/document/registerelement/index.html b/files/es/web/api/document/registerelement/index.html index 9e74c264a49fd3..07492a0edfd47a 100644 --- a/files/es/web/api/document/registerelement/index.html +++ b/files/es/web/api/document/registerelement/index.html @@ -13,7 +13,7 @@

    Sintaxis

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

    Parámetros

    @@ -28,22 +28,22 @@

    Ejemplo

    Aquí hay un ejemplo muy simple:

    -
    var Mytag = document.registerElement('my-tag');
    +
    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());
    +
    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];
    +
    var mytag = document.getElementsByTagName("my-tag")[0];
     mytag.textContent = "I am a my-tag element.";
     

    Especificaciones

    -
    Especificación
    +
    diff --git a/files/es/web/api/document/scripts/index.html b/files/es/web/api/document/scripts/index.html index fd25bc40a98c22..f819d1096fe22f 100644 --- a/files/es/web/api/document/scripts/index.html +++ b/files/es/web/api/document/scripts/index.html @@ -9,7 +9,7 @@

    Sintáxis

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

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

    @@ -18,7 +18,7 @@

    Ejemplo

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

    -
    var scripts = document.scripts;
    +
    var scripts = document.scripts;
     
     if (scripts.length) {
       alert("This page has scripts!");
    diff --git a/files/es/web/api/document/scroll_event/index.html b/files/es/web/api/document/scroll_event/index.html
    index a5a590ec74febd..a67837d23c0950 100644
    --- a/files/es/web/api/document/scroll_event/index.html
    +++ b/files/es/web/api/document/scroll_event/index.html
    @@ -3,29 +3,29 @@
     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

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

    -
    Especificación
    +
    @@ -73,7 +73,7 @@

    Ejemplo

    Optimización de Scroll con window.requestAnimationFrame

    -
    // Referencia: http://www.html5rocks.com/en/tutorials/speed/animations/
    +
    // Referencia: http://www.html5rocks.com/en/tutorials/speed/animations/
     
     var last_known_scroll_position = 0;
     var ticking = false;
    diff --git a/files/es/web/api/document/stylesheets/index.html b/files/es/web/api/document/stylesheets/index.html
    index f17c721fda8f04..25c611cd1aa6d0 100644
    --- a/files/es/web/api/document/stylesheets/index.html
    +++ b/files/es/web/api/document/stylesheets/index.html
    @@ -20,4 +20,3 @@ 

    Sintaxis

    ') }} 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/url/index.html b/files/es/web/api/document/url/index.html index 3d125432ef0d48..296927deac5376 100644 --- a/files/es/web/api/document/url/index.html +++ b/files/es/web/api/document/url/index.html @@ -15,17 +15,17 @@

    Sintaxis

    -
    var string = document.URL
    +
    var string = document.URL

    Ejemplo

    JavaScript

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

    HTML

    -
    <p id="urlText">
    +
    <p id="urlText">
       URL:<br/>
       <span id="url">La URL va aquí</span>
     </p>
    @@ -36,7 +36,7 @@

    Resultado

    Especificaciones

    -
    Property
    +
    diff --git a/files/es/web/api/document/write/index.html b/files/es/web/api/document/write/index.html index 1c88dff68f36d3..7ecf8c0b94e878 100644 --- a/files/es/web/api/document/write/index.html +++ b/files/es/web/api/document/write/index.html @@ -18,14 +18,14 @@

    Sintaxis

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

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

    Example

    -
    <html>
    +
    <html>
     
     <head>
       <title>Ejemplo de write</title>
    @@ -52,7 +52,7 @@ 

    Notas

    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>
    +
    <script>
       document.write("<h1>Título Principal</h1>")
     </script>
     
    diff --git a/files/es/web/api/document/writeln/index.html b/files/es/web/api/document/writeln/index.html index be9910a516e928..977d526e7773a6 100644 --- a/files/es/web/api/document/writeln/index.html +++ b/files/es/web/api/document/writeln/index.html @@ -24,7 +24,7 @@

    Parámetros

    Ejemplo

    -
    document.writeln("<p>¡Hola mundo!</p>");
    +
    document.writeln("<p>¡Hola mundo!</p>");
     

    Notas

    From b44854769918793d14cc84fd74f833bfbf7fe202 Mon Sep 17 00:00:00 2001 From: Craig Blaszczyk Date: Tue, 20 Sep 2022 14:39:02 +0100 Subject: [PATCH 2/4] feat: convert web/api/document to markdown --- .../es/web/api/document/adoptnode/index.html | 61 ----- files/es/web/api/document/adoptnode/index.md | 55 +++++ .../es/web/api/document/alinkcolor/index.html | 36 --- files/es/web/api/document/alinkcolor/index.md | 35 +++ files/es/web/api/document/anchors/index.html | 93 ------- files/es/web/api/document/anchors/index.md | 93 +++++++ files/es/web/api/document/applets/index.html | 28 --- files/es/web/api/document/applets/index.md | 29 +++ files/es/web/api/document/bgcolor/index.html | 37 --- files/es/web/api/document/bgcolor/index.md | 37 +++ files/es/web/api/document/body/index.html | 37 --- files/es/web/api/document/body/index.md | 39 +++ .../web/api/document/characterset/index.html | 34 --- .../es/web/api/document/characterset/index.md | 34 +++ files/es/web/api/document/clear/index.html | 31 --- files/es/web/api/document/clear/index.md | 30 +++ files/es/web/api/document/close/index.html | 27 --- files/es/web/api/document/close/index.md | 29 +++ .../web/api/document/contenttype/index.html | 25 -- .../es/web/api/document/contenttype/index.md | 24 ++ files/es/web/api/document/cookie/index.html | 118 --------- files/es/web/api/document/cookie/index.md | 123 ++++++++++ .../api/document/createattribute/index.html | 92 ------- .../web/api/document/createattribute/index.md | 61 +++++ .../createdocumentfragment/index.html | 73 ------ .../document/createdocumentfragment/index.md | 74 ++++++ .../web/api/document/createelement/index.html | 104 -------- .../web/api/document/createelement/index.md | 92 +++++++ .../api/document/createelementns/index.html | 110 --------- .../web/api/document/createelementns/index.md | 93 +++++++ .../web/api/document/createevent/index.html | 36 --- .../es/web/api/document/createevent/index.md | 36 +++ .../web/api/document/createrange/index.html | 40 ---- .../es/web/api/document/createrange/index.md | 38 +++ .../api/document/createtextnode/index.html | 78 ------ .../web/api/document/createtextnode/index.md | 63 +++++ .../web/api/document/defaultview/index.html | 35 --- .../es/web/api/document/defaultview/index.md | 35 +++ .../es/web/api/document/designmode/index.html | 56 ----- files/es/web/api/document/designmode/index.md | 46 ++++ files/es/web/api/document/dir/index.html | 28 --- files/es/web/api/document/dir/index.md | 27 +++ files/es/web/api/document/doctype/index.html | 65 ----- files/es/web/api/document/doctype/index.md | 49 ++++ .../api/document/documentelement/index.html | 42 ---- .../web/api/document/documentelement/index.md | 44 ++++ .../web/api/document/documenturi/index.html | 53 ---- .../es/web/api/document/documenturi/index.md | 39 +++ files/es/web/api/document/embeds/index.html | 48 ---- files/es/web/api/document/embeds/index.md | 34 +++ .../web/api/document/execcommand/index.html | 226 ------------------ .../es/web/api/document/execcommand/index.md | 145 +++++++++++ .../api/document/exitfullscreen/index.html | 75 ------ .../web/api/document/exitfullscreen/index.md | 59 +++++ .../api/document/getelementbyid/index.html | 152 ------------ .../web/api/document/getelementbyid/index.md | 126 ++++++++++ .../getelementsbyclassname/index.html | 50 ---- .../document/getelementsbyclassname/index.md | 56 +++++ .../api/document/getelementsbyname/index.html | 81 ------- .../api/document/getelementsbyname/index.md | 62 +++++ .../document/getelementsbytagname/index.html | 104 -------- .../document/getelementsbytagname/index.md | 104 ++++++++ .../getelementsbytagnamens/index.html | 107 --------- .../document/getelementsbytagnamens/index.md | 107 +++++++++ .../getselection/{index.html => index.md} | 4 +- files/es/web/api/document/hasfocus/index.html | 23 -- files/es/web/api/document/hasfocus/index.md | 24 ++ files/es/web/api/document/head/index.html | 37 --- files/es/web/api/document/head/index.md | 37 +++ files/es/web/api/document/hidden/index.html | 43 ---- files/es/web/api/document/hidden/index.md | 33 +++ .../es/web/api/document/importnode/index.html | 84 ------- files/es/web/api/document/importnode/index.md | 57 +++++ files/es/web/api/document/open/index.html | 110 --------- files/es/web/api/document/open/index.md | 92 +++++++ .../document/pointerlockelement/index.html | 47 ---- .../api/document/pointerlockelement/index.md | 35 +++ .../web/api/document/queryselector/index.html | 89 ------- .../web/api/document/queryselector/index.md | 83 +++++++ .../api/document/queryselectorall/index.html | 179 -------------- .../api/document/queryselectorall/index.md | 156 ++++++++++++ .../es/web/api/document/readystate/index.html | 104 -------- files/es/web/api/document/readystate/index.md | 87 +++++++ .../api/document/registerelement/index.html | 69 ------ .../web/api/document/registerelement/index.md | 58 +++++ files/es/web/api/document/scripts/index.html | 38 --- files/es/web/api/document/scripts/index.md | 38 +++ .../web/api/document/scroll_event/index.html | 104 -------- .../es/web/api/document/scroll_event/index.md | 70 ++++++ .../web/api/document/stylesheets/index.html | 22 -- .../es/web/api/document/stylesheets/index.md | 33 +++ files/es/web/api/document/url/index.html | 71 ------ files/es/web/api/document/url/index.md | 56 +++++ files/es/web/api/document/write/index.html | 76 ------ files/es/web/api/document/write/index.md | 75 ++++++ files/es/web/api/document/writeln/index.html | 40 ---- files/es/web/api/document/writeln/index.md | 38 +++ 97 files changed, 2892 insertions(+), 3320 deletions(-) delete mode 100644 files/es/web/api/document/adoptnode/index.html create mode 100644 files/es/web/api/document/adoptnode/index.md delete mode 100644 files/es/web/api/document/alinkcolor/index.html create mode 100644 files/es/web/api/document/alinkcolor/index.md delete mode 100644 files/es/web/api/document/anchors/index.html create mode 100644 files/es/web/api/document/anchors/index.md delete mode 100644 files/es/web/api/document/applets/index.html create mode 100644 files/es/web/api/document/applets/index.md delete mode 100644 files/es/web/api/document/bgcolor/index.html create mode 100644 files/es/web/api/document/bgcolor/index.md delete mode 100644 files/es/web/api/document/body/index.html create mode 100644 files/es/web/api/document/body/index.md delete mode 100644 files/es/web/api/document/characterset/index.html create mode 100644 files/es/web/api/document/characterset/index.md delete mode 100644 files/es/web/api/document/clear/index.html create mode 100644 files/es/web/api/document/clear/index.md delete mode 100644 files/es/web/api/document/close/index.html create mode 100644 files/es/web/api/document/close/index.md delete mode 100644 files/es/web/api/document/contenttype/index.html create mode 100644 files/es/web/api/document/contenttype/index.md delete mode 100644 files/es/web/api/document/cookie/index.html create mode 100644 files/es/web/api/document/cookie/index.md delete mode 100644 files/es/web/api/document/createattribute/index.html create mode 100644 files/es/web/api/document/createattribute/index.md delete mode 100644 files/es/web/api/document/createdocumentfragment/index.html create mode 100644 files/es/web/api/document/createdocumentfragment/index.md delete mode 100644 files/es/web/api/document/createelement/index.html create mode 100644 files/es/web/api/document/createelement/index.md delete mode 100644 files/es/web/api/document/createelementns/index.html create mode 100644 files/es/web/api/document/createelementns/index.md delete mode 100644 files/es/web/api/document/createevent/index.html create mode 100644 files/es/web/api/document/createevent/index.md delete mode 100644 files/es/web/api/document/createrange/index.html create mode 100644 files/es/web/api/document/createrange/index.md delete mode 100644 files/es/web/api/document/createtextnode/index.html create mode 100644 files/es/web/api/document/createtextnode/index.md delete mode 100644 files/es/web/api/document/defaultview/index.html create mode 100644 files/es/web/api/document/defaultview/index.md delete mode 100644 files/es/web/api/document/designmode/index.html create mode 100644 files/es/web/api/document/designmode/index.md delete mode 100644 files/es/web/api/document/dir/index.html create mode 100644 files/es/web/api/document/dir/index.md delete mode 100644 files/es/web/api/document/doctype/index.html create mode 100644 files/es/web/api/document/doctype/index.md delete mode 100644 files/es/web/api/document/documentelement/index.html create mode 100644 files/es/web/api/document/documentelement/index.md delete mode 100644 files/es/web/api/document/documenturi/index.html create mode 100644 files/es/web/api/document/documenturi/index.md delete mode 100644 files/es/web/api/document/embeds/index.html create mode 100644 files/es/web/api/document/embeds/index.md delete mode 100644 files/es/web/api/document/execcommand/index.html create mode 100644 files/es/web/api/document/execcommand/index.md delete mode 100644 files/es/web/api/document/exitfullscreen/index.html create mode 100644 files/es/web/api/document/exitfullscreen/index.md delete mode 100644 files/es/web/api/document/getelementbyid/index.html create mode 100644 files/es/web/api/document/getelementbyid/index.md delete mode 100644 files/es/web/api/document/getelementsbyclassname/index.html create mode 100644 files/es/web/api/document/getelementsbyclassname/index.md delete mode 100644 files/es/web/api/document/getelementsbyname/index.html create mode 100644 files/es/web/api/document/getelementsbyname/index.md delete mode 100644 files/es/web/api/document/getelementsbytagname/index.html create mode 100644 files/es/web/api/document/getelementsbytagname/index.md delete mode 100644 files/es/web/api/document/getelementsbytagnamens/index.html create mode 100644 files/es/web/api/document/getelementsbytagnamens/index.md rename files/es/web/api/document/getselection/{index.html => index.md} (56%) delete mode 100644 files/es/web/api/document/hasfocus/index.html create mode 100644 files/es/web/api/document/hasfocus/index.md delete mode 100644 files/es/web/api/document/head/index.html create mode 100644 files/es/web/api/document/head/index.md delete mode 100644 files/es/web/api/document/hidden/index.html create mode 100644 files/es/web/api/document/hidden/index.md delete mode 100644 files/es/web/api/document/importnode/index.html create mode 100644 files/es/web/api/document/importnode/index.md delete mode 100644 files/es/web/api/document/open/index.html create mode 100644 files/es/web/api/document/open/index.md delete mode 100644 files/es/web/api/document/pointerlockelement/index.html create mode 100644 files/es/web/api/document/pointerlockelement/index.md delete mode 100644 files/es/web/api/document/queryselector/index.html create mode 100644 files/es/web/api/document/queryselector/index.md delete mode 100644 files/es/web/api/document/queryselectorall/index.html create mode 100644 files/es/web/api/document/queryselectorall/index.md delete mode 100644 files/es/web/api/document/readystate/index.html create mode 100644 files/es/web/api/document/readystate/index.md delete mode 100644 files/es/web/api/document/registerelement/index.html create mode 100644 files/es/web/api/document/registerelement/index.md delete mode 100644 files/es/web/api/document/scripts/index.html create mode 100644 files/es/web/api/document/scripts/index.md delete mode 100644 files/es/web/api/document/scroll_event/index.html create mode 100644 files/es/web/api/document/scroll_event/index.md delete mode 100644 files/es/web/api/document/stylesheets/index.html create mode 100644 files/es/web/api/document/stylesheets/index.md delete mode 100644 files/es/web/api/document/url/index.html create mode 100644 files/es/web/api/document/url/index.md delete mode 100644 files/es/web/api/document/write/index.html create mode 100644 files/es/web/api/document/write/index.md delete mode 100644 files/es/web/api/document/writeln/index.html create mode 100644 files/es/web/api/document/writeln/index.md 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 736e92d22039a4..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

    - -
      -
    • {{domxref("document.importNode")}}
    • -
    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..72b4a24499287d --- /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](http://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. + +## Epecificación + +- [DOM Level 3 Core: Document.adoptNode](http://www.w3.org/TR/DOM-Level-3-Core/core.html#Document3-adoptNode) + +## Compatibilidad con navegadores + +{{Compat("api.Document.adoptNode")}} + +## 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..49eccdba94c63d --- /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")}} + +> **Advertencia:** **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](http://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](http://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`. + +## Especificación + +DOM Nivel 0. No es parte de ningún estándar. + +[MSDN: alinkColor property](http://msdn.microsoft.com/workshop/author/dhtml/reference/properties/alinkcolor.asp) 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 6c77ce14aff332..00000000000000 --- a/files/es/web/api/document/anchors/index.html +++ /dev/null @@ -1,93 +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

    - -

    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..44c85a5da221c2 --- /dev/null +++ b/files/es/web/api/document/anchors/index.md @@ -0,0 +1,93 @@ +--- +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 + +``` +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 + +[DOM Level 2 HTML: anchors](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-7577272) + +## Compatibilidad de navegadores + +{{Compat("api.Document.anchors")}} 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 233d2a56f01e6f..00000000000000 --- a/files/es/web/api/document/applets/index.html +++ /dev/null @@ -1,28 +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

      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..b341c67aa05b98 --- /dev/null +++ b/files/es/web/api/document/applets/index.md @@ -0,0 +1,29 @@ +--- +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](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-85113862) 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 1975b42dbe0dff..00000000000000 --- a/files/es/web/api/document/bgcolor/index.html +++ /dev/null @@ -1,37 +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

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

      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.

      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..d4ffac75218918 --- /dev/null +++ b/files/es/web/api/document/bgcolor/index.md @@ -0,0 +1,37 @@ +--- +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 + +- `color` es un texto representando el color como una palabra en inglés (e.j., "red") o en valor hexadecimal (e.j., "`#ff0000`"). + +### 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](http://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. + +### Especificación + +DOM Nivel 0. No es parte de ningún estándar. 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 241a06830d892e..00000000000000 --- a/files/es/web/api/document/body/index.html +++ /dev/null @@ -1,37 +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

      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..59572157ac811b --- /dev/null +++ b/files/es/web/api/document/body/index.md @@ -0,0 +1,39 @@ +--- +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 + +``` +objRef = document.body +document.body = +objRef +``` + +### Ejemplo + +``` +// 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 ``. + +### Especificación + +[DOM Level 2 HTML: HTMLDocument.body](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-56360201) 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 ca52b03dd3ebd8..00000000000000 --- a/files/es/web/api/document/characterset/index.html +++ /dev/null @@ -1,34 +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.

      - -
      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..1be36b819bbf78 --- /dev/null +++ b/files/es/web/api/document/characterset/index.md @@ -0,0 +1,34 @@ +--- +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 + +``` + +// 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: . + +### Especificación + +DOM Nivel 0. No es parte de ningún estándar. 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..dbfe95ef30cd4c --- /dev/null +++ b/files/es/web/api/document/clear/index.md @@ -0,0 +1,30 @@ +--- +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 + +- [HTML5](http://www.whatwg.org/html/#dom-document-clear) 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 f67f062861a7d2..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..464fcc44d912e9 --- /dev/null +++ b/files/es/web/api/document/close/index.md @@ -0,0 +1,29 @@ +--- +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 + +``` +document.close(); +``` + +## Ejemplo + +```js +// Abrir un documento. +// Escribir contenido en el documento. +// Cerrar el documento. +document.open(); +document.write("

      El único contenido.

      "); +document.close(); +``` + +## Especificación + +[DOM Level 2 HTML: `close()` Method](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-98948567) 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..3290f751365e80 --- /dev/null +++ b/files/es/web/api/document/contenttype/index.md @@ -0,0 +1,24 @@ +--- +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](/en/Gecko "en/Gecko"). 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 ac0b31774694fa..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:

      - -
        -
      • 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). Para más información sobre cómo utilizar rutas relativas, ir a este párrafo.
        • -
        • ;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() 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.
        • -
        -
      • -
      - -
      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

      - -
        -
      • Empezando con Firefox 2, está disponible un mejor mecanismo de almacenamiento en cliente - WHATWG 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 si se van a mantener los datos solamente en el cliente.
      • -
      - -

      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..6c46b18ee88c94 --- /dev/null +++ b/files/es/web/api/document/cookie/index.md @@ -0,0 +1,123 @@ +--- +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 + +} +``` + +```js + +``` + +{{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); +} +``` + +```js + +``` + +{{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"; + } +} +``` + +```js + +``` + +{{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. + +### Especificación + +[DOM Level 2: HTMLDocument.cookie](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-8747038) 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 ea2918662b5273..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

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

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

      Especificaciones

      - -
      Especificación
      - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      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

      - -
        -
      • {{domxref("Document.createElement()")}}
      • -
      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..1900d17a7755c2 --- /dev/null +++ b/files/es/web/api/document/createattribute/index.md @@ -0,0 +1,61 @@ +--- +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 + +| Especificación | Estatus | Comentario | +| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------------------------------- | +| {{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 + +- {{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 61ab2e03c3dfdc..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

      - -
        -
      • {{domxref("DOMImplementation.createDocument", "document.implementation.createDocument()")}}
      • -
      • {{domxref("documentFragment")}}
      • -
      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..812ffcef96034b --- /dev/null +++ b/files/es/web/api/document/createdocumentfragment/index.md @@ -0,0 +1,74 @@ +--- +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 + +``` +
        +
      +``` + +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 + +- DOM Level 2: [createDocumentFragment](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-35CB04B5) +- DOM Level 3: [createDocumentFragment](http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-35CB04B5) + +## 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 352cab19a78cec..00000000000000 --- a/files/es/web/api/document/createelement/index.html +++ /dev/null @@ -1,104 +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

      - -
        -
      • {{domxref("Node.removeChild()")}}
      • -
      • {{domxref("Node.replaceChild()")}}
      • -
      • {{domxref("Node.appendChild()")}}
      • -
      • {{domxref("Node.insertBefore()")}}
      • -
      • {{domxref("Node.hasChildNodes()")}}
      • -
      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..7ccb0cc88b354b --- /dev/null +++ b/files/es/web/api/document/createelement/index.md @@ -0,0 +1,92 @@ +--- +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 + +| Especificación | Estado | Comentario | +| ---------------------------------------------------------------------------------------------------------------- | -------------------------------- | ---------- | +| {{SpecName('DOM WHATWG', "#dom-document-createelement", "Document.createElement")}} | {{Spec2('DOM WHATWG')}} | | + +## Compatibilidad con navegadores + +{{Compat("api.Document.createElement")}} + +## 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 c19b81ec0fcdf5..00000000000000 --- a/files/es/web/api/document/createelementns/index.html +++ /dev/null @@ -1,110 +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.
      -
      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, 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

      - -
        -
      • 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 <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..72af2dc5cb2f07 --- /dev/null +++ b/files/es/web/api/document/createelementns/index.md @@ -0,0 +1,93 @@ +--- +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](http://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 + +| Especificación | Estatus | Comentario | +| ---------------------------------------------------------------------------------------------------------------- | -------------------------------- | ---------- | +| {{SpecName('DOM WHATWG', "#dom-document-createelementns", "Document.createElement")}} | {{Spec2('DOM WHATWG')}} | | + +## Compatibilidad con navegadores + +{{Compat("api.Document.createElementNS")}} + +## Ver también + +- [document.createElement](createElement) +- [document.createTextNode](createTextNode) +- [Node.namespaceURI](../Node/namespaceURI) +- [Namespaces in XML](http://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 6fde7218945229..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..2c0df9839d3cac --- /dev/null +++ b/files/es/web/api/document/createevent/index.md @@ -0,0 +1,36 @@ +--- +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"); +``` + +### Especificación + +- [DOM Level 2 Events](http://www.w3.org/TR/DOM-Level-2-Events/events.html#Events-document) 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 63a686e57e3932..00000000000000 --- a/files/es/web/api/document/createrange/index.html +++ /dev/null @@ -1,40 +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

      - - - -
      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..65c811d9ba78b5 --- /dev/null +++ b/files/es/web/api/document/createrange/index.md @@ -0,0 +1,38 @@ +--- +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 + +``` +range = document.createRange(); +``` + +En este ejemplo, `range` es el nuevo objeto [rango](/es/docs/Web/API/Range) 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](http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-DocumentRange-method-createRange) 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 9a5393e01c4ad5..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..7c4dd0b7670a64 --- /dev/null +++ b/files/es/web/api/document/createtextnode/index.md @@ -0,0 +1,63 @@ +--- +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 + +| Especificación | Estado | Comentario | +| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ---------- | +| {{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/defaultview/index.html b/files/es/web/api/document/defaultview/index.html deleted file mode 100644 index 98686a97e93022..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..618b9c03e2a1e4 --- /dev/null +++ b/files/es/web/api/document/defaultview/index.md @@ -0,0 +1,35 @@ +--- +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. + +## Especificación + +- [HTML5: defaultView](/es/docs/HTML/HTML5 "HTML/HTML5") +- [DOM Level 2 Views: defaultView](http://www.w3.org/TR/DOM-Level-2-Views/views.html#Views-DocumentView-defaultView) +- [DOM Level 3 Views](http://www.w3.org/TR/DOM-Level-3-Views/) (Actualmente en desarrolo como "Working Group Note" en W3C y aún no está implementado) 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 5bf069d4b6c422..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..26fce879cbe682 --- /dev/null +++ b/files/es/web/api/document/designmode/index.md @@ -0,0 +1,46 @@ +--- +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 + +| Especificación | Estado | Comentario | +| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- | ------------------- | +| {{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 + +- [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 b975f9b490ba21..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..55fa135e557f09 --- /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("")}}{{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 + +```js +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/doctype/index.html b/files/es/web/api/document/doctype/index.html deleted file mode 100644 index 96a3402b8ec982..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..e3eb9910dee132 --- /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 + +| Especificación | Estado | Comentario | +| ------------------------------------------------------------------------------------------------ | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | +| {{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/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..2dc529c7a2dab1 --- /dev/null +++ b/files/es/web/api/document/documentelement/index.md @@ -0,0 +1,44 @@ +--- +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 + +``` +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, ``, 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. + +### Especificación + +[DOM Level 2 Core: Document.documentElement](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-87CD092) 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 f7c1786d174602..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..27160ae7909d06 --- /dev/null +++ b/files/es/web/api/document/documenturi/index.md @@ -0,0 +1,39 @@ +--- +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 + +| Especificación | Estado | Comentario | +| ---------------------------------------------------------------------------------------- | ---------------------------- | ------------------ | +| {{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/embeds/index.html b/files/es/web/api/document/embeds/index.html deleted file mode 100644 index f9a51dfab965d9..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..6b950fc1966373 --- /dev/null +++ b/files/es/web/api/document/embeds/index.md @@ -0,0 +1,34 @@ +--- +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 + +| Especificación | Estado | Comentario | +| -------------------------------------------------------------------------------------------- | ------------------------------------ | ---------- | +| {{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/execcommand/index.html b/files/es/web/api/document/execcommand/index.html deleted file mode 100644 index 4bcd7928920a61..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..4c2f5f43853cb3 --- /dev/null +++ b/files/es/web/api/document/execcommand/index.md @@ -0,0 +1,145 @@ +--- +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 + +```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.) + +## Compatibilidad del navegador + +{{Compat("api.Document.execCommand")}} + +## Especificación + +| Especificación | Estado | Comentario | +| -------------------------------------------------------------------------------- | -------------------------------- | ---------- | +| {{SpecName('HTML Editing','#execcommand()','execCommand')}} | {{Spec2('HTML Editing')}} | | + +## 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 f634c9575cd78e..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..b65d5a35858f55 --- /dev/null +++ b/files/es/web/api/document/exitfullscreen/index.md @@ -0,0 +1,59 @@ +--- +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 + +| Especificación | Estado | Comentarios | +| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------ | +| {{SpecName("Fullscreen", "#dom-document-exitfullscreen", "Document.exitFullscreen()")}} | {{Spec2("Fullscreen")}} | Definición inicial | + +## Compatibilidad del navegador + +{{Compat("api.Document.exitFullscreen")}} + +## 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 b869432094080f..00000000000000 --- a/files/es/web/api/document/getelementbyid/index.html +++ /dev/null @@ -1,152 +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..19673b891e8d65 --- /dev/null +++ b/files/es/web/api/document/getelementbyid/index.md @@ -0,0 +1,126 @@ +--- +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. + +## Especificación + +| Especificación | Status | Comentarios | +| ------------------------------------------------------------------------------------------------------------ | -------------------------------- | ------------------------------------ | +| {{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](/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 11d6cae9e8cf21..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..830c70718351b0 --- /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'; +}); +``` + +## Compatibilidad con navegadores + +{{Compat("api.Document.getElementsByClassName")}} + +## Especifiación + +- [W3C: getElementsByClassName](https://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-document-getelementsbyclassname) 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 988d91f3a0ea8e..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..a0df6eb639bf4c --- /dev/null +++ b/files/es/web/api/document/getelementsbyname/index.md @@ -0,0 +1,62 @@ +--- +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 + +- [DOM Level 2 HTML: getElementsByName](http://www.w3.org/TR/DOM-Level-2-HTML/) +- [HTML5: getElementsByName](http://www.whatwg.org/html/#dom-document-getelementsbyname) + +## Especificaciones + +| Especificaciones | estado | Comentario | +| ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | ------------------ | +| {{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/getelementsbytagname/index.html b/files/es/web/api/document/getelementsbytagname/index.html deleted file mode 100644 index f2b284bb78550b..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..e7409137c7d536 --- /dev/null +++ b/files/es/web/api/document/getelementsbytagname/index.md @@ -0,0 +1,104 @@ +--- +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](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

      + +
      + +
      + + + + + +``` + +### Especificación + +[DOM Level 2 Core: Document.getElementsByTagName](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-A6C9094) 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 9eadd399dee739..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..88fee83a273402 --- /dev/null +++ b/files/es/web/api/document/getelementsbytagnamens/index.md @@ -0,0 +1,107 @@ +--- +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`](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

      + +
      + +
      + + + + + +``` + +### Especificación + +[DOM Level 2 Core: Document.getElementsByTagNameNS](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-getElBTNNS) diff --git a/files/es/web/api/document/getselection/index.html b/files/es/web/api/document/getselection/index.md similarity index 56% rename from files/es/web/api/document/getselection/index.html rename to files/es/web/api/document/getselection/index.md index 465c75bc53e725..c1125d4df0271f 100644 --- a/files/es/web/api/document/getselection/index.html +++ b/files/es/web/api/document/getselection/index.md @@ -9,6 +9,6 @@ translation_of_original: Web/API/Document/getSelection original_slug: Web/API/DocumentOrShadowRoot/getSelection --- -

      {{APIRef("DOM")}}

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

      +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/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..0e0a54fd438631 --- /dev/null +++ b/files/es/web/api/document/hasfocus/index.md @@ -0,0 +1,24 @@ +--- +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](http://www.whatwg.org/specs/web-apps/current-work/#focus-management) 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 bfeab2f6b012da..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..60ed82ecf5678c --- /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). + +## Compatibilidad con navegadores + +{{Compat("api.Document.head")}} + +## Especificación + +- [HTML5: DOM Tree Accessors](http://www.w3.org/TR/html5/dom.html#dom-tree-accessors) 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 7842de6e441c04..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..40c5d899512203 --- /dev/null +++ b/files/es/web/api/document/hidden/index.md @@ -0,0 +1,33 @@ +--- +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 + +| Especificacion | Estado | Comentario | +| -------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ------------------ | +| {{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/importnode/index.html b/files/es/web/api/document/importnode/index.html deleted file mode 100644 index 63920133fd2e15..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..597331245a8706 --- /dev/null +++ b/files/es/web/api/document/importnode/index.md @@ -0,0 +1,57 @@ +--- +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](http://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 + +| Specification | Status | Comment | +| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------ | +| {{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/open/index.html b/files/es/web/api/document/open/index.html deleted file mode 100644 index 7cd26e29c3cea1..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..8d1370453d7b13 --- /dev/null +++ b/files/es/web/api/document/open/index.md @@ -0,0 +1,92 @@ +--- +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. + +``` +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. + +## Specifications + +| Specification | Status | Comment | +| -------------------------------------------------------------------------------------------- | -------------------------------- | ------- | +| {{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/pointerlockelement/index.html b/files/es/web/api/document/pointerlockelement/index.html deleted file mode 100644 index 1c69bebd8c7082..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..f15316fb499761 --- /dev/null +++ b/files/es/web/api/document/pointerlockelement/index.md @@ -0,0 +1,35 @@ +--- +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 + +| Especificación | Estado | Comentario | +| ---------------------------------------------------------------------------------------------------------------- | -------------------------------- | ---------------------------------- | +| {{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](/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 1ac664123ae52f..00000000000000 --- a/files/es/web/api/document/queryselector/index.html +++ /dev/null @@ -1,89 +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

      - -{{Compat}} - -

      Especificaciones

      - -{{Specifications}} - - -

      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..2477197f28e657 --- /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](http://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`](http://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 3b6cb8d57fee2b..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..fadb263fca6da5 --- /dev/null +++ b/files/es/web/api/document/queryselectorall/index.md @@ -0,0 +1,156 @@ +--- +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 + +| Especificación | Estado | Comentario | +| -------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ------------------- | +| {{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 + +- [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 cee34853b354c2..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..5368b8e6073b6c --- /dev/null +++ b/files/es/web/api/document/readystate/index.md @@ -0,0 +1,87 @@ +--- +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(); + } +} +``` + +## Especificación + +| Especificación | Estado | Comentario | +| ------------------------------------------------------------------------------------------------------------ | -------------------------------- | ----------------------- | +| {{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/registerelement/index.html b/files/es/web/api/document/registerelement/index.html deleted file mode 100644 index 07492a0edfd47a..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..ac84fbdc7451e1 --- /dev/null +++ b/files/es/web/api/document/registerelement/index.md @@ -0,0 +1,58 @@ +--- +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 + +| Especificación | Estado | Comentario | +| ---------------------------------------- | ------------------------------------ | ------------------ | +| {{SpecName('Custom Elements')}} | {{Spec2('Custom Elements')}} | Definición inicial | + +## Compatibilidad del navegador + +{{Compat("api.Document.registerElement")}} + +## 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 f819d1096fe22f..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..50dd92b0e9ef9d --- /dev/null +++ b/files/es/web/api/document/scripts/index.md @@ -0,0 +1,38 @@ +--- +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!"); +} +``` + +## 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/scroll_event/index.html b/files/es/web/api/document/scroll_event/index.html deleted file mode 100644 index a67837d23c0950..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 ---- -

      {{ ApiRef() }}

      -

      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..3ad39209544bb7 --- /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 + +- Especificación + - : [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-scroll), [CSSOM View](http://www.w3.org/TR/cssom-view/#scrolling-0) +- 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). + +## 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](https://github.com/twbs/bootstrap/issues/16202). Safari y WKWebViews no se ven afectados por este bug. 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 25c611cd1aa6d0..00000000000000 --- a/files/es/web/api/document/stylesheets/index.html +++ /dev/null @@ -1,22 +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

      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..1c97f9544fdf4f --- /dev/null +++ b/files/es/web/api/document/stylesheets/index.md @@ -0,0 +1,33 @@ +--- +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 + +``` +styleSheetList = document.styleSheets +``` + +El objeto devuelto es del tipo [StyleSheetList](http://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). + +### Especificación + +[DOM Level 2 Style: styleSheets](http://www.w3.org/TR/DOM-Level-2-Style/stylesheets.html#StyleSheets-DocumentStyle-styleSheets) 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 296927deac5376..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..4431455df6fdae --- /dev/null +++ b/files/es/web/api/document/url/index.md @@ -0,0 +1,56 @@ +--- +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 + +| Especificación | Estado | Comentario | +| ------------------------------------------------------------------------------------------------ | -------------------------------- | ---------------------------------------------------------------------------------------------------------------- | +| {{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/write/index.html b/files/es/web/api/document/write/index.html deleted file mode 100644 index 7ecf8c0b94e878..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..297af150f7920e --- /dev/null +++ b/files/es/web/api/document/write/index.md @@ -0,0 +1,75 @@ +--- +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:** 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](http://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 + +- [DOM Level 2 HTML: `write()` Method](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-75233634) +- [Dynamic markup insertion in HTML](http://www.w3.org/TR/2011/WD-html5-author-20110705/apis-in-html-documents.html#dynamic-markup-insertion) + +## 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 977d526e7773a6..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..3ba16206169315 --- /dev/null +++ b/files/es/web/api/document/writeln/index.md @@ -0,0 +1,38 @@ +--- +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:** 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 + +``` +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](http://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"). + +## Especificación + +[writeln](http://www.w3.org/TR/2000/WD-DOM-Level-2-HTML-20001113/html.html#ID-35318390) From 4a9bd21bc2f1acb1fd7ee0ca016dcc918080fdec Mon Sep 17 00:00:00 2001 From: Craig Blaszczyk Date: Tue, 20 Sep 2022 14:50:28 +0100 Subject: [PATCH 3/4] feat: improve es docs * replace manual "specifications" and "compat" sections with macros * minor text improvements * add missing language indicators to code blocks * replace http links to W3C with https links --- files/es/web/api/document/adoptnode/index.md | 10 +++++----- files/es/web/api/document/alinkcolor/index.md | 18 +++++++++--------- files/es/web/api/document/anchors/index.md | 9 +++++---- files/es/web/api/document/applets/index.md | 16 +++++++++++----- files/es/web/api/document/bgcolor/index.md | 19 ++++++++++++------- files/es/web/api/document/body/index.md | 15 +++++++++------ .../es/web/api/document/characterset/index.md | 17 +++++++++++------ files/es/web/api/document/clear/index.md | 10 +++++++--- files/es/web/api/document/close/index.md | 10 +++++++--- .../es/web/api/document/contenttype/index.md | 11 ++++++++--- files/es/web/api/document/cookie/index.md | 8 ++++++-- .../web/api/document/createattribute/index.md | 12 ++++-------- .../document/createdocumentfragment/index.md | 17 ++++++++++------- .../web/api/document/createelement/index.md | 9 ++++----- .../web/api/document/createelementns/index.md | 12 +++++------- .../es/web/api/document/createevent/index.md | 8 ++++++-- .../es/web/api/document/createrange/index.md | 12 ++++++++---- .../web/api/document/createtextnode/index.md | 8 +++----- .../es/web/api/document/defaultview/index.md | 10 ++++++---- files/es/web/api/document/designmode/index.md | 8 +++----- files/es/web/api/document/dir/index.md | 8 ++++---- files/es/web/api/document/doctype/index.md | 10 +++++----- .../web/api/document/documentelement/index.md | 12 ++++++++---- .../es/web/api/document/documenturi/index.md | 9 +++------ files/es/web/api/document/embeds/index.md | 8 +++----- .../es/web/api/document/execcommand/index.md | 19 ++++++++----------- .../web/api/document/exitfullscreen/index.md | 8 +++----- .../web/api/document/getelementbyid/index.md | 13 ++++--------- .../document/getelementsbyclassname/index.md | 8 ++++---- .../api/document/getelementsbyname/index.md | 10 +++------- .../document/getelementsbytagname/index.md | 10 +++++++--- .../document/getelementsbytagnamens/index.md | 10 +++++++--- .../es/web/api/document/getselection/index.md | 8 ++++++++ files/es/web/api/document/hasfocus/index.md | 10 ++++++---- files/es/web/api/document/head/index.md | 8 ++++---- files/es/web/api/document/hidden/index.md | 8 +++----- files/es/web/api/document/importnode/index.md | 11 ++++------- files/es/web/api/document/open/index.md | 13 +++++-------- .../api/document/pointerlockelement/index.md | 6 ++---- .../web/api/document/queryselector/index.md | 4 ++-- .../api/document/queryselectorall/index.md | 11 +++-------- files/es/web/api/document/readystate/index.md | 11 +++++------ .../web/api/document/registerelement/index.md | 8 +++----- files/es/web/api/document/scripts/index.md | 10 ++++------ .../es/web/api/document/scroll_event/index.md | 10 +++++----- .../es/web/api/document/stylesheets/index.md | 12 ++++++++---- files/es/web/api/document/url/index.md | 9 +++------ files/es/web/api/document/write/index.md | 10 ++++++---- files/es/web/api/document/writeln/index.md | 14 +++++++++----- 49 files changed, 278 insertions(+), 249 deletions(-) diff --git a/files/es/web/api/document/adoptnode/index.md b/files/es/web/api/document/adoptnode/index.md index 72b4a24499287d..3e71e29c510a29 100644 --- a/files/es/web/api/document/adoptnode/index.md +++ b/files/es/web/api/document/adoptnode/index.md @@ -38,17 +38,17 @@ iframeImages.forEach(function(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](http://www.w3.org/DOM/faq.html#ownerdoc). +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. -## Epecificación +## Especificaciones -- [DOM Level 3 Core: Document.adoptNode](http://www.w3.org/TR/DOM-Level-3-Core/core.html#Document3-adoptNode) +{{Specifications}} -## Compatibilidad con navegadores +## Compatibilidad del Navegador -{{Compat("api.Document.adoptNode")}} +{{Compat}} ## Vea también diff --git a/files/es/web/api/document/alinkcolor/index.md b/files/es/web/api/document/alinkcolor/index.md index 49eccdba94c63d..5f38b11b2dc378 100644 --- a/files/es/web/api/document/alinkcolor/index.md +++ b/files/es/web/api/document/alinkcolor/index.md @@ -3,15 +3,13 @@ title: document.alinkColor slug: Web/API/Document/alinkColor translation_of: Web/API/Document/alinkColor --- -{{APIRef("DOM")}} - -> **Advertencia:** **Desaprobado** +{{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 ``` @@ -22,14 +20,16 @@ document.alinkColor =color El valor por defecto de esta propiedad en Mozilla es rojo (`#ee0000` en hexadecimal). -`document.alinkColor` es obsoleto en [DOM Level 2 HTML](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-26809268). Una alternativa es el selector CSS {{ Cssxref(":active") }}. +`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](http://www.w3.org/TR/html401/struct/global.html#adef-alink) a favor de la alternativa CSS. +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`. -## Especificación +## Especificaciones + +{{Specifications}} -DOM Nivel 0. No es parte de ningún estándar. +## Compatibilidad del Navegador -[MSDN: alinkColor property](http://msdn.microsoft.com/workshop/author/dhtml/reference/properties/alinkcolor.asp) +{{Compat}} diff --git a/files/es/web/api/document/anchors/index.md b/files/es/web/api/document/anchors/index.md index 44c85a5da221c2..beff960ff1d661 100644 --- a/files/es/web/api/document/anchors/index.md +++ b/files/es/web/api/document/anchors/index.md @@ -24,7 +24,7 @@ Una {{domxref("HTMLCollection")}}. ## Ejemplo -``` +```js if ( document.anchors.length >= 5 ) { dump("dump found too many anchors"); window.location = "http://www.google.com"; @@ -86,8 +86,9 @@ Por razones de retrocompatibilidad, el conjunto de anclas devuelto sólo contien ## Especificaciones -[DOM Level 2 HTML: anchors](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-7577272) +{{Specifications}} + +## Compatibilidad del Navegador -## Compatibilidad de navegadores +{{Compat}} -{{Compat("api.Document.anchors")}} diff --git a/files/es/web/api/document/applets/index.md b/files/es/web/api/document/applets/index.md index b341c67aa05b98..27cfd480c53b15 100644 --- a/files/es/web/api/document/applets/index.md +++ b/files/es/web/api/document/applets/index.md @@ -3,7 +3,7 @@ title: document.applets slug: Web/API/Document/applets translation_of: Web/API/Document/applets --- -{{APIRef("DOM")}} +{{APIRef("DOM")}}{{ Deprecated_header() }} ### Resumen @@ -13,17 +13,23 @@ del documento. ### Sintaxis -``` +```js nodeList = document.applets ``` ### Ejemplo -``` +```js // ( Cuando sabes que el segundoapplet es el que quieres ) my_java_app = document.applets[1]; ``` -### Especificación -[DOM Level 2 HTML: applets](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-85113862) +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + diff --git a/files/es/web/api/document/bgcolor/index.md b/files/es/web/api/document/bgcolor/index.md index d4ffac75218918..86c0d145866c40 100644 --- a/files/es/web/api/document/bgcolor/index.md +++ b/files/es/web/api/document/bgcolor/index.md @@ -9,7 +9,7 @@ translation_of: Web/API/Document/bgColor ### Sintaxis -``` +```js color = document.bgColor document.bgColor = color @@ -21,17 +21,22 @@ color ### Ejemplos -``` -# document.bgColor = "darkblue"; -# document.bgColor = "#ff00ff"; +```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](http://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. +`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}} -### Especificación +## Compatibilidad del Navegador -DOM Nivel 0. No es parte de ningún estándar. +{{Compat}} diff --git a/files/es/web/api/document/body/index.md b/files/es/web/api/document/body/index.md index 59572157ac811b..5dbe442d853305 100644 --- a/files/es/web/api/document/body/index.md +++ b/files/es/web/api/document/body/index.md @@ -11,15 +11,14 @@ Devuelve el nodo del `` o el nodo del `` del documento. ### Sintaxis -``` +```js objRef = document.body -document.body = -objRef +document.body = objRef ``` ### Ejemplo -``` +```js // en HTML: alert(document.body.id); // "oldBodyElement" var aNewBodyElement = document.createElement("body"); @@ -34,6 +33,10 @@ alert(document.body.id); // "newBodyElement" Aunque `body` es programable, colocando un nuevo cuerpo en un documento efectivamente quitará a todos los hijos actuales del elemento existente ``. -### Especificación +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador -[DOM Level 2 HTML: HTMLDocument.body](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-56360201) +{{Compat}} diff --git a/files/es/web/api/document/characterset/index.md b/files/es/web/api/document/characterset/index.md index 1be36b819bbf78..44c0199e2ccd76 100644 --- a/files/es/web/api/document/characterset/index.md +++ b/files/es/web/api/document/characterset/index.md @@ -11,15 +11,16 @@ Devuelve la codificación de caracteres (conjunto de caracteres) usado en el doc ### Sintaxis -``` +```js string = document.characterSet ``` ### Ejemplo -``` - +```html + // devuelve el conjunto de caracteres del documento, por ejemplo "ISO-8859-1 o UTF-8" ``` @@ -29,6 +30,10 @@ La codificación de caracteres es el conjunto de caracteres usados para interpre Para una lista completa de juegos/conjuntos de caracteres, visite: . -### Especificación +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador -DOM Nivel 0. No es parte de ningún estándar. +{{Compat}} diff --git a/files/es/web/api/document/clear/index.md b/files/es/web/api/document/clear/index.md index dbfe95ef30cd4c..d0d037ed76f791 100644 --- a/files/es/web/api/document/clear/index.md +++ b/files/es/web/api/document/clear/index.md @@ -21,10 +21,14 @@ No hace nada en versiones más recientes basado en Mozilla así como en Internet ## Síntaxis -``` +```js document.clear() ``` -## Especificación +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador -- [HTML5](http://www.whatwg.org/html/#dom-document-clear) +{{Compat}} diff --git a/files/es/web/api/document/close/index.md b/files/es/web/api/document/close/index.md index 464fcc44d912e9..1d46d2d9f5812f 100644 --- a/files/es/web/api/document/close/index.md +++ b/files/es/web/api/document/close/index.md @@ -9,7 +9,7 @@ El método `document.close()` finaliza la escritura de un documento abierta con ## Sintaxis -``` +```js document.close(); ``` @@ -24,6 +24,10 @@ document.write("

      El único contenido.

      "); document.close(); ``` -## Especificación +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador -[DOM Level 2 HTML: `close()` Method](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-98948567) +{{Compat}} diff --git a/files/es/web/api/document/contenttype/index.md b/files/es/web/api/document/contenttype/index.md index 3290f751365e80..fdffa57751c2ca 100644 --- a/files/es/web/api/document/contenttype/index.md +++ b/files/es/web/api/document/contenttype/index.md @@ -3,13 +3,13 @@ title: Document.contentType slug: Web/API/Document/contentType translation_of: Web/API/Document/contentType --- -{{ ApiRef("DOM") }}{{Non-standard_header}} +{{ 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; ``` @@ -19,6 +19,11 @@ contentType = document.contentType; Esta propiedad no es afectada por los tags meta. + ## Especificaciones -No estándar, sólo soportada por [Gecko](/en/Gecko "en/Gecko"). +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/cookie/index.md b/files/es/web/api/document/cookie/index.md index 6c46b18ee88c94..a6a9b36e453b9f 100644 --- a/files/es/web/api/document/cookie/index.md +++ b/files/es/web/api/document/cookie/index.md @@ -118,6 +118,10 @@ Es importante mencionar que la restricción path no protege contra la lectura no - 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. -### Especificación +## Especificaciones -[DOM Level 2: HTMLDocument.cookie](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-8747038) +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/createattribute/index.md b/files/es/web/api/document/createattribute/index.md index 1900d17a7755c2..4746ec5c387d85 100644 --- a/files/es/web/api/document/createattribute/index.md +++ b/files/es/web/api/document/createattribute/index.md @@ -45,16 +45,12 @@ console.log(nodo.getAttribute("miAtributo")); // "nuevoVal" ## Especificaciones -| Especificación | Estatus | Comentario | -| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------------------------------- | -| {{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 | +{{Specifications}} -## Compatibilidad del buscador +## Compatibilidad del Navegador + +{{Compat}} -{{Compat("api.Document.createAttribute")}} ## Ver ademas diff --git a/files/es/web/api/document/createdocumentfragment/index.md b/files/es/web/api/document/createdocumentfragment/index.md index 812ffcef96034b..3256ce19ed1f5c 100644 --- a/files/es/web/api/document/createdocumentfragment/index.md +++ b/files/es/web/api/document/createdocumentfragment/index.md @@ -33,14 +33,14 @@ Este ejemplo crea una lista de los principales navegadores web en un _DocumentFr HTML -``` +```html
      ``` JavaScript -``` +```js var element = document.getElementById('ul'); // assuming ul exists var fragment = document.createDocumentFragment(); var browsers = ['Firefox', 'Chrome', 'Opera', @@ -59,14 +59,17 @@ Resultado {{EmbedLiveSample("Example", 600, 140)}} -## Compatibilidad de navegadores +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador -{{Compat("api.Document.createDocumentFragment")}} +{{Compat}} -## Especificaciónes +## Compatibilidad del Navegador -- DOM Level 2: [createDocumentFragment](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-35CB04B5) -- DOM Level 3: [createDocumentFragment](http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-35CB04B5) +{{Compat}} ## Vea También diff --git a/files/es/web/api/document/createelement/index.md b/files/es/web/api/document/createelement/index.md index 7ccb0cc88b354b..dfc77f67278423 100644 --- a/files/es/web/api/document/createelement/index.md +++ b/files/es/web/api/document/createelement/index.md @@ -75,13 +75,12 @@ function addElement () { ## Especificaciones -| Especificación | Estado | Comentario | -| ---------------------------------------------------------------------------------------------------------------- | -------------------------------- | ---------- | -| {{SpecName('DOM WHATWG', "#dom-document-createelement", "Document.createElement")}} | {{Spec2('DOM WHATWG')}} | | +{{Specifications}} -## Compatibilidad con navegadores +## Compatibilidad del Navegador + +{{Compat}} -{{Compat("api.Document.createElement")}} ## Ver también diff --git a/files/es/web/api/document/createelementns/index.md b/files/es/web/api/document/createelementns/index.md index 72af2dc5cb2f07..dafafdfc43eaa3 100644 --- a/files/es/web/api/document/createelementns/index.md +++ b/files/es/web/api/document/createelementns/index.md @@ -18,7 +18,7 @@ var element = document.createElementNS(namespaceURI, qualifiedName[, options]); ### Parámetros - `namespaceURI` - - : _String_ que especifica el [namespace URI](http://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). + - : _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}} @@ -77,17 +77,15 @@ El código siguiente crea un elemento \
      nuevo en el namespace [XHTML](/es/d ## Especificaciones -| Especificación | Estatus | Comentario | -| ---------------------------------------------------------------------------------------------------------------- | -------------------------------- | ---------- | -| {{SpecName('DOM WHATWG', "#dom-document-createelementns", "Document.createElement")}} | {{Spec2('DOM WHATWG')}} | | +{{Specifications}} -## Compatibilidad con navegadores +## Compatibilidad del Navegador -{{Compat("api.Document.createElementNS")}} +{{Compat}} ## Ver también - [document.createElement](createElement) - [document.createTextNode](createTextNode) - [Node.namespaceURI](../Node/namespaceURI) -- [Namespaces in XML](http://www.w3.org/TR/1999/REC-xml-names-19990114) +- [Namespaces in XML](https://www.w3.org/TR/1999/REC-xml-names-19990114) diff --git a/files/es/web/api/document/createevent/index.md b/files/es/web/api/document/createevent/index.md index 2c0df9839d3cac..f193e41b432878 100644 --- a/files/es/web/api/document/createevent/index.md +++ b/files/es/web/api/document/createevent/index.md @@ -31,6 +31,10 @@ Este método devuelve un nuevo objeto {{ domxref("Event") }} del DOM del tipo in var nuevoEvento = document.createEvent("UIEvents"); ``` -### Especificación +## Especificaciones -- [DOM Level 2 Events](http://www.w3.org/TR/DOM-Level-2-Events/events.html#Events-document) +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/createrange/index.md b/files/es/web/api/document/createrange/index.md index 65c811d9ba78b5..e51a3ea8928dd7 100644 --- a/files/es/web/api/document/createrange/index.md +++ b/files/es/web/api/document/createrange/index.md @@ -15,7 +15,7 @@ Retorna un nuevo objeto [`Rango`](https://developer.mozilla.org/es/docs/Web/API/ ### Sintáxis -``` +```js range = document.createRange(); ``` @@ -23,7 +23,7 @@ En este ejemplo, `range` es el nuevo objeto [rango](/es/docs/Web/API/Range) crea ### Ejemplo -``` +```js var range = document.createRange(); range.setStart(startNode, startOffset); range.setEnd(endNode, endOffset); @@ -33,6 +33,10 @@ range.setEnd(endNode, endOffset); 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 +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador -[DOM Level 2 Range: DocumentRange.createRange](http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level2-DocumentRange-method-createRange) +{{Compat}} diff --git a/files/es/web/api/document/createtextnode/index.md b/files/es/web/api/document/createtextnode/index.md index 7c4dd0b7670a64..bced3fe3a42c4d 100644 --- a/files/es/web/api/document/createtextnode/index.md +++ b/files/es/web/api/document/createtextnode/index.md @@ -54,10 +54,8 @@ function addTextNode(text) { ## Especificaciones -| Especificación | Estado | Comentario | -| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ---------- | -| {{SpecName('DOM WHATWG', '#dom-document-createtextnode', 'Document: createTextNode')}} | {{Spec2('DOM WHATWG')}} | | +{{Specifications}} -## Compatibilidad con navegadores +## Compatibilidad del Navegador -{{Compat("api.Document.createTextNode")}} +{{Compat}} diff --git a/files/es/web/api/document/defaultview/index.md b/files/es/web/api/document/defaultview/index.md index 618b9c03e2a1e4..83cc8f66ac2710 100644 --- a/files/es/web/api/document/defaultview/index.md +++ b/files/es/web/api/document/defaultview/index.md @@ -28,8 +28,10 @@ Esta propiedad es de solo lectura. De acuerco con [quirksmode](http://www.quirksmode.org/dom/w3c_html.html), `defaultView` no está soportado en IE hasta su version 9. -## Especificación +## Especificaciones -- [HTML5: defaultView](/es/docs/HTML/HTML5 "HTML/HTML5") -- [DOM Level 2 Views: defaultView](http://www.w3.org/TR/DOM-Level-2-Views/views.html#Views-DocumentView-defaultView) -- [DOM Level 3 Views](http://www.w3.org/TR/DOM-Level-3-Views/) (Actualmente en desarrolo como "Working Group Note" en W3C y aún no está implementado) +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/designmode/index.md b/files/es/web/api/document/designmode/index.md index 26fce879cbe682..3988ea8f0d9a48 100644 --- a/files/es/web/api/document/designmode/index.md +++ b/files/es/web/api/document/designmode/index.md @@ -31,13 +31,11 @@ iframeNode.contentDocument.designMode = "on"; ## Especificaciones -| Especificación | Estado | Comentario | -| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- | ------------------- | -| {{SpecName('HTML WHATWG', '#making-entire-documents-editable:-the-designmode-idl-attribute', 'designMode')}} | {{Spec2('HTML WHATWG')}} | Definición inicial. | +{{Specifications}} -## Compatibilidad de Navegadores +## Compatibilidad del Navegador -{{Compat("api.Document.designMode")}} +{{Compat}} ## Ver también diff --git a/files/es/web/api/document/dir/index.md b/files/es/web/api/document/dir/index.md index 55fa135e557f09..c29ec71c2d1751 100644 --- a/files/es/web/api/document/dir/index.md +++ b/files/es/web/api/document/dir/index.md @@ -3,7 +3,7 @@ title: Document.dir slug: Web/API/Document/dir translation_of: Web/API/Document/dir --- -{{ApiRef("")}}{{non-standard_header}} +{{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). @@ -16,11 +16,11 @@ document.dir = dirStr; ## Especificaciones -HTML5 WHATWG +{{Specifications}} -## Compatibilidad de Navegadores +## Compatibilidad del Navegador -{{Compat("api.Document.dir")}} +{{Compat}} ## Véase también diff --git a/files/es/web/api/document/doctype/index.md b/files/es/web/api/document/doctype/index.md index e3eb9910dee132..6cce623218faab 100644 --- a/files/es/web/api/document/doctype/index.md +++ b/files/es/web/api/document/doctype/index.md @@ -40,10 +40,10 @@ console.log( 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ón | Estado | Comentario | -| ------------------------------------------------------------------------------------------------ | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -| {{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 | +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/documentelement/index.md b/files/es/web/api/document/documentelement/index.md index 2dc529c7a2dab1..812e747eb8898c 100644 --- a/files/es/web/api/document/documentelement/index.md +++ b/files/es/web/api/document/documentelement/index.md @@ -15,13 +15,13 @@ Devuelve el [`Element`](es/DOM/element) que es el elemento raíz de [document](e ### 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 @@ -39,6 +39,10 @@ Los documentos HTML contienen normalmente un único hijo directo, ``, quiz Por tanto, deberías usar `document.documentElement` en lugar de {{ Domxref("document.firstChild") }} para obtener el elemento raíz. -### Especificación +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador -[DOM Level 2 Core: Document.documentElement](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-87CD092) +{{Compat}} diff --git a/files/es/web/api/document/documenturi/index.md b/files/es/web/api/document/documenturi/index.md index 27160ae7909d06..15ad93c30f1100 100644 --- a/files/es/web/api/document/documenturi/index.md +++ b/files/es/web/api/document/documenturi/index.md @@ -29,11 +29,8 @@ Los documentos HTML tienen una propiedad {{domxref("document.URL")}} la cual dev ## Especificaciones -| Especificación | Estado | Comentario | -| ---------------------------------------------------------------------------------------- | ---------------------------- | ------------------ | -| {{SpecName('DOM4', '#dom-document-documenturi','documentURI')}} | {{Spec2('DOM4')}} | | -| {{SpecName('DOM3 Core', '#Document3-documentURI', 'documentURI')}} | {{Spec2('DOM3 Core')}} | Definición inicial | +{{Specifications}} -## Compatibilidad de navegadores +## Compatibilidad del Navegador -{{Compat("api.Document.documentURI")}} +{{Compat}} diff --git a/files/es/web/api/document/embeds/index.md b/files/es/web/api/document/embeds/index.md index 6b950fc1966373..c5dd5e9ce29640 100644 --- a/files/es/web/api/document/embeds/index.md +++ b/files/es/web/api/document/embeds/index.md @@ -25,10 +25,8 @@ Una {{domxref("HTMLCollection")}}. ## Especificaciones -| Especificación | Estado | Comentario | -| -------------------------------------------------------------------------------------------- | ------------------------------------ | ---------- | -| {{SpecName('HTML WHATWG', '#dom-document-embeds', 'Document.embeds')}} | {{ Spec2('HTML WHATWG') }} | | +{{Specifications}} -## Compatibilidad con Navegadores +## Compatibilidad del Navegador -{{Compat("api.Document.embeds")}} +{{Compat}} diff --git a/files/es/web/api/document/execcommand/index.md b/files/es/web/api/document/execcommand/index.md index 4c2f5f43853cb3..9e175247471aa3 100644 --- a/files/es/web/api/document/execcommand/index.md +++ b/files/es/web/api/document/execcommand/index.md @@ -10,7 +10,7 @@ tags: - editor translation_of: Web/API/Document/execCommand --- -{{ApiRef("DOM")}} +{{ApiRef("DOM")}}{{ Deprecated_header() }} ## Resumen @@ -24,11 +24,11 @@ execCommand(aCommandName, aShowDefaultUI, aValueArgument) ### Parámetros -- aCommandName +- `aCommandName` - : Una {{domxref("DOMString")}} que especifica el nombre del comando a ejecutar. Vea [Comandos](#comandos) para una lista de posibles comandos. -- aShowDefaultUI +- `aShowDefaultUI` - : Un {{jsxref("Boolean")}} que indica si la interfaz de usuario por defecto se debe mostrar. Esto no se ha implementado en Mozilla. -- aValueArgument +- `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 @@ -128,16 +128,13 @@ execCommand(aCommandName, aShowDefaultUI, aValueArgument) (Este artículo está actualmente incompleto y carece de un ejemplo.) -## Compatibilidad del navegador +## Especificaciones -{{Compat("api.Document.execCommand")}} +{{Specifications}} -## Especificación - -| Especificación | Estado | Comentario | -| -------------------------------------------------------------------------------- | -------------------------------- | ---------- | -| {{SpecName('HTML Editing','#execcommand()','execCommand')}} | {{Spec2('HTML Editing')}} | | +## Compatibilidad del Navegador +{{Compat}} ## Vea también - {{domxref("document.contentEditable")}} diff --git a/files/es/web/api/document/exitfullscreen/index.md b/files/es/web/api/document/exitfullscreen/index.md index b65d5a35858f55..820d70471a8b7c 100644 --- a/files/es/web/api/document/exitfullscreen/index.md +++ b/files/es/web/api/document/exitfullscreen/index.md @@ -41,13 +41,11 @@ document.onclick = function (event) { ## Especificaciones -| Especificación | Estado | Comentarios | -| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------ | -| {{SpecName("Fullscreen", "#dom-document-exitfullscreen", "Document.exitFullscreen()")}} | {{Spec2("Fullscreen")}} | Definición inicial | +{{Specifications}} -## Compatibilidad del navegador +## Compatibilidad del Navegador -{{Compat("api.Document.exitFullscreen")}} +{{Compat}} ## Ver también diff --git a/files/es/web/api/document/getelementbyid/index.md b/files/es/web/api/document/getelementbyid/index.md index 19673b891e8d65..bdacd0b824bcc4 100644 --- a/files/es/web/api/document/getelementbyid/index.md +++ b/files/es/web/api/document/getelementbyid/index.md @@ -106,18 +106,13 @@ 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. -## Especificación +## Especificaciones -| Especificación | Status | Comentarios | -| ------------------------------------------------------------------------------------------------------------ | -------------------------------- | ------------------------------------ | -| {{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 | +{{Specifications}} -## Compatibilidad con navegadores +## Compatibilidad del Navegador -{{Compat("api.Document.getElementById")}} +{{Compat}} ## Ver también diff --git a/files/es/web/api/document/getelementsbyclassname/index.md b/files/es/web/api/document/getelementsbyclassname/index.md index 830c70718351b0..590b4239b025d8 100644 --- a/files/es/web/api/document/getelementsbyclassname/index.md +++ b/files/es/web/api/document/getelementsbyclassname/index.md @@ -47,10 +47,10 @@ var testDivs = Array.prototype.filter.call(testElements, function(testElement){ }); ``` -## Compatibilidad con navegadores +## Especificaciones -{{Compat("api.Document.getElementsByClassName")}} +{{Specifications}} -## Especifiación +## Compatibilidad del Navegador -- [W3C: getElementsByClassName](https://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-document-getelementsbyclassname) +{{Compat}} diff --git a/files/es/web/api/document/getelementsbyname/index.md b/files/es/web/api/document/getelementsbyname/index.md index a0df6eb639bf4c..11f0bd2b7d157b 100644 --- a/files/es/web/api/document/getelementsbyname/index.md +++ b/files/es/web/api/document/getelementsbyname/index.md @@ -45,15 +45,11 @@ El método **getElementsByName** trabaja de diferente manera en diferentes naveg ## Especificaciones -- [DOM Level 2 HTML: getElementsByName](http://www.w3.org/TR/DOM-Level-2-HTML/) -- [HTML5: getElementsByName](http://www.whatwg.org/html/#dom-document-getelementsbyname) +{{Specifications}} -## Especificaciones +## Compatibilidad del Navegador -| Especificaciones | estado | Comentario | -| ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | ------------------ | -| {{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 | +{{Compat}} ## Mira también diff --git a/files/es/web/api/document/getelementsbytagname/index.md b/files/es/web/api/document/getelementsbytagname/index.md index e7409137c7d536..1fad566a88c1f5 100644 --- a/files/es/web/api/document/getelementsbytagname/index.md +++ b/files/es/web/api/document/getelementsbytagname/index.md @@ -13,7 +13,7 @@ Devuelve una lista de elementos con un nombre determinado. Se busca en todo el d ### Sintaxis -``` +```js elements = document.getElementsByTagName(name) ``` @@ -99,6 +99,10 @@ function div2ParaElems() ``` -### Especificación +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador -[DOM Level 2 Core: Document.getElementsByTagName](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-A6C9094) +{{Compat}} diff --git a/files/es/web/api/document/getelementsbytagnamens/index.md b/files/es/web/api/document/getelementsbytagnamens/index.md index 88fee83a273402..8e7cc50d72445c 100644 --- a/files/es/web/api/document/getelementsbytagnamens/index.md +++ b/files/es/web/api/document/getelementsbytagnamens/index.md @@ -13,7 +13,7 @@ Devuelve una lista de elementos cuyo nombre pertenece a un determinado 'namespac ### Sintaxis -``` +```js elements = document.getElementsByTagNameNS(namespace,name) ``` @@ -102,6 +102,10 @@ function div2ParaElems() ``` -### Especificación +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador -[DOM Level 2 Core: Document.getElementsByTagNameNS](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-getElBTNNS) +{{Compat}} diff --git a/files/es/web/api/document/getselection/index.md b/files/es/web/api/document/getselection/index.md index c1125d4df0271f..452c4562d76f82 100644 --- a/files/es/web/api/document/getselection/index.md +++ b/files/es/web/api/document/getselection/index.md @@ -12,3 +12,11 @@ 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.md b/files/es/web/api/document/hasfocus/index.md index 0e0a54fd438631..7c68c9f5be9bf4 100644 --- a/files/es/web/api/document/hasfocus/index.md +++ b/files/es/web/api/document/hasfocus/index.md @@ -13,12 +13,14 @@ El atributo `hasFocus` devuelve `true` si el foco está en en algún sitio del d ### Sintaxis -``` +```js focused = element.hasFocus ``` -### Ejemplo +## Especificaciones + +{{Specifications}} -### Especificación +## Compatibilidad del Navegador -[Focus management](http://www.whatwg.org/specs/web-apps/current-work/#focus-management) +{{Compat}} diff --git a/files/es/web/api/document/head/index.md b/files/es/web/api/document/head/index.md index 60ed82ecf5678c..62708edfe43981 100644 --- a/files/es/web/api/document/head/index.md +++ b/files/es/web/api/document/head/index.md @@ -28,10 +28,10 @@ alert( document.head === document.querySelector("head") ); // true `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). -## Compatibilidad con navegadores +## Especificaciones -{{Compat("api.Document.head")}} +{{Specifications}} -## Especificación +## Compatibilidad del Navegador -- [HTML5: DOM Tree Accessors](http://www.w3.org/TR/html5/dom.html#dom-tree-accessors) +{{Compat}} diff --git a/files/es/web/api/document/hidden/index.md b/files/es/web/api/document/hidden/index.md index 40c5d899512203..32100b47e20d82 100644 --- a/files/es/web/api/document/hidden/index.md +++ b/files/es/web/api/document/hidden/index.md @@ -24,10 +24,8 @@ document.addEventListener("visibilitychange", function() { ## Especificaciones -| Especificacion | Estado | Comentario | -| -------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ------------------ | -| {{SpecName('Page Visibility API','#dom-document-hidden', 'Document.hidden')}} | {{Spec2('Page Visibility API')}} | definicion inicial | +{{Specifications}} -## Compatibilidad con Navegadores +## Compatibilidad del Navegador -{{Compat("api.Document.hidden")}} +{{Compat}} diff --git a/files/es/web/api/document/importnode/index.md b/files/es/web/api/document/importnode/index.md index 597331245a8706..676d5dee0dd2d4 100644 --- a/files/es/web/api/document/importnode/index.md +++ b/files/es/web/api/document/importnode/index.md @@ -37,20 +37,17 @@ document.getElementById("container").appendChild(newNode); 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](http://www.w3.org/DOM/faq.html#ownerdoc). +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 -| Specification | Status | Comment | -| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------ | -| {{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 | +{{Specifications}} -## Compatibilidad navegadores +## Compatibilidad del Navegador -{{Compat("api.Document.importNode")}} +{{Compat}} ## See also diff --git a/files/es/web/api/document/open/index.md b/files/es/web/api/document/open/index.md index 8d1370453d7b13..d0a52daea2003c 100644 --- a/files/es/web/api/document/open/index.md +++ b/files/es/web/api/document/open/index.md @@ -31,7 +31,7 @@ Una instancia del objeto Document (`Document)`. 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

      "); @@ -75,16 +75,13 @@ Where `type` specified the MIME type of the data you are writing (e.g. `text/htm 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 +## Especificaciones -| Specification | Status | Comment | -| -------------------------------------------------------------------------------------------- | -------------------------------- | ------- | -| {{SpecName("HTML WHATWG", "#dom-document-open", "document.open()")}} | {{Spec2("HTML WHATWG")}} | | -| {{SpecName("DOM2 HTML", "html.html#ID-72161170", "document.open()")}} | {{Spec2("DOM2 HTML")}} | | +{{Specifications}} -## Browser compatibility +## Compatibilidad del Navegador -{{Compat("api.Document.open")}} +{{Compat}} ## See also diff --git a/files/es/web/api/document/pointerlockelement/index.md b/files/es/web/api/document/pointerlockelement/index.md index f15316fb499761..cf37672557a396 100644 --- a/files/es/web/api/document/pointerlockelement/index.md +++ b/files/es/web/api/document/pointerlockelement/index.md @@ -20,13 +20,11 @@ Un {{domxref("Element")}} o `null`. ## Especificaciones -| Especificación | Estado | Comentario | -| ---------------------------------------------------------------------------------------------------------------- | -------------------------------- | ---------------------------------- | -| {{SpecName('Bloquear puntero','l#extension-to-the-document-interface','Document')}} | {{Spec2('Pointer lock')}} | Extiende de la interfaz `Document` | +{{Specifications}} ## Compatibilidad del Navegador -{{Compat("api.Document.pointerLockElement")}} +{{Compat}} ## Véase también: diff --git a/files/es/web/api/document/queryselector/index.md b/files/es/web/api/document/queryselector/index.md index 2477197f28e657..d33d106f9a087e 100644 --- a/files/es/web/api/document/queryselector/index.md +++ b/files/es/web/api/document/queryselector/index.md @@ -45,9 +45,9 @@ var el = document.querySelector("div.user-panel.main input[name='login']"); - 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](http://www.w3.org/TR/selectors-api/). +- 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`](http://www.w3.org/TR/selectors-api/#grammar). +- 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 diff --git a/files/es/web/api/document/queryselectorall/index.md b/files/es/web/api/document/queryselectorall/index.md index fadb263fca6da5..af5b7021067e92 100644 --- a/files/es/web/api/document/queryselectorall/index.md +++ b/files/es/web/api/document/queryselectorall/index.md @@ -133,16 +133,11 @@ inner.length; // 0 ## Especificaciones -| Especificación | Estado | Comentario | -| -------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ------------------- | -| {{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 | +{{Specifications}} -## Compatibilidad en navegadores +## Compatibilidad del Navegador -{{Compat("api.Document.querySelectorAll")}} +{{Compat}} ## Ver también diff --git a/files/es/web/api/document/readystate/index.md b/files/es/web/api/document/readystate/index.md index 5368b8e6073b6c..c310be799a4612 100644 --- a/files/es/web/api/document/readystate/index.md +++ b/files/es/web/api/document/readystate/index.md @@ -72,14 +72,13 @@ document.onreadystatechange = function () { } ``` -## Especificación +## Especificaciones -| Especificación | Estado | Comentario | -| ------------------------------------------------------------------------------------------------------------ | -------------------------------- | ----------------------- | -| {{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. | +{{Specifications}} +## Compatibilidad del Navegador + +{{Compat}} ## Ver también - Evento {{event("readystatechange")}} diff --git a/files/es/web/api/document/registerelement/index.md b/files/es/web/api/document/registerelement/index.md index ac84fbdc7451e1..f411144d2c81fe 100644 --- a/files/es/web/api/document/registerelement/index.md +++ b/files/es/web/api/document/registerelement/index.md @@ -45,13 +45,11 @@ mytag.textContent = "I am a my-tag element."; ## Especificaciones -| Especificación | Estado | Comentario | -| ---------------------------------------- | ------------------------------------ | ------------------ | -| {{SpecName('Custom Elements')}} | {{Spec2('Custom Elements')}} | Definición inicial | +{{Specifications}} -## Compatibilidad del navegador +## Compatibilidad del Navegador -{{Compat("api.Document.registerElement")}} +{{Compat}} ## Ver también diff --git a/files/es/web/api/document/scripts/index.md b/files/es/web/api/document/scripts/index.md index 50dd92b0e9ef9d..a7ca79b5345607 100644 --- a/files/es/web/api/document/scripts/index.md +++ b/files/es/web/api/document/scripts/index.md @@ -27,12 +27,10 @@ if (scripts.length) { } ``` -## Compatibilidad de navegadores - -{{Compat("api.Document.scripts")}} +## Especificaciones -## +{{Specifications}} -## Especificaciones +## Compatibilidad del Navegador -- {{spec("http://www.whatwg.org/specs/web-apps/current-work/multipage/dom.html#dom-document-scripts", "DOM: document scripts")}} +{{Compat}} diff --git a/files/es/web/api/document/scroll_event/index.md b/files/es/web/api/document/scroll_event/index.md index 3ad39209544bb7..650d8a8c505ac6 100644 --- a/files/es/web/api/document/scroll_event/index.md +++ b/files/es/web/api/document/scroll_event/index.md @@ -9,8 +9,6 @@ El evento **`scroll`** se produce cuando la vista del documento o un elemento es ## Información General -- Especificación - - : [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-scroll), [CSSOM View](http://www.w3.org/TR/cssom-view/#scrolling-0) - Interfaz - : UIEvent - Bubbles @@ -63,8 +61,10 @@ window.addEventListener('scroll', function(e) { Más ejemplos se pueden ver en el evento [resize](/es/docs/Web/Events/resize#Example). -## Compatibilidad en navegadores +## Especificaciones -### iOS UIWebView +{{Specifications}} -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](https://github.com/twbs/bootstrap/issues/16202). Safari y WKWebViews no se ven afectados por este bug. +## Compatibilidad del Navegador + +{{Compat}} diff --git a/files/es/web/api/document/stylesheets/index.md b/files/es/web/api/document/stylesheets/index.md index 1c97f9544fdf4f..f504b11609f332 100644 --- a/files/es/web/api/document/stylesheets/index.md +++ b/files/es/web/api/document/stylesheets/index.md @@ -17,17 +17,21 @@ Devuelve una lista de objetos de tipo [stylesheet](/es/DOM/stylesheet "es/DOM/st ### Sintaxis -``` +```js styleSheetList = document.styleSheets ``` -El objeto devuelto es del tipo [StyleSheetList](http://www.w3.org/TR/DOM-Level-2-Style/stylesheets.html#StyleSheets-DocumentStyle-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). -### Especificación +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador -[DOM Level 2 Style: styleSheets](http://www.w3.org/TR/DOM-Level-2-Style/stylesheets.html#StyleSheets-DocumentStyle-styleSheets) +{{Compat}} diff --git a/files/es/web/api/document/url/index.md b/files/es/web/api/document/url/index.md index 4431455df6fdae..7bb5ba89b3521e 100644 --- a/files/es/web/api/document/url/index.md +++ b/files/es/web/api/document/url/index.md @@ -42,14 +42,11 @@ document.getElementById("url").textContent = document.URL; ## Especificaciones -| Especificación | Estado | Comentario | -| ------------------------------------------------------------------------------------------------ | -------------------------------- | ---------------------------------------------------------------------------------------------------------------- | -| {{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 | +{{Specifications}} -## Compatibilidad con navegadores +## Compatibilidad del Navegador -{{Compat("api.Document.URL")}} +{{Compat}} ## Ver también diff --git a/files/es/web/api/document/write/index.md b/files/es/web/api/document/write/index.md index 297af150f7920e..0b7ab19f099ed4 100644 --- a/files/es/web/api/document/write/index.md +++ b/files/es/web/api/document/write/index.md @@ -21,7 +21,7 @@ Escribe una cadena de texto dentro del hilo de un `document `abierto por [docume document.write(texto); ``` -`texto `es una cadena de texto que contiene el texto a ser impreso en el documento. +`texto` es una cadena de texto que contiene el texto a ser impreso en el documento. ### Example @@ -60,15 +60,17 @@ 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](http://www.w3.org/MarkUp/2004/xhtml-faq#docwrite). +> **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 -- [DOM Level 2 HTML: `write()` Method](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-75233634) -- [Dynamic markup insertion in HTML](http://www.w3.org/TR/2011/WD-html5-author-20110705/apis-in-html-documents.html#dynamic-markup-insertion) +{{Specifications}} +## Compatibilidad del Navegador + +{{Compat}} ## También puedes ver - {{ domxref("element.innerHTML") }} diff --git a/files/es/web/api/document/writeln/index.md b/files/es/web/api/document/writeln/index.md index 3ba16206169315..eff297f7ee86bd 100644 --- a/files/es/web/api/document/writeln/index.md +++ b/files/es/web/api/document/writeln/index.md @@ -7,11 +7,11 @@ translation_of: Web/API/Document/writeln Escribe una cadena de texto en el documento, seguida de una nueva línea. -> **Nota:** 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). +> **Nota:** 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); ``` @@ -29,10 +29,14 @@ document.writeln("

      ¡Hola mundo!

      "); **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](http://www.w3.org/MarkUp/2004/xhtml-faq#docwrite). +> **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"). -## Especificación +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador -[writeln](http://www.w3.org/TR/2000/WD-DOM-Level-2-HTML-20001113/html.html#ID-35318390) +{{Compat}} From dc44120fe3edb3461ef36b28857991f3885e728e Mon Sep 17 00:00:00 2001 From: Alexander Date: Tue, 20 Sep 2022 16:35:48 -0500 Subject: [PATCH 4/4] Apply suggestions from code review --- files/es/web/api/document/cookie/index.md | 10 +++++----- .../web/api/document/createdocumentfragment/index.md | 6 +----- files/es/web/api/document/write/index.md | 2 +- files/es/web/api/document/writeln/index.md | 2 +- 4 files changed, 8 insertions(+), 12 deletions(-) diff --git a/files/es/web/api/document/cookie/index.md b/files/es/web/api/document/cookie/index.md index a6a9b36e453b9f..e9479f82878e25 100644 --- a/files/es/web/api/document/cookie/index.md +++ b/files/es/web/api/document/cookie/index.md @@ -35,8 +35,8 @@ En el código anterior, _`nuevacookie`_ es una cadena de la forma _`clave=valor` - `;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. + - `;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. @@ -64,7 +64,7 @@ function alertCookie() { } ``` -```js +```html ``` @@ -83,7 +83,7 @@ function alertCookieValue() { } ``` -```js +```html ``` @@ -102,7 +102,7 @@ function hazUnaVez() { } ``` -```js +```html ``` diff --git a/files/es/web/api/document/createdocumentfragment/index.md b/files/es/web/api/document/createdocumentfragment/index.md index 3256ce19ed1f5c..d2f9b796fc11d7 100644 --- a/files/es/web/api/document/createdocumentfragment/index.md +++ b/files/es/web/api/document/createdocumentfragment/index.md @@ -63,11 +63,7 @@ Resultado {{Specifications}} -## Compatibilidad del Navegador - -{{Compat}} - -## Compatibilidad del Navegador +## Compatibilidad con navegadores {{Compat}} diff --git a/files/es/web/api/document/write/index.md b/files/es/web/api/document/write/index.md index 0b7ab19f099ed4..0420d589dff2c9 100644 --- a/files/es/web/api/document/write/index.md +++ b/files/es/web/api/document/write/index.md @@ -13,7 +13,7 @@ translation_of: Web/API/Document/write Escribe una cadena de texto dentro del hilo de un `document `abierto por [document.open()](/es/docs/Web/API/document.open). -> **Nota:** 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). +> **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 diff --git a/files/es/web/api/document/writeln/index.md b/files/es/web/api/document/writeln/index.md index eff297f7ee86bd..6f0405616bc3fd 100644 --- a/files/es/web/api/document/writeln/index.md +++ b/files/es/web/api/document/writeln/index.md @@ -7,7 +7,7 @@ translation_of: Web/API/Document/writeln Escribe una cadena de texto en el documento, seguida de una nueva línea. -> **Nota:** 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). +> **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