CKTIS / JavaScript
Zachycení ukazatele: potvrzení nebo přerušení tažení
Sleduj tažení podle `pointerId` a ukonči je jen jednou: při uvolnění potvrď výsledek, při zrušení nebo předčasné ztrátě zachycení ho zahoď.
Verze: Current web platform; runtime support varies
Syntaxe
// Handler sketch: supply the element and the five callbacks in your application.
element.addEventListener("pointerdown", onDown);
element.addEventListener("pointermove", onMove);
element.addEventListener("pointerup", onUp);
element.addEventListener("pointercancel", onCancel);
element.addEventListener("lostpointercapture", onLostCapture);
// In onDown, after accepting the pointer for the drag:
// element.setPointerCapture(event.pointerId);
// In onMove, only if the active drag should release capture early:
// element.releasePointerCapture(event.pointerId);Na začátku tažení ulož pointerId ukazatele, který přijmeš při pointerdown. Tato událost nastane při stisku prvního tlačítka myši nebo při dotyku prstu či hrotu pera s povrchem. Stav tažení měň pouze při událostech pointermove se stejným identifikátorem. pointermove může oznamovat změnu polohy nebo jiné vlastnosti, například tlaku, a může nastat i bez kontaktu či stisknutého tlačítka.
Zavolej element.setPointerCapture(pointerId), abys mohl sledovat tažení i mimo prvek. Přímý dotyk může zachycení nastavit implicitně. Pokud je potřeba zachycení uvolnit dříve, použij releasePointerCapture(). Obě metody mohou vyvolat NotFoundError, pokud identifikátor neodpovídá aktivnímu ukazateli.
Potvrď výsledek při pointerup: prst nebo pero se zvedne, nebo se uvolní poslední stisknuté tlačítko myši. Na rozdíl od mousedown a mouseup se pointerdown a pointerup nevyvolávají při každé změně stavu tlačítka. Při pointercancel zahoď dočasný stav: prohlížeč interakci přerušil, například aby převzal gesto posouvání nebo přiblížení.
V obou případech vymaž uložený identifikátor, aby automatické uvolnění zachycení po pointerup nebo pointercancel neukončilo tažení podruhé. lostpointercapture oznamuje ztrátu zachycení, ne nutně konec kontaktu. Tažení přeruš jen tehdy, když ještě probíhá a událost má stejný identifikátor.
Zachycení neblokuje gesta prohlížeče: jejich zpracování nastav předem pomocí CSS vlastnosti touch-action a hodnotu none omez na potřebnou oblast. Tato API patří k webové platformě, nikoli k ECMAScriptu 2024; dostupnost závisí na běhovém prostředí.
Příklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Drag with pointer capture</title>
<style>
#pad {
position: fixed;
top: 16px;
left: 16px;
z-index: 9999;
width: 220px;
height: 100px;
padding: 12px;
background: #def;
color: #123;
border: 2px solid #246;
touch-action: none;
user-select: none;
}
</style>
</head>
<body>
<div id="pad">Start dragging here</div>
<script>
(() => {
const pad = document.getElementById('pad');
let activeId = null;
let moved = false;
pad.addEventListener('pointerdown', (event) => {
if (activeId !== null || event.button !== 0) return;
pad.setPointerCapture(event.pointerId);
activeId = event.pointerId;
moved = false;
console.log('pointerdown');
});
pad.addEventListener('pointermove', (event) => {
if (event.pointerId !== activeId) return;
if (!moved) {
moved = true;
console.log('pointermove');
}
if (event.shiftKey && pad.hasPointerCapture(event.pointerId)) {
pad.releasePointerCapture(event.pointerId);
}
});
function finish(event, result) {
if (event.pointerId !== activeId) return;
activeId = null;
console.log(`${event.type}: ${result}`);
}
pad.addEventListener('pointerup', (event) => finish(event, 'commit'));
pad.addEventListener('pointercancel', (event) => finish(event, 'abort'));
pad.addEventListener('lostpointercapture', (event) => finish(event, 'abort'));
})();
</script>
</body>
</html>Výsledek
pointerdown pointermove pointerup: commit
Ulož příklad jako soubor HTML, otevři ho v prohlížeči a sleduj vývojářskou konzoli. Začni táhnout hlavním tlačítkem myši uvnitř rámečku a uvolni ho mimo něj bez stisknutého Shiftu. Při dalším tažení se nejdřív rozjeď, pak podrž Shift a pokračuj v pohybu bez uvolnění tlačítka, abys otestoval předčasnou ztrátu zachycení. Řádek `pointermove` se zobrazí nejvýše jednou za tažení.
Související lekce
- JavaScript · Lekce 35 · Středně pokročilá · Verze: 3