From c05efa8d7ae464235cf83d7c0956e42dc6974103 Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:14 +0200 Subject: move *.html to *.md --- .../api/range/createcontextualfragment/index.html | 57 ------------ .../api/range/createcontextualfragment/index.md | 57 ++++++++++++ files/fr/web/api/range/detach/index.html | 55 ----------- files/fr/web/api/range/detach/index.md | 55 +++++++++++ files/fr/web/api/range/extractcontents/index.html | 57 ------------ files/fr/web/api/range/extractcontents/index.md | 57 ++++++++++++ files/fr/web/api/range/index.html | 103 --------------------- files/fr/web/api/range/index.md | 103 +++++++++++++++++++++ files/fr/web/api/range/insertnode/index.html | 65 ------------- files/fr/web/api/range/insertnode/index.md | 65 +++++++++++++ files/fr/web/api/range/selectnode/index.html | 64 ------------- files/fr/web/api/range/selectnode/index.md | 64 +++++++++++++ files/fr/web/api/range/setstart/index.html | 71 -------------- files/fr/web/api/range/setstart/index.md | 71 ++++++++++++++ files/fr/web/api/range/surroundcontents/index.html | 70 -------------- files/fr/web/api/range/surroundcontents/index.md | 70 ++++++++++++++ 16 files changed, 542 insertions(+), 542 deletions(-) delete mode 100644 files/fr/web/api/range/createcontextualfragment/index.html create mode 100644 files/fr/web/api/range/createcontextualfragment/index.md delete mode 100644 files/fr/web/api/range/detach/index.html create mode 100644 files/fr/web/api/range/detach/index.md delete mode 100644 files/fr/web/api/range/extractcontents/index.html create mode 100644 files/fr/web/api/range/extractcontents/index.md delete mode 100644 files/fr/web/api/range/index.html create mode 100644 files/fr/web/api/range/index.md delete mode 100644 files/fr/web/api/range/insertnode/index.html create mode 100644 files/fr/web/api/range/insertnode/index.md delete mode 100644 files/fr/web/api/range/selectnode/index.html create mode 100644 files/fr/web/api/range/selectnode/index.md delete mode 100644 files/fr/web/api/range/setstart/index.html create mode 100644 files/fr/web/api/range/setstart/index.md delete mode 100644 files/fr/web/api/range/surroundcontents/index.html create mode 100644 files/fr/web/api/range/surroundcontents/index.md (limited to 'files/fr/web/api/range') diff --git a/files/fr/web/api/range/createcontextualfragment/index.html b/files/fr/web/api/range/createcontextualfragment/index.html deleted file mode 100644 index 6f9342d87d..0000000000 --- a/files/fr/web/api/range/createcontextualfragment/index.html +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: Range.createContextualFragment() -slug: Web/API/Range/createContextualFragment -translation_of: Web/API/Range/createContextualFragment ---- -

La méthode Range.createContextualFragment() 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 range (le parent du nœud sélectionné) comme nœud de contexte. L’algorithme d’analyse de fragment HTML est utilisé si le range appartient à un Document dont le bit « HTMLness » est défini. Dans le cas du HTML, si le nœud de contexte est censé être html, pour des raisons historiques l’algorithme d’analyse de fragment est invoqué avec body pour contexte à la place.

- -

Syntaxe

- -
documentFragment = range.createContextualFragment( chaineHTML )
-
- -

Paramètres

- -
-
chaineHTML
-
Une chaîne contenant du texte et des balises à convertir en un fragment de document.
-
- -

Exemple

- -
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);
-
- -

Spécification

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM Parsing', '#idl-def-range-createcontextualfragment(domstring)', 'Range.createContextualFragment()')}}{{Spec2('DOM Parsing')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Range.createContextualFragment")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/range/createcontextualfragment/index.md b/files/fr/web/api/range/createcontextualfragment/index.md new file mode 100644 index 0000000000..6f9342d87d --- /dev/null +++ b/files/fr/web/api/range/createcontextualfragment/index.md @@ -0,0 +1,57 @@ +--- +title: Range.createContextualFragment() +slug: Web/API/Range/createContextualFragment +translation_of: Web/API/Range/createContextualFragment +--- +

La méthode Range.createContextualFragment() 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 range (le parent du nœud sélectionné) comme nœud de contexte. L’algorithme d’analyse de fragment HTML est utilisé si le range appartient à un Document dont le bit « HTMLness » est défini. Dans le cas du HTML, si le nœud de contexte est censé être html, pour des raisons historiques l’algorithme d’analyse de fragment est invoqué avec body pour contexte à la place.

+ +

Syntaxe

+ +
documentFragment = range.createContextualFragment( chaineHTML )
+
+ +

Paramètres

+ +
+
chaineHTML
+
Une chaîne contenant du texte et des balises à convertir en un fragment de document.
+
+ +

Exemple

+ +
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);
+
+ +

Spécification

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('DOM Parsing', '#idl-def-range-createcontextualfragment(domstring)', 'Range.createContextualFragment()')}}{{Spec2('DOM Parsing')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Range.createContextualFragment")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/range/detach/index.html b/files/fr/web/api/range/detach/index.html deleted file mode 100644 index b1b68cd16d..0000000000 --- a/files/fr/web/api/range/detach/index.html +++ /dev/null @@ -1,55 +0,0 @@ ---- -title: Range.detach() -slug: Web/API/Range/detach -translation_of: Web/API/Range/detach ---- -

{{ApiRef("DOM")}}

- -

La méthode Range.detach() 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.

- -

Syntaxe

- -
range.detach();
-
- -

Exemple

- -
var range = document.createRange();
-
-range.selectNode(document.getElementsByTagName("div").item(0));
-range.detach();
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatusCommentaires
{{SpecName('DOM WHATWG', '#dom-range-detach', 'Range.detach()')}}{{Spec2('DOM WHATWG')}}Aucun changement.
{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-detach', 'Range.detach()')}}{{Spec2('DOM2 Traversal_Range')}}Spécification initiale.
- -

Compatibilité des navigateurs

- - - -

{{Compat("api.Range.detach")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/range/detach/index.md b/files/fr/web/api/range/detach/index.md new file mode 100644 index 0000000000..b1b68cd16d --- /dev/null +++ b/files/fr/web/api/range/detach/index.md @@ -0,0 +1,55 @@ +--- +title: Range.detach() +slug: Web/API/Range/detach +translation_of: Web/API/Range/detach +--- +

{{ApiRef("DOM")}}

+ +

La méthode Range.detach() 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.

+ +

Syntaxe

+ +
range.detach();
+
+ +

Exemple

+ +
var range = document.createRange();
+
+range.selectNode(document.getElementsByTagName("div").item(0));
+range.detach();
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatusCommentaires
{{SpecName('DOM WHATWG', '#dom-range-detach', 'Range.detach()')}}{{Spec2('DOM WHATWG')}}Aucun changement.
{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-detach', 'Range.detach()')}}{{Spec2('DOM2 Traversal_Range')}}Spécification initiale.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.Range.detach")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/range/extractcontents/index.html b/files/fr/web/api/range/extractcontents/index.html deleted file mode 100644 index dd0d7a672d..0000000000 --- a/files/fr/web/api/range/extractcontents/index.html +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: Range.extractContents() -slug: Web/API/Range/extractContents -translation_of: Web/API/Range/extractContents ---- -

{{ApiRef("DOM")}}

- -

La méthode Range.extractContents() déplace le contenu du {{ domxref("Range") }} depuis l’arbre du document dans un {{ domxref("DocumentFragment") }}.

- -

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.

- -

Les nœuds partiellement sélectionnés sont clonés pour inclure les balises parentes nécessaires pour rendre le fragment de document valide.

- -

Syntaxe

- -
documentFragment = range.extractContents();
-
- -

Exemples

- -
var range = document.createRange();
-range.selectNode(document.getElementsByTagName("div").item(0));
-var documentFragment = range.extractContents();
-document.body.appendChild(documentFragment);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#dom-range-extractcontents', 'Range.extractContents()')}}{{Spec2('DOM WHATWG')}}Pas de changement.
{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-extractContents', 'Range.extractContents()')}}{{Spec2('DOM2 Traversal_Range')}}Spécification initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Range.extractContents")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/range/extractcontents/index.md b/files/fr/web/api/range/extractcontents/index.md new file mode 100644 index 0000000000..dd0d7a672d --- /dev/null +++ b/files/fr/web/api/range/extractcontents/index.md @@ -0,0 +1,57 @@ +--- +title: Range.extractContents() +slug: Web/API/Range/extractContents +translation_of: Web/API/Range/extractContents +--- +

{{ApiRef("DOM")}}

+ +

La méthode Range.extractContents() déplace le contenu du {{ domxref("Range") }} depuis l’arbre du document dans un {{ domxref("DocumentFragment") }}.

+ +

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.

+ +

Les nœuds partiellement sélectionnés sont clonés pour inclure les balises parentes nécessaires pour rendre le fragment de document valide.

+ +

Syntaxe

+ +
documentFragment = range.extractContents();
+
+ +

Exemples

+ +
var range = document.createRange();
+range.selectNode(document.getElementsByTagName("div").item(0));
+var documentFragment = range.extractContents();
+document.body.appendChild(documentFragment);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#dom-range-extractcontents', 'Range.extractContents()')}}{{Spec2('DOM WHATWG')}}Pas de changement.
{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-extractContents', 'Range.extractContents()')}}{{Spec2('DOM2 Traversal_Range')}}Spécification initiale.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Range.extractContents")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/range/index.html b/files/fr/web/api/range/index.html deleted file mode 100644 index a17b45d829..0000000000 --- a/files/fr/web/api/range/index.html +++ /dev/null @@ -1,103 +0,0 @@ ---- -title: range -slug: Web/API/Range -translation_of: Web/API/Range ---- -

{{ ApiRef() }}

- -

Introduction

- -

L'objet Range (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é.

- -

Un segment peut être crée en utilisant la méthode createRange de l'objet document. Les objets range peuvent également être récupérés en utilisant la méthode getRangeAt de l'objet selection.

- -

Propriétés

- -
-
collapsed
-
Renvoie un booléen indiquant si le point de départ et le point final du segment sont confondus.
-
commonAncestorContainer
-
Renvoie le nœud le plus profond qui contient à la fois les nœuds startContainer et endContainer.
-
endContainer
-
Renvoie le nœud dans lequel le segment se termine.
-
endOffset
-
Renvoie un nombre représentant l'endroit où le segment se termine dans endContainer.
-
startContainer
-
Renvoie le nœud dans lequel le segment débute.
-
startOffset
-
Renvoie un nombre représentant l'endroit où le segment débute dans startContainer.
-
- -

Méthodes

- -

Méthodes de positionnement

- -

Ces méthodes permettent de définir le début et la fin d'un segment.

- -
-
setStart
-
Définit le point de départ d'un segment.
-
setEnd
-
Définit le point final d'un segment.
-
setStartBefore
-
Définit le point de départ d'un segment relativement à un autre nœud.
-
setStartAfter
-
Définit le point de départ d'un segment relativement à un autre nœud.
-
setEndBefore
-
Définit le point final d'un segment relativement à un autre nœud.
-
setEndAfter
-
Définit le point final d'un segment relativement à un autre nœud.
-
selectNode
-
Le contenu du segment devient le nœud et son contenu.
-
selectNodeContents
-
le contenu du segment devient le contenu du nœud.
-
collapse
-
Replie le segment sur l'un de ses points frontières.
-
- -

Méthodes de modification

- -

Ces méthodes recupèrent les nœuds d'un segment et modifient le contenu d'un segment.

- -
-
cloneContents
-
Renvoie un fragment de document où sont copiés les nœuds d'un segment.
-
deleteContents
-
Supprime du document le contenu d'un segment.
-
extractContents
-
Déplace le contenu d'un segment, de l'arbre du document vers un fragment de document.
-
insertNode
-
Insère un nœud au début d'un segment.
-
surroundContents
-
Déplace le contenu d'un segment dans un nouveau nœud.
-
- -

Autres méthodes

- -
-
compareBoundaryPoints
-
Compare les points frontières de deux segments.
-
cloneRange
-
Renvoie un objet Range avec des points frontières identiques à ceux du segment cloné.
-
detach
-
Supprime le segment afin d'améliorer la performance.
-
toString
-
Renvoie le texte du segment.
-
- -

Les méthodes Gecko

- -

Cette section décrit les méthodes de range qui sont particulières à Mozilla et ne font pas partie des spécifications DOM W3C.

- -
-
compareNode {{ Obsolete_inline() }}
-
Renvoie une constante qui indique si le nœud est avant, après, dans ou englobe le segment.
-
comparePoint
-
Renvoie -1, 0, ou 1, indiquant si le point se trouve avant, après, ou dans le segment.
-
createContextualFragment
-
Renvoie un fragment de document créé à partir d'un morceau de code donné.
-
intersectsNode {{ Obsolete_inline() }}
-
Renvoie un booléen indiquant si un nœud donné a une intersection avec le segment.
-
isPointInRange
-
Renvoie un booléen indiquant si le point donné est dans le segment.
-
\ No newline at end of file diff --git a/files/fr/web/api/range/index.md b/files/fr/web/api/range/index.md new file mode 100644 index 0000000000..a17b45d829 --- /dev/null +++ b/files/fr/web/api/range/index.md @@ -0,0 +1,103 @@ +--- +title: range +slug: Web/API/Range +translation_of: Web/API/Range +--- +

{{ ApiRef() }}

+ +

Introduction

+ +

L'objet Range (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é.

+ +

Un segment peut être crée en utilisant la méthode createRange de l'objet document. Les objets range peuvent également être récupérés en utilisant la méthode getRangeAt de l'objet selection.

+ +

Propriétés

+ +
+
collapsed
+
Renvoie un booléen indiquant si le point de départ et le point final du segment sont confondus.
+
commonAncestorContainer
+
Renvoie le nœud le plus profond qui contient à la fois les nœuds startContainer et endContainer.
+
endContainer
+
Renvoie le nœud dans lequel le segment se termine.
+
endOffset
+
Renvoie un nombre représentant l'endroit où le segment se termine dans endContainer.
+
startContainer
+
Renvoie le nœud dans lequel le segment débute.
+
startOffset
+
Renvoie un nombre représentant l'endroit où le segment débute dans startContainer.
+
+ +

Méthodes

+ +

Méthodes de positionnement

+ +

Ces méthodes permettent de définir le début et la fin d'un segment.

+ +
+
setStart
+
Définit le point de départ d'un segment.
+
setEnd
+
Définit le point final d'un segment.
+
setStartBefore
+
Définit le point de départ d'un segment relativement à un autre nœud.
+
setStartAfter
+
Définit le point de départ d'un segment relativement à un autre nœud.
+
setEndBefore
+
Définit le point final d'un segment relativement à un autre nœud.
+
setEndAfter
+
Définit le point final d'un segment relativement à un autre nœud.
+
selectNode
+
Le contenu du segment devient le nœud et son contenu.
+
selectNodeContents
+
le contenu du segment devient le contenu du nœud.
+
collapse
+
Replie le segment sur l'un de ses points frontières.
+
+ +

Méthodes de modification

+ +

Ces méthodes recupèrent les nœuds d'un segment et modifient le contenu d'un segment.

+ +
+
cloneContents
+
Renvoie un fragment de document où sont copiés les nœuds d'un segment.
+
deleteContents
+
Supprime du document le contenu d'un segment.
+
extractContents
+
Déplace le contenu d'un segment, de l'arbre du document vers un fragment de document.
+
insertNode
+
Insère un nœud au début d'un segment.
+
surroundContents
+
Déplace le contenu d'un segment dans un nouveau nœud.
+
+ +

Autres méthodes

+ +
+
compareBoundaryPoints
+
Compare les points frontières de deux segments.
+
cloneRange
+
Renvoie un objet Range avec des points frontières identiques à ceux du segment cloné.
+
detach
+
Supprime le segment afin d'améliorer la performance.
+
toString
+
Renvoie le texte du segment.
+
+ +

Les méthodes Gecko

+ +

Cette section décrit les méthodes de range qui sont particulières à Mozilla et ne font pas partie des spécifications DOM W3C.

+ +
+
compareNode {{ Obsolete_inline() }}
+
Renvoie une constante qui indique si le nœud est avant, après, dans ou englobe le segment.
+
comparePoint
+
Renvoie -1, 0, ou 1, indiquant si le point se trouve avant, après, ou dans le segment.
+
createContextualFragment
+
Renvoie un fragment de document créé à partir d'un morceau de code donné.
+
intersectsNode {{ Obsolete_inline() }}
+
Renvoie un booléen indiquant si un nœud donné a une intersection avec le segment.
+
isPointInRange
+
Renvoie un booléen indiquant si le point donné est dans le segment.
+
\ No newline at end of file diff --git a/files/fr/web/api/range/insertnode/index.html b/files/fr/web/api/range/insertnode/index.html deleted file mode 100644 index bfbe3dc9df..0000000000 --- a/files/fr/web/api/range/insertnode/index.html +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Range.insertNode() -slug: Web/API/Range/insertNode -translation_of: Web/API/Range/insertNode ---- -
{{ApiRef("DOM")}}
- -

La méthode Range.insertNode() insère un nœud au début du {{domxref("Range")}}.

- -

Le nouveau nœud est inséré au point de départ du Range. Si le nouveau nœud est sur le point d’être ajouté à un {{domxref("Node")}} texte, ce Node est coupé en deux au point d’insertion, et l’insertion se fait entre les deux nœuds texte.

- -

Si le nouveau nœud est un fragment de document, les enfants du fragment sont insérés à la place.

- -

Syntaxe

- -
range.insertNode(newNode);
-
- -

Paramètres

- -
-
newNode
-
Le {{domxref("Node")}} à insérer au début du range.
-
- -

Exemple

- -
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);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#dom-range-insertnode', 'Range.insertNode()')}}{{Spec2('DOM WHATWG')}}Pas de changement
{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-insertNode', 'Range.insertNode()')}}{{Spec2('DOM2 Traversal_Range')}}Définition initiale
- -

Compatibilité des navigateurs

- -

{{Compat("api.Range.insertNode")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/range/insertnode/index.md b/files/fr/web/api/range/insertnode/index.md new file mode 100644 index 0000000000..bfbe3dc9df --- /dev/null +++ b/files/fr/web/api/range/insertnode/index.md @@ -0,0 +1,65 @@ +--- +title: Range.insertNode() +slug: Web/API/Range/insertNode +translation_of: Web/API/Range/insertNode +--- +
{{ApiRef("DOM")}}
+ +

La méthode Range.insertNode() insère un nœud au début du {{domxref("Range")}}.

+ +

Le nouveau nœud est inséré au point de départ du Range. Si le nouveau nœud est sur le point d’être ajouté à un {{domxref("Node")}} texte, ce Node est coupé en deux au point d’insertion, et l’insertion se fait entre les deux nœuds texte.

+ +

Si le nouveau nœud est un fragment de document, les enfants du fragment sont insérés à la place.

+ +

Syntaxe

+ +
range.insertNode(newNode);
+
+ +

Paramètres

+ +
+
newNode
+
Le {{domxref("Node")}} à insérer au début du range.
+
+ +

Exemple

+ +
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);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#dom-range-insertnode', 'Range.insertNode()')}}{{Spec2('DOM WHATWG')}}Pas de changement
{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-insertNode', 'Range.insertNode()')}}{{Spec2('DOM2 Traversal_Range')}}Définition initiale
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Range.insertNode")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/range/selectnode/index.html b/files/fr/web/api/range/selectnode/index.html deleted file mode 100644 index 25e418cc4d..0000000000 --- a/files/fr/web/api/range/selectnode/index.html +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: Range.selectNode() -slug: Web/API/Range/selectNode -tags: - - API - - DOM - - Méthode - - Range -translation_of: Web/API/Range/selectNode ---- -

{{ApiRef("DOM")}}

- -

La méthode Range.selectNode() 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 noeudDeReference.

- -

Syntaxe

- -
range.selectNode(noeudDeReference);
-
- -

Paramètres

- -
-
noeudDeReference
-
Le {{domxref("Node")}} à choisir à l'intérieur d'un {domxref("Range")}}.
-
- -

Exemple

- -
var range = document.createRange();
-var noeudDeReference = document.getElementsByTagName("div").item(0);
-
-range.selectNode(noeudDeReference);
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#dom-range-selectnode', 'Range.selectNode()')}}{{Spec2('DOM WHATWG')}}Aucun changement.
{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-selectNode', 'Range.selectNode()')}}{{Spec2('DOM2 Traversal_Range')}}Spécification initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Range.selectNode")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/range/selectnode/index.md b/files/fr/web/api/range/selectnode/index.md new file mode 100644 index 0000000000..25e418cc4d --- /dev/null +++ b/files/fr/web/api/range/selectnode/index.md @@ -0,0 +1,64 @@ +--- +title: Range.selectNode() +slug: Web/API/Range/selectNode +tags: + - API + - DOM + - Méthode + - Range +translation_of: Web/API/Range/selectNode +--- +

{{ApiRef("DOM")}}

+ +

La méthode Range.selectNode() 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 noeudDeReference.

+ +

Syntaxe

+ +
range.selectNode(noeudDeReference);
+
+ +

Paramètres

+ +
+
noeudDeReference
+
Le {{domxref("Node")}} à choisir à l'intérieur d'un {domxref("Range")}}.
+
+ +

Exemple

+ +
var range = document.createRange();
+var noeudDeReference = document.getElementsByTagName("div").item(0);
+
+range.selectNode(noeudDeReference);
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#dom-range-selectnode', 'Range.selectNode()')}}{{Spec2('DOM WHATWG')}}Aucun changement.
{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-selectNode', 'Range.selectNode()')}}{{Spec2('DOM2 Traversal_Range')}}Spécification initiale.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Range.selectNode")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/range/setstart/index.html b/files/fr/web/api/range/setstart/index.html deleted file mode 100644 index 019a481c37..0000000000 --- a/files/fr/web/api/range/setstart/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Range.setStart() -slug: Web/API/Range/setStart -tags: - - API - - DOM - - Method - - Range -translation_of: Web/API/Range/setStart ---- -

{{ApiRef("DOM")}}

- -

La methode Range.setStart() définit la position de départ d'un {{ domxref("Range") }}.

- -

Si le startNode est un {{ domxref("Node") }}  de type Text, Comment, ou CDATASection, alors startOffset est le nombre de caractères depuis le départ du startNode. Pour les autres types de Nœud, startOffset est le nombre de noeuds enfants entre le debut du startNode.

- -

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.

- -

Syntaxe

- -
range.setStart(startNode, startOffset);
-
- -

Paramètres

- -
-
startNode
-
{{ domxref("Node") }} ou {{ domxref("Range") }} devrait démarrer.
-
startOffset
-
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.
-
- -

Example

- -
var range = document.createRange();
-var startNode = document.getElementsByTagName("p").item(2);
-var startOffset = 0;
-range.setStart(startNode,startOffset);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpecificationStatutCommentaire
{{SpecName('DOM WHATWG', '#dom-range-setstart', 'Range.setStart()')}}{{Spec2('DOM WHATWG')}}
{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-setStart', 'Range.setStart()')}}{{Spec2('DOM2 Traversal_Range')}}Définition initiale.
- -

Compatibilité navigateurs

- -

{{Compat("api.Range.setStart")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/range/setstart/index.md b/files/fr/web/api/range/setstart/index.md new file mode 100644 index 0000000000..019a481c37 --- /dev/null +++ b/files/fr/web/api/range/setstart/index.md @@ -0,0 +1,71 @@ +--- +title: Range.setStart() +slug: Web/API/Range/setStart +tags: + - API + - DOM + - Method + - Range +translation_of: Web/API/Range/setStart +--- +

{{ApiRef("DOM")}}

+ +

La methode Range.setStart() définit la position de départ d'un {{ domxref("Range") }}.

+ +

Si le startNode est un {{ domxref("Node") }}  de type Text, Comment, ou CDATASection, alors startOffset est le nombre de caractères depuis le départ du startNode. Pour les autres types de Nœud, startOffset est le nombre de noeuds enfants entre le debut du startNode.

+ +

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.

+ +

Syntaxe

+ +
range.setStart(startNode, startOffset);
+
+ +

Paramètres

+ +
+
startNode
+
{{ domxref("Node") }} ou {{ domxref("Range") }} devrait démarrer.
+
startOffset
+
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.
+
+ +

Example

+ +
var range = document.createRange();
+var startNode = document.getElementsByTagName("p").item(2);
+var startOffset = 0;
+range.setStart(startNode,startOffset);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatutCommentaire
{{SpecName('DOM WHATWG', '#dom-range-setstart', 'Range.setStart()')}}{{Spec2('DOM WHATWG')}}
{{SpecName('DOM2 Traversal_Range', 'ranges.html#Level2-Range-method-setStart', 'Range.setStart()')}}{{Spec2('DOM2 Traversal_Range')}}Définition initiale.
+ +

Compatibilité navigateurs

+ +

{{Compat("api.Range.setStart")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/range/surroundcontents/index.html b/files/fr/web/api/range/surroundcontents/index.html deleted file mode 100644 index 4b8b6fa87e..0000000000 --- a/files/fr/web/api/range/surroundcontents/index.html +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: Range.surroundContents() -slug: Web/API/Range/surroundContents -translation_of: Web/API/Range/surroundContents ---- -
{{ApiRef("DOM")}}
- -

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é.

- -

Cette méthode est à peu près équivalente à :

- -
newNode.appendChild(range.extractContents());
-range.insertNode(newNode)
- -

Après déplacement, les bornes du range incluent newNode.

- -

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.

- -

Syntaxe

- -
range.surroundContents(newNode);
-
- -

Paramètres

- -
-
newNode
-
Un {{ domxref("Node") }} à insérer à l’emplacement du range.
-
- -

Exemple

- -
var range = document.createRange();
-var newNode = document.createElement("p");
-
-range.selectNode(document.getElementsByTagName("div").item(0));
-range.surroundContents(newNode);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{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

- - diff --git a/files/fr/web/api/range/surroundcontents/index.md b/files/fr/web/api/range/surroundcontents/index.md new file mode 100644 index 0000000000..4b8b6fa87e --- /dev/null +++ b/files/fr/web/api/range/surroundcontents/index.md @@ -0,0 +1,70 @@ +--- +title: Range.surroundContents() +slug: Web/API/Range/surroundContents +translation_of: Web/API/Range/surroundContents +--- +
{{ApiRef("DOM")}}
+ +

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é.

+ +

Cette méthode est à peu près équivalente à :

+ +
newNode.appendChild(range.extractContents());
+range.insertNode(newNode)
+ +

Après déplacement, les bornes du range incluent newNode.

+ +

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.

+ +

Syntaxe

+ +
range.surroundContents(newNode);
+
+ +

Paramètres

+ +
+
newNode
+
Un {{ domxref("Node") }} à insérer à l’emplacement du range.
+
+ +

Exemple

+ +
var range = document.createRange();
+var newNode = document.createElement("p");
+
+range.selectNode(document.getElementsByTagName("div").item(0));
+range.surroundContents(newNode);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{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

+ + -- cgit v1.2.3-54-g00ecf