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/element/releasepointercapture/index.html | |
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/element/releasepointercapture/index.html')
-rw-r--r-- | files/fr/web/api/element/releasepointercapture/index.html | 148 |
1 files changed, 148 insertions, 0 deletions
diff --git a/files/fr/web/api/element/releasepointercapture/index.html b/files/fr/web/api/element/releasepointercapture/index.html new file mode 100644 index 0000000000..be7f127da3 --- /dev/null +++ b/files/fr/web/api/element/releasepointercapture/index.html @@ -0,0 +1,148 @@ +--- +title: Element.releasePointerCapture() +slug: Web/API/Element/releasePointerCapture +tags: + - API + - DOM + - Element + - Méthodes + - Pointeur +translation_of: Web/API/Element/releasePointerCapture +--- +<p>{{APIRef("DOM")}}</p> + +<p>Relâche (arrête) la capture de pointeur précédemment définie pour un <em>pointer</em> ({{domxref("PointerEvent")}}) spécifique.</p> + +<p>Voir la méthode <strong>{{domxref("Element.setPointerCapture","Element.setPointerCapture()")}}</strong> pour une description de <em>pointer capture </em>et la façon de le définir pour un élément particulier.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox">targetElement.<em>releasePointerCapture</em>(pointerId); +</pre> + +<h3 id="Arguments">Arguments</h3> + +<dl> + <dt><em>pointerId</em></dt> + <dd>L'{{domxref("PointerEvent.pointerId","identifiant")}} pour un {{domxref("PointerEvent","pointer event")}}.</dd> +</dl> + +<h3 id="Valeur_retournée">Valeur retournée</h3> + +<p>Si <code>pointerId</code> ne correspond à aucun pointeur actif, cette méthode renvoie <code>void</code> (<em>vide</em>) et déclenche une {{domxref("DOMException")}} avec le nom <code>InvalidPointerId</code>.</p> + +<h2 id="Exemple">Exemple</h2> + +<pre class="brush: js"><html> +<script> +function downHandler(ev) { + var el=document.getElementById("target"); + // L'élément "target" va recevoir/capturer d'autres évènements + el.setPointerCapture(ev.pointerId); +} +function cancelHandler(ev) { + var el=document.getElementById("target"); + // Relâche la capture du pointeur + el.releasePointerCapture(ev.pointerId); +} +function init() { + var el=document.getElementById("target"); + // Enregistre les gestionnaires du pointeur + el.onpointerdown = downHandler; + el.onpointercancel = cancelHandler; +} +</script> +<body onload="init();"> +<div id="target"> Touch me ... </div> +</body> +</html> +</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('Pointer Events 2','#widl-Element-releasePointerCapture-void-long-pointerId', 'releasePointerCapture')}}</td> + <td>{{Spec2('Pointer Events 2')}}</td> + <td>Version non stable.</td> + </tr> + <tr> + <td>{{SpecName('Pointer Events', '#widl-Element-releasePointerCapture-void-long-pointerId', 'releasePointerCapture')}}</td> + <td>{{Spec2('Pointer Events')}}</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>Basic support</td> + <td>{{CompatChrome("35")}}<sup>[1]</sup></td> + <td>{{CompatGeckoDesktop(59)}}</td> + <td>10 {{property_prefix("-ms")}}<br> + 11</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatNo}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Fonctionnalité</th> + <th>Android</th> + <th>Chrome for Android</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>{{CompatUnknown}}</td> + <td>{{CompatChrome("35")}}<sup>[1]</sup></td> + <td>{{CompatGeckoMobile("29")}}<sup>[2]</sup></td> + <td>10 {{property_prefix("-ms")}}<br> + 11</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatNo}}</td> + </tr> + </tbody> +</table> +</div> + +<p>[1] A été pris en charge dans <a href="http://crbug.com/248918">bug 248918</a>.</p> + +<p>[2] Supporté avec la préférence <code>dom.w3c_pointer_events.enabled</code> par défaut à <code>false</code> (<em>faux</em>).</p> + +<p> </p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>{{ domxref("Element.setPointerCapture","Element.setPointerCapture()") }}</li> + <li>{{ domxref("Pointer_events","Pointer Events") }}</li> +</ul> |