81 lines
3.0 KiB
JavaScript
81 lines
3.0 KiB
JavaScript
// $Id: jquery.once.js,v 1.1 2009/08/31 15:52:26 webchick Exp $
|
|
|
|
/**
|
|
* jQuery Once Plugin v1.2
|
|
* http://plugins.jquery.com/project/once
|
|
*
|
|
* Dual licensed under the MIT and GPL licenses:
|
|
* http://www.opensource.org/licenses/mit-license.php
|
|
* http://www.gnu.org/licenses/gpl.html
|
|
*/
|
|
|
|
(function ($) {
|
|
var cache = {}, uuid = 0;
|
|
|
|
/**
|
|
* Filters elements by whether they have not yet been processed.
|
|
*
|
|
* @param id
|
|
* (Optional) If this is a string, then it will be used as the CSS class
|
|
* name that is applied to the elements for determining whether it has
|
|
* already been processed. The elements will get a class in the form of
|
|
* "id-processed".
|
|
*
|
|
* If the id parameter is a function, it will be passed off to the fn
|
|
* parameter and the id will become a unique identifier, represented as a
|
|
* number.
|
|
*
|
|
* When the id is neither a string or a function, it becomes a unique
|
|
* identifier, depicted as a number. The element's class will then be
|
|
* represented in the form of "jquery-once-#-processed".
|
|
*
|
|
* Take note that the id must be valid for usage as an element's class name.
|
|
* @param fn
|
|
* (Optional) If given, this function will be called for each element that
|
|
* has not yet been processed. The function's return value follows the same
|
|
* logic as $.each(). Returning true will continue to the next matched
|
|
* element in the set, while returning false will entirely break the
|
|
* iteration.
|
|
*/
|
|
$.fn.once = function (id, fn) {
|
|
if (typeof id != 'string') {
|
|
// Generate a numeric ID if the id passed can't be used as a CSS class.
|
|
if (!(id in cache)) {
|
|
cache[id] = ++uuid;
|
|
}
|
|
// When the fn parameter is not passed, we interpret it from the id.
|
|
if (!fn) {
|
|
fn = id;
|
|
}
|
|
id = 'jquery-once-' + cache[id];
|
|
}
|
|
// Remove elements from the set that have already been processed.
|
|
var name = id + '-processed';
|
|
var elements = this.not('.' + name).addClass(name);
|
|
|
|
return $.isFunction(fn) ? elements.each(fn) : elements;
|
|
};
|
|
|
|
/**
|
|
* Filters elements that have been processed once already.
|
|
*
|
|
* @param id
|
|
* A required string representing the name of the class which should be used
|
|
* when filtering the elements. This only filters elements that have already
|
|
* been processed by the once function. The id should be the same id that
|
|
* was originally passed to the once() function.
|
|
* @param fn
|
|
* (Optional) If given, this function will be called for each element that
|
|
* has not yet been processed. The function's return value follows the same
|
|
* logic as $.each(). Returning true will continue to the next matched
|
|
* element in the set, while returning false will entirely break the
|
|
* iteration.
|
|
*/
|
|
$.fn.removeOnce = function (id, fn) {
|
|
var name = id + '-processed';
|
|
var elements = this.filter('.' + name).removeClass(name);
|
|
|
|
return $.isFunction(fn) ? elements.each(fn) : elements;
|
|
};
|
|
})(jQuery);
|