0.1.4 • Published 5 years ago

jw-mouse v0.1.4

Weekly downloads
9
License
MIT
Repository
github
Last release
5 years ago

jw-mouse

A static and stateful instance which hooks into all mouse and touch events. It also captures position, direction and speed of movement. (Currently it supports single touch only)

NPM version build status node version npm download

Demo

Install

NPM

Methods

MethodParametersDescription
attachelement: DOM elementappend the mouse to the a DOM element and event functions to it.
detachdisengage the mouse from DOM element and event functions from it.
setPreventDefaultpreventDefault: booleantoggle value for mouse prevent default on all events.
onEnterhandler: functionbind an event handler to the mouse enter event. Returns a method to unbind.
clearEnterunbind all event handlers from the mouse enter event.
onLeavehandler: functionbind an event handler to the mouse leave event. Returns a method to unbind.
clearLeaveunbind all event handlers from the mouse leave event.
onDownhandler: functionbind an event handler to the mouse down event. Returns a method to unbind.
clearDownunbind all event handlers from the mouse down event.
onUphandler: functionbind an event handler to the mouse up event. Returns a method to unbind.
clearUpunbind all event handlers from the mouse up event.
onMovehandler: functionbind an event handler to the mouse move event. Returns a method to unbind.
clearMoveunbind all event handlers from the mouse move event.
onScrollhandler: functionbind an event handler to the mouse scroll event. Returns a method to unbind.
clearScrollunbind all event handlers from the mouse scroll event.
onDraghandler: functionbind an event handler to the mouse drag event. Returns a method to unbind.
clearDragunbind all event handlers from the mouse drag event.
onDragOverhandler: functionbind an event handler to the mouse drag over event. Returns a method to unbind.
clearDragOverunbind all event handlers from the mouse drag over event.
onDrophandler: functionbind an event handler to the mouse drop event. Returns a method to unbind.
clearDropunbind all event handlers from the mouse drop event.
onStophandler: functionbind an event handler to the mouse stop event. Returns a method to unbind.
clearStopunbind all event handlers from the mouse stop event.
onClickhandler: functionbind an event handler to the mouse click event. Returns a method to unbind.
clearClickunbind all event handlers from the mouse click event.

Handler Event

On handling the event, the same event object as the one from addEventListener will be passed as a parameter, with an additional mouse object, which holds the following properties:

PropDescription
isMouseDownwhether any mouse key is pressed down.
scrollDeltathe delta value when the mouse scrolls.
isTouchingwhether the mouse is currently contacted by touch surface.
previousPositionprevious mouse position.
previousDownPositionprevious mouse position when a mouse button was pressed.
positioncurrent mouse position.
directioncurrent mouse direction.
movedDistancethe distance moved from previous position.
movingSpeedcurrent mouse moving speed.
preventDefaultwhether the mouse skips the default behaviours upon the listen element.

Usage

import Mouse from "jw-mouse";

/* Get the element for the mouse. */
var element = document.getElementById("container");

/* Create a mouse instance, with the element as its container.
 * This is to allow the mouse to monitor all mouse events from the container. */
var mouse = new Mouse(element);

/** Append the mouse to the a DOM element and event functions to it. */
mouse.attach(element);

/** Disengage the mouse from DOM element and event functions from it. */
mouse.detach();

/** Toggle value for mouse prevent default on all events. */
mouse.setPreventDefault(preventDefault);

/** Bind an event handler to the mouse enter event. */
let removeEnter = mouse.onEnter(event => { ... });

/** Unbind an event handler to the mouse enter event. */
removeEnter();

/** Unbind all event handlers from the mouse enter event. */
mouse.clearEnter();

/** Bind an event handler to the mouse leave event. */
let removeLeave = mouse.onLeave(event => { ... });

/** Unbind an event handler to the mouse leave event. */
removeLeave();

/** Unbind all event handlers from the mouse leave event. */
mouse.clearLeave();

/** Bind an event handler to the mouse down event. */
let removeDown = mouse.onDown(event => { ... });

/** Unbind an event handler to the mouse down event. */
removeDown();

/** Unbind all event handlers from the mouse down event. */
mouse.clearDown();

/** Bind an event handler to the mouse up event. */
let removeUp = mouse.onUp(event => { ... });

/** Unbind an event handler to the mouse up event. */
removeUp();

/** Unbind all event handlers from the mouse up event. */
mouse.clearUp();

/** Bind an event handler to the mouse move event. */
let removeMove = mouse.onMove(event => { ... });

/** Unbind an event handler to the mouse move event. */
removeMove();

/** Unbind all event handlers from the mouse move event. */
mouse.clearMove();

/** Bind an event handler to the scroll event. */
let removeScroll = mouse.onScroll(event => { ... });

/** Unbind an event handler to the scroll event. */
removeScroll();

/** Unbind all event handlers from the mouse scroll event. */
mouse.clearScroll();

/** Bind an event handler to the drag event. */
let removeDrag = mouse.onDrag(event => { ... });

/** Unbind an event handler to the drag event. */
removeDrag();

/** Unbind all event handlers from the mouse drag event. */
mouse.clearDrag();

/** Bind an event handler to the drag over event. */
let removeDragOver = mouse.onDragOver(event => { ... });

/** Unbind an event handler to the drag over event. */
removeDragOver();

/** Unbind all event handlers from the drag over event. */
mouse.clearDragOver();

/** Bind an event handler to the drop event. */
let removeDrop = mouse.onDrop(event => { ... });

/** Unbind an event handler to the drop event. */
removeDrop();

/** Unbind all event handlers from the drop event. */
mouse.clearDrop();

/** Bind all event handlers from the stop event. */
let removeStop = mouse.onStop(event => { ... });

/** Unbind an event handler to the stop event. */
removeStop();

/** Unbind all event handlers from the stop event. */
mouse.clearStop();

/** Bind all event handlers from the click event. */
let removeClick = mouse.onClick(event => { ... });

/** Unbind an event handler to the click event. */
removeClick();

/** Unbind all event handlers from the click event. */
mouse.clearClick();