diff options
Diffstat (limited to 'files/fr/web/api/document/write/index.md')
| -rw-r--r-- | files/fr/web/api/document/write/index.md | 94 |
1 files changed, 40 insertions, 54 deletions
diff --git a/files/fr/web/api/document/write/index.md b/files/fr/web/api/document/write/index.md index deac04e6b3..fd54354baf 100644 --- a/files/fr/web/api/document/write/index.md +++ b/files/fr/web/api/document/write/index.md @@ -9,88 +9,74 @@ tags: - Rérérence translation_of: Web/API/Document/write --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p>Écrit une chaîne de texte dans un document ouvert par <a href="/fr/docs/Web/API/Document/open">document.open()</a>.</p> +Écrit une chaîne de texte dans un document ouvert par [document.open()](/fr/docs/Web/API/Document/open). -<div class="note"> -<p><strong>Note :</strong> comme <code>document.write</code> écrit dans le flux de documents, appeler <code>document.write</code> sur un document fermé (chargé) appelle automatiquement <code>document.open</code>, ce qui efface le document.</p> -</div> +> **Note :** comme `document.write` écrit dans le flux de documents, appeler `document.write` sur un document fermé (chargé) appelle automatiquement `document.open`, ce qui efface le document. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="eval">document.write(<em>balisage</em>); -</pre> + document.write(balisage); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>markup</code></dt> - <dd>est une chaîne de caractères contenant le texte à écrire dans le document.</dd> -</dl> +- `markup` + - : est une chaîne de caractères contenant le texte à écrire dans le document. -<h3 id="Exemple">Exemple</h3> +### Exemple -<pre class="brush: html"><html> +```html +<html> -<head> -<title>Exemple de document.write</title> +<head> +<title>Exemple de document.write</title> -<script type="text/javascript"> +<script type="text/javascript"> function nouveauContenu() { alert("chargement du nouveau contenu"); document.open(); -document.write("<h1>Assez de l'ancien contenu, passons au nouveau !</h1>"); +document.write("<h1>Assez de l'ancien contenu, passons au nouveau !</h1>"); document.close(); } -</script> -</head> +</script> +</head> -<body onload="nouveauContenu();"> -<p>Ceci est le contenu original du document.</p> -</body> -</html> -</pre> +<body onload="nouveauContenu();"> +<p>Ceci est le contenu original du document.</p> +</body> +</html> +``` -<h2 id="Notes">Notes</h2> +## Notes -<p>Écrire dans un document qui a déjà été chargé sans appeler <a href="/fr/docs/Web/API/Document/open">document.open()</a> provoquera un appel automatique à <code>document.open</code>. Une fois l'écriture terminée, il est recommandé d'appeler <a href="/fr/docs/Web/API/Document/close">document.close()</a> pour indiquer au navigateur qu'il peut terminer de charger la page. Le texte fourni est analysé et intégré à la structure du modèle de document. Dans l'exemple ci-dessus, l'élément <code>h1</code> devient un nœud dans le document.</p> +Écrire dans un document qui a déjà été chargé sans appeler [document.open()](/fr/docs/Web/API/Document/open) provoquera un appel automatique à `document.open`. Une fois l'écriture terminée, il est recommandé d'appeler [document.close()](/fr/docs/Web/API/Document/close) pour indiquer au navigateur qu'il peut terminer de charger la page. Le texte fourni est analysé et intégré à la structure du modèle de document. Dans l'exemple ci-dessus, l'élément `h1` devient un nœud dans le document. -<p>Si l'appel à <code>document.write()</code> est intégré directement dans le code HTML, il n'appellera pas <code>document.open()</code>. Par exemple :</p> +Si l'appel à `document.write()` est intégré directement dans le code HTML, il n'appellera pas `document.open()`. Par exemple : -<pre class="brush: html"><script> - document.write("<h1>Main title</h1>") -</script></pre> +```html +<script> + document.write("<h1>Main title</h1>") +</script> +``` -<div class="note"> -<p><strong>Note :</strong> <code>document.write</code> et <code>document.writeln <a href="/fr/docs/Archive/Web/Writing_JavaScript_for_HTML">ne fonctionnent pas dans les documents XHTML</a> (vous obtiendrez une erreur </code> "Operation is not supported" [<code>NS_ERROR_DOM_NOT_SUPPORTED_ERR</code>] dans la console d'erreurs). Cela arrive lors de l'ouverture d'un fichier local avec l'extension de fichier .xhtm ou pour tout document servi avec une <code>application/xhtml+xml</code> de <a href="/fr/docs/Glossaire/Type_MIME">type MIME</a>. Plus d'informations disponibles dans la <a href="http://www.w3.org/MarkUp/2004/xhtml-faq#docwrite">foire aux questions W3C XHTML (en)</a>.</p> -</div> +> **Note :** `document.write` et `document.writeln ne fonctionnent pas dans les documents XHTML (vous obtiendrez une erreur ` "Operation is not supported" \[`NS_ERROR_DOM_NOT_SUPPORTED_ERR`] dans la console d'erreurs). Cela arrive lors de l'ouverture d'un fichier local avec l'extension de fichier .xhtm ou pour tout document servi avec une `application/xhtml+xml` de [type MIME](/fr/docs/Glossaire/Type_MIME). Plus d'informations disponibles dans la [foire aux questions W3C XHTML (en)](http://www.w3.org/MarkUp/2004/xhtml-faq#docwrite). -<div class="note"> -<p><strong>Note :</strong> <code>document.write</code> dans les scripts <a href="/en-US/docs/Web/HTML/Element/script#attr-defer">deferred (<em>différé</em>)</a> ou <a href="/en-US/docs/Web/HTML/Element/script#attr-async">asynchronous (<em>asynchrone</em>)</a> sera ignoré et vous recevrez un message comme "A call to <code>document.write()</code> from an asynchronously-loaded external script was ignored" dans la console d'erreurs.</p> -</div> +> **Note :** `document.write` dans les scripts [deferred (_différé_)](/en-US/docs/Web/HTML/Element/script#attr-defer) ou [asynchronous (_asynchrone_)](/en-US/docs/Web/HTML/Element/script#attr-async) sera ignoré et vous recevrez un message comme "A call to `document.write()` from an asynchronously-loaded external script was ignored" dans la console d'erreurs. -<div class="note"> -<p><strong>Note :</strong> Dans Edge seulement, appeler plusieurs fois <code>document.write</code> dans un "iframe" déclenche une erreur "SCRIPT70: Permission denied." <em>(autorisation refusée)</em>.</p> -</div> +> **Note :** Dans Edge seulement, appeler plusieurs fois `document.write` dans un "iframe" déclenche une erreur "SCRIPT70: Permission denied." _(autorisation refusée)_. -<div class="note"> -<p><strong>Note :</strong> À partir de la version 55, Chrome n'exécute pas les éléments <code><script></code> injectés via <code>document.write()</code> en cas d'échec de cache HTTP pour les utilisateurs sur une connexion 2G.</p> -</div> +> **Note :** À partir de la version 55, Chrome n'exécute pas les éléments `<script>` injectés via `document.write()` en cas d'échec de cache HTTP pour les utilisateurs sur une connexion 2G. -<h2 id="Sp.C3.A9cification">Spécification</h2> +## Spécification -<ul> - <li><a href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-75233634">DOM Level 2 HTML: <code>write()</code> Method</a></li> - <li><a href="http://www.w3.org/TR/2011/WD-html5-author-20110705/apis-in-html-documents.html#dynamic-markup-insertion">Dynamic markup insertion in HTML</a></li> -</ul> +- [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) -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{ domxref("element.innerHTML") }}</li> - <li>{{ domxref("document.createElement()") }}</li> -</ul> +- {{ domxref("element.innerHTML") }} +- {{ domxref("document.createElement()") }} |