npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

vanilla-delegation

v5.5.0

Published

Lightweight vanilla event delegation.

Downloads

98

Readme

Vanilla-delegation - npm version

Build Status David GitHub file size in bytes NPM

Light vanilla event delegation.

Extras


🔧 How to install

Install from npm and require it in your script.

$ npm install vanilla-delegation --save
require('vanilla-delegation');

or import the script in your html document:

<script rel="https://unpkg.com/vanilla-delegation/dist/vanilla-delegation.min.js" />

✏️ How to use

The script implements new methods on Element, NodeList and HTMLCollection.

// Add
Element.addDelegateListener(eventType, selector, handler, useCapture = false)
NodeList.addDelegateListener(eventType, selector, handler, useCapture = false)
HTMLCollection.addDelegateListener(eventType, selector, handler, useCapture = false)

// Remove
Element.removeDelegateListener(eventType, selector, handler, useCapture = false)
  • eventType: [string] A case-sensitive string representing the event type to listen for.
  • selector: [string] css child selector, must be a child of Element.
  • handler: [function] callback function, original event obj is passed as argument (more details here). Be sure to pass a named function so you can remove it with removeDelegateListener() if needed. Be aware in case you're using a minifier like uglify-js be sure to set keep_fnames: true in your uglifyOptions (more details here)
  • useCapture: [boolean] native useCapture parameter (default false). See here for more details.

➕ Add listener

// get single element
const body = document.querySelector('body');

// bind listener with delegation
body.addDelegateListener('click', 'a', function handlerFn(event) {
    event.preventDefault();
    alert('link clicked!');
});

Also can be used with querySelectorAll, getElementsByClassName, getElementsByTagName, getElementsByTagNameNS

// get multiple elements
const div = document.querySelectorAll('div');

// bind listener with delegation on every element in NodeList (or HTMLCollection)
div.addDelegateListener('click', 'a', function handlerFn(event) {
    event.preventDefault();
    alert('link clicked!');
});

➖ Remove listener

In order to remove a listener be sure to pass a named function to removeDelegateListener()

const div = document.querySelector('div');
div.removeDelegateListener('click', 'a', handlerFn);

removeDelegateListener() can be used on single Element nodes only

Handler function

Event is passed to handler function as argument.

this is the element matching selector.

event.delegateTarget is the Element to which the event was originally attached (jQuery-like)


Global polyfill (IE9+ support)

A global polyfill is included by default with vanilla-delegation:

See https://developer.mozilla.org/en-US/docs/Web/API/Element/matches#Polyfill

Support

  • (latest 2 versions)
  • IE 11