From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- files/fr/web/api/element/matches/index.md | 122 +++++++++++++----------------- 1 file changed, 52 insertions(+), 70 deletions(-) (limited to 'files/fr/web/api/element/matches/index.md') diff --git a/files/fr/web/api/element/matches/index.md b/files/fr/web/api/element/matches/index.md index 21e4a2ee68..40ef961ca7 100644 --- a/files/fr/web/api/element/matches/index.md +++ b/files/fr/web/api/element/matches/index.md @@ -7,102 +7,84 @@ tags: - Selector translation_of: Web/API/Element/matches --- -

{{ APIRef("DOM") }}

+{{ APIRef("DOM") }} -

La méthode element.matches() renvoie true lorsque l'élément peut être sélectionné par le sélecteur défini par la chaîne passée en paramêtre; sinon, elle renvoie false.

+`La méthode `**`element.matches()`** renvoie `true` lorsque l'élément peut être sélectionné par le sélecteur défini par la chaîne passée en paramêtre; sinon, elle renvoie `false`. -
-

Attention : Certains navigateurs implémentent cette méthode sous le nom matchesSelector() non-standardisé et préfixé.

-
+> **Attention :** Certains navigateurs implémentent cette méthode sous le nom `matchesSelector()` non-standardisé et préfixé. -

Syntaxe

+## Syntaxe -
var result = element.matches(selectorString);
-
+ var result = element.matches(selectorString); - +- `result` contient la valeur retournée `true` ou `false`. +- `selectorString` est une chaîne définissant le sélecteur à tester sur l'élément. -

Exemple

+## Exemple -
<ul id="birds">
-  <li>perroquet amazone</li>
-  <li class="endangered">aigle des Philippines</li>
-  <li>pélican blanc</li>
-</ul>
+```html
+
 
-<script type="text/javascript">
+
+```
 
-
Ce code affichera l'alerte "Le - aigle des Philippines - est en voie de disparition !" sur la console, puisque l'élèment possède l'attribut class de valeur endangered.

+Ce code affichera l'alerte "Le - aigle des Philippines - est en voie de disparition !" sur la console, puisque l'élèment possède l'attribut` class `de valeur `endangered`.
 
-
Exceptions

+## Exceptions
 
-

- 
SYNTAX_ERR

- 
Lorsque la chaîne passée en paramêtre défini sélecteur invalide.

-

+- `SYNTAX_ERR`
+  - : Lorsque la chaîne passée en paramêtre défini sélecteur invalide.
 
-
Polyfill

+## Polyfill
 
-
Pour les navigateurs qui ne supportent pas Element.matches() ou Element.matchesSelector(), mais fournissent le support de document.querySelectorAll(), il existe un polyfill :

+Pour les navigateurs qui ne supportent pas `Element.matches()` ou `Element.matchesSelector()`, mais fournissent le support de` document.querySelectorAll()`, il existe un _polyfill_ :
 
-
if (!Element.prototype.matches) {
-    Element.prototype.matches =
-        Element.prototype.matchesSelector ||
-        Element.prototype.mozMatchesSelector ||
-        Element.prototype.msMatchesSelector ||
-        Element.prototype.oMatchesSelector ||
-        Element.prototype.webkitMatchesSelector ||
-        function(s) {
-            var matches = (this.document || this.ownerDocument).querySelectorAll(s),
-                i = matches.length;
-            while (--i >= 0 && matches.item(i) !== this) {}
-            return i > -1;
-        };
-}

+    if (!Element.prototype.matches) {
+        Element.prototype.matches =
+            Element.prototype.matchesSelector ||
+            Element.prototype.mozMatchesSelector ||
+            Element.prototype.msMatchesSelector ||
+            Element.prototype.oMatchesSelector ||
+            Element.prototype.webkitMatchesSelector ||
+            function(s) {
+                var matches = (this.document || this.ownerDocument).querySelectorAll(s),
+                    i = matches.length;
+                while (--i >= 0 && matches.item(i) !== this) {}
+                return i > -1;
+            };
+    }
 
-
Cependant, étant donné la possibilité de prendre en charge les anciens navigateurs, les éléments suivants devraient suffire pour la plupart (sinon tous) des cas pratiques (c'est-à-dire le support IE9 +).

+Cependant, étant donné la possibilité de prendre en charge les anciens navigateurs, les éléments suivants devraient suffire pour la plupart (sinon tous) des cas pratiques (c'est-à-dire le support IE9 +).
 
-
if (!Element.prototype.matches) {
+```html
+if (!Element.prototype.matches) {
     Element.prototype.matches = Element.prototype.msMatchesSelector;
-}

+}
+```
 
-
Spécification

+## Spécification
 
-
- 
-  
-   
-   
-  
- 
- 
-  
-   
-   
-  
- 
-
SpécificationStatus
{{SpecName('DOM WHATWG', '#dom-element-matches', 'Element.prototype.matches')}}{{Spec2('DOM WHATWG')}}

+| Spécification                                                                                            | Status                           |
+| -------------------------------------------------------------------------------------------------------- | -------------------------------- |
+| {{SpecName('DOM WHATWG', '#dom-element-matches', 'Element.prototype.matches')}} | {{Spec2('DOM WHATWG')}} |
 
-
Compatibilité des navigateurs

+## Compatibilité des navigateurs
 
+{{Compat("api.Element.matches")}}
 
+## Voir aussi
 
-
{{Compat("api.Element.matches")}}

-
-
Voir aussi

-
-
+- [La syntaxe des sélecteurs](/fr/Apprendre/CSS/Introduction_%C3%A0_CSS/Les_s%C3%A9lecteurs)
+- autres méthodes qui utilisent les sélecteurs : {{domxref("element.querySelector()")}} et {{domxref("element.closest()")}}.
-- 
cgit v1.2.3-54-g00ecf