From 40edc745dfb5c152e12080748f9357b376e8dbe9 Mon Sep 17 00:00:00 2001 From: MDN Date: Tue, 18 May 2021 00:44:37 +0000 Subject: [CRON] sync translated content --- .../orphaned/web/api/elementtraversal/index.html | 42 ++++++++ files/fr/orphaned/web/api/parentnode/index.html | 76 +++++++++++++++ .../web/api/parentnode/queryselector/index.html | 106 +++++++++++++++++++++ .../web/api/parentnode/queryselectorall/index.html | 84 ++++++++++++++++ 4 files changed, 308 insertions(+) create mode 100644 files/fr/orphaned/web/api/elementtraversal/index.html create mode 100644 files/fr/orphaned/web/api/parentnode/index.html create mode 100644 files/fr/orphaned/web/api/parentnode/queryselector/index.html create mode 100644 files/fr/orphaned/web/api/parentnode/queryselectorall/index.html (limited to 'files/fr/orphaned') diff --git a/files/fr/orphaned/web/api/elementtraversal/index.html b/files/fr/orphaned/web/api/elementtraversal/index.html new file mode 100644 index 0000000000..46a59875c6 --- /dev/null +++ b/files/fr/orphaned/web/api/elementtraversal/index.html @@ -0,0 +1,42 @@ +--- +title: ElementTraversal +slug: orphaned/Web/API/ElementTraversal +tags: + - API + - Arborescence + - DOM + - Element + - Interface + - Noeuds +translation_of: Web/API/ElementTraversal +original_slug: Web/API/ElementTraversal +--- +
{{APIRef("DOM")}}{{obsolete_header}}
+ +

L'interface ElementTraversal définissait des méthodes permettant d'accèder depuis un {{domxref("Node")}} (noeud) à un autre dans l'arbre du document.

+ +

Elle s'est avérée inutile, car très peu de types de {{domxref("Node")}} ont pu implémenter toutes ses méthodes et propriétés. Elle a été scindée en deux interfaces, {{domxref ("ChildNode")}} et {{domxref ("ParentNode")}} contenant les méthodes et propriétés utiles pour chacun des types de noeud.

+ +

Comme c'était une pure interface, sans aucun objet de ce type, ce changement n'a eu aucun effet sur le web.

+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#interface-childnode', 'ChildNode')}}{{Spec2('DOM WHATWG')}}L'interface ElementTraversal divisée en interfaces {{domxref("ParentNode")}} et {{domxref("ChildNode")}}
{{SpecName('Element Traversal', '#interface-elementTraversal', 'ElementTraversal')}}{{Spec2('Element Traversal')}}Définition initiale.
diff --git a/files/fr/orphaned/web/api/parentnode/index.html b/files/fr/orphaned/web/api/parentnode/index.html new file mode 100644 index 0000000000..10b417c6d9 --- /dev/null +++ b/files/fr/orphaned/web/api/parentnode/index.html @@ -0,0 +1,76 @@ +--- +title: ParentNode +slug: orphaned/Web/API/ParentNode +tags: + - API +translation_of: Web/API/ParentNode +original_slug: Web/API/ParentNode +--- +

{{ APIRef("DOM") }}

+ +

Le ParentNode contient des méthodes et des propriétés communes à tous les types d'objets {{domxref("Node")}}  qui peuvent avoir des enfants. Il est implémenté par les objets {{domxref("Element")}}, {{domxref("Document")}}, et {{domxref("DocumentFragment")}}.

+ +

Propriétés

+ +
+
{{ domxref("ParentNode.children") }} {{experimental_inline}} {{readonlyInline}}
+
Retourne la {{domxref("HTMLCollection")}} contenant tous les objets de type {{domxref("Element")}} qui sont des enfants de ce ParentNode.
+
{{ domxref("ParentNode.firstElementChild") }} {{experimental_inline}} {{readonlyInline}}
+
Retourne l' {{domxref("Element")}} qui est le premier enfant de ce ParentNode, ou null s'il n'y en a pas.
+
{{ domxref("ParentNode.lastElementChild") }} {{experimental_inline}} {{readonlyInline}}
+
Retourne l'élément {{domxref("Element")}} qui est le dernier enfant de ce ParentNode, ou null s'il n'y en a pas.
+
{{ domxref("ParentNode.childElementCount") }} {{experimental_inline}} {{readonlyInline}}
+
Retourne un unsigned long donnant la quantité d'enfants du parent.
+
+ +

Méthodes

+ +
+
{{domxref("ParentNode.append()")}} {{experimental_inline}}
+
Insère un ensemble d'objets {{domxref("Node")}} ou {{domxref("DOMString")}} après le dernier enfant du ParentNode. Les objets {{domxref("DOMString")}} sont insérés comme équivalents aux noeuds {{domxref("Text")}} .
+
{{domxref("ParentNode.prepend()")}} {{experimental_inline}}
+
Insère un ensemble d'objets {{domxref("Node")}} ou {{domxref("DOMString")}} avant le premier enfant du ParentNode. Les objets {{domxref("DOMString")}} sont insérés comme équivalents aux noeuds {{domxref("Text")}}.
+
{{domxref("ParentNode.querySelector()")}}
+
Retourne le premier {{domxref("Element")}} avec l'élément actuel en tant que racine qui correspond au groupe de sélecteurs spécifié.
+
{{domxref("ParentNode.querySelectorAll()")}}
+
Retourne une {{domxref("NodeList")}} représentant une liste d'éléments avec l'élément courant comme racine qui correspond au groupe de sélecteurs spécifié.
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#parentnode', 'ParentNode')}}{{Spec2('DOM WHATWG')}}Divise l'interface ElementTraversal dans {{domxref("ChildNode")}} et {{domxref("ParentNode")}}. Les propriétés {{domxref("ParentNode.firstElementChild")}}, {{domxref("ParentNode.lastElementChild")}}, et {{domxref("ParentNode.childElementCount")}} sont maintenant définies sur ce dernier. Ajout des propriétés {{domxref("ParentNode.children")}}, et des méthodes {{domxref("ParentNode.querySelector()")}}, {{domxref("ParentNode.querySelectorAll()")}}, {{domxref("ParentNode.append()")}}, et {{domxref("ParentNode.prepend()")}}.
{{SpecName('Element Traversal', '#interface-elementTraversal', 'ElementTraversal')}}{{Spec2('Element Traversal')}}Ajout de la définition initiale de ses propriétés dans l'interface pureElementTraversal, et son utilisation sur {{domxref("Element")}}.
+ +

 

+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.ParentNode")}}

+ +

Voir aussi

+ + diff --git a/files/fr/orphaned/web/api/parentnode/queryselector/index.html b/files/fr/orphaned/web/api/parentnode/queryselector/index.html new file mode 100644 index 0000000000..45d1d0e21b --- /dev/null +++ b/files/fr/orphaned/web/api/parentnode/queryselector/index.html @@ -0,0 +1,106 @@ +--- +title: ParentNode.querySelector() +slug: orphaned/Web/API/ParentNode/querySelector +tags: + - API + - DOM + - Draft + - Method + - NeedsExample + - ParentNode + - Reference + - Selectors + - querySelector +translation_of: Web/API/ParentNode/querySelector +original_slug: Web/API/ParentNode/querySelector +--- +

{{APIRef("DOM")}}{{Draft}}

+ +

Le mixin {{DOMxRef("ParentNode")}} définit la méthode querySelector()  comme renvoyant un {{DOMxRef("Element")}} représentant le premier élément correspondant au groupe de sélecteurs spécifié qui sont les descendants de l'objet sur lequel la méthode a été appelée.

+ +

Si vous avez besoin de tous les éléments correspondant à la liste de sélecteurs, utilisez plutôt {{DOMxRef("ParentNode.querySelectorAll", "querySelectorAll()")}} .

+ +
+

Remarque: Cette méthode est implémentée comme {{DOMxRef("Document.querySelector()")}}, {{DOMxRef("DocumentFragment.querySelector()")}} et {{DOMxRef("Element.querySelector()")}}.

+
+ +

Syntaxe

+ +
élément = parentNode.querySelector(sélécteurs);
+
+ +

Paramètres

+ +
+
sélécteurs
+
Un {{DOMxRef("DOMString")}} contenant un ou plusieurs sélecteurs à comparer. Cette chaîne doit être une compound selector list valide prise en charge par le navigateur; sinon, une exception SyntaxError est levée. Voir Localisation des éléments DOM à l'aide de sélecteurs pour plus d'informations sur l'utilisation des sélecteurs pour identifier les éléments. Plusieurs sélecteurs peuvent être spécifiés en les séparant à l'aide de virgules.
+
+ +
+

Remarque: Les caractères qui ne font pas partie de la syntaxe CSS standard doivent être échappés à l'aide d'un caractère barre oblique inverse. Étant donné que JavaScript utilise également l'échappement arrière, une attention particulière doit être apportée lors de l'écriture de littéraux de chaîne à l'aide de ces caractères. Voir {{anch("Escaping special characters")}} pour plus d'informations.

+
+ +

Retourner une valeur

+ +

Le premier {{DOMxRef("Element")}} qui correspond à au moins l'un des sélecteurs spécifiés ou null si aucun élément de ce type n'est trouvé.

+ +
+

Remarque: Si le spécifié sélécteurs inclut un pseudo-élément CSS,  la valeur renvoyée est toujours null.

+
+ +

Des exceptions

+ +
+
SyntaxError
+
La syntaxe de la chaîne sélécteurs spécifiée n'est pas valide.
+
+ +

Caractéristiques

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName("DOM WHATWG", "#dom-parentnode-queryselector", "ParentNode.querySelector()")}}{{Spec2("DOM WHATWG")}}Niveau de vie
{{SpecName("Selectors API Level 2", "#dom-parentnode-queryselector", "ParentNode.querySelector()")}}{{Spec2("Selectors API Level 2")}}Pas de changement
{{SpecName("DOM4", "#dom-parentnode-queryselector", "ParentNode.querySelector()")}}{{Spec2("DOM4")}}Définition initiale
{{SpecName("Selectors API Level 1", "#interface-definitions", "document.querySelector()")}}{{Spec2("Selectors API Level 1")}}Définition originale
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.ParentNode.querySelector")}}

+ +

Voir également

+ + diff --git a/files/fr/orphaned/web/api/parentnode/queryselectorall/index.html b/files/fr/orphaned/web/api/parentnode/queryselectorall/index.html new file mode 100644 index 0000000000..054007e471 --- /dev/null +++ b/files/fr/orphaned/web/api/parentnode/queryselectorall/index.html @@ -0,0 +1,84 @@ +--- +title: ParentNode.querySelectorAll() +slug: orphaned/Web/API/ParentNode/querySelectorAll +tags: + - API + - DOM + - Méthodes + - Noeuds + - Sélecteurs + - parent +translation_of: Web/API/ParentNode/querySelectorAll +original_slug: Web/API/ParentNode/querySelectorAll +--- +
{{ApiRef("DOM")}}
+ +

Renvoie une {{domxref("NodeList")}} représentant une liste d'éléments avec l'élément courant comme racine et qui correspondent au groupe de sélecteurs spécifiés.

+ +

Syntaxe

+ +
elementList = document.querySelectorAll(selectors);
+
+ +

+ + + +

La NodeList retournée contiendra tous les éléments dans le document qui correspondent à l'un des sélecteurs spécifiés. Si la chaîne selectors contient un pseudo-element CSS, la elementList retournée sera vide.

+ +

Exemples

+ +

Cet exemple renvoie une liste de tous les éléments div d'un document avec une classe "note" ou "alert" :

+ +
var matches = document.querySelectorAll("div.note, div.alert");
+
+ +

Notes

+ +

Renvoie une NodeList non directe de tous les noeuds éléments correspondant.

+ +

Lance une exception SYNTAX_ERR si le groupe de sélecteurs spécifié est invalide.

+ +

querySelectorAll() fut introduite dans l'API WebApps.

+ +

L'argument chaîne passé à querySelectorAll() doit suivre la syntaxe CSS. Voir {{domxref("document.querySelector")}} pour des exemples concrets.

+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName("Selectors API Level 2", "#dom-parentnode-queryselectorall", "ParentNode.querySelectorAll()")}}{{Spec2("Selectors API Level 2")}}Pas de changement.
{{SpecName("DOM4", "#dom-parentnode-queryselectorall", "ParentNode.querySelectorAll()")}}{{Spec2("DOM4")}}Définition initiale.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.ParentNode.querySelectorAll")}}

+ + +

Voir aussi

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