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

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

See the API documentation for details on how to use jQuery Once.

Development

Install dependencies through npm:

npm install

Test with ESLint, Mocha and Mocha JSDom:

npm test

Update project documentation with Projectz and jsdoc-to-markdown:

npm run projectz
npm run docs

Build jquery.once.min.js with:

npm run build

Tag and publish the new versions to npm with Semantic Versioning:

git tag 2.0.0
git push origin 2.0.0
npm publish

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!

Changelog

[2.0.0] - January 20th, 2015

Fixed

• Fixed type checking of the id parameter of .once() as optional
  • From @theodoreb
• Fixed inline code documentation
  • From @yched

Added

• Added performance improvement through .data() use rather than class attributes
• Added findOnce() function to allow filtering once'd elements
• Added automated testing through Mocha
• Added jsdoc-to-markdown to automatically build API documentation

Changed

• Switched to ESLint for code linting
• Removed unneeded cache variable
• Removed function callback in order to promote jQuery chaining standards