diff options
Diffstat (limited to 'files/fr/web/api/text/index.html')
-rw-r--r-- | files/fr/web/api/text/index.html | 234 |
1 files changed, 234 insertions, 0 deletions
diff --git a/files/fr/web/api/text/index.html b/files/fr/web/api/text/index.html new file mode 100644 index 0000000000..702acd9d54 --- /dev/null +++ b/files/fr/web/api/text/index.html @@ -0,0 +1,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> |