diff options
Diffstat (limited to 'files/fr/web/api/element/insertadjacenthtml/index.md')
| -rw-r--r-- | files/fr/web/api/element/insertadjacenthtml/index.md | 110 |
1 files changed, 47 insertions, 63 deletions
diff --git a/files/fr/web/api/element/insertadjacenthtml/index.md b/files/fr/web/api/element/insertadjacenthtml/index.md index e1f0ffa06a..39f3fb07b7 100644 --- a/files/fr/web/api/element/insertadjacenthtml/index.md +++ b/files/fr/web/api/element/insertadjacenthtml/index.md @@ -8,92 +8,76 @@ tags: - Reference translation_of: Web/API/Element/insertAdjacentHTML --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p><code>insertAdjacentHTML()</code> analyse le texte spécifié en tant que HTML ou XML et insère les noeuds résultants dans le DOM à la position spécifiée. L'élement qui est utilisé n'est pas réanalysé et les élements qu'il contient ne sont donc pas corrompus. Ceci, et le fait d'éviter la sérialisation supplémentaire, rend la fonction plus rapide et directe que <strong>innerHTML</strong>.</p> +`insertAdjacentHTML()` analyse le texte spécifié en tant que HTML ou XML et insère les noeuds résultants dans le DOM à la position spécifiée. L'élement qui est utilisé n'est pas réanalysé et les élements qu'il contient ne sont donc pas corrompus. Ceci, et le fait d'éviter la sérialisation supplémentaire, rend la fonction plus rapide et directe que **innerHTML**. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">element.insertAdjacentHTML(position, text);</pre> +```js +element.insertAdjacentHTML(position, text); +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>position</code> </dt> - <dd>une {{domxref("DOMString")}} représentant la position relative à l'<code>element</code>, et doit être une des chaînes de caractères suivantes :</dd> -</dl> +- `position` + - : une {{domxref("DOMString")}} représentant la position relative à l'`element`, et doit être une des chaînes de caractères suivantes : -<ul> - <li><code>'beforebegin'</code> : Avant l'<code>element</code> lui-même.</li> - <li><code>'afterbegin'</code> : Juste à l'intérieur de l'<code>element</code> , avant son premier enfant.</li> - <li><code>'beforeend'</code> : Juste à l'intérieur de l'<code>element</code> , après son dernier enfant.</li> - <li><code>'afterend'</code> : Après <code>element</code> lui-même.</li> -</ul> +<!----> -<dl> - <dt><code>text</code></dt> - <dd> est la chaîne de caractères qui doit être analysée en tant qu'HTML ou XML et insérée dans l'arbre du DOM.</dd> -</dl> +- `'beforebegin'` : Avant l'`element` lui-même. +- `'afterbegin'` : Juste à l'intérieur de l'`element` , avant son premier enfant. +- `'beforeend'` : Juste à l'intérieur de l'`element` , après son dernier enfant. +- `'afterend'` : Après `element` lui-même. -<h3 id="Visualisation_des_noms_de_position">Visualisation des noms de position</h3> +<!----> +- `text` + - : est la chaîne de caractères qui doit être analysée en tant qu'HTML ou XML et insérée dans l'arbre du DOM. -<pre><!-- beforebegin --> -<p> - <!-- afterbegin --> - foo - <!-- beforeend --> -</p> -<!-- afterend --></pre> +### Visualisation des noms de position -<div class="note"> - <p><strong>Note :</strong> Les positions <code>beforebegin</code> et <code>afterend</code> ne fonctionnent que si le noeud est un arbre et a un élément parent.</p> -</div> + <!-- beforebegin --> + <p> + <!-- afterbegin --> + foo + <!-- beforeend --> + </p> + <!-- afterend --> -<h2 id="Example">Exemple</h2> +> **Note :** Les positions `beforebegin` et `afterend` ne fonctionnent que si le noeud est un arbre et a un élément parent. -<pre class="brush: js">// <div id="one">one</div> +## Exemple + +```js +// <div id="one">one</div> var d1 = document.getElementById('one'); -d1.insertAdjacentHTML('afterend', '<div id="two">two</div>'); +d1.insertAdjacentHTML('afterend', '<div id="two">two</div>'); // Ici la nouvelle structure est : -// <div id="one">one</div><div id="two">two</div></pre> +// <div id="one">one</div><div id="two">two</div> +``` -<h2 id="Browser_Compatibility">Notes</h2> +## Notes -<h3 id="Considérations_de_sécurité">Considérations de sécurité</h3> +### Considérations de sécurité -<p>Lorsque vous insérez du code HTML dans une page en utilisant insertAdjacentHTML, veillez à ne pas utiliser d'entrée utilisateur qui n'a pas été échappée.</p> +Lorsque vous insérez du code HTML dans une page en utilisant insertAdjacentHTML, veillez à ne pas utiliser d'entrée utilisateur qui n'a pas été échappée. -<p>Il est recommandé de ne pas utiliser <code>insertAdjacentHTML</code> lors de l'insertion de texte brut; à la place, utilisez la propriété <code>node.textContent</code> ou la méthode <code>node.insertAdjacentText()</code>. Cela n'interprète pas le contenu transmis au format HTML, mais l'insère à la place sous forme de texte brut.</p> +Il est recommandé de ne pas utiliser `insertAdjacentHTML` lors de l'insertion de texte brut; à la place, utilisez la propriété `node.textContent` ou la méthode `node.insertAdjacentText()`. Cela n'interprète pas le contenu transmis au format HTML, mais l'insère à la place sous forme de texte brut. -<h2 id="Spécification">Spécification</h2> +## Spécification -<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 Parsing', '#widl-Element-insertAdjacentHTML-void-DOMString-position-DOMString-text', 'Element.insertAdjacentHTML()')}}</td> - <td>{{ Spec2('DOM Parsing') }}</td> - <td></td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------ | ----------- | +| {{SpecName('DOM Parsing', '#widl-Element-insertAdjacentHTML-void-DOMString-position-DOMString-text', 'Element.insertAdjacentHTML()')}} | {{ Spec2('DOM Parsing') }} | | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Element.insertAdjacentHTML")}}</p> +{{Compat("api.Element.insertAdjacentHTML")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("Element.insertAdjacentElement()")}}</li> - <li>{{domxref("Element.insertAdjacentText()")}}</li> - <li><a href="https://hacks.mozilla.org/2011/11/insertadjacenthtml-enables-faster-html-snippet-injection/">hacks.mozilla.org guest post</a> par Henri Sivonen y compris le benchmark montrant que insertAdjacentHTML peut être beaucoup plus rapide dans certains cas.</li> -</ul> +- {{domxref("Element.insertAdjacentElement()")}} +- {{domxref("Element.insertAdjacentText()")}} +- [hacks.mozilla.org guest post](https://hacks.mozilla.org/2011/11/insertadjacenthtml-enables-faster-html-snippet-injection/) par Henri Sivonen y compris le benchmark montrant que insertAdjacentHTML peut être beaucoup plus rapide dans certains cas. |