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/element/matches/index.md | |
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/element/matches/index.md')
-rw-r--r-- | files/fr/web/api/element/matches/index.md | 122 |
1 files changed, 52 insertions, 70 deletions
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 --- -<p>{{ APIRef("DOM") }}</p> +{{ APIRef("DOM") }} -<p><code>La méthode<strong> </strong></code><strong><code>element.matches()</code></strong> renvoie <code>true</code> 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 <code>false</code>.</p> +`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`. -<div class="warning"> -<p><strong>Attention :</strong> Certains navigateurs implémentent cette méthode sous le nom <code>matchesSelector()</code> non-standardisé et préfixé.</p> -</div> +> **Attention :** Certains navigateurs implémentent cette méthode sous le nom `matchesSelector()` non-standardisé et préfixé. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>var result</em> = <em>element</em>.matches(selectorString); -</pre> + var result = element.matches(selectorString); -<ul> - <li><code>result</code> contient la valeur retournée <code>true</code> ou <code>false</code>.</li> - <li><code>selectorString</code> est une chaîne définissant le sélecteur à tester sur l'élément.</li> -</ul> +- `result` contient la valeur retournée `true` ou `false`. +- `selectorString` est une chaîne définissant le sélecteur à tester sur l'élément. -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: html"><ul id="birds"> - <li>perroquet amazone</li> - <li class="endangered">aigle des Philippines</li> - <li>pélican blanc</li> -</ul> +```html +<ul id="birds"> + <li>perroquet amazone</li> + <li class="endangered">aigle des Philippines</li> + <li>pélican blanc</li> +</ul> -<script type="text/javascript"> +<script type="text/javascript"> var birds = document.getElementsByTagName('li'); - for (var i = 0; i < birds.length; i++) { + for (var i = 0; i < birds.length; i++) { if (birds[i].matches('.endangered')) { console.log('Le - ' + birds[i].textContent + '- est en voie de disparition !'); } } -</script></pre> +</script> +``` -<p>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<code> class </code>de valeur <code>endangered</code>.</p> +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`. -<h2 id="Exceptions">Exceptions</h2> +## Exceptions -<dl> - <dt><code>SYNTAX_ERR</code></dt> - <dd>Lorsque la chaîne passée en paramêtre défini sélecteur invalide.</dd> -</dl> +- `SYNTAX_ERR` + - : Lorsque la chaîne passée en paramêtre défini sélecteur invalide. -<h2 id="Polyfill">Polyfill</h2> +## Polyfill -<p>Pour les navigateurs qui ne supportent pas <code>Element.matches()</code> ou <code>Element.matchesSelector()</code>, mais fournissent le support de<code> document.querySelectorAll()</code>, il existe un <em>polyfill</em> :</p> +Pour les navigateurs qui ne supportent pas `Element.matches()` ou `Element.matchesSelector()`, mais fournissent le support de` document.querySelectorAll()`, il existe un _polyfill_ : -<pre>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; - }; -}</pre> + 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; + }; + } -<p>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 +).</p> +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 +). -<pre class="brush: html">if (!Element.prototype.matches) { +```html +if (!Element.prototype.matches) { Element.prototype.matches = Element.prototype.msMatchesSelector; -}</pre> +} +``` -<h2 id="Spécification">Spécification</h2> +## Spécification -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Status</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('DOM WHATWG', '#dom-element-matches', 'Element.prototype.matches')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - </tr> - </tbody> -</table> +| Spécification | Status | +| -------------------------------------------------------------------------------------------------------- | -------------------------------- | +| {{SpecName('DOM WHATWG', '#dom-element-matches', 'Element.prototype.matches')}} | {{Spec2('DOM WHATWG')}} | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.Element.matches")}} +## Voir aussi -<p>{{Compat("api.Element.matches")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/Apprendre/CSS/Introduction_%C3%A0_CSS/Les_s%C3%A9lecteurs">La syntaxe des sélecteurs</a></li> - <li>autres méthodes qui utilisent les sélecteurs : {{domxref("element.querySelector()")}} et {{domxref("element.closest()")}}.</li> -</ul> +- [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()")}}. |