jquery-once

jQuery Once

Act on jQuery elements only once.

Filters out all elements that had the same filter applied on them before. It can be used to ensure that a function is only applied once to an element.

Install

NPM

• Use: require('jquery-once')
• Install: npm install --save jquery-once

Browserify

• Use: require('jquery-once')
• Install: npm install --save jquery-once
• CDN URL: //wzrd.in/bundle/jquery-once@2.0.0-alpha.4

Ender

• Use: require('jquery-once')
• Install: ender add jquery-once

Component

• Use: require('jquery-once')
• Install: component install RobLoach/jquery-once

Bower

• Use: require('jquery-once')
• Install: bower install jquery-once

Usage

$('div.calendar').once('calendar', function() {
  // This function is only executed once for each div, even if this
  // code segment is executed repeatedly.
});
$('div.calendar').once('calendar').click(function() {
  // .once('calendar') filters out all elements which already have been
  // filtered with once(), and the elements that haven't been filtered
  // yet remain. The previous set of elements can be restored with
  // .end().
});

It also works without supplying a name:

$('div.calendar').once(function() {
  // This function is only executed once for each div, even if this
  // code segment is executed repeatedly. Other scripts can't refer
  // to this `once` method. The once data used to store execution are
  // in the form "jquery-once-1", "jquery-once-2", etc.
});

Development

Install dependencies through npm:

npm install

Use Grunt to run qunit tests:

grunt jshint qunit

Build the project with Grunt:

grunt release

Update project documentation with Projectz:

npm run-script projectz

History

Discover the change history by heading on over to the HISTORY.md file.

License

Licensed under:

• GPL-2.0
• the incredibly permissive MIT license

Copyright © Rob Loach (http://github.com/robloach)

Backers

Maintainers

These amazing people are maintaining this project:

• Rob Loach (https://github.com/robloach)

Sponsors

No sponsors yet! Will you be the first?

Contributors

These amazing people have contributed code to this project:

• JohnAlbin — view contributions
• Rob Loach [e-mail] — view contributions
• theodoreb — view contributions

Become a contributor!