diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
commit | 33058f2b292b3a581333bdfb21b8f671898c5060 (patch) | |
tree | 51c3e392513ec574331b2d3f85c394445ea803c6 /files/fr/web/api/text | |
parent | 8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff) | |
download | translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2 translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip |
initial commit
Diffstat (limited to 'files/fr/web/api/text')
-rw-r--r-- | files/fr/web/api/text/index.html | 234 | ||||
-rw-r--r-- | files/fr/web/api/text/splittext/index.html | 142 |
2 files changed, 376 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> diff --git a/files/fr/web/api/text/splittext/index.html b/files/fr/web/api/text/splittext/index.html new file mode 100644 index 0000000000..034a953e46 --- /dev/null +++ b/files/fr/web/api/text/splittext/index.html @@ -0,0 +1,142 @@ +--- +title: Text.splitText() +slug: Web/API/Text/splitText +translation_of: Web/API/Text/splitText +--- +<div>{{apiref("DOM")}}</div> + +<p>La méthode <strong><code>Text.splitText()</code></strong> sépare le nœud {{domxref("Text")}} en deux nœuds au niveau de l’indice spécifié, et conserve les deux nœuds dans l’arbre en tant que voisins.</p> + +<p>Après la séparation, le nœud actuel contient tout le texte jusqu’à l’indice spécifié, et un nœud nouvellement créé du même type contient le texte restant. Le nœud nouvellement créé est retourné à l’appelant. Si le nœud original avait un parent, le nouveau nœud est inséré en tant que voisin suivant du nœud original. Si l’indice est égal à la longueur du nœud original, le nœud nouvellement créé ne contient pas de données.</p> + +<p>Des nœuds texte séparés peuvent être concaténés en utilisant la méthode {{domxref("Node.normalize()")}}.</p> + +<p>Une {{domxref("DOMException")}} avec la valeur <code>INDEX_SIZE_ERR</code> est levée si l’indice spécifié est négatif ou est supérieur au nombre d’unités 16-bit dans le texte du nœud ; une {{domxref("DOMException")}} avec la valeur <code>NO_MODIFICATION_ALLOWED_ERR</code> est levée si le nœud est en lecture seule.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox"><em>noeudRemplacant</em> = <em>noeudTexte</em>.splitText(indice) +</pre> + +<h2 id="Exemple">Exemple</h2> + +<p>Dans cet exemple, le nœud texte d’un {{HTMLElement("p")}} est séparé en deux nœuds texte et un {{HTMLElement("span")}} est inséré entre les deux.</p> + +<pre class="brush:html"><body> + <p id="p">foobar</p> + + <script type="text/javascript"> + var p = document.getElementById('p'); + var noeudTexte = p.firstChild; + + // coupe entre foo et bar + var noeudRemplacant = noeudTexte.splitText(3); + + // crée un span avec ' contenu du span ' + var span = document.createElement('span'); + span.appendChild(document.createTextNode(' contenu du span ')); + + // ajoute le span avant 'bar' + p.insertBefore(span, noeudRemplacant); + + // le résultat est <p id="p">foo<span> contenu du span </span>bar</p> + </script> +</body> +</pre> + +<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">Commentaires</th> + </tr> + <tr> + <td>{{SpecName('DOM WHATWG', '#dom-text-splittext', 'Text.splitText')}}</td> + <td>{{Spec2('DOM WHATWG')}}</td> + <td>Pas de changement depuis {{SpecName('DOM3 Core')}}.</td> + </tr> + <tr> + <td>{{SpecName('DOM3 Core', 'core.html#ID-38853C1D', 'Text.splitText')}}</td> + <td>{{Spec2('DOM3 Core')}}</td> + <td>Pas de changement depuis {{SpecName('DOM2 Core')}}.</td> + </tr> + <tr> + <td>{{SpecName('DOM2 Core', 'core.html#ID-38853C1D', 'Text.splitText')}}</td> + <td>{{Spec2('DOM2 Core')}}</td> + <td>Pas de changement depuis {{SpecName('DOM1')}}.</td> + </tr> + <tr> + <td>{{SpecName('DOM1', 'level-one-core.html#ID-38853C1D', 'Text.splitText')}}</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>Support de base</td> + <td>1.0 [1]</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoDesktop("1.0")}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}} [1]</td> + <td>{{CompatVersionUnknown}} [2]</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>Support de base</td> + <td>{{CompatVersionUnknown}} [1]</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoMobile("1.0")}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}} [1]</td> + <td>{{CompatVersionUnknown}} [2]</td> + </tr> + </tbody> +</table> +</div> + +<p>[1] Avant Chrome 30 et Opera 17, l’argument de <code>splitText()</code> n’était pas obligatoire, tel que requis par la spécification et implementé par IE et les navigateurs basés sur Gecko.</p> + +<p>[2] L’argument n’est pas obligatoire, bien que requis par la spec.</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>L’interface {{domxref("Text")}} à laquelle cette méthode appartient.</li> + <li>La méthode opposée : {{domxref("Node.normalize")}}.</li> +</ul> |