Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Element: releasePointerCapture() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Juli 2020⁩.

Die releasePointerCapture() Methode der Element Schnittstelle gibt die Pointer-Erfassung frei (stoppt sie), die zuvor für einen bestimmten (PointerEvent) Pointer gesetzt wurde.

Syntax

js
releasePointerCapture(pointerId)

Parameter

pointerId

Die pointerId eines PointerEvent Objekts.

Rückgabewert

Keiner (undefined).

Ausnahmen

NotFoundError DOMException

Wird ausgelöst, wenn pointerId keinem aktiven Pointer entspricht.

Beispiele

Dieses Beispiel setzt die Pointer-Erfassung auf einem <div>, wenn Sie darauf drücken. So können Sie das Element horizontal verschieben, selbst wenn Ihr Pointer seine Grenzen überschreitet.

HTML

html
<div id="slider">SLIDE ME</div>

CSS

css
div {
  width: 140px;
  height: 50px;
  display: flex;
  align-items: center;
  justify-content: center;
  background: #ffbbee;
}

JavaScript

js
function beginSliding(e) {
  slider.onpointermove = slide;
  slider.setPointerCapture(e.pointerId);
}

function stopSliding(e) {
  slider.onpointermove = null;
  slider.releasePointerCapture(e.pointerId);
}

function slide(e) {
  slider.style.transform = `translate(${e.clientX - 70}px)`;
}

const slider = document.getElementById("slider");

slider.onpointerdown = beginSliding;
slider.onpointerup = stopSliding;

Ergebnis

Spezifikationen

Specification
Pointer Events
# dom-element-releasepointercapture

Browser-Kompatibilität

Siehe auch