Event delegation in Javascript
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
plugins Rename plugins Dec 3, 2012
README.md Add README Nov 28, 2012
gator.js Minimize and increase version to 1.2.4 Jan 16, 2015
gator.min.js Minimize and increase version to 1.2.4 Jan 16, 2015
package.json Minimize and increase version to 1.2.4 Jan 16, 2015

README.md

Gator

Gator is a Javascript event delegation library.

It is around 800 bytes when gzipped and minified and has no external dependencies.

Browser Support

Out of the box Gator works in

  • Chrome
  • Safari 5+
  • Firefox 3.6+
  • Internet Explorer 9+

The legacy.js plugin adds support for

  • Safari < 5
  • Firefox < 3.6
  • Internet Explorer 6, 7, 8

When using the legacy plugin only single classes, single ids, and single tag names are supported for selectors

Getting Started

  1. Include gator on your page before the closing </body> tag

    <script src="/path/to/gator.min.js"></script>
  2. Add some events

    <script>
        // add a click event to document that checks for elements with class expand
        Gator(document).on('click', '.expand', function(e) {
            console.log('clicked on', this);
            return false;
        });
    
        // add a click event to document with no delegation
        Gator(document).on('click', function() {
            console.log('clicked on document!');
        });
    
        // remove all click events on .expand
        Gator(document).off('click', '.expand');
    
        // remove all click events on document
        Gator(document).off('click');
    </script>

Documentation

Full documentation is available at http://craig.is/riding/gators