blob: 3ee0e113a7988c57fdf5b96b7705e11476a1059f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
|
---
title: Document.createCDATASection()
slug: Web/API/Document/createCDATASection
tags:
- API
- Création
- DOM
- Document
- Méthode
- Section
- XML
- données
translation_of: Web/API/Document/createCDATASection
---
{{APIRef("DOM")}}
`createCDATASection()` crée un nouveau noeud de section CDATA et le renvoie.
## Syntaxe
CDATASectionNode = document.createCDATASection(data)
- `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.
## Exemple
```js
var docu = new DOMParser().parseFromString('<xml></xml>', "application/xml")
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>
```
## Notes
- 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).
## Spécification
- [createCDATASection](http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-createCDATASection)
|
