Element: releasePointerCapture() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年7月以降、すべてのブラウザーで利用可能です。
releasePointerCapture() は Element インターフェイスのメソッドで、特定の（PointerEvent の）ポインターに対して以前に設定されたポインターキャプチャを解放（停止）します。
ポインターキャプチャの説明と特定の要素に設定する方法については、Element.setPointerCapture() メソッドを参照してください。
構文
js
releasePointerCapture(pointerId)
引数
pointerId-
PointerEventオブジェクトのpointerId。
返値
なし (undefined)。
例外
| 例外 | 説明 |
|---|---|
InvalidPointerId |
pointerId がどのアクティブなポインターとも一致しない場合。 |
例
この例では、<div> を押下するとポインターキャプチャが設定されます。 これにより、ポインターをその境界の外側に移動した場合でも、要素を水平方向にスライドさせることができます。
HTML
html
<div id="slider">スライドしてね</div>
CSS
css
div {
width: 140px;
height: 50px;
display: flex;
align-items: center;
justify-content: center;
background: #fbe;
}
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;
結果
仕様書
| 仕様書 |
|---|
| Pointer Events # dom-element-releasepointercapture |