diff options
Diffstat (limited to 'files/fr/web/api/document/createcdatasection/index.md')
| -rw-r--r-- | files/fr/web/api/document/createcdatasection/index.md | 40 |
1 files changed, 17 insertions, 23 deletions
diff --git a/files/fr/web/api/document/createcdatasection/index.md b/files/fr/web/api/document/createcdatasection/index.md index f1a44c9a07..3ee0e113a7 100644 --- a/files/fr/web/api/document/createcdatasection/index.md +++ b/files/fr/web/api/document/createcdatasection/index.md @@ -12,41 +12,35 @@ tags: - données translation_of: Web/API/Document/createCDATASection --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p><code>createCDATASection()</code> crée un nouveau noeud de section CDATA et le renvoie.</p> +`createCDATASection()` crée un nouveau noeud de section CDATA et le renvoie. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>CDATASectionNode</var> = document.createCDATASection(data) -</pre> + CDATASectionNode = document.createCDATASection(data) -<ul> - <li><code>CDATASectionNode</code> est un noeud de <a href="/fr/docs/Web/API/CDATASection">Section CDATA</a>.</li> - <li><code>data</code> est une string (<em>chaîne de caractères</em>) contenant les données à ajouter à la section CDATA.</li> -</ul> +- `CDATASectionNode` est un noeud de [Section CDATA](/fr/docs/Web/API/CDATASection). +- `data` est une string (_chaîne de caractères_) contenant les données à ajouter à la section CDATA. -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush:js">var docu = new DOMParser().parseFromString('<xml></xml>', "application/xml") +```js +var docu = new DOMParser().parseFromString('<xml></xml>', "application/xml") -var cdata = docu.createCDATASection('Some <CDATA> data & then some'); +var cdata = docu.createCDATASection('Some <CDATA> data & then some'); docu.getElementsByTagName('xml')[0].appendChild(cdata); alert(new XMLSerializer().serializeToString(docu)); -// Affiche : <xml><![CDATA[Some <CDATA> data & then some]]></xml> -</pre> +// Affiche : <xml><![CDATA[Some <CDATA> data & then some]]></xml> +``` -<h2 id="Notes">Notes</h2> +## Notes -<ul> - <li>Cela fonctionnera uniquement avec XML, pas avec les documents HTML (car les documents HTML ne supportent pas les sections CDATA) ; le tenter sur un document HTML va lancer une exception <code>NOT_SUPPORTED_ERR</code>.</li> - <li>Va lancer une exception <code>NS_ERROR_DOM_INVALID_CHARACTER_ERR</code> si on essaye de soumettre la séquence CDATA de fermeture ("]]>") en tant que partie des données ; les données fournies par l'utilisateur non échappées, ne peuvent pas être utilisées en toute sécurité sans qu'avec cette méthode on obtienne cette exception (<code><a href="/en-US/docs/DOM/document.createTextNode">createTextNode()</a></code> peut souvent être utilisé à sa place).</li> -</ul> +- Cela fonctionnera uniquement avec XML, pas avec les documents HTML (car les documents HTML ne supportent pas les sections CDATA) ; le tenter sur un document HTML va lancer une exception `NOT_SUPPORTED_ERR`. +- Va lancer une exception `NS_ERROR_DOM_INVALID_CHARACTER_ERR` si on essaye de soumettre la séquence CDATA de fermeture ("]]>") en tant que partie des données ; les données fournies par l'utilisateur non échappées, ne peuvent pas être utilisées en toute sécurité sans qu'avec cette méthode on obtienne cette exception ([`createTextNode()`](/en-US/docs/DOM/document.createTextNode) peut souvent être utilisé à sa place). -<h2 id="Specification">Spécification</h2> +## Spécification -<ul> - <li><a href="http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-createCDATASection">createCDATASection</a></li> -</ul> +- [createCDATASection](http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-createCDATASection) |