CKTIS / JavaScript
Zajem kazalca: potrditev ali prekinitev vlečenja
Z `pointerId` spremljaj vlečenje in ga končaj samo enkrat: ob sprostitvi potrdi rezultat, ob preklicu ali predčasni izgubi zajema pa ga zavrzi.
Različica: Current web platform; runtime support varies
Sintaksa
// 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);Ob začetku vlečenja shrani pointerId kazalca, ki ga sprejmeš ob pointerdown. Dogodek se sproži ob pritisku prvega gumba miške ali ko se prst oziroma konica pisala dotakne površine. Stanje vlečenja posodabljaj le ob dogodkih pointermove s shranjenim identifikatorjem. pointermove lahko sporoči spremembo položaja ali druge lastnosti, na primer pritiska, in se lahko sproži tudi brez stika ali pritisnjenega gumba.
Pokliči element.setPointerCapture(pointerId), da lahko vlečenje spremljaš tudi zunaj elementa. Neposredni dotik lahko zajem vklopi implicitno. Če ga moraš sprostiti prej, uporabi releasePointerCapture(). Obe metodi lahko sprožita NotFoundError, če identifikator ne pripada aktivnemu kazalcu.
Ob pointerup potrdi rezultat: prst ali pisalo se dvigne ali pa je spuščen zadnji pritisnjeni gumb miške. Za razliko od mousedown in mouseup se pointerdown in pointerup ne sprožita ob vsaki spremembi stanja miškinega gumba. Ob pointercancel zavrzi začasno stanje: brskalnik je prekinil interakcijo, na primer da bi prevzel potezo za pomikanje ali povečavo.
V obeh primerih počisti shranjeni identifikator, da samodejna sprostitev zajema po pointerup ali pointercancel vlečenja ne konča še drugič. lostpointercapture pomeni izgubo zajema, ne nujno konca stika. Vlečenje prekini samo, če še poteka in se identifikator dogodka ujema s shranjenim.
Zajem ne prepreči potez brskalnika: njihovo obravnavo vnaprej določi z lastnostjo CSS touch-action in omeji none na območje, ki ga potrebuje. Ti API-ji so del spletne platforme, ne ECMAScripta 2024; razpoložljivost je odvisna od izvajalnega okolja.
Primeri
<!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>Rezultat
pointerdown pointermove pointerup: commit
Shrani primer kot datoteko HTML, odpri jo v brskalniku in spremljaj razvijalsko konzolo. Začni vleči z glavnim gumbom miške znotraj okvirja in ga spusti zunaj, ne da bi držal Shift. Pri drugem vlečenju najprej premakni miško, nato pridrži Shift in nadaljuj premikanje, ne da bi spustil gumb, da preveriš predčasno izgubo zajema. Vrstica `pointermove` se prikaže največ enkrat na vlečenje.
Povezane lekcije
- JavaScript · Lekcija 35 · Srednja · Različica: 3