0.1.2 • Published 10 years ago

hand v0.1.2

Weekly downloads
1
License
ISC
Repository
github
Last release
10 years ago

Hand - Element Grabber

No dependencies. Super performant. A micro lib for attaching elements to mouse movement.

http://storage.j0.hn/hand.gif

Install:

npm install hand

or:

bower install hand

Usage

Works with AMD loaders or browserify with require('hand') or simply window.hand without a loader.

document.addEventListener( 'DOMContentLoaded', function(){
  var el = document.getElementById('my-element');

  // Drag and drop for `el`
  el.addEventListener( 'mousedown', function( e ){
    // Tell hand what to grab and where to grab it from
    hand.grab( el, e.offsetX, e.offsetY );
  });

  el.addEventListener( 'mousedown', function( e ){
    hand.drop( el );
  });
});

API

hand.grab( element, [offsetX], [offsetY] )

Grab an element

Parameters:

  • element - The element to attach to mouse movement
  • offsetX - X coordinate on the element to grab from
  • offsetY - Y coordinate on the element to grab from

hand.drop( element )

Drops an element

Parameters:

  • element - The element to drop

Browser support

  1. If your browser doesn't support CSS transforms/translate3d, then this will not work at all.
  2. If your browser doesn't support CSS ClassList, then install this polyfill