Last active
December 25, 2015 04:59
-
-
Save mattcroberts/6921581 to your computer and use it in GitHub Desktop.
Reverse Relation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
<!DOCTYPE html> | |
<head> | |
<script src="js/lib/require.js" data-main="js/Config"></script> | |
</head> | |
<body> | |
</body> | |
</html> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
requirejs.config({ | |
deps:["Main"], | |
paths:{ | |
backbone:"lib/backbone", | |
"backbone.associations":"lib/backbone-associations", | |
jquery:"lib/jquery", | |
underscore:"lib/lodash" | |
}, | |
shim:{ | |
backbone:{ | |
exports: "Backbone", | |
deps:["underscore", "jquery"] | |
}, | |
'backbone.associations': { | |
deps:["backbone"] | |
}, | |
} | |
}); |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
/** | |
* Created by matt on 10/10/13. | |
*/ | |
define([ | |
"backbone.associations", | |
"Person" | |
], function(Associations, Person){ | |
var House = Backbone.AssociatedModel.extend({ | |
relations:[{ | |
key:"person", | |
type:Backbone.One, | |
relatedModel: function(){ return Person;} | |
}] | |
}); | |
return House; | |
}) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
// | |
// Backbone-associations.js 0.5.2 | |
// | |
// (c) 2013 Dhruva Ray, Jaynti Kanani, Persistent Systems Ltd. | |
// Backbone-associations may be freely distributed under the MIT license. | |
// For all details and documentation: | |
// https://github.com/dhruvaray/backbone-associations/ | |
// | |
// Initial Setup | |
// -------------- | |
(function () { | |
"use strict"; | |
// Save a reference to the global object (`window` in the browser, `exports` | |
// on the server). | |
var root = this; | |
// The top-level namespace. All public Backbone classes and modules will be attached to this. | |
// Exported for the browser and CommonJS. | |
var _, Backbone, BackboneModel, BackboneCollection, ModelProto, | |
CollectionProto, defaultEvents, AssociatedModel, pathChecker, | |
collectionEvents; | |
if (typeof window === 'undefined') { | |
_ = require('underscore'); | |
Backbone = require('backbone'); | |
if (typeof exports !== 'undefined') { | |
exports = module.exports = Backbone; | |
} | |
} else { | |
_ = root._; | |
Backbone = root.Backbone; | |
} | |
// Create local reference `Model` prototype. | |
BackboneModel = Backbone.Model; | |
BackboneCollection = Backbone.Collection; | |
ModelProto = BackboneModel.prototype; | |
CollectionProto = BackboneCollection.prototype; | |
pathChecker = /[\.\[\]]+/g; | |
// Built-in Backbone `events`. | |
defaultEvents = ["change", "add", "remove", "reset", "sort", "destroy"]; | |
collectionEvents = ["reset", "sort"]; | |
Backbone.Associations = { | |
VERSION:"0.5.2" | |
}; | |
// Backbone.AssociatedModel | |
// -------------- | |
//Add `Many` and `One` relations to Backbone Object. | |
Backbone.Associations.Many = Backbone.Many = "Many"; | |
Backbone.Associations.One = Backbone.One = "One"; | |
Backbone.Associations.Self = Backbone.Self = "Self"; | |
// Define `AssociatedModel` (Extends Backbone.Model). | |
AssociatedModel = Backbone.AssociatedModel = Backbone.Associations.AssociatedModel = BackboneModel.extend({ | |
// Define relations with Associated Model. | |
relations:undefined, | |
// Define `Model` property which can keep track of already fired `events`, | |
// and prevent redundant event to be triggered in case of cyclic model graphs. | |
_proxyCalls:undefined, | |
// Get the value of an attribute. | |
get:function (attr) { | |
var obj = ModelProto.get.call(this, attr); | |
return obj ? obj : this._getAttr.apply(this, arguments); | |
}, | |
// Set a hash of model attributes on the Backbone Model. | |
set:function (key, value, options) { | |
var attributes, result; | |
// Duplicate backbone's behavior to allow separate key/value parameters, | |
// instead of a single 'attributes' object. | |
if (_.isObject(key) || key == null) { | |
attributes = key; | |
options = value; | |
} else { | |
attributes = {}; | |
attributes[key] = value; | |
} | |
result = this._set(attributes, options); | |
// Trigger events which have been blocked until the entire object graph is updated. | |
this._processPendingEvents(); | |
return result; | |
}, | |
// Works with an attribute hash and options + fully qualified paths | |
_set:function (attributes, options) { | |
var attr, modelMap, modelId, obj, result = this; | |
if (!attributes) return this; | |
for (attr in attributes) { | |
//Create a map for each unique object whose attributes we want to set | |
modelMap || (modelMap = {}); | |
if (attr.match(pathChecker)) { | |
var pathTokens = getPathArray(attr), initials = _.initial(pathTokens), | |
last = pathTokens[pathTokens.length - 1], | |
parentModel = this.get(initials); | |
if (parentModel instanceof AssociatedModel) { | |
obj = modelMap[parentModel.cid] || (modelMap[parentModel.cid] = {'model':parentModel, 'data':{}}); | |
obj.data[last] = attributes[attr]; | |
} | |
} else { | |
obj = modelMap[this.cid] || (modelMap[this.cid] = {'model':this, 'data':{}}); | |
obj.data[attr] = attributes[attr]; | |
} | |
} | |
if (modelMap) { | |
for (modelId in modelMap) { | |
obj = modelMap[modelId]; | |
this._setAttr.call(obj.model, obj.data, options) || (result = false); | |
} | |
} else { | |
result = this._setAttr.call(this, attributes, options); | |
} | |
return result; | |
}, | |
// Set a hash of model attributes on the object, | |
// fire Backbone `event` with options. | |
// It maintains relations between models during the set operation. | |
// It also bubbles up child events to the parent. | |
_setAttr:function (attributes, options) { | |
var attr; | |
// Extract attributes and options. | |
options || (options = {}); | |
if (options.unset) for (attr in attributes) attributes[attr] = void 0; | |
this.parents = this.parents || []; | |
if (this.relations) { | |
// Iterate over `this.relations` and `set` model and collection values | |
// if `relations` are available. | |
_.each(this.relations, function (relation) { | |
var relationKey = relation.key, | |
relatedModel = relation.relatedModel, | |
collectionType = relation.collectionType, | |
map = relation.map, | |
currVal = this.attributes[relationKey], | |
idKey = currVal && currVal.idAttribute, | |
val, relationOptions, data, relationValue, newCtx = false; | |
// Call function if relatedModel is implemented as a function | |
if (relatedModel && !(relatedModel.prototype instanceof BackboneModel)) | |
relatedModel = _.isFunction(relatedModel) ? | |
relatedModel.call(this, relation, attributes) : | |
relatedModel; | |
// Get class if relation and map is stored as a string. | |
if (relatedModel && _.isString(relatedModel)) { | |
relatedModel = (relatedModel === Backbone.Self) ? this.constructor : map2Scope(relatedModel); | |
} | |
collectionType && _.isString(collectionType) && (collectionType = map2Scope(collectionType)); | |
map && _.isString(map) && (map = map2Scope(map)); | |
// Merge in `options` specific to this relation. | |
relationOptions = relation.options ? _.extend({}, relation.options, options) : options; | |
if ((!relatedModel) && (!collectionType)) | |
throw new Error('specify either a relatedModel or collectionType'); | |
if (attributes[relationKey]) { | |
// Get value of attribute with relation key in `val`. | |
val = _.result(attributes, relationKey); | |
// Map `val` if a transformation function is provided. | |
val = map ? map.call(this, val, collectionType ? collectionType : relatedModel) : val; | |
// If `relation.type` is `Backbone.Many`, | |
// Create `Backbone.Collection` with passed data and perform Backbone `set`. | |
if (relation.type === Backbone.Many) { | |
// `collectionType` of defined `relation` should be instance of `Backbone.Collection`. | |
if (collectionType && !collectionType.prototype instanceof BackboneCollection) { | |
throw new Error('collectionType must inherit from Backbone.Collection'); | |
} | |
if (val instanceof BackboneCollection && !currVal) { | |
data = val; | |
// Set current context as new context | |
newCtx = true; | |
} else { | |
// Create a new collection | |
if (!currVal) { | |
data = collectionType ? new collectionType() : this._createCollection(relatedModel); | |
} else { | |
data = currVal; | |
// Setting this flag will prevent events from firing immediately. That way clients | |
// will not get events until the entire object graph is updated. | |
data._deferEvents = true; | |
} | |
// Use Backbone.Collection's `reset` or smart `set` method | |
data[relationOptions.reset ? 'reset' : 'set'](val instanceof BackboneCollection | |
? val.models | |
: val, relationOptions); | |
} | |
} else if (relation.type === Backbone.One) { | |
if (!relatedModel) | |
throw new Error('specify a relatedModel for Backbone.One type'); | |
if (!(relatedModel.prototype instanceof Backbone.AssociatedModel)) | |
throw new Error('specify an AssociatedModel for Backbone.One type'); | |
if (val instanceof AssociatedModel) { | |
data = val; | |
// Compute whether the context is a new one after this assignment. | |
newCtx = (currVal !== val); | |
} else { | |
//Create a new model | |
if (!currVal) { | |
data = new relatedModel(val, relationOptions); | |
} else { | |
//Is the passed in data for the same key? | |
if (currVal && val[idKey] && currVal.get(idKey) === val[idKey]) { | |
// Setting this flag will prevent events from firing immediately. That way clients | |
// will not get events until the entire object graph is updated. | |
currVal._deferEvents = true; | |
// Perform the traditional `set` operation | |
currVal._set(val, relationOptions); | |
data = currVal; | |
} else { | |
data = new relatedModel(val, relationOptions); | |
} | |
} | |
} | |
} else { | |
throw new Error('type attribute must be specified and have the values Backbone.One or Backbone.Many'); | |
} | |
attributes[relationKey] = data; | |
relationValue = data; | |
// Add proxy events to respective parents. | |
// Only add callback if not defined or new Ctx has been identified. | |
if (newCtx || (relationValue && !relationValue._proxyCallback)) { | |
relationValue._proxyCallback = function () { | |
return this._bubbleEvent.call(this, relationKey, relationValue, arguments); | |
}; | |
relationValue.on("all", relationValue._proxyCallback, this); | |
} | |
} | |
//Distinguish between the value of undefined versus a set no-op | |
if (attributes.hasOwnProperty(relationKey)) { | |
//Maintain reverse pointers - a.k.a parents | |
var updated = attributes[relationKey]; | |
var original = this.attributes[relationKey]; | |
if (updated) { | |
updated.parents = updated.parents || []; | |
(_.indexOf(updated.parents, this) == -1) && updated.parents.push(this); | |
} else if (original && original.parents.length > 0) { // New value is undefined | |
original.parents = _.difference(original.parents, [this]); | |
// Don't bubble to this parent anymore | |
original._proxyCallback && original.off("all", original._proxyCallback, this); | |
} | |
} | |
}, this); | |
} | |
// Return results for `BackboneModel.set`. | |
return ModelProto.set.call(this, attributes, options); | |
}, | |
// Bubble-up event to `parent` Model | |
_bubbleEvent:function (relationKey, relationValue, eventArguments) { | |
var args = eventArguments, | |
opt = args[0].split(":"), | |
eventType = opt[0], | |
catch_all = args[0] == "nested-change", | |
eventObject = args[1], | |
colObject = args[2], | |
indexEventObject = -1, | |
_proxyCalls = relationValue._proxyCalls, | |
cargs, | |
eventPath, | |
basecolEventPath, | |
isDefaultEvent = _.indexOf(defaultEvents, eventType) !== -1; | |
//Short circuit the listen in to the nested-graph event | |
if (catch_all) return; | |
// Change the event name to a fully qualified path. | |
_.size(opt) > 1 && (eventPath = opt[1]); | |
if (_.indexOf(collectionEvents, eventType) !== -1) { | |
colObject = eventObject; | |
} | |
// Find the specific object in the collection which has changed. | |
if (relationValue instanceof BackboneCollection && isDefaultEvent && eventObject) { | |
var pathTokens = getPathArray(eventPath), | |
initialTokens = _.initial(pathTokens), colModel; | |
colModel = relationValue.find(function (model) { | |
if (eventObject === model) return true; | |
if (!model) return false; | |
var changedModel = model.get(initialTokens); | |
if ((changedModel instanceof AssociatedModel || changedModel instanceof BackboneCollection) | |
&& eventObject === changedModel) | |
return true; | |
changedModel = model.get(pathTokens); | |
if ((changedModel instanceof AssociatedModel || changedModel instanceof BackboneCollection) | |
&& eventObject === changedModel) | |
return true; | |
if (changedModel instanceof BackboneCollection && colObject | |
&& colObject === changedModel) | |
return true; | |
}); | |
colModel && (indexEventObject = relationValue.indexOf(colModel)); | |
} | |
// Manipulate `eventPath`. | |
eventPath = relationKey + ((indexEventObject !== -1 && (eventType === "change" || eventPath)) ? | |
"[" + indexEventObject + "]" : "") + (eventPath ? "." + eventPath : ""); | |
// Short circuit collection * events | |
if (/\[\*\]/g.test(eventPath)) return this; | |
basecolEventPath = eventPath.replace(/\[\d+\]/g, '[*]'); | |
cargs = []; | |
cargs.push.apply(cargs, args); | |
cargs[0] = eventType + ":" + eventPath; | |
// If event has been already triggered as result of same source `eventPath`, | |
// no need to re-trigger event to prevent cycle. | |
_proxyCalls = relationValue._proxyCalls = (_proxyCalls || {}); | |
if (this._isEventAvailable.call(this, _proxyCalls, eventPath)) return this; | |
// Add `eventPath` in `_proxyCalls` to keep track of already triggered `event`. | |
_proxyCalls[eventPath] = true; | |
// Set up previous attributes correctly. | |
if ("change" === eventType) { | |
this._previousAttributes[relationKey] = relationValue._previousAttributes; | |
this.changed[relationKey] = relationValue; | |
} | |
// Bubble up event to parent `model` with new changed arguments. | |
this.trigger.apply(this, cargs); | |
//Only fire for change. Not change:attribute | |
if ("change" === eventType && this.get(eventPath) != args[2]) { | |
var ncargs = ["nested-change", eventPath, args[1]]; | |
args[2] && ncargs.push(args[2]); //args[2] will be options if present | |
this.trigger.apply(this, ncargs); | |
} | |
// Remove `eventPath` from `_proxyCalls`, | |
// if `eventPath` and `_proxyCalls` are available, | |
// which allow event to be triggered on for next operation of `set`. | |
if (_proxyCalls && eventPath) delete _proxyCalls[eventPath]; | |
// Create a collection modified event with wild-card | |
if (eventPath !== basecolEventPath) { | |
cargs[0] = eventType + ":" + basecolEventPath; | |
this.trigger.apply(this, cargs); | |
} | |
return this; | |
}, | |
// Has event been fired from this source. Used to prevent event recursion in cyclic graphs | |
_isEventAvailable:function (_proxyCalls, path) { | |
return _.find(_proxyCalls, function (value, eventKey) { | |
return path.indexOf(eventKey, path.length - eventKey.length) !== -1; | |
}); | |
}, | |
// Returns New `collection` of type `relation.relatedModel`. | |
_createCollection:function (type) { | |
var collection, relatedModel = type; | |
_.isString(relatedModel) && (relatedModel = map2Scope(relatedModel)); | |
// Creates new `Backbone.Collection` and defines model class. | |
if (relatedModel && relatedModel.prototype instanceof AssociatedModel) { | |
collection = new BackboneCollection(); | |
collection.model = relatedModel; | |
} else { | |
throw new Error('type must inherit from Backbone.AssociatedModel'); | |
} | |
return collection; | |
}, | |
// Process all pending events after the entire object graph has been updated | |
_processPendingEvents:function () { | |
if (!this._processedEvents) { | |
this._processedEvents = true; | |
this._deferEvents = false; | |
// Trigger all pending events | |
_.each(this._pendingEvents, function (e) { | |
e.c.trigger.apply(e.c, e.a); | |
}); | |
this._pendingEvents = []; | |
// Traverse down the object graph and call process pending events on sub-trees | |
_.each(this.relations, function (relation) { | |
var val = this.attributes[relation.key]; | |
val && val._processPendingEvents(); | |
}, this); | |
delete this._processedEvents; | |
} | |
}, | |
// Override trigger to defer events in the object graph. | |
trigger:function (name) { | |
// Defer event processing | |
if (this._deferEvents) { | |
this._pendingEvents = this._pendingEvents || []; | |
// Maintain a queue of pending events to trigger after the entire object graph is updated. | |
this._pendingEvents.push({c:this, a:arguments}); | |
} else { | |
ModelProto.trigger.apply(this, arguments); | |
} | |
}, | |
// The JSON representation of the model. | |
toJSON:function (options) { | |
var json = {}, aJson; | |
json[this.idAttribute] = this.id; | |
if (!this.visited) { | |
this.visited = true; | |
// Get json representation from `BackboneModel.toJSON`. | |
json = ModelProto.toJSON.apply(this, arguments); | |
// If `this.relations` is defined, iterate through each `relation` | |
// and added it's json representation to parents' json representation. | |
if (this.relations) { | |
_.each(this.relations, function (relation) { | |
var attr = this.attributes[relation.key]; | |
if (attr) { | |
aJson = attr.toJSON(options); | |
json[relation.key] = _.isArray(aJson) ? _.compact(aJson) : aJson; | |
} | |
}, this); | |
} | |
delete this.visited; | |
} | |
return json; | |
}, | |
// Create a new model with identical attributes to this one. | |
clone:function () { | |
return new this.constructor(this.toJSON()); | |
}, | |
// Call this if you want to set an `AssociatedModel` to a falsy value like undefined/null directly. | |
// Not calling this will leak memory and have wrong parents. | |
// See test case "parent relations" | |
cleanup:function () { | |
_.each(this.relations, function (relation) { | |
var val = this.attributes[relation.key]; | |
val && (val.parents = _.difference(val.parents, [this])); | |
}, this); | |
this.off(); | |
}, | |
// Navigate the path to the leaf object in the path to query for the attribute value | |
_getAttr:function (path) { | |
var result = this, | |
//Tokenize the path | |
attrs = getPathArray(path), | |
key, | |
i; | |
if (_.size(attrs) < 1) return; | |
for (i = 0; i < attrs.length; i++) { | |
key = attrs[i]; | |
if (!result) break; | |
//Navigate the path to get to the result | |
result = result instanceof BackboneCollection | |
? (isNaN(key) ? undefined : result.at(key)) | |
: result.attributes[key]; | |
} | |
return result; | |
} | |
}); | |
var delimiters = /[^\.\[\]]+/g; | |
// Tokenize the fully qualified event path | |
var getPathArray = function (path) { | |
if (path === '') return ['']; | |
return _.isString(path) ? (path.match(delimiters)) : path || []; | |
}; | |
var map2Scope = function (path) { | |
return _.reduce(path.split('.'), function (memo, elem) { | |
return memo[elem] | |
}, root); | |
}; | |
//Infer the relation from the collection's parents and find the appropriate map for the passed in `models` | |
var map2models = function (parents, target, models) { | |
var relation, surrogate; | |
//Iterate over collection's parents | |
_.find(parents, function (parent) { | |
//Iterate over relations | |
relation = _.find(parent.relations, function (rel) { | |
return parent.get(rel.key) === target; | |
}, this); | |
if (relation) { | |
surrogate = parent;//surrogate for transformation | |
return true;//break; | |
} | |
}, this); | |
//If we found a relation and it has a mapping function | |
if (relation && relation.map) { | |
return relation.map.call(surrogate, models, target); | |
} | |
return models; | |
}; | |
var proxies = {}; | |
// Proxy Backbone collection methods | |
_.each(['set', 'remove', 'reset'], function (method) { | |
proxies[method] = BackboneCollection.prototype[method]; | |
CollectionProto[method] = function (models, options) { | |
//Short-circuit if this collection doesn't hold `AssociatedModels` | |
if (this.model.prototype instanceof AssociatedModel && this.parents) { | |
//Find a map function if available and perform a transformation | |
arguments[0] = map2models(this.parents, this, models); | |
} | |
return proxies[method].apply(this, arguments); | |
} | |
}); | |
// Override trigger to defer events in the object graph. | |
proxies['trigger'] = CollectionProto['trigger']; | |
CollectionProto['trigger'] = function (name) { | |
if (this._deferEvents) { | |
this._pendingEvents = this._pendingEvents || []; | |
// Maintain a queue of pending events to trigger after the entire object graph is updated. | |
this._pendingEvents.push({c:this, a:arguments}); | |
} else { | |
proxies['trigger'].apply(this, arguments); | |
} | |
}; | |
// Attach process pending event functionality on collections as well. Re-use from `AssociatedModel` | |
CollectionProto._processPendingEvents = AssociatedModel.prototype._processPendingEvents; | |
}).call(this); |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
// Backbone.js 1.0.0 | |
// (c) 2010-2013 Jeremy Ashkenas, DocumentCloud Inc. | |
// Backbone may be freely distributed under the MIT license. | |
// For all details and documentation: | |
// http://backbonejs.org | |
(function(){ | |
// Initial Setup | |
// ------------- | |
// Save a reference to the global object (`window` in the browser, `exports` | |
// on the server). | |
var root = this; | |
// Save the previous value of the `Backbone` variable, so that it can be | |
// restored later on, if `noConflict` is used. | |
var previousBackbone = root.Backbone; | |
// Create local references to array methods we'll want to use later. | |
var array = []; | |
var push = array.push; | |
var slice = array.slice; | |
var splice = array.splice; | |
// The top-level namespace. All public Backbone classes and modules will | |
// be attached to this. Exported for both the browser and the server. | |
var Backbone; | |
if (typeof exports !== 'undefined') { | |
Backbone = exports; | |
} else { | |
Backbone = root.Backbone = {}; | |
} | |
// Current version of the library. Keep in sync with `package.json`. | |
Backbone.VERSION = '1.0.0'; | |
// Require Underscore, if we're on the server, and it's not already present. | |
var _ = root._; | |
if (!_ && (typeof require !== 'undefined')) _ = require('underscore'); | |
// For Backbone's purposes, jQuery, Zepto, Ender, or My Library (kidding) owns | |
// the `$` variable. | |
Backbone.$ = root.jQuery || root.Zepto || root.ender || root.$; | |
// Runs Backbone.js in *noConflict* mode, returning the `Backbone` variable | |
// to its previous owner. Returns a reference to this Backbone object. | |
Backbone.noConflict = function() { | |
root.Backbone = previousBackbone; | |
return this; | |
}; | |
// Turn on `emulateHTTP` to support legacy HTTP servers. Setting this option | |
// will fake `"PUT"` and `"DELETE"` requests via the `_method` parameter and | |
// set a `X-Http-Method-Override` header. | |
Backbone.emulateHTTP = false; | |
// Turn on `emulateJSON` to support legacy servers that can't deal with direct | |
// `application/json` requests ... will encode the body as | |
// `application/x-www-form-urlencoded` instead and will send the model in a | |
// form param named `model`. | |
Backbone.emulateJSON = false; | |
// Backbone.Events | |
// --------------- | |
// A module that can be mixed in to *any object* in order to provide it with | |
// custom events. You may bind with `on` or remove with `off` callback | |
// functions to an event; `trigger`-ing an event fires all callbacks in | |
// succession. | |
// | |
// var object = {}; | |
// _.extend(object, Backbone.Events); | |
// object.on('expand', function(){ alert('expanded'); }); | |
// object.trigger('expand'); | |
// | |
var Events = Backbone.Events = { | |
// Bind an event to a `callback` function. Passing `"all"` will bind | |
// the callback to all events fired. | |
on: function(name, callback, context) { | |
if (!eventsApi(this, 'on', name, [callback, context]) || !callback) return this; | |
this._events || (this._events = {}); | |
var events = this._events[name] || (this._events[name] = []); | |
events.push({callback: callback, context: context, ctx: context || this}); | |
return this; | |
}, | |
// Bind an event to only be triggered a single time. After the first time | |
// the callback is invoked, it will be removed. | |
once: function(name, callback, context) { | |
if (!eventsApi(this, 'once', name, [callback, context]) || !callback) return this; | |
var self = this; | |
var once = _.once(function() { | |
self.off(name, once); | |
callback.apply(this, arguments); | |
}); | |
once._callback = callback; | |
return this.on(name, once, context); | |
}, | |
// Remove one or many callbacks. If `context` is null, removes all | |
// callbacks with that function. If `callback` is null, removes all | |
// callbacks for the event. If `name` is null, removes all bound | |
// callbacks for all events. | |
off: function(name, callback, context) { | |
var retain, ev, events, names, i, l, j, k; | |
if (!this._events || !eventsApi(this, 'off', name, [callback, context])) return this; | |
if (!name && !callback && !context) { | |
this._events = {}; | |
return this; | |
} | |
names = name ? [name] : _.keys(this._events); | |
for (i = 0, l = names.length; i < l; i++) { | |
name = names[i]; | |
if (events = this._events[name]) { | |
this._events[name] = retain = []; | |
if (callback || context) { | |
for (j = 0, k = events.length; j < k; j++) { | |
ev = events[j]; | |
if ((callback && callback !== ev.callback && callback !== ev.callback._callback) || | |
(context && context !== ev.context)) { | |
retain.push(ev); | |
} | |
} | |
} | |
if (!retain.length) delete this._events[name]; | |
} | |
} | |
return this; | |
}, | |
// Trigger one or many events, firing all bound callbacks. Callbacks are | |
// passed the same arguments as `trigger` is, apart from the event name | |
// (unless you're listening on `"all"`, which will cause your callback to | |
// receive the true name of the event as the first argument). | |
trigger: function(name) { | |
if (!this._events) return this; | |
var args = slice.call(arguments, 1); | |
if (!eventsApi(this, 'trigger', name, args)) return this; | |
var events = this._events[name]; | |
var allEvents = this._events.all; | |
if (events) triggerEvents(events, args); | |
if (allEvents) triggerEvents(allEvents, arguments); | |
return this; | |
}, | |
// Tell this object to stop listening to either specific events ... or | |
// to every object it's currently listening to. | |
stopListening: function(obj, name, callback) { | |
var listeners = this._listeners; | |
if (!listeners) return this; | |
var deleteListener = !name && !callback; | |
if (typeof name === 'object') callback = this; | |
if (obj) (listeners = {})[obj._listenerId] = obj; | |
for (var id in listeners) { | |
listeners[id].off(name, callback, this); | |
if (deleteListener) delete this._listeners[id]; | |
} | |
return this; | |
} | |
}; | |
// Regular expression used to split event strings. | |
var eventSplitter = /\s+/; | |
// Implement fancy features of the Events API such as multiple event | |
// names `"change blur"` and jQuery-style event maps `{change: action}` | |
// in terms of the existing API. | |
var eventsApi = function(obj, action, name, rest) { | |
if (!name) return true; | |
// Handle event maps. | |
if (typeof name === 'object') { | |
for (var key in name) { | |
obj[action].apply(obj, [key, name[key]].concat(rest)); | |
} | |
return false; | |
} | |
// Handle space separated event names. | |
if (eventSplitter.test(name)) { | |
var names = name.split(eventSplitter); | |
for (var i = 0, l = names.length; i < l; i++) { | |
obj[action].apply(obj, [names[i]].concat(rest)); | |
} | |
return false; | |
} | |
return true; | |
}; | |
// A difficult-to-believe, but optimized internal dispatch function for | |
// triggering events. Tries to keep the usual cases speedy (most internal | |
// Backbone events have 3 arguments). | |
var triggerEvents = function(events, args) { | |
var ev, i = -1, l = events.length, a1 = args[0], a2 = args[1], a3 = args[2]; | |
switch (args.length) { | |
case 0: while (++i < l) (ev = events[i]).callback.call(ev.ctx); return; | |
case 1: while (++i < l) (ev = events[i]).callback.call(ev.ctx, a1); return; | |
case 2: while (++i < l) (ev = events[i]).callback.call(ev.ctx, a1, a2); return; | |
case 3: while (++i < l) (ev = events[i]).callback.call(ev.ctx, a1, a2, a3); return; | |
default: while (++i < l) (ev = events[i]).callback.apply(ev.ctx, args); | |
} | |
}; | |
var listenMethods = {listenTo: 'on', listenToOnce: 'once'}; | |
// Inversion-of-control versions of `on` and `once`. Tell *this* object to | |
// listen to an event in another object ... keeping track of what it's | |
// listening to. | |
_.each(listenMethods, function(implementation, method) { | |
Events[method] = function(obj, name, callback) { | |
var listeners = this._listeners || (this._listeners = {}); | |
var id = obj._listenerId || (obj._listenerId = _.uniqueId('l')); | |
listeners[id] = obj; | |
if (typeof name === 'object') callback = this; | |
obj[implementation](name, callback, this); | |
return this; | |
}; | |
}); | |
// Aliases for backwards compatibility. | |
Events.bind = Events.on; | |
Events.unbind = Events.off; | |
// Allow the `Backbone` object to serve as a global event bus, for folks who | |
// want global "pubsub" in a convenient place. | |
_.extend(Backbone, Events); | |
// Backbone.Model | |
// -------------- | |
// Backbone **Models** are the basic data object in the framework -- | |
// frequently representing a row in a table in a database on your server. | |
// A discrete chunk of data and a bunch of useful, related methods for | |
// performing computations and transformations on that data. | |
// Create a new model with the specified attributes. A client id (`cid`) | |
// is automatically generated and assigned for you. | |
var Model = Backbone.Model = function(attributes, options) { | |
var defaults; | |
var attrs = attributes || {}; | |
options || (options = {}); | |
this.cid = _.uniqueId('c'); | |
this.attributes = {}; | |
_.extend(this, _.pick(options, modelOptions)); | |
if (options.parse) attrs = this.parse(attrs, options) || {}; | |
if (defaults = _.result(this, 'defaults')) { | |
attrs = _.defaults({}, attrs, defaults); | |
} | |
this.set(attrs, options); | |
this.changed = {}; | |
this.initialize.apply(this, arguments); | |
}; | |
// A list of options to be attached directly to the model, if provided. | |
var modelOptions = ['url', 'urlRoot', 'collection']; | |
// Attach all inheritable methods to the Model prototype. | |
_.extend(Model.prototype, Events, { | |
// A hash of attributes whose current and previous value differ. | |
changed: null, | |
// The value returned during the last failed validation. | |
validationError: null, | |
// The default name for the JSON `id` attribute is `"id"`. MongoDB and | |
// CouchDB users may want to set this to `"_id"`. | |
idAttribute: 'id', | |
// Initialize is an empty function by default. Override it with your own | |
// initialization logic. | |
initialize: function(){}, | |
// Return a copy of the model's `attributes` object. | |
toJSON: function(options) { | |
return _.clone(this.attributes); | |
}, | |
// Proxy `Backbone.sync` by default -- but override this if you need | |
// custom syncing semantics for *this* particular model. | |
sync: function() { | |
return Backbone.sync.apply(this, arguments); | |
}, | |
// Get the value of an attribute. | |
get: function(attr) { | |
return this.attributes[attr]; | |
}, | |
// Get the HTML-escaped value of an attribute. | |
escape: function(attr) { | |
return _.escape(this.get(attr)); | |
}, | |
// Returns `true` if the attribute contains a value that is not null | |
// or undefined. | |
has: function(attr) { | |
return this.get(attr) != null; | |
}, | |
// Set a hash of model attributes on the object, firing `"change"`. This is | |
// the core primitive operation of a model, updating the data and notifying | |
// anyone who needs to know about the change in state. The heart of the beast. | |
set: function(key, val, options) { | |
var attr, attrs, unset, changes, silent, changing, prev, current; | |
if (key == null) return this; | |
// Handle both `"key", value` and `{key: value}` -style arguments. | |
if (typeof key === 'object') { | |
attrs = key; | |
options = val; | |
} else { | |
(attrs = {})[key] = val; | |
} | |
options || (options = {}); | |
// Run validation. | |
if (!this._validate(attrs, options)) return false; | |
// Extract attributes and options. | |
unset = options.unset; | |
silent = options.silent; | |
changes = []; | |
changing = this._changing; | |
this._changing = true; | |
if (!changing) { | |
this._previousAttributes = _.clone(this.attributes); | |
this.changed = {}; | |
} | |
current = this.attributes, prev = this._previousAttributes; | |
// Check for changes of `id`. | |
if (this.idAttribute in attrs) this.id = attrs[this.idAttribute]; | |
// For each `set` attribute, update or delete the current value. | |
for (attr in attrs) { | |
val = attrs[attr]; | |
if (!_.isEqual(current[attr], val)) changes.push(attr); | |
if (!_.isEqual(prev[attr], val)) { | |
this.changed[attr] = val; | |
} else { | |
delete this.changed[attr]; | |
} | |
unset ? delete current[attr] : current[attr] = val; | |
} | |
// Trigger all relevant attribute changes. | |
if (!silent) { | |
if (changes.length) this._pending = true; | |
for (var i = 0, l = changes.length; i < l; i++) { | |
this.trigger('change:' + changes[i], this, current[changes[i]], options); | |
} | |
} | |
// You might be wondering why there's a `while` loop here. Changes can | |
// be recursively nested within `"change"` events. | |
if (changing) return this; | |
if (!silent) { | |
while (this._pending) { | |
this._pending = false; | |
this.trigger('change', this, options); | |
} | |
} | |
this._pending = false; | |
this._changing = false; | |
return this; | |
}, | |
// Remove an attribute from the model, firing `"change"`. `unset` is a noop | |
// if the attribute doesn't exist. | |
unset: function(attr, options) { | |
return this.set(attr, void 0, _.extend({}, options, {unset: true})); | |
}, | |
// Clear all attributes on the model, firing `"change"`. | |
clear: function(options) { | |
var attrs = {}; | |
for (var key in this.attributes) attrs[key] = void 0; | |
return this.set(attrs, _.extend({}, options, {unset: true})); | |
}, | |
// Determine if the model has changed since the last `"change"` event. | |
// If you specify an attribute name, determine if that attribute has changed. | |
hasChanged: function(attr) { | |
if (attr == null) return !_.isEmpty(this.changed); | |
return _.has(this.changed, attr); | |
}, | |
// Return an object containing all the attributes that have changed, or | |
// false if there are no changed attributes. Useful for determining what | |
// parts of a view need to be updated and/or what attributes need to be | |
// persisted to the server. Unset attributes will be set to undefined. | |
// You can also pass an attributes object to diff against the model, | |
// determining if there *would be* a change. | |
changedAttributes: function(diff) { | |
if (!diff) return this.hasChanged() ? _.clone(this.changed) : false; | |
var val, changed = false; | |
var old = this._changing ? this._previousAttributes : this.attributes; | |
for (var attr in diff) { | |
if (_.isEqual(old[attr], (val = diff[attr]))) continue; | |
(changed || (changed = {}))[attr] = val; | |
} | |
return changed; | |
}, | |
// Get the previous value of an attribute, recorded at the time the last | |
// `"change"` event was fired. | |
previous: function(attr) { | |
if (attr == null || !this._previousAttributes) return null; | |
return this._previousAttributes[attr]; | |
}, | |
// Get all of the attributes of the model at the time of the previous | |
// `"change"` event. | |
previousAttributes: function() { | |
return _.clone(this._previousAttributes); | |
}, | |
// Fetch the model from the server. If the server's representation of the | |
// model differs from its current attributes, they will be overridden, | |
// triggering a `"change"` event. | |
fetch: function(options) { | |
options = options ? _.clone(options) : {}; | |
if (options.parse === void 0) options.parse = true; | |
var model = this; | |
var success = options.success; | |
options.success = function(resp) { | |
if (!model.set(model.parse(resp, options), options)) return false; | |
if (success) success(model, resp, options); | |
model.trigger('sync', model, resp, options); | |
}; | |
wrapError(this, options); | |
return this.sync('read', this, options); | |
}, | |
// Set a hash of model attributes, and sync the model to the server. | |
// If the server returns an attributes hash that differs, the model's | |
// state will be `set` again. | |
save: function(key, val, options) { | |
var attrs, method, xhr, attributes = this.attributes; | |
// Handle both `"key", value` and `{key: value}` -style arguments. | |
if (key == null || typeof key === 'object') { | |
attrs = key; | |
options = val; | |
} else { | |
(attrs = {})[key] = val; | |
} | |
// If we're not waiting and attributes exist, save acts as `set(attr).save(null, opts)`. | |
if (attrs && (!options || !options.wait) && !this.set(attrs, options)) return false; | |
options = _.extend({validate: true}, options); | |
// Do not persist invalid models. | |
if (!this._validate(attrs, options)) return false; | |
// Set temporary attributes if `{wait: true}`. | |
if (attrs && options.wait) { | |
this.attributes = _.extend({}, attributes, attrs); | |
} | |
// After a successful server-side save, the client is (optionally) | |
// updated with the server-side state. | |
if (options.parse === void 0) options.parse = true; | |
var model = this; | |
var success = options.success; | |
options.success = function(resp) { | |
// Ensure attributes are restored during synchronous saves. | |
model.attributes = attributes; | |
var serverAttrs = model.parse(resp, options); | |
if (options.wait) serverAttrs = _.extend(attrs || {}, serverAttrs); | |
if (_.isObject(serverAttrs) && !model.set(serverAttrs, options)) { | |
return false; | |
} | |
if (success) success(model, resp, options); | |
model.trigger('sync', model, resp, options); | |
}; | |
wrapError(this, options); | |
method = this.isNew() ? 'create' : (options.patch ? 'patch' : 'update'); | |
if (method === 'patch') options.attrs = attrs; | |
xhr = this.sync(method, this, options); | |
// Restore attributes. | |
if (attrs && options.wait) this.attributes = attributes; | |
return xhr; | |
}, | |
// Destroy this model on the server if it was already persisted. | |
// Optimistically removes the model from its collection, if it has one. | |
// If `wait: true` is passed, waits for the server to respond before removal. | |
destroy: function(options) { | |
options = options ? _.clone(options) : {}; | |
var model = this; | |
var success = options.success; | |
var destroy = function() { | |
model.trigger('destroy', model, model.collection, options); | |
}; | |
options.success = function(resp) { | |
if (options.wait || model.isNew()) destroy(); | |
if (success) success(model, resp, options); | |
if (!model.isNew()) model.trigger('sync', model, resp, options); | |
}; | |
if (this.isNew()) { | |
options.success(); | |
return false; | |
} | |
wrapError(this, options); | |
var xhr = this.sync('delete', this, options); | |
if (!options.wait) destroy(); | |
return xhr; | |
}, | |
// Default URL for the model's representation on the server -- if you're | |
// using Backbone's restful methods, override this to change the endpoint | |
// that will be called. | |
url: function() { | |
var base = _.result(this, 'urlRoot') || _.result(this.collection, 'url') || urlError(); | |
if (this.isNew()) return base; | |
return base + (base.charAt(base.length - 1) === '/' ? '' : '/') + encodeURIComponent(this.id); | |
}, | |
// **parse** converts a response into the hash of attributes to be `set` on | |
// the model. The default implementation is just to pass the response along. | |
parse: function(resp, options) { | |
return resp; | |
}, | |
// Create a new model with identical attributes to this one. | |
clone: function() { | |
return new this.constructor(this.attributes); | |
}, | |
// A model is new if it has never been saved to the server, and lacks an id. | |
isNew: function() { | |
return this.id == null; | |
}, | |
// Check if the model is currently in a valid state. | |
isValid: function(options) { | |
return this._validate({}, _.extend(options || {}, { validate: true })); | |
}, | |
// Run validation against the next complete set of model attributes, | |
// returning `true` if all is well. Otherwise, fire an `"invalid"` event. | |
_validate: function(attrs, options) { | |
if (!options.validate || !this.validate) return true; | |
attrs = _.extend({}, this.attributes, attrs); | |
var error = this.validationError = this.validate(attrs, options) || null; | |
if (!error) return true; | |
this.trigger('invalid', this, error, _.extend(options || {}, {validationError: error})); | |
return false; | |
} | |
}); | |
// Underscore methods that we want to implement on the Model. | |
var modelMethods = ['keys', 'values', 'pairs', 'invert', 'pick', 'omit']; | |
// Mix in each Underscore method as a proxy to `Model#attributes`. | |
_.each(modelMethods, function(method) { | |
Model.prototype[method] = function() { | |
var args = slice.call(arguments); | |
args.unshift(this.attributes); | |
return _[method].apply(_, args); | |
}; | |
}); | |
// Backbone.Collection | |
// ------------------- | |
// If models tend to represent a single row of data, a Backbone Collection is | |
// more analagous to a table full of data ... or a small slice or page of that | |
// table, or a collection of rows that belong together for a particular reason | |
// -- all of the messages in this particular folder, all of the documents | |
// belonging to this particular author, and so on. Collections maintain | |
// indexes of their models, both in order, and for lookup by `id`. | |
// Create a new **Collection**, perhaps to contain a specific type of `model`. | |
// If a `comparator` is specified, the Collection will maintain | |
// its models in sort order, as they're added and removed. | |
var Collection = Backbone.Collection = function(models, options) { | |
options || (options = {}); | |
if (options.url) this.url = options.url; | |
if (options.model) this.model = options.model; | |
if (options.comparator !== void 0) this.comparator = options.comparator; | |
this._reset(); | |
this.initialize.apply(this, arguments); | |
if (models) this.reset(models, _.extend({silent: true}, options)); | |
}; | |
// Default options for `Collection#set`. | |
var setOptions = {add: true, remove: true, merge: true}; | |
var addOptions = {add: true, merge: false, remove: false}; | |
// Define the Collection's inheritable methods. | |
_.extend(Collection.prototype, Events, { | |
// The default model for a collection is just a **Backbone.Model**. | |
// This should be overridden in most cases. | |
model: Model, | |
// Initialize is an empty function by default. Override it with your own | |
// initialization logic. | |
initialize: function(){}, | |
// The JSON representation of a Collection is an array of the | |
// models' attributes. | |
toJSON: function(options) { | |
return this.map(function(model){ return model.toJSON(options); }); | |
}, | |
// Proxy `Backbone.sync` by default. | |
sync: function() { | |
return Backbone.sync.apply(this, arguments); | |
}, | |
// Add a model, or list of models to the set. | |
add: function(models, options) { | |
return this.set(models, _.defaults(options || {}, addOptions)); | |
}, | |
// Remove a model, or a list of models from the set. | |
remove: function(models, options) { | |
models = _.isArray(models) ? models.slice() : [models]; | |
options || (options = {}); | |
var i, l, index, model; | |
for (i = 0, l = models.length; i < l; i++) { | |
model = this.get(models[i]); | |
if (!model) continue; | |
delete this._byId[model.id]; | |
delete this._byId[model.cid]; | |
index = this.indexOf(model); | |
this.models.splice(index, 1); | |
this.length--; | |
if (!options.silent) { | |
options.index = index; | |
model.trigger('remove', model, this, options); | |
} | |
this._removeReference(model); | |
} | |
return this; | |
}, | |
// Update a collection by `set`-ing a new list of models, adding new ones, | |
// removing models that are no longer present, and merging models that | |
// already exist in the collection, as necessary. Similar to **Model#set**, | |
// the core operation for updating the data contained by the collection. | |
set: function(models, options) { | |
options = _.defaults(options || {}, setOptions); | |
if (options.parse) models = this.parse(models, options); | |
if (!_.isArray(models)) models = models ? [models] : []; | |
var i, l, model, attrs, existing, sort; | |
var at = options.at; | |
var sortable = this.comparator && (at == null) && options.sort !== false; | |
var sortAttr = _.isString(this.comparator) ? this.comparator : null; | |
var toAdd = [], toRemove = [], modelMap = {}; | |
// Turn bare objects into model references, and prevent invalid models | |
// from being added. | |
for (i = 0, l = models.length; i < l; i++) { | |
if (!(model = this._prepareModel(models[i], options))) continue; | |
// If a duplicate is found, prevent it from being added and | |
// optionally merge it into the existing model. | |
if (existing = this.get(model)) { | |
if (options.remove) modelMap[existing.cid] = true; | |
if (options.merge) { | |
existing.set(model.attributes, options); | |
if (sortable && !sort && existing.hasChanged(sortAttr)) sort = true; | |
} | |
// This is a new model, push it to the `toAdd` list. | |
} else if (options.add) { | |
toAdd.push(model); | |
// Listen to added models' events, and index models for lookup by | |
// `id` and by `cid`. | |
model.on('all', this._onModelEvent, this); | |
this._byId[model.cid] = model; | |
if (model.id != null) this._byId[model.id] = model; | |
} | |
} | |
// Remove nonexistent models if appropriate. | |
if (options.remove) { | |
for (i = 0, l = this.length; i < l; ++i) { | |
if (!modelMap[(model = this.models[i]).cid]) toRemove.push(model); | |
} | |
if (toRemove.length) this.remove(toRemove, options); | |
} | |
// See if sorting is needed, update `length` and splice in new models. | |
if (toAdd.length) { | |
if (sortable) sort = true; | |
this.length += toAdd.length; | |
if (at != null) { | |
splice.apply(this.models, [at, 0].concat(toAdd)); | |
} else { | |
push.apply(this.models, toAdd); | |
} | |
} | |
// Silently sort the collection if appropriate. | |
if (sort) this.sort({silent: true}); | |
if (options.silent) return this; | |
// Trigger `add` events. | |
for (i = 0, l = toAdd.length; i < l; i++) { | |
(model = toAdd[i]).trigger('add', model, this, options); | |
} | |
// Trigger `sort` if the collection was sorted. | |
if (sort) this.trigger('sort', this, options); | |
return this; | |
}, | |
// When you have more items than you want to add or remove individually, | |
// you can reset the entire set with a new list of models, without firing | |
// any granular `add` or `remove` events. Fires `reset` when finished. | |
// Useful for bulk operations and optimizations. | |
reset: function(models, options) { | |
options || (options = {}); | |
for (var i = 0, l = this.models.length; i < l; i++) { | |
this._removeReference(this.models[i]); | |
} | |
options.previousModels = this.models; | |
this._reset(); | |
this.add(models, _.extend({silent: true}, options)); | |
if (!options.silent) this.trigger('reset', this, options); | |
return this; | |
}, | |
// Add a model to the end of the collection. | |
push: function(model, options) { | |
model = this._prepareModel(model, options); | |
this.add(model, _.extend({at: this.length}, options)); | |
return model; | |
}, | |
// Remove a model from the end of the collection. | |
pop: function(options) { | |
var model = this.at(this.length - 1); | |
this.remove(model, options); | |
return model; | |
}, | |
// Add a model to the beginning of the collection. | |
unshift: function(model, options) { | |
model = this._prepareModel(model, options); | |
this.add(model, _.extend({at: 0}, options)); | |
return model; | |
}, | |
// Remove a model from the beginning of the collection. | |
shift: function(options) { | |
var model = this.at(0); | |
this.remove(model, options); | |
return model; | |
}, | |
// Slice out a sub-array of models from the collection. | |
slice: function(begin, end) { | |
return this.models.slice(begin, end); | |
}, | |
// Get a model from the set by id. | |
get: function(obj) { | |
if (obj == null) return void 0; | |
return this._byId[obj.id != null ? obj.id : obj.cid || obj]; | |
}, | |
// Get the model at the given index. | |
at: function(index) { | |
return this.models[index]; | |
}, | |
// Return models with matching attributes. Useful for simple cases of | |
// `filter`. | |
where: function(attrs, first) { | |
if (_.isEmpty(attrs)) return first ? void 0 : []; | |
return this[first ? 'find' : 'filter'](function(model) { | |
for (var key in attrs) { | |
if (attrs[key] !== model.get(key)) return false; | |
} | |
return true; | |
}); | |
}, | |
// Return the first model with matching attributes. Useful for simple cases | |
// of `find`. | |
findWhere: function(attrs) { | |
return this.where(attrs, true); | |
}, | |
// Force the collection to re-sort itself. You don't need to call this under | |
// normal circumstances, as the set will maintain sort order as each item | |
// is added. | |
sort: function(options) { | |
if (!this.comparator) throw new Error('Cannot sort a set without a comparator'); | |
options || (options = {}); | |
// Run sort based on type of `comparator`. | |
if (_.isString(this.comparator) || this.comparator.length === 1) { | |
this.models = this.sortBy(this.comparator, this); | |
} else { | |
this.models.sort(_.bind(this.comparator, this)); | |
} | |
if (!options.silent) this.trigger('sort', this, options); | |
return this; | |
}, | |
// Figure out the smallest index at which a model should be inserted so as | |
// to maintain order. | |
sortedIndex: function(model, value, context) { | |
value || (value = this.comparator); | |
var iterator = _.isFunction(value) ? value : function(model) { | |
return model.get(value); | |
}; | |
return _.sortedIndex(this.models, model, iterator, context); | |
}, | |
// Pluck an attribute from each model in the collection. | |
pluck: function(attr) { | |
return _.invoke(this.models, 'get', attr); | |
}, | |
// Fetch the default set of models for this collection, resetting the | |
// collection when they arrive. If `reset: true` is passed, the response | |
// data will be passed through the `reset` method instead of `set`. | |
fetch: function(options) { | |
options = options ? _.clone(options) : {}; | |
if (options.parse === void 0) options.parse = true; | |
var success = options.success; | |
var collection = this; | |
options.success = function(resp) { | |
var method = options.reset ? 'reset' : 'set'; | |
collection[method](resp, options); | |
if (success) success(collection, resp, options); | |
collection.trigger('sync', collection, resp, options); | |
}; | |
wrapError(this, options); | |
return this.sync('read', this, options); | |
}, | |
// Create a new instance of a model in this collection. Add the model to the | |
// collection immediately, unless `wait: true` is passed, in which case we | |
// wait for the server to agree. | |
create: function(model, options) { | |
options = options ? _.clone(options) : {}; | |
if (!(model = this._prepareModel(model, options))) return false; | |
if (!options.wait) this.add(model, options); | |
var collection = this; | |
var success = options.success; | |
options.success = function(resp) { | |
if (options.wait) collection.add(model, options); | |
if (success) success(model, resp, options); | |
}; | |
model.save(null, options); | |
return model; | |
}, | |
// **parse** converts a response into a list of models to be added to the | |
// collection. The default implementation is just to pass it through. | |
parse: function(resp, options) { | |
return resp; | |
}, | |
// Create a new collection with an identical list of models as this one. | |
clone: function() { | |
return new this.constructor(this.models); | |
}, | |
// Private method to reset all internal state. Called when the collection | |
// is first initialized or reset. | |
_reset: function() { | |
this.length = 0; | |
this.models = []; | |
this._byId = {}; | |
}, | |
// Prepare a hash of attributes (or other model) to be added to this | |
// collection. | |
_prepareModel: function(attrs, options) { | |
if (attrs instanceof Model) { | |
if (!attrs.collection) attrs.collection = this; | |
return attrs; | |
} | |
options || (options = {}); | |
options.collection = this; | |
var model = new this.model(attrs, options); | |
if (!model._validate(attrs, options)) { | |
this.trigger('invalid', this, attrs, options); | |
return false; | |
} | |
return model; | |
}, | |
// Internal method to sever a model's ties to a collection. | |
_removeReference: function(model) { | |
if (this === model.collection) delete model.collection; | |
model.off('all', this._onModelEvent, this); | |
}, | |
// Internal method called every time a model in the set fires an event. | |
// Sets need to update their indexes when models change ids. All other | |
// events simply proxy through. "add" and "remove" events that originate | |
// in other collections are ignored. | |
_onModelEvent: function(event, model, collection, options) { | |
if ((event === 'add' || event === 'remove') && collection !== this) return; | |
if (event === 'destroy') this.remove(model, options); | |
if (model && event === 'change:' + model.idAttribute) { | |
delete this._byId[model.previous(model.idAttribute)]; | |
if (model.id != null) this._byId[model.id] = model; | |
} | |
this.trigger.apply(this, arguments); | |
} | |
}); | |
// Underscore methods that we want to implement on the Collection. | |
// 90% of the core usefulness of Backbone Collections is actually implemented | |
// right here: | |
var methods = ['forEach', 'each', 'map', 'collect', 'reduce', 'foldl', | |
'inject', 'reduceRight', 'foldr', 'find', 'detect', 'filter', 'select', | |
'reject', 'every', 'all', 'some', 'any', 'include', 'contains', 'invoke', | |
'max', 'min', 'toArray', 'size', 'first', 'head', 'take', 'initial', 'rest', | |
'tail', 'drop', 'last', 'without', 'indexOf', 'shuffle', 'lastIndexOf', | |
'isEmpty', 'chain']; | |
// Mix in each Underscore method as a proxy to `Collection#models`. | |
_.each(methods, function(method) { | |
Collection.prototype[method] = function() { | |
var args = slice.call(arguments); | |
args.unshift(this.models); | |
return _[method].apply(_, args); | |
}; | |
}); | |
// Underscore methods that take a property name as an argument. | |
var attributeMethods = ['groupBy', 'countBy', 'sortBy']; | |
// Use attributes instead of properties. | |
_.each(attributeMethods, function(method) { | |
Collection.prototype[method] = function(value, context) { | |
var iterator = _.isFunction(value) ? value : function(model) { | |
return model.get(value); | |
}; | |
return _[method](this.models, iterator, context); | |
}; | |
}); | |
// Backbone.View | |
// ------------- | |
// Backbone Views are almost more convention than they are actual code. A View | |
// is simply a JavaScript object that represents a logical chunk of UI in the | |
// DOM. This might be a single item, an entire list, a sidebar or panel, or | |
// even the surrounding frame which wraps your whole app. Defining a chunk of | |
// UI as a **View** allows you to define your DOM events declaratively, without | |
// having to worry about render order ... and makes it easy for the view to | |
// react to specific changes in the state of your models. | |
// Creating a Backbone.View creates its initial element outside of the DOM, | |
// if an existing element is not provided... | |
var View = Backbone.View = function(options) { | |
this.cid = _.uniqueId('view'); | |
this._configure(options || {}); | |
this._ensureElement(); | |
this.initialize.apply(this, arguments); | |
this.delegateEvents(); | |
}; | |
// Cached regex to split keys for `delegate`. | |
var delegateEventSplitter = /^(\S+)\s*(.*)$/; | |
// List of view options to be merged as properties. | |
var viewOptions = ['model', 'collection', 'el', 'id', 'attributes', 'className', 'tagName', 'events']; | |
// Set up all inheritable **Backbone.View** properties and methods. | |
_.extend(View.prototype, Events, { | |
// The default `tagName` of a View's element is `"div"`. | |
tagName: 'div', | |
// jQuery delegate for element lookup, scoped to DOM elements within the | |
// current view. This should be prefered to global lookups where possible. | |
$: function(selector) { | |
return this.$el.find(selector); | |
}, | |
// Initialize is an empty function by default. Override it with your own | |
// initialization logic. | |
initialize: function(){}, | |
// **render** is the core function that your view should override, in order | |
// to populate its element (`this.el`), with the appropriate HTML. The | |
// convention is for **render** to always return `this`. | |
render: function() { | |
return this; | |
}, | |
// Remove this view by taking the element out of the DOM, and removing any | |
// applicable Backbone.Events listeners. | |
remove: function() { | |
this.$el.remove(); | |
this.stopListening(); | |
return this; | |
}, | |
// Change the view's element (`this.el` property), including event | |
// re-delegation. | |
setElement: function(element, delegate) { | |
if (this.$el) this.undelegateEvents(); | |
this.$el = element instanceof Backbone.$ ? element : Backbone.$(element); | |
this.el = this.$el[0]; | |
if (delegate !== false) this.delegateEvents(); | |
return this; | |
}, | |
// Set callbacks, where `this.events` is a hash of | |
// | |
// *{"event selector": "callback"}* | |
// | |
// { | |
// 'mousedown .title': 'edit', | |
// 'click .button': 'save' | |
// 'click .open': function(e) { ... } | |
// } | |
// | |
// pairs. Callbacks will be bound to the view, with `this` set properly. | |
// Uses event delegation for efficiency. | |
// Omitting the selector binds the event to `this.el`. | |
// This only works for delegate-able events: not `focus`, `blur`, and | |
// not `change`, `submit`, and `reset` in Internet Explorer. | |
delegateEvents: function(events) { | |
if (!(events || (events = _.result(this, 'events')))) return this; | |
this.undelegateEvents(); | |
for (var key in events) { | |
var method = events[key]; | |
if (!_.isFunction(method)) method = this[events[key]]; | |
if (!method) continue; | |
var match = key.match(delegateEventSplitter); | |
var eventName = match[1], selector = match[2]; | |
method = _.bind(method, this); | |
eventName += '.delegateEvents' + this.cid; | |
if (selector === '') { | |
this.$el.on(eventName, method); | |
} else { | |
this.$el.on(eventName, selector, method); | |
} | |
} | |
return this; | |
}, | |
// Clears all callbacks previously bound to the view with `delegateEvents`. | |
// You usually don't need to use this, but may wish to if you have multiple | |
// Backbone views attached to the same DOM element. | |
undelegateEvents: function() { | |
this.$el.off('.delegateEvents' + this.cid); | |
return this; | |
}, | |
// Performs the initial configuration of a View with a set of options. | |
// Keys with special meaning *(e.g. model, collection, id, className)* are | |
// attached directly to the view. See `viewOptions` for an exhaustive | |
// list. | |
_configure: function(options) { | |
if (this.options) options = _.extend({}, _.result(this, 'options'), options); | |
_.extend(this, _.pick(options, viewOptions)); | |
this.options = options; | |
}, | |
// Ensure that the View has a DOM element to render into. | |
// If `this.el` is a string, pass it through `$()`, take the first | |
// matching element, and re-assign it to `el`. Otherwise, create | |
// an element from the `id`, `className` and `tagName` properties. | |
_ensureElement: function() { | |
if (!this.el) { | |
var attrs = _.extend({}, _.result(this, 'attributes')); | |
if (this.id) attrs.id = _.result(this, 'id'); | |
if (this.className) attrs['class'] = _.result(this, 'className'); | |
var $el = Backbone.$('<' + _.result(this, 'tagName') + '>').attr(attrs); | |
this.setElement($el, false); | |
} else { | |
this.setElement(_.result(this, 'el'), false); | |
} | |
} | |
}); | |
// Backbone.sync | |
// ------------- | |
// Override this function to change the manner in which Backbone persists | |
// models to the server. You will be passed the type of request, and the | |
// model in question. By default, makes a RESTful Ajax request | |
// to the model's `url()`. Some possible customizations could be: | |
// | |
// * Use `setTimeout` to batch rapid-fire updates into a single request. | |
// * Send up the models as XML instead of JSON. | |
// * Persist models via WebSockets instead of Ajax. | |
// | |
// Turn on `Backbone.emulateHTTP` in order to send `PUT` and `DELETE` requests | |
// as `POST`, with a `_method` parameter containing the true HTTP method, | |
// as well as all requests with the body as `application/x-www-form-urlencoded` | |
// instead of `application/json` with the model in a param named `model`. | |
// Useful when interfacing with server-side languages like **PHP** that make | |
// it difficult to read the body of `PUT` requests. | |
Backbone.sync = function(method, model, options) { | |
var type = methodMap[method]; | |
// Default options, unless specified. | |
_.defaults(options || (options = {}), { | |
emulateHTTP: Backbone.emulateHTTP, | |
emulateJSON: Backbone.emulateJSON | |
}); | |
// Default JSON-request options. | |
var params = {type: type, dataType: 'json'}; | |
// Ensure that we have a URL. | |
if (!options.url) { | |
params.url = _.result(model, 'url') || urlError(); | |
} | |
// Ensure that we have the appropriate request data. | |
if (options.data == null && model && (method === 'create' || method === 'update' || method === 'patch')) { | |
params.contentType = 'application/json'; | |
params.data = JSON.stringify(options.attrs || model.toJSON(options)); | |
} | |
// For older servers, emulate JSON by encoding the request into an HTML-form. | |
if (options.emulateJSON) { | |
params.contentType = 'application/x-www-form-urlencoded'; | |
params.data = params.data ? {model: params.data} : {}; | |
} | |
// For older servers, emulate HTTP by mimicking the HTTP method with `_method` | |
// And an `X-HTTP-Method-Override` header. | |
if (options.emulateHTTP && (type === 'PUT' || type === 'DELETE' || type === 'PATCH')) { | |
params.type = 'POST'; | |
if (options.emulateJSON) params.data._method = type; | |
var beforeSend = options.beforeSend; | |
options.beforeSend = function(xhr) { | |
xhr.setRequestHeader('X-HTTP-Method-Override', type); | |
if (beforeSend) return beforeSend.apply(this, arguments); | |
}; | |
} | |
// Don't process data on a non-GET request. | |
if (params.type !== 'GET' && !options.emulateJSON) { | |
params.processData = false; | |
} | |
// If we're sending a `PATCH` request, and we're in an old Internet Explorer | |
// that still has ActiveX enabled by default, override jQuery to use that | |
// for XHR instead. Remove this line when jQuery supports `PATCH` on IE8. | |
if (params.type === 'PATCH' && window.ActiveXObject && | |
!(window.external && window.external.msActiveXFilteringEnabled)) { | |
params.xhr = function() { | |
return new ActiveXObject("Microsoft.XMLHTTP"); | |
}; | |
} | |
// Make the request, allowing the user to override any Ajax options. | |
var xhr = options.xhr = Backbone.ajax(_.extend(params, options)); | |
model.trigger('request', model, xhr, options); | |
return xhr; | |
}; | |
// Map from CRUD to HTTP for our default `Backbone.sync` implementation. | |
var methodMap = { | |
'create': 'POST', | |
'update': 'PUT', | |
'patch': 'PATCH', | |
'delete': 'DELETE', | |
'read': 'GET' | |
}; | |
// Set the default implementation of `Backbone.ajax` to proxy through to `$`. | |
// Override this if you'd like to use a different library. | |
Backbone.ajax = function() { | |
return Backbone.$.ajax.apply(Backbone.$, arguments); | |
}; | |
// Backbone.Router | |
// --------------- | |
// Routers map faux-URLs to actions, and fire events when routes are | |
// matched. Creating a new one sets its `routes` hash, if not set statically. | |
var Router = Backbone.Router = function(options) { | |
options || (options = {}); | |
if (options.routes) this.routes = options.routes; | |
this._bindRoutes(); | |
this.initialize.apply(this, arguments); | |
}; | |
// Cached regular expressions for matching named param parts and splatted | |
// parts of route strings. | |
var optionalParam = /\((.*?)\)/g; | |
var namedParam = /(\(\?)?:\w+/g; | |
var splatParam = /\*\w+/g; | |
var escapeRegExp = /[\-{}\[\]+?.,\\\^$|#\s]/g; | |
// Set up all inheritable **Backbone.Router** properties and methods. | |
_.extend(Router.prototype, Events, { | |
// Initialize is an empty function by default. Override it with your own | |
// initialization logic. | |
initialize: function(){}, | |
// Manually bind a single named route to a callback. For example: | |
// | |
// this.route('search/:query/p:num', 'search', function(query, num) { | |
// ... | |
// }); | |
// | |
route: function(route, name, callback) { | |
if (!_.isRegExp(route)) route = this._routeToRegExp(route); | |
if (_.isFunction(name)) { | |
callback = name; | |
name = ''; | |
} | |
if (!callback) callback = this[name]; | |
var router = this; | |
Backbone.history.route(route, function(fragment) { | |
var args = router._extractParameters(route, fragment); | |
callback && callback.apply(router, args); | |
router.trigger.apply(router, ['route:' + name].concat(args)); | |
router.trigger('route', name, args); | |
Backbone.history.trigger('route', router, name, args); | |
}); | |
return this; | |
}, | |
// Simple proxy to `Backbone.history` to save a fragment into the history. | |
navigate: function(fragment, options) { | |
Backbone.history.navigate(fragment, options); | |
return this; | |
}, | |
// Bind all defined routes to `Backbone.history`. We have to reverse the | |
// order of the routes here to support behavior where the most general | |
// routes can be defined at the bottom of the route map. | |
_bindRoutes: function() { | |
if (!this.routes) return; | |
this.routes = _.result(this, 'routes'); | |
var route, routes = _.keys(this.routes); | |
while ((route = routes.pop()) != null) { | |
this.route(route, this.routes[route]); | |
} | |
}, | |
// Convert a route string into a regular expression, suitable for matching | |
// against the current location hash. | |
_routeToRegExp: function(route) { | |
route = route.replace(escapeRegExp, '\\$&') | |
.replace(optionalParam, '(?:$1)?') | |
.replace(namedParam, function(match, optional){ | |
return optional ? match : '([^\/]+)'; | |
}) | |
.replace(splatParam, '(.*?)'); | |
return new RegExp('^' + route + '$'); | |
}, | |
// Given a route, and a URL fragment that it matches, return the array of | |
// extracted decoded parameters. Empty or unmatched parameters will be | |
// treated as `null` to normalize cross-browser behavior. | |
_extractParameters: function(route, fragment) { | |
var params = route.exec(fragment).slice(1); | |
return _.map(params, function(param) { | |
return param ? decodeURIComponent(param) : null; | |
}); | |
} | |
}); | |
// Backbone.History | |
// ---------------- | |
// Handles cross-browser history management, based on either | |
// [pushState](http://diveintohtml5.info/history.html) and real URLs, or | |
// [onhashchange](https://developer.mozilla.org/en-US/docs/DOM/window.onhashchange) | |
// and URL fragments. If the browser supports neither (old IE, natch), | |
// falls back to polling. | |
var History = Backbone.History = function() { | |
this.handlers = []; | |
_.bindAll(this, 'checkUrl'); | |
// Ensure that `History` can be used outside of the browser. | |
if (typeof window !== 'undefined') { | |
this.location = window.location; | |
this.history = window.history; | |
} | |
}; | |
// Cached regex for stripping a leading hash/slash and trailing space. | |
var routeStripper = /^[#\/]|\s+$/g; | |
// Cached regex for stripping leading and trailing slashes. | |
var rootStripper = /^\/+|\/+$/g; | |
// Cached regex for detecting MSIE. | |
var isExplorer = /msie [\w.]+/; | |
// Cached regex for removing a trailing slash. | |
var trailingSlash = /\/$/; | |
// Has the history handling already been started? | |
History.started = false; | |
// Set up all inheritable **Backbone.History** properties and methods. | |
_.extend(History.prototype, Events, { | |
// The default interval to poll for hash changes, if necessary, is | |
// twenty times a second. | |
interval: 50, | |
// Gets the true hash value. Cannot use location.hash directly due to bug | |
// in Firefox where location.hash will always be decoded. | |
getHash: function(window) { | |
var match = (window || this).location.href.match(/#(.*)$/); | |
return match ? match[1] : ''; | |
}, | |
// Get the cross-browser normalized URL fragment, either from the URL, | |
// the hash, or the override. | |
getFragment: function(fragment, forcePushState) { | |
if (fragment == null) { | |
if (this._hasPushState || !this._wantsHashChange || forcePushState) { | |
fragment = this.location.pathname; | |
var root = this.root.replace(trailingSlash, ''); | |
if (!fragment.indexOf(root)) fragment = fragment.substr(root.length); | |
} else { | |
fragment = this.getHash(); | |
} | |
} | |
return fragment.replace(routeStripper, ''); | |
}, | |
// Start the hash change handling, returning `true` if the current URL matches | |
// an existing route, and `false` otherwise. | |
start: function(options) { | |
if (History.started) throw new Error("Backbone.history has already been started"); | |
History.started = true; | |
// Figure out the initial configuration. Do we need an iframe? | |
// Is pushState desired ... is it available? | |
this.options = _.extend({}, {root: '/'}, this.options, options); | |
this.root = this.options.root; | |
this._wantsHashChange = this.options.hashChange !== false; | |
this._wantsPushState = !!this.options.pushState; | |
this._hasPushState = !!(this.options.pushState && this.history && this.history.pushState); | |
var fragment = this.getFragment(); | |
var docMode = document.documentMode; | |
var oldIE = (isExplorer.exec(navigator.userAgent.toLowerCase()) && (!docMode || docMode <= 7)); | |
// Normalize root to always include a leading and trailing slash. | |
this.root = ('/' + this.root + '/').replace(rootStripper, '/'); | |
if (oldIE && this._wantsHashChange) { | |
this.iframe = Backbone.$('<iframe src="javascript:0" tabindex="-1" />').hide().appendTo('body')[0].contentWindow; | |
this.navigate(fragment); | |
} | |
// Depending on whether we're using pushState or hashes, and whether | |
// 'onhashchange' is supported, determine how we check the URL state. | |
if (this._hasPushState) { | |
Backbone.$(window).on('popstate', this.checkUrl); | |
} else if (this._wantsHashChange && ('onhashchange' in window) && !oldIE) { | |
Backbone.$(window).on('hashchange', this.checkUrl); | |
} else if (this._wantsHashChange) { | |
this._checkUrlInterval = setInterval(this.checkUrl, this.interval); | |
} | |
// Determine if we need to change the base url, for a pushState link | |
// opened by a non-pushState browser. | |
this.fragment = fragment; | |
var loc = this.location; | |
var atRoot = loc.pathname.replace(/[^\/]$/, '$&/') === this.root; | |
// If we've started off with a route from a `pushState`-enabled browser, | |
// but we're currently in a browser that doesn't support it... | |
if (this._wantsHashChange && this._wantsPushState && !this._hasPushState && !atRoot) { | |
this.fragment = this.getFragment(null, true); | |
this.location.replace(this.root + this.location.search + '#' + this.fragment); | |
// Return immediately as browser will do redirect to new url | |
return true; | |
// Or if we've started out with a hash-based route, but we're currently | |
// in a browser where it could be `pushState`-based instead... | |
} else if (this._wantsPushState && this._hasPushState && atRoot && loc.hash) { | |
this.fragment = this.getHash().replace(routeStripper, ''); | |
this.history.replaceState({}, document.title, this.root + this.fragment + loc.search); | |
} | |
if (!this.options.silent) return this.loadUrl(); | |
}, | |
// Disable Backbone.history, perhaps temporarily. Not useful in a real app, | |
// but possibly useful for unit testing Routers. | |
stop: function() { | |
Backbone.$(window).off('popstate', this.checkUrl).off('hashchange', this.checkUrl); | |
clearInterval(this._checkUrlInterval); | |
History.started = false; | |
}, | |
// Add a route to be tested when the fragment changes. Routes added later | |
// may override previous routes. | |
route: function(route, callback) { | |
this.handlers.unshift({route: route, callback: callback}); | |
}, | |
// Checks the current URL to see if it has changed, and if it has, | |
// calls `loadUrl`, normalizing across the hidden iframe. | |
checkUrl: function(e) { | |
var current = this.getFragment(); | |
if (current === this.fragment && this.iframe) { | |
current = this.getFragment(this.getHash(this.iframe)); | |
} | |
if (current === this.fragment) return false; | |
if (this.iframe) this.navigate(current); | |
this.loadUrl() || this.loadUrl(this.getHash()); | |
}, | |
// Attempt to load the current URL fragment. If a route succeeds with a | |
// match, returns `true`. If no defined routes matches the fragment, | |
// returns `false`. | |
loadUrl: function(fragmentOverride) { | |
var fragment = this.fragment = this.getFragment(fragmentOverride); | |
var matched = _.any(this.handlers, function(handler) { | |
if (handler.route.test(fragment)) { | |
handler.callback(fragment); | |
return true; | |
} | |
}); | |
return matched; | |
}, | |
// Save a fragment into the hash history, or replace the URL state if the | |
// 'replace' option is passed. You are responsible for properly URL-encoding | |
// the fragment in advance. | |
// | |
// The options object can contain `trigger: true` if you wish to have the | |
// route callback be fired (not usually desirable), or `replace: true`, if | |
// you wish to modify the current URL without adding an entry to the history. | |
navigate: function(fragment, options) { | |
if (!History.started) return false; | |
if (!options || options === true) options = {trigger: options}; | |
fragment = this.getFragment(fragment || ''); | |
if (this.fragment === fragment) return; | |
this.fragment = fragment; | |
var url = this.root + fragment; | |
// If pushState is available, we use it to set the fragment as a real URL. | |
if (this._hasPushState) { | |
this.history[options.replace ? 'replaceState' : 'pushState']({}, document.title, url); | |
// If hash changes haven't been explicitly disabled, update the hash | |
// fragment to store history. | |
} else if (this._wantsHashChange) { | |
this._updateHash(this.location, fragment, options.replace); | |
if (this.iframe && (fragment !== this.getFragment(this.getHash(this.iframe)))) { | |
// Opening and closing the iframe tricks IE7 and earlier to push a | |
// history entry on hash-tag change. When replace is true, we don't | |
// want this. | |
if(!options.replace) this.iframe.document.open().close(); | |
this._updateHash(this.iframe.location, fragment, options.replace); | |
} | |
// If you've told us that you explicitly don't want fallback hashchange- | |
// based history, then `navigate` becomes a page refresh. | |
} else { | |
return this.location.assign(url); | |
} | |
if (options.trigger) this.loadUrl(fragment); | |
}, | |
// Update the hash location, either replacing the current entry, or adding | |
// a new one to the browser history. | |
_updateHash: function(location, fragment, replace) { | |
if (replace) { | |
var href = location.href.replace(/(javascript:|#).*$/, ''); | |
location.replace(href + '#' + fragment); | |
} else { | |
// Some browsers require that `hash` contains a leading #. | |
location.hash = '#' + fragment; | |
} | |
} | |
}); | |
// Create the default Backbone.history. | |
Backbone.history = new History; | |
// Helpers | |
// ------- | |
// Helper function to correctly set up the prototype chain, for subclasses. | |
// Similar to `goog.inherits`, but uses a hash of prototype properties and | |
// class properties to be extended. | |
var extend = function(protoProps, staticProps) { | |
var parent = this; | |
var child; | |
// The constructor function for the new subclass is either defined by you | |
// (the "constructor" property in your `extend` definition), or defaulted | |
// by us to simply call the parent's constructor. | |
if (protoProps && _.has(protoProps, 'constructor')) { | |
child = protoProps.constructor; | |
} else { | |
child = function(){ return parent.apply(this, arguments); }; | |
} | |
// Add static properties to the constructor function, if supplied. | |
_.extend(child, parent, staticProps); | |
// Set the prototype chain to inherit from `parent`, without calling | |
// `parent`'s constructor function. | |
var Surrogate = function(){ this.constructor = child; }; | |
Surrogate.prototype = parent.prototype; | |
child.prototype = new Surrogate; | |
// Add prototype properties (instance properties) to the subclass, | |
// if supplied. | |
if (protoProps) _.extend(child.prototype, protoProps); | |
// Set a convenience property in case the parent's prototype is needed | |
// later. | |
child.__super__ = parent.prototype; | |
return child; | |
}; | |
// Set up inheritance for the model, collection, router, view and history. | |
Model.extend = Collection.extend = Router.extend = View.extend = History.extend = extend; | |
// Throw an error when a URL is needed, and none is supplied. | |
var urlError = function() { | |
throw new Error('A "url" property or function must be specified'); | |
}; | |
// Wrap an optional error callback with a fallback error event. | |
var wrapError = function (model, options) { | |
var error = options.error; | |
options.error = function(resp) { | |
if (error) error(model, resp, options); | |
model.trigger('error', model, resp, options); | |
}; | |
}; | |
}).call(this); |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
/*! | |
* jQuery JavaScript Library v2.0.3 | |
* http://jquery.com/ | |
* | |
* Includes Sizzle.js | |
* http://sizzlejs.com/ | |
* | |
* Copyright 2005, 2013 jQuery Foundation, Inc. and other contributors | |
* Released under the MIT license | |
* http://jquery.org/license | |
* | |
* Date: 2013-07-03T13:30Z | |
*/ | |
(function( window, undefined ) { | |
// Can't do this because several apps including ASP.NET trace | |
// the stack via arguments.caller.callee and Firefox dies if | |
// you try to trace through "use strict" call chains. (#13335) | |
// Support: Firefox 18+ | |
//"use strict"; | |
var | |
// A central reference to the root jQuery(document) | |
rootjQuery, | |
// The deferred used on DOM ready | |
readyList, | |
// Support: IE9 | |
// For `typeof xmlNode.method` instead of `xmlNode.method !== undefined` | |
core_strundefined = typeof undefined, | |
// Use the correct document accordingly with window argument (sandbox) | |
location = window.location, | |
document = window.document, | |
docElem = document.documentElement, | |
// Map over jQuery in case of overwrite | |
_jQuery = window.jQuery, | |
// Map over the $ in case of overwrite | |
_$ = window.$, | |
// [[Class]] -> type pairs | |
class2type = {}, | |
// List of deleted data cache ids, so we can reuse them | |
core_deletedIds = [], | |
core_version = "2.0.3", | |
// Save a reference to some core methods | |
core_concat = core_deletedIds.concat, | |
core_push = core_deletedIds.push, | |
core_slice = core_deletedIds.slice, | |
core_indexOf = core_deletedIds.indexOf, | |
core_toString = class2type.toString, | |
core_hasOwn = class2type.hasOwnProperty, | |
core_trim = core_version.trim, | |
// Define a local copy of jQuery | |
jQuery = function( selector, context ) { | |
// The jQuery object is actually just the init constructor 'enhanced' | |
return new jQuery.fn.init( selector, context, rootjQuery ); | |
}, | |
// Used for matching numbers | |
core_pnum = /[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/.source, | |
// Used for splitting on whitespace | |
core_rnotwhite = /\S+/g, | |
// A simple way to check for HTML strings | |
// Prioritize #id over <tag> to avoid XSS via location.hash (#9521) | |
// Strict HTML recognition (#11290: must start with <) | |
rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]*))$/, | |
// Match a standalone tag | |
rsingleTag = /^<(\w+)\s*\/?>(?:<\/\1>|)$/, | |
// Matches dashed string for camelizing | |
rmsPrefix = /^-ms-/, | |
rdashAlpha = /-([\da-z])/gi, | |
// Used by jQuery.camelCase as callback to replace() | |
fcamelCase = function( all, letter ) { | |
return letter.toUpperCase(); | |
}, | |
// The ready event handler and self cleanup method | |
completed = function() { | |
document.removeEventListener( "DOMContentLoaded", completed, false ); | |
window.removeEventListener( "load", completed, false ); | |
jQuery.ready(); | |
}; | |
jQuery.fn = jQuery.prototype = { | |
// The current version of jQuery being used | |
jquery: core_version, | |
constructor: jQuery, | |
init: function( selector, context, rootjQuery ) { | |
var match, elem; | |
// HANDLE: $(""), $(null), $(undefined), $(false) | |
if ( !selector ) { | |
return this; | |
} | |
// Handle HTML strings | |
if ( typeof selector === "string" ) { | |
if ( selector.charAt(0) === "<" && selector.charAt( selector.length - 1 ) === ">" && selector.length >= 3 ) { | |
// Assume that strings that start and end with <> are HTML and skip the regex check | |
match = [ null, selector, null ]; | |
} else { | |
match = rquickExpr.exec( selector ); | |
} | |
// Match html or make sure no context is specified for #id | |
if ( match && (match[1] || !context) ) { | |
// HANDLE: $(html) -> $(array) | |
if ( match[1] ) { | |
context = context instanceof jQuery ? context[0] : context; | |
// scripts is true for back-compat | |
jQuery.merge( this, jQuery.parseHTML( | |
match[1], | |
context && context.nodeType ? context.ownerDocument || context : document, | |
true | |
) ); | |
// HANDLE: $(html, props) | |
if ( rsingleTag.test( match[1] ) && jQuery.isPlainObject( context ) ) { | |
for ( match in context ) { | |
// Properties of context are called as methods if possible | |
if ( jQuery.isFunction( this[ match ] ) ) { | |
this[ match ]( context[ match ] ); | |
// ...and otherwise set as attributes | |
} else { | |
this.attr( match, context[ match ] ); | |
} | |
} | |
} | |
return this; | |
// HANDLE: $(#id) | |
} else { | |
elem = document.getElementById( match[2] ); | |
// Check parentNode to catch when Blackberry 4.6 returns | |
// nodes that are no longer in the document #6963 | |
if ( elem && elem.parentNode ) { | |
// Inject the element directly into the jQuery object | |
this.length = 1; | |
this[0] = elem; | |
} | |
this.context = document; | |
this.selector = selector; | |
return this; | |
} | |
// HANDLE: $(expr, $(...)) | |
} else if ( !context || context.jquery ) { | |
return ( context || rootjQuery ).find( selector ); | |
// HANDLE: $(expr, context) | |
// (which is just equivalent to: $(context).find(expr) | |
} else { | |
return this.constructor( context ).find( selector ); | |
} | |
// HANDLE: $(DOMElement) | |
} else if ( selector.nodeType ) { | |
this.context = this[0] = selector; | |
this.length = 1; | |
return this; | |
// HANDLE: $(function) | |
// Shortcut for document ready | |
} else if ( jQuery.isFunction( selector ) ) { | |
return rootjQuery.ready( selector ); | |
} | |
if ( selector.selector !== undefined ) { | |
this.selector = selector.selector; | |
this.context = selector.context; | |
} | |
return jQuery.makeArray( selector, this ); | |
}, | |
// Start with an empty selector | |
selector: "", | |
// The default length of a jQuery object is 0 | |
length: 0, | |
toArray: function() { | |
return core_slice.call( this ); | |
}, | |
// Get the Nth element in the matched element set OR | |
// Get the whole matched element set as a clean array | |
get: function( num ) { | |
return num == null ? | |
// Return a 'clean' array | |
this.toArray() : | |
// Return just the object | |
( num < 0 ? this[ this.length + num ] : this[ num ] ); | |
}, | |
// Take an array of elements and push it onto the stack | |
// (returning the new matched element set) | |
pushStack: function( elems ) { | |
// Build a new jQuery matched element set | |
var ret = jQuery.merge( this.constructor(), elems ); | |
// Add the old object onto the stack (as a reference) | |
ret.prevObject = this; | |
ret.context = this.context; | |
// Return the newly-formed element set | |
return ret; | |
}, | |
// Execute a callback for every element in the matched set. | |
// (You can seed the arguments with an array of args, but this is | |
// only used internally.) | |
each: function( callback, args ) { | |
return jQuery.each( this, callback, args ); | |
}, | |
ready: function( fn ) { | |
// Add the callback | |
jQuery.ready.promise().done( fn ); | |
return this; | |
}, | |
slice: function() { | |
return this.pushStack( core_slice.apply( this, arguments ) ); | |
}, | |
first: function() { | |
return this.eq( 0 ); | |
}, | |
last: function() { | |
return this.eq( -1 ); | |
}, | |
eq: function( i ) { | |
var len = this.length, | |
j = +i + ( i < 0 ? len : 0 ); | |
return this.pushStack( j >= 0 && j < len ? [ this[j] ] : [] ); | |
}, | |
map: function( callback ) { | |
return this.pushStack( jQuery.map(this, function( elem, i ) { | |
return callback.call( elem, i, elem ); | |
})); | |
}, | |
end: function() { | |
return this.prevObject || this.constructor(null); | |
}, | |
// For internal use only. | |
// Behaves like an Array's method, not like a jQuery method. | |
push: core_push, | |
sort: [].sort, | |
splice: [].splice | |
}; | |
// Give the init function the jQuery prototype for later instantiation | |
jQuery.fn.init.prototype = jQuery.fn; | |
jQuery.extend = jQuery.fn.extend = function() { | |
var options, name, src, copy, copyIsArray, clone, | |
target = arguments[0] || {}, | |
i = 1, | |
length = arguments.length, | |
deep = false; | |
// Handle a deep copy situation | |
if ( typeof target === "boolean" ) { | |
deep = target; | |
target = arguments[1] || {}; | |
// skip the boolean and the target | |
i = 2; | |
} | |
// Handle case when target is a string or something (possible in deep copy) | |
if ( typeof target !== "object" && !jQuery.isFunction(target) ) { | |
target = {}; | |
} | |
// extend jQuery itself if only one argument is passed | |
if ( length === i ) { | |
target = this; | |
--i; | |
} | |
for ( ; i < length; i++ ) { | |
// Only deal with non-null/undefined values | |
if ( (options = arguments[ i ]) != null ) { | |
// Extend the base object | |
for ( name in options ) { | |
src = target[ name ]; | |
copy = options[ name ]; | |
// Prevent never-ending loop | |
if ( target === copy ) { | |
continue; | |
} | |
// Recurse if we're merging plain objects or arrays | |
if ( deep && copy && ( jQuery.isPlainObject(copy) || (copyIsArray = jQuery.isArray(copy)) ) ) { | |
if ( copyIsArray ) { | |
copyIsArray = false; | |
clone = src && jQuery.isArray(src) ? src : []; | |
} else { | |
clone = src && jQuery.isPlainObject(src) ? src : {}; | |
} | |
// Never move original objects, clone them | |
target[ name ] = jQuery.extend( deep, clone, copy ); | |
// Don't bring in undefined values | |
} else if ( copy !== undefined ) { | |
target[ name ] = copy; | |
} | |
} | |
} | |
} | |
// Return the modified object | |
return target; | |
}; | |
jQuery.extend({ | |
// Unique for each copy of jQuery on the page | |
expando: "jQuery" + ( core_version + Math.random() ).replace( /\D/g, "" ), | |
noConflict: function( deep ) { | |
if ( window.$ === jQuery ) { | |
window.$ = _$; | |
} | |
if ( deep && window.jQuery === jQuery ) { | |
window.jQuery = _jQuery; | |
} | |
return jQuery; | |
}, | |
// Is the DOM ready to be used? Set to true once it occurs. | |
isReady: false, | |
// A counter to track how many items to wait for before | |
// the ready event fires. See #6781 | |
readyWait: 1, | |
// Hold (or release) the ready event | |
holdReady: function( hold ) { | |
if ( hold ) { | |
jQuery.readyWait++; | |
} else { | |
jQuery.ready( true ); | |
} | |
}, | |
// Handle when the DOM is ready | |
ready: function( wait ) { | |
// Abort if there are pending holds or we're already ready | |
if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) { | |
return; | |
} | |
// Remember that the DOM is ready | |
jQuery.isReady = true; | |
// If a normal DOM Ready event fired, decrement, and wait if need be | |
if ( wait !== true && --jQuery.readyWait > 0 ) { | |
return; | |
} | |
// If there are functions bound, to execute | |
readyList.resolveWith( document, [ jQuery ] ); | |
// Trigger any bound ready events | |
if ( jQuery.fn.trigger ) { | |
jQuery( document ).trigger("ready").off("ready"); | |
} | |
}, | |
// See test/unit/core.js for details concerning isFunction. | |
// Since version 1.3, DOM methods and functions like alert | |
// aren't supported. They return false on IE (#2968). | |
isFunction: function( obj ) { | |
return jQuery.type(obj) === "function"; | |
}, | |
isArray: Array.isArray, | |
isWindow: function( obj ) { | |
return obj != null && obj === obj.window; | |
}, | |
isNumeric: function( obj ) { | |
return !isNaN( parseFloat(obj) ) && isFinite( obj ); | |
}, | |
type: function( obj ) { | |
if ( obj == null ) { | |
return String( obj ); | |
} | |
// Support: Safari <= 5.1 (functionish RegExp) | |
return typeof obj === "object" || typeof obj === "function" ? | |
class2type[ core_toString.call(obj) ] || "object" : | |
typeof obj; | |
}, | |
isPlainObject: function( obj ) { | |
// Not plain objects: | |
// - Any object or value whose internal [[Class]] property is not "[object Object]" | |
// - DOM nodes | |
// - window | |
if ( jQuery.type( obj ) !== "object" || obj.nodeType || jQuery.isWindow( obj ) ) { | |
return false; | |
} | |
// Support: Firefox <20 | |
// The try/catch suppresses exceptions thrown when attempting to access | |
// the "constructor" property of certain host objects, ie. |window.location| | |
// https://bugzilla.mozilla.org/show_bug.cgi?id=814622 | |
try { | |
if ( obj.constructor && | |
!core_hasOwn.call( obj.constructor.prototype, "isPrototypeOf" ) ) { | |
return false; | |
} | |
} catch ( e ) { | |
return false; | |
} | |
// If the function hasn't returned already, we're confident that | |
// |obj| is a plain object, created by {} or constructed with new Object | |
return true; | |
}, | |
isEmptyObject: function( obj ) { | |
var name; | |
for ( name in obj ) { | |
return false; | |
} | |
return true; | |
}, | |
error: function( msg ) { | |
throw new Error( msg ); | |
}, | |
// data: string of html | |
// context (optional): If specified, the fragment will be created in this context, defaults to document | |
// keepScripts (optional): If true, will include scripts passed in the html string | |
parseHTML: function( data, context, keepScripts ) { | |
if ( !data || typeof data !== "string" ) { | |
return null; | |
} | |
if ( typeof context === "boolean" ) { | |
keepScripts = context; | |
context = false; | |
} | |
context = context || document; | |
var parsed = rsingleTag.exec( data ), | |
scripts = !keepScripts && []; | |
// Single tag | |
if ( parsed ) { | |
return [ context.createElement( parsed[1] ) ]; | |
} | |
parsed = jQuery.buildFragment( [ data ], context, scripts ); | |
if ( scripts ) { | |
jQuery( scripts ).remove(); | |
} | |
return jQuery.merge( [], parsed.childNodes ); | |
}, | |
parseJSON: JSON.parse, | |
// Cross-browser xml parsing | |
parseXML: function( data ) { | |
var xml, tmp; | |
if ( !data || typeof data !== "string" ) { | |
return null; | |
} | |
// Support: IE9 | |
try { | |
tmp = new DOMParser(); | |
xml = tmp.parseFromString( data , "text/xml" ); | |
} catch ( e ) { | |
xml = undefined; | |
} | |
if ( !xml || xml.getElementsByTagName( "parsererror" ).length ) { | |
jQuery.error( "Invalid XML: " + data ); | |
} | |
return xml; | |
}, | |
noop: function() {}, | |
// Evaluates a script in a global context | |
globalEval: function( code ) { | |
var script, | |
indirect = eval; | |
code = jQuery.trim( code ); | |
if ( code ) { | |
// If the code includes a valid, prologue position | |
// strict mode pragma, execute code by injecting a | |
// script tag into the document. | |
if ( code.indexOf("use strict") === 1 ) { | |
script = document.createElement("script"); | |
script.text = code; | |
document.head.appendChild( script ).parentNode.removeChild( script ); | |
} else { | |
// Otherwise, avoid the DOM node creation, insertion | |
// and removal by using an indirect global eval | |
indirect( code ); | |
} | |
} | |
}, | |
// Convert dashed to camelCase; used by the css and data modules | |
// Microsoft forgot to hump their vendor prefix (#9572) | |
camelCase: function( string ) { | |
return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); | |
}, | |
nodeName: function( elem, name ) { | |
return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase(); | |
}, | |
// args is for internal usage only | |
each: function( obj, callback, args ) { | |
var value, | |
i = 0, | |
length = obj.length, | |
isArray = isArraylike( obj ); | |
if ( args ) { | |
if ( isArray ) { | |
for ( ; i < length; i++ ) { | |
value = callback.apply( obj[ i ], args ); | |
if ( value === false ) { | |
break; | |
} | |
} | |
} else { | |
for ( i in obj ) { | |
value = callback.apply( obj[ i ], args ); | |
if ( value === false ) { | |
break; | |
} | |
} | |
} | |
// A special, fast, case for the most common use of each | |
} else { | |
if ( isArray ) { | |
for ( ; i < length; i++ ) { | |
value = callback.call( obj[ i ], i, obj[ i ] ); | |
if ( value === false ) { | |
break; | |
} | |
} | |
} else { | |
for ( i in obj ) { | |
value = callback.call( obj[ i ], i, obj[ i ] ); | |
if ( value === false ) { | |
break; | |
} | |
} | |
} | |
} | |
return obj; | |
}, | |
trim: function( text ) { | |
return text == null ? "" : core_trim.call( text ); | |
}, | |
// results is for internal usage only | |
makeArray: function( arr, results ) { | |
var ret = results || []; | |
if ( arr != null ) { | |
if ( isArraylike( Object(arr) ) ) { | |
jQuery.merge( ret, | |
typeof arr === "string" ? | |
[ arr ] : arr | |
); | |
} else { | |
core_push.call( ret, arr ); | |
} | |
} | |
return ret; | |
}, | |
inArray: function( elem, arr, i ) { | |
return arr == null ? -1 : core_indexOf.call( arr, elem, i ); | |
}, | |
merge: function( first, second ) { | |
var l = second.length, | |
i = first.length, | |
j = 0; | |
if ( typeof l === "number" ) { | |
for ( ; j < l; j++ ) { | |
first[ i++ ] = second[ j ]; | |
} | |
} else { | |
while ( second[j] !== undefined ) { | |
first[ i++ ] = second[ j++ ]; | |
} | |
} | |
first.length = i; | |
return first; | |
}, | |
grep: function( elems, callback, inv ) { | |
var retVal, | |
ret = [], | |
i = 0, | |
length = elems.length; | |
inv = !!inv; | |
// Go through the array, only saving the items | |
// that pass the validator function | |
for ( ; i < length; i++ ) { | |
retVal = !!callback( elems[ i ], i ); | |
if ( inv !== retVal ) { | |
ret.push( elems[ i ] ); | |
} | |
} | |
return ret; | |
}, | |
// arg is for internal usage only | |
map: function( elems, callback, arg ) { | |
var value, | |
i = 0, | |
length = elems.length, | |
isArray = isArraylike( elems ), | |
ret = []; | |
// Go through the array, translating each of the items to their | |
if ( isArray ) { | |
for ( ; i < length; i++ ) { | |
value = callback( elems[ i ], i, arg ); | |
if ( value != null ) { | |
ret[ ret.length ] = value; | |
} | |
} | |
// Go through every key on the object, | |
} else { | |
for ( i in elems ) { | |
value = callback( elems[ i ], i, arg ); | |
if ( value != null ) { | |
ret[ ret.length ] = value; | |
} | |
} | |
} | |
// Flatten any nested arrays | |
return core_concat.apply( [], ret ); | |
}, | |
// A global GUID counter for objects | |
guid: 1, | |
// Bind a function to a context, optionally partially applying any | |
// arguments. | |
proxy: function( fn, context ) { | |
var tmp, args, proxy; | |
if ( typeof context === "string" ) { | |
tmp = fn[ context ]; | |
context = fn; | |
fn = tmp; | |
} | |
// Quick check to determine if target is callable, in the spec | |
// this throws a TypeError, but we will just return undefined. | |
if ( !jQuery.isFunction( fn ) ) { | |
return undefined; | |
} | |
// Simulated bind | |
args = core_slice.call( arguments, 2 ); | |
proxy = function() { | |
return fn.apply( context || this, args.concat( core_slice.call( arguments ) ) ); | |
}; | |
// Set the guid of unique handler to the same of original handler, so it can be removed | |
proxy.guid = fn.guid = fn.guid || jQuery.guid++; | |
return proxy; | |
}, | |
// Multifunctional method to get and set values of a collection | |
// The value/s can optionally be executed if it's a function | |
access: function( elems, fn, key, value, chainable, emptyGet, raw ) { | |
var i = 0, | |
length = elems.length, | |
bulk = key == null; | |
// Sets many values | |
if ( jQuery.type( key ) === "object" ) { | |
chainable = true; | |
for ( i in key ) { | |
jQuery.access( elems, fn, i, key[i], true, emptyGet, raw ); | |
} | |
// Sets one value | |
} else if ( value !== undefined ) { | |
chainable = true; | |
if ( !jQuery.isFunction( value ) ) { | |
raw = true; | |
} | |
if ( bulk ) { | |
// Bulk operations run against the entire set | |
if ( raw ) { | |
fn.call( elems, value ); | |
fn = null; | |
// ...except when executing function values | |
} else { | |
bulk = fn; | |
fn = function( elem, key, value ) { | |
return bulk.call( jQuery( elem ), value ); | |
}; | |
} | |
} | |
if ( fn ) { | |
for ( ; i < length; i++ ) { | |
fn( elems[i], key, raw ? value : value.call( elems[i], i, fn( elems[i], key ) ) ); | |
} | |
} | |
} | |
return chainable ? | |
elems : | |
// Gets | |
bulk ? | |
fn.call( elems ) : | |
length ? fn( elems[0], key ) : emptyGet; | |
}, | |
now: Date.now, | |
// A method for quickly swapping in/out CSS properties to get correct calculations. | |
// Note: this method belongs to the css module but it's needed here for the support module. | |
// If support gets modularized, this method should be moved back to the css module. | |
swap: function( elem, options, callback, args ) { | |
var ret, name, | |
old = {}; | |
// Remember the old values, and insert the new ones | |
for ( name in options ) { | |
old[ name ] = elem.style[ name ]; | |
elem.style[ name ] = options[ name ]; | |
} | |
ret = callback.apply( elem, args || [] ); | |
// Revert the old values | |
for ( name in options ) { | |
elem.style[ name ] = old[ name ]; | |
} | |
return ret; | |
} | |
}); | |
jQuery.ready.promise = function( obj ) { | |
if ( !readyList ) { | |
readyList = jQuery.Deferred(); | |
// Catch cases where $(document).ready() is called after the browser event has already occurred. | |
// we once tried to use readyState "interactive" here, but it caused issues like the one | |
// discovered by ChrisS here: http://bugs.jquery.com/ticket/12282#comment:15 | |
if ( document.readyState === "complete" ) { | |
// Handle it asynchronously to allow scripts the opportunity to delay ready | |
setTimeout( jQuery.ready ); | |
} else { | |
// Use the handy event callback | |
document.addEventListener( "DOMContentLoaded", completed, false ); | |
// A fallback to window.onload, that will always work | |
window.addEventListener( "load", completed, false ); | |
} | |
} | |
return readyList.promise( obj ); | |
}; | |
// Populate the class2type map | |
jQuery.each("Boolean Number String Function Array Date RegExp Object Error".split(" "), function(i, name) { | |
class2type[ "[object " + name + "]" ] = name.toLowerCase(); | |
}); | |
function isArraylike( obj ) { | |
var length = obj.length, | |
type = jQuery.type( obj ); | |
if ( jQuery.isWindow( obj ) ) { | |
return false; | |
} | |
if ( obj.nodeType === 1 && length ) { | |
return true; | |
} | |
return type === "array" || type !== "function" && | |
( length === 0 || | |
typeof length === "number" && length > 0 && ( length - 1 ) in obj ); | |
} | |
// All jQuery objects should point back to these | |
rootjQuery = jQuery(document); | |
/*! | |
* Sizzle CSS Selector Engine v1.9.4-pre | |
* http://sizzlejs.com/ | |
* | |
* Copyright 2013 jQuery Foundation, Inc. and other contributors | |
* Released under the MIT license | |
* http://jquery.org/license | |
* | |
* Date: 2013-06-03 | |
*/ | |
(function( window, undefined ) { | |
var i, | |
support, | |
cachedruns, | |
Expr, | |
getText, | |
isXML, | |
compile, | |
outermostContext, | |
sortInput, | |
// Local document vars | |
setDocument, | |
document, | |
docElem, | |
documentIsHTML, | |
rbuggyQSA, | |
rbuggyMatches, | |
matches, | |
contains, | |
// Instance-specific data | |
expando = "sizzle" + -(new Date()), | |
preferredDoc = window.document, | |
dirruns = 0, | |
done = 0, | |
classCache = createCache(), | |
tokenCache = createCache(), | |
compilerCache = createCache(), | |
hasDuplicate = false, | |
sortOrder = function( a, b ) { | |
if ( a === b ) { | |
hasDuplicate = true; | |
return 0; | |
} | |
return 0; | |
}, | |
// General-purpose constants | |
strundefined = typeof undefined, | |
MAX_NEGATIVE = 1 << 31, | |
// Instance methods | |
hasOwn = ({}).hasOwnProperty, | |
arr = [], | |
pop = arr.pop, | |
push_native = arr.push, | |
push = arr.push, | |
slice = arr.slice, | |
// Use a stripped-down indexOf if we can't use a native one | |
indexOf = arr.indexOf || function( elem ) { | |
var i = 0, | |
len = this.length; | |
for ( ; i < len; i++ ) { | |
if ( this[i] === elem ) { | |
return i; | |
} | |
} | |
return -1; | |
}, | |
booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped", | |
// Regular expressions | |
// Whitespace characters http://www.w3.org/TR/css3-selectors/#whitespace | |
whitespace = "[\\x20\\t\\r\\n\\f]", | |
// http://www.w3.org/TR/css3-syntax/#characters | |
characterEncoding = "(?:\\\\.|[\\w-]|[^\\x00-\\xa0])+", | |
// Loosely modeled on CSS identifier characters | |
// An unquoted value should be a CSS identifier http://www.w3.org/TR/css3-selectors/#attribute-selectors | |
// Proper syntax: http://www.w3.org/TR/CSS21/syndata.html#value-def-identifier | |
identifier = characterEncoding.replace( "w", "w#" ), | |
// Acceptable operators http://www.w3.org/TR/selectors/#attribute-selectors | |
attributes = "\\[" + whitespace + "*(" + characterEncoding + ")" + whitespace + | |
"*(?:([*^$|!~]?=)" + whitespace + "*(?:(['\"])((?:\\\\.|[^\\\\])*?)\\3|(" + identifier + ")|)|)" + whitespace + "*\\]", | |
// Prefer arguments quoted, | |
// then not containing pseudos/brackets, | |
// then attribute selectors/non-parenthetical expressions, | |
// then anything else | |
// These preferences are here to reduce the number of selectors | |
// needing tokenize in the PSEUDO preFilter | |
pseudos = ":(" + characterEncoding + ")(?:\\(((['\"])((?:\\\\.|[^\\\\])*?)\\3|((?:\\\\.|[^\\\\()[\\]]|" + attributes.replace( 3, 8 ) + ")*)|.*)\\)|)", | |
// Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter | |
rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + whitespace + "+$", "g" ), | |
rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ), | |
rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace + "*" ), | |
rsibling = new RegExp( whitespace + "*[+~]" ), | |
rattributeQuotes = new RegExp( "=" + whitespace + "*([^\\]'\"]*)" + whitespace + "*\\]", "g" ), | |
rpseudo = new RegExp( pseudos ), | |
ridentifier = new RegExp( "^" + identifier + "$" ), | |
matchExpr = { | |
"ID": new RegExp( "^#(" + characterEncoding + ")" ), | |
"CLASS": new RegExp( "^\\.(" + characterEncoding + ")" ), | |
"TAG": new RegExp( "^(" + characterEncoding.replace( "w", "w*" ) + ")" ), | |
"ATTR": new RegExp( "^" + attributes ), | |
"PSEUDO": new RegExp( "^" + pseudos ), | |
"CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + whitespace + | |
"*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + whitespace + | |
"*(\\d+)|))" + whitespace + "*\\)|)", "i" ), | |
"bool": new RegExp( "^(?:" + booleans + ")$", "i" ), | |
// For use in libraries implementing .is() | |
// We use this for POS matching in `select` | |
"needsContext": new RegExp( "^" + whitespace + "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + | |
whitespace + "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" ) | |
}, | |
rnative = /^[^{]+\{\s*\[native \w/, | |
// Easily-parseable/retrievable ID or TAG or CLASS selectors | |
rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/, | |
rinputs = /^(?:input|select|textarea|button)$/i, | |
rheader = /^h\d$/i, | |
rescape = /'|\\/g, | |
// CSS escapes http://www.w3.org/TR/CSS21/syndata.html#escaped-characters | |
runescape = new RegExp( "\\\\([\\da-f]{1,6}" + whitespace + "?|(" + whitespace + ")|.)", "ig" ), | |
funescape = function( _, escaped, escapedWhitespace ) { | |
var high = "0x" + escaped - 0x10000; | |
// NaN means non-codepoint | |
// Support: Firefox | |
// Workaround erroneous numeric interpretation of +"0x" | |
return high !== high || escapedWhitespace ? | |
escaped : | |
// BMP codepoint | |
high < 0 ? | |
String.fromCharCode( high + 0x10000 ) : | |
// Supplemental Plane codepoint (surrogate pair) | |
String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 ); | |
}; | |
// Optimize for push.apply( _, NodeList ) | |
try { | |
push.apply( | |
(arr = slice.call( preferredDoc.childNodes )), | |
preferredDoc.childNodes | |
); | |
// Support: Android<4.0 | |
// Detect silently failing push.apply | |
arr[ preferredDoc.childNodes.length ].nodeType; | |
} catch ( e ) { | |
push = { apply: arr.length ? | |
// Leverage slice if possible | |
function( target, els ) { | |
push_native.apply( target, slice.call(els) ); | |
} : | |
// Support: IE<9 | |
// Otherwise append directly | |
function( target, els ) { | |
var j = target.length, | |
i = 0; | |
// Can't trust NodeList.length | |
while ( (target[j++] = els[i++]) ) {} | |
target.length = j - 1; | |
} | |
}; | |
} | |
function Sizzle( selector, context, results, seed ) { | |
var match, elem, m, nodeType, | |
// QSA vars | |
i, groups, old, nid, newContext, newSelector; | |
if ( ( context ? context.ownerDocument || context : preferredDoc ) !== document ) { | |
setDocument( context ); | |
} | |
context = context || document; | |
results = results || []; | |
if ( !selector || typeof selector !== "string" ) { | |
return results; | |
} | |
if ( (nodeType = context.nodeType) !== 1 && nodeType !== 9 ) { | |
return []; | |
} | |
if ( documentIsHTML && !seed ) { | |
// Shortcuts | |
if ( (match = rquickExpr.exec( selector )) ) { | |
// Speed-up: Sizzle("#ID") | |
if ( (m = match[1]) ) { | |
if ( nodeType === 9 ) { | |
elem = context.getElementById( m ); | |
// Check parentNode to catch when Blackberry 4.6 returns | |
// nodes that are no longer in the document #6963 | |
if ( elem && elem.parentNode ) { | |
// Handle the case where IE, Opera, and Webkit return items | |
// by name instead of ID | |
if ( elem.id === m ) { | |
results.push( elem ); | |
return results; | |
} | |
} else { | |
return results; | |
} | |
} else { | |
// Context is not a document | |
if ( context.ownerDocument && (elem = context.ownerDocument.getElementById( m )) && | |
contains( context, elem ) && elem.id === m ) { | |
results.push( elem ); | |
return results; | |
} | |
} | |
// Speed-up: Sizzle("TAG") | |
} else if ( match[2] ) { | |
push.apply( results, context.getElementsByTagName( selector ) ); | |
return results; | |
// Speed-up: Sizzle(".CLASS") | |
} else if ( (m = match[3]) && support.getElementsByClassName && context.getElementsByClassName ) { | |
push.apply( results, context.getElementsByClassName( m ) ); | |
return results; | |
} | |
} | |
// QSA path | |
if ( support.qsa && (!rbuggyQSA || !rbuggyQSA.test( selector )) ) { | |
nid = old = expando; | |
newContext = context; | |
newSelector = nodeType === 9 && selector; | |
// qSA works strangely on Element-rooted queries | |
// We can work around this by specifying an extra ID on the root | |
// and working up from there (Thanks to Andrew Dupont for the technique) | |
// IE 8 doesn't work on object elements | |
if ( nodeType === 1 && context.nodeName.toLowerCase() !== "object" ) { | |
groups = tokenize( selector ); | |
if ( (old = context.getAttribute("id")) ) { | |
nid = old.replace( rescape, "\\$&" ); | |
} else { | |
context.setAttribute( "id", nid ); | |
} | |
nid = "[id='" + nid + "'] "; | |
i = groups.length; | |
while ( i-- ) { | |
groups[i] = nid + toSelector( groups[i] ); | |
} | |
newContext = rsibling.test( selector ) && context.parentNode || context; | |
newSelector = groups.join(","); | |
} | |
if ( newSelector ) { | |
try { | |
push.apply( results, | |
newContext.querySelectorAll( newSelector ) | |
); | |
return results; | |
} catch(qsaError) { | |
} finally { | |
if ( !old ) { | |
context.removeAttribute("id"); | |
} | |
} | |
} | |
} | |
} | |
// All others | |
return select( selector.replace( rtrim, "$1" ), context, results, seed ); | |
} | |
/** | |
* Create key-value caches of limited size | |
* @returns {Function(string, Object)} Returns the Object data after storing it on itself with | |
* property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength) | |
* deleting the oldest entry | |
*/ | |
function createCache() { | |
var keys = []; | |
function cache( key, value ) { | |
// Use (key + " ") to avoid collision with native prototype properties (see Issue #157) | |
if ( keys.push( key += " " ) > Expr.cacheLength ) { | |
// Only keep the most recent entries | |
delete cache[ keys.shift() ]; | |
} | |
return (cache[ key ] = value); | |
} | |
return cache; | |
} | |
/** | |
* Mark a function for special use by Sizzle | |
* @param {Function} fn The function to mark | |
*/ | |
function markFunction( fn ) { | |
fn[ expando ] = true; | |
return fn; | |
} | |
/** | |
* Support testing using an element | |
* @param {Function} fn Passed the created div and expects a boolean result | |
*/ | |
function assert( fn ) { | |
var div = document.createElement("div"); | |
try { | |
return !!fn( div ); | |
} catch (e) { | |
return false; | |
} finally { | |
// Remove from its parent by default | |
if ( div.parentNode ) { | |
div.parentNode.removeChild( div ); | |
} | |
// release memory in IE | |
div = null; | |
} | |
} | |
/** | |
* Adds the same handler for all of the specified attrs | |
* @param {String} attrs Pipe-separated list of attributes | |
* @param {Function} handler The method that will be applied | |
*/ | |
function addHandle( attrs, handler ) { | |
var arr = attrs.split("|"), | |
i = attrs.length; | |
while ( i-- ) { | |
Expr.attrHandle[ arr[i] ] = handler; | |
} | |
} | |
/** | |
* Checks document order of two siblings | |
* @param {Element} a | |
* @param {Element} b | |
* @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b | |
*/ | |
function siblingCheck( a, b ) { | |
var cur = b && a, | |
diff = cur && a.nodeType === 1 && b.nodeType === 1 && | |
( ~b.sourceIndex || MAX_NEGATIVE ) - | |
( ~a.sourceIndex || MAX_NEGATIVE ); | |
// Use IE sourceIndex if available on both nodes | |
if ( diff ) { | |
return diff; | |
} | |
// Check if b follows a | |
if ( cur ) { | |
while ( (cur = cur.nextSibling) ) { | |
if ( cur === b ) { | |
return -1; | |
} | |
} | |
} | |
return a ? 1 : -1; | |
} | |
/** | |
* Returns a function to use in pseudos for input types | |
* @param {String} type | |
*/ | |
function createInputPseudo( type ) { | |
return function( elem ) { | |
var name = elem.nodeName.toLowerCase(); | |
return name === "input" && elem.type === type; | |
}; | |
} | |
/** | |
* Returns a function to use in pseudos for buttons | |
* @param {String} type | |
*/ | |
function createButtonPseudo( type ) { | |
return function( elem ) { | |
var name = elem.nodeName.toLowerCase(); | |
return (name === "input" || name === "button") && elem.type === type; | |
}; | |
} | |
/** | |
* Returns a function to use in pseudos for positionals | |
* @param {Function} fn | |
*/ | |
function createPositionalPseudo( fn ) { | |
return markFunction(function( argument ) { | |
argument = +argument; | |
return markFunction(function( seed, matches ) { | |
var j, | |
matchIndexes = fn( [], seed.length, argument ), | |
i = matchIndexes.length; | |
// Match elements found at the specified indexes | |
while ( i-- ) { | |
if ( seed[ (j = matchIndexes[i]) ] ) { | |
seed[j] = !(matches[j] = seed[j]); | |
} | |
} | |
}); | |
}); | |
} | |
/** | |
* Detect xml | |
* @param {Element|Object} elem An element or a document | |
*/ | |
isXML = Sizzle.isXML = function( elem ) { | |
// documentElement is verified for cases where it doesn't yet exist | |
// (such as loading iframes in IE - #4833) | |
var documentElement = elem && (elem.ownerDocument || elem).documentElement; | |
return documentElement ? documentElement.nodeName !== "HTML" : false; | |
}; | |
// Expose support vars for convenience | |
support = Sizzle.support = {}; | |
/** | |
* Sets document-related variables once based on the current document | |
* @param {Element|Object} [doc] An element or document object to use to set the document | |
* @returns {Object} Returns the current document | |
*/ | |
setDocument = Sizzle.setDocument = function( node ) { | |
var doc = node ? node.ownerDocument || node : preferredDoc, | |
parent = doc.defaultView; | |
// If no document and documentElement is available, return | |
if ( doc === document || doc.nodeType !== 9 || !doc.documentElement ) { | |
return document; | |
} | |
// Set our document | |
document = doc; | |
docElem = doc.documentElement; | |
// Support tests | |
documentIsHTML = !isXML( doc ); | |
// Support: IE>8 | |
// If iframe document is assigned to "document" variable and if iframe has been reloaded, | |
// IE will throw "permission denied" error when accessing "document" variable, see jQuery #13936 | |
// IE6-8 do not support the defaultView property so parent will be undefined | |
if ( parent && parent.attachEvent && parent !== parent.top ) { | |
parent.attachEvent( "onbeforeunload", function() { | |
setDocument(); | |
}); | |
} | |
/* Attributes | |
---------------------------------------------------------------------- */ | |
// Support: IE<8 | |
// Verify that getAttribute really returns attributes and not properties (excepting IE8 booleans) | |
support.attributes = assert(function( div ) { | |
div.className = "i"; | |
return !div.getAttribute("className"); | |
}); | |
/* getElement(s)By* | |
---------------------------------------------------------------------- */ | |
// Check if getElementsByTagName("*") returns only elements | |
support.getElementsByTagName = assert(function( div ) { | |
div.appendChild( doc.createComment("") ); | |
return !div.getElementsByTagName("*").length; | |
}); | |
// Check if getElementsByClassName can be trusted | |
support.getElementsByClassName = assert(function( div ) { | |
div.innerHTML = "<div class='a'></div><div class='a i'></div>"; | |
// Support: Safari<4 | |
// Catch class over-caching | |
div.firstChild.className = "i"; | |
// Support: Opera<10 | |
// Catch gEBCN failure to find non-leading classes | |
return div.getElementsByClassName("i").length === 2; | |
}); | |
// Support: IE<10 | |
// Check if getElementById returns elements by name | |
// The broken getElementById methods don't pick up programatically-set names, | |
// so use a roundabout getElementsByName test | |
support.getById = assert(function( div ) { | |
docElem.appendChild( div ).id = expando; | |
return !doc.getElementsByName || !doc.getElementsByName( expando ).length; | |
}); | |
// ID find and filter | |
if ( support.getById ) { | |
Expr.find["ID"] = function( id, context ) { | |
if ( typeof context.getElementById !== strundefined && documentIsHTML ) { | |
var m = context.getElementById( id ); | |
// Check parentNode to catch when Blackberry 4.6 returns | |
// nodes that are no longer in the document #6963 | |
return m && m.parentNode ? [m] : []; | |
} | |
}; | |
Expr.filter["ID"] = function( id ) { | |
var attrId = id.replace( runescape, funescape ); | |
return function( elem ) { | |
return elem.getAttribute("id") === attrId; | |
}; | |
}; | |
} else { | |
// Support: IE6/7 | |
// getElementById is not reliable as a find shortcut | |
delete Expr.find["ID"]; | |
Expr.filter["ID"] = function( id ) { | |
var attrId = id.replace( runescape, funescape ); | |
return function( elem ) { | |
var node = typeof elem.getAttributeNode !== strundefined && elem.getAttributeNode("id"); | |
return node && node.value === attrId; | |
}; | |
}; | |
} | |
// Tag | |
Expr.find["TAG"] = support.getElementsByTagName ? | |
function( tag, context ) { | |
if ( typeof context.getElementsByTagName !== strundefined ) { | |
return context.getElementsByTagName( tag ); | |
} | |
} : | |
function( tag, context ) { | |
var elem, | |
tmp = [], | |
i = 0, | |
results = context.getElementsByTagName( tag ); | |
// Filter out possible comments | |
if ( tag === "*" ) { | |
while ( (elem = results[i++]) ) { | |
if ( elem.nodeType === 1 ) { | |
tmp.push( elem ); | |
} | |
} | |
return tmp; | |
} | |
return results; | |
}; | |
// Class | |
Expr.find["CLASS"] = support.getElementsByClassName && function( className, context ) { | |
if ( typeof context.getElementsByClassName !== strundefined && documentIsHTML ) { | |
return context.getElementsByClassName( className ); | |
} | |
}; | |
/* QSA/matchesSelector | |
---------------------------------------------------------------------- */ | |
// QSA and matchesSelector support | |
// matchesSelector(:active) reports false when true (IE9/Opera 11.5) | |
rbuggyMatches = []; | |
// qSa(:focus) reports false when true (Chrome 21) | |
// We allow this because of a bug in IE8/9 that throws an error | |
// whenever `document.activeElement` is accessed on an iframe | |
// So, we allow :focus to pass through QSA all the time to avoid the IE error | |
// See http://bugs.jquery.com/ticket/13378 | |
rbuggyQSA = []; | |
if ( (support.qsa = rnative.test( doc.querySelectorAll )) ) { | |
// Build QSA regex | |
// Regex strategy adopted from Diego Perini | |
assert(function( div ) { | |
// Select is set to empty string on purpose | |
// This is to test IE's treatment of not explicitly | |
// setting a boolean content attribute, | |
// since its presence should be enough | |
// http://bugs.jquery.com/ticket/12359 | |
div.innerHTML = "<select><option selected=''></option></select>"; | |
// Support: IE8 | |
// Boolean attributes and "value" are not treated correctly | |
if ( !div.querySelectorAll("[selected]").length ) { | |
rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" ); | |
} | |
// Webkit/Opera - :checked should return selected option elements | |
// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked | |
// IE8 throws error here and will not see later tests | |
if ( !div.querySelectorAll(":checked").length ) { | |
rbuggyQSA.push(":checked"); | |
} | |
}); | |
assert(function( div ) { | |
// Support: Opera 10-12/IE8 | |
// ^= $= *= and empty values | |
// Should not select anything | |
// Support: Windows 8 Native Apps | |
// The type attribute is restricted during .innerHTML assignment | |
var input = doc.createElement("input"); | |
input.setAttribute( "type", "hidden" ); | |
div.appendChild( input ).setAttribute( "t", "" ); | |
if ( div.querySelectorAll("[t^='']").length ) { | |
rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" ); | |
} | |
// FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled) | |
// IE8 throws error here and will not see later tests | |
if ( !div.querySelectorAll(":enabled").length ) { | |
rbuggyQSA.push( ":enabled", ":disabled" ); | |
} | |
// Opera 10-11 does not throw on post-comma invalid pseudos | |
div.querySelectorAll("*,:x"); | |
rbuggyQSA.push(",.*:"); | |
}); | |
} | |
if ( (support.matchesSelector = rnative.test( (matches = docElem.webkitMatchesSelector || | |
docElem.mozMatchesSelector || | |
docElem.oMatchesSelector || | |
docElem.msMatchesSelector) )) ) { | |
assert(function( div ) { | |
// Check to see if it's possible to do matchesSelector | |
// on a disconnected node (IE 9) | |
support.disconnectedMatch = matches.call( div, "div" ); | |
// This should fail with an exception | |
// Gecko does not error, returns false instead | |
matches.call( div, "[s!='']:x" ); | |
rbuggyMatches.push( "!=", pseudos ); | |
}); | |
} | |
rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join("|") ); | |
rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join("|") ); | |
/* Contains | |
---------------------------------------------------------------------- */ | |
// Element contains another | |
// Purposefully does not implement inclusive descendent | |
// As in, an element does not contain itself | |
contains = rnative.test( docElem.contains ) || docElem.compareDocumentPosition ? | |
function( a, b ) { | |
var adown = a.nodeType === 9 ? a.documentElement : a, | |
bup = b && b.parentNode; | |
return a === bup || !!( bup && bup.nodeType === 1 && ( | |
adown.contains ? | |
adown.contains( bup ) : | |
a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16 | |
)); | |
} : | |
function( a, b ) { | |
if ( b ) { | |
while ( (b = b.parentNode) ) { | |
if ( b === a ) { | |
return true; | |
} | |
} | |
} | |
return false; | |
}; | |
/* Sorting | |
---------------------------------------------------------------------- */ | |
// Document order sorting | |
sortOrder = docElem.compareDocumentPosition ? | |
function( a, b ) { | |
// Flag for duplicate removal | |
if ( a === b ) { | |
hasDuplicate = true; | |
return 0; | |
} | |
var compare = b.compareDocumentPosition && a.compareDocumentPosition && a.compareDocumentPosition( b ); | |
if ( compare ) { | |
// Disconnected nodes | |
if ( compare & 1 || | |
(!support.sortDetached && b.compareDocumentPosition( a ) === compare) ) { | |
// Choose the first element that is related to our preferred document | |
if ( a === doc || contains(preferredDoc, a) ) { | |
return -1; | |
} | |
if ( b === doc || contains(preferredDoc, b) ) { | |
return 1; | |
} | |
// Maintain original order | |
return sortInput ? | |
( indexOf.call( sortInput, a ) - indexOf.call( sortInput, b ) ) : | |
0; | |
} | |
return compare & 4 ? -1 : 1; | |
} | |
// Not directly comparable, sort on existence of method | |
return a.compareDocumentPosition ? -1 : 1; | |
} : | |
function( a, b ) { | |
var cur, | |
i = 0, | |
aup = a.parentNode, | |
bup = b.parentNode, | |
ap = [ a ], | |
bp = [ b ]; | |
// Exit early if the nodes are identical | |
if ( a === b ) { | |
hasDuplicate = true; | |
return 0; | |
// Parentless nodes are either documents or disconnected | |
} else if ( !aup || !bup ) { | |
return a === doc ? -1 : | |
b === doc ? 1 : | |
aup ? -1 : | |
bup ? 1 : | |
sortInput ? | |
( indexOf.call( sortInput, a ) - indexOf.call( sortInput, b ) ) : | |
0; | |
// If the nodes are siblings, we can do a quick check | |
} else if ( aup === bup ) { | |
return siblingCheck( a, b ); | |
} | |
// Otherwise we need full lists of their ancestors for comparison | |
cur = a; | |
while ( (cur = cur.parentNode) ) { | |
ap.unshift( cur ); | |
} | |
cur = b; | |
while ( (cur = cur.parentNode) ) { | |
bp.unshift( cur ); | |
} | |
// Walk down the tree looking for a discrepancy | |
while ( ap[i] === bp[i] ) { | |
i++; | |
} | |
return i ? | |
// Do a sibling check if the nodes have a common ancestor | |
siblingCheck( ap[i], bp[i] ) : | |
// Otherwise nodes in our document sort first | |
ap[i] === preferredDoc ? -1 : | |
bp[i] === preferredDoc ? 1 : | |
0; | |
}; | |
return doc; | |
}; | |
Sizzle.matches = function( expr, elements ) { | |
return Sizzle( expr, null, null, elements ); | |
}; | |
Sizzle.matchesSelector = function( elem, expr ) { | |
// Set document vars if needed | |
if ( ( elem.ownerDocument || elem ) !== document ) { | |
setDocument( elem ); | |
} | |
// Make sure that attribute selectors are quoted | |
expr = expr.replace( rattributeQuotes, "='$1']" ); | |
if ( support.matchesSelector && documentIsHTML && | |
( !rbuggyMatches || !rbuggyMatches.test( expr ) ) && | |
( !rbuggyQSA || !rbuggyQSA.test( expr ) ) ) { | |
try { | |
var ret = matches.call( elem, expr ); | |
// IE 9's matchesSelector returns false on disconnected nodes | |
if ( ret || support.disconnectedMatch || | |
// As well, disconnected nodes are said to be in a document | |
// fragment in IE 9 | |
elem.document && elem.document.nodeType !== 11 ) { | |
return ret; | |
} | |
} catch(e) {} | |
} | |
return Sizzle( expr, document, null, [elem] ).length > 0; | |
}; | |
Sizzle.contains = function( context, elem ) { | |
// Set document vars if needed | |
if ( ( context.ownerDocument || context ) !== document ) { | |
setDocument( context ); | |
} | |
return contains( context, elem ); | |
}; | |
Sizzle.attr = function( elem, name ) { | |
// Set document vars if needed | |
if ( ( elem.ownerDocument || elem ) !== document ) { | |
setDocument( elem ); | |
} | |
var fn = Expr.attrHandle[ name.toLowerCase() ], | |
// Don't get fooled by Object.prototype properties (jQuery #13807) | |
val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ? | |
fn( elem, name, !documentIsHTML ) : | |
undefined; | |
return val === undefined ? | |
support.attributes || !documentIsHTML ? | |
elem.getAttribute( name ) : | |
(val = elem.getAttributeNode(name)) && val.specified ? | |
val.value : | |
null : | |
val; | |
}; | |
Sizzle.error = function( msg ) { | |
throw new Error( "Syntax error, unrecognized expression: " + msg ); | |
}; | |
/** | |
* Document sorting and removing duplicates | |
* @param {ArrayLike} results | |
*/ | |
Sizzle.uniqueSort = function( results ) { | |
var elem, | |
duplicates = [], | |
j = 0, | |
i = 0; | |
// Unless we *know* we can detect duplicates, assume their presence | |
hasDuplicate = !support.detectDuplicates; | |
sortInput = !support.sortStable && results.slice( 0 ); | |
results.sort( sortOrder ); | |
if ( hasDuplicate ) { | |
while ( (elem = results[i++]) ) { | |
if ( elem === results[ i ] ) { | |
j = duplicates.push( i ); | |
} | |
} | |
while ( j-- ) { | |
results.splice( duplicates[ j ], 1 ); | |
} | |
} | |
return results; | |
}; | |
/** | |
* Utility function for retrieving the text value of an array of DOM nodes | |
* @param {Array|Element} elem | |
*/ | |
getText = Sizzle.getText = function( elem ) { | |
var node, | |
ret = "", | |
i = 0, | |
nodeType = elem.nodeType; | |
if ( !nodeType ) { | |
// If no nodeType, this is expected to be an array | |
for ( ; (node = elem[i]); i++ ) { | |
// Do not traverse comment nodes | |
ret += getText( node ); | |
} | |
} else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) { | |
// Use textContent for elements | |
// innerText usage removed for consistency of new lines (see #11153) | |
if ( typeof elem.textContent === "string" ) { | |
return elem.textContent; | |
} else { | |
// Traverse its children | |
for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { | |
ret += getText( elem ); | |
} | |
} | |
} else if ( nodeType === 3 || nodeType === 4 ) { | |
return elem.nodeValue; | |
} | |
// Do not include comment or processing instruction nodes | |
return ret; | |
}; | |
Expr = Sizzle.selectors = { | |
// Can be adjusted by the user | |
cacheLength: 50, | |
createPseudo: markFunction, | |
match: matchExpr, | |
attrHandle: {}, | |
find: {}, | |
relative: { | |
">": { dir: "parentNode", first: true }, | |
" ": { dir: "parentNode" }, | |
"+": { dir: "previousSibling", first: true }, | |
"~": { dir: "previousSibling" } | |
}, | |
preFilter: { | |
"ATTR": function( match ) { | |
match[1] = match[1].replace( runescape, funescape ); | |
// Move the given value to match[3] whether quoted or unquoted | |
match[3] = ( match[4] || match[5] || "" ).replace( runescape, funescape ); | |
if ( match[2] === "~=" ) { | |
match[3] = " " + match[3] + " "; | |
} | |
return match.slice( 0, 4 ); | |
}, | |
"CHILD": function( match ) { | |
/* matches from matchExpr["CHILD"] | |
1 type (only|nth|...) | |
2 what (child|of-type) | |
3 argument (even|odd|\d*|\d*n([+-]\d+)?|...) | |
4 xn-component of xn+y argument ([+-]?\d*n|) | |
5 sign of xn-component | |
6 x of xn-component | |
7 sign of y-component | |
8 y of y-component | |
*/ | |
match[1] = match[1].toLowerCase(); | |
if ( match[1].slice( 0, 3 ) === "nth" ) { | |
// nth-* requires argument | |
if ( !match[3] ) { | |
Sizzle.error( match[0] ); | |
} | |
// numeric x and y parameters for Expr.filter.CHILD | |
// remember that false/true cast respectively to 0/1 | |
match[4] = +( match[4] ? match[5] + (match[6] || 1) : 2 * ( match[3] === "even" || match[3] === "odd" ) ); | |
match[5] = +( ( match[7] + match[8] ) || match[3] === "odd" ); | |
// other types prohibit arguments | |
} else if ( match[3] ) { | |
Sizzle.error( match[0] ); | |
} | |
return match; | |
}, | |
"PSEUDO": function( match ) { | |
var excess, | |
unquoted = !match[5] && match[2]; | |
if ( matchExpr["CHILD"].test( match[0] ) ) { | |
return null; | |
} | |
// Accept quoted arguments as-is | |
if ( match[3] && match[4] !== undefined ) { | |
match[2] = match[4]; | |
// Strip excess characters from unquoted arguments | |
} else if ( unquoted && rpseudo.test( unquoted ) && | |
// Get excess from tokenize (recursively) | |
(excess = tokenize( unquoted, true )) && | |
// advance to the next closing parenthesis | |
(excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length) ) { | |
// excess is a negative index | |
match[0] = match[0].slice( 0, excess ); | |
match[2] = unquoted.slice( 0, excess ); | |
} | |
// Return only captures needed by the pseudo filter method (type and argument) | |
return match.slice( 0, 3 ); | |
} | |
}, | |
filter: { | |
"TAG": function( nodeNameSelector ) { | |
var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase(); | |
return nodeNameSelector === "*" ? | |
function() { return true; } : | |
function( elem ) { | |
return elem.nodeName && elem.nodeName.toLowerCase() === nodeName; | |
}; | |
}, | |
"CLASS": function( className ) { | |
var pattern = classCache[ className + " " ]; | |
return pattern || | |
(pattern = new RegExp( "(^|" + whitespace + ")" + className + "(" + whitespace + "|$)" )) && | |
classCache( className, function( elem ) { | |
return pattern.test( typeof elem.className === "string" && elem.className || typeof elem.getAttribute !== strundefined && elem.getAttribute("class") || "" ); | |
}); | |
}, | |
"ATTR": function( name, operator, check ) { | |
return function( elem ) { | |
var result = Sizzle.attr( elem, name ); | |
if ( result == null ) { | |
return operator === "!="; | |
} | |
if ( !operator ) { | |
return true; | |
} | |
result += ""; | |
return operator === "=" ? result === check : | |
operator === "!=" ? result !== check : | |
operator === "^=" ? check && result.indexOf( check ) === 0 : | |
operator === "*=" ? check && result.indexOf( check ) > -1 : | |
operator === "$=" ? check && result.slice( -check.length ) === check : | |
operator === "~=" ? ( " " + result + " " ).indexOf( check ) > -1 : | |
operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" : | |
false; | |
}; | |
}, | |
"CHILD": function( type, what, argument, first, last ) { | |
var simple = type.slice( 0, 3 ) !== "nth", | |
forward = type.slice( -4 ) !== "last", | |
ofType = what === "of-type"; | |
return first === 1 && last === 0 ? | |
// Shortcut for :nth-*(n) | |
function( elem ) { | |
return !!elem.parentNode; | |
} : | |
function( elem, context, xml ) { | |
var cache, outerCache, node, diff, nodeIndex, start, | |
dir = simple !== forward ? "nextSibling" : "previousSibling", | |
parent = elem.parentNode, | |
name = ofType && elem.nodeName.toLowerCase(), | |
useCache = !xml && !ofType; | |
if ( parent ) { | |
// :(first|last|only)-(child|of-type) | |
if ( simple ) { | |
while ( dir ) { | |
node = elem; | |
while ( (node = node[ dir ]) ) { | |
if ( ofType ? node.nodeName.toLowerCase() === name : node.nodeType === 1 ) { | |
return false; | |
} | |
} | |
// Reverse direction for :only-* (if we haven't yet done so) | |
start = dir = type === "only" && !start && "nextSibling"; | |
} | |
return true; | |
} | |
start = [ forward ? parent.firstChild : parent.lastChild ]; | |
// non-xml :nth-child(...) stores cache data on `parent` | |
if ( forward && useCache ) { | |
// Seek `elem` from a previously-cached index | |
outerCache = parent[ expando ] || (parent[ expando ] = {}); | |
cache = outerCache[ type ] || []; | |
nodeIndex = cache[0] === dirruns && cache[1]; | |
diff = cache[0] === dirruns && cache[2]; | |
node = nodeIndex && parent.childNodes[ nodeIndex ]; | |
while ( (node = ++nodeIndex && node && node[ dir ] || | |
// Fallback to seeking `elem` from the start | |
(diff = nodeIndex = 0) || start.pop()) ) { | |
// When found, cache indexes on `parent` and break | |
if ( node.nodeType === 1 && ++diff && node === elem ) { | |
outerCache[ type ] = [ dirruns, nodeIndex, diff ]; | |
break; | |
} | |
} | |
// Use previously-cached element index if available | |
} else if ( useCache && (cache = (elem[ expando ] || (elem[ expando ] = {}))[ type ]) && cache[0] === dirruns ) { | |
diff = cache[1]; | |
// xml :nth-child(...) or :nth-last-child(...) or :nth(-last)?-of-type(...) | |
} else { | |
// Use the same loop as above to seek `elem` from the start | |
while ( (node = ++nodeIndex && node && node[ dir ] || | |
(diff = nodeIndex = 0) || start.pop()) ) { | |
if ( ( ofType ? node.nodeName.toLowerCase() === name : node.nodeType === 1 ) && ++diff ) { | |
// Cache the index of each encountered element | |
if ( useCache ) { | |
(node[ expando ] || (node[ expando ] = {}))[ type ] = [ dirruns, diff ]; | |
} | |
if ( node === elem ) { | |
break; | |
} | |
} | |
} | |
} | |
// Incorporate the offset, then check against cycle size | |
diff -= last; | |
return diff === first || ( diff % first === 0 && diff / first >= 0 ); | |
} | |
}; | |
}, | |
"PSEUDO": function( pseudo, argument ) { | |
// pseudo-class names are case-insensitive | |
// http://www.w3.org/TR/selectors/#pseudo-classes | |
// Prioritize by case sensitivity in case custom pseudos are added with uppercase letters | |
// Remember that setFilters inherits from pseudos | |
var args, | |
fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] || | |
Sizzle.error( "unsupported pseudo: " + pseudo ); | |
// The user may use createPseudo to indicate that | |
// arguments are needed to create the filter function | |
// just as Sizzle does | |
if ( fn[ expando ] ) { | |
return fn( argument ); | |
} | |
// But maintain support for old signatures | |
if ( fn.length > 1 ) { | |
args = [ pseudo, pseudo, "", argument ]; | |
return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ? | |
markFunction(function( seed, matches ) { | |
var idx, | |
matched = fn( seed, argument ), | |
i = matched.length; | |
while ( i-- ) { | |
idx = indexOf.call( seed, matched[i] ); | |
seed[ idx ] = !( matches[ idx ] = matched[i] ); | |
} | |
}) : | |
function( elem ) { | |
return fn( elem, 0, args ); | |
}; | |
} | |
return fn; | |
} | |
}, | |
pseudos: { | |
// Potentially complex pseudos | |
"not": markFunction(function( selector ) { | |
// Trim the selector passed to compile | |
// to avoid treating leading and trailing | |
// spaces as combinators | |
var input = [], | |
results = [], | |
matcher = compile( selector.replace( rtrim, "$1" ) ); | |
return matcher[ expando ] ? | |
markFunction(function( seed, matches, context, xml ) { | |
var elem, | |
unmatched = matcher( seed, null, xml, [] ), | |
i = seed.length; | |
// Match elements unmatched by `matcher` | |
while ( i-- ) { | |
if ( (elem = unmatched[i]) ) { | |
seed[i] = !(matches[i] = elem); | |
} | |
} | |
}) : | |
function( elem, context, xml ) { | |
input[0] = elem; | |
matcher( input, null, xml, results ); | |
return !results.pop(); | |
}; | |
}), | |
"has": markFunction(function( selector ) { | |
return function( elem ) { | |
return Sizzle( selector, elem ).length > 0; | |
}; | |
}), | |
"contains": markFunction(function( text ) { | |
return function( elem ) { | |
return ( elem.textContent || elem.innerText || getText( elem ) ).indexOf( text ) > -1; | |
}; | |
}), | |
// "Whether an element is represented by a :lang() selector | |
// is based solely on the element's language value | |
// being equal to the identifier C, | |
// or beginning with the identifier C immediately followed by "-". | |
// The matching of C against the element's language value is performed case-insensitively. | |
// The identifier C does not have to be a valid language name." | |
// http://www.w3.org/TR/selectors/#lang-pseudo | |
"lang": markFunction( function( lang ) { | |
// lang value must be a valid identifier | |
if ( !ridentifier.test(lang || "") ) { | |
Sizzle.error( "unsupported lang: " + lang ); | |
} | |
lang = lang.replace( runescape, funescape ).toLowerCase(); | |
return function( elem ) { | |
var elemLang; | |
do { | |
if ( (elemLang = documentIsHTML ? | |
elem.lang : | |
elem.getAttribute("xml:lang") || elem.getAttribute("lang")) ) { | |
elemLang = elemLang.toLowerCase(); | |
return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0; | |
} | |
} while ( (elem = elem.parentNode) && elem.nodeType === 1 ); | |
return false; | |
}; | |
}), | |
// Miscellaneous | |
"target": function( elem ) { | |
var hash = window.location && window.location.hash; | |
return hash && hash.slice( 1 ) === elem.id; | |
}, | |
"root": function( elem ) { | |
return elem === docElem; | |
}, | |
"focus": function( elem ) { | |
return elem === document.activeElement && (!document.hasFocus || document.hasFocus()) && !!(elem.type || elem.href || ~elem.tabIndex); | |
}, | |
// Boolean properties | |
"enabled": function( elem ) { | |
return elem.disabled === false; | |
}, | |
"disabled": function( elem ) { | |
return elem.disabled === true; | |
}, | |
"checked": function( elem ) { | |
// In CSS3, :checked should return both checked and selected elements | |
// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked | |
var nodeName = elem.nodeName.toLowerCase(); | |
return (nodeName === "input" && !!elem.checked) || (nodeName === "option" && !!elem.selected); | |
}, | |
"selected": function( elem ) { | |
// Accessing this property makes selected-by-default | |
// options in Safari work properly | |
if ( elem.parentNode ) { | |
elem.parentNode.selectedIndex; | |
} | |
return elem.selected === true; | |
}, | |
// Contents | |
"empty": function( elem ) { | |
// http://www.w3.org/TR/selectors/#empty-pseudo | |
// :empty is only affected by element nodes and content nodes(including text(3), cdata(4)), | |
// not comment, processing instructions, or others | |
// Thanks to Diego Perini for the nodeName shortcut | |
// Greater than "@" means alpha characters (specifically not starting with "#" or "?") | |
for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { | |
if ( elem.nodeName > "@" || elem.nodeType === 3 || elem.nodeType === 4 ) { | |
return false; | |
} | |
} | |
return true; | |
}, | |
"parent": function( elem ) { | |
return !Expr.pseudos["empty"]( elem ); | |
}, | |
// Element/input types | |
"header": function( elem ) { | |
return rheader.test( elem.nodeName ); | |
}, | |
"input": function( elem ) { | |
return rinputs.test( elem.nodeName ); | |
}, | |
"button": function( elem ) { | |
var name = elem.nodeName.toLowerCase(); | |
return name === "input" && elem.type === "button" || name === "button"; | |
}, | |
"text": function( elem ) { | |
var attr; | |
// IE6 and 7 will map elem.type to 'text' for new HTML5 types (search, etc) | |
// use getAttribute instead to test this case | |
return elem.nodeName.toLowerCase() === "input" && | |
elem.type === "text" && | |
( (attr = elem.getAttribute("type")) == null || attr.toLowerCase() === elem.type ); | |
}, | |
// Position-in-collection | |
"first": createPositionalPseudo(function() { | |
return [ 0 ]; | |
}), | |
"last": createPositionalPseudo(function( matchIndexes, length ) { | |
return [ length - 1 ]; | |
}), | |
"eq": createPositionalPseudo(function( matchIndexes, length, argument ) { | |
return [ argument < 0 ? argument + length : argument ]; | |
}), | |
"even": createPositionalPseudo(function( matchIndexes, length ) { | |
var i = 0; | |
for ( ; i < length; i += 2 ) { | |
matchIndexes.push( i ); | |
} | |
return matchIndexes; | |
}), | |
"odd": createPositionalPseudo(function( matchIndexes, length ) { | |
var i = 1; | |
for ( ; i < length; i += 2 ) { | |
matchIndexes.push( i ); | |
} | |
return matchIndexes; | |
}), | |
"lt": createPositionalPseudo(function( matchIndexes, length, argument ) { | |
var i = argument < 0 ? argument + length : argument; | |
for ( ; --i >= 0; ) { | |
matchIndexes.push( i ); | |
} | |
return matchIndexes; | |
}), | |
"gt": createPositionalPseudo(function( matchIndexes, length, argument ) { | |
var i = argument < 0 ? argument + length : argument; | |
for ( ; ++i < length; ) { | |
matchIndexes.push( i ); | |
} | |
return matchIndexes; | |
}) | |
} | |
}; | |
Expr.pseudos["nth"] = Expr.pseudos["eq"]; | |
// Add button/input type pseudos | |
for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) { | |
Expr.pseudos[ i ] = createInputPseudo( i ); | |
} | |
for ( i in { submit: true, reset: true } ) { | |
Expr.pseudos[ i ] = createButtonPseudo( i ); | |
} | |
// Easy API for creating new setFilters | |
function setFilters() {} | |
setFilters.prototype = Expr.filters = Expr.pseudos; | |
Expr.setFilters = new setFilters(); | |
function tokenize( selector, parseOnly ) { | |
var matched, match, tokens, type, | |
soFar, groups, preFilters, | |
cached = tokenCache[ selector + " " ]; | |
if ( cached ) { | |
return parseOnly ? 0 : cached.slice( 0 ); | |
} | |
soFar = selector; | |
groups = []; | |
preFilters = Expr.preFilter; | |
while ( soFar ) { | |
// Comma and first run | |
if ( !matched || (match = rcomma.exec( soFar )) ) { | |
if ( match ) { | |
// Don't consume trailing commas as valid | |
soFar = soFar.slice( match[0].length ) || soFar; | |
} | |
groups.push( tokens = [] ); | |
} | |
matched = false; | |
// Combinators | |
if ( (match = rcombinators.exec( soFar )) ) { | |
matched = match.shift(); | |
tokens.push({ | |
value: matched, | |
// Cast descendant combinators to space | |
type: match[0].replace( rtrim, " " ) | |
}); | |
soFar = soFar.slice( matched.length ); | |
} | |
// Filters | |
for ( type in Expr.filter ) { | |
if ( (match = matchExpr[ type ].exec( soFar )) && (!preFilters[ type ] || | |
(match = preFilters[ type ]( match ))) ) { | |
matched = match.shift(); | |
tokens.push({ | |
value: matched, | |
type: type, | |
matches: match | |
}); | |
soFar = soFar.slice( matched.length ); | |
} | |
} | |
if ( !matched ) { | |
break; | |
} | |
} | |
// Return the length of the invalid excess | |
// if we're just parsing | |
// Otherwise, throw an error or return tokens | |
return parseOnly ? | |
soFar.length : | |
soFar ? | |
Sizzle.error( selector ) : | |
// Cache the tokens | |
tokenCache( selector, groups ).slice( 0 ); | |
} | |
function toSelector( tokens ) { | |
var i = 0, | |
len = tokens.length, | |
selector = ""; | |
for ( ; i < len; i++ ) { | |
selector += tokens[i].value; | |
} | |
return selector; | |
} | |
function addCombinator( matcher, combinator, base ) { | |
var dir = combinator.dir, | |
checkNonElements = base && dir === "parentNode", | |
doneName = done++; | |
return combinator.first ? | |
// Check against closest ancestor/preceding element | |
function( elem, context, xml ) { | |
while ( (elem = elem[ dir ]) ) { | |
if ( elem.nodeType === 1 || checkNonElements ) { | |
return matcher( elem, context, xml ); | |
} | |
} | |
} : | |
// Check against all ancestor/preceding elements | |
function( elem, context, xml ) { | |
var data, cache, outerCache, | |
dirkey = dirruns + " " + doneName; | |
// We can't set arbitrary data on XML nodes, so they don't benefit from dir caching | |
if ( xml ) { | |
while ( (elem = elem[ dir ]) ) { | |
if ( elem.nodeType === 1 || checkNonElements ) { | |
if ( matcher( elem, context, xml ) ) { | |
return true; | |
} | |
} | |
} | |
} else { | |
while ( (elem = elem[ dir ]) ) { | |
if ( elem.nodeType === 1 || checkNonElements ) { | |
outerCache = elem[ expando ] || (elem[ expando ] = {}); | |
if ( (cache = outerCache[ dir ]) && cache[0] === dirkey ) { | |
if ( (data = cache[1]) === true || data === cachedruns ) { | |
return data === true; | |
} | |
} else { | |
cache = outerCache[ dir ] = [ dirkey ]; | |
cache[1] = matcher( elem, context, xml ) || cachedruns; | |
if ( cache[1] === true ) { | |
return true; | |
} | |
} | |
} | |
} | |
} | |
}; | |
} | |
function elementMatcher( matchers ) { | |
return matchers.length > 1 ? | |
function( elem, context, xml ) { | |
var i = matchers.length; | |
while ( i-- ) { | |
if ( !matchers[i]( elem, context, xml ) ) { | |
return false; | |
} | |
} | |
return true; | |
} : | |
matchers[0]; | |
} | |
function condense( unmatched, map, filter, context, xml ) { | |
var elem, | |
newUnmatched = [], | |
i = 0, | |
len = unmatched.length, | |
mapped = map != null; | |
for ( ; i < len; i++ ) { | |
if ( (elem = unmatched[i]) ) { | |
if ( !filter || filter( elem, context, xml ) ) { | |
newUnmatched.push( elem ); | |
if ( mapped ) { | |
map.push( i ); | |
} | |
} | |
} | |
} | |
return newUnmatched; | |
} | |
function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) { | |
if ( postFilter && !postFilter[ expando ] ) { | |
postFilter = setMatcher( postFilter ); | |
} | |
if ( postFinder && !postFinder[ expando ] ) { | |
postFinder = setMatcher( postFinder, postSelector ); | |
} | |
return markFunction(function( seed, results, context, xml ) { | |
var temp, i, elem, | |
preMap = [], | |
postMap = [], | |
preexisting = results.length, | |
// Get initial elements from seed or context | |
elems = seed || multipleContexts( selector || "*", context.nodeType ? [ context ] : context, [] ), | |
// Prefilter to get matcher input, preserving a map for seed-results synchronization | |
matcherIn = preFilter && ( seed || !selector ) ? | |
condense( elems, preMap, preFilter, context, xml ) : | |
elems, | |
matcherOut = matcher ? | |
// If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results, | |
postFinder || ( seed ? preFilter : preexisting || postFilter ) ? | |
// ...intermediate processing is necessary | |
[] : | |
// ...otherwise use results directly | |
results : | |
matcherIn; | |
// Find primary matches | |
if ( matcher ) { | |
matcher( matcherIn, matcherOut, context, xml ); | |
} | |
// Apply postFilter | |
if ( postFilter ) { | |
temp = condense( matcherOut, postMap ); | |
postFilter( temp, [], context, xml ); | |
// Un-match failing elements by moving them back to matcherIn | |
i = temp.length; | |
while ( i-- ) { | |
if ( (elem = temp[i]) ) { | |
matcherOut[ postMap[i] ] = !(matcherIn[ postMap[i] ] = elem); | |
} | |
} | |
} | |
if ( seed ) { | |
if ( postFinder || preFilter ) { | |
if ( postFinder ) { | |
// Get the final matcherOut by condensing this intermediate into postFinder contexts | |
temp = []; | |
i = matcherOut.length; | |
while ( i-- ) { | |
if ( (elem = matcherOut[i]) ) { | |
// Restore matcherIn since elem is not yet a final match | |
temp.push( (matcherIn[i] = elem) ); | |
} | |
} | |
postFinder( null, (matcherOut = []), temp, xml ); | |
} | |
// Move matched elements from seed to results to keep them synchronized | |
i = matcherOut.length; | |
while ( i-- ) { | |
if ( (elem = matcherOut[i]) && | |
(temp = postFinder ? indexOf.call( seed, elem ) : preMap[i]) > -1 ) { | |
seed[temp] = !(results[temp] = elem); | |
} | |
} | |
} | |
// Add elements to results, through postFinder if defined | |
} else { | |
matcherOut = condense( | |
matcherOut === results ? | |
matcherOut.splice( preexisting, matcherOut.length ) : | |
matcherOut | |
); | |
if ( postFinder ) { | |
postFinder( null, results, matcherOut, xml ); | |
} else { | |
push.apply( results, matcherOut ); | |
} | |
} | |
}); | |
} | |
function matcherFromTokens( tokens ) { | |
var checkContext, matcher, j, | |
len = tokens.length, | |
leadingRelative = Expr.relative[ tokens[0].type ], | |
implicitRelative = leadingRelative || Expr.relative[" "], | |
i = leadingRelative ? 1 : 0, | |
// The foundational matcher ensures that elements are reachable from top-level context(s) | |
matchContext = addCombinator( function( elem ) { | |
return elem === checkContext; | |
}, implicitRelative, true ), | |
matchAnyContext = addCombinator( function( elem ) { | |
return indexOf.call( checkContext, elem ) > -1; | |
}, implicitRelative, true ), | |
matchers = [ function( elem, context, xml ) { | |
return ( !leadingRelative && ( xml || context !== outermostContext ) ) || ( | |
(checkContext = context).nodeType ? | |
matchContext( elem, context, xml ) : | |
matchAnyContext( elem, context, xml ) ); | |
} ]; | |
for ( ; i < len; i++ ) { | |
if ( (matcher = Expr.relative[ tokens[i].type ]) ) { | |
matchers = [ addCombinator(elementMatcher( matchers ), matcher) ]; | |
} else { | |
matcher = Expr.filter[ tokens[i].type ].apply( null, tokens[i].matches ); | |
// Return special upon seeing a positional matcher | |
if ( matcher[ expando ] ) { | |
// Find the next relative operator (if any) for proper handling | |
j = ++i; | |
for ( ; j < len; j++ ) { | |
if ( Expr.relative[ tokens[j].type ] ) { | |
break; | |
} | |
} | |
return setMatcher( | |
i > 1 && elementMatcher( matchers ), | |
i > 1 && toSelector( | |
// If the preceding token was a descendant combinator, insert an implicit any-element `*` | |
tokens.slice( 0, i - 1 ).concat({ value: tokens[ i - 2 ].type === " " ? "*" : "" }) | |
).replace( rtrim, "$1" ), | |
matcher, | |
i < j && matcherFromTokens( tokens.slice( i, j ) ), | |
j < len && matcherFromTokens( (tokens = tokens.slice( j )) ), | |
j < len && toSelector( tokens ) | |
); | |
} | |
matchers.push( matcher ); | |
} | |
} | |
return elementMatcher( matchers ); | |
} | |
function matcherFromGroupMatchers( elementMatchers, setMatchers ) { | |
// A counter to specify which element is currently being matched | |
var matcherCachedRuns = 0, | |
bySet = setMatchers.length > 0, | |
byElement = elementMatchers.length > 0, | |
superMatcher = function( seed, context, xml, results, expandContext ) { | |
var elem, j, matcher, | |
setMatched = [], | |
matchedCount = 0, | |
i = "0", | |
unmatched = seed && [], | |
outermost = expandContext != null, | |
contextBackup = outermostContext, | |
// We must always have either seed elements or context | |
elems = seed || byElement && Expr.find["TAG"]( "*", expandContext && context.parentNode || context ), | |
// Use integer dirruns iff this is the outermost matcher | |
dirrunsUnique = (dirruns += contextBackup == null ? 1 : Math.random() || 0.1); | |
if ( outermost ) { | |
outermostContext = context !== document && context; | |
cachedruns = matcherCachedRuns; | |
} | |
// Add elements passing elementMatchers directly to results | |
// Keep `i` a string if there are no elements so `matchedCount` will be "00" below | |
for ( ; (elem = elems[i]) != null; i++ ) { | |
if ( byElement && elem ) { | |
j = 0; | |
while ( (matcher = elementMatchers[j++]) ) { | |
if ( matcher( elem, context, xml ) ) { | |
results.push( elem ); | |
break; | |
} | |
} | |
if ( outermost ) { | |
dirruns = dirrunsUnique; | |
cachedruns = ++matcherCachedRuns; | |
} | |
} | |
// Track unmatched elements for set filters | |
if ( bySet ) { | |
// They will have gone through all possible matchers | |
if ( (elem = !matcher && elem) ) { | |
matchedCount--; | |
} | |
// Lengthen the array for every element, matched or not | |
if ( seed ) { | |
unmatched.push( elem ); | |
} | |
} | |
} | |
// Apply set filters to unmatched elements | |
matchedCount += i; | |
if ( bySet && i !== matchedCount ) { | |
j = 0; | |
while ( (matcher = setMatchers[j++]) ) { | |
matcher( unmatched, setMatched, context, xml ); | |
} | |
if ( seed ) { | |
// Reintegrate element matches to eliminate the need for sorting | |
if ( matchedCount > 0 ) { | |
while ( i-- ) { | |
if ( !(unmatched[i] || setMatched[i]) ) { | |
setMatched[i] = pop.call( results ); | |
} | |
} | |
} | |
// Discard index placeholder values to get only actual matches | |
setMatched = condense( setMatched ); | |
} | |
// Add matches to results | |
push.apply( results, setMatched ); | |
// Seedless set matches succeeding multiple successful matchers stipulate sorting | |
if ( outermost && !seed && setMatched.length > 0 && | |
( matchedCount + setMatchers.length ) > 1 ) { | |
Sizzle.uniqueSort( results ); | |
} | |
} | |
// Override manipulation of globals by nested matchers | |
if ( outermost ) { | |
dirruns = dirrunsUnique; | |
outermostContext = contextBackup; | |
} | |
return unmatched; | |
}; | |
return bySet ? | |
markFunction( superMatcher ) : | |
superMatcher; | |
} | |
compile = Sizzle.compile = function( selector, group /* Internal Use Only */ ) { | |
var i, | |
setMatchers = [], | |
elementMatchers = [], | |
cached = compilerCache[ selector + " " ]; | |
if ( !cached ) { | |
// Generate a function of recursive functions that can be used to check each element | |
if ( !group ) { | |
group = tokenize( selector ); | |
} | |
i = group.length; | |
while ( i-- ) { | |
cached = matcherFromTokens( group[i] ); | |
if ( cached[ expando ] ) { | |
setMatchers.push( cached ); | |
} else { | |
elementMatchers.push( cached ); | |
} | |
} | |
// Cache the compiled function | |
cached = compilerCache( selector, matcherFromGroupMatchers( elementMatchers, setMatchers ) ); | |
} | |
return cached; | |
}; | |
function multipleContexts( selector, contexts, results ) { | |
var i = 0, | |
len = contexts.length; | |
for ( ; i < len; i++ ) { | |
Sizzle( selector, contexts[i], results ); | |
} | |
return results; | |
} | |
function select( selector, context, results, seed ) { | |
var i, tokens, token, type, find, | |
match = tokenize( selector ); | |
if ( !seed ) { | |
// Try to minimize operations if there is only one group | |
if ( match.length === 1 ) { | |
// Take a shortcut and set the context if the root selector is an ID | |
tokens = match[0] = match[0].slice( 0 ); | |
if ( tokens.length > 2 && (token = tokens[0]).type === "ID" && | |
support.getById && context.nodeType === 9 && documentIsHTML && | |
Expr.relative[ tokens[1].type ] ) { | |
context = ( Expr.find["ID"]( token.matches[0].replace(runescape, funescape), context ) || [] )[0]; | |
if ( !context ) { | |
return results; | |
} | |
selector = selector.slice( tokens.shift().value.length ); | |
} | |
// Fetch a seed set for right-to-left matching | |
i = matchExpr["needsContext"].test( selector ) ? 0 : tokens.length; | |
while ( i-- ) { | |
token = tokens[i]; | |
// Abort if we hit a combinator | |
if ( Expr.relative[ (type = token.type) ] ) { | |
break; | |
} | |
if ( (find = Expr.find[ type ]) ) { | |
// Search, expanding context for leading sibling combinators | |
if ( (seed = find( | |
token.matches[0].replace( runescape, funescape ), | |
rsibling.test( tokens[0].type ) && context.parentNode || context | |
)) ) { | |
// If seed is empty or no tokens remain, we can return early | |
tokens.splice( i, 1 ); | |
selector = seed.length && toSelector( tokens ); | |
if ( !selector ) { | |
push.apply( results, seed ); | |
return results; | |
} | |
break; | |
} | |
} | |
} | |
} | |
} | |
// Compile and execute a filtering function | |
// Provide `match` to avoid retokenization if we modified the selector above | |
compile( selector, match )( | |
seed, | |
context, | |
!documentIsHTML, | |
results, | |
rsibling.test( selector ) | |
); | |
return results; | |
} | |
// One-time assignments | |
// Sort stability | |
support.sortStable = expando.split("").sort( sortOrder ).join("") === expando; | |
// Support: Chrome<14 | |
// Always assume duplicates if they aren't passed to the comparison function | |
support.detectDuplicates = hasDuplicate; | |
// Initialize against the default document | |
setDocument(); | |
// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27) | |
// Detached nodes confoundingly follow *each other* | |
support.sortDetached = assert(function( div1 ) { | |
// Should return 1, but returns 4 (following) | |
return div1.compareDocumentPosition( document.createElement("div") ) & 1; | |
}); | |
// Support: IE<8 | |
// Prevent attribute/property "interpolation" | |
// http://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx | |
if ( !assert(function( div ) { | |
div.innerHTML = "<a href='#'></a>"; | |
return div.firstChild.getAttribute("href") === "#" ; | |
}) ) { | |
addHandle( "type|href|height|width", function( elem, name, isXML ) { | |
if ( !isXML ) { | |
return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 ); | |
} | |
}); | |
} | |
// Support: IE<9 | |
// Use defaultValue in place of getAttribute("value") | |
if ( !support.attributes || !assert(function( div ) { | |
div.innerHTML = "<input/>"; | |
div.firstChild.setAttribute( "value", "" ); | |
return div.firstChild.getAttribute( "value" ) === ""; | |
}) ) { | |
addHandle( "value", function( elem, name, isXML ) { | |
if ( !isXML && elem.nodeName.toLowerCase() === "input" ) { | |
return elem.defaultValue; | |
} | |
}); | |
} | |
// Support: IE<9 | |
// Use getAttributeNode to fetch booleans when getAttribute lies | |
if ( !assert(function( div ) { | |
return div.getAttribute("disabled") == null; | |
}) ) { | |
addHandle( booleans, function( elem, name, isXML ) { | |
var val; | |
if ( !isXML ) { | |
return (val = elem.getAttributeNode( name )) && val.specified ? | |
val.value : | |
elem[ name ] === true ? name.toLowerCase() : null; | |
} | |
}); | |
} | |
jQuery.find = Sizzle; | |
jQuery.expr = Sizzle.selectors; | |
jQuery.expr[":"] = jQuery.expr.pseudos; | |
jQuery.unique = Sizzle.uniqueSort; | |
jQuery.text = Sizzle.getText; | |
jQuery.isXMLDoc = Sizzle.isXML; | |
jQuery.contains = Sizzle.contains; | |
})( window ); | |
// String to Object options format cache | |
var optionsCache = {}; | |
// Convert String-formatted options into Object-formatted ones and store in cache | |
function createOptions( options ) { | |
var object = optionsCache[ options ] = {}; | |
jQuery.each( options.match( core_rnotwhite ) || [], function( _, flag ) { | |
object[ flag ] = true; | |
}); | |
return object; | |
} | |
/* | |
* Create a callback list using the following parameters: | |
* | |
* options: an optional list of space-separated options that will change how | |
* the callback list behaves or a more traditional option object | |
* | |
* By default a callback list will act like an event callback list and can be | |
* "fired" multiple times. | |
* | |
* Possible options: | |
* | |
* once: will ensure the callback list can only be fired once (like a Deferred) | |
* | |
* memory: will keep track of previous values and will call any callback added | |
* after the list has been fired right away with the latest "memorized" | |
* values (like a Deferred) | |
* | |
* unique: will ensure a callback can only be added once (no duplicate in the list) | |
* | |
* stopOnFalse: interrupt callings when a callback returns false | |
* | |
*/ | |
jQuery.Callbacks = function( options ) { | |
// Convert options from String-formatted to Object-formatted if needed | |
// (we check in cache first) | |
options = typeof options === "string" ? | |
( optionsCache[ options ] || createOptions( options ) ) : | |
jQuery.extend( {}, options ); | |
var // Last fire value (for non-forgettable lists) | |
memory, | |
// Flag to know if list was already fired | |
fired, | |
// Flag to know if list is currently firing | |
firing, | |
// First callback to fire (used internally by add and fireWith) | |
firingStart, | |
// End of the loop when firing | |
firingLength, | |
// Index of currently firing callback (modified by remove if needed) | |
firingIndex, | |
// Actual callback list | |
list = [], | |
// Stack of fire calls for repeatable lists | |
stack = !options.once && [], | |
// Fire callbacks | |
fire = function( data ) { | |
memory = options.memory && data; | |
fired = true; | |
firingIndex = firingStart || 0; | |
firingStart = 0; | |
firingLength = list.length; | |
firing = true; | |
for ( ; list && firingIndex < firingLength; firingIndex++ ) { | |
if ( list[ firingIndex ].apply( data[ 0 ], data[ 1 ] ) === false && options.stopOnFalse ) { | |
memory = false; // To prevent further calls using add | |
break; | |
} | |
} | |
firing = false; | |
if ( list ) { | |
if ( stack ) { | |
if ( stack.length ) { | |
fire( stack.shift() ); | |
} | |
} else if ( memory ) { | |
list = []; | |
} else { | |
self.disable(); | |
} | |
} | |
}, | |
// Actual Callbacks object | |
self = { | |
// Add a callback or a collection of callbacks to the list | |
add: function() { | |
if ( list ) { | |
// First, we save the current length | |
var start = list.length; | |
(function add( args ) { | |
jQuery.each( args, function( _, arg ) { | |
var type = jQuery.type( arg ); | |
if ( type === "function" ) { | |
if ( !options.unique || !self.has( arg ) ) { | |
list.push( arg ); | |
} | |
} else if ( arg && arg.length && type !== "string" ) { | |
// Inspect recursively | |
add( arg ); | |
} | |
}); | |
})( arguments ); | |
// Do we need to add the callbacks to the | |
// current firing batch? | |
if ( firing ) { | |
firingLength = list.length; | |
// With memory, if we're not firing then | |
// we should call right away | |
} else if ( memory ) { | |
firingStart = start; | |
fire( memory ); | |
} | |
} | |
return this; | |
}, | |
// Remove a callback from the list | |
remove: function() { | |
if ( list ) { | |
jQuery.each( arguments, function( _, arg ) { | |
var index; | |
while( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) { | |
list.splice( index, 1 ); | |
// Handle firing indexes | |
if ( firing ) { | |
if ( index <= firingLength ) { | |
firingLength--; | |
} | |
if ( index <= firingIndex ) { | |
firingIndex--; | |
} | |
} | |
} | |
}); | |
} | |
return this; | |
}, | |
// Check if a given callback is in the list. | |
// If no argument is given, return whether or not list has callbacks attached. | |
has: function( fn ) { | |
return fn ? jQuery.inArray( fn, list ) > -1 : !!( list && list.length ); | |
}, | |
// Remove all callbacks from the list | |
empty: function() { | |
list = []; | |
firingLength = 0; | |
return this; | |
}, | |
// Have the list do nothing anymore | |
disable: function() { | |
list = stack = memory = undefined; | |
return this; | |
}, | |
// Is it disabled? | |
disabled: function() { | |
return !list; | |
}, | |
// Lock the list in its current state | |
lock: function() { | |
stack = undefined; | |
if ( !memory ) { | |
self.disable(); | |
} | |
return this; | |
}, | |
// Is it locked? | |
locked: function() { | |
return !stack; | |
}, | |
// Call all callbacks with the given context and arguments | |
fireWith: function( context, args ) { | |
if ( list && ( !fired || stack ) ) { | |
args = args || []; | |
args = [ context, args.slice ? args.slice() : args ]; | |
if ( firing ) { | |
stack.push( args ); | |
} else { | |
fire( args ); | |
} | |
} | |
return this; | |
}, | |
// Call all the callbacks with the given arguments | |
fire: function() { | |
self.fireWith( this, arguments ); | |
return this; | |
}, | |
// To know if the callbacks have already been called at least once | |
fired: function() { | |
return !!fired; | |
} | |
}; | |
return self; | |
}; | |
jQuery.extend({ | |
Deferred: function( func ) { | |
var tuples = [ | |
// action, add listener, listener list, final state | |
[ "resolve", "done", jQuery.Callbacks("once memory"), "resolved" ], | |
[ "reject", "fail", jQuery.Callbacks("once memory"), "rejected" ], | |
[ "notify", "progress", jQuery.Callbacks("memory") ] | |
], | |
state = "pending", | |
promise = { | |
state: function() { | |
return state; | |
}, | |
always: function() { | |
deferred.done( arguments ).fail( arguments ); | |
return this; | |
}, | |
then: function( /* fnDone, fnFail, fnProgress */ ) { | |
var fns = arguments; | |
return jQuery.Deferred(function( newDefer ) { | |
jQuery.each( tuples, function( i, tuple ) { | |
var action = tuple[ 0 ], | |
fn = jQuery.isFunction( fns[ i ] ) && fns[ i ]; | |
// deferred[ done | fail | progress ] for forwarding actions to newDefer | |
deferred[ tuple[1] ](function() { | |
var returned = fn && fn.apply( this, arguments ); | |
if ( returned && jQuery.isFunction( returned.promise ) ) { | |
returned.promise() | |
.done( newDefer.resolve ) | |
.fail( newDefer.reject ) | |
.progress( newDefer.notify ); | |
} else { | |
newDefer[ action + "With" ]( this === promise ? newDefer.promise() : this, fn ? [ returned ] : arguments ); | |
} | |
}); | |
}); | |
fns = null; | |
}).promise(); | |
}, | |
// Get a promise for this deferred | |
// If obj is provided, the promise aspect is added to the object | |
promise: function( obj ) { | |
return obj != null ? jQuery.extend( obj, promise ) : promise; | |
} | |
}, | |
deferred = {}; | |
// Keep pipe for back-compat | |
promise.pipe = promise.then; | |
// Add list-specific methods | |
jQuery.each( tuples, function( i, tuple ) { | |
var list = tuple[ 2 ], | |
stateString = tuple[ 3 ]; | |
// promise[ done | fail | progress ] = list.add | |
promise[ tuple[1] ] = list.add; | |
// Handle state | |
if ( stateString ) { | |
list.add(function() { | |
// state = [ resolved | rejected ] | |
state = stateString; | |
// [ reject_list | resolve_list ].disable; progress_list.lock | |
}, tuples[ i ^ 1 ][ 2 ].disable, tuples[ 2 ][ 2 ].lock ); | |
} | |
// deferred[ resolve | reject | notify ] | |
deferred[ tuple[0] ] = function() { | |
deferred[ tuple[0] + "With" ]( this === deferred ? promise : this, arguments ); | |
return this; | |
}; | |
deferred[ tuple[0] + "With" ] = list.fireWith; | |
}); | |
// Make the deferred a promise | |
promise.promise( deferred ); | |
// Call given func if any | |
if ( func ) { | |
func.call( deferred, deferred ); | |
} | |
// All done! | |
return deferred; | |
}, | |
// Deferred helper | |
when: function( subordinate /* , ..., subordinateN */ ) { | |
var i = 0, | |
resolveValues = core_slice.call( arguments ), | |
length = resolveValues.length, | |
// the count of uncompleted subordinates | |
remaining = length !== 1 || ( subordinate && jQuery.isFunction( subordinate.promise ) ) ? length : 0, | |
// the master Deferred. If resolveValues consist of only a single Deferred, just use that. | |
deferred = remaining === 1 ? subordinate : jQuery.Deferred(), | |
// Update function for both resolve and progress values | |
updateFunc = function( i, contexts, values ) { | |
return function( value ) { | |
contexts[ i ] = this; | |
values[ i ] = arguments.length > 1 ? core_slice.call( arguments ) : value; | |
if( values === progressValues ) { | |
deferred.notifyWith( contexts, values ); | |
} else if ( !( --remaining ) ) { | |
deferred.resolveWith( contexts, values ); | |
} | |
}; | |
}, | |
progressValues, progressContexts, resolveContexts; | |
// add listeners to Deferred subordinates; treat others as resolved | |
if ( length > 1 ) { | |
progressValues = new Array( length ); | |
progressContexts = new Array( length ); | |
resolveContexts = new Array( length ); | |
for ( ; i < length; i++ ) { | |
if ( resolveValues[ i ] && jQuery.isFunction( resolveValues[ i ].promise ) ) { | |
resolveValues[ i ].promise() | |
.done( updateFunc( i, resolveContexts, resolveValues ) ) | |
.fail( deferred.reject ) | |
.progress( updateFunc( i, progressContexts, progressValues ) ); | |
} else { | |
--remaining; | |
} | |
} | |
} | |
// if we're not waiting on anything, resolve the master | |
if ( !remaining ) { | |
deferred.resolveWith( resolveContexts, resolveValues ); | |
} | |
return deferred.promise(); | |
} | |
}); | |
jQuery.support = (function( support ) { | |
var input = document.createElement("input"), | |
fragment = document.createDocumentFragment(), | |
div = document.createElement("div"), | |
select = document.createElement("select"), | |
opt = select.appendChild( document.createElement("option") ); | |
// Finish early in limited environments | |
if ( !input.type ) { | |
return support; | |
} | |
input.type = "checkbox"; | |
// Support: Safari 5.1, iOS 5.1, Android 4.x, Android 2.3 | |
// Check the default checkbox/radio value ("" on old WebKit; "on" elsewhere) | |
support.checkOn = input.value !== ""; | |
// Must access the parent to make an option select properly | |
// Support: IE9, IE10 | |
support.optSelected = opt.selected; | |
// Will be defined later | |
support.reliableMarginRight = true; | |
support.boxSizingReliable = true; | |
support.pixelPosition = false; | |
// Make sure checked status is properly cloned | |
// Support: IE9, IE10 | |
input.checked = true; | |
support.noCloneChecked = input.cloneNode( true ).checked; | |
// Make sure that the options inside disabled selects aren't marked as disabled | |
// (WebKit marks them as disabled) | |
select.disabled = true; | |
support.optDisabled = !opt.disabled; | |
// Check if an input maintains its value after becoming a radio | |
// Support: IE9, IE10 | |
input = document.createElement("input"); | |
input.value = "t"; | |
input.type = "radio"; | |
support.radioValue = input.value === "t"; | |
// #11217 - WebKit loses check when the name is after the checked attribute | |
input.setAttribute( "checked", "t" ); | |
input.setAttribute( "name", "t" ); | |
fragment.appendChild( input ); | |
// Support: Safari 5.1, Android 4.x, Android 2.3 | |
// old WebKit doesn't clone checked state correctly in fragments | |
support.checkClone = fragment.cloneNode( true ).cloneNode( true ).lastChild.checked; | |
// Support: Firefox, Chrome, Safari | |
// Beware of CSP restrictions (https://developer.mozilla.org/en/Security/CSP) | |
support.focusinBubbles = "onfocusin" in window; | |
div.style.backgroundClip = "content-box"; | |
div.cloneNode( true ).style.backgroundClip = ""; | |
support.clearCloneStyle = div.style.backgroundClip === "content-box"; | |
// Run tests that need a body at doc ready | |
jQuery(function() { | |
var container, marginDiv, | |
// Support: Firefox, Android 2.3 (Prefixed box-sizing versions). | |
divReset = "padding:0;margin:0;border:0;display:block;-webkit-box-sizing:content-box;-moz-box-sizing:content-box;box-sizing:content-box", | |
body = document.getElementsByTagName("body")[ 0 ]; | |
if ( !body ) { | |
// Return for frameset docs that don't have a body | |
return; | |
} | |
container = document.createElement("div"); | |
container.style.cssText = "border:0;width:0;height:0;position:absolute;top:0;left:-9999px;margin-top:1px"; | |
// Check box-sizing and margin behavior. | |
body.appendChild( container ).appendChild( div ); | |
div.innerHTML = ""; | |
// Support: Firefox, Android 2.3 (Prefixed box-sizing versions). | |
div.style.cssText = "-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box;padding:1px;border:1px;display:block;width:4px;margin-top:1%;position:absolute;top:1%"; | |
// Workaround failing boxSizing test due to offsetWidth returning wrong value | |
// with some non-1 values of body zoom, ticket #13543 | |
jQuery.swap( body, body.style.zoom != null ? { zoom: 1 } : {}, function() { | |
support.boxSizing = div.offsetWidth === 4; | |
}); | |
// Use window.getComputedStyle because jsdom on node.js will break without it. | |
if ( window.getComputedStyle ) { | |
support.pixelPosition = ( window.getComputedStyle( div, null ) || {} ).top !== "1%"; | |
support.boxSizingReliable = ( window.getComputedStyle( div, null ) || { width: "4px" } ).width === "4px"; | |
// Support: Android 2.3 | |
// Check if div with explicit width and no margin-right incorrectly | |
// gets computed margin-right based on width of container. (#3333) | |
// WebKit Bug 13343 - getComputedStyle returns wrong value for margin-right | |
marginDiv = div.appendChild( document.createElement("div") ); | |
marginDiv.style.cssText = div.style.cssText = divReset; | |
marginDiv.style.marginRight = marginDiv.style.width = "0"; | |
div.style.width = "1px"; | |
support.reliableMarginRight = | |
!parseFloat( ( window.getComputedStyle( marginDiv, null ) || {} ).marginRight ); | |
} | |
body.removeChild( container ); | |
}); | |
return support; | |
})( {} ); | |
/* | |
Implementation Summary | |
1. Enforce API surface and semantic compatibility with 1.9.x branch | |
2. Improve the module's maintainability by reducing the storage | |
paths to a single mechanism. | |
3. Use the same single mechanism to support "private" and "user" data. | |
4. _Never_ expose "private" data to user code (TODO: Drop _data, _removeData) | |
5. Avoid exposing implementation details on user objects (eg. expando properties) | |
6. Provide a clear path for implementation upgrade to WeakMap in 2014 | |
*/ | |
var data_user, data_priv, | |
rbrace = /(?:\{[\s\S]*\}|\[[\s\S]*\])$/, | |
rmultiDash = /([A-Z])/g; | |
function Data() { | |
// Support: Android < 4, | |
// Old WebKit does not have Object.preventExtensions/freeze method, | |
// return new empty object instead with no [[set]] accessor | |
Object.defineProperty( this.cache = {}, 0, { | |
get: function() { | |
return {}; | |
} | |
}); | |
this.expando = jQuery.expando + Math.random(); | |
} | |
Data.uid = 1; | |
Data.accepts = function( owner ) { | |
// Accepts only: | |
// - Node | |
// - Node.ELEMENT_NODE | |
// - Node.DOCUMENT_NODE | |
// - Object | |
// - Any | |
return owner.nodeType ? | |
owner.nodeType === 1 || owner.nodeType === 9 : true; | |
}; | |
Data.prototype = { | |
key: function( owner ) { | |
// We can accept data for non-element nodes in modern browsers, | |
// but we should not, see #8335. | |
// Always return the key for a frozen object. | |
if ( !Data.accepts( owner ) ) { | |
return 0; | |
} | |
var descriptor = {}, | |
// Check if the owner object already has a cache key | |
unlock = owner[ this.expando ]; | |
// If not, create one | |
if ( !unlock ) { | |
unlock = Data.uid++; | |
// Secure it in a non-enumerable, non-writable property | |
try { | |
descriptor[ this.expando ] = { value: unlock }; | |
Object.defineProperties( owner, descriptor ); | |
// Support: Android < 4 | |
// Fallback to a less secure definition | |
} catch ( e ) { | |
descriptor[ this.expando ] = unlock; | |
jQuery.extend( owner, descriptor ); | |
} | |
} | |
// Ensure the cache object | |
if ( !this.cache[ unlock ] ) { | |
this.cache[ unlock ] = {}; | |
} | |
return unlock; | |
}, | |
set: function( owner, data, value ) { | |
var prop, | |
// There may be an unlock assigned to this node, | |
// if there is no entry for this "owner", create one inline | |
// and set the unlock as though an owner entry had always existed | |
unlock = this.key( owner ), | |
cache = this.cache[ unlock ]; | |
// Handle: [ owner, key, value ] args | |
if ( typeof data === "string" ) { | |
cache[ data ] = value; | |
// Handle: [ owner, { properties } ] args | |
} else { | |
// Fresh assignments by object are shallow copied | |
if ( jQuery.isEmptyObject( cache ) ) { | |
jQuery.extend( this.cache[ unlock ], data ); | |
// Otherwise, copy the properties one-by-one to the cache object | |
} else { | |
for ( prop in data ) { | |
cache[ prop ] = data[ prop ]; | |
} | |
} | |
} | |
return cache; | |
}, | |
get: function( owner, key ) { | |
// Either a valid cache is found, or will be created. | |
// New caches will be created and the unlock returned, | |
// allowing direct access to the newly created | |
// empty data object. A valid owner object must be provided. | |
var cache = this.cache[ this.key( owner ) ]; | |
return key === undefined ? | |
cache : cache[ key ]; | |
}, | |
access: function( owner, key, value ) { | |
var stored; | |
// In cases where either: | |
// | |
// 1. No key was specified | |
// 2. A string key was specified, but no value provided | |
// | |
// Take the "read" path and allow the get method to determine | |
// which value to return, respectively either: | |
// | |
// 1. The entire cache object | |
// 2. The data stored at the key | |
// | |
if ( key === undefined || | |
((key && typeof key === "string") && value === undefined) ) { | |
stored = this.get( owner, key ); | |
return stored !== undefined ? | |
stored : this.get( owner, jQuery.camelCase(key) ); | |
} | |
// [*]When the key is not a string, or both a key and value | |
// are specified, set or extend (existing objects) with either: | |
// | |
// 1. An object of properties | |
// 2. A key and value | |
// | |
this.set( owner, key, value ); | |
// Since the "set" path can have two possible entry points | |
// return the expected data based on which path was taken[*] | |
return value !== undefined ? value : key; | |
}, | |
remove: function( owner, key ) { | |
var i, name, camel, | |
unlock = this.key( owner ), | |
cache = this.cache[ unlock ]; | |
if ( key === undefined ) { | |
this.cache[ unlock ] = {}; | |
} else { | |
// Support array or space separated string of keys | |
if ( jQuery.isArray( key ) ) { | |
// If "name" is an array of keys... | |
// When data is initially created, via ("key", "val") signature, | |
// keys will be converted to camelCase. | |
// Since there is no way to tell _how_ a key was added, remove | |
// both plain key and camelCase key. #12786 | |
// This will only penalize the array argument path. | |
name = key.concat( key.map( jQuery.camelCase ) ); | |
} else { | |
camel = jQuery.camelCase( key ); | |
// Try the string as a key before any manipulation | |
if ( key in cache ) { | |
name = [ key, camel ]; | |
} else { | |
// If a key with the spaces exists, use it. | |
// Otherwise, create an array by matching non-whitespace | |
name = camel; | |
name = name in cache ? | |
[ name ] : ( name.match( core_rnotwhite ) || [] ); | |
} | |
} | |
i = name.length; | |
while ( i-- ) { | |
delete cache[ name[ i ] ]; | |
} | |
} | |
}, | |
hasData: function( owner ) { | |
return !jQuery.isEmptyObject( | |
this.cache[ owner[ this.expando ] ] || {} | |
); | |
}, | |
discard: function( owner ) { | |
if ( owner[ this.expando ] ) { | |
delete this.cache[ owner[ this.expando ] ]; | |
} | |
} | |
}; | |
// These may be used throughout the jQuery core codebase | |
data_user = new Data(); | |
data_priv = new Data(); | |
jQuery.extend({ | |
acceptData: Data.accepts, | |
hasData: function( elem ) { | |
return data_user.hasData( elem ) || data_priv.hasData( elem ); | |
}, | |
data: function( elem, name, data ) { | |
return data_user.access( elem, name, data ); | |
}, | |
removeData: function( elem, name ) { | |
data_user.remove( elem, name ); | |
}, | |
// TODO: Now that all calls to _data and _removeData have been replaced | |
// with direct calls to data_priv methods, these can be deprecated. | |
_data: function( elem, name, data ) { | |
return data_priv.access( elem, name, data ); | |
}, | |
_removeData: function( elem, name ) { | |
data_priv.remove( elem, name ); | |
} | |
}); | |
jQuery.fn.extend({ | |
data: function( key, value ) { | |
var attrs, name, | |
elem = this[ 0 ], | |
i = 0, | |
data = null; | |
// Gets all values | |
if ( key === undefined ) { | |
if ( this.length ) { | |
data = data_user.get( elem ); | |
if ( elem.nodeType === 1 && !data_priv.get( elem, "hasDataAttrs" ) ) { | |
attrs = elem.attributes; | |
for ( ; i < attrs.length; i++ ) { | |
name = attrs[ i ].name; | |
if ( name.indexOf( "data-" ) === 0 ) { | |
name = jQuery.camelCase( name.slice(5) ); | |
dataAttr( elem, name, data[ name ] ); | |
} | |
} | |
data_priv.set( elem, "hasDataAttrs", true ); | |
} | |
} | |
return data; | |
} | |
// Sets multiple values | |
if ( typeof key === "object" ) { | |
return this.each(function() { | |
data_user.set( this, key ); | |
}); | |
} | |
return jQuery.access( this, function( value ) { | |
var data, | |
camelKey = jQuery.camelCase( key ); | |
// The calling jQuery object (element matches) is not empty | |
// (and therefore has an element appears at this[ 0 ]) and the | |
// `value` parameter was not undefined. An empty jQuery object | |
// will result in `undefined` for elem = this[ 0 ] which will | |
// throw an exception if an attempt to read a data cache is made. | |
if ( elem && value === undefined ) { | |
// Attempt to get data from the cache | |
// with the key as-is | |
data = data_user.get( elem, key ); | |
if ( data !== undefined ) { | |
return data; | |
} | |
// Attempt to get data from the cache | |
// with the key camelized | |
data = data_user.get( elem, camelKey ); | |
if ( data !== undefined ) { | |
return data; | |
} | |
// Attempt to "discover" the data in | |
// HTML5 custom data-* attrs | |
data = dataAttr( elem, camelKey, undefined ); | |
if ( data !== undefined ) { | |
return data; | |
} | |
// We tried really hard, but the data doesn't exist. | |
return; | |
} | |
// Set the data... | |
this.each(function() { | |
// First, attempt to store a copy or reference of any | |
// data that might've been store with a camelCased key. | |
var data = data_user.get( this, camelKey ); | |
// For HTML5 data-* attribute interop, we have to | |
// store property names with dashes in a camelCase form. | |
// This might not apply to all properties...* | |
data_user.set( this, camelKey, value ); | |
// *... In the case of properties that might _actually_ | |
// have dashes, we need to also store a copy of that | |
// unchanged property. | |
if ( key.indexOf("-") !== -1 && data !== undefined ) { | |
data_user.set( this, key, value ); | |
} | |
}); | |
}, null, value, arguments.length > 1, null, true ); | |
}, | |
removeData: function( key ) { | |
return this.each(function() { | |
data_user.remove( this, key ); | |
}); | |
} | |
}); | |
function dataAttr( elem, key, data ) { | |
var name; | |
// If nothing was found internally, try to fetch any | |
// data from the HTML5 data-* attribute | |
if ( data === undefined && elem.nodeType === 1 ) { | |
name = "data-" + key.replace( rmultiDash, "-$1" ).toLowerCase(); | |
data = elem.getAttribute( name ); | |
if ( typeof data === "string" ) { | |
try { | |
data = data === "true" ? true : | |
data === "false" ? false : | |
data === "null" ? null : | |
// Only convert to a number if it doesn't change the string | |
+data + "" === data ? +data : | |
rbrace.test( data ) ? JSON.parse( data ) : | |
data; | |
} catch( e ) {} | |
// Make sure we set the data so it isn't changed later | |
data_user.set( elem, key, data ); | |
} else { | |
data = undefined; | |
} | |
} | |
return data; | |
} | |
jQuery.extend({ | |
queue: function( elem, type, data ) { | |
var queue; | |
if ( elem ) { | |
type = ( type || "fx" ) + "queue"; | |
queue = data_priv.get( elem, type ); | |
// Speed up dequeue by getting out quickly if this is just a lookup | |
if ( data ) { | |
if ( !queue || jQuery.isArray( data ) ) { | |
queue = data_priv.access( elem, type, jQuery.makeArray(data) ); | |
} else { | |
queue.push( data ); | |
} | |
} | |
return queue || []; | |
} | |
}, | |
dequeue: function( elem, type ) { | |
type = type || "fx"; | |
var queue = jQuery.queue( elem, type ), | |
startLength = queue.length, | |
fn = queue.shift(), | |
hooks = jQuery._queueHooks( elem, type ), | |
next = function() { | |
jQuery.dequeue( elem, type ); | |
}; | |
// If the fx queue is dequeued, always remove the progress sentinel | |
if ( fn === "inprogress" ) { | |
fn = queue.shift(); | |
startLength--; | |
} | |
if ( fn ) { | |
// Add a progress sentinel to prevent the fx queue from being | |
// automatically dequeued | |
if ( type === "fx" ) { | |
queue.unshift( "inprogress" ); | |
} | |
// clear up the last queue stop function | |
delete hooks.stop; | |
fn.call( elem, next, hooks ); | |
} | |
if ( !startLength && hooks ) { | |
hooks.empty.fire(); | |
} | |
}, | |
// not intended for public consumption - generates a queueHooks object, or returns the current one | |
_queueHooks: function( elem, type ) { | |
var key = type + "queueHooks"; | |
return data_priv.get( elem, key ) || data_priv.access( elem, key, { | |
empty: jQuery.Callbacks("once memory").add(function() { | |
data_priv.remove( elem, [ type + "queue", key ] ); | |
}) | |
}); | |
} | |
}); | |
jQuery.fn.extend({ | |
queue: function( type, data ) { | |
var setter = 2; | |
if ( typeof type !== "string" ) { | |
data = type; | |
type = "fx"; | |
setter--; | |
} | |
if ( arguments.length < setter ) { | |
return jQuery.queue( this[0], type ); | |
} | |
return data === undefined ? | |
this : | |
this.each(function() { | |
var queue = jQuery.queue( this, type, data ); | |
// ensure a hooks for this queue | |
jQuery._queueHooks( this, type ); | |
if ( type === "fx" && queue[0] !== "inprogress" ) { | |
jQuery.dequeue( this, type ); | |
} | |
}); | |
}, | |
dequeue: function( type ) { | |
return this.each(function() { | |
jQuery.dequeue( this, type ); | |
}); | |
}, | |
// Based off of the plugin by Clint Helfers, with permission. | |
// http://blindsignals.com/index.php/2009/07/jquery-delay/ | |
delay: function( time, type ) { | |
time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time; | |
type = type || "fx"; | |
return this.queue( type, function( next, hooks ) { | |
var timeout = setTimeout( next, time ); | |
hooks.stop = function() { | |
clearTimeout( timeout ); | |
}; | |
}); | |
}, | |
clearQueue: function( type ) { | |
return this.queue( type || "fx", [] ); | |
}, | |
// Get a promise resolved when queues of a certain type | |
// are emptied (fx is the type by default) | |
promise: function( type, obj ) { | |
var tmp, | |
count = 1, | |
defer = jQuery.Deferred(), | |
elements = this, | |
i = this.length, | |
resolve = function() { | |
if ( !( --count ) ) { | |
defer.resolveWith( elements, [ elements ] ); | |
} | |
}; | |
if ( typeof type !== "string" ) { | |
obj = type; | |
type = undefined; | |
} | |
type = type || "fx"; | |
while( i-- ) { | |
tmp = data_priv.get( elements[ i ], type + "queueHooks" ); | |
if ( tmp && tmp.empty ) { | |
count++; | |
tmp.empty.add( resolve ); | |
} | |
} | |
resolve(); | |
return defer.promise( obj ); | |
} | |
}); | |
var nodeHook, boolHook, | |
rclass = /[\t\r\n\f]/g, | |
rreturn = /\r/g, | |
rfocusable = /^(?:input|select|textarea|button)$/i; | |
jQuery.fn.extend({ | |
attr: function( name, value ) { | |
return jQuery.access( this, jQuery.attr, name, value, arguments.length > 1 ); | |
}, | |
removeAttr: function( name ) { | |
return this.each(function() { | |
jQuery.removeAttr( this, name ); | |
}); | |
}, | |
prop: function( name, value ) { | |
return jQuery.access( this, jQuery.prop, name, value, arguments.length > 1 ); | |
}, | |
removeProp: function( name ) { | |
return this.each(function() { | |
delete this[ jQuery.propFix[ name ] || name ]; | |
}); | |
}, | |
addClass: function( value ) { | |
var classes, elem, cur, clazz, j, | |
i = 0, | |
len = this.length, | |
proceed = typeof value === "string" && value; | |
if ( jQuery.isFunction( value ) ) { | |
return this.each(function( j ) { | |
jQuery( this ).addClass( value.call( this, j, this.className ) ); | |
}); | |
} | |
if ( proceed ) { | |
// The disjunction here is for better compressibility (see removeClass) | |
classes = ( value || "" ).match( core_rnotwhite ) || []; | |
for ( ; i < len; i++ ) { | |
elem = this[ i ]; | |
cur = elem.nodeType === 1 && ( elem.className ? | |
( " " + elem.className + " " ).replace( rclass, " " ) : | |
" " | |
); | |
if ( cur ) { | |
j = 0; | |
while ( (clazz = classes[j++]) ) { | |
if ( cur.indexOf( " " + clazz + " " ) < 0 ) { | |
cur += clazz + " "; | |
} | |
} | |
elem.className = jQuery.trim( cur ); | |
} | |
} | |
} | |
return this; | |
}, | |
removeClass: function( value ) { | |
var classes, elem, cur, clazz, j, | |
i = 0, | |
len = this.length, | |
proceed = arguments.length === 0 || typeof value === "string" && value; | |
if ( jQuery.isFunction( value ) ) { | |
return this.each(function( j ) { | |
jQuery( this ).removeClass( value.call( this, j, this.className ) ); | |
}); | |
} | |
if ( proceed ) { | |
classes = ( value || "" ).match( core_rnotwhite ) || []; | |
for ( ; i < len; i++ ) { | |
elem = this[ i ]; | |
// This expression is here for better compressibility (see addClass) | |
cur = elem.nodeType === 1 && ( elem.className ? | |
( " " + elem.className + " " ).replace( rclass, " " ) : | |
"" | |
); | |
if ( cur ) { | |
j = 0; | |
while ( (clazz = classes[j++]) ) { | |
// Remove *all* instances | |
while ( cur.indexOf( " " + clazz + " " ) >= 0 ) { | |
cur = cur.replace( " " + clazz + " ", " " ); | |
} | |
} | |
elem.className = value ? jQuery.trim( cur ) : ""; | |
} | |
} | |
} | |
return this; | |
}, | |
toggleClass: function( value, stateVal ) { | |
var type = typeof value; | |
if ( typeof stateVal === "boolean" && type === "string" ) { | |
return stateVal ? this.addClass( value ) : this.removeClass( value ); | |
} | |
if ( jQuery.isFunction( value ) ) { | |
return this.each(function( i ) { | |
jQuery( this ).toggleClass( value.call(this, i, this.className, stateVal), stateVal ); | |
}); | |
} | |
return this.each(function() { | |
if ( type === "string" ) { | |
// toggle individual class names | |
var className, | |
i = 0, | |
self = jQuery( this ), | |
classNames = value.match( core_rnotwhite ) || []; | |
while ( (className = classNames[ i++ ]) ) { | |
// check each className given, space separated list | |
if ( self.hasClass( className ) ) { | |
self.removeClass( className ); | |
} else { | |
self.addClass( className ); | |
} | |
} | |
// Toggle whole class name | |
} else if ( type === core_strundefined || type === "boolean" ) { | |
if ( this.className ) { | |
// store className if set | |
data_priv.set( this, "__className__", this.className ); | |
} | |
// If the element has a class name or if we're passed "false", | |
// then remove the whole classname (if there was one, the above saved it). | |
// Otherwise bring back whatever was previously saved (if anything), | |
// falling back to the empty string if nothing was stored. | |
this.className = this.className || value === false ? "" : data_priv.get( this, "__className__" ) || ""; | |
} | |
}); | |
}, | |
hasClass: function( selector ) { | |
var className = " " + selector + " ", | |
i = 0, | |
l = this.length; | |
for ( ; i < l; i++ ) { | |
if ( this[i].nodeType === 1 && (" " + this[i].className + " ").replace(rclass, " ").indexOf( className ) >= 0 ) { | |
return true; | |
} | |
} | |
return false; | |
}, | |
val: function( value ) { | |
var hooks, ret, isFunction, | |
elem = this[0]; | |
if ( !arguments.length ) { | |
if ( elem ) { | |
hooks = jQuery.valHooks[ elem.type ] || jQuery.valHooks[ elem.nodeName.toLowerCase() ]; | |
if ( hooks && "get" in hooks && (ret = hooks.get( elem, "value" )) !== undefined ) { | |
return ret; | |
} | |
ret = elem.value; | |
return typeof ret === "string" ? | |
// handle most common string cases | |
ret.replace(rreturn, "") : | |
// handle cases where value is null/undef or number | |
ret == null ? "" : ret; | |
} | |
return; | |
} | |
isFunction = jQuery.isFunction( value ); | |
return this.each(function( i ) { | |
var val; | |
if ( this.nodeType !== 1 ) { | |
return; | |
} | |
if ( isFunction ) { | |
val = value.call( this, i, jQuery( this ).val() ); | |
} else { | |
val = value; | |
} | |
// Treat null/undefined as ""; convert numbers to string | |
if ( val == null ) { | |
val = ""; | |
} else if ( typeof val === "number" ) { | |
val += ""; | |
} else if ( jQuery.isArray( val ) ) { | |
val = jQuery.map(val, function ( value ) { | |
return value == null ? "" : value + ""; | |
}); | |
} | |
hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; | |
// If set returns undefined, fall back to normal setting | |
if ( !hooks || !("set" in hooks) || hooks.set( this, val, "value" ) === undefined ) { | |
this.value = val; | |
} | |
}); | |
} | |
}); | |
jQuery.extend({ | |
valHooks: { | |
option: { | |
get: function( elem ) { | |
// attributes.value is undefined in Blackberry 4.7 but | |
// uses .value. See #6932 | |
var val = elem.attributes.value; | |
return !val || val.specified ? elem.value : elem.text; | |
} | |
}, | |
select: { | |
get: function( elem ) { | |
var value, option, | |
options = elem.options, | |
index = elem.selectedIndex, | |
one = elem.type === "select-one" || index < 0, | |
values = one ? null : [], | |
max = one ? index + 1 : options.length, | |
i = index < 0 ? | |
max : | |
one ? index : 0; | |
// Loop through all the selected options | |
for ( ; i < max; i++ ) { | |
option = options[ i ]; | |
// IE6-9 doesn't update selected after form reset (#2551) | |
if ( ( option.selected || i === index ) && | |
// Don't return options that are disabled or in a disabled optgroup | |
( jQuery.support.optDisabled ? !option.disabled : option.getAttribute("disabled") === null ) && | |
( !option.parentNode.disabled || !jQuery.nodeName( option.parentNode, "optgroup" ) ) ) { | |
// Get the specific value for the option | |
value = jQuery( option ).val(); | |
// We don't need an array for one selects | |
if ( one ) { | |
return value; | |
} | |
// Multi-Selects return an array | |
values.push( value ); | |
} | |
} | |
return values; | |
}, | |
set: function( elem, value ) { | |
var optionSet, option, | |
options = elem.options, | |
values = jQuery.makeArray( value ), | |
i = options.length; | |
while ( i-- ) { | |
option = options[ i ]; | |
if ( (option.selected = jQuery.inArray( jQuery(option).val(), values ) >= 0) ) { | |
optionSet = true; | |
} | |
} | |
// force browsers to behave consistently when non-matching value is set | |
if ( !optionSet ) { | |
elem.selectedIndex = -1; | |
} | |
return values; | |
} | |
} | |
}, | |
attr: function( elem, name, value ) { | |
var hooks, ret, | |
nType = elem.nodeType; | |
// don't get/set attributes on text, comment and attribute nodes | |
if ( !elem || nType === 3 || nType === 8 || nType === 2 ) { | |
return; | |
} | |
// Fallback to prop when attributes are not supported | |
if ( typeof elem.getAttribute === core_strundefined ) { | |
return jQuery.prop( elem, name, value ); | |
} | |
// All attributes are lowercase | |
// Grab necessary hook if one is defined | |
if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { | |
name = name.toLowerCase(); | |
hooks = jQuery.attrHooks[ name ] || | |
( jQuery.expr.match.bool.test( name ) ? boolHook : nodeHook ); | |
} | |
if ( value !== undefined ) { | |
if ( value === null ) { | |
jQuery.removeAttr( elem, name ); | |
} else if ( hooks && "set" in hooks && (ret = hooks.set( elem, value, name )) !== undefined ) { | |
return ret; | |
} else { | |
elem.setAttribute( name, value + "" ); | |
return value; | |
} | |
} else if ( hooks && "get" in hooks && (ret = hooks.get( elem, name )) !== null ) { | |
return ret; | |
} else { | |
ret = jQuery.find.attr( elem, name ); | |
// Non-existent attributes return null, we normalize to undefined | |
return ret == null ? | |
undefined : | |
ret; | |
} | |
}, | |
removeAttr: function( elem, value ) { | |
var name, propName, | |
i = 0, | |
attrNames = value && value.match( core_rnotwhite ); | |
if ( attrNames && elem.nodeType === 1 ) { | |
while ( (name = attrNames[i++]) ) { | |
propName = jQuery.propFix[ name ] || name; | |
// Boolean attributes get special treatment (#10870) | |
if ( jQuery.expr.match.bool.test( name ) ) { | |
// Set corresponding property to false | |
elem[ propName ] = false; | |
} | |
elem.removeAttribute( name ); | |
} | |
} | |
}, | |
attrHooks: { | |
type: { | |
set: function( elem, value ) { | |
if ( !jQuery.support.radioValue && value === "radio" && jQuery.nodeName(elem, "input") ) { | |
// Setting the type on a radio button after the value resets the value in IE6-9 | |
// Reset value to default in case type is set after value during creation | |
var val = elem.value; | |
elem.setAttribute( "type", value ); | |
if ( val ) { | |
elem.value = val; | |
} | |
return value; | |
} | |
} | |
} | |
}, | |
propFix: { | |
"for": "htmlFor", | |
"class": "className" | |
}, | |
prop: function( elem, name, value ) { | |
var ret, hooks, notxml, | |
nType = elem.nodeType; | |
// don't get/set properties on text, comment and attribute nodes | |
if ( !elem || nType === 3 || nType === 8 || nType === 2 ) { | |
return; | |
} | |
notxml = nType !== 1 || !jQuery.isXMLDoc( elem ); | |
if ( notxml ) { | |
// Fix name and attach hooks | |
name = jQuery.propFix[ name ] || name; | |
hooks = jQuery.propHooks[ name ]; | |
} | |
if ( value !== undefined ) { | |
return hooks && "set" in hooks && (ret = hooks.set( elem, value, name )) !== undefined ? | |
ret : | |
( elem[ name ] = value ); | |
} else { | |
return hooks && "get" in hooks && (ret = hooks.get( elem, name )) !== null ? | |
ret : | |
elem[ name ]; | |
} | |
}, | |
propHooks: { | |
tabIndex: { | |
get: function( elem ) { | |
return elem.hasAttribute( "tabindex" ) || rfocusable.test( elem.nodeName ) || elem.href ? | |
elem.tabIndex : | |
-1; | |
} | |
} | |
} | |
}); | |
// Hooks for boolean attributes | |
boolHook = { | |
set: function( elem, value, name ) { | |
if ( value === false ) { | |
// Remove boolean attributes when set to false | |
jQuery.removeAttr( elem, name ); | |
} else { | |
elem.setAttribute( name, name ); | |
} | |
return name; | |
} | |
}; | |
jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( i, name ) { | |
var getter = jQuery.expr.attrHandle[ name ] || jQuery.find.attr; | |
jQuery.expr.attrHandle[ name ] = function( elem, name, isXML ) { | |
var fn = jQuery.expr.attrHandle[ name ], | |
ret = isXML ? | |
undefined : | |
/* jshint eqeqeq: false */ | |
// Temporarily disable this handler to check existence | |
(jQuery.expr.attrHandle[ name ] = undefined) != | |
getter( elem, name, isXML ) ? | |
name.toLowerCase() : | |
null; | |
// Restore handler | |
jQuery.expr.attrHandle[ name ] = fn; | |
return ret; | |
}; | |
}); | |
// Support: IE9+ | |
// Selectedness for an option in an optgroup can be inaccurate | |
if ( !jQuery.support.optSelected ) { | |
jQuery.propHooks.selected = { | |
get: function( elem ) { | |
var parent = elem.parentNode; | |
if ( parent && parent.parentNode ) { | |
parent.parentNode.selectedIndex; | |
} | |
return null; | |
} | |
}; | |
} | |
jQuery.each([ | |
"tabIndex", | |
"readOnly", | |
"maxLength", | |
"cellSpacing", | |
"cellPadding", | |
"rowSpan", | |
"colSpan", | |
"useMap", | |
"frameBorder", | |
"contentEditable" | |
], function() { | |
jQuery.propFix[ this.toLowerCase() ] = this; | |
}); | |
// Radios and checkboxes getter/setter | |
jQuery.each([ "radio", "checkbox" ], function() { | |
jQuery.valHooks[ this ] = { | |
set: function( elem, value ) { | |
if ( jQuery.isArray( value ) ) { | |
return ( elem.checked = jQuery.inArray( jQuery(elem).val(), value ) >= 0 ); | |
} | |
} | |
}; | |
if ( !jQuery.support.checkOn ) { | |
jQuery.valHooks[ this ].get = function( elem ) { | |
// Support: Webkit | |
// "" is returned instead of "on" if a value isn't specified | |
return elem.getAttribute("value") === null ? "on" : elem.value; | |
}; | |
} | |
}); | |
var rkeyEvent = /^key/, | |
rmouseEvent = /^(?:mouse|contextmenu)|click/, | |
rfocusMorph = /^(?:focusinfocus|focusoutblur)$/, | |
rtypenamespace = /^([^.]*)(?:\.(.+)|)$/; | |
function returnTrue() { | |
return true; | |
} | |
function returnFalse() { | |
return false; | |
} | |
function safeActiveElement() { | |
try { | |
return document.activeElement; | |
} catch ( err ) { } | |
} | |
/* | |
* Helper functions for managing events -- not part of the public interface. | |
* Props to Dean Edwards' addEvent library for many of the ideas. | |
*/ | |
jQuery.event = { | |
global: {}, | |
add: function( elem, types, handler, data, selector ) { | |
var handleObjIn, eventHandle, tmp, | |
events, t, handleObj, | |
special, handlers, type, namespaces, origType, | |
elemData = data_priv.get( elem ); | |
// Don't attach events to noData or text/comment nodes (but allow plain objects) | |
if ( !elemData ) { | |
return; | |
} | |
// Caller can pass in an object of custom data in lieu of the handler | |
if ( handler.handler ) { | |
handleObjIn = handler; | |
handler = handleObjIn.handler; | |
selector = handleObjIn.selector; | |
} | |
// Make sure that the handler has a unique ID, used to find/remove it later | |
if ( !handler.guid ) { | |
handler.guid = jQuery.guid++; | |
} | |
// Init the element's event structure and main handler, if this is the first | |
if ( !(events = elemData.events) ) { | |
events = elemData.events = {}; | |
} | |
if ( !(eventHandle = elemData.handle) ) { | |
eventHandle = elemData.handle = function( e ) { | |
// Discard the second event of a jQuery.event.trigger() and | |
// when an event is called after a page has unloaded | |
return typeof jQuery !== core_strundefined && (!e || jQuery.event.triggered !== e.type) ? | |
jQuery.event.dispatch.apply( eventHandle.elem, arguments ) : | |
undefined; | |
}; | |
// Add elem as a property of the handle fn to prevent a memory leak with IE non-native events | |
eventHandle.elem = elem; | |
} | |
// Handle multiple events separated by a space | |
types = ( types || "" ).match( core_rnotwhite ) || [""]; | |
t = types.length; | |
while ( t-- ) { | |
tmp = rtypenamespace.exec( types[t] ) || []; | |
type = origType = tmp[1]; | |
namespaces = ( tmp[2] || "" ).split( "." ).sort(); | |
// There *must* be a type, no attaching namespace-only handlers | |
if ( !type ) { | |
continue; | |
} | |
// If event changes its type, use the special event handlers for the changed type | |
special = jQuery.event.special[ type ] || {}; | |
// If selector defined, determine special event api type, otherwise given type | |
type = ( selector ? special.delegateType : special.bindType ) || type; | |
// Update special based on newly reset type | |
special = jQuery.event.special[ type ] || {}; | |
// handleObj is passed to all event handlers | |
handleObj = jQuery.extend({ | |
type: type, | |
origType: origType, | |
data: data, | |
handler: handler, | |
guid: handler.guid, | |
selector: selector, | |
needsContext: selector && jQuery.expr.match.needsContext.test( selector ), | |
namespace: namespaces.join(".") | |
}, handleObjIn ); | |
// Init the event handler queue if we're the first | |
if ( !(handlers = events[ type ]) ) { | |
handlers = events[ type ] = []; | |
handlers.delegateCount = 0; | |
// Only use addEventListener if the special events handler returns false | |
if ( !special.setup || special.setup.call( elem, data, namespaces, eventHandle ) === false ) { | |
if ( elem.addEventListener ) { | |
elem.addEventListener( type, eventHandle, false ); | |
} | |
} | |
} | |
if ( special.add ) { | |
special.add.call( elem, handleObj ); | |
if ( !handleObj.handler.guid ) { | |
handleObj.handler.guid = handler.guid; | |
} | |
} | |
// Add to the element's handler list, delegates in front | |
if ( selector ) { | |
handlers.splice( handlers.delegateCount++, 0, handleObj ); | |
} else { | |
handlers.push( handleObj ); | |
} | |
// Keep track of which events have ever been used, for event optimization | |
jQuery.event.global[ type ] = true; | |
} | |
// Nullify elem to prevent memory leaks in IE | |
elem = null; | |
}, | |
// Detach an event or set of events from an element | |
remove: function( elem, types, handler, selector, mappedTypes ) { | |
var j, origCount, tmp, | |
events, t, handleObj, | |
special, handlers, type, namespaces, origType, | |
elemData = data_priv.hasData( elem ) && data_priv.get( elem ); | |
if ( !elemData || !(events = elemData.events) ) { | |
return; | |
} | |
// Once for each type.namespace in types; type may be omitted | |
types = ( types || "" ).match( core_rnotwhite ) || [""]; | |
t = types.length; | |
while ( t-- ) { | |
tmp = rtypenamespace.exec( types[t] ) || []; | |
type = origType = tmp[1]; | |
namespaces = ( tmp[2] || "" ).split( "." ).sort(); | |
// Unbind all events (on this namespace, if provided) for the element | |
if ( !type ) { | |
for ( type in events ) { | |
jQuery.event.remove( elem, type + types[ t ], handler, selector, true ); | |
} | |
continue; | |
} | |
special = jQuery.event.special[ type ] || {}; | |
type = ( selector ? special.delegateType : special.bindType ) || type; | |
handlers = events[ type ] || []; | |
tmp = tmp[2] && new RegExp( "(^|\\.)" + namespaces.join("\\.(?:.*\\.|)") + "(\\.|$)" ); | |
// Remove matching events | |
origCount = j = handlers.length; | |
while ( j-- ) { | |
handleObj = handlers[ j ]; | |
if ( ( mappedTypes || origType === handleObj.origType ) && | |
( !handler || handler.guid === handleObj.guid ) && | |
( !tmp || tmp.test( handleObj.namespace ) ) && | |
( !selector || selector === handleObj.selector || selector === "**" && handleObj.selector ) ) { | |
handlers.splice( j, 1 ); | |
if ( handleObj.selector ) { | |
handlers.delegateCount--; | |
} | |
if ( special.remove ) { | |
special.remove.call( elem, handleObj ); | |
} | |
} | |
} | |
// Remove generic event handler if we removed something and no more handlers exist | |
// (avoids potential for endless recursion during removal of special event handlers) | |
if ( origCount && !handlers.length ) { | |
if ( !special.teardown || special.teardown.call( elem, namespaces, elemData.handle ) === false ) { | |
jQuery.removeEvent( elem, type, elemData.handle ); | |
} | |
delete events[ type ]; | |
} | |
} | |
// Remove the expando if it's no longer used | |
if ( jQuery.isEmptyObject( events ) ) { | |
delete elemData.handle; | |
data_priv.remove( elem, "events" ); | |
} | |
}, | |
trigger: function( event, data, elem, onlyHandlers ) { | |
var i, cur, tmp, bubbleType, ontype, handle, special, | |
eventPath = [ elem || document ], | |
type = core_hasOwn.call( event, "type" ) ? event.type : event, | |
namespaces = core_hasOwn.call( event, "namespace" ) ? event.namespace.split(".") : []; | |
cur = tmp = elem = elem || document; | |
// Don't do events on text and comment nodes | |
if ( elem.nodeType === 3 || elem.nodeType === 8 ) { | |
return; | |
} | |
// focus/blur morphs to focusin/out; ensure we're not firing them right now | |
if ( rfocusMorph.test( type + jQuery.event.triggered ) ) { | |
return; | |
} | |
if ( type.indexOf(".") >= 0 ) { | |
// Namespaced trigger; create a regexp to match event type in handle() | |
namespaces = type.split("."); | |
type = namespaces.shift(); | |
namespaces.sort(); | |
} | |
ontype = type.indexOf(":") < 0 && "on" + type; | |
// Caller can pass in a jQuery.Event object, Object, or just an event type string | |
event = event[ jQuery.expando ] ? | |
event : | |
new jQuery.Event( type, typeof event === "object" && event ); | |
// Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true) | |
event.isTrigger = onlyHandlers ? 2 : 3; | |
event.namespace = namespaces.join("."); | |
event.namespace_re = event.namespace ? | |
new RegExp( "(^|\\.)" + namespaces.join("\\.(?:.*\\.|)") + "(\\.|$)" ) : | |
null; | |
// Clean up the event in case it is being reused | |
event.result = undefined; | |
if ( !event.target ) { | |
event.target = elem; | |
} | |
// Clone any incoming data and prepend the event, creating the handler arg list | |
data = data == null ? | |
[ event ] : | |
jQuery.makeArray( data, [ event ] ); | |
// Allow special events to draw outside the lines | |
special = jQuery.event.special[ type ] || {}; | |
if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) { | |
return; | |
} | |
// Determine event propagation path in advance, per W3C events spec (#9951) | |
// Bubble up to document, then to window; watch for a global ownerDocument var (#9724) | |
if ( !onlyHandlers && !special.noBubble && !jQuery.isWindow( elem ) ) { | |
bubbleType = special.delegateType || type; | |
if ( !rfocusMorph.test( bubbleType + type ) ) { | |
cur = cur.parentNode; | |
} | |
for ( ; cur; cur = cur.parentNode ) { | |
eventPath.push( cur ); | |
tmp = cur; | |
} | |
// Only add window if we got to document (e.g., not plain obj or detached DOM) | |
if ( tmp === (elem.ownerDocument || document) ) { | |
eventPath.push( tmp.defaultView || tmp.parentWindow || window ); | |
} | |
} | |
// Fire handlers on the event path | |
i = 0; | |
while ( (cur = eventPath[i++]) && !event.isPropagationStopped() ) { | |
event.type = i > 1 ? | |
bubbleType : | |
special.bindType || type; | |
// jQuery handler | |
handle = ( data_priv.get( cur, "events" ) || {} )[ event.type ] && data_priv.get( cur, "handle" ); | |
if ( handle ) { | |
handle.apply( cur, data ); | |
} | |
// Native handler | |
handle = ontype && cur[ ontype ]; | |
if ( handle && jQuery.acceptData( cur ) && handle.apply && handle.apply( cur, data ) === false ) { | |
event.preventDefault(); | |
} | |
} | |
event.type = type; | |
// If nobody prevented the default action, do it now | |
if ( !onlyHandlers && !event.isDefaultPrevented() ) { | |
if ( (!special._default || special._default.apply( eventPath.pop(), data ) === false) && | |
jQuery.acceptData( elem ) ) { | |
// Call a native DOM method on the target with the same name name as the event. | |
// Don't do default actions on window, that's where global variables be (#6170) | |
if ( ontype && jQuery.isFunction( elem[ type ] ) && !jQuery.isWindow( elem ) ) { | |
// Don't re-trigger an onFOO event when we call its FOO() method | |
tmp = elem[ ontype ]; | |
if ( tmp ) { | |
elem[ ontype ] = null; | |
} | |
// Prevent re-triggering of the same event, since we already bubbled it above | |
jQuery.event.triggered = type; | |
elem[ type ](); | |
jQuery.event.triggered = undefined; | |
if ( tmp ) { | |
elem[ ontype ] = tmp; | |
} | |
} | |
} | |
} | |
return event.result; | |
}, | |
dispatch: function( event ) { | |
// Make a writable jQuery.Event from the native event object | |
event = jQuery.event.fix( event ); | |
var i, j, ret, matched, handleObj, | |
handlerQueue = [], | |
args = core_slice.call( arguments ), | |
handlers = ( data_priv.get( this, "events" ) || {} )[ event.type ] || [], | |
special = jQuery.event.special[ event.type ] || {}; | |
// Use the fix-ed jQuery.Event rather than the (read-only) native event | |
args[0] = event; | |
event.delegateTarget = this; | |
// Call the preDispatch hook for the mapped type, and let it bail if desired | |
if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) { | |
return; | |
} | |
// Determine handlers | |
handlerQueue = jQuery.event.handlers.call( this, event, handlers ); | |
// Run delegates first; they may want to stop propagation beneath us | |
i = 0; | |
while ( (matched = handlerQueue[ i++ ]) && !event.isPropagationStopped() ) { | |
event.currentTarget = matched.elem; | |
j = 0; | |
while ( (handleObj = matched.handlers[ j++ ]) && !event.isImmediatePropagationStopped() ) { | |
// Triggered event must either 1) have no namespace, or | |
// 2) have namespace(s) a subset or equal to those in the bound event (both can have no namespace). | |
if ( !event.namespace_re || event.namespace_re.test( handleObj.namespace ) ) { | |
event.handleObj = handleObj; | |
event.data = handleObj.data; | |
ret = ( (jQuery.event.special[ handleObj.origType ] || {}).handle || handleObj.handler ) | |
.apply( matched.elem, args ); | |
if ( ret !== undefined ) { | |
if ( (event.result = ret) === false ) { | |
event.preventDefault(); | |
event.stopPropagation(); | |
} | |
} | |
} | |
} | |
} | |
// Call the postDispatch hook for the mapped type | |
if ( special.postDispatch ) { | |
special.postDispatch.call( this, event ); | |
} | |
return event.result; | |
}, | |
handlers: function( event, handlers ) { | |
var i, matches, sel, handleObj, | |
handlerQueue = [], | |
delegateCount = handlers.delegateCount, | |
cur = event.target; | |
// Find delegate handlers | |
// Black-hole SVG <use> instance trees (#13180) | |
// Avoid non-left-click bubbling in Firefox (#3861) | |
if ( delegateCount && cur.nodeType && (!event.button || event.type !== "click") ) { | |
for ( ; cur !== this; cur = cur.parentNode || this ) { | |
// Don't process clicks on disabled elements (#6911, #8165, #11382, #11764) | |
if ( cur.disabled !== true || event.type !== "click" ) { | |
matches = []; | |
for ( i = 0; i < delegateCount; i++ ) { | |
handleObj = handlers[ i ]; | |
// Don't conflict with Object.prototype properties (#13203) | |
sel = handleObj.selector + " "; | |
if ( matches[ sel ] === undefined ) { | |
matches[ sel ] = handleObj.needsContext ? | |
jQuery( sel, this ).index( cur ) >= 0 : | |
jQuery.find( sel, this, null, [ cur ] ).length; | |
} | |
if ( matches[ sel ] ) { | |
matches.push( handleObj ); | |
} | |
} | |
if ( matches.length ) { | |
handlerQueue.push({ elem: cur, handlers: matches }); | |
} | |
} | |
} | |
} | |
// Add the remaining (directly-bound) handlers | |
if ( delegateCount < handlers.length ) { | |
handlerQueue.push({ elem: this, handlers: handlers.slice( delegateCount ) }); | |
} | |
return handlerQueue; | |
}, | |
// Includes some event props shared by KeyEvent and MouseEvent | |
props: "altKey bubbles cancelable ctrlKey currentTarget eventPhase metaKey relatedTarget shiftKey target timeStamp view which".split(" "), | |
fixHooks: {}, | |
keyHooks: { | |
props: "char charCode key keyCode".split(" "), | |
filter: function( event, original ) { | |
// Add which for key events | |
if ( event.which == null ) { | |
event.which = original.charCode != null ? original.charCode : original.keyCode; | |
} | |
return event; | |
} | |
}, | |
mouseHooks: { | |
props: "button buttons clientX clientY offsetX offsetY pageX pageY screenX screenY toElement".split(" "), | |
filter: function( event, original ) { | |
var eventDoc, doc, body, | |
button = original.button; | |
// Calculate pageX/Y if missing and clientX/Y available | |
if ( event.pageX == null && original.clientX != null ) { | |
eventDoc = event.target.ownerDocument || document; | |
doc = eventDoc.documentElement; | |
body = eventDoc.body; | |
event.pageX = original.clientX + ( doc && doc.scrollLeft || body && body.scrollLeft || 0 ) - ( doc && doc.clientLeft || body && body.clientLeft || 0 ); | |
event.pageY = original.clientY + ( doc && doc.scrollTop || body && body.scrollTop || 0 ) - ( doc && doc.clientTop || body && body.clientTop || 0 ); | |
} | |
// Add which for click: 1 === left; 2 === middle; 3 === right | |
// Note: button is not normalized, so don't use it | |
if ( !event.which && button !== undefined ) { | |
event.which = ( button & 1 ? 1 : ( button & 2 ? 3 : ( button & 4 ? 2 : 0 ) ) ); | |
} | |
return event; | |
} | |
}, | |
fix: function( event ) { | |
if ( event[ jQuery.expando ] ) { | |
return event; | |
} | |
// Create a writable copy of the event object and normalize some properties | |
var i, prop, copy, | |
type = event.type, | |
originalEvent = event, | |
fixHook = this.fixHooks[ type ]; | |
if ( !fixHook ) { | |
this.fixHooks[ type ] = fixHook = | |
rmouseEvent.test( type ) ? this.mouseHooks : | |
rkeyEvent.test( type ) ? this.keyHooks : | |
{}; | |
} | |
copy = fixHook.props ? this.props.concat( fixHook.props ) : this.props; | |
event = new jQuery.Event( originalEvent ); | |
i = copy.length; | |
while ( i-- ) { | |
prop = copy[ i ]; | |
event[ prop ] = originalEvent[ prop ]; | |
} | |
// Support: Cordova 2.5 (WebKit) (#13255) | |
// All events should have a target; Cordova deviceready doesn't | |
if ( !event.target ) { | |
event.target = document; | |
} | |
// Support: Safari 6.0+, Chrome < 28 | |
// Target should not be a text node (#504, #13143) | |
if ( event.target.nodeType === 3 ) { | |
event.target = event.target.parentNode; | |
} | |
return fixHook.filter? fixHook.filter( event, originalEvent ) : event; | |
}, | |
special: { | |
load: { | |
// Prevent triggered image.load events from bubbling to window.load | |
noBubble: true | |
}, | |
focus: { | |
// Fire native event if possible so blur/focus sequence is correct | |
trigger: function() { | |
if ( this !== safeActiveElement() && this.focus ) { | |
this.focus(); | |
return false; | |
} | |
}, | |
delegateType: "focusin" | |
}, | |
blur: { | |
trigger: function() { | |
if ( this === safeActiveElement() && this.blur ) { | |
this.blur(); | |
return false; | |
} | |
}, | |
delegateType: "focusout" | |
}, | |
click: { | |
// For checkbox, fire native event so checked state will be right | |
trigger: function() { | |
if ( this.type === "checkbox" && this.click && jQuery.nodeName( this, "input" ) ) { | |
this.click(); | |
return false; | |
} | |
}, | |
// For cross-browser consistency, don't fire native .click() on links | |
_default: function( event ) { | |
return jQuery.nodeName( event.target, "a" ); | |
} | |
}, | |
beforeunload: { | |
postDispatch: function( event ) { | |
// Support: Firefox 20+ | |
// Firefox doesn't alert if the returnValue field is not set. | |
if ( event.result !== undefined ) { | |
event.originalEvent.returnValue = event.result; | |
} | |
} | |
} | |
}, | |
simulate: function( type, elem, event, bubble ) { | |
// Piggyback on a donor event to simulate a different one. | |
// Fake originalEvent to avoid donor's stopPropagation, but if the | |
// simulated event prevents default then we do the same on the donor. | |
var e = jQuery.extend( | |
new jQuery.Event(), | |
event, | |
{ | |
type: type, | |
isSimulated: true, | |
originalEvent: {} | |
} | |
); | |
if ( bubble ) { | |
jQuery.event.trigger( e, null, elem ); | |
} else { | |
jQuery.event.dispatch.call( elem, e ); | |
} | |
if ( e.isDefaultPrevented() ) { | |
event.preventDefault(); | |
} | |
} | |
}; | |
jQuery.removeEvent = function( elem, type, handle ) { | |
if ( elem.removeEventListener ) { | |
elem.removeEventListener( type, handle, false ); | |
} | |
}; | |
jQuery.Event = function( src, props ) { | |
// Allow instantiation without the 'new' keyword | |
if ( !(this instanceof jQuery.Event) ) { | |
return new jQuery.Event( src, props ); | |
} | |
// Event object | |
if ( src && src.type ) { | |
this.originalEvent = src; | |
this.type = src.type; | |
// Events bubbling up the document may have been marked as prevented | |
// by a handler lower down the tree; reflect the correct value. | |
this.isDefaultPrevented = ( src.defaultPrevented || | |
src.getPreventDefault && src.getPreventDefault() ) ? returnTrue : returnFalse; | |
// Event type | |
} else { | |
this.type = src; | |
} | |
// Put explicitly provided properties onto the event object | |
if ( props ) { | |
jQuery.extend( this, props ); | |
} | |
// Create a timestamp if incoming event doesn't have one | |
this.timeStamp = src && src.timeStamp || jQuery.now(); | |
// Mark it as fixed | |
this[ jQuery.expando ] = true; | |
}; | |
// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding | |
// http://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html | |
jQuery.Event.prototype = { | |
isDefaultPrevented: returnFalse, | |
isPropagationStopped: returnFalse, | |
isImmediatePropagationStopped: returnFalse, | |
preventDefault: function() { | |
var e = this.originalEvent; | |
this.isDefaultPrevented = returnTrue; | |
if ( e && e.preventDefault ) { | |
e.preventDefault(); | |
} | |
}, | |
stopPropagation: function() { | |
var e = this.originalEvent; | |
this.isPropagationStopped = returnTrue; | |
if ( e && e.stopPropagation ) { | |
e.stopPropagation(); | |
} | |
}, | |
stopImmediatePropagation: function() { | |
this.isImmediatePropagationStopped = returnTrue; | |
this.stopPropagation(); | |
} | |
}; | |
// Create mouseenter/leave events using mouseover/out and event-time checks | |
// Support: Chrome 15+ | |
jQuery.each({ | |
mouseenter: "mouseover", | |
mouseleave: "mouseout" | |
}, function( orig, fix ) { | |
jQuery.event.special[ orig ] = { | |
delegateType: fix, | |
bindType: fix, | |
handle: function( event ) { | |
var ret, | |
target = this, | |
related = event.relatedTarget, | |
handleObj = event.handleObj; | |
// For mousenter/leave call the handler if related is outside the target. | |
// NB: No relatedTarget if the mouse left/entered the browser window | |
if ( !related || (related !== target && !jQuery.contains( target, related )) ) { | |
event.type = handleObj.origType; | |
ret = handleObj.handler.apply( this, arguments ); | |
event.type = fix; | |
} | |
return ret; | |
} | |
}; | |
}); | |
// Create "bubbling" focus and blur events | |
// Support: Firefox, Chrome, Safari | |
if ( !jQuery.support.focusinBubbles ) { | |
jQuery.each({ focus: "focusin", blur: "focusout" }, function( orig, fix ) { | |
// Attach a single capturing handler while someone wants focusin/focusout | |
var attaches = 0, | |
handler = function( event ) { | |
jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ), true ); | |
}; | |
jQuery.event.special[ fix ] = { | |
setup: function() { | |
if ( attaches++ === 0 ) { | |
document.addEventListener( orig, handler, true ); | |
} | |
}, | |
teardown: function() { | |
if ( --attaches === 0 ) { | |
document.removeEventListener( orig, handler, true ); | |
} | |
} | |
}; | |
}); | |
} | |
jQuery.fn.extend({ | |
on: function( types, selector, data, fn, /*INTERNAL*/ one ) { | |
var origFn, type; | |
// Types can be a map of types/handlers | |
if ( typeof types === "object" ) { | |
// ( types-Object, selector, data ) | |
if ( typeof selector !== "string" ) { | |
// ( types-Object, data ) | |
data = data || selector; | |
selector = undefined; | |
} | |
for ( type in types ) { | |
this.on( type, selector, data, types[ type ], one ); | |
} | |
return this; | |
} | |
if ( data == null && fn == null ) { | |
// ( types, fn ) | |
fn = selector; | |
data = selector = undefined; | |
} else if ( fn == null ) { | |
if ( typeof selector === "string" ) { | |
// ( types, selector, fn ) | |
fn = data; | |
data = undefined; | |
} else { | |
// ( types, data, fn ) | |
fn = data; | |
data = selector; | |
selector = undefined; | |
} | |
} | |
if ( fn === false ) { | |
fn = returnFalse; | |
} else if ( !fn ) { | |
return this; | |
} | |
if ( one === 1 ) { | |
origFn = fn; | |
fn = function( event ) { | |
// Can use an empty set, since event contains the info | |
jQuery().off( event ); | |
return origFn.apply( this, arguments ); | |
}; | |
// Use same guid so caller can remove using origFn | |
fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ ); | |
} | |
return this.each( function() { | |
jQuery.event.add( this, types, fn, data, selector ); | |
}); | |
}, | |
one: function( types, selector, data, fn ) { | |
return this.on( types, selector, data, fn, 1 ); | |
}, | |
off: function( types, selector, fn ) { | |
var handleObj, type; | |
if ( types && types.preventDefault && types.handleObj ) { | |
// ( event ) dispatched jQuery.Event | |
handleObj = types.handleObj; | |
jQuery( types.delegateTarget ).off( | |
handleObj.namespace ? handleObj.origType + "." + handleObj.namespace : handleObj.origType, | |
handleObj.selector, | |
handleObj.handler | |
); | |
return this; | |
} | |
if ( typeof types === "object" ) { | |
// ( types-object [, selector] ) | |
for ( type in types ) { | |
this.off( type, selector, types[ type ] ); | |
} | |
return this; | |
} | |
if ( selector === false || typeof selector === "function" ) { | |
// ( types [, fn] ) | |
fn = selector; | |
selector = undefined; | |
} | |
if ( fn === false ) { | |
fn = returnFalse; | |
} | |
return this.each(function() { | |
jQuery.event.remove( this, types, fn, selector ); | |
}); | |
}, | |
trigger: function( type, data ) { | |
return this.each(function() { | |
jQuery.event.trigger( type, data, this ); | |
}); | |
}, | |
triggerHandler: function( type, data ) { | |
var elem = this[0]; | |
if ( elem ) { | |
return jQuery.event.trigger( type, data, elem, true ); | |
} | |
} | |
}); | |
var isSimple = /^.[^:#\[\.,]*$/, | |
rparentsprev = /^(?:parents|prev(?:Until|All))/, | |
rneedsContext = jQuery.expr.match.needsContext, | |
// methods guaranteed to produce a unique set when starting from a unique set | |
guaranteedUnique = { | |
children: true, | |
contents: true, | |
next: true, | |
prev: true | |
}; | |
jQuery.fn.extend({ | |
find: function( selector ) { | |
var i, | |
ret = [], | |
self = this, | |
len = self.length; | |
if ( typeof selector !== "string" ) { | |
return this.pushStack( jQuery( selector ).filter(function() { | |
for ( i = 0; i < len; i++ ) { | |
if ( jQuery.contains( self[ i ], this ) ) { | |
return true; | |
} | |
} | |
}) ); | |
} | |
for ( i = 0; i < len; i++ ) { | |
jQuery.find( selector, self[ i ], ret ); | |
} | |
// Needed because $( selector, context ) becomes $( context ).find( selector ) | |
ret = this.pushStack( len > 1 ? jQuery.unique( ret ) : ret ); | |
ret.selector = this.selector ? this.selector + " " + selector : selector; | |
return ret; | |
}, | |
has: function( target ) { | |
var targets = jQuery( target, this ), | |
l = targets.length; | |
return this.filter(function() { | |
var i = 0; | |
for ( ; i < l; i++ ) { | |
if ( jQuery.contains( this, targets[i] ) ) { | |
return true; | |
} | |
} | |
}); | |
}, | |
not: function( selector ) { | |
return this.pushStack( winnow(this, selector || [], true) ); | |
}, | |
filter: function( selector ) { | |
return this.pushStack( winnow(this, selector || [], false) ); | |
}, | |
is: function( selector ) { | |
return !!winnow( | |
this, | |
// If this is a positional/relative selector, check membership in the returned set | |
// so $("p:first").is("p:last") won't return true for a doc with two "p". | |
typeof selector === "string" && rneedsContext.test( selector ) ? | |
jQuery( selector ) : | |
selector || [], | |
false | |
).length; | |
}, | |
closest: function( selectors, context ) { | |
var cur, | |
i = 0, | |
l = this.length, | |
matched = [], | |
pos = ( rneedsContext.test( selectors ) || typeof selectors !== "string" ) ? | |
jQuery( selectors, context || this.context ) : | |
0; | |
for ( ; i < l; i++ ) { | |
for ( cur = this[i]; cur && cur !== context; cur = cur.parentNode ) { | |
// Always skip document fragments | |
if ( cur.nodeType < 11 && (pos ? | |
pos.index(cur) > -1 : | |
// Don't pass non-elements to Sizzle | |
cur.nodeType === 1 && | |
jQuery.find.matchesSelector(cur, selectors)) ) { | |
cur = matched.push( cur ); | |
break; | |
} | |
} | |
} | |
return this.pushStack( matched.length > 1 ? jQuery.unique( matched ) : matched ); | |
}, | |
// Determine the position of an element within | |
// the matched set of elements | |
index: function( elem ) { | |
// No argument, return index in parent | |
if ( !elem ) { | |
return ( this[ 0 ] && this[ 0 ].parentNode ) ? this.first().prevAll().length : -1; | |
} | |
// index in selector | |
if ( typeof elem === "string" ) { | |
return core_indexOf.call( jQuery( elem ), this[ 0 ] ); | |
} | |
// Locate the position of the desired element | |
return core_indexOf.call( this, | |
// If it receives a jQuery object, the first element is used | |
elem.jquery ? elem[ 0 ] : elem | |
); | |
}, | |
add: function( selector, context ) { | |
var set = typeof selector === "string" ? | |
jQuery( selector, context ) : | |
jQuery.makeArray( selector && selector.nodeType ? [ selector ] : selector ), | |
all = jQuery.merge( this.get(), set ); | |
return this.pushStack( jQuery.unique(all) ); | |
}, | |
addBack: function( selector ) { | |
return this.add( selector == null ? | |
this.prevObject : this.prevObject.filter(selector) | |
); | |
} | |
}); | |
function sibling( cur, dir ) { | |
while ( (cur = cur[dir]) && cur.nodeType !== 1 ) {} | |
return cur; | |
} | |
jQuery.each({ | |
parent: function( elem ) { | |
var parent = elem.parentNode; | |
return parent && parent.nodeType !== 11 ? parent : null; | |
}, | |
parents: function( elem ) { | |
return jQuery.dir( elem, "parentNode" ); | |
}, | |
parentsUntil: function( elem, i, until ) { | |
return jQuery.dir( elem, "parentNode", until ); | |
}, | |
next: function( elem ) { | |
return sibling( elem, "nextSibling" ); | |
}, | |
prev: function( elem ) { | |
return sibling( elem, "previousSibling" ); | |
}, | |
nextAll: function( elem ) { | |
return jQuery.dir( elem, "nextSibling" ); | |
}, | |
prevAll: function( elem ) { | |
return jQuery.dir( elem, "previousSibling" ); | |
}, | |
nextUntil: function( elem, i, until ) { | |
return jQuery.dir( elem, "nextSibling", until ); | |
}, | |
prevUntil: function( elem, i, until ) { | |
return jQuery.dir( elem, "previousSibling", until ); | |
}, | |
siblings: function( elem ) { | |
return jQuery.sibling( ( elem.parentNode || {} ).firstChild, elem ); | |
}, | |
children: function( elem ) { | |
return jQuery.sibling( elem.firstChild ); | |
}, | |
contents: function( elem ) { | |
return elem.contentDocument || jQuery.merge( [], elem.childNodes ); | |
} | |
}, function( name, fn ) { | |
jQuery.fn[ name ] = function( until, selector ) { | |
var matched = jQuery.map( this, fn, until ); | |
if ( name.slice( -5 ) !== "Until" ) { | |
selector = until; | |
} | |
if ( selector && typeof selector === "string" ) { | |
matched = jQuery.filter( selector, matched ); | |
} | |
if ( this.length > 1 ) { | |
// Remove duplicates | |
if ( !guaranteedUnique[ name ] ) { | |
jQuery.unique( matched ); | |
} | |
// Reverse order for parents* and prev-derivatives | |
if ( rparentsprev.test( name ) ) { | |
matched.reverse(); | |
} | |
} | |
return this.pushStack( matched ); | |
}; | |
}); | |
jQuery.extend({ | |
filter: function( expr, elems, not ) { | |
var elem = elems[ 0 ]; | |
if ( not ) { | |
expr = ":not(" + expr + ")"; | |
} | |
return elems.length === 1 && elem.nodeType === 1 ? | |
jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : [] : | |
jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) { | |
return elem.nodeType === 1; | |
})); | |
}, | |
dir: function( elem, dir, until ) { | |
var matched = [], | |
truncate = until !== undefined; | |
while ( (elem = elem[ dir ]) && elem.nodeType !== 9 ) { | |
if ( elem.nodeType === 1 ) { | |
if ( truncate && jQuery( elem ).is( until ) ) { | |
break; | |
} | |
matched.push( elem ); | |
} | |
} | |
return matched; | |
}, | |
sibling: function( n, elem ) { | |
var matched = []; | |
for ( ; n; n = n.nextSibling ) { | |
if ( n.nodeType === 1 && n !== elem ) { | |
matched.push( n ); | |
} | |
} | |
return matched; | |
} | |
}); | |
// Implement the identical functionality for filter and not | |
function winnow( elements, qualifier, not ) { | |
if ( jQuery.isFunction( qualifier ) ) { | |
return jQuery.grep( elements, function( elem, i ) { | |
/* jshint -W018 */ | |
return !!qualifier.call( elem, i, elem ) !== not; | |
}); | |
} | |
if ( qualifier.nodeType ) { | |
return jQuery.grep( elements, function( elem ) { | |
return ( elem === qualifier ) !== not; | |
}); | |
} | |
if ( typeof qualifier === "string" ) { | |
if ( isSimple.test( qualifier ) ) { | |
return jQuery.filter( qualifier, elements, not ); | |
} | |
qualifier = jQuery.filter( qualifier, elements ); | |
} | |
return jQuery.grep( elements, function( elem ) { | |
return ( core_indexOf.call( qualifier, elem ) >= 0 ) !== not; | |
}); | |
} | |
var rxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/gi, | |
rtagName = /<([\w:]+)/, | |
rhtml = /<|&#?\w+;/, | |
rnoInnerhtml = /<(?:script|style|link)/i, | |
manipulation_rcheckableType = /^(?:checkbox|radio)$/i, | |
// checked="checked" or checked | |
rchecked = /checked\s*(?:[^=]|=\s*.checked.)/i, | |
rscriptType = /^$|\/(?:java|ecma)script/i, | |
rscriptTypeMasked = /^true\/(.*)/, | |
rcleanScript = /^\s*<!(?:\[CDATA\[|--)|(?:\]\]|--)>\s*$/g, | |
// We have to close these tags to support XHTML (#13200) | |
wrapMap = { | |
// Support: IE 9 | |
option: [ 1, "<select multiple='multiple'>", "</select>" ], | |
thead: [ 1, "<table>", "</table>" ], | |
col: [ 2, "<table><colgroup>", "</colgroup></table>" ], | |
tr: [ 2, "<table><tbody>", "</tbody></table>" ], | |
td: [ 3, "<table><tbody><tr>", "</tr></tbody></table>" ], | |
_default: [ 0, "", "" ] | |
}; | |
// Support: IE 9 | |
wrapMap.optgroup = wrapMap.option; | |
wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; | |
wrapMap.th = wrapMap.td; | |
jQuery.fn.extend({ | |
text: function( value ) { | |
return jQuery.access( this, function( value ) { | |
return value === undefined ? | |
jQuery.text( this ) : | |
this.empty().append( ( this[ 0 ] && this[ 0 ].ownerDocument || document ).createTextNode( value ) ); | |
}, null, value, arguments.length ); | |
}, | |
append: function() { | |
return this.domManip( arguments, function( elem ) { | |
if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { | |
var target = manipulationTarget( this, elem ); | |
target.appendChild( elem ); | |
} | |
}); | |
}, | |
prepend: function() { | |
return this.domManip( arguments, function( elem ) { | |
if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { | |
var target = manipulationTarget( this, elem ); | |
target.insertBefore( elem, target.firstChild ); | |
} | |
}); | |
}, | |
before: function() { | |
return this.domManip( arguments, function( elem ) { | |
if ( this.parentNode ) { | |
this.parentNode.insertBefore( elem, this ); | |
} | |
}); | |
}, | |
after: function() { | |
return this.domManip( arguments, function( elem ) { | |
if ( this.parentNode ) { | |
this.parentNode.insertBefore( elem, this.nextSibling ); | |
} | |
}); | |
}, | |
// keepData is for internal use only--do not document | |
remove: function( selector, keepData ) { | |
var elem, | |
elems = selector ? jQuery.filter( selector, this ) : this, | |
i = 0; | |
for ( ; (elem = elems[i]) != null; i++ ) { | |
if ( !keepData && elem.nodeType === 1 ) { | |
jQuery.cleanData( getAll( elem ) ); | |
} | |
if ( elem.parentNode ) { | |
if ( keepData && jQuery.contains( elem.ownerDocument, elem ) ) { | |
setGlobalEval( getAll( elem, "script" ) ); | |
} | |
elem.parentNode.removeChild( elem ); | |
} | |
} | |
return this; | |
}, | |
empty: function() { | |
var elem, | |
i = 0; | |
for ( ; (elem = this[i]) != null; i++ ) { | |
if ( elem.nodeType === 1 ) { | |
// Prevent memory leaks | |
jQuery.cleanData( getAll( elem, false ) ); | |
// Remove any remaining nodes | |
elem.textContent = ""; | |
} | |
} | |
return this; | |
}, | |
clone: function( dataAndEvents, deepDataAndEvents ) { | |
dataAndEvents = dataAndEvents == null ? false : dataAndEvents; | |
deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents; | |
return this.map( function () { | |
return jQuery.clone( this, dataAndEvents, deepDataAndEvents ); | |
}); | |
}, | |
html: function( value ) { | |
return jQuery.access( this, function( value ) { | |
var elem = this[ 0 ] || {}, | |
i = 0, | |
l = this.length; | |
if ( value === undefined && elem.nodeType === 1 ) { | |
return elem.innerHTML; | |
} | |
// See if we can take a shortcut and just use innerHTML | |
if ( typeof value === "string" && !rnoInnerhtml.test( value ) && | |
!wrapMap[ ( rtagName.exec( value ) || [ "", "" ] )[ 1 ].toLowerCase() ] ) { | |
value = value.replace( rxhtmlTag, "<$1></$2>" ); | |
try { | |
for ( ; i < l; i++ ) { | |
elem = this[ i ] || {}; | |
// Remove element nodes and prevent memory leaks | |
if ( elem.nodeType === 1 ) { | |
jQuery.cleanData( getAll( elem, false ) ); | |
elem.innerHTML = value; | |
} | |
} | |
elem = 0; | |
// If using innerHTML throws an exception, use the fallback method | |
} catch( e ) {} | |
} | |
if ( elem ) { | |
this.empty().append( value ); | |
} | |
}, null, value, arguments.length ); | |
}, | |
replaceWith: function() { | |
var | |
// Snapshot the DOM in case .domManip sweeps something relevant into its fragment | |
args = jQuery.map( this, function( elem ) { | |
return [ elem.nextSibling, elem.parentNode ]; | |
}), | |
i = 0; | |
// Make the changes, replacing each context element with the new content | |
this.domManip( arguments, function( elem ) { | |
var next = args[ i++ ], | |
parent = args[ i++ ]; | |
if ( parent ) { | |
// Don't use the snapshot next if it has moved (#13810) | |
if ( next && next.parentNode !== parent ) { | |
next = this.nextSibling; | |
} | |
jQuery( this ).remove(); | |
parent.insertBefore( elem, next ); | |
} | |
// Allow new content to include elements from the context set | |
}, true ); | |
// Force removal if there was no new content (e.g., from empty arguments) | |
return i ? this : this.remove(); | |
}, | |
detach: function( selector ) { | |
return this.remove( selector, true ); | |
}, | |
domManip: function( args, callback, allowIntersection ) { | |
// Flatten any nested arrays | |
args = core_concat.apply( [], args ); | |
var fragment, first, scripts, hasScripts, node, doc, | |
i = 0, | |
l = this.length, | |
set = this, | |
iNoClone = l - 1, | |
value = args[ 0 ], | |
isFunction = jQuery.isFunction( value ); | |
// We can't cloneNode fragments that contain checked, in WebKit | |
if ( isFunction || !( l <= 1 || typeof value !== "string" || jQuery.support.checkClone || !rchecked.test( value ) ) ) { | |
return this.each(function( index ) { | |
var self = set.eq( index ); | |
if ( isFunction ) { | |
args[ 0 ] = value.call( this, index, self.html() ); | |
} | |
self.domManip( args, callback, allowIntersection ); | |
}); | |
} | |
if ( l ) { | |
fragment = jQuery.buildFragment( args, this[ 0 ].ownerDocument, false, !allowIntersection && this ); | |
first = fragment.firstChild; | |
if ( fragment.childNodes.length === 1 ) { | |
fragment = first; | |
} | |
if ( first ) { | |
scripts = jQuery.map( getAll( fragment, "script" ), disableScript ); | |
hasScripts = scripts.length; | |
// Use the original fragment for the last item instead of the first because it can end up | |
// being emptied incorrectly in certain situations (#8070). | |
for ( ; i < l; i++ ) { | |
node = fragment; | |
if ( i !== iNoClone ) { | |
node = jQuery.clone( node, true, true ); | |
// Keep references to cloned scripts for later restoration | |
if ( hasScripts ) { | |
// Support: QtWebKit | |
// jQuery.merge because core_push.apply(_, arraylike) throws | |
jQuery.merge( scripts, getAll( node, "script" ) ); | |
} | |
} | |
callback.call( this[ i ], node, i ); | |
} | |
if ( hasScripts ) { | |
doc = scripts[ scripts.length - 1 ].ownerDocument; | |
// Reenable scripts | |
jQuery.map( scripts, restoreScript ); | |
// Evaluate executable scripts on first document insertion | |
for ( i = 0; i < hasScripts; i++ ) { | |
node = scripts[ i ]; | |
if ( rscriptType.test( node.type || "" ) && | |
!data_priv.access( node, "globalEval" ) && jQuery.contains( doc, node ) ) { | |
if ( node.src ) { | |
// Hope ajax is available... | |
jQuery._evalUrl( node.src ); | |
} else { | |
jQuery.globalEval( node.textContent.replace( rcleanScript, "" ) ); | |
} | |
} | |
} | |
} | |
} | |
} | |
return this; | |
} | |
}); | |
jQuery.each({ | |
appendTo: "append", | |
prependTo: "prepend", | |
insertBefore: "before", | |
insertAfter: "after", | |
replaceAll: "replaceWith" | |
}, function( name, original ) { | |
jQuery.fn[ name ] = function( selector ) { | |
var elems, | |
ret = [], | |
insert = jQuery( selector ), | |
last = insert.length - 1, | |
i = 0; | |
for ( ; i <= last; i++ ) { | |
elems = i === last ? this : this.clone( true ); | |
jQuery( insert[ i ] )[ original ]( elems ); | |
// Support: QtWebKit | |
// .get() because core_push.apply(_, arraylike) throws | |
core_push.apply( ret, elems.get() ); | |
} | |
return this.pushStack( ret ); | |
}; | |
}); | |
jQuery.extend({ | |
clone: function( elem, dataAndEvents, deepDataAndEvents ) { | |
var i, l, srcElements, destElements, | |
clone = elem.cloneNode( true ), | |
inPage = jQuery.contains( elem.ownerDocument, elem ); | |
// Support: IE >= 9 | |
// Fix Cloning issues | |
if ( !jQuery.support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) && !jQuery.isXMLDoc( elem ) ) { | |
// We eschew Sizzle here for performance reasons: http://jsperf.com/getall-vs-sizzle/2 | |
destElements = getAll( clone ); | |
srcElements = getAll( elem ); | |
for ( i = 0, l = srcElements.length; i < l; i++ ) { | |
fixInput( srcElements[ i ], destElements[ i ] ); | |
} | |
} | |
// Copy the events from the original to the clone | |
if ( dataAndEvents ) { | |
if ( deepDataAndEvents ) { | |
srcElements = srcElements || getAll( elem ); | |
destElements = destElements || getAll( clone ); | |
for ( i = 0, l = srcElements.length; i < l; i++ ) { | |
cloneCopyEvent( srcElements[ i ], destElements[ i ] ); | |
} | |
} else { | |
cloneCopyEvent( elem, clone ); | |
} | |
} | |
// Preserve script evaluation history | |
destElements = getAll( clone, "script" ); | |
if ( destElements.length > 0 ) { | |
setGlobalEval( destElements, !inPage && getAll( elem, "script" ) ); | |
} | |
// Return the cloned set | |
return clone; | |
}, | |
buildFragment: function( elems, context, scripts, selection ) { | |
var elem, tmp, tag, wrap, contains, j, | |
i = 0, | |
l = elems.length, | |
fragment = context.createDocumentFragment(), | |
nodes = []; | |
for ( ; i < l; i++ ) { | |
elem = elems[ i ]; | |
if ( elem || elem === 0 ) { | |
// Add nodes directly | |
if ( jQuery.type( elem ) === "object" ) { | |
// Support: QtWebKit | |
// jQuery.merge because core_push.apply(_, arraylike) throws | |
jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem ); | |
// Convert non-html into a text node | |
} else if ( !rhtml.test( elem ) ) { | |
nodes.push( context.createTextNode( elem ) ); | |
// Convert html into DOM nodes | |
} else { | |
tmp = tmp || fragment.appendChild( context.createElement("div") ); | |
// Deserialize a standard representation | |
tag = ( rtagName.exec( elem ) || ["", ""] )[ 1 ].toLowerCase(); | |
wrap = wrapMap[ tag ] || wrapMap._default; | |
tmp.innerHTML = wrap[ 1 ] + elem.replace( rxhtmlTag, "<$1></$2>" ) + wrap[ 2 ]; | |
// Descend through wrappers to the right content | |
j = wrap[ 0 ]; | |
while ( j-- ) { | |
tmp = tmp.lastChild; | |
} | |
// Support: QtWebKit | |
// jQuery.merge because core_push.apply(_, arraylike) throws | |
jQuery.merge( nodes, tmp.childNodes ); | |
// Remember the top-level container | |
tmp = fragment.firstChild; | |
// Fixes #12346 | |
// Support: Webkit, IE | |
tmp.textContent = ""; | |
} | |
} | |
} | |
// Remove wrapper from fragment | |
fragment.textContent = ""; | |
i = 0; | |
while ( (elem = nodes[ i++ ]) ) { | |
// #4087 - If origin and destination elements are the same, and this is | |
// that element, do not do anything | |
if ( selection && jQuery.inArray( elem, selection ) !== -1 ) { | |
continue; | |
} | |
contains = jQuery.contains( elem.ownerDocument, elem ); | |
// Append to fragment | |
tmp = getAll( fragment.appendChild( elem ), "script" ); | |
// Preserve script evaluation history | |
if ( contains ) { | |
setGlobalEval( tmp ); | |
} | |
// Capture executables | |
if ( scripts ) { | |
j = 0; | |
while ( (elem = tmp[ j++ ]) ) { | |
if ( rscriptType.test( elem.type || "" ) ) { | |
scripts.push( elem ); | |
} | |
} | |
} | |
} | |
return fragment; | |
}, | |
cleanData: function( elems ) { | |
var data, elem, events, type, key, j, | |
special = jQuery.event.special, | |
i = 0; | |
for ( ; (elem = elems[ i ]) !== undefined; i++ ) { | |
if ( Data.accepts( elem ) ) { | |
key = elem[ data_priv.expando ]; | |
if ( key && (data = data_priv.cache[ key ]) ) { | |
events = Object.keys( data.events || {} ); | |
if ( events.length ) { | |
for ( j = 0; (type = events[j]) !== undefined; j++ ) { | |
if ( special[ type ] ) { | |
jQuery.event.remove( elem, type ); | |
// This is a shortcut to avoid jQuery.event.remove's overhead | |
} else { | |
jQuery.removeEvent( elem, type, data.handle ); | |
} | |
} | |
} | |
if ( data_priv.cache[ key ] ) { | |
// Discard any remaining `private` data | |
delete data_priv.cache[ key ]; | |
} | |
} | |
} | |
// Discard any remaining `user` data | |
delete data_user.cache[ elem[ data_user.expando ] ]; | |
} | |
}, | |
_evalUrl: function( url ) { | |
return jQuery.ajax({ | |
url: url, | |
type: "GET", | |
dataType: "script", | |
async: false, | |
global: false, | |
"throws": true | |
}); | |
} | |
}); | |
// Support: 1.x compatibility | |
// Manipulating tables requires a tbody | |
function manipulationTarget( elem, content ) { | |
return jQuery.nodeName( elem, "table" ) && | |
jQuery.nodeName( content.nodeType === 1 ? content : content.firstChild, "tr" ) ? | |
elem.getElementsByTagName("tbody")[0] || | |
elem.appendChild( elem.ownerDocument.createElement("tbody") ) : | |
elem; | |
} | |
// Replace/restore the type attribute of script elements for safe DOM manipulation | |
function disableScript( elem ) { | |
elem.type = (elem.getAttribute("type") !== null) + "/" + elem.type; | |
return elem; | |
} | |
function restoreScript( elem ) { | |
var match = rscriptTypeMasked.exec( elem.type ); | |
if ( match ) { | |
elem.type = match[ 1 ]; | |
} else { | |
elem.removeAttribute("type"); | |
} | |
return elem; | |
} | |
// Mark scripts as having already been evaluated | |
function setGlobalEval( elems, refElements ) { | |
var l = elems.length, | |
i = 0; | |
for ( ; i < l; i++ ) { | |
data_priv.set( | |
elems[ i ], "globalEval", !refElements || data_priv.get( refElements[ i ], "globalEval" ) | |
); | |
} | |
} | |
function cloneCopyEvent( src, dest ) { | |
var i, l, type, pdataOld, pdataCur, udataOld, udataCur, events; | |
if ( dest.nodeType !== 1 ) { | |
return; | |
} | |
// 1. Copy private data: events, handlers, etc. | |
if ( data_priv.hasData( src ) ) { | |
pdataOld = data_priv.access( src ); | |
pdataCur = data_priv.set( dest, pdataOld ); | |
events = pdataOld.events; | |
if ( events ) { | |
delete pdataCur.handle; | |
pdataCur.events = {}; | |
for ( type in events ) { | |
for ( i = 0, l = events[ type ].length; i < l; i++ ) { | |
jQuery.event.add( dest, type, events[ type ][ i ] ); | |
} | |
} | |
} | |
} | |
// 2. Copy user data | |
if ( data_user.hasData( src ) ) { | |
udataOld = data_user.access( src ); | |
udataCur = jQuery.extend( {}, udataOld ); | |
data_user.set( dest, udataCur ); | |
} | |
} | |
function getAll( context, tag ) { | |
var ret = context.getElementsByTagName ? context.getElementsByTagName( tag || "*" ) : | |
context.querySelectorAll ? context.querySelectorAll( tag || "*" ) : | |
[]; | |
return tag === undefined || tag && jQuery.nodeName( context, tag ) ? | |
jQuery.merge( [ context ], ret ) : | |
ret; | |
} | |
// Support: IE >= 9 | |
function fixInput( src, dest ) { | |
var nodeName = dest.nodeName.toLowerCase(); | |
// Fails to persist the checked state of a cloned checkbox or radio button. | |
if ( nodeName === "input" && manipulation_rcheckableType.test( src.type ) ) { | |
dest.checked = src.checked; | |
// Fails to return the selected option to the default selected state when cloning options | |
} else if ( nodeName === "input" || nodeName === "textarea" ) { | |
dest.defaultValue = src.defaultValue; | |
} | |
} | |
jQuery.fn.extend({ | |
wrapAll: function( html ) { | |
var wrap; | |
if ( jQuery.isFunction( html ) ) { | |
return this.each(function( i ) { | |
jQuery( this ).wrapAll( html.call(this, i) ); | |
}); | |
} | |
if ( this[ 0 ] ) { | |
// The elements to wrap the target around | |
wrap = jQuery( html, this[ 0 ].ownerDocument ).eq( 0 ).clone( true ); | |
if ( this[ 0 ].parentNode ) { | |
wrap.insertBefore( this[ 0 ] ); | |
} | |
wrap.map(function() { | |
var elem = this; | |
while ( elem.firstElementChild ) { | |
elem = elem.firstElementChild; | |
} | |
return elem; | |
}).append( this ); | |
} | |
return this; | |
}, | |
wrapInner: function( html ) { | |
if ( jQuery.isFunction( html ) ) { | |
return this.each(function( i ) { | |
jQuery( this ).wrapInner( html.call(this, i) ); | |
}); | |
} | |
return this.each(function() { | |
var self = jQuery( this ), | |
contents = self.contents(); | |
if ( contents.length ) { | |
contents.wrapAll( html ); | |
} else { | |
self.append( html ); | |
} | |
}); | |
}, | |
wrap: function( html ) { | |
var isFunction = jQuery.isFunction( html ); | |
return this.each(function( i ) { | |
jQuery( this ).wrapAll( isFunction ? html.call(this, i) : html ); | |
}); | |
}, | |
unwrap: function() { | |
return this.parent().each(function() { | |
if ( !jQuery.nodeName( this, "body" ) ) { | |
jQuery( this ).replaceWith( this.childNodes ); | |
} | |
}).end(); | |
} | |
}); | |
var curCSS, iframe, | |
// swappable if display is none or starts with table except "table", "table-cell", or "table-caption" | |
// see here for display values: https://developer.mozilla.org/en-US/docs/CSS/display | |
rdisplayswap = /^(none|table(?!-c[ea]).+)/, | |
rmargin = /^margin/, | |
rnumsplit = new RegExp( "^(" + core_pnum + ")(.*)$", "i" ), | |
rnumnonpx = new RegExp( "^(" + core_pnum + ")(?!px)[a-z%]+$", "i" ), | |
rrelNum = new RegExp( "^([+-])=(" + core_pnum + ")", "i" ), | |
elemdisplay = { BODY: "block" }, | |
cssShow = { position: "absolute", visibility: "hidden", display: "block" }, | |
cssNormalTransform = { | |
letterSpacing: 0, | |
fontWeight: 400 | |
}, | |
cssExpand = [ "Top", "Right", "Bottom", "Left" ], | |
cssPrefixes = [ "Webkit", "O", "Moz", "ms" ]; | |
// return a css property mapped to a potentially vendor prefixed property | |
function vendorPropName( style, name ) { | |
// shortcut for names that are not vendor prefixed | |
if ( name in style ) { | |
return name; | |
} | |
// check for vendor prefixed names | |
var capName = name.charAt(0).toUpperCase() + name.slice(1), | |
origName = name, | |
i = cssPrefixes.length; | |
while ( i-- ) { | |
name = cssPrefixes[ i ] + capName; | |
if ( name in style ) { | |
return name; | |
} | |
} | |
return origName; | |
} | |
function isHidden( elem, el ) { | |
// isHidden might be called from jQuery#filter function; | |
// in that case, element will be second argument | |
elem = el || elem; | |
return jQuery.css( elem, "display" ) === "none" || !jQuery.contains( elem.ownerDocument, elem ); | |
} | |
// NOTE: we've included the "window" in window.getComputedStyle | |
// because jsdom on node.js will break without it. | |
function getStyles( elem ) { | |
return window.getComputedStyle( elem, null ); | |
} | |
function showHide( elements, show ) { | |
var display, elem, hidden, | |
values = [], | |
index = 0, | |
length = elements.length; | |
for ( ; index < length; index++ ) { | |
elem = elements[ index ]; | |
if ( !elem.style ) { | |
continue; | |
} | |
values[ index ] = data_priv.get( elem, "olddisplay" ); | |
display = elem.style.display; | |
if ( show ) { | |
// Reset the inline display of this element to learn if it is | |
// being hidden by cascaded rules or not | |
if ( !values[ index ] && display === "none" ) { | |
elem.style.display = ""; | |
} | |
// Set elements which have been overridden with display: none | |
// in a stylesheet to whatever the default browser style is | |
// for such an element | |
if ( elem.style.display === "" && isHidden( elem ) ) { | |
values[ index ] = data_priv.access( elem, "olddisplay", css_defaultDisplay(elem.nodeName) ); | |
} | |
} else { | |
if ( !values[ index ] ) { | |
hidden = isHidden( elem ); | |
if ( display && display !== "none" || !hidden ) { | |
data_priv.set( elem, "olddisplay", hidden ? display : jQuery.css(elem, "display") ); | |
} | |
} | |
} | |
} | |
// Set the display of most of the elements in a second loop | |
// to avoid the constant reflow | |
for ( index = 0; index < length; index++ ) { | |
elem = elements[ index ]; | |
if ( !elem.style ) { | |
continue; | |
} | |
if ( !show || elem.style.display === "none" || elem.style.display === "" ) { | |
elem.style.display = show ? values[ index ] || "" : "none"; | |
} | |
} | |
return elements; | |
} | |
jQuery.fn.extend({ | |
css: function( name, value ) { | |
return jQuery.access( this, function( elem, name, value ) { | |
var styles, len, | |
map = {}, | |
i = 0; | |
if ( jQuery.isArray( name ) ) { | |
styles = getStyles( elem ); | |
len = name.length; | |
for ( ; i < len; i++ ) { | |
map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles ); | |
} | |
return map; | |
} | |
return value !== undefined ? | |
jQuery.style( elem, name, value ) : | |
jQuery.css( elem, name ); | |
}, name, value, arguments.length > 1 ); | |
}, | |
show: function() { | |
return showHide( this, true ); | |
}, | |
hide: function() { | |
return showHide( this ); | |
}, | |
toggle: function( state ) { | |
if ( typeof state === "boolean" ) { | |
return state ? this.show() : this.hide(); | |
} | |
return this.each(function() { | |
if ( isHidden( this ) ) { | |
jQuery( this ).show(); | |
} else { | |
jQuery( this ).hide(); | |
} | |
}); | |
} | |
}); | |
jQuery.extend({ | |
// Add in style property hooks for overriding the default | |
// behavior of getting and setting a style property | |
cssHooks: { | |
opacity: { | |
get: function( elem, computed ) { | |
if ( computed ) { | |
// We should always get a number back from opacity | |
var ret = curCSS( elem, "opacity" ); | |
return ret === "" ? "1" : ret; | |
} | |
} | |
} | |
}, | |
// Don't automatically add "px" to these possibly-unitless properties | |
cssNumber: { | |
"columnCount": true, | |
"fillOpacity": true, | |
"fontWeight": true, | |
"lineHeight": true, | |
"opacity": true, | |
"order": true, | |
"orphans": true, | |
"widows": true, | |
"zIndex": true, | |
"zoom": true | |
}, | |
// Add in properties whose names you wish to fix before | |
// setting or getting the value | |
cssProps: { | |
// normalize float css property | |
"float": "cssFloat" | |
}, | |
// Get and set the style property on a DOM Node | |
style: function( elem, name, value, extra ) { | |
// Don't set styles on text and comment nodes | |
if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) { | |
return; | |
} | |
// Make sure that we're working with the right name | |
var ret, type, hooks, | |
origName = jQuery.camelCase( name ), | |
style = elem.style; | |
name = jQuery.cssProps[ origName ] || ( jQuery.cssProps[ origName ] = vendorPropName( style, origName ) ); | |
// gets hook for the prefixed version | |
// followed by the unprefixed version | |
hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; | |
// Check if we're setting a value | |
if ( value !== undefined ) { | |
type = typeof value; | |
// convert relative number strings (+= or -=) to relative numbers. #7345 | |
if ( type === "string" && (ret = rrelNum.exec( value )) ) { | |
value = ( ret[1] + 1 ) * ret[2] + parseFloat( jQuery.css( elem, name ) ); | |
// Fixes bug #9237 | |
type = "number"; | |
} | |
// Make sure that NaN and null values aren't set. See: #7116 | |
if ( value == null || type === "number" && isNaN( value ) ) { | |
return; | |
} | |
// If a number was passed in, add 'px' to the (except for certain CSS properties) | |
if ( type === "number" && !jQuery.cssNumber[ origName ] ) { | |
value += "px"; | |
} | |
// Fixes #8908, it can be done more correctly by specifying setters in cssHooks, | |
// but it would mean to define eight (for every problematic property) identical functions | |
if ( !jQuery.support.clearCloneStyle && value === "" && name.indexOf("background") === 0 ) { | |
style[ name ] = "inherit"; | |
} | |
// If a hook was provided, use that value, otherwise just set the specified value | |
if ( !hooks || !("set" in hooks) || (value = hooks.set( elem, value, extra )) !== undefined ) { | |
style[ name ] = value; | |
} | |
} else { | |
// If a hook was provided get the non-computed value from there | |
if ( hooks && "get" in hooks && (ret = hooks.get( elem, false, extra )) !== undefined ) { | |
return ret; | |
} | |
// Otherwise just get the value from the style object | |
return style[ name ]; | |
} | |
}, | |
css: function( elem, name, extra, styles ) { | |
var val, num, hooks, | |
origName = jQuery.camelCase( name ); | |
// Make sure that we're working with the right name | |
name = jQuery.cssProps[ origName ] || ( jQuery.cssProps[ origName ] = vendorPropName( elem.style, origName ) ); | |
// gets hook for the prefixed version | |
// followed by the unprefixed version | |
hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; | |
// If a hook was provided get the computed value from there | |
if ( hooks && "get" in hooks ) { | |
val = hooks.get( elem, true, extra ); | |
} | |
// Otherwise, if a way to get the computed value exists, use that | |
if ( val === undefined ) { | |
val = curCSS( elem, name, styles ); | |
} | |
//convert "normal" to computed value | |
if ( val === "normal" && name in cssNormalTransform ) { | |
val = cssNormalTransform[ name ]; | |
} | |
// Return, converting to number if forced or a qualifier was provided and val looks numeric | |
if ( extra === "" || extra ) { | |
num = parseFloat( val ); | |
return extra === true || jQuery.isNumeric( num ) ? num || 0 : val; | |
} | |
return val; | |
} | |
}); | |
curCSS = function( elem, name, _computed ) { | |
var width, minWidth, maxWidth, | |
computed = _computed || getStyles( elem ), | |
// Support: IE9 | |
// getPropertyValue is only needed for .css('filter') in IE9, see #12537 | |
ret = computed ? computed.getPropertyValue( name ) || computed[ name ] : undefined, | |
style = elem.style; | |
if ( computed ) { | |
if ( ret === "" && !jQuery.contains( elem.ownerDocument, elem ) ) { | |
ret = jQuery.style( elem, name ); | |
} | |
// Support: Safari 5.1 | |
// A tribute to the "awesome hack by Dean Edwards" | |
// Safari 5.1.7 (at least) returns percentage for a larger set of values, but width seems to be reliably pixels | |
// this is against the CSSOM draft spec: http://dev.w3.org/csswg/cssom/#resolved-values | |
if ( rnumnonpx.test( ret ) && rmargin.test( name ) ) { | |
// Remember the original values | |
width = style.width; | |
minWidth = style.minWidth; | |
maxWidth = style.maxWidth; | |
// Put in the new values to get a computed value out | |
style.minWidth = style.maxWidth = style.width = ret; | |
ret = computed.width; | |
// Revert the changed values | |
style.width = width; | |
style.minWidth = minWidth; | |
style.maxWidth = maxWidth; | |
} | |
} | |
return ret; | |
}; | |
function setPositiveNumber( elem, value, subtract ) { | |
var matches = rnumsplit.exec( value ); | |
return matches ? | |
// Guard against undefined "subtract", e.g., when used as in cssHooks | |
Math.max( 0, matches[ 1 ] - ( subtract || 0 ) ) + ( matches[ 2 ] || "px" ) : | |
value; | |
} | |
function augmentWidthOrHeight( elem, name, extra, isBorderBox, styles ) { | |
var i = extra === ( isBorderBox ? "border" : "content" ) ? | |
// If we already have the right measurement, avoid augmentation | |
4 : | |
// Otherwise initialize for horizontal or vertical properties | |
name === "width" ? 1 : 0, | |
val = 0; | |
for ( ; i < 4; i += 2 ) { | |
// both box models exclude margin, so add it if we want it | |
if ( extra === "margin" ) { | |
val += jQuery.css( elem, extra + cssExpand[ i ], true, styles ); | |
} | |
if ( isBorderBox ) { | |
// border-box includes padding, so remove it if we want content | |
if ( extra === "content" ) { | |
val -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); | |
} | |
// at this point, extra isn't border nor margin, so remove border | |
if ( extra !== "margin" ) { | |
val -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); | |
} | |
} else { | |
// at this point, extra isn't content, so add padding | |
val += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); | |
// at this point, extra isn't content nor padding, so add border | |
if ( extra !== "padding" ) { | |
val += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); | |
} | |
} | |
} | |
return val; | |
} | |
function getWidthOrHeight( elem, name, extra ) { | |
// Start with offset property, which is equivalent to the border-box value | |
var valueIsBorderBox = true, | |
val = name === "width" ? elem.offsetWidth : elem.offsetHeight, | |
styles = getStyles( elem ), | |
isBorderBox = jQuery.support.boxSizing && jQuery.css( elem, "boxSizing", false, styles ) === "border-box"; | |
// some non-html elements return undefined for offsetWidth, so check for null/undefined | |
// svg - https://bugzilla.mozilla.org/show_bug.cgi?id=649285 | |
// MathML - https://bugzilla.mozilla.org/show_bug.cgi?id=491668 | |
if ( val <= 0 || val == null ) { | |
// Fall back to computed then uncomputed css if necessary | |
val = curCSS( elem, name, styles ); | |
if ( val < 0 || val == null ) { | |
val = elem.style[ name ]; | |
} | |
// Computed unit is not pixels. Stop here and return. | |
if ( rnumnonpx.test(val) ) { | |
return val; | |
} | |
// we need the check for style in case a browser which returns unreliable values | |
// for getComputedStyle silently falls back to the reliable elem.style | |
valueIsBorderBox = isBorderBox && ( jQuery.support.boxSizingReliable || val === elem.style[ name ] ); | |
// Normalize "", auto, and prepare for extra | |
val = parseFloat( val ) || 0; | |
} | |
// use the active box-sizing model to add/subtract irrelevant styles | |
return ( val + | |
augmentWidthOrHeight( | |
elem, | |
name, | |
extra || ( isBorderBox ? "border" : "content" ), | |
valueIsBorderBox, | |
styles | |
) | |
) + "px"; | |
} | |
// Try to determine the default display value of an element | |
function css_defaultDisplay( nodeName ) { | |
var doc = document, | |
display = elemdisplay[ nodeName ]; | |
if ( !display ) { | |
display = actualDisplay( nodeName, doc ); | |
// If the simple way fails, read from inside an iframe | |
if ( display === "none" || !display ) { | |
// Use the already-created iframe if possible | |
iframe = ( iframe || | |
jQuery("<iframe frameborder='0' width='0' height='0'/>") | |
.css( "cssText", "display:block !important" ) | |
).appendTo( doc.documentElement ); | |
// Always write a new HTML skeleton so Webkit and Firefox don't choke on reuse | |
doc = ( iframe[0].contentWindow || iframe[0].contentDocument ).document; | |
doc.write("<!doctype html><html><body>"); | |
doc.close(); | |
display = actualDisplay( nodeName, doc ); | |
iframe.detach(); | |
} | |
// Store the correct default display | |
elemdisplay[ nodeName ] = display; | |
} | |
return display; | |
} | |
// Called ONLY from within css_defaultDisplay | |
function actualDisplay( name, doc ) { | |
var elem = jQuery( doc.createElement( name ) ).appendTo( doc.body ), | |
display = jQuery.css( elem[0], "display" ); | |
elem.remove(); | |
return display; | |
} | |
jQuery.each([ "height", "width" ], function( i, name ) { | |
jQuery.cssHooks[ name ] = { | |
get: function( elem, computed, extra ) { | |
if ( computed ) { | |
// certain elements can have dimension info if we invisibly show them | |
// however, it must have a current display style that would benefit from this | |
return elem.offsetWidth === 0 && rdisplayswap.test( jQuery.css( elem, "display" ) ) ? | |
jQuery.swap( elem, cssShow, function() { | |
return getWidthOrHeight( elem, name, extra ); | |
}) : | |
getWidthOrHeight( elem, name, extra ); | |
} | |
}, | |
set: function( elem, value, extra ) { | |
var styles = extra && getStyles( elem ); | |
return setPositiveNumber( elem, value, extra ? | |
augmentWidthOrHeight( | |
elem, | |
name, | |
extra, | |
jQuery.support.boxSizing && jQuery.css( elem, "boxSizing", false, styles ) === "border-box", | |
styles | |
) : 0 | |
); | |
} | |
}; | |
}); | |
// These hooks cannot be added until DOM ready because the support test | |
// for it is not run until after DOM ready | |
jQuery(function() { | |
// Support: Android 2.3 | |
if ( !jQuery.support.reliableMarginRight ) { | |
jQuery.cssHooks.marginRight = { | |
get: function( elem, computed ) { | |
if ( computed ) { | |
// Support: Android 2.3 | |
// WebKit Bug 13343 - getComputedStyle returns wrong value for margin-right | |
// Work around by temporarily setting element display to inline-block | |
return jQuery.swap( elem, { "display": "inline-block" }, | |
curCSS, [ elem, "marginRight" ] ); | |
} | |
} | |
}; | |
} | |
// Webkit bug: https://bugs.webkit.org/show_bug.cgi?id=29084 | |
// getComputedStyle returns percent when specified for top/left/bottom/right | |
// rather than make the css module depend on the offset module, we just check for it here | |
if ( !jQuery.support.pixelPosition && jQuery.fn.position ) { | |
jQuery.each( [ "top", "left" ], function( i, prop ) { | |
jQuery.cssHooks[ prop ] = { | |
get: function( elem, computed ) { | |
if ( computed ) { | |
computed = curCSS( elem, prop ); | |
// if curCSS returns percentage, fallback to offset | |
return rnumnonpx.test( computed ) ? | |
jQuery( elem ).position()[ prop ] + "px" : | |
computed; | |
} | |
} | |
}; | |
}); | |
} | |
}); | |
if ( jQuery.expr && jQuery.expr.filters ) { | |
jQuery.expr.filters.hidden = function( elem ) { | |
// Support: Opera <= 12.12 | |
// Opera reports offsetWidths and offsetHeights less than zero on some elements | |
return elem.offsetWidth <= 0 && elem.offsetHeight <= 0; | |
}; | |
jQuery.expr.filters.visible = function( elem ) { | |
return !jQuery.expr.filters.hidden( elem ); | |
}; | |
} | |
// These hooks are used by animate to expand properties | |
jQuery.each({ | |
margin: "", | |
padding: "", | |
border: "Width" | |
}, function( prefix, suffix ) { | |
jQuery.cssHooks[ prefix + suffix ] = { | |
expand: function( value ) { | |
var i = 0, | |
expanded = {}, | |
// assumes a single number if not a string | |
parts = typeof value === "string" ? value.split(" ") : [ value ]; | |
for ( ; i < 4; i++ ) { | |
expanded[ prefix + cssExpand[ i ] + suffix ] = | |
parts[ i ] || parts[ i - 2 ] || parts[ 0 ]; | |
} | |
return expanded; | |
} | |
}; | |
if ( !rmargin.test( prefix ) ) { | |
jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber; | |
} | |
}); | |
var r20 = /%20/g, | |
rbracket = /\[\]$/, | |
rCRLF = /\r?\n/g, | |
rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i, | |
rsubmittable = /^(?:input|select|textarea|keygen)/i; | |
jQuery.fn.extend({ | |
serialize: function() { | |
return jQuery.param( this.serializeArray() ); | |
}, | |
serializeArray: function() { | |
return this.map(function(){ | |
// Can add propHook for "elements" to filter or add form elements | |
var elements = jQuery.prop( this, "elements" ); | |
return elements ? jQuery.makeArray( elements ) : this; | |
}) | |
.filter(function(){ | |
var type = this.type; | |
// Use .is(":disabled") so that fieldset[disabled] works | |
return this.name && !jQuery( this ).is( ":disabled" ) && | |
rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) && | |
( this.checked || !manipulation_rcheckableType.test( type ) ); | |
}) | |
.map(function( i, elem ){ | |
var val = jQuery( this ).val(); | |
return val == null ? | |
null : | |
jQuery.isArray( val ) ? | |
jQuery.map( val, function( val ){ | |
return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; | |
}) : | |
{ name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; | |
}).get(); | |
} | |
}); | |
//Serialize an array of form elements or a set of | |
//key/values into a query string | |
jQuery.param = function( a, traditional ) { | |
var prefix, | |
s = [], | |
add = function( key, value ) { | |
// If value is a function, invoke it and return its value | |
value = jQuery.isFunction( value ) ? value() : ( value == null ? "" : value ); | |
s[ s.length ] = encodeURIComponent( key ) + "=" + encodeURIComponent( value ); | |
}; | |
// Set traditional to true for jQuery <= 1.3.2 behavior. | |
if ( traditional === undefined ) { | |
traditional = jQuery.ajaxSettings && jQuery.ajaxSettings.traditional; | |
} | |
// If an array was passed in, assume that it is an array of form elements. | |
if ( jQuery.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) { | |
// Serialize the form elements | |
jQuery.each( a, function() { | |
add( this.name, this.value ); | |
}); | |
} else { | |
// If traditional, encode the "old" way (the way 1.3.2 or older | |
// did it), otherwise encode params recursively. | |
for ( prefix in a ) { | |
buildParams( prefix, a[ prefix ], traditional, add ); | |
} | |
} | |
// Return the resulting serialization | |
return s.join( "&" ).replace( r20, "+" ); | |
}; | |
function buildParams( prefix, obj, traditional, add ) { | |
var name; | |
if ( jQuery.isArray( obj ) ) { | |
// Serialize array item. | |
jQuery.each( obj, function( i, v ) { | |
if ( traditional || rbracket.test( prefix ) ) { | |
// Treat each array item as a scalar. | |
add( prefix, v ); | |
} else { | |
// Item is non-scalar (array or object), encode its numeric index. | |
buildParams( prefix + "[" + ( typeof v === "object" ? i : "" ) + "]", v, traditional, add ); | |
} | |
}); | |
} else if ( !traditional && jQuery.type( obj ) === "object" ) { | |
// Serialize object item. | |
for ( name in obj ) { | |
buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add ); | |
} | |
} else { | |
// Serialize scalar item. | |
add( prefix, obj ); | |
} | |
} | |
jQuery.each( ("blur focus focusin focusout load resize scroll unload click dblclick " + | |
"mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave " + | |
"change select submit keydown keypress keyup error contextmenu").split(" "), function( i, name ) { | |
// Handle event binding | |
jQuery.fn[ name ] = function( data, fn ) { | |
return arguments.length > 0 ? | |
this.on( name, null, data, fn ) : | |
this.trigger( name ); | |
}; | |
}); | |
jQuery.fn.extend({ | |
hover: function( fnOver, fnOut ) { | |
return this.mouseenter( fnOver ).mouseleave( fnOut || fnOver ); | |
}, | |
bind: function( types, data, fn ) { | |
return this.on( types, null, data, fn ); | |
}, | |
unbind: function( types, fn ) { | |
return this.off( types, null, fn ); | |
}, | |
delegate: function( selector, types, data, fn ) { | |
return this.on( types, selector, data, fn ); | |
}, | |
undelegate: function( selector, types, fn ) { | |
// ( namespace ) or ( selector, types [, fn] ) | |
return arguments.length === 1 ? this.off( selector, "**" ) : this.off( types, selector || "**", fn ); | |
} | |
}); | |
var | |
// Document location | |
ajaxLocParts, | |
ajaxLocation, | |
ajax_nonce = jQuery.now(), | |
ajax_rquery = /\?/, | |
rhash = /#.*$/, | |
rts = /([?&])_=[^&]*/, | |
rheaders = /^(.*?):[ \t]*([^\r\n]*)$/mg, | |
// #7653, #8125, #8152: local protocol detection | |
rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/, | |
rnoContent = /^(?:GET|HEAD)$/, | |
rprotocol = /^\/\//, | |
rurl = /^([\w.+-]+:)(?:\/\/([^\/?#:]*)(?::(\d+)|)|)/, | |
// Keep a copy of the old load method | |
_load = jQuery.fn.load, | |
/* Prefilters | |
* 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example) | |
* 2) These are called: | |
* - BEFORE asking for a transport | |
* - AFTER param serialization (s.data is a string if s.processData is true) | |
* 3) key is the dataType | |
* 4) the catchall symbol "*" can be used | |
* 5) execution will start with transport dataType and THEN continue down to "*" if needed | |
*/ | |
prefilters = {}, | |
/* Transports bindings | |
* 1) key is the dataType | |
* 2) the catchall symbol "*" can be used | |
* 3) selection will start with transport dataType and THEN go to "*" if needed | |
*/ | |
transports = {}, | |
// Avoid comment-prolog char sequence (#10098); must appease lint and evade compression | |
allTypes = "*/".concat("*"); | |
// #8138, IE may throw an exception when accessing | |
// a field from window.location if document.domain has been set | |
try { | |
ajaxLocation = location.href; | |
} catch( e ) { | |
// Use the href attribute of an A element | |
// since IE will modify it given document.location | |
ajaxLocation = document.createElement( "a" ); | |
ajaxLocation.href = ""; | |
ajaxLocation = ajaxLocation.href; | |
} | |
// Segment location into parts | |
ajaxLocParts = rurl.exec( ajaxLocation.toLowerCase() ) || []; | |
// Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport | |
function addToPrefiltersOrTransports( structure ) { | |
// dataTypeExpression is optional and defaults to "*" | |
return function( dataTypeExpression, func ) { | |
if ( typeof dataTypeExpression !== "string" ) { | |
func = dataTypeExpression; | |
dataTypeExpression = "*"; | |
} | |
var dataType, | |
i = 0, | |
dataTypes = dataTypeExpression.toLowerCase().match( core_rnotwhite ) || []; | |
if ( jQuery.isFunction( func ) ) { | |
// For each dataType in the dataTypeExpression | |
while ( (dataType = dataTypes[i++]) ) { | |
// Prepend if requested | |
if ( dataType[0] === "+" ) { | |
dataType = dataType.slice( 1 ) || "*"; | |
(structure[ dataType ] = structure[ dataType ] || []).unshift( func ); | |
// Otherwise append | |
} else { | |
(structure[ dataType ] = structure[ dataType ] || []).push( func ); | |
} | |
} | |
} | |
}; | |
} | |
// Base inspection function for prefilters and transports | |
function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) { | |
var inspected = {}, | |
seekingTransport = ( structure === transports ); | |
function inspect( dataType ) { | |
var selected; | |
inspected[ dataType ] = true; | |
jQuery.each( structure[ dataType ] || [], function( _, prefilterOrFactory ) { | |
var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR ); | |
if( typeof dataTypeOrTransport === "string" && !seekingTransport && !inspected[ dataTypeOrTransport ] ) { | |
options.dataTypes.unshift( dataTypeOrTransport ); | |
inspect( dataTypeOrTransport ); | |
return false; | |
} else if ( seekingTransport ) { | |
return !( selected = dataTypeOrTransport ); | |
} | |
}); | |
return selected; | |
} | |
return inspect( options.dataTypes[ 0 ] ) || !inspected[ "*" ] && inspect( "*" ); | |
} | |
// A special extend for ajax options | |
// that takes "flat" options (not to be deep extended) | |
// Fixes #9887 | |
function ajaxExtend( target, src ) { | |
var key, deep, | |
flatOptions = jQuery.ajaxSettings.flatOptions || {}; | |
for ( key in src ) { | |
if ( src[ key ] !== undefined ) { | |
( flatOptions[ key ] ? target : ( deep || (deep = {}) ) )[ key ] = src[ key ]; | |
} | |
} | |
if ( deep ) { | |
jQuery.extend( true, target, deep ); | |
} | |
return target; | |
} | |
jQuery.fn.load = function( url, params, callback ) { | |
if ( typeof url !== "string" && _load ) { | |
return _load.apply( this, arguments ); | |
} | |
var selector, type, response, | |
self = this, | |
off = url.indexOf(" "); | |
if ( off >= 0 ) { | |
selector = url.slice( off ); | |
url = url.slice( 0, off ); | |
} | |
// If it's a function | |
if ( jQuery.isFunction( params ) ) { | |
// We assume that it's the callback | |
callback = params; | |
params = undefined; | |
// Otherwise, build a param string | |
} else if ( params && typeof params === "object" ) { | |
type = "POST"; | |
} | |
// If we have elements to modify, make the request | |
if ( self.length > 0 ) { | |
jQuery.ajax({ | |
url: url, | |
// if "type" variable is undefined, then "GET" method will be used | |
type: type, | |
dataType: "html", | |
data: params | |
}).done(function( responseText ) { | |
// Save response for use in complete callback | |
response = arguments; | |
self.html( selector ? | |
// If a selector was specified, locate the right elements in a dummy div | |
// Exclude scripts to avoid IE 'Permission Denied' errors | |
jQuery("<div>").append( jQuery.parseHTML( responseText ) ).find( selector ) : | |
// Otherwise use the full result | |
responseText ); | |
}).complete( callback && function( jqXHR, status ) { | |
self.each( callback, response || [ jqXHR.responseText, status, jqXHR ] ); | |
}); | |
} | |
return this; | |
}; | |
// Attach a bunch of functions for handling common AJAX events | |
jQuery.each( [ "ajaxStart", "ajaxStop", "ajaxComplete", "ajaxError", "ajaxSuccess", "ajaxSend" ], function( i, type ){ | |
jQuery.fn[ type ] = function( fn ){ | |
return this.on( type, fn ); | |
}; | |
}); | |
jQuery.extend({ | |
// Counter for holding the number of active queries | |
active: 0, | |
// Last-Modified header cache for next request | |
lastModified: {}, | |
etag: {}, | |
ajaxSettings: { | |
url: ajaxLocation, | |
type: "GET", | |
isLocal: rlocalProtocol.test( ajaxLocParts[ 1 ] ), | |
global: true, | |
processData: true, | |
async: true, | |
contentType: "application/x-www-form-urlencoded; charset=UTF-8", | |
/* | |
timeout: 0, | |
data: null, | |
dataType: null, | |
username: null, | |
password: null, | |
cache: null, | |
throws: false, | |
traditional: false, | |
headers: {}, | |
*/ | |
accepts: { | |
"*": allTypes, | |
text: "text/plain", | |
html: "text/html", | |
xml: "application/xml, text/xml", | |
json: "application/json, text/javascript" | |
}, | |
contents: { | |
xml: /xml/, | |
html: /html/, | |
json: /json/ | |
}, | |
responseFields: { | |
xml: "responseXML", | |
text: "responseText", | |
json: "responseJSON" | |
}, | |
// Data converters | |
// Keys separate source (or catchall "*") and destination types with a single space | |
converters: { | |
// Convert anything to text | |
"* text": String, | |
// Text to html (true = no transformation) | |
"text html": true, | |
// Evaluate text as a json expression | |
"text json": jQuery.parseJSON, | |
// Parse text as xml | |
"text xml": jQuery.parseXML | |
}, | |
// For options that shouldn't be deep extended: | |
// you can add your own custom options here if | |
// and when you create one that shouldn't be | |
// deep extended (see ajaxExtend) | |
flatOptions: { | |
url: true, | |
context: true | |
} | |
}, | |
// Creates a full fledged settings object into target | |
// with both ajaxSettings and settings fields. | |
// If target is omitted, writes into ajaxSettings. | |
ajaxSetup: function( target, settings ) { | |
return settings ? | |
// Building a settings object | |
ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) : | |
// Extending ajaxSettings | |
ajaxExtend( jQuery.ajaxSettings, target ); | |
}, | |
ajaxPrefilter: addToPrefiltersOrTransports( prefilters ), | |
ajaxTransport: addToPrefiltersOrTransports( transports ), | |
// Main method | |
ajax: function( url, options ) { | |
// If url is an object, simulate pre-1.5 signature | |
if ( typeof url === "object" ) { | |
options = url; | |
url = undefined; | |
} | |
// Force options to be an object | |
options = options || {}; | |
var transport, | |
// URL without anti-cache param | |
cacheURL, | |
// Response headers | |
responseHeadersString, | |
responseHeaders, | |
// timeout handle | |
timeoutTimer, | |
// Cross-domain detection vars | |
parts, | |
// To know if global events are to be dispatched | |
fireGlobals, | |
// Loop variable | |
i, | |
// Create the final options object | |
s = jQuery.ajaxSetup( {}, options ), | |
// Callbacks context | |
callbackContext = s.context || s, | |
// Context for global events is callbackContext if it is a DOM node or jQuery collection | |
globalEventContext = s.context && ( callbackContext.nodeType || callbackContext.jquery ) ? | |
jQuery( callbackContext ) : | |
jQuery.event, | |
// Deferreds | |
deferred = jQuery.Deferred(), | |
completeDeferred = jQuery.Callbacks("once memory"), | |
// Status-dependent callbacks | |
statusCode = s.statusCode || {}, | |
// Headers (they are sent all at once) | |
requestHeaders = {}, | |
requestHeadersNames = {}, | |
// The jqXHR state | |
state = 0, | |
// Default abort message | |
strAbort = "canceled", | |
// Fake xhr | |
jqXHR = { | |
readyState: 0, | |
// Builds headers hashtable if needed | |
getResponseHeader: function( key ) { | |
var match; | |
if ( state === 2 ) { | |
if ( !responseHeaders ) { | |
responseHeaders = {}; | |
while ( (match = rheaders.exec( responseHeadersString )) ) { | |
responseHeaders[ match[1].toLowerCase() ] = match[ 2 ]; | |
} | |
} | |
match = responseHeaders[ key.toLowerCase() ]; | |
} | |
return match == null ? null : match; | |
}, | |
// Raw string | |
getAllResponseHeaders: function() { | |
return state === 2 ? responseHeadersString : null; | |
}, | |
// Caches the header | |
setRequestHeader: function( name, value ) { | |
var lname = name.toLowerCase(); | |
if ( !state ) { | |
name = requestHeadersNames[ lname ] = requestHeadersNames[ lname ] || name; | |
requestHeaders[ name ] = value; | |
} | |
return this; | |
}, | |
// Overrides response content-type header | |
overrideMimeType: function( type ) { | |
if ( !state ) { | |
s.mimeType = type; | |
} | |
return this; | |
}, | |
// Status-dependent callbacks | |
statusCode: function( map ) { | |
var code; | |
if ( map ) { | |
if ( state < 2 ) { | |
for ( code in map ) { | |
// Lazy-add the new callback in a way that preserves old ones | |
statusCode[ code ] = [ statusCode[ code ], map[ code ] ]; | |
} | |
} else { | |
// Execute the appropriate callbacks | |
jqXHR.always( map[ jqXHR.status ] ); | |
} | |
} | |
return this; | |
}, | |
// Cancel the request | |
abort: function( statusText ) { | |
var finalText = statusText || strAbort; | |
if ( transport ) { | |
transport.abort( finalText ); | |
} | |
done( 0, finalText ); | |
return this; | |
} | |
}; | |
// Attach deferreds | |
deferred.promise( jqXHR ).complete = completeDeferred.add; | |
jqXHR.success = jqXHR.done; | |
jqXHR.error = jqXHR.fail; | |
// Remove hash character (#7531: and string promotion) | |
// Add protocol if not provided (prefilters might expect it) | |
// Handle falsy url in the settings object (#10093: consistency with old signature) | |
// We also use the url parameter if available | |
s.url = ( ( url || s.url || ajaxLocation ) + "" ).replace( rhash, "" ) | |
.replace( rprotocol, ajaxLocParts[ 1 ] + "//" ); | |
// Alias method option to type as per ticket #12004 | |
s.type = options.method || options.type || s.method || s.type; | |
// Extract dataTypes list | |
s.dataTypes = jQuery.trim( s.dataType || "*" ).toLowerCase().match( core_rnotwhite ) || [""]; | |
// A cross-domain request is in order when we have a protocol:host:port mismatch | |
if ( s.crossDomain == null ) { | |
parts = rurl.exec( s.url.toLowerCase() ); | |
s.crossDomain = !!( parts && | |
( parts[ 1 ] !== ajaxLocParts[ 1 ] || parts[ 2 ] !== ajaxLocParts[ 2 ] || | |
( parts[ 3 ] || ( parts[ 1 ] === "http:" ? "80" : "443" ) ) !== | |
( ajaxLocParts[ 3 ] || ( ajaxLocParts[ 1 ] === "http:" ? "80" : "443" ) ) ) | |
); | |
} | |
// Convert data if not already a string | |
if ( s.data && s.processData && typeof s.data !== "string" ) { | |
s.data = jQuery.param( s.data, s.traditional ); | |
} | |
// Apply prefilters | |
inspectPrefiltersOrTransports( prefilters, s, options, jqXHR ); | |
// If request was aborted inside a prefilter, stop there | |
if ( state === 2 ) { | |
return jqXHR; | |
} | |
// We can fire global events as of now if asked to | |
fireGlobals = s.global; | |
// Watch for a new set of requests | |
if ( fireGlobals && jQuery.active++ === 0 ) { | |
jQuery.event.trigger("ajaxStart"); | |
} | |
// Uppercase the type | |
s.type = s.type.toUpperCase(); | |
// Determine if request has content | |
s.hasContent = !rnoContent.test( s.type ); | |
// Save the URL in case we're toying with the If-Modified-Since | |
// and/or If-None-Match header later on | |
cacheURL = s.url; | |
// More options handling for requests with no content | |
if ( !s.hasContent ) { | |
// If data is available, append data to url | |
if ( s.data ) { | |
cacheURL = ( s.url += ( ajax_rquery.test( cacheURL ) ? "&" : "?" ) + s.data ); | |
// #9682: remove data so that it's not used in an eventual retry | |
delete s.data; | |
} | |
// Add anti-cache in url if needed | |
if ( s.cache === false ) { | |
s.url = rts.test( cacheURL ) ? | |
// If there is already a '_' parameter, set its value | |
cacheURL.replace( rts, "$1_=" + ajax_nonce++ ) : | |
// Otherwise add one to the end | |
cacheURL + ( ajax_rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + ajax_nonce++; | |
} | |
} | |
// Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. | |
if ( s.ifModified ) { | |
if ( jQuery.lastModified[ cacheURL ] ) { | |
jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ cacheURL ] ); | |
} | |
if ( jQuery.etag[ cacheURL ] ) { | |
jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ cacheURL ] ); | |
} | |
} | |
// Set the correct header, if data is being sent | |
if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) { | |
jqXHR.setRequestHeader( "Content-Type", s.contentType ); | |
} | |
// Set the Accepts header for the server, depending on the dataType | |
jqXHR.setRequestHeader( | |
"Accept", | |
s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[0] ] ? | |
s.accepts[ s.dataTypes[0] ] + ( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) : | |
s.accepts[ "*" ] | |
); | |
// Check for headers option | |
for ( i in s.headers ) { | |
jqXHR.setRequestHeader( i, s.headers[ i ] ); | |
} | |
// Allow custom headers/mimetypes and early abort | |
if ( s.beforeSend && ( s.beforeSend.call( callbackContext, jqXHR, s ) === false || state === 2 ) ) { | |
// Abort if not done already and return | |
return jqXHR.abort(); | |
} | |
// aborting is no longer a cancellation | |
strAbort = "abort"; | |
// Install callbacks on deferreds | |
for ( i in { success: 1, error: 1, complete: 1 } ) { | |
jqXHR[ i ]( s[ i ] ); | |
} | |
// Get transport | |
transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR ); | |
// If no transport, we auto-abort | |
if ( !transport ) { | |
done( -1, "No Transport" ); | |
} else { | |
jqXHR.readyState = 1; | |
// Send global event | |
if ( fireGlobals ) { | |
globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] ); | |
} | |
// Timeout | |
if ( s.async && s.timeout > 0 ) { | |
timeoutTimer = setTimeout(function() { | |
jqXHR.abort("timeout"); | |
}, s.timeout ); | |
} | |
try { | |
state = 1; | |
transport.send( requestHeaders, done ); | |
} catch ( e ) { | |
// Propagate exception as error if not done | |
if ( state < 2 ) { | |
done( -1, e ); | |
// Simply rethrow otherwise | |
} else { | |
throw e; | |
} | |
} | |
} | |
// Callback for when everything is done | |
function done( status, nativeStatusText, responses, headers ) { | |
var isSuccess, success, error, response, modified, | |
statusText = nativeStatusText; | |
// Called once | |
if ( state === 2 ) { | |
return; | |
} | |
// State is "done" now | |
state = 2; | |
// Clear timeout if it exists | |
if ( timeoutTimer ) { | |
clearTimeout( timeoutTimer ); | |
} | |
// Dereference transport for early garbage collection | |
// (no matter how long the jqXHR object will be used) | |
transport = undefined; | |
// Cache response headers | |
responseHeadersString = headers || ""; | |
// Set readyState | |
jqXHR.readyState = status > 0 ? 4 : 0; | |
// Determine if successful | |
isSuccess = status >= 200 && status < 300 || status === 304; | |
// Get response data | |
if ( responses ) { | |
response = ajaxHandleResponses( s, jqXHR, responses ); | |
} | |
// Convert no matter what (that way responseXXX fields are always set) | |
response = ajaxConvert( s, response, jqXHR, isSuccess ); | |
// If successful, handle type chaining | |
if ( isSuccess ) { | |
// Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. | |
if ( s.ifModified ) { | |
modified = jqXHR.getResponseHeader("Last-Modified"); | |
if ( modified ) { | |
jQuery.lastModified[ cacheURL ] = modified; | |
} | |
modified = jqXHR.getResponseHeader("etag"); | |
if ( modified ) { | |
jQuery.etag[ cacheURL ] = modified; | |
} | |
} | |
// if no content | |
if ( status === 204 || s.type === "HEAD" ) { | |
statusText = "nocontent"; | |
// if not modified | |
} else if ( status === 304 ) { | |
statusText = "notmodified"; | |
// If we have data, let's convert it | |
} else { | |
statusText = response.state; | |
success = response.data; | |
error = response.error; | |
isSuccess = !error; | |
} | |
} else { | |
// We extract error from statusText | |
// then normalize statusText and status for non-aborts | |
error = statusText; | |
if ( status || !statusText ) { | |
statusText = "error"; | |
if ( status < 0 ) { | |
status = 0; | |
} | |
} | |
} | |
// Set data for the fake xhr object | |
jqXHR.status = status; | |
jqXHR.statusText = ( nativeStatusText || statusText ) + ""; | |
// Success/Error | |
if ( isSuccess ) { | |
deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] ); | |
} else { | |
deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] ); | |
} | |
// Status-dependent callbacks | |
jqXHR.statusCode( statusCode ); | |
statusCode = undefined; | |
if ( fireGlobals ) { | |
globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError", | |
[ jqXHR, s, isSuccess ? success : error ] ); | |
} | |
// Complete | |
completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] ); | |
if ( fireGlobals ) { | |
globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] ); | |
// Handle the global AJAX counter | |
if ( !( --jQuery.active ) ) { | |
jQuery.event.trigger("ajaxStop"); | |
} | |
} | |
} | |
return jqXHR; | |
}, | |
getJSON: function( url, data, callback ) { | |
return jQuery.get( url, data, callback, "json" ); | |
}, | |
getScript: function( url, callback ) { | |
return jQuery.get( url, undefined, callback, "script" ); | |
} | |
}); | |
jQuery.each( [ "get", "post" ], function( i, method ) { | |
jQuery[ method ] = function( url, data, callback, type ) { | |
// shift arguments if data argument was omitted | |
if ( jQuery.isFunction( data ) ) { | |
type = type || callback; | |
callback = data; | |
data = undefined; | |
} | |
return jQuery.ajax({ | |
url: url, | |
type: method, | |
dataType: type, | |
data: data, | |
success: callback | |
}); | |
}; | |
}); | |
/* Handles responses to an ajax request: | |
* - finds the right dataType (mediates between content-type and expected dataType) | |
* - returns the corresponding response | |
*/ | |
function ajaxHandleResponses( s, jqXHR, responses ) { | |
var ct, type, finalDataType, firstDataType, | |
contents = s.contents, | |
dataTypes = s.dataTypes; | |
// Remove auto dataType and get content-type in the process | |
while( dataTypes[ 0 ] === "*" ) { | |
dataTypes.shift(); | |
if ( ct === undefined ) { | |
ct = s.mimeType || jqXHR.getResponseHeader("Content-Type"); | |
} | |
} | |
// Check if we're dealing with a known content-type | |
if ( ct ) { | |
for ( type in contents ) { | |
if ( contents[ type ] && contents[ type ].test( ct ) ) { | |
dataTypes.unshift( type ); | |
break; | |
} | |
} | |
} | |
// Check to see if we have a response for the expected dataType | |
if ( dataTypes[ 0 ] in responses ) { | |
finalDataType = dataTypes[ 0 ]; | |
} else { | |
// Try convertible dataTypes | |
for ( type in responses ) { | |
if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[0] ] ) { | |
finalDataType = type; | |
break; | |
} | |
if ( !firstDataType ) { | |
firstDataType = type; | |
} | |
} | |
// Or just use first one | |
finalDataType = finalDataType || firstDataType; | |
} | |
// If we found a dataType | |
// We add the dataType to the list if needed | |
// and return the corresponding response | |
if ( finalDataType ) { | |
if ( finalDataType !== dataTypes[ 0 ] ) { | |
dataTypes.unshift( finalDataType ); | |
} | |
return responses[ finalDataType ]; | |
} | |
} | |
/* Chain conversions given the request and the original response | |
* Also sets the responseXXX fields on the jqXHR instance | |
*/ | |
function ajaxConvert( s, response, jqXHR, isSuccess ) { | |
var conv2, current, conv, tmp, prev, | |
converters = {}, | |
// Work with a copy of dataTypes in case we need to modify it for conversion | |
dataTypes = s.dataTypes.slice(); | |
// Create converters map with lowercased keys | |
if ( dataTypes[ 1 ] ) { | |
for ( conv in s.converters ) { | |
converters[ conv.toLowerCase() ] = s.converters[ conv ]; | |
} | |
} | |
current = dataTypes.shift(); | |
// Convert to each sequential dataType | |
while ( current ) { | |
if ( s.responseFields[ current ] ) { | |
jqXHR[ s.responseFields[ current ] ] = response; | |
} | |
// Apply the dataFilter if provided | |
if ( !prev && isSuccess && s.dataFilter ) { | |
response = s.dataFilter( response, s.dataType ); | |
} | |
prev = current; | |
current = dataTypes.shift(); | |
if ( current ) { | |
// There's only work to do if current dataType is non-auto | |
if ( current === "*" ) { | |
current = prev; | |
// Convert response if prev dataType is non-auto and differs from current | |
} else if ( prev !== "*" && prev !== current ) { | |
// Seek a direct converter | |
conv = converters[ prev + " " + current ] || converters[ "* " + current ]; | |
// If none found, seek a pair | |
if ( !conv ) { | |
for ( conv2 in converters ) { | |
// If conv2 outputs current | |
tmp = conv2.split( " " ); | |
if ( tmp[ 1 ] === current ) { | |
// If prev can be converted to accepted input | |
conv = converters[ prev + " " + tmp[ 0 ] ] || | |
converters[ "* " + tmp[ 0 ] ]; | |
if ( conv ) { | |
// Condense equivalence converters | |
if ( conv === true ) { | |
conv = converters[ conv2 ]; | |
// Otherwise, insert the intermediate dataType | |
} else if ( converters[ conv2 ] !== true ) { | |
current = tmp[ 0 ]; | |
dataTypes.unshift( tmp[ 1 ] ); | |
} | |
break; | |
} | |
} | |
} | |
} | |
// Apply converter (if not an equivalence) | |
if ( conv !== true ) { | |
// Unless errors are allowed to bubble, catch and return them | |
if ( conv && s[ "throws" ] ) { | |
response = conv( response ); | |
} else { | |
try { | |
response = conv( response ); | |
} catch ( e ) { | |
return { state: "parsererror", error: conv ? e : "No conversion from " + prev + " to " + current }; | |
} | |
} | |
} | |
} | |
} | |
} | |
return { state: "success", data: response }; | |
} | |
// Install script dataType | |
jQuery.ajaxSetup({ | |
accepts: { | |
script: "text/javascript, application/javascript, application/ecmascript, application/x-ecmascript" | |
}, | |
contents: { | |
script: /(?:java|ecma)script/ | |
}, | |
converters: { | |
"text script": function( text ) { | |
jQuery.globalEval( text ); | |
return text; | |
} | |
} | |
}); | |
// Handle cache's special case and crossDomain | |
jQuery.ajaxPrefilter( "script", function( s ) { | |
if ( s.cache === undefined ) { | |
s.cache = false; | |
} | |
if ( s.crossDomain ) { | |
s.type = "GET"; | |
} | |
}); | |
// Bind script tag hack transport | |
jQuery.ajaxTransport( "script", function( s ) { | |
// This transport only deals with cross domain requests | |
if ( s.crossDomain ) { | |
var script, callback; | |
return { | |
send: function( _, complete ) { | |
script = jQuery("<script>").prop({ | |
async: true, | |
charset: s.scriptCharset, | |
src: s.url | |
}).on( | |
"load error", | |
callback = function( evt ) { | |
script.remove(); | |
callback = null; | |
if ( evt ) { | |
complete( evt.type === "error" ? 404 : 200, evt.type ); | |
} | |
} | |
); | |
document.head.appendChild( script[ 0 ] ); | |
}, | |
abort: function() { | |
if ( callback ) { | |
callback(); | |
} | |
} | |
}; | |
} | |
}); | |
var oldCallbacks = [], | |
rjsonp = /(=)\?(?=&|$)|\?\?/; | |
// Default jsonp settings | |
jQuery.ajaxSetup({ | |
jsonp: "callback", | |
jsonpCallback: function() { | |
var callback = oldCallbacks.pop() || ( jQuery.expando + "_" + ( ajax_nonce++ ) ); | |
this[ callback ] = true; | |
return callback; | |
} | |
}); | |
// Detect, normalize options and install callbacks for jsonp requests | |
jQuery.ajaxPrefilter( "json jsonp", function( s, originalSettings, jqXHR ) { | |
var callbackName, overwritten, responseContainer, | |
jsonProp = s.jsonp !== false && ( rjsonp.test( s.url ) ? | |
"url" : | |
typeof s.data === "string" && !( s.contentType || "" ).indexOf("application/x-www-form-urlencoded") && rjsonp.test( s.data ) && "data" | |
); | |
// Handle iff the expected data type is "jsonp" or we have a parameter to set | |
if ( jsonProp || s.dataTypes[ 0 ] === "jsonp" ) { | |
// Get callback name, remembering preexisting value associated with it | |
callbackName = s.jsonpCallback = jQuery.isFunction( s.jsonpCallback ) ? | |
s.jsonpCallback() : | |
s.jsonpCallback; | |
// Insert callback into url or form data | |
if ( jsonProp ) { | |
s[ jsonProp ] = s[ jsonProp ].replace( rjsonp, "$1" + callbackName ); | |
} else if ( s.jsonp !== false ) { | |
s.url += ( ajax_rquery.test( s.url ) ? "&" : "?" ) + s.jsonp + "=" + callbackName; | |
} | |
// Use data converter to retrieve json after script execution | |
s.converters["script json"] = function() { | |
if ( !responseContainer ) { | |
jQuery.error( callbackName + " was not called" ); | |
} | |
return responseContainer[ 0 ]; | |
}; | |
// force json dataType | |
s.dataTypes[ 0 ] = "json"; | |
// Install callback | |
overwritten = window[ callbackName ]; | |
window[ callbackName ] = function() { | |
responseContainer = arguments; | |
}; | |
// Clean-up function (fires after converters) | |
jqXHR.always(function() { | |
// Restore preexisting value | |
window[ callbackName ] = overwritten; | |
// Save back as free | |
if ( s[ callbackName ] ) { | |
// make sure that re-using the options doesn't screw things around | |
s.jsonpCallback = originalSettings.jsonpCallback; | |
// save the callback name for future use | |
oldCallbacks.push( callbackName ); | |
} | |
// Call if it was a function and we have a response | |
if ( responseContainer && jQuery.isFunction( overwritten ) ) { | |
overwritten( responseContainer[ 0 ] ); | |
} | |
responseContainer = overwritten = undefined; | |
}); | |
// Delegate to script | |
return "script"; | |
} | |
}); | |
jQuery.ajaxSettings.xhr = function() { | |
try { | |
return new XMLHttpRequest(); | |
} catch( e ) {} | |
}; | |
var xhrSupported = jQuery.ajaxSettings.xhr(), | |
xhrSuccessStatus = { | |
// file protocol always yields status code 0, assume 200 | |
0: 200, | |
// Support: IE9 | |
// #1450: sometimes IE returns 1223 when it should be 204 | |
1223: 204 | |
}, | |
// Support: IE9 | |
// We need to keep track of outbound xhr and abort them manually | |
// because IE is not smart enough to do it all by itself | |
xhrId = 0, | |
xhrCallbacks = {}; | |
if ( window.ActiveXObject ) { | |
jQuery( window ).on( "unload", function() { | |
for( var key in xhrCallbacks ) { | |
xhrCallbacks[ key ](); | |
} | |
xhrCallbacks = undefined; | |
}); | |
} | |
jQuery.support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported ); | |
jQuery.support.ajax = xhrSupported = !!xhrSupported; | |
jQuery.ajaxTransport(function( options ) { | |
var callback; | |
// Cross domain only allowed if supported through XMLHttpRequest | |
if ( jQuery.support.cors || xhrSupported && !options.crossDomain ) { | |
return { | |
send: function( headers, complete ) { | |
var i, id, | |
xhr = options.xhr(); | |
xhr.open( options.type, options.url, options.async, options.username, options.password ); | |
// Apply custom fields if provided | |
if ( options.xhrFields ) { | |
for ( i in options.xhrFields ) { | |
xhr[ i ] = options.xhrFields[ i ]; | |
} | |
} | |
// Override mime type if needed | |
if ( options.mimeType && xhr.overrideMimeType ) { | |
xhr.overrideMimeType( options.mimeType ); | |
} | |
// X-Requested-With header | |
// For cross-domain requests, seeing as conditions for a preflight are | |
// akin to a jigsaw puzzle, we simply never set it to be sure. | |
// (it can always be set on a per-request basis or even using ajaxSetup) | |
// For same-domain requests, won't change header if already provided. | |
if ( !options.crossDomain && !headers["X-Requested-With"] ) { | |
headers["X-Requested-With"] = "XMLHttpRequest"; | |
} | |
// Set headers | |
for ( i in headers ) { | |
xhr.setRequestHeader( i, headers[ i ] ); | |
} | |
// Callback | |
callback = function( type ) { | |
return function() { | |
if ( callback ) { | |
delete xhrCallbacks[ id ]; | |
callback = xhr.onload = xhr.onerror = null; | |
if ( type === "abort" ) { | |
xhr.abort(); | |
} else if ( type === "error" ) { | |
complete( | |
// file protocol always yields status 0, assume 404 | |
xhr.status || 404, | |
xhr.statusText | |
); | |
} else { | |
complete( | |
xhrSuccessStatus[ xhr.status ] || xhr.status, | |
xhr.statusText, | |
// Support: IE9 | |
// #11426: When requesting binary data, IE9 will throw an exception | |
// on any attempt to access responseText | |
typeof xhr.responseText === "string" ? { | |
text: xhr.responseText | |
} : undefined, | |
xhr.getAllResponseHeaders() | |
); | |
} | |
} | |
}; | |
}; | |
// Listen to events | |
xhr.onload = callback(); | |
xhr.onerror = callback("error"); | |
// Create the abort callback | |
callback = xhrCallbacks[( id = xhrId++ )] = callback("abort"); | |
// Do send the request | |
// This may raise an exception which is actually | |
// handled in jQuery.ajax (so no try/catch here) | |
xhr.send( options.hasContent && options.data || null ); | |
}, | |
abort: function() { | |
if ( callback ) { | |
callback(); | |
} | |
} | |
}; | |
} | |
}); | |
var fxNow, timerId, | |
rfxtypes = /^(?:toggle|show|hide)$/, | |
rfxnum = new RegExp( "^(?:([+-])=|)(" + core_pnum + ")([a-z%]*)$", "i" ), | |
rrun = /queueHooks$/, | |
animationPrefilters = [ defaultPrefilter ], | |
tweeners = { | |
"*": [function( prop, value ) { | |
var tween = this.createTween( prop, value ), | |
target = tween.cur(), | |
parts = rfxnum.exec( value ), | |
unit = parts && parts[ 3 ] || ( jQuery.cssNumber[ prop ] ? "" : "px" ), | |
// Starting value computation is required for potential unit mismatches | |
start = ( jQuery.cssNumber[ prop ] || unit !== "px" && +target ) && | |
rfxnum.exec( jQuery.css( tween.elem, prop ) ), | |
scale = 1, | |
maxIterations = 20; | |
if ( start && start[ 3 ] !== unit ) { | |
// Trust units reported by jQuery.css | |
unit = unit || start[ 3 ]; | |
// Make sure we update the tween properties later on | |
parts = parts || []; | |
// Iteratively approximate from a nonzero starting point | |
start = +target || 1; | |
do { | |
// If previous iteration zeroed out, double until we get *something* | |
// Use a string for doubling factor so we don't accidentally see scale as unchanged below | |
scale = scale || ".5"; | |
// Adjust and apply | |
start = start / scale; | |
jQuery.style( tween.elem, prop, start + unit ); | |
// Update scale, tolerating zero or NaN from tween.cur() | |
// And breaking the loop if scale is unchanged or perfect, or if we've just had enough | |
} while ( scale !== (scale = tween.cur() / target) && scale !== 1 && --maxIterations ); | |
} | |
// Update tween properties | |
if ( parts ) { | |
start = tween.start = +start || +target || 0; | |
tween.unit = unit; | |
// If a +=/-= token was provided, we're doing a relative animation | |
tween.end = parts[ 1 ] ? | |
start + ( parts[ 1 ] + 1 ) * parts[ 2 ] : | |
+parts[ 2 ]; | |
} | |
return tween; | |
}] | |
}; | |
// Animations created synchronously will run synchronously | |
function createFxNow() { | |
setTimeout(function() { | |
fxNow = undefined; | |
}); | |
return ( fxNow = jQuery.now() ); | |
} | |
function createTween( value, prop, animation ) { | |
var tween, | |
collection = ( tweeners[ prop ] || [] ).concat( tweeners[ "*" ] ), | |
index = 0, | |
length = collection.length; | |
for ( ; index < length; index++ ) { | |
if ( (tween = collection[ index ].call( animation, prop, value )) ) { | |
// we're done with this property | |
return tween; | |
} | |
} | |
} | |
function Animation( elem, properties, options ) { | |
var result, | |
stopped, | |
index = 0, | |
length = animationPrefilters.length, | |
deferred = jQuery.Deferred().always( function() { | |
// don't match elem in the :animated selector | |
delete tick.elem; | |
}), | |
tick = function() { | |
if ( stopped ) { | |
return false; | |
} | |
var currentTime = fxNow || createFxNow(), | |
remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ), | |
// archaic crash bug won't allow us to use 1 - ( 0.5 || 0 ) (#12497) | |
temp = remaining / animation.duration || 0, | |
percent = 1 - temp, | |
index = 0, | |
length = animation.tweens.length; | |
for ( ; index < length ; index++ ) { | |
animation.tweens[ index ].run( percent ); | |
} | |
deferred.notifyWith( elem, [ animation, percent, remaining ]); | |
if ( percent < 1 && length ) { | |
return remaining; | |
} else { | |
deferred.resolveWith( elem, [ animation ] ); | |
return false; | |
} | |
}, | |
animation = deferred.promise({ | |
elem: elem, | |
props: jQuery.extend( {}, properties ), | |
opts: jQuery.extend( true, { specialEasing: {} }, options ), | |
originalProperties: properties, | |
originalOptions: options, | |
startTime: fxNow || createFxNow(), | |
duration: options.duration, | |
tweens: [], | |
createTween: function( prop, end ) { | |
var tween = jQuery.Tween( elem, animation.opts, prop, end, | |
animation.opts.specialEasing[ prop ] || animation.opts.easing ); | |
animation.tweens.push( tween ); | |
return tween; | |
}, | |
stop: function( gotoEnd ) { | |
var index = 0, | |
// if we are going to the end, we want to run all the tweens | |
// otherwise we skip this part | |
length = gotoEnd ? animation.tweens.length : 0; | |
if ( stopped ) { | |
return this; | |
} | |
stopped = true; | |
for ( ; index < length ; index++ ) { | |
animation.tweens[ index ].run( 1 ); | |
} | |
// resolve when we played the last frame | |
// otherwise, reject | |
if ( gotoEnd ) { | |
deferred.resolveWith( elem, [ animation, gotoEnd ] ); | |
} else { | |
deferred.rejectWith( elem, [ animation, gotoEnd ] ); | |
} | |
return this; | |
} | |
}), | |
props = animation.props; | |
propFilter( props, animation.opts.specialEasing ); | |
for ( ; index < length ; index++ ) { | |
result = animationPrefilters[ index ].call( animation, elem, props, animation.opts ); | |
if ( result ) { | |
return result; | |
} | |
} | |
jQuery.map( props, createTween, animation ); | |
if ( jQuery.isFunction( animation.opts.start ) ) { | |
animation.opts.start.call( elem, animation ); | |
} | |
jQuery.fx.timer( | |
jQuery.extend( tick, { | |
elem: elem, | |
anim: animation, | |
queue: animation.opts.queue | |
}) | |
); | |
// attach callbacks from options | |
return animation.progress( animation.opts.progress ) | |
.done( animation.opts.done, animation.opts.complete ) | |
.fail( animation.opts.fail ) | |
.always( animation.opts.always ); | |
} | |
function propFilter( props, specialEasing ) { | |
var index, name, easing, value, hooks; | |
// camelCase, specialEasing and expand cssHook pass | |
for ( index in props ) { | |
name = jQuery.camelCase( index ); | |
easing = specialEasing[ name ]; | |
value = props[ index ]; | |
if ( jQuery.isArray( value ) ) { | |
easing = value[ 1 ]; | |
value = props[ index ] = value[ 0 ]; | |
} | |
if ( index !== name ) { | |
props[ name ] = value; | |
delete props[ index ]; | |
} | |
hooks = jQuery.cssHooks[ name ]; | |
if ( hooks && "expand" in hooks ) { | |
value = hooks.expand( value ); | |
delete props[ name ]; | |
// not quite $.extend, this wont overwrite keys already present. | |
// also - reusing 'index' from above because we have the correct "name" | |
for ( index in value ) { | |
if ( !( index in props ) ) { | |
props[ index ] = value[ index ]; | |
specialEasing[ index ] = easing; | |
} | |
} | |
} else { | |
specialEasing[ name ] = easing; | |
} | |
} | |
} | |
jQuery.Animation = jQuery.extend( Animation, { | |
tweener: function( props, callback ) { | |
if ( jQuery.isFunction( props ) ) { | |
callback = props; | |
props = [ "*" ]; | |
} else { | |
props = props.split(" "); | |
} | |
var prop, | |
index = 0, | |
length = props.length; | |
for ( ; index < length ; index++ ) { | |
prop = props[ index ]; | |
tweeners[ prop ] = tweeners[ prop ] || []; | |
tweeners[ prop ].unshift( callback ); | |
} | |
}, | |
prefilter: function( callback, prepend ) { | |
if ( prepend ) { | |
animationPrefilters.unshift( callback ); | |
} else { | |
animationPrefilters.push( callback ); | |
} | |
} | |
}); | |
function defaultPrefilter( elem, props, opts ) { | |
/* jshint validthis: true */ | |
var prop, value, toggle, tween, hooks, oldfire, | |
anim = this, | |
orig = {}, | |
style = elem.style, | |
hidden = elem.nodeType && isHidden( elem ), | |
dataShow = data_priv.get( elem, "fxshow" ); | |
// handle queue: false promises | |
if ( !opts.queue ) { | |
hooks = jQuery._queueHooks( elem, "fx" ); | |
if ( hooks.unqueued == null ) { | |
hooks.unqueued = 0; | |
oldfire = hooks.empty.fire; | |
hooks.empty.fire = function() { | |
if ( !hooks.unqueued ) { | |
oldfire(); | |
} | |
}; | |
} | |
hooks.unqueued++; | |
anim.always(function() { | |
// doing this makes sure that the complete handler will be called | |
// before this completes | |
anim.always(function() { | |
hooks.unqueued--; | |
if ( !jQuery.queue( elem, "fx" ).length ) { | |
hooks.empty.fire(); | |
} | |
}); | |
}); | |
} | |
// height/width overflow pass | |
if ( elem.nodeType === 1 && ( "height" in props || "width" in props ) ) { | |
// Make sure that nothing sneaks out | |
// Record all 3 overflow attributes because IE9-10 do not | |
// change the overflow attribute when overflowX and | |
// overflowY are set to the same value | |
opts.overflow = [ style.overflow, style.overflowX, style.overflowY ]; | |
// Set display property to inline-block for height/width | |
// animations on inline elements that are having width/height animated | |
if ( jQuery.css( elem, "display" ) === "inline" && | |
jQuery.css( elem, "float" ) === "none" ) { | |
style.display = "inline-block"; | |
} | |
} | |
if ( opts.overflow ) { | |
style.overflow = "hidden"; | |
anim.always(function() { | |
style.overflow = opts.overflow[ 0 ]; | |
style.overflowX = opts.overflow[ 1 ]; | |
style.overflowY = opts.overflow[ 2 ]; | |
}); | |
} | |
// show/hide pass | |
for ( prop in props ) { | |
value = props[ prop ]; | |
if ( rfxtypes.exec( value ) ) { | |
delete props[ prop ]; | |
toggle = toggle || value === "toggle"; | |
if ( value === ( hidden ? "hide" : "show" ) ) { | |
// If there is dataShow left over from a stopped hide or show and we are going to proceed with show, we should pretend to be hidden | |
if ( value === "show" && dataShow && dataShow[ prop ] !== undefined ) { | |
hidden = true; | |
} else { | |
continue; | |
} | |
} | |
orig[ prop ] = dataShow && dataShow[ prop ] || jQuery.style( elem, prop ); | |
} | |
} | |
if ( !jQuery.isEmptyObject( orig ) ) { | |
if ( dataShow ) { | |
if ( "hidden" in dataShow ) { | |
hidden = dataShow.hidden; | |
} | |
} else { | |
dataShow = data_priv.access( elem, "fxshow", {} ); | |
} | |
// store state if its toggle - enables .stop().toggle() to "reverse" | |
if ( toggle ) { | |
dataShow.hidden = !hidden; | |
} | |
if ( hidden ) { | |
jQuery( elem ).show(); | |
} else { | |
anim.done(function() { | |
jQuery( elem ).hide(); | |
}); | |
} | |
anim.done(function() { | |
var prop; | |
data_priv.remove( elem, "fxshow" ); | |
for ( prop in orig ) { | |
jQuery.style( elem, prop, orig[ prop ] ); | |
} | |
}); | |
for ( prop in orig ) { | |
tween = createTween( hidden ? dataShow[ prop ] : 0, prop, anim ); | |
if ( !( prop in dataShow ) ) { | |
dataShow[ prop ] = tween.start; | |
if ( hidden ) { | |
tween.end = tween.start; | |
tween.start = prop === "width" || prop === "height" ? 1 : 0; | |
} | |
} | |
} | |
} | |
} | |
function Tween( elem, options, prop, end, easing ) { | |
return new Tween.prototype.init( elem, options, prop, end, easing ); | |
} | |
jQuery.Tween = Tween; | |
Tween.prototype = { | |
constructor: Tween, | |
init: function( elem, options, prop, end, easing, unit ) { | |
this.elem = elem; | |
this.prop = prop; | |
this.easing = easing || "swing"; | |
this.options = options; | |
this.start = this.now = this.cur(); | |
this.end = end; | |
this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" ); | |
}, | |
cur: function() { | |
var hooks = Tween.propHooks[ this.prop ]; | |
return hooks && hooks.get ? | |
hooks.get( this ) : | |
Tween.propHooks._default.get( this ); | |
}, | |
run: function( percent ) { | |
var eased, | |
hooks = Tween.propHooks[ this.prop ]; | |
if ( this.options.duration ) { | |
this.pos = eased = jQuery.easing[ this.easing ]( | |
percent, this.options.duration * percent, 0, 1, this.options.duration | |
); | |
} else { | |
this.pos = eased = percent; | |
} | |
this.now = ( this.end - this.start ) * eased + this.start; | |
if ( this.options.step ) { | |
this.options.step.call( this.elem, this.now, this ); | |
} | |
if ( hooks && hooks.set ) { | |
hooks.set( this ); | |
} else { | |
Tween.propHooks._default.set( this ); | |
} | |
return this; | |
} | |
}; | |
Tween.prototype.init.prototype = Tween.prototype; | |
Tween.propHooks = { | |
_default: { | |
get: function( tween ) { | |
var result; | |
if ( tween.elem[ tween.prop ] != null && | |
(!tween.elem.style || tween.elem.style[ tween.prop ] == null) ) { | |
return tween.elem[ tween.prop ]; | |
} | |
// passing an empty string as a 3rd parameter to .css will automatically | |
// attempt a parseFloat and fallback to a string if the parse fails | |
// so, simple values such as "10px" are parsed to Float. | |
// complex values such as "rotate(1rad)" are returned as is. | |
result = jQuery.css( tween.elem, tween.prop, "" ); | |
// Empty strings, null, undefined and "auto" are converted to 0. | |
return !result || result === "auto" ? 0 : result; | |
}, | |
set: function( tween ) { | |
// use step hook for back compat - use cssHook if its there - use .style if its | |
// available and use plain properties where available | |
if ( jQuery.fx.step[ tween.prop ] ) { | |
jQuery.fx.step[ tween.prop ]( tween ); | |
} else if ( tween.elem.style && ( tween.elem.style[ jQuery.cssProps[ tween.prop ] ] != null || jQuery.cssHooks[ tween.prop ] ) ) { | |
jQuery.style( tween.elem, tween.prop, tween.now + tween.unit ); | |
} else { | |
tween.elem[ tween.prop ] = tween.now; | |
} | |
} | |
} | |
}; | |
// Support: IE9 | |
// Panic based approach to setting things on disconnected nodes | |
Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = { | |
set: function( tween ) { | |
if ( tween.elem.nodeType && tween.elem.parentNode ) { | |
tween.elem[ tween.prop ] = tween.now; | |
} | |
} | |
}; | |
jQuery.each([ "toggle", "show", "hide" ], function( i, name ) { | |
var cssFn = jQuery.fn[ name ]; | |
jQuery.fn[ name ] = function( speed, easing, callback ) { | |
return speed == null || typeof speed === "boolean" ? | |
cssFn.apply( this, arguments ) : | |
this.animate( genFx( name, true ), speed, easing, callback ); | |
}; | |
}); | |
jQuery.fn.extend({ | |
fadeTo: function( speed, to, easing, callback ) { | |
// show any hidden elements after setting opacity to 0 | |
return this.filter( isHidden ).css( "opacity", 0 ).show() | |
// animate to the value specified | |
.end().animate({ opacity: to }, speed, easing, callback ); | |
}, | |
animate: function( prop, speed, easing, callback ) { | |
var empty = jQuery.isEmptyObject( prop ), | |
optall = jQuery.speed( speed, easing, callback ), | |
doAnimation = function() { | |
// Operate on a copy of prop so per-property easing won't be lost | |
var anim = Animation( this, jQuery.extend( {}, prop ), optall ); | |
// Empty animations, or finishing resolves immediately | |
if ( empty || data_priv.get( this, "finish" ) ) { | |
anim.stop( true ); | |
} | |
}; | |
doAnimation.finish = doAnimation; | |
return empty || optall.queue === false ? | |
this.each( doAnimation ) : | |
this.queue( optall.queue, doAnimation ); | |
}, | |
stop: function( type, clearQueue, gotoEnd ) { | |
var stopQueue = function( hooks ) { | |
var stop = hooks.stop; | |
delete hooks.stop; | |
stop( gotoEnd ); | |
}; | |
if ( typeof type !== "string" ) { | |
gotoEnd = clearQueue; | |
clearQueue = type; | |
type = undefined; | |
} | |
if ( clearQueue && type !== false ) { | |
this.queue( type || "fx", [] ); | |
} | |
return this.each(function() { | |
var dequeue = true, | |
index = type != null && type + "queueHooks", | |
timers = jQuery.timers, | |
data = data_priv.get( this ); | |
if ( index ) { | |
if ( data[ index ] && data[ index ].stop ) { | |
stopQueue( data[ index ] ); | |
} | |
} else { | |
for ( index in data ) { | |
if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) { | |
stopQueue( data[ index ] ); | |
} | |
} | |
} | |
for ( index = timers.length; index--; ) { | |
if ( timers[ index ].elem === this && (type == null || timers[ index ].queue === type) ) { | |
timers[ index ].anim.stop( gotoEnd ); | |
dequeue = false; | |
timers.splice( index, 1 ); | |
} | |
} | |
// start the next in the queue if the last step wasn't forced | |
// timers currently will call their complete callbacks, which will dequeue | |
// but only if they were gotoEnd | |
if ( dequeue || !gotoEnd ) { | |
jQuery.dequeue( this, type ); | |
} | |
}); | |
}, | |
finish: function( type ) { | |
if ( type !== false ) { | |
type = type || "fx"; | |
} | |
return this.each(function() { | |
var index, | |
data = data_priv.get( this ), | |
queue = data[ type + "queue" ], | |
hooks = data[ type + "queueHooks" ], | |
timers = jQuery.timers, | |
length = queue ? queue.length : 0; | |
// enable finishing flag on private data | |
data.finish = true; | |
// empty the queue first | |
jQuery.queue( this, type, [] ); | |
if ( hooks && hooks.stop ) { | |
hooks.stop.call( this, true ); | |
} | |
// look for any active animations, and finish them | |
for ( index = timers.length; index--; ) { | |
if ( timers[ index ].elem === this && timers[ index ].queue === type ) { | |
timers[ index ].anim.stop( true ); | |
timers.splice( index, 1 ); | |
} | |
} | |
// look for any animations in the old queue and finish them | |
for ( index = 0; index < length; index++ ) { | |
if ( queue[ index ] && queue[ index ].finish ) { | |
queue[ index ].finish.call( this ); | |
} | |
} | |
// turn off finishing flag | |
delete data.finish; | |
}); | |
} | |
}); | |
// Generate parameters to create a standard animation | |
function genFx( type, includeWidth ) { | |
var which, | |
attrs = { height: type }, | |
i = 0; | |
// if we include width, step value is 1 to do all cssExpand values, | |
// if we don't include width, step value is 2 to skip over Left and Right | |
includeWidth = includeWidth? 1 : 0; | |
for( ; i < 4 ; i += 2 - includeWidth ) { | |
which = cssExpand[ i ]; | |
attrs[ "margin" + which ] = attrs[ "padding" + which ] = type; | |
} | |
if ( includeWidth ) { | |
attrs.opacity = attrs.width = type; | |
} | |
return attrs; | |
} | |
// Generate shortcuts for custom animations | |
jQuery.each({ | |
slideDown: genFx("show"), | |
slideUp: genFx("hide"), | |
slideToggle: genFx("toggle"), | |
fadeIn: { opacity: "show" }, | |
fadeOut: { opacity: "hide" }, | |
fadeToggle: { opacity: "toggle" } | |
}, function( name, props ) { | |
jQuery.fn[ name ] = function( speed, easing, callback ) { | |
return this.animate( props, speed, easing, callback ); | |
}; | |
}); | |
jQuery.speed = function( speed, easing, fn ) { | |
var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : { | |
complete: fn || !fn && easing || | |
jQuery.isFunction( speed ) && speed, | |
duration: speed, | |
easing: fn && easing || easing && !jQuery.isFunction( easing ) && easing | |
}; | |
opt.duration = jQuery.fx.off ? 0 : typeof opt.duration === "number" ? opt.duration : | |
opt.duration in jQuery.fx.speeds ? jQuery.fx.speeds[ opt.duration ] : jQuery.fx.speeds._default; | |
// normalize opt.queue - true/undefined/null -> "fx" | |
if ( opt.queue == null || opt.queue === true ) { | |
opt.queue = "fx"; | |
} | |
// Queueing | |
opt.old = opt.complete; | |
opt.complete = function() { | |
if ( jQuery.isFunction( opt.old ) ) { | |
opt.old.call( this ); | |
} | |
if ( opt.queue ) { | |
jQuery.dequeue( this, opt.queue ); | |
} | |
}; | |
return opt; | |
}; | |
jQuery.easing = { | |
linear: function( p ) { | |
return p; | |
}, | |
swing: function( p ) { | |
return 0.5 - Math.cos( p*Math.PI ) / 2; | |
} | |
}; | |
jQuery.timers = []; | |
jQuery.fx = Tween.prototype.init; | |
jQuery.fx.tick = function() { | |
var timer, | |
timers = jQuery.timers, | |
i = 0; | |
fxNow = jQuery.now(); | |
for ( ; i < timers.length; i++ ) { | |
timer = timers[ i ]; | |
// Checks the timer has not already been removed | |
if ( !timer() && timers[ i ] === timer ) { | |
timers.splice( i--, 1 ); | |
} | |
} | |
if ( !timers.length ) { | |
jQuery.fx.stop(); | |
} | |
fxNow = undefined; | |
}; | |
jQuery.fx.timer = function( timer ) { | |
if ( timer() && jQuery.timers.push( timer ) ) { | |
jQuery.fx.start(); | |
} | |
}; | |
jQuery.fx.interval = 13; | |
jQuery.fx.start = function() { | |
if ( !timerId ) { | |
timerId = setInterval( jQuery.fx.tick, jQuery.fx.interval ); | |
} | |
}; | |
jQuery.fx.stop = function() { | |
clearInterval( timerId ); | |
timerId = null; | |
}; | |
jQuery.fx.speeds = { | |
slow: 600, | |
fast: 200, | |
// Default speed | |
_default: 400 | |
}; | |
// Back Compat <1.8 extension point | |
jQuery.fx.step = {}; | |
if ( jQuery.expr && jQuery.expr.filters ) { | |
jQuery.expr.filters.animated = function( elem ) { | |
return jQuery.grep(jQuery.timers, function( fn ) { | |
return elem === fn.elem; | |
}).length; | |
}; | |
} | |
jQuery.fn.offset = function( options ) { | |
if ( arguments.length ) { | |
return options === undefined ? | |
this : | |
this.each(function( i ) { | |
jQuery.offset.setOffset( this, options, i ); | |
}); | |
} | |
var docElem, win, | |
elem = this[ 0 ], | |
box = { top: 0, left: 0 }, | |
doc = elem && elem.ownerDocument; | |
if ( !doc ) { | |
return; | |
} | |
docElem = doc.documentElement; | |
// Make sure it's not a disconnected DOM node | |
if ( !jQuery.contains( docElem, elem ) ) { | |
return box; | |
} | |
// If we don't have gBCR, just use 0,0 rather than error | |
// BlackBerry 5, iOS 3 (original iPhone) | |
if ( typeof elem.getBoundingClientRect !== core_strundefined ) { | |
box = elem.getBoundingClientRect(); | |
} | |
win = getWindow( doc ); | |
return { | |
top: box.top + win.pageYOffset - docElem.clientTop, | |
left: box.left + win.pageXOffset - docElem.clientLeft | |
}; | |
}; | |
jQuery.offset = { | |
setOffset: function( elem, options, i ) { | |
var curPosition, curLeft, curCSSTop, curTop, curOffset, curCSSLeft, calculatePosition, | |
position = jQuery.css( elem, "position" ), | |
curElem = jQuery( elem ), | |
props = {}; | |
// Set position first, in-case top/left are set even on static elem | |
if ( position === "static" ) { | |
elem.style.position = "relative"; | |
} | |
curOffset = curElem.offset(); | |
curCSSTop = jQuery.css( elem, "top" ); | |
curCSSLeft = jQuery.css( elem, "left" ); | |
calculatePosition = ( position === "absolute" || position === "fixed" ) && ( curCSSTop + curCSSLeft ).indexOf("auto") > -1; | |
// Need to be able to calculate position if either top or left is auto and position is either absolute or fixed | |
if ( calculatePosition ) { | |
curPosition = curElem.position(); | |
curTop = curPosition.top; | |
curLeft = curPosition.left; | |
} else { | |
curTop = parseFloat( curCSSTop ) || 0; | |
curLeft = parseFloat( curCSSLeft ) || 0; | |
} | |
if ( jQuery.isFunction( options ) ) { | |
options = options.call( elem, i, curOffset ); | |
} | |
if ( options.top != null ) { | |
props.top = ( options.top - curOffset.top ) + curTop; | |
} | |
if ( options.left != null ) { | |
props.left = ( options.left - curOffset.left ) + curLeft; | |
} | |
if ( "using" in options ) { | |
options.using.call( elem, props ); | |
} else { | |
curElem.css( props ); | |
} | |
} | |
}; | |
jQuery.fn.extend({ | |
position: function() { | |
if ( !this[ 0 ] ) { | |
return; | |
} | |
var offsetParent, offset, | |
elem = this[ 0 ], | |
parentOffset = { top: 0, left: 0 }; | |
// Fixed elements are offset from window (parentOffset = {top:0, left: 0}, because it is it's only offset parent | |
if ( jQuery.css( elem, "position" ) === "fixed" ) { | |
// We assume that getBoundingClientRect is available when computed position is fixed | |
offset = elem.getBoundingClientRect(); | |
} else { | |
// Get *real* offsetParent | |
offsetParent = this.offsetParent(); | |
// Get correct offsets | |
offset = this.offset(); | |
if ( !jQuery.nodeName( offsetParent[ 0 ], "html" ) ) { | |
parentOffset = offsetParent.offset(); | |
} | |
// Add offsetParent borders | |
parentOffset.top += jQuery.css( offsetParent[ 0 ], "borderTopWidth", true ); | |
parentOffset.left += jQuery.css( offsetParent[ 0 ], "borderLeftWidth", true ); | |
} | |
// Subtract parent offsets and element margins | |
return { | |
top: offset.top - parentOffset.top - jQuery.css( elem, "marginTop", true ), | |
left: offset.left - parentOffset.left - jQuery.css( elem, "marginLeft", true ) | |
}; | |
}, | |
offsetParent: function() { | |
return this.map(function() { | |
var offsetParent = this.offsetParent || docElem; | |
while ( offsetParent && ( !jQuery.nodeName( offsetParent, "html" ) && jQuery.css( offsetParent, "position") === "static" ) ) { | |
offsetParent = offsetParent.offsetParent; | |
} | |
return offsetParent || docElem; | |
}); | |
} | |
}); | |
// Create scrollLeft and scrollTop methods | |
jQuery.each( {scrollLeft: "pageXOffset", scrollTop: "pageYOffset"}, function( method, prop ) { | |
var top = "pageYOffset" === prop; | |
jQuery.fn[ method ] = function( val ) { | |
return jQuery.access( this, function( elem, method, val ) { | |
var win = getWindow( elem ); | |
if ( val === undefined ) { | |
return win ? win[ prop ] : elem[ method ]; | |
} | |
if ( win ) { | |
win.scrollTo( | |
!top ? val : window.pageXOffset, | |
top ? val : window.pageYOffset | |
); | |
} else { | |
elem[ method ] = val; | |
} | |
}, method, val, arguments.length, null ); | |
}; | |
}); | |
function getWindow( elem ) { | |
return jQuery.isWindow( elem ) ? elem : elem.nodeType === 9 && elem.defaultView; | |
} | |
// Create innerHeight, innerWidth, height, width, outerHeight and outerWidth methods | |
jQuery.each( { Height: "height", Width: "width" }, function( name, type ) { | |
jQuery.each( { padding: "inner" + name, content: type, "": "outer" + name }, function( defaultExtra, funcName ) { | |
// margin is only for outerHeight, outerWidth | |
jQuery.fn[ funcName ] = function( margin, value ) { | |
var chainable = arguments.length && ( defaultExtra || typeof margin !== "boolean" ), | |
extra = defaultExtra || ( margin === true || value === true ? "margin" : "border" ); | |
return jQuery.access( this, function( elem, type, value ) { | |
var doc; | |
if ( jQuery.isWindow( elem ) ) { | |
// As of 5/8/2012 this will yield incorrect results for Mobile Safari, but there | |
// isn't a whole lot we can do. See pull request at this URL for discussion: | |
// https://github.com/jquery/jquery/pull/764 | |
return elem.document.documentElement[ "client" + name ]; | |
} | |
// Get document width or height | |
if ( elem.nodeType === 9 ) { | |
doc = elem.documentElement; | |
// Either scroll[Width/Height] or offset[Width/Height] or client[Width/Height], | |
// whichever is greatest | |
return Math.max( | |
elem.body[ "scroll" + name ], doc[ "scroll" + name ], | |
elem.body[ "offset" + name ], doc[ "offset" + name ], | |
doc[ "client" + name ] | |
); | |
} | |
return value === undefined ? | |
// Get width or height on the element, requesting but not forcing parseFloat | |
jQuery.css( elem, type, extra ) : | |
// Set width or height on the element | |
jQuery.style( elem, type, value, extra ); | |
}, type, chainable ? margin : undefined, chainable, null ); | |
}; | |
}); | |
}); | |
// Limit scope pollution from any deprecated API | |
// (function() { | |
// The number of elements contained in the matched element set | |
jQuery.fn.size = function() { | |
return this.length; | |
}; | |
jQuery.fn.andSelf = jQuery.fn.addBack; | |
// })(); | |
if ( typeof module === "object" && module && typeof module.exports === "object" ) { | |
// Expose jQuery as module.exports in loaders that implement the Node | |
// module pattern (including browserify). Do not create the global, since | |
// the user will be storing it themselves locally, and globals are frowned | |
// upon in the Node module world. | |
module.exports = jQuery; | |
} else { | |
// Register as a named AMD module, since jQuery can be concatenated with other | |
// files that may use define, but not via a proper concatenation script that | |
// understands anonymous AMD modules. A named AMD is safest and most robust | |
// way to register. Lowercase jquery is used because AMD module names are | |
// derived from file names, and jQuery is normally delivered in a lowercase | |
// file name. Do this after creating the global so that if an AMD module wants | |
// to call noConflict to hide this version of jQuery, it will work. | |
if ( typeof define === "function" && define.amd ) { | |
define( "jquery", [], function () { return jQuery; } ); | |
} | |
} | |
// If there is a window object, that at least has a document property, | |
// define jQuery and $ identifiers | |
if ( typeof window === "object" && typeof window.document === "object" ) { | |
window.jQuery = window.$ = jQuery; | |
} | |
})( window ); |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
/** | |
* @license | |
* Lo-Dash 1.3.1 (Custom Build) <http://lodash.com/> | |
* Build: `lodash -o ./dist/lodash.compat.js` | |
* Copyright 2012-2013 The Dojo Foundation <http://dojofoundation.org/> | |
* Based on Underscore.js 1.4.4 <http://underscorejs.org/> | |
* Copyright 2009-2013 Jeremy Ashkenas, DocumentCloud Inc. | |
* Available under MIT license <http://lodash.com/license> | |
*/ | |
;(function(window) { | |
/** Used as a safe reference for `undefined` in pre ES5 environments */ | |
var undefined; | |
/** Used to pool arrays and objects used internally */ | |
var arrayPool = [], | |
objectPool = []; | |
/** Used to generate unique IDs */ | |
var idCounter = 0; | |
/** Used internally to indicate various things */ | |
var indicatorObject = {}; | |
/** Used to prefix keys to avoid issues with `__proto__` and properties on `Object.prototype` */ | |
var keyPrefix = +new Date + ''; | |
/** Used as the size when optimizations are enabled for large arrays */ | |
var largeArraySize = 75; | |
/** Used as the max size of the `arrayPool` and `objectPool` */ | |
var maxPoolSize = 40; | |
/** Used to match empty string literals in compiled template source */ | |
var reEmptyStringLeading = /\b__p \+= '';/g, | |
reEmptyStringMiddle = /\b(__p \+=) '' \+/g, | |
reEmptyStringTrailing = /(__e\(.*?\)|\b__t\)) \+\n'';/g; | |
/** Used to match HTML entities */ | |
var reEscapedHtml = /&(?:amp|lt|gt|quot|#39);/g; | |
/** | |
* Used to match ES6 template delimiters | |
* http://people.mozilla.org/~jorendorff/es6-draft.html#sec-7.8.6 | |
*/ | |
var reEsTemplate = /\$\{([^\\}]*(?:\\.[^\\}]*)*)\}/g; | |
/** Used to match regexp flags from their coerced string values */ | |
var reFlags = /\w*$/; | |
/** Used to match "interpolate" template delimiters */ | |
var reInterpolate = /<%=([\s\S]+?)%>/g; | |
/** Used to detect functions containing a `this` reference */ | |
var reThis = (reThis = /\bthis\b/) && reThis.test(runInContext) && reThis; | |
/** Used to detect and test whitespace */ | |
var whitespace = ( | |
// whitespace | |
' \t\x0B\f\xA0\ufeff' + | |
// line terminators | |
'\n\r\u2028\u2029' + | |
// unicode category "Zs" space separators | |
'\u1680\u180e\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u202f\u205f\u3000' | |
); | |
/** Used to match leading whitespace and zeros to be removed */ | |
var reLeadingSpacesAndZeros = RegExp('^[' + whitespace + ']*0+(?=.$)'); | |
/** Used to ensure capturing order of template delimiters */ | |
var reNoMatch = /($^)/; | |
/** Used to match HTML characters */ | |
var reUnescapedHtml = /[&<>"']/g; | |
/** Used to match unescaped characters in compiled string literals */ | |
var reUnescapedString = /['\n\r\t\u2028\u2029\\]/g; | |
/** Used to assign default `context` object properties */ | |
var contextProps = [ | |
'Array', 'Boolean', 'Date', 'Error', 'Function', 'Math', 'Number', 'Object', | |
'RegExp', 'String', '_', 'attachEvent', 'clearTimeout', 'isFinite', 'isNaN', | |
'parseInt', 'setImmediate', 'setTimeout' | |
]; | |
/** Used to fix the JScript [[DontEnum]] bug */ | |
var shadowedProps = [ | |
'constructor', 'hasOwnProperty', 'isPrototypeOf', 'propertyIsEnumerable', | |
'toLocaleString', 'toString', 'valueOf' | |
]; | |
/** Used to make template sourceURLs easier to identify */ | |
var templateCounter = 0; | |
/** `Object#toString` result shortcuts */ | |
var argsClass = '[object Arguments]', | |
arrayClass = '[object Array]', | |
boolClass = '[object Boolean]', | |
dateClass = '[object Date]', | |
errorClass = '[object Error]', | |
funcClass = '[object Function]', | |
numberClass = '[object Number]', | |
objectClass = '[object Object]', | |
regexpClass = '[object RegExp]', | |
stringClass = '[object String]'; | |
/** Used to identify object classifications that `_.clone` supports */ | |
var cloneableClasses = {}; | |
cloneableClasses[funcClass] = false; | |
cloneableClasses[argsClass] = cloneableClasses[arrayClass] = | |
cloneableClasses[boolClass] = cloneableClasses[dateClass] = | |
cloneableClasses[numberClass] = cloneableClasses[objectClass] = | |
cloneableClasses[regexpClass] = cloneableClasses[stringClass] = true; | |
/** Used to determine if values are of the language type Object */ | |
var objectTypes = { | |
'boolean': false, | |
'function': true, | |
'object': true, | |
'number': false, | |
'string': false, | |
'undefined': false | |
}; | |
/** Used to escape characters for inclusion in compiled string literals */ | |
var stringEscapes = { | |
'\\': '\\', | |
"'": "'", | |
'\n': 'n', | |
'\r': 'r', | |
'\t': 't', | |
'\u2028': 'u2028', | |
'\u2029': 'u2029' | |
}; | |
/** Detect free variable `exports` */ | |
var freeExports = objectTypes[typeof exports] && exports; | |
/** Detect free variable `module` */ | |
var freeModule = objectTypes[typeof module] && module && module.exports == freeExports && module; | |
/** Detect free variable `global`, from Node.js or Browserified code, and use it as `window` */ | |
var freeGlobal = objectTypes[typeof global] && global; | |
if (freeGlobal && (freeGlobal.global === freeGlobal || freeGlobal.window === freeGlobal)) { | |
window = freeGlobal; | |
} | |
/*--------------------------------------------------------------------------*/ | |
/** | |
* A basic implementation of `_.indexOf` without support for binary searches | |
* or `fromIndex` constraints. | |
* | |
* @private | |
* @param {Array} array The array to search. | |
* @param {Mixed} value The value to search for. | |
* @param {Number} [fromIndex=0] The index to search from. | |
* @returns {Number} Returns the index of the matched value or `-1`. | |
*/ | |
function basicIndexOf(array, value, fromIndex) { | |
var index = (fromIndex || 0) - 1, | |
length = array.length; | |
while (++index < length) { | |
if (array[index] === value) { | |
return index; | |
} | |
} | |
return -1; | |
} | |
/** | |
* An implementation of `_.contains` for cache objects that mimics the return | |
* signature of `_.indexOf` by returning `0` if the value is found, else `-1`. | |
* | |
* @private | |
* @param {Object} cache The cache object to inspect. | |
* @param {Mixed} value The value to search for. | |
* @returns {Number} Returns `0` if `value` is found, else `-1`. | |
*/ | |
function cacheIndexOf(cache, value) { | |
var type = typeof value; | |
cache = cache.cache; | |
if (type == 'boolean' || value == null) { | |
return cache[value]; | |
} | |
if (type != 'number' && type != 'string') { | |
type = 'object'; | |
} | |
var key = type == 'number' ? value : keyPrefix + value; | |
cache = cache[type] || (cache[type] = {}); | |
return type == 'object' | |
? (cache[key] && basicIndexOf(cache[key], value) > -1 ? 0 : -1) | |
: (cache[key] ? 0 : -1); | |
} | |
/** | |
* Adds a given `value` to the corresponding cache object. | |
* | |
* @private | |
* @param {Mixed} value The value to add to the cache. | |
*/ | |
function cachePush(value) { | |
var cache = this.cache, | |
type = typeof value; | |
if (type == 'boolean' || value == null) { | |
cache[value] = true; | |
} else { | |
if (type != 'number' && type != 'string') { | |
type = 'object'; | |
} | |
var key = type == 'number' ? value : keyPrefix + value, | |
typeCache = cache[type] || (cache[type] = {}); | |
if (type == 'object') { | |
if ((typeCache[key] || (typeCache[key] = [])).push(value) == this.array.length) { | |
cache[type] = false; | |
} | |
} else { | |
typeCache[key] = true; | |
} | |
} | |
} | |
/** | |
* Used by `_.max` and `_.min` as the default `callback` when a given | |
* `collection` is a string value. | |
* | |
* @private | |
* @param {String} value The character to inspect. | |
* @returns {Number} Returns the code unit of given character. | |
*/ | |
function charAtCallback(value) { | |
return value.charCodeAt(0); | |
} | |
/** | |
* Used by `sortBy` to compare transformed `collection` values, stable sorting | |
* them in ascending order. | |
* | |
* @private | |
* @param {Object} a The object to compare to `b`. | |
* @param {Object} b The object to compare to `a`. | |
* @returns {Number} Returns the sort order indicator of `1` or `-1`. | |
*/ | |
function compareAscending(a, b) { | |
var ai = a.index, | |
bi = b.index; | |
a = a.criteria; | |
b = b.criteria; | |
// ensure a stable sort in V8 and other engines | |
// http://code.google.com/p/v8/issues/detail?id=90 | |
if (a !== b) { | |
if (a > b || typeof a == 'undefined') { | |
return 1; | |
} | |
if (a < b || typeof b == 'undefined') { | |
return -1; | |
} | |
} | |
return ai < bi ? -1 : 1; | |
} | |
/** | |
* Creates a cache object to optimize linear searches of large arrays. | |
* | |
* @private | |
* @param {Array} [array=[]] The array to search. | |
* @returns {Null|Object} Returns the cache object or `null` if caching should not be used. | |
*/ | |
function createCache(array) { | |
var index = -1, | |
length = array.length; | |
var cache = getObject(); | |
cache['false'] = cache['null'] = cache['true'] = cache['undefined'] = false; | |
var result = getObject(); | |
result.array = array; | |
result.cache = cache; | |
result.push = cachePush; | |
while (++index < length) { | |
result.push(array[index]); | |
} | |
return cache.object === false | |
? (releaseObject(result), null) | |
: result; | |
} | |
/** | |
* Used by `template` to escape characters for inclusion in compiled | |
* string literals. | |
* | |
* @private | |
* @param {String} match The matched character to escape. | |
* @returns {String} Returns the escaped character. | |
*/ | |
function escapeStringChar(match) { | |
return '\\' + stringEscapes[match]; | |
} | |
/** | |
* Gets an array from the array pool or creates a new one if the pool is empty. | |
* | |
* @private | |
* @returns {Array} The array from the pool. | |
*/ | |
function getArray() { | |
return arrayPool.pop() || []; | |
} | |
/** | |
* Gets an object from the object pool or creates a new one if the pool is empty. | |
* | |
* @private | |
* @returns {Object} The object from the pool. | |
*/ | |
function getObject() { | |
return objectPool.pop() || { | |
'args': '', | |
'array': null, | |
'bottom': '', | |
'cache': null, | |
'criteria': null, | |
'false': false, | |
'firstArg': '', | |
'index': 0, | |
'init': '', | |
'leading': false, | |
'loop': '', | |
'maxWait': 0, | |
'null': false, | |
'number': null, | |
'object': null, | |
'push': null, | |
'shadowedProps': null, | |
'string': null, | |
'top': '', | |
'trailing': false, | |
'true': false, | |
'undefined': false, | |
'useHas': false, | |
'useKeys': false, | |
'value': null | |
}; | |
} | |
/** | |
* Checks if `value` is a DOM node in IE < 9. | |
* | |
* @private | |
* @param {Mixed} value The value to check. | |
* @returns {Boolean} Returns `true` if the `value` is a DOM node, else `false`. | |
*/ | |
function isNode(value) { | |
// IE < 9 presents DOM nodes as `Object` objects except they have `toString` | |
// methods that are `typeof` "string" and still can coerce nodes to strings | |
return typeof value.toString != 'function' && typeof (value + '') == 'string'; | |
} | |
/** | |
* A no-operation function. | |
* | |
* @private | |
*/ | |
function noop() { | |
// no operation performed | |
} | |
/** | |
* Releases the given `array` back to the array pool. | |
* | |
* @private | |
* @param {Array} [array] The array to release. | |
*/ | |
function releaseArray(array) { | |
array.length = 0; | |
if (arrayPool.length < maxPoolSize) { | |
arrayPool.push(array); | |
} | |
} | |
/** | |
* Releases the given `object` back to the object pool. | |
* | |
* @private | |
* @param {Object} [object] The object to release. | |
*/ | |
function releaseObject(object) { | |
var cache = object.cache; | |
if (cache) { | |
releaseObject(cache); | |
} | |
object.array = object.cache = object.criteria = object.object = object.number = object.string = object.value = null; | |
if (objectPool.length < maxPoolSize) { | |
objectPool.push(object); | |
} | |
} | |
/** | |
* Slices the `collection` from the `start` index up to, but not including, | |
* the `end` index. | |
* | |
* Note: This function is used, instead of `Array#slice`, to support node lists | |
* in IE < 9 and to ensure dense arrays are returned. | |
* | |
* @private | |
* @param {Array|Object|String} collection The collection to slice. | |
* @param {Number} start The start index. | |
* @param {Number} end The end index. | |
* @returns {Array} Returns the new array. | |
*/ | |
function slice(array, start, end) { | |
start || (start = 0); | |
if (typeof end == 'undefined') { | |
end = array ? array.length : 0; | |
} | |
var index = -1, | |
length = end - start || 0, | |
result = Array(length < 0 ? 0 : length); | |
while (++index < length) { | |
result[index] = array[start + index]; | |
} | |
return result; | |
} | |
/*--------------------------------------------------------------------------*/ | |
/** | |
* Create a new `lodash` function using the given `context` object. | |
* | |
* @static | |
* @memberOf _ | |
* @category Utilities | |
* @param {Object} [context=window] The context object. | |
* @returns {Function} Returns the `lodash` function. | |
*/ | |
function runInContext(context) { | |
// Avoid issues with some ES3 environments that attempt to use values, named | |
// after built-in constructors like `Object`, for the creation of literals. | |
// ES5 clears this up by stating that literals must use built-in constructors. | |
// See http://es5.github.com/#x11.1.5. | |
context = context ? _.defaults(window.Object(), context, _.pick(window, contextProps)) : window; | |
/** Native constructor references */ | |
var Array = context.Array, | |
Boolean = context.Boolean, | |
Date = context.Date, | |
Error = context.Error, | |
Function = context.Function, | |
Math = context.Math, | |
Number = context.Number, | |
Object = context.Object, | |
RegExp = context.RegExp, | |
String = context.String, | |
TypeError = context.TypeError; | |
/** | |
* Used for `Array` method references. | |
* | |
* Normally `Array.prototype` would suffice, however, using an array literal | |
* avoids issues in Narwhal. | |
*/ | |
var arrayRef = []; | |
/** Used for native method references */ | |
var errorProto = Error.prototype, | |
objectProto = Object.prototype, | |
stringProto = String.prototype; | |
/** Used to restore the original `_` reference in `noConflict` */ | |
var oldDash = context._; | |
/** Used to detect if a method is native */ | |
var reNative = RegExp('^' + | |
String(objectProto.valueOf) | |
.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') | |
.replace(/valueOf|for [^\]]+/g, '.+?') + '$' | |
); | |
/** Native method shortcuts */ | |
var ceil = Math.ceil, | |
clearTimeout = context.clearTimeout, | |
concat = arrayRef.concat, | |
floor = Math.floor, | |
fnToString = Function.prototype.toString, | |
getPrototypeOf = reNative.test(getPrototypeOf = Object.getPrototypeOf) && getPrototypeOf, | |
hasOwnProperty = objectProto.hasOwnProperty, | |
push = arrayRef.push, | |
propertyIsEnumerable = objectProto.propertyIsEnumerable, | |
setImmediate = context.setImmediate, | |
setTimeout = context.setTimeout, | |
toString = objectProto.toString; | |
/* Native method shortcuts for methods with the same name as other `lodash` methods */ | |
var nativeBind = reNative.test(nativeBind = toString.bind) && nativeBind, | |
nativeCreate = reNative.test(nativeCreate = Object.create) && nativeCreate, | |
nativeIsArray = reNative.test(nativeIsArray = Array.isArray) && nativeIsArray, | |
nativeIsFinite = context.isFinite, | |
nativeIsNaN = context.isNaN, | |
nativeKeys = reNative.test(nativeKeys = Object.keys) && nativeKeys, | |
nativeMax = Math.max, | |
nativeMin = Math.min, | |
nativeParseInt = context.parseInt, | |
nativeRandom = Math.random, | |
nativeSlice = arrayRef.slice; | |
/** Detect various environments */ | |
var isIeOpera = reNative.test(context.attachEvent), | |
isV8 = nativeBind && !/\n|true/.test(nativeBind + isIeOpera); | |
/** Used to lookup a built-in constructor by [[Class]] */ | |
var ctorByClass = {}; | |
ctorByClass[arrayClass] = Array; | |
ctorByClass[boolClass] = Boolean; | |
ctorByClass[dateClass] = Date; | |
ctorByClass[funcClass] = Function; | |
ctorByClass[objectClass] = Object; | |
ctorByClass[numberClass] = Number; | |
ctorByClass[regexpClass] = RegExp; | |
ctorByClass[stringClass] = String; | |
/** Used to avoid iterating non-enumerable properties in IE < 9 */ | |
var nonEnumProps = {}; | |
nonEnumProps[arrayClass] = nonEnumProps[dateClass] = nonEnumProps[numberClass] = { 'constructor': true, 'toLocaleString': true, 'toString': true, 'valueOf': true }; | |
nonEnumProps[boolClass] = nonEnumProps[stringClass] = { 'constructor': true, 'toString': true, 'valueOf': true }; | |
nonEnumProps[errorClass] = nonEnumProps[funcClass] = nonEnumProps[regexpClass] = { 'constructor': true, 'toString': true }; | |
nonEnumProps[objectClass] = { 'constructor': true }; | |
(function() { | |
var length = shadowedProps.length; | |
while (length--) { | |
var prop = shadowedProps[length]; | |
for (var className in nonEnumProps) { | |
if (hasOwnProperty.call(nonEnumProps, className) && !hasOwnProperty.call(nonEnumProps[className], prop)) { | |
nonEnumProps[className][prop] = false; | |
} | |
} | |
} | |
}()); | |
/*--------------------------------------------------------------------------*/ | |
/** | |
* Creates a `lodash` object, which wraps the given `value`, to enable method | |
* chaining. | |
* | |
* In addition to Lo-Dash methods, wrappers also have the following `Array` methods: | |
* `concat`, `join`, `pop`, `push`, `reverse`, `shift`, `slice`, `sort`, `splice`, | |
* and `unshift` | |
* | |
* Chaining is supported in custom builds as long as the `value` method is | |
* implicitly or explicitly included in the build. | |
* | |
* The chainable wrapper functions are: | |
* `after`, `assign`, `bind`, `bindAll`, `bindKey`, `chain`, `compact`, | |
* `compose`, `concat`, `countBy`, `createCallback`, `debounce`, `defaults`, | |
* `defer`, `delay`, `difference`, `filter`, `flatten`, `forEach`, `forIn`, | |
* `forOwn`, `functions`, `groupBy`, `initial`, `intersection`, `invert`, | |
* `invoke`, `keys`, `map`, `max`, `memoize`, `merge`, `min`, `object`, `omit`, | |
* `once`, `pairs`, `partial`, `partialRight`, `pick`, `pluck`, `push`, `range`, | |
* `reject`, `rest`, `reverse`, `shuffle`, `slice`, `sort`, `sortBy`, `splice`, | |
* `tap`, `throttle`, `times`, `toArray`, `transform`, `union`, `uniq`, `unshift`, | |
* `unzip`, `values`, `where`, `without`, `wrap`, and `zip` | |
* | |
* The non-chainable wrapper functions are: | |
* `clone`, `cloneDeep`, `contains`, `escape`, `every`, `find`, `has`, | |
* `identity`, `indexOf`, `isArguments`, `isArray`, `isBoolean`, `isDate`, | |
* `isElement`, `isEmpty`, `isEqual`, `isFinite`, `isFunction`, `isNaN`, | |
* `isNull`, `isNumber`, `isObject`, `isPlainObject`, `isRegExp`, `isString`, | |
* `isUndefined`, `join`, `lastIndexOf`, `mixin`, `noConflict`, `parseInt`, | |
* `pop`, `random`, `reduce`, `reduceRight`, `result`, `shift`, `size`, `some`, | |
* `sortedIndex`, `runInContext`, `template`, `unescape`, `uniqueId`, and `value` | |
* | |
* The wrapper functions `first` and `last` return wrapped values when `n` is | |
* passed, otherwise they return unwrapped values. | |
* | |
* @name _ | |
* @constructor | |
* @alias chain | |
* @category Chaining | |
* @param {Mixed} value The value to wrap in a `lodash` instance. | |
* @returns {Object} Returns a `lodash` instance. | |
* @example | |
* | |
* var wrapped = _([1, 2, 3]); | |
* | |
* // returns an unwrapped value | |
* wrapped.reduce(function(sum, num) { | |
* return sum + num; | |
* }); | |
* // => 6 | |
* | |
* // returns a wrapped value | |
* var squares = wrapped.map(function(num) { | |
* return num * num; | |
* }); | |
* | |
* _.isArray(squares); | |
* // => false | |
* | |
* _.isArray(squares.value()); | |
* // => true | |
*/ | |
function lodash(value) { | |
// don't wrap if already wrapped, even if wrapped by a different `lodash` constructor | |
return (value && typeof value == 'object' && !isArray(value) && hasOwnProperty.call(value, '__wrapped__')) | |
? value | |
: new lodashWrapper(value); | |
} | |
/** | |
* A fast path for creating `lodash` wrapper objects. | |
* | |
* @private | |
* @param {Mixed} value The value to wrap in a `lodash` instance. | |
* @returns {Object} Returns a `lodash` instance. | |
*/ | |
function lodashWrapper(value) { | |
this.__wrapped__ = value; | |
} | |
// ensure `new lodashWrapper` is an instance of `lodash` | |
lodashWrapper.prototype = lodash.prototype; | |
/** | |
* An object used to flag environments features. | |
* | |
* @static | |
* @memberOf _ | |
* @type Object | |
*/ | |
var support = lodash.support = {}; | |
(function() { | |
var ctor = function() { this.x = 1; }, | |
object = { '0': 1, 'length': 1 }, | |
props = []; | |
ctor.prototype = { 'valueOf': 1, 'y': 1 }; | |
for (var prop in new ctor) { props.push(prop); } | |
for (prop in arguments) { } | |
/** | |
* Detect if `arguments` objects are `Object` objects (all but Narwhal and Opera < 10.5). | |
* | |
* @memberOf _.support | |
* @type Boolean | |
*/ | |
support.argsObject = arguments.constructor == Object && !(arguments instanceof Array); | |
/** | |
* Detect if an `arguments` object's [[Class]] is resolvable (all but Firefox < 4, IE < 9). | |
* | |
* @memberOf _.support | |
* @type Boolean | |
*/ | |
support.argsClass = isArguments(arguments); | |
/** | |
* Detect if `name` or `message` properties of `Error.prototype` are | |
* enumerable by default. (IE < 9, Safari < 5.1) | |
* | |
* @memberOf _.support | |
* @type Boolean | |
*/ | |
support.enumErrorProps = propertyIsEnumerable.call(errorProto, 'message') || propertyIsEnumerable.call(errorProto, 'name'); | |
/** | |
* Detect if `prototype` properties are enumerable by default. | |
* | |
* Firefox < 3.6, Opera > 9.50 - Opera < 11.60, and Safari < 5.1 | |
* (if the prototype or a property on the prototype has been set) | |
* incorrectly sets a function's `prototype` property [[Enumerable]] | |
* value to `true`. | |
* | |
* @memberOf _.support | |
* @type Boolean | |
*/ | |
support.enumPrototypes = propertyIsEnumerable.call(ctor, 'prototype'); | |
/** | |
* Detect if `Function#bind` exists and is inferred to be fast (all but V8). | |
* | |
* @memberOf _.support | |
* @type Boolean | |
*/ | |
support.fastBind = nativeBind && !isV8; | |
/** | |
* Detect if own properties are iterated after inherited properties (all but IE < 9). | |
* | |
* @memberOf _.support | |
* @type Boolean | |
*/ | |
support.ownLast = props[0] != 'x'; | |
/** | |
* Detect if `arguments` object indexes are non-enumerable | |
* (Firefox < 4, IE < 9, PhantomJS, Safari < 5.1). | |
* | |
* @memberOf _.support | |
* @type Boolean | |
*/ | |
support.nonEnumArgs = prop != 0; | |
/** | |
* Detect if properties shadowing those on `Object.prototype` are non-enumerable. | |
* | |
* In IE < 9 an objects own properties, shadowing non-enumerable ones, are | |
* made non-enumerable as well (a.k.a the JScript [[DontEnum]] bug). | |
* | |
* @memberOf _.support | |
* @type Boolean | |
*/ | |
support.nonEnumShadows = !/valueOf/.test(props); | |
/** | |
* Detect if `Array#shift` and `Array#splice` augment array-like objects correctly. | |
* | |
* Firefox < 10, IE compatibility mode, and IE < 9 have buggy Array `shift()` | |
* and `splice()` functions that fail to remove the last element, `value[0]`, | |
* of array-like objects even though the `length` property is set to `0`. | |
* The `shift()` method is buggy in IE 8 compatibility mode, while `splice()` | |
* is buggy regardless of mode in IE < 9 and buggy in compatibility mode in IE 9. | |
* | |
* @memberOf _.support | |
* @type Boolean | |
*/ | |
support.spliceObjects = (arrayRef.splice.call(object, 0, 1), !object[0]); | |
/** | |
* Detect lack of support for accessing string characters by index. | |
* | |
* IE < 8 can't access characters by index and IE 8 can only access | |
* characters by index on string literals. | |
* | |
* @memberOf _.support | |
* @type Boolean | |
*/ | |
support.unindexedChars = ('x'[0] + Object('x')[0]) != 'xx'; | |
/** | |
* Detect if a DOM node's [[Class]] is resolvable (all but IE < 9) | |
* and that the JS engine errors when attempting to coerce an object to | |
* a string without a `toString` function. | |
* | |
* @memberOf _.support | |
* @type Boolean | |
*/ | |
try { | |
support.nodeClass = !(toString.call(document) == objectClass && !({ 'toString': 0 } + '')); | |
} catch(e) { | |
support.nodeClass = true; | |
} | |
}(1)); | |
/** | |
* By default, the template delimiters used by Lo-Dash are similar to those in | |
* embedded Ruby (ERB). Change the following template settings to use alternative | |
* delimiters. | |
* | |
* @static | |
* @memberOf _ | |
* @type Object | |
*/ | |
lodash.templateSettings = { | |
/** | |
* Used to detect `data` property values to be HTML-escaped. | |
* | |
* @memberOf _.templateSettings | |
* @type RegExp | |
*/ | |
'escape': /<%-([\s\S]+?)%>/g, | |
/** | |
* Used to detect code to be evaluated. | |
* | |
* @memberOf _.templateSettings | |
* @type RegExp | |
*/ | |
'evaluate': /<%([\s\S]+?)%>/g, | |
/** | |
* Used to detect `data` property values to inject. | |
* | |
* @memberOf _.templateSettings | |
* @type RegExp | |
*/ | |
'interpolate': reInterpolate, | |
/** | |
* Used to reference the data object in the template text. | |
* | |
* @memberOf _.templateSettings | |
* @type String | |
*/ | |
'variable': '', | |
/** | |
* Used to import variables into the compiled template. | |
* | |
* @memberOf _.templateSettings | |
* @type Object | |
*/ | |
'imports': { | |
/** | |
* A reference to the `lodash` function. | |
* | |
* @memberOf _.templateSettings.imports | |
* @type Function | |
*/ | |
'_': lodash | |
} | |
}; | |
/*--------------------------------------------------------------------------*/ | |
/** | |
* The template used to create iterator functions. | |
* | |
* @private | |
* @param {Object} data The data object used to populate the text. | |
* @returns {String} Returns the interpolated text. | |
*/ | |
var iteratorTemplate = function(obj) { | |
var __p = 'var index, iterable = ' + | |
(obj.firstArg) + | |
', result = ' + | |
(obj.init) + | |
';\nif (!iterable) return result;\n' + | |
(obj.top) + | |
';'; | |
if (obj.array) { | |
__p += '\nvar length = iterable.length; index = -1;\nif (' + | |
(obj.array) + | |
') { '; | |
if (support.unindexedChars) { | |
__p += '\n if (isString(iterable)) {\n iterable = iterable.split(\'\')\n } '; | |
} | |
__p += '\n while (++index < length) {\n ' + | |
(obj.loop) + | |
';\n }\n}\nelse { '; | |
} else if (support.nonEnumArgs) { | |
__p += '\n var length = iterable.length; index = -1;\n if (length && isArguments(iterable)) {\n while (++index < length) {\n index += \'\';\n ' + | |
(obj.loop) + | |
';\n }\n } else { '; | |
} | |
if (support.enumPrototypes) { | |
__p += '\n var skipProto = typeof iterable == \'function\';\n '; | |
} | |
if (support.enumErrorProps) { | |
__p += '\n var skipErrorProps = iterable === errorProto || iterable instanceof Error;\n '; | |
} | |
var conditions = []; if (support.enumPrototypes) { conditions.push('!(skipProto && index == "prototype")'); } if (support.enumErrorProps) { conditions.push('!(skipErrorProps && (index == "message" || index == "name"))'); } | |
if (obj.useHas && obj.useKeys) { | |
__p += '\n var ownIndex = -1,\n ownProps = objectTypes[typeof iterable] && keys(iterable),\n length = ownProps ? ownProps.length : 0;\n\n while (++ownIndex < length) {\n index = ownProps[ownIndex];\n'; | |
if (conditions.length) { | |
__p += ' if (' + | |
(conditions.join(' && ')) + | |
') {\n '; | |
} | |
__p += | |
(obj.loop) + | |
'; '; | |
if (conditions.length) { | |
__p += '\n }'; | |
} | |
__p += '\n } '; | |
} else { | |
__p += '\n for (index in iterable) {\n'; | |
if (obj.useHas) { conditions.push("hasOwnProperty.call(iterable, index)"); } if (conditions.length) { | |
__p += ' if (' + | |
(conditions.join(' && ')) + | |
') {\n '; | |
} | |
__p += | |
(obj.loop) + | |
'; '; | |
if (conditions.length) { | |
__p += '\n }'; | |
} | |
__p += '\n } '; | |
if (support.nonEnumShadows) { | |
__p += '\n\n if (iterable !== objectProto) {\n var ctor = iterable.constructor,\n isProto = iterable === (ctor && ctor.prototype),\n className = iterable === stringProto ? stringClass : iterable === errorProto ? errorClass : toString.call(iterable),\n nonEnum = nonEnumProps[className];\n '; | |
for (k = 0; k < 7; k++) { | |
__p += '\n index = \'' + | |
(obj.shadowedProps[k]) + | |
'\';\n if ((!(isProto && nonEnum[index]) && hasOwnProperty.call(iterable, index))'; | |
if (!obj.useHas) { | |
__p += ' || (!nonEnum[index] && iterable[index] !== objectProto[index])'; | |
} | |
__p += ') {\n ' + | |
(obj.loop) + | |
';\n } '; | |
} | |
__p += '\n } '; | |
} | |
} | |
if (obj.array || support.nonEnumArgs) { | |
__p += '\n}'; | |
} | |
__p += | |
(obj.bottom) + | |
';\nreturn result'; | |
return __p | |
}; | |
/** Reusable iterator options for `assign` and `defaults` */ | |
var defaultsIteratorOptions = { | |
'args': 'object, source, guard', | |
'top': | |
'var args = arguments,\n' + | |
' argsIndex = 0,\n' + | |
" argsLength = typeof guard == 'number' ? 2 : args.length;\n" + | |
'while (++argsIndex < argsLength) {\n' + | |
' iterable = args[argsIndex];\n' + | |
' if (iterable && objectTypes[typeof iterable]) {', | |
'loop': "if (typeof result[index] == 'undefined') result[index] = iterable[index]", | |
'bottom': ' }\n}' | |
}; | |
/** Reusable iterator options shared by `each`, `forIn`, and `forOwn` */ | |
var eachIteratorOptions = { | |
'args': 'collection, callback, thisArg', | |
'top': "callback = callback && typeof thisArg == 'undefined' ? callback : lodash.createCallback(callback, thisArg)", | |
'array': "typeof length == 'number'", | |
'loop': 'if (callback(iterable[index], index, collection) === false) return result' | |
}; | |
/** Reusable iterator options for `forIn` and `forOwn` */ | |
var forOwnIteratorOptions = { | |
'top': 'if (!objectTypes[typeof iterable]) return result;\n' + eachIteratorOptions.top, | |
'array': false | |
}; | |
/*--------------------------------------------------------------------------*/ | |
/** | |
* Creates a function that, when called, invokes `func` with the `this` binding | |
* of `thisArg` and prepends any `partialArgs` to the arguments passed to the | |
* bound function. | |
* | |
* @private | |
* @param {Function|String} func The function to bind or the method name. | |
* @param {Mixed} [thisArg] The `this` binding of `func`. | |
* @param {Array} partialArgs An array of arguments to be partially applied. | |
* @param {Object} [idicator] Used to indicate binding by key or partially | |
* applying arguments from the right. | |
* @returns {Function} Returns the new bound function. | |
*/ | |
function createBound(func, thisArg, partialArgs, indicator) { | |
var isFunc = isFunction(func), | |
isPartial = !partialArgs, | |
key = thisArg; | |
// juggle arguments | |
if (isPartial) { | |
var rightIndicator = indicator; | |
partialArgs = thisArg; | |
} | |
else if (!isFunc) { | |
if (!indicator) { | |
throw new TypeError; | |
} | |
thisArg = func; | |
} | |
function bound() { | |
// `Function#bind` spec | |
// http://es5.github.com/#x15.3.4.5 | |
var args = arguments, | |
thisBinding = isPartial ? this : thisArg; | |
if (!isFunc) { | |
func = thisArg[key]; | |
} | |
if (partialArgs.length) { | |
args = args.length | |
? (args = nativeSlice.call(args), rightIndicator ? args.concat(partialArgs) : partialArgs.concat(args)) | |
: partialArgs; | |
} | |
if (this instanceof bound) { | |
// ensure `new bound` is an instance of `func` | |
thisBinding = createObject(func.prototype); | |
// mimic the constructor's `return` behavior | |
// http://es5.github.com/#x13.2.2 | |
var result = func.apply(thisBinding, args); | |
return isObject(result) ? result : thisBinding; | |
} | |
return func.apply(thisBinding, args); | |
} | |
return bound; | |
} | |
/** | |
* Creates compiled iteration functions. | |
* | |
* @private | |
* @param {Object} [options1, options2, ...] The compile options object(s). | |
* array - A string of code to determine if the iterable is an array or array-like. | |
* useHas - A boolean to specify using `hasOwnProperty` checks in the object loop. | |
* useKeys - A boolean to specify using `_.keys` for own property iteration. | |
* args - A string of comma separated arguments the iteration function will accept. | |
* top - A string of code to execute before the iteration branches. | |
* loop - A string of code to execute in the object loop. | |
* bottom - A string of code to execute after the iteration branches. | |
* @returns {Function} Returns the compiled function. | |
*/ | |
function createIterator() { | |
var data = getObject(); | |
// data properties | |
data.shadowedProps = shadowedProps; | |
// iterator options | |
data.array = data.bottom = data.loop = data.top = ''; | |
data.init = 'iterable'; | |
data.useHas = true; | |
data.useKeys = !!keys; | |
// merge options into a template data object | |
for (var object, index = 0; object = arguments[index]; index++) { | |
for (var key in object) { | |
data[key] = object[key]; | |
} | |
} | |
var args = data.args; | |
data.firstArg = /^[^,]+/.exec(args)[0]; | |
// create the function factory | |
var factory = Function( | |
'errorClass, errorProto, hasOwnProperty, isArguments, isArray, ' + | |
'isString, keys, lodash, objectProto, objectTypes, nonEnumProps, ' + | |
'stringClass, stringProto, toString', | |
'return function(' + args + ') {\n' + iteratorTemplate(data) + '\n}' | |
); | |
releaseObject(data); | |
// return the compiled function | |
return factory( | |
errorClass, errorProto, hasOwnProperty, isArguments, isArray, | |
isString, keys, lodash, objectProto, objectTypes, nonEnumProps, | |
stringClass, stringProto, toString | |
); | |
} | |
/** | |
* Creates a new object with the specified `prototype`. | |
* | |
* @private | |
* @param {Object} prototype The prototype object. | |
* @returns {Object} Returns the new object. | |
*/ | |
function createObject(prototype) { | |
return isObject(prototype) ? nativeCreate(prototype) : {}; | |
} | |
// fallback for browsers without `Object.create` | |
if (!nativeCreate) { | |
var createObject = function(prototype) { | |
if (isObject(prototype)) { | |
noop.prototype = prototype; | |
var result = new noop; | |
noop.prototype = null; | |
} | |
return result || {}; | |
}; | |
} | |
/** | |
* Used by `escape` to convert characters to HTML entities. | |
* | |
* @private | |
* @param {String} match The matched character to escape. | |
* @returns {String} Returns the escaped character. | |
*/ | |
function escapeHtmlChar(match) { | |
return htmlEscapes[match]; | |
} | |
/** | |
* Gets the appropriate "indexOf" function. If the `_.indexOf` method is | |
* customized, this method returns the custom method, otherwise it returns | |
* the `basicIndexOf` function. | |
* | |
* @private | |
* @returns {Function} Returns the "indexOf" function. | |
*/ | |
function getIndexOf(array, value, fromIndex) { | |
var result = (result = lodash.indexOf) === indexOf ? basicIndexOf : result; | |
return result; | |
} | |
/** | |
* Creates a function that juggles arguments, allowing argument overloading | |
* for `_.flatten` and `_.uniq`, before passing them to the given `func`. | |
* | |
* @private | |
* @param {Function} func The function to wrap. | |
* @returns {Function} Returns the new function. | |
*/ | |
function overloadWrapper(func) { | |
return function(array, flag, callback, thisArg) { | |
// juggle arguments | |
if (typeof flag != 'boolean' && flag != null) { | |
thisArg = callback; | |
callback = !(thisArg && thisArg[flag] === array) ? flag : undefined; | |
flag = false; | |
} | |
if (callback != null) { | |
callback = lodash.createCallback(callback, thisArg); | |
} | |
return func(array, flag, callback, thisArg); | |
}; | |
} | |
/** | |
* A fallback implementation of `isPlainObject` which checks if a given `value` | |
* is an object created by the `Object` constructor, assuming objects created | |
* by the `Object` constructor have no inherited enumerable properties and that | |
* there are no `Object.prototype` extensions. | |
* | |
* @private | |
* @param {Mixed} value The value to check. | |
* @returns {Boolean} Returns `true`, if `value` is a plain object, else `false`. | |
*/ | |
function shimIsPlainObject(value) { | |
var ctor, | |
result; | |
// avoid non Object objects, `arguments` objects, and DOM elements | |
if (!(value && toString.call(value) == objectClass) || | |
(ctor = value.constructor, isFunction(ctor) && !(ctor instanceof ctor)) || | |
(!support.argsClass && isArguments(value)) || | |
(!support.nodeClass && isNode(value))) { | |
return false; | |
} | |
// IE < 9 iterates inherited properties before own properties. If the first | |
// iterated property is an object's own property then there are no inherited | |
// enumerable properties. | |
if (support.ownLast) { | |
forIn(value, function(value, key, object) { | |
result = hasOwnProperty.call(object, key); | |
return false; | |
}); | |
return result !== false; | |
} | |
// In most environments an object's own properties are iterated before | |
// its inherited properties. If the last iterated property is an object's | |
// own property then there are no inherited enumerable properties. | |
forIn(value, function(value, key) { | |
result = key; | |
}); | |
return result === undefined || hasOwnProperty.call(value, result); | |
} | |
/** | |
* Used by `unescape` to convert HTML entities to characters. | |
* | |
* @private | |
* @param {String} match The matched character to unescape. | |
* @returns {String} Returns the unescaped character. | |
*/ | |
function unescapeHtmlChar(match) { | |
return htmlUnescapes[match]; | |
} | |
/*--------------------------------------------------------------------------*/ | |
/** | |
* Checks if `value` is an `arguments` object. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Mixed} value The value to check. | |
* @returns {Boolean} Returns `true`, if the `value` is an `arguments` object, else `false`. | |
* @example | |
* | |
* (function() { return _.isArguments(arguments); })(1, 2, 3); | |
* // => true | |
* | |
* _.isArguments([1, 2, 3]); | |
* // => false | |
*/ | |
function isArguments(value) { | |
return toString.call(value) == argsClass; | |
} | |
// fallback for browsers that can't detect `arguments` objects by [[Class]] | |
if (!support.argsClass) { | |
isArguments = function(value) { | |
return value ? hasOwnProperty.call(value, 'callee') : false; | |
}; | |
} | |
/** | |
* Checks if `value` is an array. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Mixed} value The value to check. | |
* @returns {Boolean} Returns `true`, if the `value` is an array, else `false`. | |
* @example | |
* | |
* (function() { return _.isArray(arguments); })(); | |
* // => false | |
* | |
* _.isArray([1, 2, 3]); | |
* // => true | |
*/ | |
var isArray = nativeIsArray || function(value) { | |
return value ? (typeof value == 'object' && toString.call(value) == arrayClass) : false; | |
}; | |
/** | |
* A fallback implementation of `Object.keys` which produces an array of the | |
* given object's own enumerable property names. | |
* | |
* @private | |
* @type Function | |
* @param {Object} object The object to inspect. | |
* @returns {Array} Returns a new array of property names. | |
*/ | |
var shimKeys = createIterator({ | |
'args': 'object', | |
'init': '[]', | |
'top': 'if (!(objectTypes[typeof object])) return result', | |
'loop': 'result.push(index)' | |
}); | |
/** | |
* Creates an array composed of the own enumerable property names of `object`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Object} object The object to inspect. | |
* @returns {Array} Returns a new array of property names. | |
* @example | |
* | |
* _.keys({ 'one': 1, 'two': 2, 'three': 3 }); | |
* // => ['one', 'two', 'three'] (order is not guaranteed) | |
*/ | |
var keys = !nativeKeys ? shimKeys : function(object) { | |
if (!isObject(object)) { | |
return []; | |
} | |
if ((support.enumPrototypes && typeof object == 'function') || | |
(support.nonEnumArgs && object.length && isArguments(object))) { | |
return shimKeys(object); | |
} | |
return nativeKeys(object); | |
}; | |
/** | |
* A function compiled to iterate `arguments` objects, arrays, objects, and | |
* strings consistenly across environments, executing the `callback` for each | |
* element in the `collection`. The `callback` is bound to `thisArg` and invoked | |
* with three arguments; (value, index|key, collection). Callbacks may exit | |
* iteration early by explicitly returning `false`. | |
* | |
* @private | |
* @type Function | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Function} [callback=identity] The function called per iteration. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Array|Object|String} Returns `collection`. | |
*/ | |
var basicEach = createIterator(eachIteratorOptions); | |
/** | |
* Used to convert characters to HTML entities: | |
* | |
* Though the `>` character is escaped for symmetry, characters like `>` and `/` | |
* don't require escaping in HTML and have no special meaning unless they're part | |
* of a tag or an unquoted attribute value. | |
* http://mathiasbynens.be/notes/ambiguous-ampersands (under "semi-related fun fact") | |
*/ | |
var htmlEscapes = { | |
'&': '&', | |
'<': '<', | |
'>': '>', | |
'"': '"', | |
"'": ''' | |
}; | |
/** Used to convert HTML entities to characters */ | |
var htmlUnescapes = invert(htmlEscapes); | |
/*--------------------------------------------------------------------------*/ | |
/** | |
* Assigns own enumerable properties of source object(s) to the destination | |
* object. Subsequent sources will overwrite property assignments of previous | |
* sources. If a `callback` function is passed, it will be executed to produce | |
* the assigned values. The `callback` is bound to `thisArg` and invoked with | |
* two arguments; (objectValue, sourceValue). | |
* | |
* @static | |
* @memberOf _ | |
* @type Function | |
* @alias extend | |
* @category Objects | |
* @param {Object} object The destination object. | |
* @param {Object} [source1, source2, ...] The source objects. | |
* @param {Function} [callback] The function to customize assigning values. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Object} Returns the destination object. | |
* @example | |
* | |
* _.assign({ 'name': 'moe' }, { 'age': 40 }); | |
* // => { 'name': 'moe', 'age': 40 } | |
* | |
* var defaults = _.partialRight(_.assign, function(a, b) { | |
* return typeof a == 'undefined' ? b : a; | |
* }); | |
* | |
* var food = { 'name': 'apple' }; | |
* defaults(food, { 'name': 'banana', 'type': 'fruit' }); | |
* // => { 'name': 'apple', 'type': 'fruit' } | |
*/ | |
var assign = createIterator(defaultsIteratorOptions, { | |
'top': | |
defaultsIteratorOptions.top.replace(';', | |
';\n' + | |
"if (argsLength > 3 && typeof args[argsLength - 2] == 'function') {\n" + | |
' var callback = lodash.createCallback(args[--argsLength - 1], args[argsLength--], 2);\n' + | |
"} else if (argsLength > 2 && typeof args[argsLength - 1] == 'function') {\n" + | |
' callback = args[--argsLength];\n' + | |
'}' | |
), | |
'loop': 'result[index] = callback ? callback(result[index], iterable[index]) : iterable[index]' | |
}); | |
/** | |
* Creates a clone of `value`. If `deep` is `true`, nested objects will also | |
* be cloned, otherwise they will be assigned by reference. If a `callback` | |
* function is passed, it will be executed to produce the cloned values. If | |
* `callback` returns `undefined`, cloning will be handled by the method instead. | |
* The `callback` is bound to `thisArg` and invoked with one argument; (value). | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Mixed} value The value to clone. | |
* @param {Boolean} [deep=false] A flag to indicate a deep clone. | |
* @param {Function} [callback] The function to customize cloning values. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @param- {Array} [stackA=[]] Tracks traversed source objects. | |
* @param- {Array} [stackB=[]] Associates clones with source counterparts. | |
* @returns {Mixed} Returns the cloned `value`. | |
* @example | |
* | |
* var stooges = [ | |
* { 'name': 'moe', 'age': 40 }, | |
* { 'name': 'larry', 'age': 50 } | |
* ]; | |
* | |
* var shallow = _.clone(stooges); | |
* shallow[0] === stooges[0]; | |
* // => true | |
* | |
* var deep = _.clone(stooges, true); | |
* deep[0] === stooges[0]; | |
* // => false | |
* | |
* _.mixin({ | |
* 'clone': _.partialRight(_.clone, function(value) { | |
* return _.isElement(value) ? value.cloneNode(false) : undefined; | |
* }) | |
* }); | |
* | |
* var clone = _.clone(document.body); | |
* clone.childNodes.length; | |
* // => 0 | |
*/ | |
function clone(value, deep, callback, thisArg, stackA, stackB) { | |
var result = value; | |
// allows working with "Collections" methods without using their `callback` | |
// argument, `index|key`, for this method's `callback` | |
if (typeof deep != 'boolean' && deep != null) { | |
thisArg = callback; | |
callback = deep; | |
deep = false; | |
} | |
if (typeof callback == 'function') { | |
callback = (typeof thisArg == 'undefined') | |
? callback | |
: lodash.createCallback(callback, thisArg, 1); | |
result = callback(result); | |
if (typeof result != 'undefined') { | |
return result; | |
} | |
result = value; | |
} | |
// inspect [[Class]] | |
var isObj = isObject(result); | |
if (isObj) { | |
var className = toString.call(result); | |
if (!cloneableClasses[className] || (!support.nodeClass && isNode(result))) { | |
return result; | |
} | |
var isArr = isArray(result); | |
} | |
// shallow clone | |
if (!isObj || !deep) { | |
return isObj | |
? (isArr ? slice(result) : assign({}, result)) | |
: result; | |
} | |
var ctor = ctorByClass[className]; | |
switch (className) { | |
case boolClass: | |
case dateClass: | |
return new ctor(+result); | |
case numberClass: | |
case stringClass: | |
return new ctor(result); | |
case regexpClass: | |
return ctor(result.source, reFlags.exec(result)); | |
} | |
// check for circular references and return corresponding clone | |
var initedStack = !stackA; | |
stackA || (stackA = getArray()); | |
stackB || (stackB = getArray()); | |
var length = stackA.length; | |
while (length--) { | |
if (stackA[length] == value) { | |
return stackB[length]; | |
} | |
} | |
// init cloned object | |
result = isArr ? ctor(result.length) : {}; | |
// add array properties assigned by `RegExp#exec` | |
if (isArr) { | |
if (hasOwnProperty.call(value, 'index')) { | |
result.index = value.index; | |
} | |
if (hasOwnProperty.call(value, 'input')) { | |
result.input = value.input; | |
} | |
} | |
// add the source value to the stack of traversed objects | |
// and associate it with its clone | |
stackA.push(value); | |
stackB.push(result); | |
// recursively populate clone (susceptible to call stack limits) | |
(isArr ? basicEach : forOwn)(value, function(objValue, key) { | |
result[key] = clone(objValue, deep, callback, undefined, stackA, stackB); | |
}); | |
if (initedStack) { | |
releaseArray(stackA); | |
releaseArray(stackB); | |
} | |
return result; | |
} | |
/** | |
* Creates a deep clone of `value`. If a `callback` function is passed, | |
* it will be executed to produce the cloned values. If `callback` returns | |
* `undefined`, cloning will be handled by the method instead. The `callback` | |
* is bound to `thisArg` and invoked with one argument; (value). | |
* | |
* Note: This method is loosely based on the structured clone algorithm. Functions | |
* and DOM nodes are **not** cloned. The enumerable properties of `arguments` objects and | |
* objects created by constructors other than `Object` are cloned to plain `Object` objects. | |
* See http://www.w3.org/TR/html5/infrastructure.html#internal-structured-cloning-algorithm. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Mixed} value The value to deep clone. | |
* @param {Function} [callback] The function to customize cloning values. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Mixed} Returns the deep cloned `value`. | |
* @example | |
* | |
* var stooges = [ | |
* { 'name': 'moe', 'age': 40 }, | |
* { 'name': 'larry', 'age': 50 } | |
* ]; | |
* | |
* var deep = _.cloneDeep(stooges); | |
* deep[0] === stooges[0]; | |
* // => false | |
* | |
* var view = { | |
* 'label': 'docs', | |
* 'node': element | |
* }; | |
* | |
* var clone = _.cloneDeep(view, function(value) { | |
* return _.isElement(value) ? value.cloneNode(true) : undefined; | |
* }); | |
* | |
* clone.node == view.node; | |
* // => false | |
*/ | |
function cloneDeep(value, callback, thisArg) { | |
return clone(value, true, callback, thisArg); | |
} | |
/** | |
* Assigns own enumerable properties of source object(s) to the destination | |
* object for all destination properties that resolve to `undefined`. Once a | |
* property is set, additional defaults of the same property will be ignored. | |
* | |
* @static | |
* @memberOf _ | |
* @type Function | |
* @category Objects | |
* @param {Object} object The destination object. | |
* @param {Object} [source1, source2, ...] The source objects. | |
* @param- {Object} [guard] Allows working with `_.reduce` without using its | |
* callback's `key` and `object` arguments as sources. | |
* @returns {Object} Returns the destination object. | |
* @example | |
* | |
* var food = { 'name': 'apple' }; | |
* _.defaults(food, { 'name': 'banana', 'type': 'fruit' }); | |
* // => { 'name': 'apple', 'type': 'fruit' } | |
*/ | |
var defaults = createIterator(defaultsIteratorOptions); | |
/** | |
* This method is similar to `_.find`, except that it returns the key of the | |
* element that passes the callback check, instead of the element itself. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Object} object The object to search. | |
* @param {Function|Object|String} [callback=identity] The function called per | |
* iteration. If a property name or object is passed, it will be used to create | |
* a "_.pluck" or "_.where" style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Mixed} Returns the key of the found element, else `undefined`. | |
* @example | |
* | |
* _.findKey({ 'a': 1, 'b': 2, 'c': 3, 'd': 4 }, function(num) { | |
* return num % 2 == 0; | |
* }); | |
* // => 'b' | |
*/ | |
function findKey(object, callback, thisArg) { | |
var result; | |
callback = lodash.createCallback(callback, thisArg); | |
forOwn(object, function(value, key, object) { | |
if (callback(value, key, object)) { | |
result = key; | |
return false; | |
} | |
}); | |
return result; | |
} | |
/** | |
* Iterates over `object`'s own and inherited enumerable properties, executing | |
* the `callback` for each property. The `callback` is bound to `thisArg` and | |
* invoked with three arguments; (value, key, object). Callbacks may exit iteration | |
* early by explicitly returning `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @type Function | |
* @category Objects | |
* @param {Object} object The object to iterate over. | |
* @param {Function} [callback=identity] The function called per iteration. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Object} Returns `object`. | |
* @example | |
* | |
* function Dog(name) { | |
* this.name = name; | |
* } | |
* | |
* Dog.prototype.bark = function() { | |
* alert('Woof, woof!'); | |
* }; | |
* | |
* _.forIn(new Dog('Dagny'), function(value, key) { | |
* alert(key); | |
* }); | |
* // => alerts 'name' and 'bark' (order is not guaranteed) | |
*/ | |
var forIn = createIterator(eachIteratorOptions, forOwnIteratorOptions, { | |
'useHas': false | |
}); | |
/** | |
* Iterates over an object's own enumerable properties, executing the `callback` | |
* for each property. The `callback` is bound to `thisArg` and invoked with three | |
* arguments; (value, key, object). Callbacks may exit iteration early by explicitly | |
* returning `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @type Function | |
* @category Objects | |
* @param {Object} object The object to iterate over. | |
* @param {Function} [callback=identity] The function called per iteration. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Object} Returns `object`. | |
* @example | |
* | |
* _.forOwn({ '0': 'zero', '1': 'one', 'length': 2 }, function(num, key) { | |
* alert(key); | |
* }); | |
* // => alerts '0', '1', and 'length' (order is not guaranteed) | |
*/ | |
var forOwn = createIterator(eachIteratorOptions, forOwnIteratorOptions); | |
/** | |
* Creates a sorted array of all enumerable properties, own and inherited, | |
* of `object` that have function values. | |
* | |
* @static | |
* @memberOf _ | |
* @alias methods | |
* @category Objects | |
* @param {Object} object The object to inspect. | |
* @returns {Array} Returns a new array of property names that have function values. | |
* @example | |
* | |
* _.functions(_); | |
* // => ['all', 'any', 'bind', 'bindAll', 'clone', 'compact', 'compose', ...] | |
*/ | |
function functions(object) { | |
var result = []; | |
forIn(object, function(value, key) { | |
if (isFunction(value)) { | |
result.push(key); | |
} | |
}); | |
return result.sort(); | |
} | |
/** | |
* Checks if the specified object `property` exists and is a direct property, | |
* instead of an inherited property. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Object} object The object to check. | |
* @param {String} property The property to check for. | |
* @returns {Boolean} Returns `true` if key is a direct property, else `false`. | |
* @example | |
* | |
* _.has({ 'a': 1, 'b': 2, 'c': 3 }, 'b'); | |
* // => true | |
*/ | |
function has(object, property) { | |
return object ? hasOwnProperty.call(object, property) : false; | |
} | |
/** | |
* Creates an object composed of the inverted keys and values of the given `object`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Object} object The object to invert. | |
* @returns {Object} Returns the created inverted object. | |
* @example | |
* | |
* _.invert({ 'first': 'moe', 'second': 'larry' }); | |
* // => { 'moe': 'first', 'larry': 'second' } | |
*/ | |
function invert(object) { | |
var index = -1, | |
props = keys(object), | |
length = props.length, | |
result = {}; | |
while (++index < length) { | |
var key = props[index]; | |
result[object[key]] = key; | |
} | |
return result; | |
} | |
/** | |
* Checks if `value` is a boolean value. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Mixed} value The value to check. | |
* @returns {Boolean} Returns `true`, if the `value` is a boolean value, else `false`. | |
* @example | |
* | |
* _.isBoolean(null); | |
* // => false | |
*/ | |
function isBoolean(value) { | |
return value === true || value === false || toString.call(value) == boolClass; | |
} | |
/** | |
* Checks if `value` is a date. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Mixed} value The value to check. | |
* @returns {Boolean} Returns `true`, if the `value` is a date, else `false`. | |
* @example | |
* | |
* _.isDate(new Date); | |
* // => true | |
*/ | |
function isDate(value) { | |
return value ? (typeof value == 'object' && toString.call(value) == dateClass) : false; | |
} | |
/** | |
* Checks if `value` is a DOM element. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Mixed} value The value to check. | |
* @returns {Boolean} Returns `true`, if the `value` is a DOM element, else `false`. | |
* @example | |
* | |
* _.isElement(document.body); | |
* // => true | |
*/ | |
function isElement(value) { | |
return value ? value.nodeType === 1 : false; | |
} | |
/** | |
* Checks if `value` is empty. Arrays, strings, or `arguments` objects with a | |
* length of `0` and objects with no own enumerable properties are considered | |
* "empty". | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Array|Object|String} value The value to inspect. | |
* @returns {Boolean} Returns `true`, if the `value` is empty, else `false`. | |
* @example | |
* | |
* _.isEmpty([1, 2, 3]); | |
* // => false | |
* | |
* _.isEmpty({}); | |
* // => true | |
* | |
* _.isEmpty(''); | |
* // => true | |
*/ | |
function isEmpty(value) { | |
var result = true; | |
if (!value) { | |
return result; | |
} | |
var className = toString.call(value), | |
length = value.length; | |
if ((className == arrayClass || className == stringClass || | |
(support.argsClass ? className == argsClass : isArguments(value))) || | |
(className == objectClass && typeof length == 'number' && isFunction(value.splice))) { | |
return !length; | |
} | |
forOwn(value, function() { | |
return (result = false); | |
}); | |
return result; | |
} | |
/** | |
* Performs a deep comparison between two values to determine if they are | |
* equivalent to each other. If `callback` is passed, it will be executed to | |
* compare values. If `callback` returns `undefined`, comparisons will be handled | |
* by the method instead. The `callback` is bound to `thisArg` and invoked with | |
* two arguments; (a, b). | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Mixed} a The value to compare. | |
* @param {Mixed} b The other value to compare. | |
* @param {Function} [callback] The function to customize comparing values. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @param- {Array} [stackA=[]] Tracks traversed `a` objects. | |
* @param- {Array} [stackB=[]] Tracks traversed `b` objects. | |
* @returns {Boolean} Returns `true`, if the values are equivalent, else `false`. | |
* @example | |
* | |
* var moe = { 'name': 'moe', 'age': 40 }; | |
* var copy = { 'name': 'moe', 'age': 40 }; | |
* | |
* moe == copy; | |
* // => false | |
* | |
* _.isEqual(moe, copy); | |
* // => true | |
* | |
* var words = ['hello', 'goodbye']; | |
* var otherWords = ['hi', 'goodbye']; | |
* | |
* _.isEqual(words, otherWords, function(a, b) { | |
* var reGreet = /^(?:hello|hi)$/i, | |
* aGreet = _.isString(a) && reGreet.test(a), | |
* bGreet = _.isString(b) && reGreet.test(b); | |
* | |
* return (aGreet || bGreet) ? (aGreet == bGreet) : undefined; | |
* }); | |
* // => true | |
*/ | |
function isEqual(a, b, callback, thisArg, stackA, stackB) { | |
// used to indicate that when comparing objects, `a` has at least the properties of `b` | |
var whereIndicator = callback === indicatorObject; | |
if (typeof callback == 'function' && !whereIndicator) { | |
callback = lodash.createCallback(callback, thisArg, 2); | |
var result = callback(a, b); | |
if (typeof result != 'undefined') { | |
return !!result; | |
} | |
} | |
// exit early for identical values | |
if (a === b) { | |
// treat `+0` vs. `-0` as not equal | |
return a !== 0 || (1 / a == 1 / b); | |
} | |
var type = typeof a, | |
otherType = typeof b; | |
// exit early for unlike primitive values | |
if (a === a && | |
(!a || (type != 'function' && type != 'object')) && | |
(!b || (otherType != 'function' && otherType != 'object'))) { | |
return false; | |
} | |
// exit early for `null` and `undefined`, avoiding ES3's Function#call behavior | |
// http://es5.github.com/#x15.3.4.4 | |
if (a == null || b == null) { | |
return a === b; | |
} | |
// compare [[Class]] names | |
var className = toString.call(a), | |
otherClass = toString.call(b); | |
if (className == argsClass) { | |
className = objectClass; | |
} | |
if (otherClass == argsClass) { | |
otherClass = objectClass; | |
} | |
if (className != otherClass) { | |
return false; | |
} | |
switch (className) { | |
case boolClass: | |
case dateClass: | |
// coerce dates and booleans to numbers, dates to milliseconds and booleans | |
// to `1` or `0`, treating invalid dates coerced to `NaN` as not equal | |
return +a == +b; | |
case numberClass: | |
// treat `NaN` vs. `NaN` as equal | |
return (a != +a) | |
? b != +b | |
// but treat `+0` vs. `-0` as not equal | |
: (a == 0 ? (1 / a == 1 / b) : a == +b); | |
case regexpClass: | |
case stringClass: | |
// coerce regexes to strings (http://es5.github.com/#x15.10.6.4) | |
// treat string primitives and their corresponding object instances as equal | |
return a == String(b); | |
} | |
var isArr = className == arrayClass; | |
if (!isArr) { | |
// unwrap any `lodash` wrapped values | |
if (hasOwnProperty.call(a, '__wrapped__ ') || hasOwnProperty.call(b, '__wrapped__')) { | |
return isEqual(a.__wrapped__ || a, b.__wrapped__ || b, callback, thisArg, stackA, stackB); | |
} | |
// exit for functions and DOM nodes | |
if (className != objectClass || (!support.nodeClass && (isNode(a) || isNode(b)))) { | |
return false; | |
} | |
// in older versions of Opera, `arguments` objects have `Array` constructors | |
var ctorA = !support.argsObject && isArguments(a) ? Object : a.constructor, | |
ctorB = !support.argsObject && isArguments(b) ? Object : b.constructor; | |
// non `Object` object instances with different constructors are not equal | |
if (ctorA != ctorB && !( | |
isFunction(ctorA) && ctorA instanceof ctorA && | |
isFunction(ctorB) && ctorB instanceof ctorB | |
)) { | |
return false; | |
} | |
} | |
// assume cyclic structures are equal | |
// the algorithm for detecting cyclic structures is adapted from ES 5.1 | |
// section 15.12.3, abstract operation `JO` (http://es5.github.com/#x15.12.3) | |
var initedStack = !stackA; | |
stackA || (stackA = getArray()); | |
stackB || (stackB = getArray()); | |
var length = stackA.length; | |
while (length--) { | |
if (stackA[length] == a) { | |
return stackB[length] == b; | |
} | |
} | |
var size = 0; | |
result = true; | |
// add `a` and `b` to the stack of traversed objects | |
stackA.push(a); | |
stackB.push(b); | |
// recursively compare objects and arrays (susceptible to call stack limits) | |
if (isArr) { | |
length = a.length; | |
size = b.length; | |
// compare lengths to determine if a deep comparison is necessary | |
result = size == a.length; | |
if (!result && !whereIndicator) { | |
return result; | |
} | |
// deep compare the contents, ignoring non-numeric properties | |
while (size--) { | |
var index = length, | |
value = b[size]; | |
if (whereIndicator) { | |
while (index--) { | |
if ((result = isEqual(a[index], value, callback, thisArg, stackA, stackB))) { | |
break; | |
} | |
} | |
} else if (!(result = isEqual(a[size], value, callback, thisArg, stackA, stackB))) { | |
break; | |
} | |
} | |
return result; | |
} | |
// deep compare objects using `forIn`, instead of `forOwn`, to avoid `Object.keys` | |
// which, in this case, is more costly | |
forIn(b, function(value, key, b) { | |
if (hasOwnProperty.call(b, key)) { | |
// count the number of properties. | |
size++; | |
// deep compare each property value. | |
return (result = hasOwnProperty.call(a, key) && isEqual(a[key], value, callback, thisArg, stackA, stackB)); | |
} | |
}); | |
if (result && !whereIndicator) { | |
// ensure both objects have the same number of properties | |
forIn(a, function(value, key, a) { | |
if (hasOwnProperty.call(a, key)) { | |
// `size` will be `-1` if `a` has more properties than `b` | |
return (result = --size > -1); | |
} | |
}); | |
} | |
if (initedStack) { | |
releaseArray(stackA); | |
releaseArray(stackB); | |
} | |
return result; | |
} | |
/** | |
* Checks if `value` is, or can be coerced to, a finite number. | |
* | |
* Note: This is not the same as native `isFinite`, which will return true for | |
* booleans and empty strings. See http://es5.github.com/#x15.1.2.5. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Mixed} value The value to check. | |
* @returns {Boolean} Returns `true`, if the `value` is finite, else `false`. | |
* @example | |
* | |
* _.isFinite(-101); | |
* // => true | |
* | |
* _.isFinite('10'); | |
* // => true | |
* | |
* _.isFinite(true); | |
* // => false | |
* | |
* _.isFinite(''); | |
* // => false | |
* | |
* _.isFinite(Infinity); | |
* // => false | |
*/ | |
function isFinite(value) { | |
return nativeIsFinite(value) && !nativeIsNaN(parseFloat(value)); | |
} | |
/** | |
* Checks if `value` is a function. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Mixed} value The value to check. | |
* @returns {Boolean} Returns `true`, if the `value` is a function, else `false`. | |
* @example | |
* | |
* _.isFunction(_); | |
* // => true | |
*/ | |
function isFunction(value) { | |
return typeof value == 'function'; | |
} | |
// fallback for older versions of Chrome and Safari | |
if (isFunction(/x/)) { | |
isFunction = function(value) { | |
return typeof value == 'function' && toString.call(value) == funcClass; | |
}; | |
} | |
/** | |
* Checks if `value` is the language type of Object. | |
* (e.g. arrays, functions, objects, regexes, `new Number(0)`, and `new String('')`) | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Mixed} value The value to check. | |
* @returns {Boolean} Returns `true`, if the `value` is an object, else `false`. | |
* @example | |
* | |
* _.isObject({}); | |
* // => true | |
* | |
* _.isObject([1, 2, 3]); | |
* // => true | |
* | |
* _.isObject(1); | |
* // => false | |
*/ | |
function isObject(value) { | |
// check if the value is the ECMAScript language type of Object | |
// http://es5.github.com/#x8 | |
// and avoid a V8 bug | |
// http://code.google.com/p/v8/issues/detail?id=2291 | |
return !!(value && objectTypes[typeof value]); | |
} | |
/** | |
* Checks if `value` is `NaN`. | |
* | |
* Note: This is not the same as native `isNaN`, which will return `true` for | |
* `undefined` and other values. See http://es5.github.com/#x15.1.2.4. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Mixed} value The value to check. | |
* @returns {Boolean} Returns `true`, if the `value` is `NaN`, else `false`. | |
* @example | |
* | |
* _.isNaN(NaN); | |
* // => true | |
* | |
* _.isNaN(new Number(NaN)); | |
* // => true | |
* | |
* isNaN(undefined); | |
* // => true | |
* | |
* _.isNaN(undefined); | |
* // => false | |
*/ | |
function isNaN(value) { | |
// `NaN` as a primitive is the only value that is not equal to itself | |
// (perform the [[Class]] check first to avoid errors with some host objects in IE) | |
return isNumber(value) && value != +value | |
} | |
/** | |
* Checks if `value` is `null`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Mixed} value The value to check. | |
* @returns {Boolean} Returns `true`, if the `value` is `null`, else `false`. | |
* @example | |
* | |
* _.isNull(null); | |
* // => true | |
* | |
* _.isNull(undefined); | |
* // => false | |
*/ | |
function isNull(value) { | |
return value === null; | |
} | |
/** | |
* Checks if `value` is a number. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Mixed} value The value to check. | |
* @returns {Boolean} Returns `true`, if the `value` is a number, else `false`. | |
* @example | |
* | |
* _.isNumber(8.4 * 5); | |
* // => true | |
*/ | |
function isNumber(value) { | |
return typeof value == 'number' || toString.call(value) == numberClass; | |
} | |
/** | |
* Checks if a given `value` is an object created by the `Object` constructor. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Mixed} value The value to check. | |
* @returns {Boolean} Returns `true`, if `value` is a plain object, else `false`. | |
* @example | |
* | |
* function Stooge(name, age) { | |
* this.name = name; | |
* this.age = age; | |
* } | |
* | |
* _.isPlainObject(new Stooge('moe', 40)); | |
* // => false | |
* | |
* _.isPlainObject([1, 2, 3]); | |
* // => false | |
* | |
* _.isPlainObject({ 'name': 'moe', 'age': 40 }); | |
* // => true | |
*/ | |
var isPlainObject = !getPrototypeOf ? shimIsPlainObject : function(value) { | |
if (!(value && toString.call(value) == objectClass) || (!support.argsClass && isArguments(value))) { | |
return false; | |
} | |
var valueOf = value.valueOf, | |
objProto = typeof valueOf == 'function' && (objProto = getPrototypeOf(valueOf)) && getPrototypeOf(objProto); | |
return objProto | |
? (value == objProto || getPrototypeOf(value) == objProto) | |
: shimIsPlainObject(value); | |
}; | |
/** | |
* Checks if `value` is a regular expression. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Mixed} value The value to check. | |
* @returns {Boolean} Returns `true`, if the `value` is a regular expression, else `false`. | |
* @example | |
* | |
* _.isRegExp(/moe/); | |
* // => true | |
*/ | |
function isRegExp(value) { | |
return !!(value && objectTypes[typeof value]) && toString.call(value) == regexpClass; | |
} | |
/** | |
* Checks if `value` is a string. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Mixed} value The value to check. | |
* @returns {Boolean} Returns `true`, if the `value` is a string, else `false`. | |
* @example | |
* | |
* _.isString('moe'); | |
* // => true | |
*/ | |
function isString(value) { | |
return typeof value == 'string' || toString.call(value) == stringClass; | |
} | |
/** | |
* Checks if `value` is `undefined`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Mixed} value The value to check. | |
* @returns {Boolean} Returns `true`, if the `value` is `undefined`, else `false`. | |
* @example | |
* | |
* _.isUndefined(void 0); | |
* // => true | |
*/ | |
function isUndefined(value) { | |
return typeof value == 'undefined'; | |
} | |
/** | |
* Recursively merges own enumerable properties of the source object(s), that | |
* don't resolve to `undefined`, into the destination object. Subsequent sources | |
* will overwrite property assignments of previous sources. If a `callback` function | |
* is passed, it will be executed to produce the merged values of the destination | |
* and source properties. If `callback` returns `undefined`, merging will be | |
* handled by the method instead. The `callback` is bound to `thisArg` and | |
* invoked with two arguments; (objectValue, sourceValue). | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Object} object The destination object. | |
* @param {Object} [source1, source2, ...] The source objects. | |
* @param {Function} [callback] The function to customize merging properties. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @param- {Object} [deepIndicator] Indicates that `stackA` and `stackB` are | |
* arrays of traversed objects, instead of source objects. | |
* @param- {Array} [stackA=[]] Tracks traversed source objects. | |
* @param- {Array} [stackB=[]] Associates values with source counterparts. | |
* @returns {Object} Returns the destination object. | |
* @example | |
* | |
* var names = { | |
* 'stooges': [ | |
* { 'name': 'moe' }, | |
* { 'name': 'larry' } | |
* ] | |
* }; | |
* | |
* var ages = { | |
* 'stooges': [ | |
* { 'age': 40 }, | |
* { 'age': 50 } | |
* ] | |
* }; | |
* | |
* _.merge(names, ages); | |
* // => { 'stooges': [{ 'name': 'moe', 'age': 40 }, { 'name': 'larry', 'age': 50 }] } | |
* | |
* var food = { | |
* 'fruits': ['apple'], | |
* 'vegetables': ['beet'] | |
* }; | |
* | |
* var otherFood = { | |
* 'fruits': ['banana'], | |
* 'vegetables': ['carrot'] | |
* }; | |
* | |
* _.merge(food, otherFood, function(a, b) { | |
* return _.isArray(a) ? a.concat(b) : undefined; | |
* }); | |
* // => { 'fruits': ['apple', 'banana'], 'vegetables': ['beet', 'carrot] } | |
*/ | |
function merge(object, source, deepIndicator) { | |
var args = arguments, | |
index = 0, | |
length = 2; | |
if (!isObject(object)) { | |
return object; | |
} | |
if (deepIndicator === indicatorObject) { | |
var callback = args[3], | |
stackA = args[4], | |
stackB = args[5]; | |
} else { | |
var initedStack = true; | |
stackA = getArray(); | |
stackB = getArray(); | |
// allows working with `_.reduce` and `_.reduceRight` without | |
// using their `callback` arguments, `index|key` and `collection` | |
if (typeof deepIndicator != 'number') { | |
length = args.length; | |
} | |
if (length > 3 && typeof args[length - 2] == 'function') { | |
callback = lodash.createCallback(args[--length - 1], args[length--], 2); | |
} else if (length > 2 && typeof args[length - 1] == 'function') { | |
callback = args[--length]; | |
} | |
} | |
while (++index < length) { | |
(isArray(args[index]) ? forEach : forOwn)(args[index], function(source, key) { | |
var found, | |
isArr, | |
result = source, | |
value = object[key]; | |
if (source && ((isArr = isArray(source)) || isPlainObject(source))) { | |
// avoid merging previously merged cyclic sources | |
var stackLength = stackA.length; | |
while (stackLength--) { | |
if ((found = stackA[stackLength] == source)) { | |
value = stackB[stackLength]; | |
break; | |
} | |
} | |
if (!found) { | |
var isShallow; | |
if (callback) { | |
result = callback(value, source); | |
if ((isShallow = typeof result != 'undefined')) { | |
value = result; | |
} | |
} | |
if (!isShallow) { | |
value = isArr | |
? (isArray(value) ? value : []) | |
: (isPlainObject(value) ? value : {}); | |
} | |
// add `source` and associated `value` to the stack of traversed objects | |
stackA.push(source); | |
stackB.push(value); | |
// recursively merge objects and arrays (susceptible to call stack limits) | |
if (!isShallow) { | |
value = merge(value, source, indicatorObject, callback, stackA, stackB); | |
} | |
} | |
} | |
else { | |
if (callback) { | |
result = callback(value, source); | |
if (typeof result == 'undefined') { | |
result = source; | |
} | |
} | |
if (typeof result != 'undefined') { | |
value = result; | |
} | |
} | |
object[key] = value; | |
}); | |
} | |
if (initedStack) { | |
releaseArray(stackA); | |
releaseArray(stackB); | |
} | |
return object; | |
} | |
/** | |
* Creates a shallow clone of `object` excluding the specified properties. | |
* Property names may be specified as individual arguments or as arrays of | |
* property names. If a `callback` function is passed, it will be executed | |
* for each property in the `object`, omitting the properties `callback` | |
* returns truthy for. The `callback` is bound to `thisArg` and invoked | |
* with three arguments; (value, key, object). | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Object} object The source object. | |
* @param {Function|String} callback|[prop1, prop2, ...] The properties to omit | |
* or the function called per iteration. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Object} Returns an object without the omitted properties. | |
* @example | |
* | |
* _.omit({ 'name': 'moe', 'age': 40 }, 'age'); | |
* // => { 'name': 'moe' } | |
* | |
* _.omit({ 'name': 'moe', 'age': 40 }, function(value) { | |
* return typeof value == 'number'; | |
* }); | |
* // => { 'name': 'moe' } | |
*/ | |
function omit(object, callback, thisArg) { | |
var indexOf = getIndexOf(), | |
isFunc = typeof callback == 'function', | |
result = {}; | |
if (isFunc) { | |
callback = lodash.createCallback(callback, thisArg); | |
} else { | |
var props = concat.apply(arrayRef, nativeSlice.call(arguments, 1)); | |
} | |
forIn(object, function(value, key, object) { | |
if (isFunc | |
? !callback(value, key, object) | |
: indexOf(props, key) < 0 | |
) { | |
result[key] = value; | |
} | |
}); | |
return result; | |
} | |
/** | |
* Creates a two dimensional array of the given object's key-value pairs, | |
* i.e. `[[key1, value1], [key2, value2]]`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Object} object The object to inspect. | |
* @returns {Array} Returns new array of key-value pairs. | |
* @example | |
* | |
* _.pairs({ 'moe': 30, 'larry': 40 }); | |
* // => [['moe', 30], ['larry', 40]] (order is not guaranteed) | |
*/ | |
function pairs(object) { | |
var index = -1, | |
props = keys(object), | |
length = props.length, | |
result = Array(length); | |
while (++index < length) { | |
var key = props[index]; | |
result[index] = [key, object[key]]; | |
} | |
return result; | |
} | |
/** | |
* Creates a shallow clone of `object` composed of the specified properties. | |
* Property names may be specified as individual arguments or as arrays of property | |
* names. If `callback` is passed, it will be executed for each property in the | |
* `object`, picking the properties `callback` returns truthy for. The `callback` | |
* is bound to `thisArg` and invoked with three arguments; (value, key, object). | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Object} object The source object. | |
* @param {Array|Function|String} callback|[prop1, prop2, ...] The function called | |
* per iteration or properties to pick, either as individual arguments or arrays. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Object} Returns an object composed of the picked properties. | |
* @example | |
* | |
* _.pick({ 'name': 'moe', '_userid': 'moe1' }, 'name'); | |
* // => { 'name': 'moe' } | |
* | |
* _.pick({ 'name': 'moe', '_userid': 'moe1' }, function(value, key) { | |
* return key.charAt(0) != '_'; | |
* }); | |
* // => { 'name': 'moe' } | |
*/ | |
function pick(object, callback, thisArg) { | |
var result = {}; | |
if (typeof callback != 'function') { | |
var index = -1, | |
props = concat.apply(arrayRef, nativeSlice.call(arguments, 1)), | |
length = isObject(object) ? props.length : 0; | |
while (++index < length) { | |
var key = props[index]; | |
if (key in object) { | |
result[key] = object[key]; | |
} | |
} | |
} else { | |
callback = lodash.createCallback(callback, thisArg); | |
forIn(object, function(value, key, object) { | |
if (callback(value, key, object)) { | |
result[key] = value; | |
} | |
}); | |
} | |
return result; | |
} | |
/** | |
* An alternative to `_.reduce`, this method transforms an `object` to a new | |
* `accumulator` object which is the result of running each of its elements | |
* through the `callback`, with each `callback` execution potentially mutating | |
* the `accumulator` object. The `callback` is bound to `thisArg` and invoked | |
* with four arguments; (accumulator, value, key, object). Callbacks may exit | |
* iteration early by explicitly returning `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Array|Object} collection The collection to iterate over. | |
* @param {Function} [callback=identity] The function called per iteration. | |
* @param {Mixed} [accumulator] The custom accumulator value. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Mixed} Returns the accumulated value. | |
* @example | |
* | |
* var squares = _.transform([1, 2, 3, 4, 5, 6, 7, 8, 9, 10], function(result, num) { | |
* num *= num; | |
* if (num % 2) { | |
* return result.push(num) < 3; | |
* } | |
* }); | |
* // => [1, 9, 25] | |
* | |
* var mapped = _.transform({ 'a': 1, 'b': 2, 'c': 3 }, function(result, num, key) { | |
* result[key] = num * 3; | |
* }); | |
* // => { 'a': 3, 'b': 6, 'c': 9 } | |
*/ | |
function transform(object, callback, accumulator, thisArg) { | |
var isArr = isArray(object); | |
callback = lodash.createCallback(callback, thisArg, 4); | |
if (accumulator == null) { | |
if (isArr) { | |
accumulator = []; | |
} else { | |
var ctor = object && object.constructor, | |
proto = ctor && ctor.prototype; | |
accumulator = createObject(proto); | |
} | |
} | |
(isArr ? basicEach : forOwn)(object, function(value, index, object) { | |
return callback(accumulator, value, index, object); | |
}); | |
return accumulator; | |
} | |
/** | |
* Creates an array composed of the own enumerable property values of `object`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Objects | |
* @param {Object} object The object to inspect. | |
* @returns {Array} Returns a new array of property values. | |
* @example | |
* | |
* _.values({ 'one': 1, 'two': 2, 'three': 3 }); | |
* // => [1, 2, 3] (order is not guaranteed) | |
*/ | |
function values(object) { | |
var index = -1, | |
props = keys(object), | |
length = props.length, | |
result = Array(length); | |
while (++index < length) { | |
result[index] = object[props[index]]; | |
} | |
return result; | |
} | |
/*--------------------------------------------------------------------------*/ | |
/** | |
* Creates an array of elements from the specified indexes, or keys, of the | |
* `collection`. Indexes may be specified as individual arguments or as arrays | |
* of indexes. | |
* | |
* @static | |
* @memberOf _ | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Array|Number|String} [index1, index2, ...] The indexes of | |
* `collection` to retrieve, either as individual arguments or arrays. | |
* @returns {Array} Returns a new array of elements corresponding to the | |
* provided indexes. | |
* @example | |
* | |
* _.at(['a', 'b', 'c', 'd', 'e'], [0, 2, 4]); | |
* // => ['a', 'c', 'e'] | |
* | |
* _.at(['moe', 'larry', 'curly'], 0, 2); | |
* // => ['moe', 'curly'] | |
*/ | |
function at(collection) { | |
var index = -1, | |
props = concat.apply(arrayRef, nativeSlice.call(arguments, 1)), | |
length = props.length, | |
result = Array(length); | |
if (support.unindexedChars && isString(collection)) { | |
collection = collection.split(''); | |
} | |
while(++index < length) { | |
result[index] = collection[props[index]]; | |
} | |
return result; | |
} | |
/** | |
* Checks if a given `target` element is present in a `collection` using strict | |
* equality for comparisons, i.e. `===`. If `fromIndex` is negative, it is used | |
* as the offset from the end of the collection. | |
* | |
* @static | |
* @memberOf _ | |
* @alias include | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Mixed} target The value to check for. | |
* @param {Number} [fromIndex=0] The index to search from. | |
* @returns {Boolean} Returns `true` if the `target` element is found, else `false`. | |
* @example | |
* | |
* _.contains([1, 2, 3], 1); | |
* // => true | |
* | |
* _.contains([1, 2, 3], 1, 2); | |
* // => false | |
* | |
* _.contains({ 'name': 'moe', 'age': 40 }, 'moe'); | |
* // => true | |
* | |
* _.contains('curly', 'ur'); | |
* // => true | |
*/ | |
function contains(collection, target, fromIndex) { | |
var index = -1, | |
indexOf = getIndexOf(), | |
length = collection ? collection.length : 0, | |
result = false; | |
fromIndex = (fromIndex < 0 ? nativeMax(0, length + fromIndex) : fromIndex) || 0; | |
if (length && typeof length == 'number') { | |
result = (isString(collection) | |
? collection.indexOf(target, fromIndex) | |
: indexOf(collection, target, fromIndex) | |
) > -1; | |
} else { | |
basicEach(collection, function(value) { | |
if (++index >= fromIndex) { | |
return !(result = value === target); | |
} | |
}); | |
} | |
return result; | |
} | |
/** | |
* Creates an object composed of keys returned from running each element of the | |
* `collection` through the given `callback`. The corresponding value of each key | |
* is the number of times the key was returned by the `callback`. The `callback` | |
* is bound to `thisArg` and invoked with three arguments; (value, index|key, collection). | |
* | |
* If a property name is passed for `callback`, the created "_.pluck" style | |
* callback will return the property value of the given element. | |
* | |
* If an object is passed for `callback`, the created "_.where" style callback | |
* will return `true` for elements that have the properties of the given object, | |
* else `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Function|Object|String} [callback=identity] The function called per | |
* iteration. If a property name or object is passed, it will be used to create | |
* a "_.pluck" or "_.where" style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Object} Returns the composed aggregate object. | |
* @example | |
* | |
* _.countBy([4.3, 6.1, 6.4], function(num) { return Math.floor(num); }); | |
* // => { '4': 1, '6': 2 } | |
* | |
* _.countBy([4.3, 6.1, 6.4], function(num) { return this.floor(num); }, Math); | |
* // => { '4': 1, '6': 2 } | |
* | |
* _.countBy(['one', 'two', 'three'], 'length'); | |
* // => { '3': 2, '5': 1 } | |
*/ | |
function countBy(collection, callback, thisArg) { | |
var result = {}; | |
callback = lodash.createCallback(callback, thisArg); | |
forEach(collection, function(value, key, collection) { | |
key = String(callback(value, key, collection)); | |
(hasOwnProperty.call(result, key) ? result[key]++ : result[key] = 1); | |
}); | |
return result; | |
} | |
/** | |
* Checks if the `callback` returns a truthy value for **all** elements of a | |
* `collection`. The `callback` is bound to `thisArg` and invoked with three | |
* arguments; (value, index|key, collection). | |
* | |
* If a property name is passed for `callback`, the created "_.pluck" style | |
* callback will return the property value of the given element. | |
* | |
* If an object is passed for `callback`, the created "_.where" style callback | |
* will return `true` for elements that have the properties of the given object, | |
* else `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @alias all | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Function|Object|String} [callback=identity] The function called per | |
* iteration. If a property name or object is passed, it will be used to create | |
* a "_.pluck" or "_.where" style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Boolean} Returns `true` if all elements pass the callback check, | |
* else `false`. | |
* @example | |
* | |
* _.every([true, 1, null, 'yes'], Boolean); | |
* // => false | |
* | |
* var stooges = [ | |
* { 'name': 'moe', 'age': 40 }, | |
* { 'name': 'larry', 'age': 50 } | |
* ]; | |
* | |
* // using "_.pluck" callback shorthand | |
* _.every(stooges, 'age'); | |
* // => true | |
* | |
* // using "_.where" callback shorthand | |
* _.every(stooges, { 'age': 50 }); | |
* // => false | |
*/ | |
function every(collection, callback, thisArg) { | |
var result = true; | |
callback = lodash.createCallback(callback, thisArg); | |
if (isArray(collection)) { | |
var index = -1, | |
length = collection.length; | |
while (++index < length) { | |
if (!(result = !!callback(collection[index], index, collection))) { | |
break; | |
} | |
} | |
} else { | |
basicEach(collection, function(value, index, collection) { | |
return (result = !!callback(value, index, collection)); | |
}); | |
} | |
return result; | |
} | |
/** | |
* Examines each element in a `collection`, returning an array of all elements | |
* the `callback` returns truthy for. The `callback` is bound to `thisArg` and | |
* invoked with three arguments; (value, index|key, collection). | |
* | |
* If a property name is passed for `callback`, the created "_.pluck" style | |
* callback will return the property value of the given element. | |
* | |
* If an object is passed for `callback`, the created "_.where" style callback | |
* will return `true` for elements that have the properties of the given object, | |
* else `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @alias select | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Function|Object|String} [callback=identity] The function called per | |
* iteration. If a property name or object is passed, it will be used to create | |
* a "_.pluck" or "_.where" style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Array} Returns a new array of elements that passed the callback check. | |
* @example | |
* | |
* var evens = _.filter([1, 2, 3, 4, 5, 6], function(num) { return num % 2 == 0; }); | |
* // => [2, 4, 6] | |
* | |
* var food = [ | |
* { 'name': 'apple', 'organic': false, 'type': 'fruit' }, | |
* { 'name': 'carrot', 'organic': true, 'type': 'vegetable' } | |
* ]; | |
* | |
* // using "_.pluck" callback shorthand | |
* _.filter(food, 'organic'); | |
* // => [{ 'name': 'carrot', 'organic': true, 'type': 'vegetable' }] | |
* | |
* // using "_.where" callback shorthand | |
* _.filter(food, { 'type': 'fruit' }); | |
* // => [{ 'name': 'apple', 'organic': false, 'type': 'fruit' }] | |
*/ | |
function filter(collection, callback, thisArg) { | |
var result = []; | |
callback = lodash.createCallback(callback, thisArg); | |
if (isArray(collection)) { | |
var index = -1, | |
length = collection.length; | |
while (++index < length) { | |
var value = collection[index]; | |
if (callback(value, index, collection)) { | |
result.push(value); | |
} | |
} | |
} else { | |
basicEach(collection, function(value, index, collection) { | |
if (callback(value, index, collection)) { | |
result.push(value); | |
} | |
}); | |
} | |
return result; | |
} | |
/** | |
* Examines each element in a `collection`, returning the first that the `callback` | |
* returns truthy for. The `callback` is bound to `thisArg` and invoked with three | |
* arguments; (value, index|key, collection). | |
* | |
* If a property name is passed for `callback`, the created "_.pluck" style | |
* callback will return the property value of the given element. | |
* | |
* If an object is passed for `callback`, the created "_.where" style callback | |
* will return `true` for elements that have the properties of the given object, | |
* else `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @alias detect, findWhere | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Function|Object|String} [callback=identity] The function called per | |
* iteration. If a property name or object is passed, it will be used to create | |
* a "_.pluck" or "_.where" style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Mixed} Returns the found element, else `undefined`. | |
* @example | |
* | |
* _.find([1, 2, 3, 4], function(num) { | |
* return num % 2 == 0; | |
* }); | |
* // => 2 | |
* | |
* var food = [ | |
* { 'name': 'apple', 'organic': false, 'type': 'fruit' }, | |
* { 'name': 'banana', 'organic': true, 'type': 'fruit' }, | |
* { 'name': 'beet', 'organic': false, 'type': 'vegetable' } | |
* ]; | |
* | |
* // using "_.where" callback shorthand | |
* _.find(food, { 'type': 'vegetable' }); | |
* // => { 'name': 'beet', 'organic': false, 'type': 'vegetable' } | |
* | |
* // using "_.pluck" callback shorthand | |
* _.find(food, 'organic'); | |
* // => { 'name': 'banana', 'organic': true, 'type': 'fruit' } | |
*/ | |
function find(collection, callback, thisArg) { | |
callback = lodash.createCallback(callback, thisArg); | |
if (isArray(collection)) { | |
var index = -1, | |
length = collection.length; | |
while (++index < length) { | |
var value = collection[index]; | |
if (callback(value, index, collection)) { | |
return value; | |
} | |
} | |
} else { | |
var result; | |
basicEach(collection, function(value, index, collection) { | |
if (callback(value, index, collection)) { | |
result = value; | |
return false; | |
} | |
}); | |
return result; | |
} | |
} | |
/** | |
* Iterates over a `collection`, executing the `callback` for each element in | |
* the `collection`. The `callback` is bound to `thisArg` and invoked with three | |
* arguments; (value, index|key, collection). Callbacks may exit iteration early | |
* by explicitly returning `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @alias each | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Function} [callback=identity] The function called per iteration. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Array|Object|String} Returns `collection`. | |
* @example | |
* | |
* _([1, 2, 3]).forEach(alert).join(','); | |
* // => alerts each number and returns '1,2,3' | |
* | |
* _.forEach({ 'one': 1, 'two': 2, 'three': 3 }, alert); | |
* // => alerts each number value (order is not guaranteed) | |
*/ | |
function forEach(collection, callback, thisArg) { | |
if (callback && typeof thisArg == 'undefined' && isArray(collection)) { | |
var index = -1, | |
length = collection.length; | |
while (++index < length) { | |
if (callback(collection[index], index, collection) === false) { | |
break; | |
} | |
} | |
} else { | |
basicEach(collection, callback, thisArg); | |
} | |
return collection; | |
} | |
/** | |
* Creates an object composed of keys returned from running each element of the | |
* `collection` through the `callback`. The corresponding value of each key is | |
* an array of elements passed to `callback` that returned the key. The `callback` | |
* is bound to `thisArg` and invoked with three arguments; (value, index|key, collection). | |
* | |
* If a property name is passed for `callback`, the created "_.pluck" style | |
* callback will return the property value of the given element. | |
* | |
* If an object is passed for `callback`, the created "_.where" style callback | |
* will return `true` for elements that have the properties of the given object, | |
* else `false` | |
* | |
* @static | |
* @memberOf _ | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Function|Object|String} [callback=identity] The function called per | |
* iteration. If a property name or object is passed, it will be used to create | |
* a "_.pluck" or "_.where" style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Object} Returns the composed aggregate object. | |
* @example | |
* | |
* _.groupBy([4.2, 6.1, 6.4], function(num) { return Math.floor(num); }); | |
* // => { '4': [4.2], '6': [6.1, 6.4] } | |
* | |
* _.groupBy([4.2, 6.1, 6.4], function(num) { return this.floor(num); }, Math); | |
* // => { '4': [4.2], '6': [6.1, 6.4] } | |
* | |
* // using "_.pluck" callback shorthand | |
* _.groupBy(['one', 'two', 'three'], 'length'); | |
* // => { '3': ['one', 'two'], '5': ['three'] } | |
*/ | |
function groupBy(collection, callback, thisArg) { | |
var result = {}; | |
callback = lodash.createCallback(callback, thisArg); | |
forEach(collection, function(value, key, collection) { | |
key = String(callback(value, key, collection)); | |
(hasOwnProperty.call(result, key) ? result[key] : result[key] = []).push(value); | |
}); | |
return result; | |
} | |
/** | |
* Invokes the method named by `methodName` on each element in the `collection`, | |
* returning an array of the results of each invoked method. Additional arguments | |
* will be passed to each invoked method. If `methodName` is a function, it will | |
* be invoked for, and `this` bound to, each element in the `collection`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Function|String} methodName The name of the method to invoke or | |
* the function invoked per iteration. | |
* @param {Mixed} [arg1, arg2, ...] Arguments to invoke the method with. | |
* @returns {Array} Returns a new array of the results of each invoked method. | |
* @example | |
* | |
* _.invoke([[5, 1, 7], [3, 2, 1]], 'sort'); | |
* // => [[1, 5, 7], [1, 2, 3]] | |
* | |
* _.invoke([123, 456], String.prototype.split, ''); | |
* // => [['1', '2', '3'], ['4', '5', '6']] | |
*/ | |
function invoke(collection, methodName) { | |
var args = nativeSlice.call(arguments, 2), | |
index = -1, | |
isFunc = typeof methodName == 'function', | |
length = collection ? collection.length : 0, | |
result = Array(typeof length == 'number' ? length : 0); | |
forEach(collection, function(value) { | |
result[++index] = (isFunc ? methodName : value[methodName]).apply(value, args); | |
}); | |
return result; | |
} | |
/** | |
* Creates an array of values by running each element in the `collection` | |
* through the `callback`. The `callback` is bound to `thisArg` and invoked with | |
* three arguments; (value, index|key, collection). | |
* | |
* If a property name is passed for `callback`, the created "_.pluck" style | |
* callback will return the property value of the given element. | |
* | |
* If an object is passed for `callback`, the created "_.where" style callback | |
* will return `true` for elements that have the properties of the given object, | |
* else `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @alias collect | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Function|Object|String} [callback=identity] The function called per | |
* iteration. If a property name or object is passed, it will be used to create | |
* a "_.pluck" or "_.where" style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Array} Returns a new array of the results of each `callback` execution. | |
* @example | |
* | |
* _.map([1, 2, 3], function(num) { return num * 3; }); | |
* // => [3, 6, 9] | |
* | |
* _.map({ 'one': 1, 'two': 2, 'three': 3 }, function(num) { return num * 3; }); | |
* // => [3, 6, 9] (order is not guaranteed) | |
* | |
* var stooges = [ | |
* { 'name': 'moe', 'age': 40 }, | |
* { 'name': 'larry', 'age': 50 } | |
* ]; | |
* | |
* // using "_.pluck" callback shorthand | |
* _.map(stooges, 'name'); | |
* // => ['moe', 'larry'] | |
*/ | |
function map(collection, callback, thisArg) { | |
var index = -1, | |
length = collection ? collection.length : 0, | |
result = Array(typeof length == 'number' ? length : 0); | |
callback = lodash.createCallback(callback, thisArg); | |
if (isArray(collection)) { | |
while (++index < length) { | |
result[index] = callback(collection[index], index, collection); | |
} | |
} else { | |
basicEach(collection, function(value, key, collection) { | |
result[++index] = callback(value, key, collection); | |
}); | |
} | |
return result; | |
} | |
/** | |
* Retrieves the maximum value of an `array`. If `callback` is passed, | |
* it will be executed for each value in the `array` to generate the | |
* criterion by which the value is ranked. The `callback` is bound to | |
* `thisArg` and invoked with three arguments; (value, index, collection). | |
* | |
* If a property name is passed for `callback`, the created "_.pluck" style | |
* callback will return the property value of the given element. | |
* | |
* If an object is passed for `callback`, the created "_.where" style callback | |
* will return `true` for elements that have the properties of the given object, | |
* else `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Function|Object|String} [callback=identity] The function called per | |
* iteration. If a property name or object is passed, it will be used to create | |
* a "_.pluck" or "_.where" style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Mixed} Returns the maximum value. | |
* @example | |
* | |
* _.max([4, 2, 8, 6]); | |
* // => 8 | |
* | |
* var stooges = [ | |
* { 'name': 'moe', 'age': 40 }, | |
* { 'name': 'larry', 'age': 50 } | |
* ]; | |
* | |
* _.max(stooges, function(stooge) { return stooge.age; }); | |
* // => { 'name': 'larry', 'age': 50 }; | |
* | |
* // using "_.pluck" callback shorthand | |
* _.max(stooges, 'age'); | |
* // => { 'name': 'larry', 'age': 50 }; | |
*/ | |
function max(collection, callback, thisArg) { | |
var computed = -Infinity, | |
result = computed; | |
if (!callback && isArray(collection)) { | |
var index = -1, | |
length = collection.length; | |
while (++index < length) { | |
var value = collection[index]; | |
if (value > result) { | |
result = value; | |
} | |
} | |
} else { | |
callback = (!callback && isString(collection)) | |
? charAtCallback | |
: lodash.createCallback(callback, thisArg); | |
basicEach(collection, function(value, index, collection) { | |
var current = callback(value, index, collection); | |
if (current > computed) { | |
computed = current; | |
result = value; | |
} | |
}); | |
} | |
return result; | |
} | |
/** | |
* Retrieves the minimum value of an `array`. If `callback` is passed, | |
* it will be executed for each value in the `array` to generate the | |
* criterion by which the value is ranked. The `callback` is bound to `thisArg` | |
* and invoked with three arguments; (value, index, collection). | |
* | |
* If a property name is passed for `callback`, the created "_.pluck" style | |
* callback will return the property value of the given element. | |
* | |
* If an object is passed for `callback`, the created "_.where" style callback | |
* will return `true` for elements that have the properties of the given object, | |
* else `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Function|Object|String} [callback=identity] The function called per | |
* iteration. If a property name or object is passed, it will be used to create | |
* a "_.pluck" or "_.where" style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Mixed} Returns the minimum value. | |
* @example | |
* | |
* _.min([4, 2, 8, 6]); | |
* // => 2 | |
* | |
* var stooges = [ | |
* { 'name': 'moe', 'age': 40 }, | |
* { 'name': 'larry', 'age': 50 } | |
* ]; | |
* | |
* _.min(stooges, function(stooge) { return stooge.age; }); | |
* // => { 'name': 'moe', 'age': 40 }; | |
* | |
* // using "_.pluck" callback shorthand | |
* _.min(stooges, 'age'); | |
* // => { 'name': 'moe', 'age': 40 }; | |
*/ | |
function min(collection, callback, thisArg) { | |
var computed = Infinity, | |
result = computed; | |
if (!callback && isArray(collection)) { | |
var index = -1, | |
length = collection.length; | |
while (++index < length) { | |
var value = collection[index]; | |
if (value < result) { | |
result = value; | |
} | |
} | |
} else { | |
callback = (!callback && isString(collection)) | |
? charAtCallback | |
: lodash.createCallback(callback, thisArg); | |
basicEach(collection, function(value, index, collection) { | |
var current = callback(value, index, collection); | |
if (current < computed) { | |
computed = current; | |
result = value; | |
} | |
}); | |
} | |
return result; | |
} | |
/** | |
* Retrieves the value of a specified property from all elements in the `collection`. | |
* | |
* @static | |
* @memberOf _ | |
* @type Function | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {String} property The property to pluck. | |
* @returns {Array} Returns a new array of property values. | |
* @example | |
* | |
* var stooges = [ | |
* { 'name': 'moe', 'age': 40 }, | |
* { 'name': 'larry', 'age': 50 } | |
* ]; | |
* | |
* _.pluck(stooges, 'name'); | |
* // => ['moe', 'larry'] | |
*/ | |
var pluck = map; | |
/** | |
* Reduces a `collection` to a value which is the accumulated result of running | |
* each element in the `collection` through the `callback`, where each successive | |
* `callback` execution consumes the return value of the previous execution. | |
* If `accumulator` is not passed, the first element of the `collection` will be | |
* used as the initial `accumulator` value. The `callback` is bound to `thisArg` | |
* and invoked with four arguments; (accumulator, value, index|key, collection). | |
* | |
* @static | |
* @memberOf _ | |
* @alias foldl, inject | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Function} [callback=identity] The function called per iteration. | |
* @param {Mixed} [accumulator] Initial value of the accumulator. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Mixed} Returns the accumulated value. | |
* @example | |
* | |
* var sum = _.reduce([1, 2, 3], function(sum, num) { | |
* return sum + num; | |
* }); | |
* // => 6 | |
* | |
* var mapped = _.reduce({ 'a': 1, 'b': 2, 'c': 3 }, function(result, num, key) { | |
* result[key] = num * 3; | |
* return result; | |
* }, {}); | |
* // => { 'a': 3, 'b': 6, 'c': 9 } | |
*/ | |
function reduce(collection, callback, accumulator, thisArg) { | |
var noaccum = arguments.length < 3; | |
callback = lodash.createCallback(callback, thisArg, 4); | |
if (isArray(collection)) { | |
var index = -1, | |
length = collection.length; | |
if (noaccum) { | |
accumulator = collection[++index]; | |
} | |
while (++index < length) { | |
accumulator = callback(accumulator, collection[index], index, collection); | |
} | |
} else { | |
basicEach(collection, function(value, index, collection) { | |
accumulator = noaccum | |
? (noaccum = false, value) | |
: callback(accumulator, value, index, collection) | |
}); | |
} | |
return accumulator; | |
} | |
/** | |
* This method is similar to `_.reduce`, except that it iterates over a | |
* `collection` from right to left. | |
* | |
* @static | |
* @memberOf _ | |
* @alias foldr | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Function} [callback=identity] The function called per iteration. | |
* @param {Mixed} [accumulator] Initial value of the accumulator. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Mixed} Returns the accumulated value. | |
* @example | |
* | |
* var list = [[0, 1], [2, 3], [4, 5]]; | |
* var flat = _.reduceRight(list, function(a, b) { return a.concat(b); }, []); | |
* // => [4, 5, 2, 3, 0, 1] | |
*/ | |
function reduceRight(collection, callback, accumulator, thisArg) { | |
var iterable = collection, | |
length = collection ? collection.length : 0, | |
noaccum = arguments.length < 3; | |
if (typeof length != 'number') { | |
var props = keys(collection); | |
length = props.length; | |
} else if (support.unindexedChars && isString(collection)) { | |
iterable = collection.split(''); | |
} | |
callback = lodash.createCallback(callback, thisArg, 4); | |
forEach(collection, function(value, index, collection) { | |
index = props ? props[--length] : --length; | |
accumulator = noaccum | |
? (noaccum = false, iterable[index]) | |
: callback(accumulator, iterable[index], index, collection); | |
}); | |
return accumulator; | |
} | |
/** | |
* The opposite of `_.filter`, this method returns the elements of a | |
* `collection` that `callback` does **not** return truthy for. | |
* | |
* If a property name is passed for `callback`, the created "_.pluck" style | |
* callback will return the property value of the given element. | |
* | |
* If an object is passed for `callback`, the created "_.where" style callback | |
* will return `true` for elements that have the properties of the given object, | |
* else `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Function|Object|String} [callback=identity] The function called per | |
* iteration. If a property name or object is passed, it will be used to create | |
* a "_.pluck" or "_.where" style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Array} Returns a new array of elements that did **not** pass the | |
* callback check. | |
* @example | |
* | |
* var odds = _.reject([1, 2, 3, 4, 5, 6], function(num) { return num % 2 == 0; }); | |
* // => [1, 3, 5] | |
* | |
* var food = [ | |
* { 'name': 'apple', 'organic': false, 'type': 'fruit' }, | |
* { 'name': 'carrot', 'organic': true, 'type': 'vegetable' } | |
* ]; | |
* | |
* // using "_.pluck" callback shorthand | |
* _.reject(food, 'organic'); | |
* // => [{ 'name': 'apple', 'organic': false, 'type': 'fruit' }] | |
* | |
* // using "_.where" callback shorthand | |
* _.reject(food, { 'type': 'fruit' }); | |
* // => [{ 'name': 'carrot', 'organic': true, 'type': 'vegetable' }] | |
*/ | |
function reject(collection, callback, thisArg) { | |
callback = lodash.createCallback(callback, thisArg); | |
return filter(collection, function(value, index, collection) { | |
return !callback(value, index, collection); | |
}); | |
} | |
/** | |
* Creates an array of shuffled `array` values, using a version of the | |
* Fisher-Yates shuffle. See http://en.wikipedia.org/wiki/Fisher-Yates_shuffle. | |
* | |
* @static | |
* @memberOf _ | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to shuffle. | |
* @returns {Array} Returns a new shuffled collection. | |
* @example | |
* | |
* _.shuffle([1, 2, 3, 4, 5, 6]); | |
* // => [4, 1, 6, 3, 5, 2] | |
*/ | |
function shuffle(collection) { | |
var index = -1, | |
length = collection ? collection.length : 0, | |
result = Array(typeof length == 'number' ? length : 0); | |
forEach(collection, function(value) { | |
var rand = floor(nativeRandom() * (++index + 1)); | |
result[index] = result[rand]; | |
result[rand] = value; | |
}); | |
return result; | |
} | |
/** | |
* Gets the size of the `collection` by returning `collection.length` for arrays | |
* and array-like objects or the number of own enumerable properties for objects. | |
* | |
* @static | |
* @memberOf _ | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to inspect. | |
* @returns {Number} Returns `collection.length` or number of own enumerable properties. | |
* @example | |
* | |
* _.size([1, 2]); | |
* // => 2 | |
* | |
* _.size({ 'one': 1, 'two': 2, 'three': 3 }); | |
* // => 3 | |
* | |
* _.size('curly'); | |
* // => 5 | |
*/ | |
function size(collection) { | |
var length = collection ? collection.length : 0; | |
return typeof length == 'number' ? length : keys(collection).length; | |
} | |
/** | |
* Checks if the `callback` returns a truthy value for **any** element of a | |
* `collection`. The function returns as soon as it finds passing value, and | |
* does not iterate over the entire `collection`. The `callback` is bound to | |
* `thisArg` and invoked with three arguments; (value, index|key, collection). | |
* | |
* If a property name is passed for `callback`, the created "_.pluck" style | |
* callback will return the property value of the given element. | |
* | |
* If an object is passed for `callback`, the created "_.where" style callback | |
* will return `true` for elements that have the properties of the given object, | |
* else `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @alias any | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Function|Object|String} [callback=identity] The function called per | |
* iteration. If a property name or object is passed, it will be used to create | |
* a "_.pluck" or "_.where" style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Boolean} Returns `true` if any element passes the callback check, | |
* else `false`. | |
* @example | |
* | |
* _.some([null, 0, 'yes', false], Boolean); | |
* // => true | |
* | |
* var food = [ | |
* { 'name': 'apple', 'organic': false, 'type': 'fruit' }, | |
* { 'name': 'carrot', 'organic': true, 'type': 'vegetable' } | |
* ]; | |
* | |
* // using "_.pluck" callback shorthand | |
* _.some(food, 'organic'); | |
* // => true | |
* | |
* // using "_.where" callback shorthand | |
* _.some(food, { 'type': 'meat' }); | |
* // => false | |
*/ | |
function some(collection, callback, thisArg) { | |
var result; | |
callback = lodash.createCallback(callback, thisArg); | |
if (isArray(collection)) { | |
var index = -1, | |
length = collection.length; | |
while (++index < length) { | |
if ((result = callback(collection[index], index, collection))) { | |
break; | |
} | |
} | |
} else { | |
basicEach(collection, function(value, index, collection) { | |
return !(result = callback(value, index, collection)); | |
}); | |
} | |
return !!result; | |
} | |
/** | |
* Creates an array of elements, sorted in ascending order by the results of | |
* running each element in the `collection` through the `callback`. This method | |
* performs a stable sort, that is, it will preserve the original sort order of | |
* equal elements. The `callback` is bound to `thisArg` and invoked with three | |
* arguments; (value, index|key, collection). | |
* | |
* If a property name is passed for `callback`, the created "_.pluck" style | |
* callback will return the property value of the given element. | |
* | |
* If an object is passed for `callback`, the created "_.where" style callback | |
* will return `true` for elements that have the properties of the given object, | |
* else `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Function|Object|String} [callback=identity] The function called per | |
* iteration. If a property name or object is passed, it will be used to create | |
* a "_.pluck" or "_.where" style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Array} Returns a new array of sorted elements. | |
* @example | |
* | |
* _.sortBy([1, 2, 3], function(num) { return Math.sin(num); }); | |
* // => [3, 1, 2] | |
* | |
* _.sortBy([1, 2, 3], function(num) { return this.sin(num); }, Math); | |
* // => [3, 1, 2] | |
* | |
* // using "_.pluck" callback shorthand | |
* _.sortBy(['banana', 'strawberry', 'apple'], 'length'); | |
* // => ['apple', 'banana', 'strawberry'] | |
*/ | |
function sortBy(collection, callback, thisArg) { | |
var index = -1, | |
length = collection ? collection.length : 0, | |
result = Array(typeof length == 'number' ? length : 0); | |
callback = lodash.createCallback(callback, thisArg); | |
forEach(collection, function(value, key, collection) { | |
var object = result[++index] = getObject(); | |
object.criteria = callback(value, key, collection); | |
object.index = index; | |
object.value = value; | |
}); | |
length = result.length; | |
result.sort(compareAscending); | |
while (length--) { | |
var object = result[length]; | |
result[length] = object.value; | |
releaseObject(object); | |
} | |
return result; | |
} | |
/** | |
* Converts the `collection` to an array. | |
* | |
* @static | |
* @memberOf _ | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to convert. | |
* @returns {Array} Returns the new converted array. | |
* @example | |
* | |
* (function() { return _.toArray(arguments).slice(1); })(1, 2, 3, 4); | |
* // => [2, 3, 4] | |
*/ | |
function toArray(collection) { | |
if (collection && typeof collection.length == 'number') { | |
return (support.unindexedChars && isString(collection)) | |
? collection.split('') | |
: slice(collection); | |
} | |
return values(collection); | |
} | |
/** | |
* Examines each element in a `collection`, returning an array of all elements | |
* that have the given `properties`. When checking `properties`, this method | |
* performs a deep comparison between values to determine if they are equivalent | |
* to each other. | |
* | |
* @static | |
* @memberOf _ | |
* @type Function | |
* @category Collections | |
* @param {Array|Object|String} collection The collection to iterate over. | |
* @param {Object} properties The object of property values to filter by. | |
* @returns {Array} Returns a new array of elements that have the given `properties`. | |
* @example | |
* | |
* var stooges = [ | |
* { 'name': 'moe', 'age': 40 }, | |
* { 'name': 'larry', 'age': 50 } | |
* ]; | |
* | |
* _.where(stooges, { 'age': 40 }); | |
* // => [{ 'name': 'moe', 'age': 40 }] | |
*/ | |
var where = filter; | |
/*--------------------------------------------------------------------------*/ | |
/** | |
* Creates an array with all falsey values of `array` removed. The values | |
* `false`, `null`, `0`, `""`, `undefined` and `NaN` are all falsey. | |
* | |
* @static | |
* @memberOf _ | |
* @category Arrays | |
* @param {Array} array The array to compact. | |
* @returns {Array} Returns a new filtered array. | |
* @example | |
* | |
* _.compact([0, 1, false, 2, '', 3]); | |
* // => [1, 2, 3] | |
*/ | |
function compact(array) { | |
var index = -1, | |
length = array ? array.length : 0, | |
result = []; | |
while (++index < length) { | |
var value = array[index]; | |
if (value) { | |
result.push(value); | |
} | |
} | |
return result; | |
} | |
/** | |
* Creates an array of `array` elements not present in the other arrays | |
* using strict equality for comparisons, i.e. `===`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Arrays | |
* @param {Array} array The array to process. | |
* @param {Array} [array1, array2, ...] Arrays to check. | |
* @returns {Array} Returns a new array of `array` elements not present in the | |
* other arrays. | |
* @example | |
* | |
* _.difference([1, 2, 3, 4, 5], [5, 2, 10]); | |
* // => [1, 3, 4] | |
*/ | |
function difference(array) { | |
var index = -1, | |
indexOf = getIndexOf(), | |
length = array ? array.length : 0, | |
seen = concat.apply(arrayRef, nativeSlice.call(arguments, 1)), | |
result = []; | |
var isLarge = length >= largeArraySize && indexOf === basicIndexOf; | |
if (isLarge) { | |
var cache = createCache(seen); | |
if (cache) { | |
indexOf = cacheIndexOf; | |
seen = cache; | |
} else { | |
isLarge = false; | |
} | |
} | |
while (++index < length) { | |
var value = array[index]; | |
if (indexOf(seen, value) < 0) { | |
result.push(value); | |
} | |
} | |
if (isLarge) { | |
releaseObject(seen); | |
} | |
return result; | |
} | |
/** | |
* This method is similar to `_.find`, except that it returns the index of | |
* the element that passes the callback check, instead of the element itself. | |
* | |
* @static | |
* @memberOf _ | |
* @category Arrays | |
* @param {Array} array The array to search. | |
* @param {Function|Object|String} [callback=identity] The function called per | |
* iteration. If a property name or object is passed, it will be used to create | |
* a "_.pluck" or "_.where" style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Mixed} Returns the index of the found element, else `-1`. | |
* @example | |
* | |
* _.findIndex(['apple', 'banana', 'beet'], function(food) { | |
* return /^b/.test(food); | |
* }); | |
* // => 1 | |
*/ | |
function findIndex(array, callback, thisArg) { | |
var index = -1, | |
length = array ? array.length : 0; | |
callback = lodash.createCallback(callback, thisArg); | |
while (++index < length) { | |
if (callback(array[index], index, array)) { | |
return index; | |
} | |
} | |
return -1; | |
} | |
/** | |
* Gets the first element of the `array`. If a number `n` is passed, the first | |
* `n` elements of the `array` are returned. If a `callback` function is passed, | |
* elements at the beginning of the array are returned as long as the `callback` | |
* returns truthy. The `callback` is bound to `thisArg` and invoked with three | |
* arguments; (value, index, array). | |
* | |
* If a property name is passed for `callback`, the created "_.pluck" style | |
* callback will return the property value of the given element. | |
* | |
* If an object is passed for `callback`, the created "_.where" style callback | |
* will return `true` for elements that have the properties of the given object, | |
* else `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @alias head, take | |
* @category Arrays | |
* @param {Array} array The array to query. | |
* @param {Function|Object|Number|String} [callback|n] The function called | |
* per element or the number of elements to return. If a property name or | |
* object is passed, it will be used to create a "_.pluck" or "_.where" | |
* style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Mixed} Returns the first element(s) of `array`. | |
* @example | |
* | |
* _.first([1, 2, 3]); | |
* // => 1 | |
* | |
* _.first([1, 2, 3], 2); | |
* // => [1, 2] | |
* | |
* _.first([1, 2, 3], function(num) { | |
* return num < 3; | |
* }); | |
* // => [1, 2] | |
* | |
* var food = [ | |
* { 'name': 'banana', 'organic': true }, | |
* { 'name': 'beet', 'organic': false }, | |
* ]; | |
* | |
* // using "_.pluck" callback shorthand | |
* _.first(food, 'organic'); | |
* // => [{ 'name': 'banana', 'organic': true }] | |
* | |
* var food = [ | |
* { 'name': 'apple', 'type': 'fruit' }, | |
* { 'name': 'banana', 'type': 'fruit' }, | |
* { 'name': 'beet', 'type': 'vegetable' } | |
* ]; | |
* | |
* // using "_.where" callback shorthand | |
* _.first(food, { 'type': 'fruit' }); | |
* // => [{ 'name': 'apple', 'type': 'fruit' }, { 'name': 'banana', 'type': 'fruit' }] | |
*/ | |
function first(array, callback, thisArg) { | |
if (array) { | |
var n = 0, | |
length = array.length; | |
if (typeof callback != 'number' && callback != null) { | |
var index = -1; | |
callback = lodash.createCallback(callback, thisArg); | |
while (++index < length && callback(array[index], index, array)) { | |
n++; | |
} | |
} else { | |
n = callback; | |
if (n == null || thisArg) { | |
return array[0]; | |
} | |
} | |
return slice(array, 0, nativeMin(nativeMax(0, n), length)); | |
} | |
} | |
/** | |
* Flattens a nested array (the nesting can be to any depth). If `isShallow` | |
* is truthy, `array` will only be flattened a single level. If `callback` | |
* is passed, each element of `array` is passed through a `callback` before | |
* flattening. The `callback` is bound to `thisArg` and invoked with three | |
* arguments; (value, index, array). | |
* | |
* If a property name is passed for `callback`, the created "_.pluck" style | |
* callback will return the property value of the given element. | |
* | |
* If an object is passed for `callback`, the created "_.where" style callback | |
* will return `true` for elements that have the properties of the given object, | |
* else `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Arrays | |
* @param {Array} array The array to flatten. | |
* @param {Boolean} [isShallow=false] A flag to indicate only flattening a single level. | |
* @param {Function|Object|String} [callback=identity] The function called per | |
* iteration. If a property name or object is passed, it will be used to create | |
* a "_.pluck" or "_.where" style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Array} Returns a new flattened array. | |
* @example | |
* | |
* _.flatten([1, [2], [3, [[4]]]]); | |
* // => [1, 2, 3, 4]; | |
* | |
* _.flatten([1, [2], [3, [[4]]]], true); | |
* // => [1, 2, 3, [[4]]]; | |
* | |
* var stooges = [ | |
* { 'name': 'curly', 'quotes': ['Oh, a wise guy, eh?', 'Poifect!'] }, | |
* { 'name': 'moe', 'quotes': ['Spread out!', 'You knucklehead!'] } | |
* ]; | |
* | |
* // using "_.pluck" callback shorthand | |
* _.flatten(stooges, 'quotes'); | |
* // => ['Oh, a wise guy, eh?', 'Poifect!', 'Spread out!', 'You knucklehead!'] | |
*/ | |
var flatten = overloadWrapper(function flatten(array, isShallow, callback) { | |
var index = -1, | |
length = array ? array.length : 0, | |
result = []; | |
while (++index < length) { | |
var value = array[index]; | |
if (callback) { | |
value = callback(value, index, array); | |
} | |
// recursively flatten arrays (susceptible to call stack limits) | |
if (isArray(value)) { | |
push.apply(result, isShallow ? value : flatten(value)); | |
} else { | |
result.push(value); | |
} | |
} | |
return result; | |
}); | |
/** | |
* Gets the index at which the first occurrence of `value` is found using | |
* strict equality for comparisons, i.e. `===`. If the `array` is already | |
* sorted, passing `true` for `fromIndex` will run a faster binary search. | |
* | |
* @static | |
* @memberOf _ | |
* @category Arrays | |
* @param {Array} array The array to search. | |
* @param {Mixed} value The value to search for. | |
* @param {Boolean|Number} [fromIndex=0] The index to search from or `true` to | |
* perform a binary search on a sorted `array`. | |
* @returns {Number} Returns the index of the matched value or `-1`. | |
* @example | |
* | |
* _.indexOf([1, 2, 3, 1, 2, 3], 2); | |
* // => 1 | |
* | |
* _.indexOf([1, 2, 3, 1, 2, 3], 2, 3); | |
* // => 4 | |
* | |
* _.indexOf([1, 1, 2, 2, 3, 3], 2, true); | |
* // => 2 | |
*/ | |
function indexOf(array, value, fromIndex) { | |
if (typeof fromIndex == 'number') { | |
var length = array ? array.length : 0; | |
fromIndex = (fromIndex < 0 ? nativeMax(0, length + fromIndex) : fromIndex || 0); | |
} else if (fromIndex) { | |
var index = sortedIndex(array, value); | |
return array[index] === value ? index : -1; | |
} | |
return array ? basicIndexOf(array, value, fromIndex) : -1; | |
} | |
/** | |
* Gets all but the last element of `array`. If a number `n` is passed, the | |
* last `n` elements are excluded from the result. If a `callback` function | |
* is passed, elements at the end of the array are excluded from the result | |
* as long as the `callback` returns truthy. The `callback` is bound to | |
* `thisArg` and invoked with three arguments; (value, index, array). | |
* | |
* If a property name is passed for `callback`, the created "_.pluck" style | |
* callback will return the property value of the given element. | |
* | |
* If an object is passed for `callback`, the created "_.where" style callback | |
* will return `true` for elements that have the properties of the given object, | |
* else `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Arrays | |
* @param {Array} array The array to query. | |
* @param {Function|Object|Number|String} [callback|n=1] The function called | |
* per element or the number of elements to exclude. If a property name or | |
* object is passed, it will be used to create a "_.pluck" or "_.where" | |
* style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Array} Returns a slice of `array`. | |
* @example | |
* | |
* _.initial([1, 2, 3]); | |
* // => [1, 2] | |
* | |
* _.initial([1, 2, 3], 2); | |
* // => [1] | |
* | |
* _.initial([1, 2, 3], function(num) { | |
* return num > 1; | |
* }); | |
* // => [1] | |
* | |
* var food = [ | |
* { 'name': 'beet', 'organic': false }, | |
* { 'name': 'carrot', 'organic': true } | |
* ]; | |
* | |
* // using "_.pluck" callback shorthand | |
* _.initial(food, 'organic'); | |
* // => [{ 'name': 'beet', 'organic': false }] | |
* | |
* var food = [ | |
* { 'name': 'banana', 'type': 'fruit' }, | |
* { 'name': 'beet', 'type': 'vegetable' }, | |
* { 'name': 'carrot', 'type': 'vegetable' } | |
* ]; | |
* | |
* // using "_.where" callback shorthand | |
* _.initial(food, { 'type': 'vegetable' }); | |
* // => [{ 'name': 'banana', 'type': 'fruit' }] | |
*/ | |
function initial(array, callback, thisArg) { | |
if (!array) { | |
return []; | |
} | |
var n = 0, | |
length = array.length; | |
if (typeof callback != 'number' && callback != null) { | |
var index = length; | |
callback = lodash.createCallback(callback, thisArg); | |
while (index-- && callback(array[index], index, array)) { | |
n++; | |
} | |
} else { | |
n = (callback == null || thisArg) ? 1 : callback || n; | |
} | |
return slice(array, 0, nativeMin(nativeMax(0, length - n), length)); | |
} | |
/** | |
* Computes the intersection of all the passed-in arrays using strict equality | |
* for comparisons, i.e. `===`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Arrays | |
* @param {Array} [array1, array2, ...] Arrays to process. | |
* @returns {Array} Returns a new array of unique elements that are present | |
* in **all** of the arrays. | |
* @example | |
* | |
* _.intersection([1, 2, 3], [101, 2, 1, 10], [2, 1]); | |
* // => [1, 2] | |
*/ | |
function intersection(array) { | |
var args = arguments, | |
argsLength = args.length, | |
argsIndex = -1, | |
caches = getArray(), | |
index = -1, | |
indexOf = getIndexOf(), | |
length = array ? array.length : 0, | |
result = [], | |
seen = getArray(); | |
while (++argsIndex < argsLength) { | |
var value = args[argsIndex]; | |
caches[argsIndex] = indexOf === basicIndexOf && | |
(value ? value.length : 0) >= largeArraySize && | |
createCache(argsIndex ? args[argsIndex] : seen); | |
} | |
outer: | |
while (++index < length) { | |
var cache = caches[0]; | |
value = array[index]; | |
if ((cache ? cacheIndexOf(cache, value) : indexOf(seen, value)) < 0) { | |
argsIndex = argsLength; | |
(cache || seen).push(value); | |
while (--argsIndex) { | |
cache = caches[argsIndex]; | |
if ((cache ? cacheIndexOf(cache, value) : indexOf(args[argsIndex], value)) < 0) { | |
continue outer; | |
} | |
} | |
result.push(value); | |
} | |
} | |
while (argsLength--) { | |
cache = caches[argsLength]; | |
if (cache) { | |
releaseObject(cache); | |
} | |
} | |
releaseArray(caches); | |
releaseArray(seen); | |
return result; | |
} | |
/** | |
* Gets the last element of the `array`. If a number `n` is passed, the | |
* last `n` elements of the `array` are returned. If a `callback` function | |
* is passed, elements at the end of the array are returned as long as the | |
* `callback` returns truthy. The `callback` is bound to `thisArg` and | |
* invoked with three arguments;(value, index, array). | |
* | |
* | |
* If a property name is passed for `callback`, the created "_.pluck" style | |
* callback will return the property value of the given element. | |
* | |
* If an object is passed for `callback`, the created "_.where" style callback | |
* will return `true` for elements that have the properties of the given object, | |
* else `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Arrays | |
* @param {Array} array The array to query. | |
* @param {Function|Object|Number|String} [callback|n] The function called | |
* per element or the number of elements to return. If a property name or | |
* object is passed, it will be used to create a "_.pluck" or "_.where" | |
* style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Mixed} Returns the last element(s) of `array`. | |
* @example | |
* | |
* _.last([1, 2, 3]); | |
* // => 3 | |
* | |
* _.last([1, 2, 3], 2); | |
* // => [2, 3] | |
* | |
* _.last([1, 2, 3], function(num) { | |
* return num > 1; | |
* }); | |
* // => [2, 3] | |
* | |
* var food = [ | |
* { 'name': 'beet', 'organic': false }, | |
* { 'name': 'carrot', 'organic': true } | |
* ]; | |
* | |
* // using "_.pluck" callback shorthand | |
* _.last(food, 'organic'); | |
* // => [{ 'name': 'carrot', 'organic': true }] | |
* | |
* var food = [ | |
* { 'name': 'banana', 'type': 'fruit' }, | |
* { 'name': 'beet', 'type': 'vegetable' }, | |
* { 'name': 'carrot', 'type': 'vegetable' } | |
* ]; | |
* | |
* // using "_.where" callback shorthand | |
* _.last(food, { 'type': 'vegetable' }); | |
* // => [{ 'name': 'beet', 'type': 'vegetable' }, { 'name': 'carrot', 'type': 'vegetable' }] | |
*/ | |
function last(array, callback, thisArg) { | |
if (array) { | |
var n = 0, | |
length = array.length; | |
if (typeof callback != 'number' && callback != null) { | |
var index = length; | |
callback = lodash.createCallback(callback, thisArg); | |
while (index-- && callback(array[index], index, array)) { | |
n++; | |
} | |
} else { | |
n = callback; | |
if (n == null || thisArg) { | |
return array[length - 1]; | |
} | |
} | |
return slice(array, nativeMax(0, length - n)); | |
} | |
} | |
/** | |
* Gets the index at which the last occurrence of `value` is found using strict | |
* equality for comparisons, i.e. `===`. If `fromIndex` is negative, it is used | |
* as the offset from the end of the collection. | |
* | |
* @static | |
* @memberOf _ | |
* @category Arrays | |
* @param {Array} array The array to search. | |
* @param {Mixed} value The value to search for. | |
* @param {Number} [fromIndex=array.length-1] The index to search from. | |
* @returns {Number} Returns the index of the matched value or `-1`. | |
* @example | |
* | |
* _.lastIndexOf([1, 2, 3, 1, 2, 3], 2); | |
* // => 4 | |
* | |
* _.lastIndexOf([1, 2, 3, 1, 2, 3], 2, 3); | |
* // => 1 | |
*/ | |
function lastIndexOf(array, value, fromIndex) { | |
var index = array ? array.length : 0; | |
if (typeof fromIndex == 'number') { | |
index = (fromIndex < 0 ? nativeMax(0, index + fromIndex) : nativeMin(fromIndex, index - 1)) + 1; | |
} | |
while (index--) { | |
if (array[index] === value) { | |
return index; | |
} | |
} | |
return -1; | |
} | |
/** | |
* Creates an array of numbers (positive and/or negative) progressing from | |
* `start` up to but not including `end`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Arrays | |
* @param {Number} [start=0] The start of the range. | |
* @param {Number} end The end of the range. | |
* @param {Number} [step=1] The value to increment or decrement by. | |
* @returns {Array} Returns a new range array. | |
* @example | |
* | |
* _.range(10); | |
* // => [0, 1, 2, 3, 4, 5, 6, 7, 8, 9] | |
* | |
* _.range(1, 11); | |
* // => [1, 2, 3, 4, 5, 6, 7, 8, 9, 10] | |
* | |
* _.range(0, 30, 5); | |
* // => [0, 5, 10, 15, 20, 25] | |
* | |
* _.range(0, -10, -1); | |
* // => [0, -1, -2, -3, -4, -5, -6, -7, -8, -9] | |
* | |
* _.range(0); | |
* // => [] | |
*/ | |
function range(start, end, step) { | |
start = +start || 0; | |
step = +step || 1; | |
if (end == null) { | |
end = start; | |
start = 0; | |
} | |
// use `Array(length)` so V8 will avoid the slower "dictionary" mode | |
// http://youtu.be/XAqIpGU8ZZk#t=17m25s | |
var index = -1, | |
length = nativeMax(0, ceil((end - start) / step)), | |
result = Array(length); | |
while (++index < length) { | |
result[index] = start; | |
start += step; | |
} | |
return result; | |
} | |
/** | |
* The opposite of `_.initial`, this method gets all but the first value of | |
* `array`. If a number `n` is passed, the first `n` values are excluded from | |
* the result. If a `callback` function is passed, elements at the beginning | |
* of the array are excluded from the result as long as the `callback` returns | |
* truthy. The `callback` is bound to `thisArg` and invoked with three | |
* arguments; (value, index, array). | |
* | |
* If a property name is passed for `callback`, the created "_.pluck" style | |
* callback will return the property value of the given element. | |
* | |
* If an object is passed for `callback`, the created "_.where" style callback | |
* will return `true` for elements that have the properties of the given object, | |
* else `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @alias drop, tail | |
* @category Arrays | |
* @param {Array} array The array to query. | |
* @param {Function|Object|Number|String} [callback|n=1] The function called | |
* per element or the number of elements to exclude. If a property name or | |
* object is passed, it will be used to create a "_.pluck" or "_.where" | |
* style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Array} Returns a slice of `array`. | |
* @example | |
* | |
* _.rest([1, 2, 3]); | |
* // => [2, 3] | |
* | |
* _.rest([1, 2, 3], 2); | |
* // => [3] | |
* | |
* _.rest([1, 2, 3], function(num) { | |
* return num < 3; | |
* }); | |
* // => [3] | |
* | |
* var food = [ | |
* { 'name': 'banana', 'organic': true }, | |
* { 'name': 'beet', 'organic': false }, | |
* ]; | |
* | |
* // using "_.pluck" callback shorthand | |
* _.rest(food, 'organic'); | |
* // => [{ 'name': 'beet', 'organic': false }] | |
* | |
* var food = [ | |
* { 'name': 'apple', 'type': 'fruit' }, | |
* { 'name': 'banana', 'type': 'fruit' }, | |
* { 'name': 'beet', 'type': 'vegetable' } | |
* ]; | |
* | |
* // using "_.where" callback shorthand | |
* _.rest(food, { 'type': 'fruit' }); | |
* // => [{ 'name': 'beet', 'type': 'vegetable' }] | |
*/ | |
function rest(array, callback, thisArg) { | |
if (typeof callback != 'number' && callback != null) { | |
var n = 0, | |
index = -1, | |
length = array ? array.length : 0; | |
callback = lodash.createCallback(callback, thisArg); | |
while (++index < length && callback(array[index], index, array)) { | |
n++; | |
} | |
} else { | |
n = (callback == null || thisArg) ? 1 : nativeMax(0, callback); | |
} | |
return slice(array, n); | |
} | |
/** | |
* Uses a binary search to determine the smallest index at which the `value` | |
* should be inserted into `array` in order to maintain the sort order of the | |
* sorted `array`. If `callback` is passed, it will be executed for `value` and | |
* each element in `array` to compute their sort ranking. The `callback` is | |
* bound to `thisArg` and invoked with one argument; (value). | |
* | |
* If a property name is passed for `callback`, the created "_.pluck" style | |
* callback will return the property value of the given element. | |
* | |
* If an object is passed for `callback`, the created "_.where" style callback | |
* will return `true` for elements that have the properties of the given object, | |
* else `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Arrays | |
* @param {Array} array The array to inspect. | |
* @param {Mixed} value The value to evaluate. | |
* @param {Function|Object|String} [callback=identity] The function called per | |
* iteration. If a property name or object is passed, it will be used to create | |
* a "_.pluck" or "_.where" style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Number} Returns the index at which the value should be inserted | |
* into `array`. | |
* @example | |
* | |
* _.sortedIndex([20, 30, 50], 40); | |
* // => 2 | |
* | |
* // using "_.pluck" callback shorthand | |
* _.sortedIndex([{ 'x': 20 }, { 'x': 30 }, { 'x': 50 }], { 'x': 40 }, 'x'); | |
* // => 2 | |
* | |
* var dict = { | |
* 'wordToNumber': { 'twenty': 20, 'thirty': 30, 'fourty': 40, 'fifty': 50 } | |
* }; | |
* | |
* _.sortedIndex(['twenty', 'thirty', 'fifty'], 'fourty', function(word) { | |
* return dict.wordToNumber[word]; | |
* }); | |
* // => 2 | |
* | |
* _.sortedIndex(['twenty', 'thirty', 'fifty'], 'fourty', function(word) { | |
* return this.wordToNumber[word]; | |
* }, dict); | |
* // => 2 | |
*/ | |
function sortedIndex(array, value, callback, thisArg) { | |
var low = 0, | |
high = array ? array.length : low; | |
// explicitly reference `identity` for better inlining in Firefox | |
callback = callback ? lodash.createCallback(callback, thisArg, 1) : identity; | |
value = callback(value); | |
while (low < high) { | |
var mid = (low + high) >>> 1; | |
(callback(array[mid]) < value) | |
? low = mid + 1 | |
: high = mid; | |
} | |
return low; | |
} | |
/** | |
* Computes the union of the passed-in arrays using strict equality for | |
* comparisons, i.e. `===`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Arrays | |
* @param {Array} [array1, array2, ...] Arrays to process. | |
* @returns {Array} Returns a new array of unique values, in order, that are | |
* present in one or more of the arrays. | |
* @example | |
* | |
* _.union([1, 2, 3], [101, 2, 1, 10], [2, 1]); | |
* // => [1, 2, 3, 101, 10] | |
*/ | |
function union(array) { | |
if (!isArray(array)) { | |
arguments[0] = array ? nativeSlice.call(array) : arrayRef; | |
} | |
return uniq(concat.apply(arrayRef, arguments)); | |
} | |
/** | |
* Creates a duplicate-value-free version of the `array` using strict equality | |
* for comparisons, i.e. `===`. If the `array` is already sorted, passing `true` | |
* for `isSorted` will run a faster algorithm. If `callback` is passed, each | |
* element of `array` is passed through the `callback` before uniqueness is computed. | |
* The `callback` is bound to `thisArg` and invoked with three arguments; (value, index, array). | |
* | |
* If a property name is passed for `callback`, the created "_.pluck" style | |
* callback will return the property value of the given element. | |
* | |
* If an object is passed for `callback`, the created "_.where" style callback | |
* will return `true` for elements that have the properties of the given object, | |
* else `false`. | |
* | |
* @static | |
* @memberOf _ | |
* @alias unique | |
* @category Arrays | |
* @param {Array} array The array to process. | |
* @param {Boolean} [isSorted=false] A flag to indicate that the `array` is already sorted. | |
* @param {Function|Object|String} [callback=identity] The function called per | |
* iteration. If a property name or object is passed, it will be used to create | |
* a "_.pluck" or "_.where" style callback, respectively. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Array} Returns a duplicate-value-free array. | |
* @example | |
* | |
* _.uniq([1, 2, 1, 3, 1]); | |
* // => [1, 2, 3] | |
* | |
* _.uniq([1, 1, 2, 2, 3], true); | |
* // => [1, 2, 3] | |
* | |
* _.uniq(['A', 'b', 'C', 'a', 'B', 'c'], function(letter) { return letter.toLowerCase(); }); | |
* // => ['A', 'b', 'C'] | |
* | |
* _.uniq([1, 2.5, 3, 1.5, 2, 3.5], function(num) { return this.floor(num); }, Math); | |
* // => [1, 2.5, 3] | |
* | |
* // using "_.pluck" callback shorthand | |
* _.uniq([{ 'x': 1 }, { 'x': 2 }, { 'x': 1 }], 'x'); | |
* // => [{ 'x': 1 }, { 'x': 2 }] | |
*/ | |
var uniq = overloadWrapper(function(array, isSorted, callback) { | |
var index = -1, | |
indexOf = getIndexOf(), | |
length = array ? array.length : 0, | |
result = []; | |
var isLarge = !isSorted && length >= largeArraySize && indexOf === basicIndexOf, | |
seen = (callback || isLarge) ? getArray() : result; | |
if (isLarge) { | |
var cache = createCache(seen); | |
if (cache) { | |
indexOf = cacheIndexOf; | |
seen = cache; | |
} else { | |
isLarge = false; | |
seen = callback ? seen : (releaseArray(seen), result); | |
} | |
} | |
while (++index < length) { | |
var value = array[index], | |
computed = callback ? callback(value, index, array) : value; | |
if (isSorted | |
? !index || seen[seen.length - 1] !== computed | |
: indexOf(seen, computed) < 0 | |
) { | |
if (callback || isLarge) { | |
seen.push(computed); | |
} | |
result.push(value); | |
} | |
} | |
if (isLarge) { | |
releaseArray(seen.array); | |
releaseObject(seen); | |
} else if (callback) { | |
releaseArray(seen); | |
} | |
return result; | |
}); | |
/** | |
* The inverse of `_.zip`, this method splits groups of elements into arrays | |
* composed of elements from each group at their corresponding indexes. | |
* | |
* @static | |
* @memberOf _ | |
* @category Arrays | |
* @param {Array} array The array to process. | |
* @returns {Array} Returns a new array of the composed arrays. | |
* @example | |
* | |
* _.unzip([['moe', 30, true], ['larry', 40, false]]); | |
* // => [['moe', 'larry'], [30, 40], [true, false]]; | |
*/ | |
function unzip(array) { | |
var index = -1, | |
length = array ? max(pluck(array, 'length')) : 0, | |
result = Array(length < 0 ? 0 : length); | |
while (++index < length) { | |
result[index] = pluck(array, index); | |
} | |
return result; | |
} | |
/** | |
* Creates an array with all occurrences of the passed values removed using | |
* strict equality for comparisons, i.e. `===`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Arrays | |
* @param {Array} array The array to filter. | |
* @param {Mixed} [value1, value2, ...] Values to remove. | |
* @returns {Array} Returns a new filtered array. | |
* @example | |
* | |
* _.without([1, 2, 1, 0, 3, 1, 4], 0, 1); | |
* // => [2, 3, 4] | |
*/ | |
function without(array) { | |
return difference(array, nativeSlice.call(arguments, 1)); | |
} | |
/** | |
* Groups the elements of each array at their corresponding indexes. Useful for | |
* separate data sources that are coordinated through matching array indexes. | |
* For a matrix of nested arrays, `_.zip.apply(...)` can transpose the matrix | |
* in a similar fashion. | |
* | |
* @static | |
* @memberOf _ | |
* @category Arrays | |
* @param {Array} [array1, array2, ...] Arrays to process. | |
* @returns {Array} Returns a new array of grouped elements. | |
* @example | |
* | |
* _.zip(['moe', 'larry'], [30, 40], [true, false]); | |
* // => [['moe', 30, true], ['larry', 40, false]] | |
*/ | |
function zip(array) { | |
return array ? unzip(arguments) : []; | |
} | |
/** | |
* Creates an object composed from arrays of `keys` and `values`. Pass either | |
* a single two dimensional array, i.e. `[[key1, value1], [key2, value2]]`, or | |
* two arrays, one of `keys` and one of corresponding `values`. | |
* | |
* @static | |
* @memberOf _ | |
* @alias object | |
* @category Arrays | |
* @param {Array} keys The array of keys. | |
* @param {Array} [values=[]] The array of values. | |
* @returns {Object} Returns an object composed of the given keys and | |
* corresponding values. | |
* @example | |
* | |
* _.zipObject(['moe', 'larry'], [30, 40]); | |
* // => { 'moe': 30, 'larry': 40 } | |
*/ | |
function zipObject(keys, values) { | |
var index = -1, | |
length = keys ? keys.length : 0, | |
result = {}; | |
while (++index < length) { | |
var key = keys[index]; | |
if (values) { | |
result[key] = values[index]; | |
} else { | |
result[key[0]] = key[1]; | |
} | |
} | |
return result; | |
} | |
/*--------------------------------------------------------------------------*/ | |
/** | |
* If `n` is greater than `0`, a function is created that is restricted to | |
* executing `func`, with the `this` binding and arguments of the created | |
* function, only after it is called `n` times. If `n` is less than `1`, | |
* `func` is executed immediately, without a `this` binding or additional | |
* arguments, and its result is returned. | |
* | |
* @static | |
* @memberOf _ | |
* @category Functions | |
* @param {Number} n The number of times the function must be called before | |
* it is executed. | |
* @param {Function} func The function to restrict. | |
* @returns {Function} Returns the new restricted function. | |
* @example | |
* | |
* var renderNotes = _.after(notes.length, render); | |
* _.forEach(notes, function(note) { | |
* note.asyncSave({ 'success': renderNotes }); | |
* }); | |
* // `renderNotes` is run once, after all notes have saved | |
*/ | |
function after(n, func) { | |
if (n < 1) { | |
return func(); | |
} | |
return function() { | |
if (--n < 1) { | |
return func.apply(this, arguments); | |
} | |
}; | |
} | |
/** | |
* Creates a function that, when called, invokes `func` with the `this` | |
* binding of `thisArg` and prepends any additional `bind` arguments to those | |
* passed to the bound function. | |
* | |
* @static | |
* @memberOf _ | |
* @category Functions | |
* @param {Function} func The function to bind. | |
* @param {Mixed} [thisArg] The `this` binding of `func`. | |
* @param {Mixed} [arg1, arg2, ...] Arguments to be partially applied. | |
* @returns {Function} Returns the new bound function. | |
* @example | |
* | |
* var func = function(greeting) { | |
* return greeting + ' ' + this.name; | |
* }; | |
* | |
* func = _.bind(func, { 'name': 'moe' }, 'hi'); | |
* func(); | |
* // => 'hi moe' | |
*/ | |
function bind(func, thisArg) { | |
// use `Function#bind` if it exists and is fast | |
// (in V8 `Function#bind` is slower except when partially applied) | |
return support.fastBind || (nativeBind && arguments.length > 2) | |
? nativeBind.call.apply(nativeBind, arguments) | |
: createBound(func, thisArg, nativeSlice.call(arguments, 2)); | |
} | |
/** | |
* Binds methods on `object` to `object`, overwriting the existing method. | |
* Method names may be specified as individual arguments or as arrays of method | |
* names. If no method names are provided, all the function properties of `object` | |
* will be bound. | |
* | |
* @static | |
* @memberOf _ | |
* @category Functions | |
* @param {Object} object The object to bind and assign the bound methods to. | |
* @param {String} [methodName1, methodName2, ...] Method names on the object to bind. | |
* @returns {Object} Returns `object`. | |
* @example | |
* | |
* var view = { | |
* 'label': 'docs', | |
* 'onClick': function() { alert('clicked ' + this.label); } | |
* }; | |
* | |
* _.bindAll(view); | |
* jQuery('#docs').on('click', view.onClick); | |
* // => alerts 'clicked docs', when the button is clicked | |
*/ | |
function bindAll(object) { | |
var funcs = arguments.length > 1 ? concat.apply(arrayRef, nativeSlice.call(arguments, 1)) : functions(object), | |
index = -1, | |
length = funcs.length; | |
while (++index < length) { | |
var key = funcs[index]; | |
object[key] = bind(object[key], object); | |
} | |
return object; | |
} | |
/** | |
* Creates a function that, when called, invokes the method at `object[key]` | |
* and prepends any additional `bindKey` arguments to those passed to the bound | |
* function. This method differs from `_.bind` by allowing bound functions to | |
* reference methods that will be redefined or don't yet exist. | |
* See http://michaux.ca/articles/lazy-function-definition-pattern. | |
* | |
* @static | |
* @memberOf _ | |
* @category Functions | |
* @param {Object} object The object the method belongs to. | |
* @param {String} key The key of the method. | |
* @param {Mixed} [arg1, arg2, ...] Arguments to be partially applied. | |
* @returns {Function} Returns the new bound function. | |
* @example | |
* | |
* var object = { | |
* 'name': 'moe', | |
* 'greet': function(greeting) { | |
* return greeting + ' ' + this.name; | |
* } | |
* }; | |
* | |
* var func = _.bindKey(object, 'greet', 'hi'); | |
* func(); | |
* // => 'hi moe' | |
* | |
* object.greet = function(greeting) { | |
* return greeting + ', ' + this.name + '!'; | |
* }; | |
* | |
* func(); | |
* // => 'hi, moe!' | |
*/ | |
function bindKey(object, key) { | |
return createBound(object, key, nativeSlice.call(arguments, 2), indicatorObject); | |
} | |
/** | |
* Creates a function that is the composition of the passed functions, | |
* where each function consumes the return value of the function that follows. | |
* For example, composing the functions `f()`, `g()`, and `h()` produces `f(g(h()))`. | |
* Each function is executed with the `this` binding of the composed function. | |
* | |
* @static | |
* @memberOf _ | |
* @category Functions | |
* @param {Function} [func1, func2, ...] Functions to compose. | |
* @returns {Function} Returns the new composed function. | |
* @example | |
* | |
* var greet = function(name) { return 'hi ' + name; }; | |
* var exclaim = function(statement) { return statement + '!'; }; | |
* var welcome = _.compose(exclaim, greet); | |
* welcome('moe'); | |
* // => 'hi moe!' | |
*/ | |
function compose() { | |
var funcs = arguments; | |
return function() { | |
var args = arguments, | |
length = funcs.length; | |
while (length--) { | |
args = [funcs[length].apply(this, args)]; | |
} | |
return args[0]; | |
}; | |
} | |
/** | |
* Produces a callback bound to an optional `thisArg`. If `func` is a property | |
* name, the created callback will return the property value for a given element. | |
* If `func` is an object, the created callback will return `true` for elements | |
* that contain the equivalent object properties, otherwise it will return `false`. | |
* | |
* Note: All Lo-Dash methods, that accept a `callback` argument, use `_.createCallback`. | |
* | |
* @static | |
* @memberOf _ | |
* @category Functions | |
* @param {Mixed} [func=identity] The value to convert to a callback. | |
* @param {Mixed} [thisArg] The `this` binding of the created callback. | |
* @param {Number} [argCount=3] The number of arguments the callback accepts. | |
* @returns {Function} Returns a callback function. | |
* @example | |
* | |
* var stooges = [ | |
* { 'name': 'moe', 'age': 40 }, | |
* { 'name': 'larry', 'age': 50 } | |
* ]; | |
* | |
* // wrap to create custom callback shorthands | |
* _.createCallback = _.wrap(_.createCallback, function(func, callback, thisArg) { | |
* var match = /^(.+?)__([gl]t)(.+)$/.exec(callback); | |
* return !match ? func(callback, thisArg) : function(object) { | |
* return match[2] == 'gt' ? object[match[1]] > match[3] : object[match[1]] < match[3]; | |
* }; | |
* }); | |
* | |
* _.filter(stooges, 'age__gt45'); | |
* // => [{ 'name': 'larry', 'age': 50 }] | |
* | |
* // create mixins with support for "_.pluck" and "_.where" callback shorthands | |
* _.mixin({ | |
* 'toLookup': function(collection, callback, thisArg) { | |
* callback = _.createCallback(callback, thisArg); | |
* return _.reduce(collection, function(result, value, index, collection) { | |
* return (result[callback(value, index, collection)] = value, result); | |
* }, {}); | |
* } | |
* }); | |
* | |
* _.toLookup(stooges, 'name'); | |
* // => { 'moe': { 'name': 'moe', 'age': 40 }, 'larry': { 'name': 'larry', 'age': 50 } } | |
*/ | |
function createCallback(func, thisArg, argCount) { | |
if (func == null) { | |
return identity; | |
} | |
var type = typeof func; | |
if (type != 'function') { | |
if (type != 'object') { | |
return function(object) { | |
return object[func]; | |
}; | |
} | |
var props = keys(func); | |
return function(object) { | |
var length = props.length, | |
result = false; | |
while (length--) { | |
if (!(result = isEqual(object[props[length]], func[props[length]], indicatorObject))) { | |
break; | |
} | |
} | |
return result; | |
}; | |
} | |
if (typeof thisArg == 'undefined' || (reThis && !reThis.test(fnToString.call(func)))) { | |
return func; | |
} | |
if (argCount === 1) { | |
return function(value) { | |
return func.call(thisArg, value); | |
}; | |
} | |
if (argCount === 2) { | |
return function(a, b) { | |
return func.call(thisArg, a, b); | |
}; | |
} | |
if (argCount === 4) { | |
return function(accumulator, value, index, collection) { | |
return func.call(thisArg, accumulator, value, index, collection); | |
}; | |
} | |
return function(value, index, collection) { | |
return func.call(thisArg, value, index, collection); | |
}; | |
} | |
/** | |
* Creates a function that will delay the execution of `func` until after | |
* `wait` milliseconds have elapsed since the last time it was invoked. Pass | |
* an `options` object to indicate that `func` should be invoked on the leading | |
* and/or trailing edge of the `wait` timeout. Subsequent calls to the debounced | |
* function will return the result of the last `func` call. | |
* | |
* Note: If `leading` and `trailing` options are `true`, `func` will be called | |
* on the trailing edge of the timeout only if the the debounced function is | |
* invoked more than once during the `wait` timeout. | |
* | |
* @static | |
* @memberOf _ | |
* @category Functions | |
* @param {Function} func The function to debounce. | |
* @param {Number} wait The number of milliseconds to delay. | |
* @param {Object} options The options object. | |
* [leading=false] A boolean to specify execution on the leading edge of the timeout. | |
* [maxWait] The maximum time `func` is allowed to be delayed before it's called. | |
* [trailing=true] A boolean to specify execution on the trailing edge of the timeout. | |
* @returns {Function} Returns the new debounced function. | |
* @example | |
* | |
* var lazyLayout = _.debounce(calculateLayout, 300); | |
* jQuery(window).on('resize', lazyLayout); | |
* | |
* jQuery('#postbox').on('click', _.debounce(sendMail, 200, { | |
* 'leading': true, | |
* 'trailing': false | |
* }); | |
*/ | |
function debounce(func, wait, options) { | |
var args, | |
result, | |
thisArg, | |
callCount = 0, | |
lastCalled = 0, | |
maxWait = false, | |
maxTimeoutId = null, | |
timeoutId = null, | |
trailing = true; | |
function clear() { | |
clearTimeout(maxTimeoutId); | |
clearTimeout(timeoutId); | |
callCount = 0; | |
maxTimeoutId = timeoutId = null; | |
} | |
function delayed() { | |
var isCalled = trailing && (!leading || callCount > 1); | |
clear(); | |
if (isCalled) { | |
if (maxWait !== false) { | |
lastCalled = new Date; | |
} | |
result = func.apply(thisArg, args); | |
} | |
} | |
function maxDelayed() { | |
clear(); | |
if (trailing || (maxWait !== wait)) { | |
lastCalled = new Date; | |
result = func.apply(thisArg, args); | |
} | |
} | |
wait = nativeMax(0, wait || 0); | |
if (options === true) { | |
var leading = true; | |
trailing = false; | |
} else if (isObject(options)) { | |
leading = options.leading; | |
maxWait = 'maxWait' in options && nativeMax(wait, options.maxWait || 0); | |
trailing = 'trailing' in options ? options.trailing : trailing; | |
} | |
return function() { | |
args = arguments; | |
thisArg = this; | |
callCount++; | |
// avoid issues with Titanium and `undefined` timeout ids | |
// https://github.com/appcelerator/titanium_mobile/blob/3_1_0_GA/android/titanium/src/java/ti/modules/titanium/TitaniumModule.java#L185-L192 | |
clearTimeout(timeoutId); | |
if (maxWait === false) { | |
if (leading && callCount < 2) { | |
result = func.apply(thisArg, args); | |
} | |
} else { | |
var now = new Date; | |
if (!maxTimeoutId && !leading) { | |
lastCalled = now; | |
} | |
var remaining = maxWait - (now - lastCalled); | |
if (remaining <= 0) { | |
clearTimeout(maxTimeoutId); | |
maxTimeoutId = null; | |
lastCalled = now; | |
result = func.apply(thisArg, args); | |
} | |
else if (!maxTimeoutId) { | |
maxTimeoutId = setTimeout(maxDelayed, remaining); | |
} | |
} | |
if (wait !== maxWait) { | |
timeoutId = setTimeout(delayed, wait); | |
} | |
return result; | |
}; | |
} | |
/** | |
* Defers executing the `func` function until the current call stack has cleared. | |
* Additional arguments will be passed to `func` when it is invoked. | |
* | |
* @static | |
* @memberOf _ | |
* @category Functions | |
* @param {Function} func The function to defer. | |
* @param {Mixed} [arg1, arg2, ...] Arguments to invoke the function with. | |
* @returns {Number} Returns the timer id. | |
* @example | |
* | |
* _.defer(function() { alert('deferred'); }); | |
* // returns from the function before `alert` is called | |
*/ | |
function defer(func) { | |
var args = nativeSlice.call(arguments, 1); | |
return setTimeout(function() { func.apply(undefined, args); }, 1); | |
} | |
// use `setImmediate` if it's available in Node.js | |
if (isV8 && freeModule && typeof setImmediate == 'function') { | |
defer = bind(setImmediate, context); | |
} | |
/** | |
* Executes the `func` function after `wait` milliseconds. Additional arguments | |
* will be passed to `func` when it is invoked. | |
* | |
* @static | |
* @memberOf _ | |
* @category Functions | |
* @param {Function} func The function to delay. | |
* @param {Number} wait The number of milliseconds to delay execution. | |
* @param {Mixed} [arg1, arg2, ...] Arguments to invoke the function with. | |
* @returns {Number} Returns the timer id. | |
* @example | |
* | |
* var log = _.bind(console.log, console); | |
* _.delay(log, 1000, 'logged later'); | |
* // => 'logged later' (Appears after one second.) | |
*/ | |
function delay(func, wait) { | |
var args = nativeSlice.call(arguments, 2); | |
return setTimeout(function() { func.apply(undefined, args); }, wait); | |
} | |
/** | |
* Creates a function that memoizes the result of `func`. If `resolver` is | |
* passed, it will be used to determine the cache key for storing the result | |
* based on the arguments passed to the memoized function. By default, the first | |
* argument passed to the memoized function is used as the cache key. The `func` | |
* is executed with the `this` binding of the memoized function. The result | |
* cache is exposed as the `cache` property on the memoized function. | |
* | |
* @static | |
* @memberOf _ | |
* @category Functions | |
* @param {Function} func The function to have its output memoized. | |
* @param {Function} [resolver] A function used to resolve the cache key. | |
* @returns {Function} Returns the new memoizing function. | |
* @example | |
* | |
* var fibonacci = _.memoize(function(n) { | |
* return n < 2 ? n : fibonacci(n - 1) + fibonacci(n - 2); | |
* }); | |
*/ | |
function memoize(func, resolver) { | |
function memoized() { | |
var cache = memoized.cache, | |
key = keyPrefix + (resolver ? resolver.apply(this, arguments) : arguments[0]); | |
return hasOwnProperty.call(cache, key) | |
? cache[key] | |
: (cache[key] = func.apply(this, arguments)); | |
} | |
memoized.cache = {}; | |
return memoized; | |
} | |
/** | |
* Creates a function that is restricted to execute `func` once. Repeat calls to | |
* the function will return the value of the first call. The `func` is executed | |
* with the `this` binding of the created function. | |
* | |
* @static | |
* @memberOf _ | |
* @category Functions | |
* @param {Function} func The function to restrict. | |
* @returns {Function} Returns the new restricted function. | |
* @example | |
* | |
* var initialize = _.once(createApplication); | |
* initialize(); | |
* initialize(); | |
* // `initialize` executes `createApplication` once | |
*/ | |
function once(func) { | |
var ran, | |
result; | |
return function() { | |
if (ran) { | |
return result; | |
} | |
ran = true; | |
result = func.apply(this, arguments); | |
// clear the `func` variable so the function may be garbage collected | |
func = null; | |
return result; | |
}; | |
} | |
/** | |
* Creates a function that, when called, invokes `func` with any additional | |
* `partial` arguments prepended to those passed to the new function. This | |
* method is similar to `_.bind`, except it does **not** alter the `this` binding. | |
* | |
* @static | |
* @memberOf _ | |
* @category Functions | |
* @param {Function} func The function to partially apply arguments to. | |
* @param {Mixed} [arg1, arg2, ...] Arguments to be partially applied. | |
* @returns {Function} Returns the new partially applied function. | |
* @example | |
* | |
* var greet = function(greeting, name) { return greeting + ' ' + name; }; | |
* var hi = _.partial(greet, 'hi'); | |
* hi('moe'); | |
* // => 'hi moe' | |
*/ | |
function partial(func) { | |
return createBound(func, nativeSlice.call(arguments, 1)); | |
} | |
/** | |
* This method is similar to `_.partial`, except that `partial` arguments are | |
* appended to those passed to the new function. | |
* | |
* @static | |
* @memberOf _ | |
* @category Functions | |
* @param {Function} func The function to partially apply arguments to. | |
* @param {Mixed} [arg1, arg2, ...] Arguments to be partially applied. | |
* @returns {Function} Returns the new partially applied function. | |
* @example | |
* | |
* var defaultsDeep = _.partialRight(_.merge, _.defaults); | |
* | |
* var options = { | |
* 'variable': 'data', | |
* 'imports': { 'jq': $ } | |
* }; | |
* | |
* defaultsDeep(options, _.templateSettings); | |
* | |
* options.variable | |
* // => 'data' | |
* | |
* options.imports | |
* // => { '_': _, 'jq': $ } | |
*/ | |
function partialRight(func) { | |
return createBound(func, nativeSlice.call(arguments, 1), null, indicatorObject); | |
} | |
/** | |
* Creates a function that, when executed, will only call the `func` function | |
* at most once per every `wait` milliseconds. Pass an `options` object to | |
* indicate that `func` should be invoked on the leading and/or trailing edge | |
* of the `wait` timeout. Subsequent calls to the throttled function will | |
* return the result of the last `func` call. | |
* | |
* Note: If `leading` and `trailing` options are `true`, `func` will be called | |
* on the trailing edge of the timeout only if the the throttled function is | |
* invoked more than once during the `wait` timeout. | |
* | |
* @static | |
* @memberOf _ | |
* @category Functions | |
* @param {Function} func The function to throttle. | |
* @param {Number} wait The number of milliseconds to throttle executions to. | |
* @param {Object} options The options object. | |
* [leading=true] A boolean to specify execution on the leading edge of the timeout. | |
* [trailing=true] A boolean to specify execution on the trailing edge of the timeout. | |
* @returns {Function} Returns the new throttled function. | |
* @example | |
* | |
* var throttled = _.throttle(updatePosition, 100); | |
* jQuery(window).on('scroll', throttled); | |
* | |
* jQuery('.interactive').on('click', _.throttle(renewToken, 300000, { | |
* 'trailing': false | |
* })); | |
*/ | |
function throttle(func, wait, options) { | |
var leading = true, | |
trailing = true; | |
if (options === false) { | |
leading = false; | |
} else if (isObject(options)) { | |
leading = 'leading' in options ? options.leading : leading; | |
trailing = 'trailing' in options ? options.trailing : trailing; | |
} | |
options = getObject(); | |
options.leading = leading; | |
options.maxWait = wait; | |
options.trailing = trailing; | |
var result = debounce(func, wait, options); | |
releaseObject(options); | |
return result; | |
} | |
/** | |
* Creates a function that passes `value` to the `wrapper` function as its | |
* first argument. Additional arguments passed to the function are appended | |
* to those passed to the `wrapper` function. The `wrapper` is executed with | |
* the `this` binding of the created function. | |
* | |
* @static | |
* @memberOf _ | |
* @category Functions | |
* @param {Mixed} value The value to wrap. | |
* @param {Function} wrapper The wrapper function. | |
* @returns {Function} Returns the new function. | |
* @example | |
* | |
* var hello = function(name) { return 'hello ' + name; }; | |
* hello = _.wrap(hello, function(func) { | |
* return 'before, ' + func('moe') + ', after'; | |
* }); | |
* hello(); | |
* // => 'before, hello moe, after' | |
*/ | |
function wrap(value, wrapper) { | |
return function() { | |
var args = [value]; | |
push.apply(args, arguments); | |
return wrapper.apply(this, args); | |
}; | |
} | |
/*--------------------------------------------------------------------------*/ | |
/** | |
* Converts the characters `&`, `<`, `>`, `"`, and `'` in `string` to their | |
* corresponding HTML entities. | |
* | |
* @static | |
* @memberOf _ | |
* @category Utilities | |
* @param {String} string The string to escape. | |
* @returns {String} Returns the escaped string. | |
* @example | |
* | |
* _.escape('Moe, Larry & Curly'); | |
* // => 'Moe, Larry & Curly' | |
*/ | |
function escape(string) { | |
return string == null ? '' : String(string).replace(reUnescapedHtml, escapeHtmlChar); | |
} | |
/** | |
* This method returns the first argument passed to it. | |
* | |
* @static | |
* @memberOf _ | |
* @category Utilities | |
* @param {Mixed} value Any value. | |
* @returns {Mixed} Returns `value`. | |
* @example | |
* | |
* var moe = { 'name': 'moe' }; | |
* moe === _.identity(moe); | |
* // => true | |
*/ | |
function identity(value) { | |
return value; | |
} | |
/** | |
* Adds functions properties of `object` to the `lodash` function and chainable | |
* wrapper. | |
* | |
* @static | |
* @memberOf _ | |
* @category Utilities | |
* @param {Object} object The object of function properties to add to `lodash`. | |
* @example | |
* | |
* _.mixin({ | |
* 'capitalize': function(string) { | |
* return string.charAt(0).toUpperCase() + string.slice(1).toLowerCase(); | |
* } | |
* }); | |
* | |
* _.capitalize('moe'); | |
* // => 'Moe' | |
* | |
* _('moe').capitalize(); | |
* // => 'Moe' | |
*/ | |
function mixin(object) { | |
forEach(functions(object), function(methodName) { | |
var func = lodash[methodName] = object[methodName]; | |
lodash.prototype[methodName] = function() { | |
var value = this.__wrapped__, | |
args = [value]; | |
push.apply(args, arguments); | |
var result = func.apply(lodash, args); | |
return (value && typeof value == 'object' && value === result) | |
? this | |
: new lodashWrapper(result); | |
}; | |
}); | |
} | |
/** | |
* Reverts the '_' variable to its previous value and returns a reference to | |
* the `lodash` function. | |
* | |
* @static | |
* @memberOf _ | |
* @category Utilities | |
* @returns {Function} Returns the `lodash` function. | |
* @example | |
* | |
* var lodash = _.noConflict(); | |
*/ | |
function noConflict() { | |
context._ = oldDash; | |
return this; | |
} | |
/** | |
* Converts the given `value` into an integer of the specified `radix`. | |
* If `radix` is `undefined` or `0`, a `radix` of `10` is used unless the | |
* `value` is a hexadecimal, in which case a `radix` of `16` is used. | |
* | |
* Note: This method avoids differences in native ES3 and ES5 `parseInt` | |
* implementations. See http://es5.github.com/#E. | |
* | |
* @static | |
* @memberOf _ | |
* @category Utilities | |
* @param {String} value The value to parse. | |
* @param {Number} [radix] The radix used to interpret the value to parse. | |
* @returns {Number} Returns the new integer value. | |
* @example | |
* | |
* _.parseInt('08'); | |
* // => 8 | |
*/ | |
var parseInt = nativeParseInt(whitespace + '08') == 8 ? nativeParseInt : function(value, radix) { | |
// Firefox and Opera still follow the ES3 specified implementation of `parseInt` | |
return nativeParseInt(isString(value) ? value.replace(reLeadingSpacesAndZeros, '') : value, radix || 0); | |
}; | |
/** | |
* Produces a random number between `min` and `max` (inclusive). If only one | |
* argument is passed, a number between `0` and the given number will be returned. | |
* | |
* @static | |
* @memberOf _ | |
* @category Utilities | |
* @param {Number} [min=0] The minimum possible value. | |
* @param {Number} [max=1] The maximum possible value. | |
* @returns {Number} Returns a random number. | |
* @example | |
* | |
* _.random(0, 5); | |
* // => a number between 0 and 5 | |
* | |
* _.random(5); | |
* // => also a number between 0 and 5 | |
*/ | |
function random(min, max) { | |
if (min == null && max == null) { | |
max = 1; | |
} | |
min = +min || 0; | |
if (max == null) { | |
max = min; | |
min = 0; | |
} else { | |
max = +max || 0; | |
} | |
var rand = nativeRandom(); | |
return (min % 1 || max % 1) | |
? min + nativeMin(rand * (max - min + parseFloat('1e-' + ((rand +'').length - 1))), max) | |
: min + floor(rand * (max - min + 1)); | |
} | |
/** | |
* Resolves the value of `property` on `object`. If `property` is a function, | |
* it will be invoked with the `this` binding of `object` and its result returned, | |
* else the property value is returned. If `object` is falsey, then `undefined` | |
* is returned. | |
* | |
* @static | |
* @memberOf _ | |
* @category Utilities | |
* @param {Object} object The object to inspect. | |
* @param {String} property The property to get the value of. | |
* @returns {Mixed} Returns the resolved value. | |
* @example | |
* | |
* var object = { | |
* 'cheese': 'crumpets', | |
* 'stuff': function() { | |
* return 'nonsense'; | |
* } | |
* }; | |
* | |
* _.result(object, 'cheese'); | |
* // => 'crumpets' | |
* | |
* _.result(object, 'stuff'); | |
* // => 'nonsense' | |
*/ | |
function result(object, property) { | |
var value = object ? object[property] : undefined; | |
return isFunction(value) ? object[property]() : value; | |
} | |
/** | |
* A micro-templating method that handles arbitrary delimiters, preserves | |
* whitespace, and correctly escapes quotes within interpolated code. | |
* | |
* Note: In the development build, `_.template` utilizes sourceURLs for easier | |
* debugging. See http://www.html5rocks.com/en/tutorials/developertools/sourcemaps/#toc-sourceurl | |
* | |
* For more information on precompiling templates see: | |
* http://lodash.com/#custom-builds | |
* | |
* For more information on Chrome extension sandboxes see: | |
* http://developer.chrome.com/stable/extensions/sandboxingEval.html | |
* | |
* @static | |
* @memberOf _ | |
* @category Utilities | |
* @param {String} text The template text. | |
* @param {Object} data The data object used to populate the text. | |
* @param {Object} options The options object. | |
* escape - The "escape" delimiter regexp. | |
* evaluate - The "evaluate" delimiter regexp. | |
* interpolate - The "interpolate" delimiter regexp. | |
* sourceURL - The sourceURL of the template's compiled source. | |
* variable - The data object variable name. | |
* @returns {Function|String} Returns a compiled function when no `data` object | |
* is given, else it returns the interpolated text. | |
* @example | |
* | |
* // using a compiled template | |
* var compiled = _.template('hello <%= name %>'); | |
* compiled({ 'name': 'moe' }); | |
* // => 'hello moe' | |
* | |
* var list = '<% _.forEach(people, function(name) { %><li><%= name %></li><% }); %>'; | |
* _.template(list, { 'people': ['moe', 'larry'] }); | |
* // => '<li>moe</li><li>larry</li>' | |
* | |
* // using the "escape" delimiter to escape HTML in data property values | |
* _.template('<b><%- value %></b>', { 'value': '<script>' }); | |
* // => '<b><script></b>' | |
* | |
* // using the ES6 delimiter as an alternative to the default "interpolate" delimiter | |
* _.template('hello ${ name }', { 'name': 'curly' }); | |
* // => 'hello curly' | |
* | |
* // using the internal `print` function in "evaluate" delimiters | |
* _.template('<% print("hello " + epithet); %>!', { 'epithet': 'stooge' }); | |
* // => 'hello stooge!' | |
* | |
* // using custom template delimiters | |
* _.templateSettings = { | |
* 'interpolate': /{{([\s\S]+?)}}/g | |
* }; | |
* | |
* _.template('hello {{ name }}!', { 'name': 'mustache' }); | |
* // => 'hello mustache!' | |
* | |
* // using the `sourceURL` option to specify a custom sourceURL for the template | |
* var compiled = _.template('hello <%= name %>', null, { 'sourceURL': '/basic/greeting.jst' }); | |
* compiled(data); | |
* // => find the source of "greeting.jst" under the Sources tab or Resources panel of the web inspector | |
* | |
* // using the `variable` option to ensure a with-statement isn't used in the compiled template | |
* var compiled = _.template('hi <%= data.name %>!', null, { 'variable': 'data' }); | |
* compiled.source; | |
* // => function(data) { | |
* var __t, __p = '', __e = _.escape; | |
* __p += 'hi ' + ((__t = ( data.name )) == null ? '' : __t) + '!'; | |
* return __p; | |
* } | |
* | |
* // using the `source` property to inline compiled templates for meaningful | |
* // line numbers in error messages and a stack trace | |
* fs.writeFileSync(path.join(cwd, 'jst.js'), '\ | |
* var JST = {\ | |
* "main": ' + _.template(mainText).source + '\ | |
* };\ | |
* '); | |
*/ | |
function template(text, data, options) { | |
// based on John Resig's `tmpl` implementation | |
// http://ejohn.org/blog/javascript-micro-templating/ | |
// and Laura Doktorova's doT.js | |
// https://github.com/olado/doT | |
var settings = lodash.templateSettings; | |
text || (text = ''); | |
// avoid missing dependencies when `iteratorTemplate` is not defined | |
options = defaults({}, options, settings); | |
var imports = defaults({}, options.imports, settings.imports), | |
importsKeys = keys(imports), | |
importsValues = values(imports); | |
var isEvaluating, | |
index = 0, | |
interpolate = options.interpolate || reNoMatch, | |
source = "__p += '"; | |
// compile the regexp to match each delimiter | |
var reDelimiters = RegExp( | |
(options.escape || reNoMatch).source + '|' + | |
interpolate.source + '|' + | |
(interpolate === reInterpolate ? reEsTemplate : reNoMatch).source + '|' + | |
(options.evaluate || reNoMatch).source + '|$' | |
, 'g'); | |
text.replace(reDelimiters, function(match, escapeValue, interpolateValue, esTemplateValue, evaluateValue, offset) { | |
interpolateValue || (interpolateValue = esTemplateValue); | |
// escape characters that cannot be included in string literals | |
source += text.slice(index, offset).replace(reUnescapedString, escapeStringChar); | |
// replace delimiters with snippets | |
if (escapeValue) { | |
source += "' +\n__e(" + escapeValue + ") +\n'"; | |
} | |
if (evaluateValue) { | |
isEvaluating = true; | |
source += "';\n" + evaluateValue + ";\n__p += '"; | |
} | |
if (interpolateValue) { | |
source += "' +\n((__t = (" + interpolateValue + ")) == null ? '' : __t) +\n'"; | |
} | |
index = offset + match.length; | |
// the JS engine embedded in Adobe products requires returning the `match` | |
// string in order to produce the correct `offset` value | |
return match; | |
}); | |
source += "';\n"; | |
// if `variable` is not specified, wrap a with-statement around the generated | |
// code to add the data object to the top of the scope chain | |
var variable = options.variable, | |
hasVariable = variable; | |
if (!hasVariable) { | |
variable = 'obj'; | |
source = 'with (' + variable + ') {\n' + source + '\n}\n'; | |
} | |
// cleanup code by stripping empty strings | |
source = (isEvaluating ? source.replace(reEmptyStringLeading, '') : source) | |
.replace(reEmptyStringMiddle, '$1') | |
.replace(reEmptyStringTrailing, '$1;'); | |
// frame code as the function body | |
source = 'function(' + variable + ') {\n' + | |
(hasVariable ? '' : variable + ' || (' + variable + ' = {});\n') + | |
"var __t, __p = '', __e = _.escape" + | |
(isEvaluating | |
? ', __j = Array.prototype.join;\n' + | |
"function print() { __p += __j.call(arguments, '') }\n" | |
: ';\n' | |
) + | |
source + | |
'return __p\n}'; | |
// Use a sourceURL for easier debugging and wrap in a multi-line comment to | |
// avoid issues with Narwhal, IE conditional compilation, and the JS engine | |
// embedded in Adobe products. | |
// http://www.html5rocks.com/en/tutorials/developertools/sourcemaps/#toc-sourceurl | |
var sourceURL = '\n/*\n//@ sourceURL=' + (options.sourceURL || '/lodash/template/source[' + (templateCounter++) + ']') + '\n*/'; | |
try { | |
var result = Function(importsKeys, 'return ' + source + sourceURL).apply(undefined, importsValues); | |
} catch(e) { | |
e.source = source; | |
throw e; | |
} | |
if (data) { | |
return result(data); | |
} | |
// provide the compiled function's source via its `toString` method, in | |
// supported environments, or the `source` property as a convenience for | |
// inlining compiled templates during the build process | |
result.source = source; | |
return result; | |
} | |
/** | |
* Executes the `callback` function `n` times, returning an array of the results | |
* of each `callback` execution. The `callback` is bound to `thisArg` and invoked | |
* with one argument; (index). | |
* | |
* @static | |
* @memberOf _ | |
* @category Utilities | |
* @param {Number} n The number of times to execute the callback. | |
* @param {Function} callback The function called per iteration. | |
* @param {Mixed} [thisArg] The `this` binding of `callback`. | |
* @returns {Array} Returns a new array of the results of each `callback` execution. | |
* @example | |
* | |
* var diceRolls = _.times(3, _.partial(_.random, 1, 6)); | |
* // => [3, 6, 4] | |
* | |
* _.times(3, function(n) { mage.castSpell(n); }); | |
* // => calls `mage.castSpell(n)` three times, passing `n` of `0`, `1`, and `2` respectively | |
* | |
* _.times(3, function(n) { this.cast(n); }, mage); | |
* // => also calls `mage.castSpell(n)` three times | |
*/ | |
function times(n, callback, thisArg) { | |
n = (n = +n) > -1 ? n : 0; | |
var index = -1, | |
result = Array(n); | |
callback = lodash.createCallback(callback, thisArg, 1); | |
while (++index < n) { | |
result[index] = callback(index); | |
} | |
return result; | |
} | |
/** | |
* The inverse of `_.escape`, this method converts the HTML entities | |
* `&`, `<`, `>`, `"`, and `'` in `string` to their | |
* corresponding characters. | |
* | |
* @static | |
* @memberOf _ | |
* @category Utilities | |
* @param {String} string The string to unescape. | |
* @returns {String} Returns the unescaped string. | |
* @example | |
* | |
* _.unescape('Moe, Larry & Curly'); | |
* // => 'Moe, Larry & Curly' | |
*/ | |
function unescape(string) { | |
return string == null ? '' : String(string).replace(reEscapedHtml, unescapeHtmlChar); | |
} | |
/** | |
* Generates a unique ID. If `prefix` is passed, the ID will be appended to it. | |
* | |
* @static | |
* @memberOf _ | |
* @category Utilities | |
* @param {String} [prefix] The value to prefix the ID with. | |
* @returns {String} Returns the unique ID. | |
* @example | |
* | |
* _.uniqueId('contact_'); | |
* // => 'contact_104' | |
* | |
* _.uniqueId(); | |
* // => '105' | |
*/ | |
function uniqueId(prefix) { | |
var id = ++idCounter; | |
return String(prefix == null ? '' : prefix) + id; | |
} | |
/*--------------------------------------------------------------------------*/ | |
/** | |
* Invokes `interceptor` with the `value` as the first argument, and then | |
* returns `value`. The purpose of this method is to "tap into" a method chain, | |
* in order to perform operations on intermediate results within the chain. | |
* | |
* @static | |
* @memberOf _ | |
* @category Chaining | |
* @param {Mixed} value The value to pass to `interceptor`. | |
* @param {Function} interceptor The function to invoke. | |
* @returns {Mixed} Returns `value`. | |
* @example | |
* | |
* _([1, 2, 3, 4]) | |
* .filter(function(num) { return num % 2 == 0; }) | |
* .tap(alert) | |
* .map(function(num) { return num * num; }) | |
* .value(); | |
* // => // [2, 4] (alerted) | |
* // => [4, 16] | |
*/ | |
function tap(value, interceptor) { | |
interceptor(value); | |
return value; | |
} | |
/** | |
* Produces the `toString` result of the wrapped value. | |
* | |
* @name toString | |
* @memberOf _ | |
* @category Chaining | |
* @returns {String} Returns the string result. | |
* @example | |
* | |
* _([1, 2, 3]).toString(); | |
* // => '1,2,3' | |
*/ | |
function wrapperToString() { | |
return String(this.__wrapped__); | |
} | |
/** | |
* Extracts the wrapped value. | |
* | |
* @name valueOf | |
* @memberOf _ | |
* @alias value | |
* @category Chaining | |
* @returns {Mixed} Returns the wrapped value. | |
* @example | |
* | |
* _([1, 2, 3]).valueOf(); | |
* // => [1, 2, 3] | |
*/ | |
function wrapperValueOf() { | |
return this.__wrapped__; | |
} | |
/*--------------------------------------------------------------------------*/ | |
// add functions that return wrapped values when chaining | |
lodash.after = after; | |
lodash.assign = assign; | |
lodash.at = at; | |
lodash.bind = bind; | |
lodash.bindAll = bindAll; | |
lodash.bindKey = bindKey; | |
lodash.compact = compact; | |
lodash.compose = compose; | |
lodash.countBy = countBy; | |
lodash.createCallback = createCallback; | |
lodash.debounce = debounce; | |
lodash.defaults = defaults; | |
lodash.defer = defer; | |
lodash.delay = delay; | |
lodash.difference = difference; | |
lodash.filter = filter; | |
lodash.flatten = flatten; | |
lodash.forEach = forEach; | |
lodash.forIn = forIn; | |
lodash.forOwn = forOwn; | |
lodash.functions = functions; | |
lodash.groupBy = groupBy; | |
lodash.initial = initial; | |
lodash.intersection = intersection; | |
lodash.invert = invert; | |
lodash.invoke = invoke; | |
lodash.keys = keys; | |
lodash.map = map; | |
lodash.max = max; | |
lodash.memoize = memoize; | |
lodash.merge = merge; | |
lodash.min = min; | |
lodash.omit = omit; | |
lodash.once = once; | |
lodash.pairs = pairs; | |
lodash.partial = partial; | |
lodash.partialRight = partialRight; | |
lodash.pick = pick; | |
lodash.pluck = pluck; | |
lodash.range = range; | |
lodash.reject = reject; | |
lodash.rest = rest; | |
lodash.shuffle = shuffle; | |
lodash.sortBy = sortBy; | |
lodash.tap = tap; | |
lodash.throttle = throttle; | |
lodash.times = times; | |
lodash.toArray = toArray; | |
lodash.transform = transform; | |
lodash.union = union; | |
lodash.uniq = uniq; | |
lodash.unzip = unzip; | |
lodash.values = values; | |
lodash.where = where; | |
lodash.without = without; | |
lodash.wrap = wrap; | |
lodash.zip = zip; | |
lodash.zipObject = zipObject; | |
// add aliases | |
lodash.collect = map; | |
lodash.drop = rest; | |
lodash.each = forEach; | |
lodash.extend = assign; | |
lodash.methods = functions; | |
lodash.object = zipObject; | |
lodash.select = filter; | |
lodash.tail = rest; | |
lodash.unique = uniq; | |
// add functions to `lodash.prototype` | |
mixin(lodash); | |
// add Underscore compat | |
lodash.chain = lodash; | |
lodash.prototype.chain = function() { return this; }; | |
/*--------------------------------------------------------------------------*/ | |
// add functions that return unwrapped values when chaining | |
lodash.clone = clone; | |
lodash.cloneDeep = cloneDeep; | |
lodash.contains = contains; | |
lodash.escape = escape; | |
lodash.every = every; | |
lodash.find = find; | |
lodash.findIndex = findIndex; | |
lodash.findKey = findKey; | |
lodash.has = has; | |
lodash.identity = identity; | |
lodash.indexOf = indexOf; | |
lodash.isArguments = isArguments; | |
lodash.isArray = isArray; | |
lodash.isBoolean = isBoolean; | |
lodash.isDate = isDate; | |
lodash.isElement = isElement; | |
lodash.isEmpty = isEmpty; | |
lodash.isEqual = isEqual; | |
lodash.isFinite = isFinite; | |
lodash.isFunction = isFunction; | |
lodash.isNaN = isNaN; | |
lodash.isNull = isNull; | |
lodash.isNumber = isNumber; | |
lodash.isObject = isObject; | |
lodash.isPlainObject = isPlainObject; | |
lodash.isRegExp = isRegExp; | |
lodash.isString = isString; | |
lodash.isUndefined = isUndefined; | |
lodash.lastIndexOf = lastIndexOf; | |
lodash.mixin = mixin; | |
lodash.noConflict = noConflict; | |
lodash.parseInt = parseInt; | |
lodash.random = random; | |
lodash.reduce = reduce; | |
lodash.reduceRight = reduceRight; | |
lodash.result = result; | |
lodash.runInContext = runInContext; | |
lodash.size = size; | |
lodash.some = some; | |
lodash.sortedIndex = sortedIndex; | |
lodash.template = template; | |
lodash.unescape = unescape; | |
lodash.uniqueId = uniqueId; | |
// add aliases | |
lodash.all = every; | |
lodash.any = some; | |
lodash.detect = find; | |
lodash.findWhere = find; | |
lodash.foldl = reduce; | |
lodash.foldr = reduceRight; | |
lodash.include = contains; | |
lodash.inject = reduce; | |
forOwn(lodash, function(func, methodName) { | |
if (!lodash.prototype[methodName]) { | |
lodash.prototype[methodName] = function() { | |
var args = [this.__wrapped__]; | |
push.apply(args, arguments); | |
return func.apply(lodash, args); | |
}; | |
} | |
}); | |
/*--------------------------------------------------------------------------*/ | |
// add functions capable of returning wrapped and unwrapped values when chaining | |
lodash.first = first; | |
lodash.last = last; | |
// add aliases | |
lodash.take = first; | |
lodash.head = first; | |
forOwn(lodash, function(func, methodName) { | |
if (!lodash.prototype[methodName]) { | |
lodash.prototype[methodName]= function(callback, thisArg) { | |
var result = func(this.__wrapped__, callback, thisArg); | |
return callback == null || (thisArg && typeof callback != 'function') | |
? result | |
: new lodashWrapper(result); | |
}; | |
} | |
}); | |
/*--------------------------------------------------------------------------*/ | |
/** | |
* The semantic version number. | |
* | |
* @static | |
* @memberOf _ | |
* @type String | |
*/ | |
lodash.VERSION = '1.3.1'; | |
// add "Chaining" functions to the wrapper | |
lodash.prototype.toString = wrapperToString; | |
lodash.prototype.value = wrapperValueOf; | |
lodash.prototype.valueOf = wrapperValueOf; | |
// add `Array` functions that return unwrapped values | |
basicEach(['join', 'pop', 'shift'], function(methodName) { | |
var func = arrayRef[methodName]; | |
lodash.prototype[methodName] = function() { | |
return func.apply(this.__wrapped__, arguments); | |
}; | |
}); | |
// add `Array` functions that return the wrapped value | |
basicEach(['push', 'reverse', 'sort', 'unshift'], function(methodName) { | |
var func = arrayRef[methodName]; | |
lodash.prototype[methodName] = function() { | |
func.apply(this.__wrapped__, arguments); | |
return this; | |
}; | |
}); | |
// add `Array` functions that return new wrapped values | |
basicEach(['concat', 'slice', 'splice'], function(methodName) { | |
var func = arrayRef[methodName]; | |
lodash.prototype[methodName] = function() { | |
return new lodashWrapper(func.apply(this.__wrapped__, arguments)); | |
}; | |
}); | |
// avoid array-like object bugs with `Array#shift` and `Array#splice` | |
// in Firefox < 10 and IE < 9 | |
if (!support.spliceObjects) { | |
basicEach(['pop', 'shift', 'splice'], function(methodName) { | |
var func = arrayRef[methodName], | |
isSplice = methodName == 'splice'; | |
lodash.prototype[methodName] = function() { | |
var value = this.__wrapped__, | |
result = func.apply(value, arguments); | |
if (value.length === 0) { | |
delete value[0]; | |
} | |
return isSplice ? new lodashWrapper(result) : result; | |
}; | |
}); | |
} | |
return lodash; | |
} | |
/*--------------------------------------------------------------------------*/ | |
// expose Lo-Dash | |
var _ = runInContext(); | |
// some AMD build optimizers, like r.js, check for specific condition patterns like the following: | |
if (typeof define == 'function' && typeof define.amd == 'object' && define.amd) { | |
// Expose Lo-Dash to the global object even when an AMD loader is present in | |
// case Lo-Dash was injected by a third-party script and not intended to be | |
// loaded as a module. The global assignment can be reverted in the Lo-Dash | |
// module via its `noConflict()` method. | |
window._ = _; | |
// define as an anonymous module so, through path mapping, it can be | |
// referenced as the "underscore" module | |
define(function() { | |
return _; | |
}); | |
} | |
// check for `exports` after `define` in case a build optimizer adds an `exports` object | |
else if (freeExports && !freeExports.nodeType) { | |
// in Node.js or RingoJS v0.8.0+ | |
if (freeModule) { | |
(freeModule.exports = _)._ = _; | |
} | |
// in Narwhal or RingoJS v0.7.0- | |
else { | |
freeExports._ = _; | |
} | |
} | |
else { | |
// in a browser or Rhino | |
window._ = _; | |
} | |
}(this)); |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
/** vim: et:ts=4:sw=4:sts=4 | |
* @license RequireJS 2.1.5 Copyright (c) 2010-2012, The Dojo Foundation All Rights Reserved. | |
* Available via the MIT or new BSD license. | |
* see: http://github.com/jrburke/requirejs for details | |
*/ | |
//Not using strict: uneven strict support in browsers, #392, and causes | |
//problems with requirejs.exec()/transpiler plugins that may not be strict. | |
/*jslint regexp: true, nomen: true, sloppy: true */ | |
/*global window, navigator, document, importScripts, setTimeout, opera */ | |
var requirejs, require, define; | |
(function (global) { | |
var req, s, head, baseElement, dataMain, src, | |
interactiveScript, currentlyAddingScript, mainScript, subPath, | |
version = '2.1.5', | |
commentRegExp = /(\/\*([\s\S]*?)\*\/|([^:]|^)\/\/(.*)$)/mg, | |
cjsRequireRegExp = /[^.]\s*require\s*\(\s*["']([^'"\s]+)["']\s*\)/g, | |
jsSuffixRegExp = /\.js$/, | |
currDirRegExp = /^\.\//, | |
op = Object.prototype, | |
ostring = op.toString, | |
hasOwn = op.hasOwnProperty, | |
ap = Array.prototype, | |
apsp = ap.splice, | |
isBrowser = !!(typeof window !== 'undefined' && navigator && document), | |
isWebWorker = !isBrowser && typeof importScripts !== 'undefined', | |
//PS3 indicates loaded and complete, but need to wait for complete | |
//specifically. Sequence is 'loading', 'loaded', execution, | |
// then 'complete'. The UA check is unfortunate, but not sure how | |
//to feature test w/o causing perf issues. | |
readyRegExp = isBrowser && navigator.platform === 'PLAYSTATION 3' ? | |
/^complete$/ : /^(complete|loaded)$/, | |
defContextName = '_', | |
//Oh the tragedy, detecting opera. See the usage of isOpera for reason. | |
isOpera = typeof opera !== 'undefined' && opera.toString() === '[object Opera]', | |
contexts = {}, | |
cfg = {}, | |
globalDefQueue = [], | |
useInteractive = false; | |
function isFunction(it) { | |
return ostring.call(it) === '[object Function]'; | |
} | |
function isArray(it) { | |
return ostring.call(it) === '[object Array]'; | |
} | |
/** | |
* Helper function for iterating over an array. If the func returns | |
* a true value, it will break out of the loop. | |
*/ | |
function each(ary, func) { | |
if (ary) { | |
var i; | |
for (i = 0; i < ary.length; i += 1) { | |
if (ary[i] && func(ary[i], i, ary)) { | |
break; | |
} | |
} | |
} | |
} | |
/** | |
* Helper function for iterating over an array backwards. If the func | |
* returns a true value, it will break out of the loop. | |
*/ | |
function eachReverse(ary, func) { | |
if (ary) { | |
var i; | |
for (i = ary.length - 1; i > -1; i -= 1) { | |
if (ary[i] && func(ary[i], i, ary)) { | |
break; | |
} | |
} | |
} | |
} | |
function hasProp(obj, prop) { | |
return hasOwn.call(obj, prop); | |
} | |
function getOwn(obj, prop) { | |
return hasProp(obj, prop) && obj[prop]; | |
} | |
/** | |
* Cycles over properties in an object and calls a function for each | |
* property value. If the function returns a truthy value, then the | |
* iteration is stopped. | |
*/ | |
function eachProp(obj, func) { | |
var prop; | |
for (prop in obj) { | |
if (hasProp(obj, prop)) { | |
if (func(obj[prop], prop)) { | |
break; | |
} | |
} | |
} | |
} | |
/** | |
* Simple function to mix in properties from source into target, | |
* but only if target does not already have a property of the same name. | |
*/ | |
function mixin(target, source, force, deepStringMixin) { | |
if (source) { | |
eachProp(source, function (value, prop) { | |
if (force || !hasProp(target, prop)) { | |
if (deepStringMixin && typeof value !== 'string') { | |
if (!target[prop]) { | |
target[prop] = {}; | |
} | |
mixin(target[prop], value, force, deepStringMixin); | |
} else { | |
target[prop] = value; | |
} | |
} | |
}); | |
} | |
return target; | |
} | |
//Similar to Function.prototype.bind, but the 'this' object is specified | |
//first, since it is easier to read/figure out what 'this' will be. | |
function bind(obj, fn) { | |
return function () { | |
return fn.apply(obj, arguments); | |
}; | |
} | |
function scripts() { | |
return document.getElementsByTagName('script'); | |
} | |
//Allow getting a global that expressed in | |
//dot notation, like 'a.b.c'. | |
function getGlobal(value) { | |
if (!value) { | |
return value; | |
} | |
var g = global; | |
each(value.split('.'), function (part) { | |
g = g[part]; | |
}); | |
return g; | |
} | |
/** | |
* Constructs an error with a pointer to an URL with more information. | |
* @param {String} id the error ID that maps to an ID on a web page. | |
* @param {String} message human readable error. | |
* @param {Error} [err] the original error, if there is one. | |
* | |
* @returns {Error} | |
*/ | |
function makeError(id, msg, err, requireModules) { | |
var e = new Error(msg + '\nhttp://requirejs.org/docs/errors.html#' + id); | |
e.requireType = id; | |
e.requireModules = requireModules; | |
if (err) { | |
e.originalError = err; | |
} | |
return e; | |
} | |
if (typeof define !== 'undefined') { | |
//If a define is already in play via another AMD loader, | |
//do not overwrite. | |
return; | |
} | |
if (typeof requirejs !== 'undefined') { | |
if (isFunction(requirejs)) { | |
//Do not overwrite and existing requirejs instance. | |
return; | |
} | |
cfg = requirejs; | |
requirejs = undefined; | |
} | |
//Allow for a require config object | |
if (typeof require !== 'undefined' && !isFunction(require)) { | |
//assume it is a config object. | |
cfg = require; | |
require = undefined; | |
} | |
function newContext(contextName) { | |
var inCheckLoaded, Module, context, handlers, | |
checkLoadedTimeoutId, | |
config = { | |
//Defaults. Do not set a default for map | |
//config to speed up normalize(), which | |
//will run faster if there is no default. | |
waitSeconds: 7, | |
baseUrl: './', | |
paths: {}, | |
pkgs: {}, | |
shim: {}, | |
config: {} | |
}, | |
registry = {}, | |
//registry of just enabled modules, to speed | |
//cycle breaking code when lots of modules | |
//are registered, but not activated. | |
enabledRegistry = {}, | |
undefEvents = {}, | |
defQueue = [], | |
defined = {}, | |
urlFetched = {}, | |
requireCounter = 1, | |
unnormalizedCounter = 1; | |
/** | |
* Trims the . and .. from an array of path segments. | |
* It will keep a leading path segment if a .. will become | |
* the first path segment, to help with module name lookups, | |
* which act like paths, but can be remapped. But the end result, | |
* all paths that use this function should look normalized. | |
* NOTE: this method MODIFIES the input array. | |
* @param {Array} ary the array of path segments. | |
*/ | |
function trimDots(ary) { | |
var i, part; | |
for (i = 0; ary[i]; i += 1) { | |
part = ary[i]; | |
if (part === '.') { | |
ary.splice(i, 1); | |
i -= 1; | |
} else if (part === '..') { | |
if (i === 1 && (ary[2] === '..' || ary[0] === '..')) { | |
//End of the line. Keep at least one non-dot | |
//path segment at the front so it can be mapped | |
//correctly to disk. Otherwise, there is likely | |
//no path mapping for a path starting with '..'. | |
//This can still fail, but catches the most reasonable | |
//uses of .. | |
break; | |
} else if (i > 0) { | |
ary.splice(i - 1, 2); | |
i -= 2; | |
} | |
} | |
} | |
} | |
/** | |
* Given a relative module name, like ./something, normalize it to | |
* a real name that can be mapped to a path. | |
* @param {String} name the relative name | |
* @param {String} baseName a real name that the name arg is relative | |
* to. | |
* @param {Boolean} applyMap apply the map config to the value. Should | |
* only be done if this normalization is for a dependency ID. | |
* @returns {String} normalized name | |
*/ | |
function normalize(name, baseName, applyMap) { | |
var pkgName, pkgConfig, mapValue, nameParts, i, j, nameSegment, | |
foundMap, foundI, foundStarMap, starI, | |
baseParts = baseName && baseName.split('/'), | |
normalizedBaseParts = baseParts, | |
map = config.map, | |
starMap = map && map['*']; | |
//Adjust any relative paths. | |
if (name && name.charAt(0) === '.') { | |
//If have a base name, try to normalize against it, | |
//otherwise, assume it is a top-level require that will | |
//be relative to baseUrl in the end. | |
if (baseName) { | |
if (getOwn(config.pkgs, baseName)) { | |
//If the baseName is a package name, then just treat it as one | |
//name to concat the name with. | |
normalizedBaseParts = baseParts = [baseName]; | |
} else { | |
//Convert baseName to array, and lop off the last part, | |
//so that . matches that 'directory' and not name of the baseName's | |
//module. For instance, baseName of 'one/two/three', maps to | |
//'one/two/three.js', but we want the directory, 'one/two' for | |
//this normalization. | |
normalizedBaseParts = baseParts.slice(0, baseParts.length - 1); | |
} | |
name = normalizedBaseParts.concat(name.split('/')); | |
trimDots(name); | |
//Some use of packages may use a . path to reference the | |
//'main' module name, so normalize for that. | |
pkgConfig = getOwn(config.pkgs, (pkgName = name[0])); | |
name = name.join('/'); | |
if (pkgConfig && name === pkgName + '/' + pkgConfig.main) { | |
name = pkgName; | |
} | |
} else if (name.indexOf('./') === 0) { | |
// No baseName, so this is ID is resolved relative | |
// to baseUrl, pull off the leading dot. | |
name = name.substring(2); | |
} | |
} | |
//Apply map config if available. | |
if (applyMap && map && (baseParts || starMap)) { | |
nameParts = name.split('/'); | |
for (i = nameParts.length; i > 0; i -= 1) { | |
nameSegment = nameParts.slice(0, i).join('/'); | |
if (baseParts) { | |
//Find the longest baseName segment match in the config. | |
//So, do joins on the biggest to smallest lengths of baseParts. | |
for (j = baseParts.length; j > 0; j -= 1) { | |
mapValue = getOwn(map, baseParts.slice(0, j).join('/')); | |
//baseName segment has config, find if it has one for | |
//this name. | |
if (mapValue) { | |
mapValue = getOwn(mapValue, nameSegment); | |
if (mapValue) { | |
//Match, update name to the new value. | |
foundMap = mapValue; | |
foundI = i; | |
break; | |
} | |
} | |
} | |
} | |
if (foundMap) { | |
break; | |
} | |
//Check for a star map match, but just hold on to it, | |
//if there is a shorter segment match later in a matching | |
//config, then favor over this star map. | |
if (!foundStarMap && starMap && getOwn(starMap, nameSegment)) { | |
foundStarMap = getOwn(starMap, nameSegment); | |
starI = i; | |
} | |
} | |
if (!foundMap && foundStarMap) { | |
foundMap = foundStarMap; | |
foundI = starI; | |
} | |
if (foundMap) { | |
nameParts.splice(0, foundI, foundMap); | |
name = nameParts.join('/'); | |
} | |
} | |
return name; | |
} | |
function removeScript(name) { | |
if (isBrowser) { | |
each(scripts(), function (scriptNode) { | |
if (scriptNode.getAttribute('data-requiremodule') === name && | |
scriptNode.getAttribute('data-requirecontext') === context.contextName) { | |
scriptNode.parentNode.removeChild(scriptNode); | |
return true; | |
} | |
}); | |
} | |
} | |
function hasPathFallback(id) { | |
var pathConfig = getOwn(config.paths, id); | |
if (pathConfig && isArray(pathConfig) && pathConfig.length > 1) { | |
removeScript(id); | |
//Pop off the first array value, since it failed, and | |
//retry | |
pathConfig.shift(); | |
context.require.undef(id); | |
context.require([id]); | |
return true; | |
} | |
} | |
//Turns a plugin!resource to [plugin, resource] | |
//with the plugin being undefined if the name | |
//did not have a plugin prefix. | |
function splitPrefix(name) { | |
var prefix, | |
index = name ? name.indexOf('!') : -1; | |
if (index > -1) { | |
prefix = name.substring(0, index); | |
name = name.substring(index + 1, name.length); | |
} | |
return [prefix, name]; | |
} | |
/** | |
* Creates a module mapping that includes plugin prefix, module | |
* name, and path. If parentModuleMap is provided it will | |
* also normalize the name via require.normalize() | |
* | |
* @param {String} name the module name | |
* @param {String} [parentModuleMap] parent module map | |
* for the module name, used to resolve relative names. | |
* @param {Boolean} isNormalized: is the ID already normalized. | |
* This is true if this call is done for a define() module ID. | |
* @param {Boolean} applyMap: apply the map config to the ID. | |
* Should only be true if this map is for a dependency. | |
* | |
* @returns {Object} | |
*/ | |
function makeModuleMap(name, parentModuleMap, isNormalized, applyMap) { | |
var url, pluginModule, suffix, nameParts, | |
prefix = null, | |
parentName = parentModuleMap ? parentModuleMap.name : null, | |
originalName = name, | |
isDefine = true, | |
normalizedName = ''; | |
//If no name, then it means it is a require call, generate an | |
//internal name. | |
if (!name) { | |
isDefine = false; | |
name = '_@r' + (requireCounter += 1); | |
} | |
nameParts = splitPrefix(name); | |
prefix = nameParts[0]; | |
name = nameParts[1]; | |
if (prefix) { | |
prefix = normalize(prefix, parentName, applyMap); | |
pluginModule = getOwn(defined, prefix); | |
} | |
//Account for relative paths if there is a base name. | |
if (name) { | |
if (prefix) { | |
if (pluginModule && pluginModule.normalize) { | |
//Plugin is loaded, use its normalize method. | |
normalizedName = pluginModule.normalize(name, function (name) { | |
return normalize(name, parentName, applyMap); | |
}); | |
} else { | |
normalizedName = normalize(name, parentName, applyMap); | |
} | |
} else { | |
//A regular module. | |
normalizedName = normalize(name, parentName, applyMap); | |
//Normalized name may be a plugin ID due to map config | |
//application in normalize. The map config values must | |
//already be normalized, so do not need to redo that part. | |
nameParts = splitPrefix(normalizedName); | |
prefix = nameParts[0]; | |
normalizedName = nameParts[1]; | |
isNormalized = true; | |
url = context.nameToUrl(normalizedName); | |
} | |
} | |
//If the id is a plugin id that cannot be determined if it needs | |
//normalization, stamp it with a unique ID so two matching relative | |
//ids that may conflict can be separate. | |
suffix = prefix && !pluginModule && !isNormalized ? | |
'_unnormalized' + (unnormalizedCounter += 1) : | |
''; | |
return { | |
prefix: prefix, | |
name: normalizedName, | |
parentMap: parentModuleMap, | |
unnormalized: !!suffix, | |
url: url, | |
originalName: originalName, | |
isDefine: isDefine, | |
id: (prefix ? | |
prefix + '!' + normalizedName : | |
normalizedName) + suffix | |
}; | |
} | |
function getModule(depMap) { | |
var id = depMap.id, | |
mod = getOwn(registry, id); | |
if (!mod) { | |
mod = registry[id] = new context.Module(depMap); | |
} | |
return mod; | |
} | |
function on(depMap, name, fn) { | |
var id = depMap.id, | |
mod = getOwn(registry, id); | |
if (hasProp(defined, id) && | |
(!mod || mod.defineEmitComplete)) { | |
if (name === 'defined') { | |
fn(defined[id]); | |
} | |
} else { | |
getModule(depMap).on(name, fn); | |
} | |
} | |
function onError(err, errback) { | |
var ids = err.requireModules, | |
notified = false; | |
if (errback) { | |
errback(err); | |
} else { | |
each(ids, function (id) { | |
var mod = getOwn(registry, id); | |
if (mod) { | |
//Set error on module, so it skips timeout checks. | |
mod.error = err; | |
if (mod.events.error) { | |
notified = true; | |
mod.emit('error', err); | |
} | |
} | |
}); | |
if (!notified) { | |
req.onError(err); | |
} | |
} | |
} | |
/** | |
* Internal method to transfer globalQueue items to this context's | |
* defQueue. | |
*/ | |
function takeGlobalQueue() { | |
//Push all the globalDefQueue items into the context's defQueue | |
if (globalDefQueue.length) { | |
//Array splice in the values since the context code has a | |
//local var ref to defQueue, so cannot just reassign the one | |
//on context. | |
apsp.apply(defQueue, | |
[defQueue.length - 1, 0].concat(globalDefQueue)); | |
globalDefQueue = []; | |
} | |
} | |
handlers = { | |
'require': function (mod) { | |
if (mod.require) { | |
return mod.require; | |
} else { | |
return (mod.require = context.makeRequire(mod.map)); | |
} | |
}, | |
'exports': function (mod) { | |
mod.usingExports = true; | |
if (mod.map.isDefine) { | |
if (mod.exports) { | |
return mod.exports; | |
} else { | |
return (mod.exports = defined[mod.map.id] = {}); | |
} | |
} | |
}, | |
'module': function (mod) { | |
if (mod.module) { | |
return mod.module; | |
} else { | |
return (mod.module = { | |
id: mod.map.id, | |
uri: mod.map.url, | |
config: function () { | |
return (config.config && getOwn(config.config, mod.map.id)) || {}; | |
}, | |
exports: defined[mod.map.id] | |
}); | |
} | |
} | |
}; | |
function cleanRegistry(id) { | |
//Clean up machinery used for waiting modules. | |
delete registry[id]; | |
delete enabledRegistry[id]; | |
} | |
function breakCycle(mod, traced, processed) { | |
var id = mod.map.id; | |
if (mod.error) { | |
mod.emit('error', mod.error); | |
} else { | |
traced[id] = true; | |
each(mod.depMaps, function (depMap, i) { | |
var depId = depMap.id, | |
dep = getOwn(registry, depId); | |
//Only force things that have not completed | |
//being defined, so still in the registry, | |
//and only if it has not been matched up | |
//in the module already. | |
if (dep && !mod.depMatched[i] && !processed[depId]) { | |
if (getOwn(traced, depId)) { | |
mod.defineDep(i, defined[depId]); | |
mod.check(); //pass false? | |
} else { | |
breakCycle(dep, traced, processed); | |
} | |
} | |
}); | |
processed[id] = true; | |
} | |
} | |
function checkLoaded() { | |
var map, modId, err, usingPathFallback, | |
waitInterval = config.waitSeconds * 1000, | |
//It is possible to disable the wait interval by using waitSeconds of 0. | |
expired = waitInterval && (context.startTime + waitInterval) < new Date().getTime(), | |
noLoads = [], | |
reqCalls = [], | |
stillLoading = false, | |
needCycleCheck = true; | |
//Do not bother if this call was a result of a cycle break. | |
if (inCheckLoaded) { | |
return; | |
} | |
inCheckLoaded = true; | |
//Figure out the state of all the modules. | |
eachProp(enabledRegistry, function (mod) { | |
map = mod.map; | |
modId = map.id; | |
//Skip things that are not enabled or in error state. | |
if (!mod.enabled) { | |
return; | |
} | |
if (!map.isDefine) { | |
reqCalls.push(mod); | |
} | |
if (!mod.error) { | |
//If the module should be executed, and it has not | |
//been inited and time is up, remember it. | |
if (!mod.inited && expired) { | |
if (hasPathFallback(modId)) { | |
usingPathFallback = true; | |
stillLoading = true; | |
} else { | |
noLoads.push(modId); | |
removeScript(modId); | |
} | |
} else if (!mod.inited && mod.fetched && map.isDefine) { | |
stillLoading = true; | |
if (!map.prefix) { | |
//No reason to keep looking for unfinished | |
//loading. If the only stillLoading is a | |
//plugin resource though, keep going, | |
//because it may be that a plugin resource | |
//is waiting on a non-plugin cycle. | |
return (needCycleCheck = false); | |
} | |
} | |
} | |
}); | |
if (expired && noLoads.length) { | |
//If wait time expired, throw error of unloaded modules. | |
err = makeError('timeout', 'Load timeout for modules: ' + noLoads, null, noLoads); | |
err.contextName = context.contextName; | |
return onError(err); | |
} | |
//Not expired, check for a cycle. | |
if (needCycleCheck) { | |
each(reqCalls, function (mod) { | |
breakCycle(mod, {}, {}); | |
}); | |
} | |
//If still waiting on loads, and the waiting load is something | |
//other than a plugin resource, or there are still outstanding | |
//scripts, then just try back later. | |
if ((!expired || usingPathFallback) && stillLoading) { | |
//Something is still waiting to load. Wait for it, but only | |
//if a timeout is not already in effect. | |
if ((isBrowser || isWebWorker) && !checkLoadedTimeoutId) { | |
checkLoadedTimeoutId = setTimeout(function () { | |
checkLoadedTimeoutId = 0; | |
checkLoaded(); | |
}, 50); | |
} | |
} | |
inCheckLoaded = false; | |
} | |
Module = function (map) { | |
this.events = getOwn(undefEvents, map.id) || {}; | |
this.map = map; | |
this.shim = getOwn(config.shim, map.id); | |
this.depExports = []; | |
this.depMaps = []; | |
this.depMatched = []; | |
this.pluginMaps = {}; | |
this.depCount = 0; | |
/* this.exports this.factory | |
this.depMaps = [], | |
this.enabled, this.fetched | |
*/ | |
}; | |
Module.prototype = { | |
init: function (depMaps, factory, errback, options) { | |
options = options || {}; | |
//Do not do more inits if already done. Can happen if there | |
//are multiple define calls for the same module. That is not | |
//a normal, common case, but it is also not unexpected. | |
if (this.inited) { | |
return; | |
} | |
this.factory = factory; | |
if (errback) { | |
//Register for errors on this module. | |
this.on('error', errback); | |
} else if (this.events.error) { | |
//If no errback already, but there are error listeners | |
//on this module, set up an errback to pass to the deps. | |
errback = bind(this, function (err) { | |
this.emit('error', err); | |
}); | |
} | |
//Do a copy of the dependency array, so that | |
//source inputs are not modified. For example | |
//"shim" deps are passed in here directly, and | |
//doing a direct modification of the depMaps array | |
//would affect that config. | |
this.depMaps = depMaps && depMaps.slice(0); | |
this.errback = errback; | |
//Indicate this module has be initialized | |
this.inited = true; | |
this.ignore = options.ignore; | |
//Could have option to init this module in enabled mode, | |
//or could have been previously marked as enabled. However, | |
//the dependencies are not known until init is called. So | |
//if enabled previously, now trigger dependencies as enabled. | |
if (options.enabled || this.enabled) { | |
//Enable this module and dependencies. | |
//Will call this.check() | |
this.enable(); | |
} else { | |
this.check(); | |
} | |
}, | |
defineDep: function (i, depExports) { | |
//Because of cycles, defined callback for a given | |
//export can be called more than once. | |
if (!this.depMatched[i]) { | |
this.depMatched[i] = true; | |
this.depCount -= 1; | |
this.depExports[i] = depExports; | |
} | |
}, | |
fetch: function () { | |
if (this.fetched) { | |
return; | |
} | |
this.fetched = true; | |
context.startTime = (new Date()).getTime(); | |
var map = this.map; | |
//If the manager is for a plugin managed resource, | |
//ask the plugin to load it now. | |
if (this.shim) { | |
context.makeRequire(this.map, { | |
enableBuildCallback: true | |
})(this.shim.deps || [], bind(this, function () { | |
return map.prefix ? this.callPlugin() : this.load(); | |
})); | |
} else { | |
//Regular dependency. | |
return map.prefix ? this.callPlugin() : this.load(); | |
} | |
}, | |
load: function () { | |
var url = this.map.url; | |
//Regular dependency. | |
if (!urlFetched[url]) { | |
urlFetched[url] = true; | |
context.load(this.map.id, url); | |
} | |
}, | |
/** | |
* Checks if the module is ready to define itself, and if so, | |
* define it. | |
*/ | |
check: function () { | |
if (!this.enabled || this.enabling) { | |
return; | |
} | |
var err, cjsModule, | |
id = this.map.id, | |
depExports = this.depExports, | |
exports = this.exports, | |
factory = this.factory; | |
if (!this.inited) { | |
this.fetch(); | |
} else if (this.error) { | |
this.emit('error', this.error); | |
} else if (!this.defining) { | |
//The factory could trigger another require call | |
//that would result in checking this module to | |
//define itself again. If already in the process | |
//of doing that, skip this work. | |
this.defining = true; | |
if (this.depCount < 1 && !this.defined) { | |
if (isFunction(factory)) { | |
//If there is an error listener, favor passing | |
//to that instead of throwing an error. | |
if (this.events.error) { | |
try { | |
exports = context.execCb(id, factory, depExports, exports); | |
} catch (e) { | |
err = e; | |
} | |
} else { | |
exports = context.execCb(id, factory, depExports, exports); | |
} | |
if (this.map.isDefine) { | |
//If setting exports via 'module' is in play, | |
//favor that over return value and exports. After that, | |
//favor a non-undefined return value over exports use. | |
cjsModule = this.module; | |
if (cjsModule && | |
cjsModule.exports !== undefined && | |
//Make sure it is not already the exports value | |
cjsModule.exports !== this.exports) { | |
exports = cjsModule.exports; | |
} else if (exports === undefined && this.usingExports) { | |
//exports already set the defined value. | |
exports = this.exports; | |
} | |
} | |
if (err) { | |
err.requireMap = this.map; | |
err.requireModules = [this.map.id]; | |
err.requireType = 'define'; | |
return onError((this.error = err)); | |
} | |
} else { | |
//Just a literal value | |
exports = factory; | |
} | |
this.exports = exports; | |
if (this.map.isDefine && !this.ignore) { | |
defined[id] = exports; | |
if (req.onResourceLoad) { | |
req.onResourceLoad(context, this.map, this.depMaps); | |
} | |
} | |
//Clean up | |
cleanRegistry(id); | |
this.defined = true; | |
} | |
//Finished the define stage. Allow calling check again | |
//to allow define notifications below in the case of a | |
//cycle. | |
this.defining = false; | |
if (this.defined && !this.defineEmitted) { | |
this.defineEmitted = true; | |
this.emit('defined', this.exports); | |
this.defineEmitComplete = true; | |
} | |
} | |
}, | |
callPlugin: function () { | |
var map = this.map, | |
id = map.id, | |
//Map already normalized the prefix. | |
pluginMap = makeModuleMap(map.prefix); | |
//Mark this as a dependency for this plugin, so it | |
//can be traced for cycles. | |
this.depMaps.push(pluginMap); | |
on(pluginMap, 'defined', bind(this, function (plugin) { | |
var load, normalizedMap, normalizedMod, | |
name = this.map.name, | |
parentName = this.map.parentMap ? this.map.parentMap.name : null, | |
localRequire = context.makeRequire(map.parentMap, { | |
enableBuildCallback: true | |
}); | |
//If current map is not normalized, wait for that | |
//normalized name to load instead of continuing. | |
if (this.map.unnormalized) { | |
//Normalize the ID if the plugin allows it. | |
if (plugin.normalize) { | |
name = plugin.normalize(name, function (name) { | |
return normalize(name, parentName, true); | |
}) || ''; | |
} | |
//prefix and name should already be normalized, no need | |
//for applying map config again either. | |
normalizedMap = makeModuleMap(map.prefix + '!' + name, | |
this.map.parentMap); | |
on(normalizedMap, | |
'defined', bind(this, function (value) { | |
this.init([], function () { return value; }, null, { | |
enabled: true, | |
ignore: true | |
}); | |
})); | |
normalizedMod = getOwn(registry, normalizedMap.id); | |
if (normalizedMod) { | |
//Mark this as a dependency for this plugin, so it | |
//can be traced for cycles. | |
this.depMaps.push(normalizedMap); | |
if (this.events.error) { | |
normalizedMod.on('error', bind(this, function (err) { | |
this.emit('error', err); | |
})); | |
} | |
normalizedMod.enable(); | |
} | |
return; | |
} | |
load = bind(this, function (value) { | |
this.init([], function () { return value; }, null, { | |
enabled: true | |
}); | |
}); | |
load.error = bind(this, function (err) { | |
this.inited = true; | |
this.error = err; | |
err.requireModules = [id]; | |
//Remove temp unnormalized modules for this module, | |
//since they will never be resolved otherwise now. | |
eachProp(registry, function (mod) { | |
if (mod.map.id.indexOf(id + '_unnormalized') === 0) { | |
cleanRegistry(mod.map.id); | |
} | |
}); | |
onError(err); | |
}); | |
//Allow plugins to load other code without having to know the | |
//context or how to 'complete' the load. | |
load.fromText = bind(this, function (text, textAlt) { | |
/*jslint evil: true */ | |
var moduleName = map.name, | |
moduleMap = makeModuleMap(moduleName), | |
hasInteractive = useInteractive; | |
//As of 2.1.0, support just passing the text, to reinforce | |
//fromText only being called once per resource. Still | |
//support old style of passing moduleName but discard | |
//that moduleName in favor of the internal ref. | |
if (textAlt) { | |
text = textAlt; | |
} | |
//Turn off interactive script matching for IE for any define | |
//calls in the text, then turn it back on at the end. | |
if (hasInteractive) { | |
useInteractive = false; | |
} | |
//Prime the system by creating a module instance for | |
//it. | |
getModule(moduleMap); | |
//Transfer any config to this other module. | |
if (hasProp(config.config, id)) { | |
config.config[moduleName] = config.config[id]; | |
} | |
try { | |
req.exec(text); | |
} catch (e) { | |
return onError(makeError('fromtexteval', | |
'fromText eval for ' + id + | |
' failed: ' + e, | |
e, | |
[id])); | |
} | |
if (hasInteractive) { | |
useInteractive = true; | |
} | |
//Mark this as a dependency for the plugin | |
//resource | |
this.depMaps.push(moduleMap); | |
//Support anonymous modules. | |
context.completeLoad(moduleName); | |
//Bind the value of that module to the value for this | |
//resource ID. | |
localRequire([moduleName], load); | |
}); | |
//Use parentName here since the plugin's name is not reliable, | |
//could be some weird string with no path that actually wants to | |
//reference the parentName's path. | |
plugin.load(map.name, localRequire, load, config); | |
})); | |
context.enable(pluginMap, this); | |
this.pluginMaps[pluginMap.id] = pluginMap; | |
}, | |
enable: function () { | |
enabledRegistry[this.map.id] = this; | |
this.enabled = true; | |
//Set flag mentioning that the module is enabling, | |
//so that immediate calls to the defined callbacks | |
//for dependencies do not trigger inadvertent load | |
//with the depCount still being zero. | |
this.enabling = true; | |
//Enable each dependency | |
each(this.depMaps, bind(this, function (depMap, i) { | |
var id, mod, handler; | |
if (typeof depMap === 'string') { | |
//Dependency needs to be converted to a depMap | |
//and wired up to this module. | |
depMap = makeModuleMap(depMap, | |
(this.map.isDefine ? this.map : this.map.parentMap), | |
false, | |
!this.skipMap); | |
this.depMaps[i] = depMap; | |
handler = getOwn(handlers, depMap.id); | |
if (handler) { | |
this.depExports[i] = handler(this); | |
return; | |
} | |
this.depCount += 1; | |
on(depMap, 'defined', bind(this, function (depExports) { | |
this.defineDep(i, depExports); | |
this.check(); | |
})); | |
if (this.errback) { | |
on(depMap, 'error', this.errback); | |
} | |
} | |
id = depMap.id; | |
mod = registry[id]; | |
//Skip special modules like 'require', 'exports', 'module' | |
//Also, don't call enable if it is already enabled, | |
//important in circular dependency cases. | |
if (!hasProp(handlers, id) && mod && !mod.enabled) { | |
context.enable(depMap, this); | |
} | |
})); | |
//Enable each plugin that is used in | |
//a dependency | |
eachProp(this.pluginMaps, bind(this, function (pluginMap) { | |
var mod = getOwn(registry, pluginMap.id); | |
if (mod && !mod.enabled) { | |
context.enable(pluginMap, this); | |
} | |
})); | |
this.enabling = false; | |
this.check(); | |
}, | |
on: function (name, cb) { | |
var cbs = this.events[name]; | |
if (!cbs) { | |
cbs = this.events[name] = []; | |
} | |
cbs.push(cb); | |
}, | |
emit: function (name, evt) { | |
each(this.events[name], function (cb) { | |
cb(evt); | |
}); | |
if (name === 'error') { | |
//Now that the error handler was triggered, remove | |
//the listeners, since this broken Module instance | |
//can stay around for a while in the registry. | |
delete this.events[name]; | |
} | |
} | |
}; | |
function callGetModule(args) { | |
//Skip modules already defined. | |
if (!hasProp(defined, args[0])) { | |
getModule(makeModuleMap(args[0], null, true)).init(args[1], args[2]); | |
} | |
} | |
function removeListener(node, func, name, ieName) { | |
//Favor detachEvent because of IE9 | |
//issue, see attachEvent/addEventListener comment elsewhere | |
//in this file. | |
if (node.detachEvent && !isOpera) { | |
//Probably IE. If not it will throw an error, which will be | |
//useful to know. | |
if (ieName) { | |
node.detachEvent(ieName, func); | |
} | |
} else { | |
node.removeEventListener(name, func, false); | |
} | |
} | |
/** | |
* Given an event from a script node, get the requirejs info from it, | |
* and then removes the event listeners on the node. | |
* @param {Event} evt | |
* @returns {Object} | |
*/ | |
function getScriptData(evt) { | |
//Using currentTarget instead of target for Firefox 2.0's sake. Not | |
//all old browsers will be supported, but this one was easy enough | |
//to support and still makes sense. | |
var node = evt.currentTarget || evt.srcElement; | |
//Remove the listeners once here. | |
removeListener(node, context.onScriptLoad, 'load', 'onreadystatechange'); | |
removeListener(node, context.onScriptError, 'error'); | |
return { | |
node: node, | |
id: node && node.getAttribute('data-requiremodule') | |
}; | |
} | |
function intakeDefines() { | |
var args; | |
//Any defined modules in the global queue, intake them now. | |
takeGlobalQueue(); | |
//Make sure any remaining defQueue items get properly processed. | |
while (defQueue.length) { | |
args = defQueue.shift(); | |
if (args[0] === null) { | |
return onError(makeError('mismatch', 'Mismatched anonymous define() module: ' + args[args.length - 1])); | |
} else { | |
//args are id, deps, factory. Should be normalized by the | |
//define() function. | |
callGetModule(args); | |
} | |
} | |
} | |
context = { | |
config: config, | |
contextName: contextName, | |
registry: registry, | |
defined: defined, | |
urlFetched: urlFetched, | |
defQueue: defQueue, | |
Module: Module, | |
makeModuleMap: makeModuleMap, | |
nextTick: req.nextTick, | |
onError: onError, | |
/** | |
* Set a configuration for the context. | |
* @param {Object} cfg config object to integrate. | |
*/ | |
configure: function (cfg) { | |
//Make sure the baseUrl ends in a slash. | |
if (cfg.baseUrl) { | |
if (cfg.baseUrl.charAt(cfg.baseUrl.length - 1) !== '/') { | |
cfg.baseUrl += '/'; | |
} | |
} | |
//Save off the paths and packages since they require special processing, | |
//they are additive. | |
var pkgs = config.pkgs, | |
shim = config.shim, | |
objs = { | |
paths: true, | |
config: true, | |
map: true | |
}; | |
eachProp(cfg, function (value, prop) { | |
if (objs[prop]) { | |
if (prop === 'map') { | |
if (!config.map) { | |
config.map = {}; | |
} | |
mixin(config[prop], value, true, true); | |
} else { | |
mixin(config[prop], value, true); | |
} | |
} else { | |
config[prop] = value; | |
} | |
}); | |
//Merge shim | |
if (cfg.shim) { | |
eachProp(cfg.shim, function (value, id) { | |
//Normalize the structure | |
if (isArray(value)) { | |
value = { | |
deps: value | |
}; | |
} | |
if ((value.exports || value.init) && !value.exportsFn) { | |
value.exportsFn = context.makeShimExports(value); | |
} | |
shim[id] = value; | |
}); | |
config.shim = shim; | |
} | |
//Adjust packages if necessary. | |
if (cfg.packages) { | |
each(cfg.packages, function (pkgObj) { | |
var location; | |
pkgObj = typeof pkgObj === 'string' ? { name: pkgObj } : pkgObj; | |
location = pkgObj.location; | |
//Create a brand new object on pkgs, since currentPackages can | |
//be passed in again, and config.pkgs is the internal transformed | |
//state for all package configs. | |
pkgs[pkgObj.name] = { | |
name: pkgObj.name, | |
location: location || pkgObj.name, | |
//Remove leading dot in main, so main paths are normalized, | |
//and remove any trailing .js, since different package | |
//envs have different conventions: some use a module name, | |
//some use a file name. | |
main: (pkgObj.main || 'main') | |
.replace(currDirRegExp, '') | |
.replace(jsSuffixRegExp, '') | |
}; | |
}); | |
//Done with modifications, assing packages back to context config | |
config.pkgs = pkgs; | |
} | |
//If there are any "waiting to execute" modules in the registry, | |
//update the maps for them, since their info, like URLs to load, | |
//may have changed. | |
eachProp(registry, function (mod, id) { | |
//If module already has init called, since it is too | |
//late to modify them, and ignore unnormalized ones | |
//since they are transient. | |
if (!mod.inited && !mod.map.unnormalized) { | |
mod.map = makeModuleMap(id); | |
} | |
}); | |
//If a deps array or a config callback is specified, then call | |
//require with those args. This is useful when require is defined as a | |
//config object before require.js is loaded. | |
if (cfg.deps || cfg.callback) { | |
context.require(cfg.deps || [], cfg.callback); | |
} | |
}, | |
makeShimExports: function (value) { | |
function fn() { | |
var ret; | |
if (value.init) { | |
ret = value.init.apply(global, arguments); | |
} | |
return ret || (value.exports && getGlobal(value.exports)); | |
} | |
return fn; | |
}, | |
makeRequire: function (relMap, options) { | |
options = options || {}; | |
function localRequire(deps, callback, errback) { | |
var id, map, requireMod; | |
if (options.enableBuildCallback && callback && isFunction(callback)) { | |
callback.__requireJsBuild = true; | |
} | |
if (typeof deps === 'string') { | |
if (isFunction(callback)) { | |
//Invalid call | |
return onError(makeError('requireargs', 'Invalid require call'), errback); | |
} | |
//If require|exports|module are requested, get the | |
//value for them from the special handlers. Caveat: | |
//this only works while module is being defined. | |
if (relMap && hasProp(handlers, deps)) { | |
return handlers[deps](registry[relMap.id]); | |
} | |
//Synchronous access to one module. If require.get is | |
//available (as in the Node adapter), prefer that. | |
if (req.get) { | |
return req.get(context, deps, relMap, localRequire); | |
} | |
//Normalize module name, if it contains . or .. | |
map = makeModuleMap(deps, relMap, false, true); | |
id = map.id; | |
if (!hasProp(defined, id)) { | |
return onError(makeError('notloaded', 'Module name "' + | |
id + | |
'" has not been loaded yet for context: ' + | |
contextName + | |
(relMap ? '' : '. Use require([])'))); | |
} | |
return defined[id]; | |
} | |
//Grab defines waiting in the global queue. | |
intakeDefines(); | |
//Mark all the dependencies as needing to be loaded. | |
context.nextTick(function () { | |
//Some defines could have been added since the | |
//require call, collect them. | |
intakeDefines(); | |
requireMod = getModule(makeModuleMap(null, relMap)); | |
//Store if map config should be applied to this require | |
//call for dependencies. | |
requireMod.skipMap = options.skipMap; | |
requireMod.init(deps, callback, errback, { | |
enabled: true | |
}); | |
checkLoaded(); | |
}); | |
return localRequire; | |
} | |
mixin(localRequire, { | |
isBrowser: isBrowser, | |
/** | |
* Converts a module name + .extension into an URL path. | |
* *Requires* the use of a module name. It does not support using | |
* plain URLs like nameToUrl. | |
*/ | |
toUrl: function (moduleNamePlusExt) { | |
var ext, | |
index = moduleNamePlusExt.lastIndexOf('.'), | |
segment = moduleNamePlusExt.split('/')[0], | |
isRelative = segment === '.' || segment === '..'; | |
//Have a file extension alias, and it is not the | |
//dots from a relative path. | |
if (index !== -1 && (!isRelative || index > 1)) { | |
ext = moduleNamePlusExt.substring(index, moduleNamePlusExt.length); | |
moduleNamePlusExt = moduleNamePlusExt.substring(0, index); | |
} | |
return context.nameToUrl(normalize(moduleNamePlusExt, | |
relMap && relMap.id, true), ext, true); | |
}, | |
defined: function (id) { | |
return hasProp(defined, makeModuleMap(id, relMap, false, true).id); | |
}, | |
specified: function (id) { | |
id = makeModuleMap(id, relMap, false, true).id; | |
return hasProp(defined, id) || hasProp(registry, id); | |
} | |
}); | |
//Only allow undef on top level require calls | |
if (!relMap) { | |
localRequire.undef = function (id) { | |
//Bind any waiting define() calls to this context, | |
//fix for #408 | |
takeGlobalQueue(); | |
var map = makeModuleMap(id, relMap, true), | |
mod = getOwn(registry, id); | |
delete defined[id]; | |
delete urlFetched[map.url]; | |
delete undefEvents[id]; | |
if (mod) { | |
//Hold on to listeners in case the | |
//module will be attempted to be reloaded | |
//using a different config. | |
if (mod.events.defined) { | |
undefEvents[id] = mod.events; | |
} | |
cleanRegistry(id); | |
} | |
}; | |
} | |
return localRequire; | |
}, | |
/** | |
* Called to enable a module if it is still in the registry | |
* awaiting enablement. A second arg, parent, the parent module, | |
* is passed in for context, when this method is overriden by | |
* the optimizer. Not shown here to keep code compact. | |
*/ | |
enable: function (depMap) { | |
var mod = getOwn(registry, depMap.id); | |
if (mod) { | |
getModule(depMap).enable(); | |
} | |
}, | |
/** | |
* Internal method used by environment adapters to complete a load event. | |
* A load event could be a script load or just a load pass from a synchronous | |
* load call. | |
* @param {String} moduleName the name of the module to potentially complete. | |
*/ | |
completeLoad: function (moduleName) { | |
var found, args, mod, | |
shim = getOwn(config.shim, moduleName) || {}, | |
shExports = shim.exports; | |
takeGlobalQueue(); | |
while (defQueue.length) { | |
args = defQueue.shift(); | |
if (args[0] === null) { | |
args[0] = moduleName; | |
//If already found an anonymous module and bound it | |
//to this name, then this is some other anon module | |
//waiting for its completeLoad to fire. | |
if (found) { | |
break; | |
} | |
found = true; | |
} else if (args[0] === moduleName) { | |
//Found matching define call for this script! | |
found = true; | |
} | |
callGetModule(args); | |
} | |
//Do this after the cycle of callGetModule in case the result | |
//of those calls/init calls changes the registry. | |
mod = getOwn(registry, moduleName); | |
if (!found && !hasProp(defined, moduleName) && mod && !mod.inited) { | |
if (config.enforceDefine && (!shExports || !getGlobal(shExports))) { | |
if (hasPathFallback(moduleName)) { | |
return; | |
} else { | |
return onError(makeError('nodefine', | |
'No define call for ' + moduleName, | |
null, | |
[moduleName])); | |
} | |
} else { | |
//A script that does not call define(), so just simulate | |
//the call for it. | |
callGetModule([moduleName, (shim.deps || []), shim.exportsFn]); | |
} | |
} | |
checkLoaded(); | |
}, | |
/** | |
* Converts a module name to a file path. Supports cases where | |
* moduleName may actually be just an URL. | |
* Note that it **does not** call normalize on the moduleName, | |
* it is assumed to have already been normalized. This is an | |
* internal API, not a public one. Use toUrl for the public API. | |
*/ | |
nameToUrl: function (moduleName, ext, skipExt) { | |
var paths, pkgs, pkg, pkgPath, syms, i, parentModule, url, | |
parentPath; | |
//If a colon is in the URL, it indicates a protocol is used and it is just | |
//an URL to a file, or if it starts with a slash, contains a query arg (i.e. ?) | |
//or ends with .js, then assume the user meant to use an url and not a module id. | |
//The slash is important for protocol-less URLs as well as full paths. | |
if (req.jsExtRegExp.test(moduleName)) { | |
//Just a plain path, not module name lookup, so just return it. | |
//Add extension if it is included. This is a bit wonky, only non-.js things pass | |
//an extension, this method probably needs to be reworked. | |
url = moduleName + (ext || ''); | |
} else { | |
//A module that needs to be converted to a path. | |
paths = config.paths; | |
pkgs = config.pkgs; | |
syms = moduleName.split('/'); | |
//For each module name segment, see if there is a path | |
//registered for it. Start with most specific name | |
//and work up from it. | |
for (i = syms.length; i > 0; i -= 1) { | |
parentModule = syms.slice(0, i).join('/'); | |
pkg = getOwn(pkgs, parentModule); | |
parentPath = getOwn(paths, parentModule); | |
if (parentPath) { | |
//If an array, it means there are a few choices, | |
//Choose the one that is desired | |
if (isArray(parentPath)) { | |
parentPath = parentPath[0]; | |
} | |
syms.splice(0, i, parentPath); | |
break; | |
} else if (pkg) { | |
//If module name is just the package name, then looking | |
//for the main module. | |
if (moduleName === pkg.name) { | |
pkgPath = pkg.location + '/' + pkg.main; | |
} else { | |
pkgPath = pkg.location; | |
} | |
syms.splice(0, i, pkgPath); | |
break; | |
} | |
} | |
//Join the path parts together, then figure out if baseUrl is needed. | |
url = syms.join('/'); | |
url += (ext || (/\?/.test(url) || skipExt ? '' : '.js')); | |
url = (url.charAt(0) === '/' || url.match(/^[\w\+\.\-]+:/) ? '' : config.baseUrl) + url; | |
} | |
return config.urlArgs ? url + | |
((url.indexOf('?') === -1 ? '?' : '&') + | |
config.urlArgs) : url; | |
}, | |
//Delegates to req.load. Broken out as a separate function to | |
//allow overriding in the optimizer. | |
load: function (id, url) { | |
req.load(context, id, url); | |
}, | |
/** | |
* Executes a module callack function. Broken out as a separate function | |
* solely to allow the build system to sequence the files in the built | |
* layer in the right sequence. | |
* | |
* @private | |
*/ | |
execCb: function (name, callback, args, exports) { | |
return callback.apply(exports, args); | |
}, | |
/** | |
* callback for script loads, used to check status of loading. | |
* | |
* @param {Event} evt the event from the browser for the script | |
* that was loaded. | |
*/ | |
onScriptLoad: function (evt) { | |
//Using currentTarget instead of target for Firefox 2.0's sake. Not | |
//all old browsers will be supported, but this one was easy enough | |
//to support and still makes sense. | |
if (evt.type === 'load' || | |
(readyRegExp.test((evt.currentTarget || evt.srcElement).readyState))) { | |
//Reset interactive script so a script node is not held onto for | |
//to long. | |
interactiveScript = null; | |
//Pull out the name of the module and the context. | |
var data = getScriptData(evt); | |
context.completeLoad(data.id); | |
} | |
}, | |
/** | |
* Callback for script errors. | |
*/ | |
onScriptError: function (evt) { | |
var data = getScriptData(evt); | |
if (!hasPathFallback(data.id)) { | |
return onError(makeError('scripterror', 'Script error', evt, [data.id])); | |
} | |
} | |
}; | |
context.require = context.makeRequire(); | |
return context; | |
} | |
/** | |
* Main entry point. | |
* | |
* If the only argument to require is a string, then the module that | |
* is represented by that string is fetched for the appropriate context. | |
* | |
* If the first argument is an array, then it will be treated as an array | |
* of dependency string names to fetch. An optional function callback can | |
* be specified to execute when all of those dependencies are available. | |
* | |
* Make a local req variable to help Caja compliance (it assumes things | |
* on a require that are not standardized), and to give a short | |
* name for minification/local scope use. | |
*/ | |
req = requirejs = function (deps, callback, errback, optional) { | |
//Find the right context, use default | |
var context, config, | |
contextName = defContextName; | |
// Determine if have config object in the call. | |
if (!isArray(deps) && typeof deps !== 'string') { | |
// deps is a config object | |
config = deps; | |
if (isArray(callback)) { | |
// Adjust args if there are dependencies | |
deps = callback; | |
callback = errback; | |
errback = optional; | |
} else { | |
deps = []; | |
} | |
} | |
if (config && config.context) { | |
contextName = config.context; | |
} | |
context = getOwn(contexts, contextName); | |
if (!context) { | |
context = contexts[contextName] = req.s.newContext(contextName); | |
} | |
if (config) { | |
context.configure(config); | |
} | |
return context.require(deps, callback, errback); | |
}; | |
/** | |
* Support require.config() to make it easier to cooperate with other | |
* AMD loaders on globally agreed names. | |
*/ | |
req.config = function (config) { | |
return req(config); | |
}; | |
/** | |
* Execute something after the current tick | |
* of the event loop. Override for other envs | |
* that have a better solution than setTimeout. | |
* @param {Function} fn function to execute later. | |
*/ | |
req.nextTick = typeof setTimeout !== 'undefined' ? function (fn) { | |
setTimeout(fn, 4); | |
} : function (fn) { fn(); }; | |
/** | |
* Export require as a global, but only if it does not already exist. | |
*/ | |
if (!require) { | |
require = req; | |
} | |
req.version = version; | |
//Used to filter out dependencies that are already paths. | |
req.jsExtRegExp = /^\/|:|\?|\.js$/; | |
req.isBrowser = isBrowser; | |
s = req.s = { | |
contexts: contexts, | |
newContext: newContext | |
}; | |
//Create default context. | |
req({}); | |
//Exports some context-sensitive methods on global require. | |
each([ | |
'toUrl', | |
'undef', | |
'defined', | |
'specified' | |
], function (prop) { | |
//Reference from contexts instead of early binding to default context, | |
//so that during builds, the latest instance of the default context | |
//with its config gets used. | |
req[prop] = function () { | |
var ctx = contexts[defContextName]; | |
return ctx.require[prop].apply(ctx, arguments); | |
}; | |
}); | |
if (isBrowser) { | |
head = s.head = document.getElementsByTagName('head')[0]; | |
//If BASE tag is in play, using appendChild is a problem for IE6. | |
//When that browser dies, this can be removed. Details in this jQuery bug: | |
//http://dev.jquery.com/ticket/2709 | |
baseElement = document.getElementsByTagName('base')[0]; | |
if (baseElement) { | |
head = s.head = baseElement.parentNode; | |
} | |
} | |
/** | |
* Any errors that require explicitly generates will be passed to this | |
* function. Intercept/override it if you want custom error handling. | |
* @param {Error} err the error object. | |
*/ | |
req.onError = function (err) { | |
throw err; | |
}; | |
/** | |
* Does the request to load a module for the browser case. | |
* Make this a separate function to allow other environments | |
* to override it. | |
* | |
* @param {Object} context the require context to find state. | |
* @param {String} moduleName the name of the module. | |
* @param {Object} url the URL to the module. | |
*/ | |
req.load = function (context, moduleName, url) { | |
var config = (context && context.config) || {}, | |
node; | |
if (isBrowser) { | |
//In the browser so use a script tag | |
node = config.xhtml ? | |
document.createElementNS('http://www.w3.org/1999/xhtml', 'html:script') : | |
document.createElement('script'); | |
node.type = config.scriptType || 'text/javascript'; | |
node.charset = 'utf-8'; | |
node.async = true; | |
node.setAttribute('data-requirecontext', context.contextName); | |
node.setAttribute('data-requiremodule', moduleName); | |
//Set up load listener. Test attachEvent first because IE9 has | |
//a subtle issue in its addEventListener and script onload firings | |
//that do not match the behavior of all other browsers with | |
//addEventListener support, which fire the onload event for a | |
//script right after the script execution. See: | |
//https://connect.microsoft.com/IE/feedback/details/648057/script-onload-event-is-not-fired-immediately-after-script-execution | |
//UNFORTUNATELY Opera implements attachEvent but does not follow the script | |
//script execution mode. | |
if (node.attachEvent && | |
//Check if node.attachEvent is artificially added by custom script or | |
//natively supported by browser | |
//read https://github.com/jrburke/requirejs/issues/187 | |
//if we can NOT find [native code] then it must NOT natively supported. | |
//in IE8, node.attachEvent does not have toString() | |
//Note the test for "[native code" with no closing brace, see: | |
//https://github.com/jrburke/requirejs/issues/273 | |
!(node.attachEvent.toString && node.attachEvent.toString().indexOf('[native code') < 0) && | |
!isOpera) { | |
//Probably IE. IE (at least 6-8) do not fire | |
//script onload right after executing the script, so | |
//we cannot tie the anonymous define call to a name. | |
//However, IE reports the script as being in 'interactive' | |
//readyState at the time of the define call. | |
useInteractive = true; | |
node.attachEvent('onreadystatechange', context.onScriptLoad); | |
//It would be great to add an error handler here to catch | |
//404s in IE9+. However, onreadystatechange will fire before | |
//the error handler, so that does not help. If addEventListener | |
//is used, then IE will fire error before load, but we cannot | |
//use that pathway given the connect.microsoft.com issue | |
//mentioned above about not doing the 'script execute, | |
//then fire the script load event listener before execute | |
//next script' that other browsers do. | |
//Best hope: IE10 fixes the issues, | |
//and then destroys all installs of IE 6-9. | |
//node.attachEvent('onerror', context.onScriptError); | |
} else { | |
node.addEventListener('load', context.onScriptLoad, false); | |
node.addEventListener('error', context.onScriptError, false); | |
} | |
node.src = url; | |
//For some cache cases in IE 6-8, the script executes before the end | |
//of the appendChild execution, so to tie an anonymous define | |
//call to the module name (which is stored on the node), hold on | |
//to a reference to this node, but clear after the DOM insertion. | |
currentlyAddingScript = node; | |
if (baseElement) { | |
head.insertBefore(node, baseElement); | |
} else { | |
head.appendChild(node); | |
} | |
currentlyAddingScript = null; | |
return node; | |
} else if (isWebWorker) { | |
try { | |
//In a web worker, use importScripts. This is not a very | |
//efficient use of importScripts, importScripts will block until | |
//its script is downloaded and evaluated. However, if web workers | |
//are in play, the expectation that a build has been done so that | |
//only one script needs to be loaded anyway. This may need to be | |
//reevaluated if other use cases become common. | |
importScripts(url); | |
//Account for anonymous modules | |
context.completeLoad(moduleName); | |
} catch (e) { | |
context.onError(makeError('importscripts', | |
'importScripts failed for ' + | |
moduleName + ' at ' + url, | |
e, | |
[moduleName])); | |
} | |
} | |
}; | |
function getInteractiveScript() { | |
if (interactiveScript && interactiveScript.readyState === 'interactive') { | |
return interactiveScript; | |
} | |
eachReverse(scripts(), function (script) { | |
if (script.readyState === 'interactive') { | |
return (interactiveScript = script); | |
} | |
}); | |
return interactiveScript; | |
} | |
//Look for a data-main script attribute, which could also adjust the baseUrl. | |
if (isBrowser) { | |
//Figure out baseUrl. Get it from the script tag with require.js in it. | |
eachReverse(scripts(), function (script) { | |
//Set the 'head' where we can append children by | |
//using the script's parent. | |
if (!head) { | |
head = script.parentNode; | |
} | |
//Look for a data-main attribute to set main script for the page | |
//to load. If it is there, the path to data main becomes the | |
//baseUrl, if it is not already set. | |
dataMain = script.getAttribute('data-main'); | |
if (dataMain) { | |
//Set final baseUrl if there is not already an explicit one. | |
if (!cfg.baseUrl) { | |
//Pull off the directory of data-main for use as the | |
//baseUrl. | |
src = dataMain.split('/'); | |
mainScript = src.pop(); | |
subPath = src.length ? src.join('/') + '/' : './'; | |
cfg.baseUrl = subPath; | |
dataMain = mainScript; | |
} | |
//Strip off any trailing .js since dataMain is now | |
//like a module name. | |
dataMain = dataMain.replace(jsSuffixRegExp, ''); | |
//Put the data-main script in the files to load. | |
cfg.deps = cfg.deps ? cfg.deps.concat(dataMain) : [dataMain]; | |
return true; | |
} | |
}); | |
} | |
/** | |
* The function that handles definitions of modules. Differs from | |
* require() in that a string for the module should be the first argument, | |
* and the function to execute after dependencies are loaded should | |
* return a value to define the module corresponding to the first argument's | |
* name. | |
*/ | |
define = function (name, deps, callback) { | |
var node, context; | |
//Allow for anonymous modules | |
if (typeof name !== 'string') { | |
//Adjust args appropriately | |
callback = deps; | |
deps = name; | |
name = null; | |
} | |
//This module may not have dependencies | |
if (!isArray(deps)) { | |
callback = deps; | |
deps = []; | |
} | |
//If no name, and callback is a function, then figure out if it a | |
//CommonJS thing with dependencies. | |
if (!deps.length && isFunction(callback)) { | |
//Remove comments from the callback string, | |
//look for require calls, and pull them into the dependencies, | |
//but only if there are function args. | |
if (callback.length) { | |
callback | |
.toString() | |
.replace(commentRegExp, '') | |
.replace(cjsRequireRegExp, function (match, dep) { | |
deps.push(dep); | |
}); | |
//May be a CommonJS thing even without require calls, but still | |
//could use exports, and module. Avoid doing exports and module | |
//work though if it just needs require. | |
//REQUIRES the function to expect the CommonJS variables in the | |
//order listed below. | |
deps = (callback.length === 1 ? ['require'] : ['require', 'exports', 'module']).concat(deps); | |
} | |
} | |
//If in IE 6-8 and hit an anonymous define() call, do the interactive | |
//work. | |
if (useInteractive) { | |
node = currentlyAddingScript || getInteractiveScript(); | |
if (node) { | |
if (!name) { | |
name = node.getAttribute('data-requiremodule'); | |
} | |
context = contexts[node.getAttribute('data-requirecontext')]; | |
} | |
} | |
//Always save off evaluating the def call until the script onload handler. | |
//This allows multiple modules to be in a file without prematurely | |
//tracing dependencies, and allows for anonymous module support, | |
//where the module name is not known until the script onload event | |
//occurs. If no context, use the global queue, and get it processed | |
//in the onscript load callback. | |
(context ? context.defQueue : globalDefQueue).push([name, deps, callback]); | |
}; | |
define.amd = { | |
jQuery: true | |
}; | |
/** | |
* Executes the text. Normally just uses eval, but can be modified | |
* to use a better, environment-specific call. Only used for transpiling | |
* loader plugins, not for plain JS modules. | |
* @param {String} text the text to execute/evaluate. | |
*/ | |
req.exec = function (text) { | |
/*jslint evil: true */ | |
return eval(text); | |
}; | |
//Set up with config info. | |
req(cfg); | |
}(this)); |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
/** | |
* Created by matt on 10/10/13. | |
*/ | |
define(["Person"], function(Person){ | |
var person = new Person(); | |
person.set("house", { | |
windows:4 | |
}); | |
alert(person.get("house")) | |
}) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
/** | |
* Created by matt on 10/10/13. | |
*/ | |
define([ | |
"backbone.associations", | |
"House" | |
], function(Associations, House){ | |
var Person = Backbone.AssociatedModel.extend({ | |
relations:[{ | |
key:"house", | |
type:Backbone.One, | |
relatedModel: function(){ return House;} | |
}] | |
}); | |
return Person; | |
}) |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment