Este articulo necesita una revisión editorial. Cómo puedes ayudar.
Esta traducción está incompleta. Por favor, ayuda a traducir este artículo del inglés.
Escribe una cadena de texto dentro del hilo de un document
abierto por document.open().
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>
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.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").