38 lines
1.4 KiB
JavaScript
38 lines
1.4 KiB
JavaScript
import { isDragActive } from './drag/state/is-active.mjs';
|
|
import { setupGesture } from './utils/setup.mjs';
|
|
|
|
function isValidHover(event) {
|
|
return !(event.pointerType === "touch" || isDragActive());
|
|
}
|
|
/**
|
|
* Create a hover gesture. hover() is different to .addEventListener("pointerenter")
|
|
* in that it has an easier syntax, filters out polyfilled touch events, interoperates
|
|
* with drag gestures, and automatically removes the "pointerennd" event listener when the hover ends.
|
|
*
|
|
* @public
|
|
*/
|
|
function hover(elementOrSelector, onHoverStart, options = {}) {
|
|
const [elements, eventOptions, cancel] = setupGesture(elementOrSelector, options);
|
|
const onPointerEnter = (enterEvent) => {
|
|
if (!isValidHover(enterEvent))
|
|
return;
|
|
const { target } = enterEvent;
|
|
const onHoverEnd = onHoverStart(target, enterEvent);
|
|
if (typeof onHoverEnd !== "function" || !target)
|
|
return;
|
|
const onPointerLeave = (leaveEvent) => {
|
|
if (!isValidHover(leaveEvent))
|
|
return;
|
|
onHoverEnd(leaveEvent);
|
|
target.removeEventListener("pointerleave", onPointerLeave);
|
|
};
|
|
target.addEventListener("pointerleave", onPointerLeave, eventOptions);
|
|
};
|
|
elements.forEach((element) => {
|
|
element.addEventListener("pointerenter", onPointerEnter, eventOptions);
|
|
});
|
|
return cancel;
|
|
}
|
|
|
|
export { hover };
|