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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
|
---
title: Text
slug: Web/API/Text
tags:
- API
- DOM
translation_of: Web/API/Text
---
<p>{{ApiRef("DOM")}}</p>
<p>L'interface <strong><code>Text</code></strong> représente le contenu textuel d'un élément {{domxref("Element")}} ou d'un attribut {{domxref("Attr")}}. Si un élément n'a pas de balisage dans son contenu, il a un seul enfant implémentant <code>Text</code> qui contient le texte de l'élément. Par contre, si l'élément contient un balisage, il est analysé par les éléments d'information et les noeuds <code>Text</code> qui sont ses enfants.</p>
<p>Un nouveau document a un unique noeud <code>Text</code> pour chaque bloc de texte. Au fil du temps, d'autres noeuds peuvent être créés <code>Text</code> en temps que modification du contenu du document. La méthode {{domxref("Node.normalize()")}} fusionne les objets <code>Text</code> dans un seul noeud pour chaque bloc de texte.</p>
<p>{{InheritanceDiagram}}</p>
<h2 id="Methods" name="Methods">Constructeur</h2>
<dl>
<dt>{{domxref("Text.Text", "Text()")}} {{experimental_inline}}</dt>
<dd>Retourne un noeud <code>Text</code> avec le paramètre comme contenu textuel.</dd>
</dl>
<h2 id="Propriétés">Propriétés</h2>
<p><em>Hérite des propriétés de son parent {{domxref("CharacterData")}}.</em></p>
<dl>
<dt>{{domxref("Text.isElementContentWhitespace")}} {{readonlyInline}}{{ obsolete_inline() }}</dt>
<dd>
<p>Renvoie une marque {{domxref("Boolean")}} indiquant si le noeud de texte contient uniquement des espaces.</p>
</dd>
<dt>{{domxref("Text.wholeText")}} {{readonlyInline}}</dt>
<dd>Renvoie une {{domxref("DOMString")}} (<em>chaîne de caractères</em>) contenant le texte de tous les noeuds <code>Text</code> adjacents logiquement à ce {{domxref("Node")}}, concaténé dans l'ordre du document.</dd>
<dt>{{domxref("Text.assignedSlot")}} {{readonlyinline}}</dt>
<dd>Retourne l'objet {{domxref("HTMLSlotElement")}} associé à l'élément.</dd>
</dl>
<h2 id="Méthodes">Méthodes</h2>
<p><em>Hérite des méthodes de son parent {{domxref("CharacterData")}}.</em></p>
<dl>
</dl>
<dl>
<dt>{{domxref("Text.replaceWholeText")}} {{ obsolete_inline() }}</dt>
<dd>Remplace le texte du noeud en cours et tous les noeuds logiquement adjacents avec le texte spécifié.</dd>
</dl>
<dl>
<dt><span class="internal">{{domxref("Text.splitText")}}</span></dt>
<dd>Fractionne le noeud en deux noeuds selon un décalage spécifié.</dd>
</dl>
<h2 id="Spécifications">Spécifications</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Spécification</th>
<th scope="col">Statut</th>
<th scope="col">Commentaire</th>
</tr>
<tr>
<td>{{SpecName('DOM WHATWG', '#text', 'Text')}}</td>
<td>{{Spec2('DOM WHATWG')}}</td>
<td>Suppression de la propriété <code>isElementContentWhitespace</code>.<br>
Suppression de la méthode <code>replaceWholeText()</code>.<br>
Ajout du constructeur <code>Text()</code>.<br>
Ajout de la propriété <code>assignedSlot</code>.</td>
</tr>
<tr>
<td>{{SpecName('DOM3 Core', 'core.html#ID-1312295772', 'Text')}}</td>
<td>{{Spec2('DOM3 Core')}}</td>
<td>Ajout des propriétés <code>isElementContentWhitespace</code> et <code>wholeText</code>.<br>
Ajout de la méthode <code>replaceWholeText()</code>.</td>
</tr>
<tr>
<td>{{SpecName('DOM2 Core', 'core.html#ID-1312295772', 'Text')}}</td>
<td>{{Spec2('DOM2 Core')}}</td>
<td>Pas de changement depuis {{SpecName('DOM1')}}.</td>
</tr>
<tr>
<td>{{SpecName('DOM1', 'level-one-core.html#ID-1312295772', 'Text')}}</td>
<td>{{Spec2('DOM1')}}</td>
<td>Définition initiale.</td>
</tr>
</tbody>
</table>
<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
<p>{{CompatibilityTable}}</p>
<div id="compat-desktop">
<table class="compat-table">
<tbody>
<tr>
<th>Fonctionnalité</th>
<th>Chrome</th>
<th>Edge</th>
<th>Firefox (Gecko)</th>
<th>Internet Explorer</th>
<th>Opera</th>
<th>Safari</th>
</tr>
<tr>
<td>Basic support</td>
<td>1.0 [3]</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatGeckoDesktop("1.0")}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}} [3]</td>
<td>{{CompatVersionUnknown}} [4]</td>
</tr>
<tr>
<td><code>wholeText</code></td>
<td>1.0</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatGeckoDesktop("1.9.1")}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
</tr>
<tr>
<td><code>isElementContentWhitespace</code></td>
<td>{{CompatNo}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}<br>
Removed in {{CompatGeckoDesktop("10")}}</td>
<td>{{CompatNo}}</td>
<td>{{CompatNo}}</td>
<td>{{CompatNo}}</td>
</tr>
<tr>
<td><code>replaceWholeText</code></td>
<td>{{CompatVersionUnknown}} [1] [2]</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatGeckoDesktop("1.9.1")}}<br>
Removed in {{CompatGeckoDesktop("10")}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}} [1] [2]</td>
<td>{{CompatVersionUnknown}} [4]</td>
</tr>
<tr>
<td><code>Text()</code> constructor</td>
<td>28.0</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatGeckoDesktop("24.0")}}</td>
<td>{{CompatNo}}</td>
<td>15.0</td>
<td>{{CompatNo}}</td>
</tr>
</tbody>
</table>
</div>
<div id="compat-mobile">
<table class="compat-table">
<tbody>
<tr>
<th>Fonctionnalité</th>
<th>Android</th>
<th>Edge</th>
<th>Firefox Mobile (Gecko)</th>
<th>IE Mobile</th>
<th>Opera Mobile</th>
<th>Safari Mobile</th>
</tr>
<tr>
<td>Basic support</td>
<td>{{CompatVersionUnknown}} [3]</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatGeckoMobile("1.0")}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}} [3]</td>
<td>{{CompatVersionUnknown}} [4]</td>
</tr>
<tr>
<td><code>wholeText</code></td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatGeckoMobile("1.9.1")}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
</tr>
<tr>
<td><code>isElementContentWhitespace</code></td>
<td>{{CompatNo}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}<br>
Removed in {{CompatGeckoMobile("10")}}</td>
<td>{{CompatNo}}</td>
<td>{{CompatNo}}</td>
<td>{{CompatNo}}</td>
</tr>
<tr>
<td><code>replaceWholeText</code></td>
<td>{{CompatVersionUnknown}} [1] [2]</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatGeckoMobile("1.9.1")}}<br>
Removed in {{CompatGeckoMobile("10")}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}} [1] [2]</td>
<td>{{CompatVersionUnknown}} [4]</td>
</tr>
<tr>
<td><code>Text()</code> constructor</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatGeckoMobile("24.0")}}</td>
<td>{{CompatNo}}</td>
<td>15.0</td>
<td>{{CompatNo}}</td>
</tr>
</tbody>
</table>
</div>
<p>[1] Chromium envisage actuellement de laisser tomber son support.</p>
<p>[2] Avant Chrome 30 et Opera 17, l'argument n'était pas obligatoire, comme requis par la spécification.</p>
<p>[3] Avant Chrome 30 et Opera 17, l'argument <code>splitText()</code> n'était pas obligatoire, tel que requis par la spécification et mis en œuvre par les navigateurs IE et Gecko.</p>
<p>[4] L'argument n'est pas obligatoire, bien que requis par la spécification.</p>
<h2 id="Voir_aussi">Voir aussi</h2>
<ul>
<li><a href="https://developer.mozilla.org/fr/docs/Web/API/Document_Object_Model" title="/en-US/docs/DOM/DOM_Reference">Référence du DOM</a></li>
</ul>
|
