diff options
| author | julieng <julien.gattelier@gmail.com> | 2021-10-02 17:20:24 +0200 |
|---|---|---|
| committer | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-10-02 17:30:20 +0200 |
| commit | 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde (patch) | |
| tree | 30a56efd3eff3a01bd1611e1840fdbbfacf544a4 /files/fr/web/api/range/surroundcontents | |
| parent | c05efa8d7ae464235cf83d7c0956e42dc6974103 (diff) | |
| download | translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.gz translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.bz2 translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.zip | |
convert content to md
Diffstat (limited to 'files/fr/web/api/range/surroundcontents')
| -rw-r--r-- | files/fr/web/api/range/surroundcontents/index.md | 83 |
1 files changed, 33 insertions, 50 deletions
diff --git a/files/fr/web/api/range/surroundcontents/index.md b/files/fr/web/api/range/surroundcontents/index.md index 4b8b6fa87e..e157cd42f2 100644 --- a/files/fr/web/api/range/surroundcontents/index.md +++ b/files/fr/web/api/range/surroundcontents/index.md @@ -3,68 +3,51 @@ title: Range.surroundContents() slug: Web/API/Range/surroundContents translation_of: Web/API/Range/surroundContents --- -<div>{{ApiRef("DOM")}}</div> +{{ApiRef("DOM")}} -<p>La méthode <strong><code>Range.surroundContents()</code></strong> déplace le contenu du {{ domxref("Range") }} dans un nouveau nœud, plaçant le nouveau nœud au début du <code>range</code> spécifié.</p> +La méthode **`Range.surroundContents()`** déplace le contenu du {{ domxref("Range") }} dans un nouveau nœud, plaçant le nouveau nœud au début du `range` spécifié. -<p>Cette méthode est à peu près équivalente à :</p> +Cette méthode est à peu près équivalente à : -<pre class="brush: js">newNode.appendChild(range.extractContents()); -range.insertNode(newNode)</pre> +```js +newNode.appendChild(range.extractContents()); +range.insertNode(newNode) +``` -<p>Après déplacement, les bornes du <code>range</code> incluent <code>newNode</code>.</p> +Après déplacement, les bornes du `range` incluent `newNode`. -<p>Cependant, une exception sera levée si le {{ domxref("Range") }} découpe un nœud non-{{ domxref("Text") }} sur une seule de ses bornes. C’est-à-dire que, contrairement à l’alternative ci-dessus, s’il y a des nœuds partiellement sélectionnés, ils ne seront pas clonés ; à la place, l’opération échouera.</p> +Cependant, une exception sera levée si le {{ domxref("Range") }} découpe un nœud non-{{ domxref("Text") }} sur une seule de ses bornes. C’est-à-dire que, contrairement à l’alternative ci-dessus, s’il y a des nœuds partiellement sélectionnés, ils ne seront pas clonés ; à la place, l’opération échouera. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>range</em>.surroundContents(<em>newNode</em>); -</pre> + range.surroundContents(newNode); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><em>newNode</em></dt> - <dd>Un {{ domxref("Node") }} à insérer à l’emplacement du <code>range</code>.</dd> -</dl> +- _newNode_ + - : Un {{ domxref("Node") }} à insérer à l’emplacement du `range`. -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush:js">var range = document.createRange(); +```js +var range = document.createRange(); var newNode = document.createElement("p"); range.selectNode(document.getElementsByTagName("div").item(0)); range.surroundContents(newNode); -</pre> - -<h2 id="Specification">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', '#dom-range-surroundcontents', 'Range.surroundContents()')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Pas de changement.</td> - </tr> - <tr> - <td>{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-surroundContents', 'Range.surroundContents()')}}</td> - <td>{{Spec2('DOM2 Traversal_Range')}}</td> - <td>Spécification initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Range.surroundContents")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/DOM/DOM_Reference">L’index des interfaces DOM</a></li> -</ul> +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- | ----------------------- | +| {{SpecName('DOM WHATWG', '#dom-range-surroundcontents', 'Range.surroundContents()')}} | {{Spec2('DOM WHATWG')}} | Pas de changement. | +| {{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-surroundContents', 'Range.surroundContents()')}} | {{Spec2('DOM2 Traversal_Range')}} | Spécification initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Range.surroundContents")}} + +## Voir aussi + +- [L’index des interfaces DOM](/fr/docs/DOM/DOM_Reference) |
