From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../api/element/releasepointercapture/index.html | 148 +++++++++++++++++++++ 1 file changed, 148 insertions(+) create mode 100644 files/fr/web/api/element/releasepointercapture/index.html (limited to 'files/fr/web/api/element/releasepointercapture/index.html') 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 +--- +

{{APIRef("DOM")}}

+ +

Relâche (arrête) la capture de pointeur précédemment définie pour un pointer ({{domxref("PointerEvent")}}) spécifique.

+ +

Voir la méthode {{domxref("Element.setPointerCapture","Element.setPointerCapture()")}} pour une description de pointer capture et la façon de le définir pour un élément particulier.

+ +

Syntaxe

+ +
targetElement.releasePointerCapture(pointerId);
+
+ +

Arguments

+ +
+
pointerId
+
L'{{domxref("PointerEvent.pointerId","identifiant")}} pour un {{domxref("PointerEvent","pointer event")}}.
+
+ +

Valeur retournée

+ +

Si pointerId ne correspond à aucun pointeur actif, cette méthode renvoie void (vide) et déclenche une {{domxref("DOMException")}} avec le nom InvalidPointerId.

+ +

Exemple

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

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('Pointer Events 2','#widl-Element-releasePointerCapture-void-long-pointerId', 'releasePointerCapture')}}{{Spec2('Pointer Events 2')}}Version non stable.
{{SpecName('Pointer Events', '#widl-Element-releasePointerCapture-void-long-pointerId', 'releasePointerCapture')}}{{Spec2('Pointer Events')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
FonctionnalitéChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatChrome("35")}}[1]{{CompatGeckoDesktop(59)}}10 {{property_prefix("-ms")}}
+ 11		{{CompatUnknown}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FonctionnalitéAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatChrome("35")}}[1]{{CompatGeckoMobile("29")}}[2]10 {{property_prefix("-ms")}}
+ 11		{{CompatUnknown}}{{CompatNo}}
+
+ +

[1] A été pris en charge dans bug 248918.

+ +

[2] Supporté avec la préférence dom.w3c_pointer_events.enabled par défaut à false (faux).

+ +

 

+ +

Voir aussi

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