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/range | |
| 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/range')
| -rw-r--r-- | files/fr/web/api/range/createcontextualfragment/index.html | 105 | ||||
| -rw-r--r-- | files/fr/web/api/range/detach/index.html | 55 | ||||
| -rw-r--r-- | files/fr/web/api/range/extractcontents/index.html | 59 | ||||
| -rw-r--r-- | files/fr/web/api/range/index.html | 111 | ||||
| -rw-r--r-- | files/fr/web/api/range/insertnode/index.html | 115 | ||||
| -rw-r--r-- | files/fr/web/api/range/selectnode/index.html | 114 | ||||
| -rw-r--r-- | files/fr/web/api/range/setstart/index.html | 121 | ||||
| -rw-r--r-- | files/fr/web/api/range/surroundcontents/index.html | 72 |
8 files changed, 752 insertions, 0 deletions
diff --git a/files/fr/web/api/range/createcontextualfragment/index.html b/files/fr/web/api/range/createcontextualfragment/index.html new file mode 100644 index 0000000000..fa9c86ae30 --- /dev/null +++ b/files/fr/web/api/range/createcontextualfragment/index.html @@ -0,0 +1,105 @@ +--- +title: Range.createContextualFragment() +slug: Web/API/Range/createContextualFragment +translation_of: Web/API/Range/createContextualFragment +--- +<p>La méthode <strong><code>Range.createContextualFragment()</code></strong> retourne un {{domxref("DocumentFragment")}} en invoquant l’algorithme d’analyse de fragment HTML ou l’algorithme d’analyse de fragment XML, avec le début du <code>range</code> (le <em>parent</em> du nœud sélectionné) comme nœud de contexte. L’algorithme d’analyse de fragment HTML est utilisé si le <code>range</code> appartient à un <code>Document</code> dont le bit « HTMLness » est défini. Dans le cas du HTML, si le nœud de contexte est censé être <code>html</code>, pour des raisons historiques l’algorithme d’analyse de fragment est invoqué avec <code>body</code> pour contexte à la place.</p> + +<h2 id="Syntaxe" name="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox"><em>documentFragment</em> = <em>range</em>.createContextualFragment( <em>chaineHTML</em> ) +</pre> + +<h3 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h3> + +<dl> + <dt><em>chaineHTML</em></dt> + <dd>Une chaîne contenant du texte et des balises à convertir en un fragment de document.</dd> +</dl> + +<h2 id="Exemple" name="Exemple">Exemple</h2> + +<pre class="brush: js">var chaineHTML = "<div>Je suis un nœud div<div>"; +var range = document.createRange(); +// fait que le parent de la première div du document devient le nœud de contexte +range.selectNode(document.getElementsByTagName("div").item(0)); +var documentFragment = range.createContextualFragment(chaineHTML); +document.body.appendChild(documentFragment); +</pre> + +<h2 id="Sp.C3.A9cification" name="Sp.C3.A9cification">Spécification</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 Parsing', '#idl-def-range-createcontextualfragment(domstring)', 'Range.createContextualFragment()')}}</td> + <td>{{Spec2('DOM Parsing')}}</td> + <td>Spécification 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>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>11</td> + <td>15.0</td> + <td>9.1.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}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatNo}}</td> + <td>15.0</td> + <td>{{CompatUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li><a href="/fr/docs/Web/API/Document_Object_Model">Index des interfaces DOM</a></li> +</ul> diff --git a/files/fr/web/api/range/detach/index.html b/files/fr/web/api/range/detach/index.html new file mode 100644 index 0000000000..b1b68cd16d --- /dev/null +++ b/files/fr/web/api/range/detach/index.html @@ -0,0 +1,55 @@ +--- +title: Range.detach() +slug: Web/API/Range/detach +translation_of: Web/API/Range/detach +--- +<p>{{ApiRef("DOM")}}</p> + +<p>La méthode <strong><code>Range.detach()</code></strong> n'a aucun effet. Elle permet de désactiver l'objet {{domxref("Range")}} et de libérer les ressources associées. Cette méthode a été conservée pour des raisons de compatibilités.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox">range.detach(); +</pre> + +<h2 id="Exemple">Exemple</h2> + +<pre class="brush:js">var range = document.createRange(); + +range.selectNode(document.getElementsByTagName("div").item(0)); +range.detach(); +</pre> + +<h2 id="Spécifications">Spécifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Spécification</th> + <th scope="col">Status</th> + <th scope="col">Commentaires</th> + </tr> + <tr> + <td>{{SpecName('DOM WHATWG', '#dom-range-detach', 'Range.detach()')}}</td> + <td>{{Spec2('DOM WHATWG')}}</td> + <td>Aucun changement.</td> + </tr> + <tr> + <td>{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-detach', 'Range.detach()')}}</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.detach")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li><a href="/en-US/docs/Web/API/Document_Object_Model">The DOM interfaces index</a></li> +</ul> diff --git a/files/fr/web/api/range/extractcontents/index.html b/files/fr/web/api/range/extractcontents/index.html new file mode 100644 index 0000000000..9415780474 --- /dev/null +++ b/files/fr/web/api/range/extractcontents/index.html @@ -0,0 +1,59 @@ +--- +title: Range.extractContents() +slug: Web/API/Range/extractContents +translation_of: Web/API/Range/extractContents +--- +<p>{{ApiRef("DOM")}}</p> + +<p>La méthode <strong><code>Range.extractContents()</code></strong> déplace le contenu du {{ domxref("Range") }} depuis l’arbre du document dans un {{ domxref("DocumentFragment") }}.</p> + +<p>Les gestionnaires d’évènements ajoutés en utilisant les méthodes du DOM ne sont pas conservés lors de l’extraction. les attributs HTML d’évènements sont conservés ou dupliqués comme ils le seraient avec la méthode {{domxref("Node.cloneNode()")}}. Les attributs HTML id sont également clonés, ce qui peut mener à un document invalide si un nœud partiellement sélectionné est extrait et ajouté au document.</p> + +<p>Les nœuds partiellement sélectionnés sont clonés pour inclure les balises parentes nécessaires pour rendre le fragment de document valide.</p> + +<h2 id="Syntaxe" name="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox"><em>documentFragment</em> = <em>range</em>.extractContents(); +</pre> + +<h2 id="Exemples">Exemples</h2> + +<pre class="brush: js">var range = document.createRange(); +range.selectNode(document.getElementsByTagName("div").item(0)); +var documentFragment = range.extractContents(); +document.body.appendChild(documentFragment); +</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">Commentaire</th> + </tr> + <tr> + <td>{{SpecName('DOM WHATWG', '#dom-range-extractcontents', 'Range.extractContents()')}}</td> + <td>{{Spec2('DOM WHATWG')}}</td> + <td>Pas de changement.</td> + </tr> + <tr> + <td>{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-extractContents', 'Range.extractContents()')}}</td> + <td>{{Spec2('DOM2 Traversal_Range')}}</td> + <td>Spécification initiale.</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div class="hidden">Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et à nous envoyer une <em>pull request</em>.</div> + +<p>{{Compat("api.Range.extractContents")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li><a href="/fr/docs/Web/API/Document_Object_Model">L’index des interfaces DOM</a></li> +</ul> diff --git a/files/fr/web/api/range/index.html b/files/fr/web/api/range/index.html new file mode 100644 index 0000000000..c42a83b4ea --- /dev/null +++ b/files/fr/web/api/range/index.html @@ -0,0 +1,111 @@ +--- +title: range +slug: Web/API/Range +translation_of: Web/API/Range +--- +<p>{{ ApiRef() }}</p> + +<h3 id="Introduction" name="Introduction">Introduction</h3> + +<p>L'objet <code>Range</code> (littéralement : "étendue" ou "portée", ici : "segment") représente un fragment de document qui peut contenir des nœuds et des parties de nœuds texte dans un document donné.</p> + +<p>Un segment peut être crée en utilisant la méthode <a href="/fr/docs/Web/API/document/createRange">createRange</a> de l'objet <a href="/fr/docs/Web/API/document">document</a>. Les objets range peuvent également être récupérés en utilisant la méthode <a href="/fr/docs/Web/API/Selection/getRangeAt">getRangeAt</a> de l'objet <a href="/fr/docs/Web/API/Selection">selection</a>.</p> + +<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s">Propriétés</h3> + +<dl> + <dt><a href="/fr/docs/Web/API/range/collapsed">collapsed</a></dt> + <dd>Renvoie un booléen indiquant si le point de départ et le point final du segment sont confondus.</dd> + <dt><a href="/fr/docs/Web/API/range/commonAncestorContainer">commonAncestorContainer</a></dt> + <dd>Renvoie le nœud le plus profond qui contient à la fois les nœuds <code>startContainer</code> et <code>endContainer</code>.</dd> + <dt><a href="/fr/docs/Web/API/range/endContainer">endContainer</a></dt> + <dd>Renvoie le nœud dans lequel le segment se termine.</dd> + <dt><a href="/fr/docs/Web/API/range/endOffset">endOffset</a></dt> + <dd>Renvoie un nombre représentant l'endroit où le segment se termine dans <code>endContainer</code>.</dd> + <dt><a href="/fr/docs/Web/API/range/startContainer">startContainer</a></dt> + <dd>Renvoie le nœud dans lequel le segment débute.</dd> + <dt><a href="/fr/docs/Web/API/range/startOffset">startOffset</a></dt> + <dd>Renvoie un nombre représentant l'endroit où le segment débute dans <code>startContainer</code>.</dd> +</dl> + +<h3 id="M.C3.A9thodes" name="M.C3.A9thodes">Méthodes</h3> + +<h4 id="M.C3.A9thodes_de_positionnement" name="M.C3.A9thodes_de_positionnement">Méthodes de positionnement</h4> + +<p>Ces méthodes permettent de définir le début et la fin d'un segment.</p> + +<dl> + <dt><a href="/fr/docs/Web/API/range/setStart">setStart</a></dt> + <dd>Définit le point de départ d'un segment.</dd> + <dt><a href="/fr/docs/Web/API/range/setEnd">setEnd</a></dt> + <dd>Définit le point final d'un segment.</dd> + <dt><a href="/fr/docs/Web/API/range/setStartBefore">setStartBefore</a></dt> + <dd>Définit le point de départ d'un segment relativement à un autre nœud.</dd> + <dt><a href="/fr/docs/Web/API/range/setStartAfter">setStartAfter</a></dt> + <dd>Définit le point de départ d'un segment relativement à un autre nœud.</dd> + <dt><a href="/fr/docs/Web/API/range/setEndBefore">setEndBefore</a></dt> + <dd>Définit le point final d'un segment relativement à un autre nœud.</dd> + <dt><a href="/fr/docs/Web/API/range/setEndAfter">setEndAfter</a></dt> + <dd>Définit le point final d'un segment relativement à un autre nœud.</dd> + <dt><a href="/fr/docs/Web/API/range/selectNode">selectNode</a></dt> + <dd>Le contenu du segment devient le nœud et son contenu.</dd> + <dt><a href="/fr/docs/Web/API/range/selectNodeContents">selectNodeContents</a></dt> + <dd>le contenu du segment devient le contenu du nœud.</dd> + <dt><a href="/fr/docs/Web/API/range/collapse">collapse</a></dt> + <dd>Replie le segment sur l'un de ses points frontières.</dd> +</dl> + +<h4 id="M.C3.A9thodes_de_modification" name="M.C3.A9thodes_de_modification">Méthodes de modification</h4> + +<p>Ces méthodes recupèrent les nœuds d'un segment et modifient le contenu d'un segment.</p> + +<dl> + <dt><a href="/fr/docs/Web/API/range/cloneContents">cloneContents</a></dt> + <dd>Renvoie un fragment de document où sont copiés les nœuds d'un segment.</dd> + <dt><a href="/fr/docs/Web/API/range/deleteContents">deleteContents</a></dt> + <dd>Supprime du document le contenu d'un segment.</dd> + <dt><a href="/fr/docs/Web/API/range/extractContents">extractContents</a></dt> + <dd>Déplace le contenu d'un segment, de l'arbre du document vers un fragment de document.</dd> + <dt><a href="/fr/docs/Web/API/range/insertNode">insertNode</a></dt> + <dd>Insère un nœud au début d'un segment.</dd> + <dt><a href="/fr/docs/Web/API/range/surroundContents">surroundContents</a></dt> + <dd>Déplace le contenu d'un segment dans un nouveau nœud.</dd> +</dl> + +<h4 id="Autres_m.C3.A9thodes" name="Autres_m.C3.A9thodes">Autres méthodes</h4> + +<dl> + <dt><a href="/fr/docs/Web/API/range/compareBoundaryPoints">compareBoundaryPoints</a></dt> + <dd>Compare les points frontières de deux segments.</dd> + <dt><a href="/fr/docs/Web/API/range/cloneRange">cloneRange</a></dt> + <dd>Renvoie un objet <code>Range</code> avec des points frontières identiques à ceux du segment cloné.</dd> + <dt><a href="/fr/docs/Web/API/range/detach">detach</a></dt> + <dd>Supprime le segment afin d'améliorer la performance.</dd> + <dt><a href="/fr/docs/Web/API/range/toString">toString</a></dt> + <dd>Renvoie le texte du segment.</dd> +</dl> + +<h4 id="Les_m.C3.A9thodes_Gecko" name="Les_m.C3.A9thodes_Gecko">Les méthodes Gecko</h4> + +<p>Cette section décrit les méthodes de range qui sont particulières à Mozilla et ne font pas partie des spécifications DOM W3C.</p> + +<dl> + <dt><a href="/fr/docs/Web/API/range/compareNode">compareNode</a> {{ Obsolete_inline() }}</dt> + <dd>Renvoie une constante qui indique si le nœud est avant, après, dans ou englobe le segment.</dd> + <dt><a href="/fr/docs/Web/API/range/comparePoint">comparePoint</a></dt> + <dd>Renvoie -1, 0, ou 1, indiquant si le point se trouve avant, après, ou dans le segment.</dd> + <dt><a href="/fr/docs/Web/API/range/createContextualFragment">createContextualFragment</a></dt> + <dd>Renvoie un fragment de document créé à partir d'un morceau de code donné.</dd> + <dt><a href="/fr/docs/Web/API/range/intersectsNode">intersectsNode</a> {{ Obsolete_inline() }}</dt> + <dd>Renvoie un booléen indiquant si un nœud donné a une intersection avec le segment.</dd> + <dt><a href="/fr/docs/Web/API/range/isPointInRange">isPointInRange</a></dt> + <dd>Renvoie un booléen indiquant si le point donné est dans le segment.</dd> +</dl> + +<p><span class="comment">Liens Interwikis</span></p> + +<p> </p> + +<div class="noinclude"> </div> + +<p>{{ languages( { "en": "en/DOM/range", "es": "es/DOM/range", "ja": "ja/DOM/range", "pl": "pl/DOM/range" } ) }}</p> diff --git a/files/fr/web/api/range/insertnode/index.html b/files/fr/web/api/range/insertnode/index.html new file mode 100644 index 0000000000..bec290d0ed --- /dev/null +++ b/files/fr/web/api/range/insertnode/index.html @@ -0,0 +1,115 @@ +--- +title: Range.insertNode() +slug: Web/API/Range/insertNode +translation_of: Web/API/Range/insertNode +--- +<div>{{ApiRef("DOM")}}</div> + +<p>La méthode <code><strong>Range.insertNode()</strong></code> insère un nœud au début du {{domxref("Range")}}.</p> + +<p>Le nouveau nœud est inséré au point de départ du <code>Range</code>. Si le nouveau nœud est sur le point d’être ajouté à un {{domxref("Node")}} texte, ce <code>Node</code> est coupé en deux au point d’insertion, et l’insertion se fait entre les deux nœuds texte.</p> + +<p>Si le nouveau nœud est un fragment de document, les enfants du fragment sont insérés à la place.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox"><em>range</em>.insertNode(<em>newNode</em>); +</pre> + +<h3 id="Paramètres">Paramètres</h3> + +<dl> + <dt><em>newNode</em></dt> + <dd>Le {{domxref("Node")}} à insérer au début du <code>range</code>.</dd> +</dl> + +<h2 id="Exemple">Exemple</h2> + +<pre class="brush: js">range = document.createRange(); +newNode = document.createElement("p"); +newNode.appendChild(document.createTextNode("New Node Inserted Here")); +range.selectNode(document.getElementsByTagName("div").item(0)); +range.insertNode(newNode); +</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">Commentaire</th> + </tr> + <tr> + <td>{{SpecName('DOM WHATWG', '#dom-range-insertnode', 'Range.insertNode()')}}</td> + <td>{{Spec2('DOM WHATWG')}}</td> + <td>Pas de changement</td> + </tr> + <tr> + <td>{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-insertNode', 'Range.insertNode()')}}</td> + <td>{{Spec2('DOM2 Traversal_Range')}}</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>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari</th> + </tr> + <tr> + <td>Support de base</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoDesktop("1.0")}}<br> + {{CompatGeckoDesktop("14.0")}}<sup>[1]</sup></td> + <td>9.0</td> + <td>9.0</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Fonctionnalité</th> + <th>Android</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}}</td> + <td>{{CompatGeckoMobile("1.0")}}<br> + {{CompatGeckoDesktop("14.0")}}<sup>[1]</sup></td> + <td>9.0</td> + <td>9.0</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<p>[1] Avant Gecko 14.0 {{geckoRelease("14.0")}}, cette méthode n’a pas d’effet sur des ranges « collapsés » (dont les points de début et de fin sont confondus). À présent elle se comporte selon la spécification.</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li><a href="/en-US/docs/Web/API/Document_Object_Model">L’index des interfaces DOM</a></li> +</ul> diff --git a/files/fr/web/api/range/selectnode/index.html b/files/fr/web/api/range/selectnode/index.html new file mode 100644 index 0000000000..9cc2d63030 --- /dev/null +++ b/files/fr/web/api/range/selectnode/index.html @@ -0,0 +1,114 @@ +--- +title: Range.selectNode() +slug: Web/API/Range/selectNode +tags: + - API + - DOM + - Méthode + - Range +translation_of: Web/API/Range/selectNode +--- +<p>{{ApiRef("DOM")}}</p> + +<p>La méthode <code>Range.selectNode()</code> définit le {{domxref ("Range")}} destiné à contenir le {{domxref("Node")}} et son contenu. Le {{domxref ("Node")}} parent du début et de la fin du {{domxref("Range")}} sera le même que le parent du <em>noeudDeReference</em>.</p> + +<h2 id="Syntax" name="Syntax">Syntaxe</h2> + +<pre class="syntaxbox"><em>range</em>.selectNode(<em>noeudDeReference</em>); +</pre> + +<h3 id="Parameters" name="Parameters">Paramètres</h3> + +<dl> + <dt><em>noeudDeReference</em></dt> + <dd>Le {{domxref("Node")}} à choisir à l'intérieur d'un <code>{domxref("Range")}}</code>.</dd> +</dl> + +<h2 id="Example" name="Example">Exemple</h2> + +<pre class="brush:js">var range = document.createRange(); +var noeudDeReference = document.getElementsByTagName("div").item(0); + +range.selectNode(noeudDeReference);</pre> + +<h2 id="Specification" name="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-selectnode', 'Range.selectNode()')}}</td> + <td>{{Spec2('DOM WHATWG')}}</td> + <td>Aucun changement.</td> + </tr> + <tr> + <td>{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-selectNode', 'Range.selectNode()')}}</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>{{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>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoDesktop("1.0")}}</td> + <td>9.0</td> + <td>9.0</td> + <td>{{CompatVersionUnknown}}</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}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoMobile("1.0")}}</td> + <td>9.0</td> + <td>9.0</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li><a href="/fr/docs/Web/API/Document_Object_Model">Référence du DOM</a></li> +</ul> diff --git a/files/fr/web/api/range/setstart/index.html b/files/fr/web/api/range/setstart/index.html new file mode 100644 index 0000000000..5f5eea8691 --- /dev/null +++ b/files/fr/web/api/range/setstart/index.html @@ -0,0 +1,121 @@ +--- +title: Range.setStart() +slug: Web/API/Range/setStart +tags: + - API + - DOM + - Method + - Range +translation_of: Web/API/Range/setStart +--- +<p>{{ApiRef("DOM")}}</p> + +<p>La methode <strong><code>Range.setStart() </code></strong>définit la position de départ d'un {{ domxref("Range") }}.</p> + +<p>Si le <code>startNode</code> est un {{ domxref("Node") }} de type <code>Text</code>, <code>Comment</code>, ou <code>CDATASection</code>, alors startOffset est le nombre de caractères depuis le départ du <code>startNode</code>. Pour les autres types de <code>Nœud</code>, <code>startOffset</code> est le nombre de noeuds enfants entre le debut du <code>startNode</code>.</p> + +<p><span id="result_box" lang="fr"><span>Si vous définissez le point de départ en dessous (plus bas dans le document), le point final entraînera une plage réduite avec les points de départ et de fin réglés tous les deux sur la position de départ spécifiée.</span></span></p> + +<h2 id="Syntax" name="Syntax">Syntaxe</h2> + +<pre class="syntaxbox"><em>range</em>.setStart(<em>startNode</em>, <em>startOffset</em>); +</pre> + +<h3 id="Parameters" name="Parameters">Paramètres</h3> + +<dl> + <dt><em>startNode</em></dt> + <dd>{{ domxref("Node") }} ou {{ domxref("Range") }} devrait démarrer.</dd> + <dt><em>startOffset</em></dt> + <dd><span id="result_box" lang="fr"><span>Un entier supérieur ou égal à zéro représentant le décalage pour le début du {{domxref ("Range")}} à partir du début de startNode</span></span>.</dd> +</dl> + +<h2 id="Example" name="Example">Example</h2> + +<pre class="brush: js">var range = document.createRange(); +var startNode = document.getElementsByTagName("p").item(2); +var startOffset = 0; +range.setStart(startNode,startOffset); +</pre> + +<h2 id="Specification" name="Specification">Spécifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('DOM WHATWG', '#dom-range-setstart', 'Range.setStart()')}}</td> + <td>{{Spec2('DOM WHATWG')}}</td> + <td>No change.</td> + </tr> + <tr> + <td>{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-setStart', 'Range.setStart()')}}</td> + <td>{{Spec2('DOM2 Traversal_Range')}}</td> + <td>Initial specification.</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_navigateurs">Compatibilité navigateurs</h2> + +<p>{{CompatibilityTable}}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</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>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoDesktop("1.0")}}</td> + <td>9.0</td> + <td>9.0</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</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}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoMobile("1.0")}}</td> + <td>9.0</td> + <td>9.0</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li><a href="/en-US/docs/DOM/DOM_Reference" title="/en-US/docs/DOM/DOM_Reference">The DOM interfaces index</a></li> +</ul> diff --git a/files/fr/web/api/range/surroundcontents/index.html b/files/fr/web/api/range/surroundcontents/index.html new file mode 100644 index 0000000000..f06b360d27 --- /dev/null +++ b/files/fr/web/api/range/surroundcontents/index.html @@ -0,0 +1,72 @@ +--- +title: Range.surroundContents() +slug: Web/API/Range/surroundContents +translation_of: Web/API/Range/surroundContents +--- +<div>{{ApiRef("DOM")}}</div> + +<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> + +<p>Cette méthode est à peu près équivalente à :</p> + +<pre class="brush: js">newNode.appendChild(range.extractContents()); +range.insertNode(newNode)</pre> + +<p>Après déplacement, les bornes du <code>range</code> incluent <code>newNode</code>.</p> + +<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> + +<h2 id="Syntax" name="Syntax">Syntaxe</h2> + +<pre class="syntaxbox"><em>range</em>.surroundContents(<em>newNode</em>); +</pre> + +<h3 id="Paramètres">Paramètres</h3> + +<dl> + <dt><em>newNode</em></dt> + <dd>Un {{ domxref("Node") }} à insérer à l’emplacement du <code>range</code>.</dd> +</dl> + +<h2 id="Example" name="Example">Exemple</h2> + +<pre class="brush:js">var range = document.createRange(); +var newNode = document.createElement("p"); + +range.selectNode(document.getElementsByTagName("div").item(0)); +range.surroundContents(newNode); +</pre> + +<h2 id="Specification" name="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> + +<div class="hidden">La table de compatibilité sur cette page est génératée à partir de données structurées. Si vous souhaitez contribuer aux données, veuillez consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et nous envoyer une pull request.</div> + +<p>{{Compat("api.Range.surroundContents")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li><a href="/fr/docs/DOM/DOM_Reference" title="/en-US/docs/DOM/DOM_Reference">L’index des interfaces DOM</a></li> +</ul> |
