---
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>