diff options
Diffstat (limited to 'files/fr/web/api/element/insertadjacenttext/index.md')
| -rw-r--r-- | files/fr/web/api/element/insertadjacenttext/index.md | 191 |
1 files changed, 81 insertions, 110 deletions
diff --git a/files/fr/web/api/element/insertadjacenttext/index.md b/files/fr/web/api/element/insertadjacenttext/index.md index f0ab71ddad..2ecca80491 100644 --- a/files/fr/web/api/element/insertadjacenttext/index.md +++ b/files/fr/web/api/element/insertadjacenttext/index.md @@ -10,118 +10,89 @@ tags: - Texte translation_of: Web/API/Element/insertAdjacentText --- -<p>{{APIRef("DOM")}}</p> - -<p>La méthode <code>insertAdjacentText()</code> insère un noeud texte donné à une position donnée par rapport à l'élément sur lequel elle est appelé.</p> - -<h2 id="Syntax">Syntaxe</h2> - -<pre><em>element</em>.insertAdjacentText(<em>position</em>, <em>element</em>);</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt>position</dt> - <dd>Une {{domxref("DOMString")}} (<em>chaîne de caractères</em>) représentant la position par rapport à l'<code>element</code> ; elle doit être l'une des chaînes suivantes : - <ul> - <li><code>'beforebegin'</code> : avant l'<code>element</code> lui-même ;</li> - <li><code>'afterbegin'</code> : à l'intérieur de l'<code>element</code>, avant son premier enfant ;</li> - <li><code>'beforeend'</code> : à l'intérieur de l'<code>element</code>, avant son dernier enfant ;</li> - <li><code>'afterend'</code> : après l'<code>element</code> lui-même.</li> - </ul> - </dd> - <dt>element</dt> - <dd>Une {{domxref("DOMString")}} (<em>chaîne de caractères</em>) représentant le texte à insérer dans l'arbre.</dd> -</dl> - -<h3 id="Valeur_renvoyée">Valeur renvoyée</h3> - -<p>Vide.</p> - -<h3 id="Exceptions">Exceptions</h3> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Exception</th> - <th scope="col">Explication</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>SyntaxError</code></td> - <td>La <code>position</code> indiquée n'est pas une valeur reconnue.</td> - </tr> - </tbody> -</table> - -<h3 id="Visualisation_des_noms_de_position">Visualisation des noms de position</h3> - -<pre><!-- beforebegin --> -<p> -<!-- afterbegin> --> -machin -<!-- beforeend --> -</p> -<!-- afterend --></pre> - -<div class="note"> - <p><strong>Note :</strong> Les positions <code>beforebegin</code> et <code>afterend</code> ne fonctionnent que si le noeud est dans l'arbre et possède un élément parent.</p> -</div> - -<h2 id="Example">Exemple</h2> - -<pre class="brush: js">beforeBtn.addEventListener('click', function() { +{{APIRef("DOM")}} + +La méthode `insertAdjacentText()` insère un noeud texte donné à une position donnée par rapport à l'élément sur lequel elle est appelé. + +## Syntaxe + + element.insertAdjacentText(position, element); + +### Paramètres + +- position + + - : Une {{domxref("DOMString")}} (_chaîne de caractères_) représentant la position par rapport à l'`element` ; elle doit être l'une des chaînes suivantes : + + - `'beforebegin'` : avant l'`element` lui-même ; + - `'afterbegin'` : à l'intérieur de l'`element`, avant son premier enfant ; + - `'beforeend'` : à l'intérieur de l'`element`, avant son dernier enfant ; + - `'afterend'` : après l'`element` lui-même. + +- element + - : Une {{domxref("DOMString")}} (_chaîne de caractères_) représentant le texte à insérer dans l'arbre. + +### Valeur renvoyée + +Vide. + +### Exceptions + +| Exception | Explication | +| ------------- | ----------------------------------------------------- | +| `SyntaxError` | La `position` indiquée n'est pas une valeur reconnue. | + +### Visualisation des noms de position + + <!-- beforebegin --> + <p> + <!-- afterbegin> --> + machin + <!-- beforeend --> + </p> + <!-- afterend --> + +> **Note :** Les positions `beforebegin` et `afterend` ne fonctionnent que si le noeud est dans l'arbre et possède un élément parent. + +## Exemple + +```js +beforeBtn.addEventListener('click', function() { para.insertAdjacentText('afterbegin',textInput.value); }); afterBtn.addEventListener('click', function() { para.insertAdjacentText('beforeend',textInput.value); -});</pre> - -<p>Jetez un œil à notre démo <a href="https://mdn.github.io/dom-examples/insert-adjacent/insertAdjacentText.html">insertAdjacentText.html</a> sur GitHub (voir le <a href="https://github.com/mdn/dom-examples/blob/master/insert-adjacent/insertAdjacentText.html">code source</a> aussi). Ici, nous avons un simple paragraphe. Vous pouvez entrer du texte dans l'élément de formulaire, puis presser les boutons <em>Insert before</em> (<em>insère avant</em>) et <em>Insert after</em> (<em>insère après</em>) pour l'insérer avant ou après le texte de paragraphe existant en utilisant <code>insertAdjacentText()</code>. Notez que le nœud texte existant n'y est pas ajouté — d'autres nœuds de texte sont créés contenant le nouvel ajout.</p> - -<h2 id="Émulation">Émulation</h2> - -<p>Vous pouvez utiliser une émulation de la méthode <code>insertAdjacentText()</code> dans Internet Explorer 5.5 (et peut-être antérieur) et supérieur avec le code suivant :</p> - -<pre>if (!Element.prototype.insertAdjacentText) - Element.prototype.insertAdjacentText = function(type, txt){ - this.insertAdjacentHTML( - type, - (txt+'') // convertir en chaîne de caractères - .replace(/&/g, '&amp;') // intégrer des symboles d'esperluette - .replace(/</g, '&lt;') // intégrer les symboles "plus petit que" - ) - } -</pre> - -<h2 id="Specification">Spécification</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('DOM WHATWG', '#dom-element-insertadjacenttext', 'insertAdjacentText()')}}</td> - <td>{{ Spec2('DOM WHATWG') }}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Element.insertAdjacentText")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("Element.insertAdjacentElement()")}}</li> - <li>{{domxref("Element.insertAdjacentHTML()")}}</li> -</ul> +}); +``` + +Jetez un œil à notre démo [insertAdjacentText.html](https://mdn.github.io/dom-examples/insert-adjacent/insertAdjacentText.html) sur GitHub (voir le [code source](https://github.com/mdn/dom-examples/blob/master/insert-adjacent/insertAdjacentText.html) aussi). Ici, nous avons un simple paragraphe. Vous pouvez entrer du texte dans l'élément de formulaire, puis presser les boutons _Insert before_ (_insère avant_) et _Insert after_ (_insère après_) pour l'insérer avant ou après le texte de paragraphe existant en utilisant `insertAdjacentText()`. Notez que le nœud texte existant n'y est pas ajouté — d'autres nœuds de texte sont créés contenant le nouvel ajout. + +## Émulation + +Vous pouvez utiliser une émulation de la méthode `insertAdjacentText()` dans Internet Explorer 5.5 (et peut-être antérieur) et supérieur avec le code suivant : + + if (!Element.prototype.insertAdjacentText) + Element.prototype.insertAdjacentText = function(type, txt){ + this.insertAdjacentHTML( + type, + (txt+'') // convertir en chaîne de caractères + .replace(/&/g, '&') // intégrer des symboles d'esperluette + .replace(/</g, '<') // intégrer les symboles "plus petit que" + ) + } + +## Spécification + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------- | -------------------------------- | ----------- | +| {{SpecName('DOM WHATWG', '#dom-element-insertadjacenttext', 'insertAdjacentText()')}} | {{ Spec2('DOM WHATWG') }} | | + +## Compatibilité des navigateurs + +{{Compat("api.Element.insertAdjacentText")}} + +## Voir aussi + +- {{domxref("Element.insertAdjacentElement()")}} +- {{domxref("Element.insertAdjacentHTML()")}} |