+++ /dev/null
-// Knockout Mapping plugin v2.0.3
-// (c) 2011 Steven Sanderson, Roy Jacobs - http://knockoutjs.com/
-// License: Ms-Pl (http://www.opensource.org/licenses/ms-pl.html)
-
-// Google Closure Compiler helpers (used only to make the minified file smaller)
-ko.exportSymbol = function (publicPath, object) {
- var tokens = publicPath.split(".");
- var target = window;
- for (var i = 0; i < tokens.length - 1; i++)
- target = target[tokens[i]];
- target[tokens[tokens.length - 1]] = object;
-};
-ko.exportProperty = function (owner, publicName, object) {
- owner[publicName] = object;
-};
-
-(function () {
- ko.mapping = {};
-
- var mappingProperty = "__ko_mapping__";
- var realKoDependentObservable = ko.dependentObservable;
- var mappingNesting = 0;
- var dependentObservables;
- var visitedObjects;
-
- var _defaultOptions = {
- include: ["_destroy"],
- ignore: [],
- copy: []
- };
- var defaultOptions = _defaultOptions;
-
- function extendObject(destination, source) {
- for (var key in source) {
- if (source.hasOwnProperty(key) && source[key]) {
- if (key && destination[key] && !(destination[key] instanceof Array)) {
- extendObject(destination[key], source[key]);
- } else {
- destination[key] = source[key];
- }
- }
- }
- }
-
- function merge(obj1, obj2) {
- var merged = {};
- extendObject(merged, obj1);
- extendObject(merged, obj2);
-
- return merged;
- }
-
- ko.mapping.isMapped = function (viewModel) {
- var unwrapped = ko.utils.unwrapObservable(viewModel);
- return unwrapped && unwrapped[mappingProperty];
- }
-
- ko.mapping.fromJS = function (jsObject /*, inputOptions, target*/ ) {
- if (arguments.length == 0) throw new Error("When calling ko.fromJS, pass the object you want to convert.");
-
- // When mapping is completed, even with an exception, reset the nesting level
- window.setTimeout(function () {
- mappingNesting = 0;
- }, 0);
-
- if (!mappingNesting++) {
- dependentObservables = [];
- visitedObjects = new objectLookup();
- }
-
- var options;
- var target;
-
- if (arguments.length == 2) {
- if (arguments[1][mappingProperty]) {
- target = arguments[1];
- } else {
- options = arguments[1];
- }
- }
- if (arguments.length == 3) {
- options = arguments[1];
- target = arguments[2];
- }
-
- if (target) {
- options = merge(options, target[mappingProperty]);
- }
- options = fillOptions(options);
-
- var result = updateViewModel(target, jsObject, options);
- if (target) {
- result = target;
- }
-
- // Evaluate any dependent observables that were proxied.
- // Do this in a timeout to defer execution. Basically, any user code that explicitly looks up the DO will perform the first evaluation. Otherwise,
- // it will be done by this code.
- if (!--mappingNesting) {
- window.setTimeout(function () {
- ko.utils.arrayForEach(dependentObservables, function (DO) {
- if (DO) DO();
- });
- }, 0);
- }
-
- // Save any new mapping options in the view model, so that updateFromJS can use them later.
- result[mappingProperty] = merge(result[mappingProperty], options);
-
- return result;
- };
-
- ko.mapping.fromJSON = function (jsonString /*, options, target*/ ) {
- var parsed = ko.utils.parseJson(jsonString);
- arguments[0] = parsed;
- return ko.mapping.fromJS.apply(this, arguments);
- };
-
- ko.mapping.updateFromJS = function (viewModel) {
- throw new Error("ko.mapping.updateFromJS, use ko.mapping.fromJS instead. Please note that the order of parameters is different!");
- };
-
- ko.mapping.updateFromJSON = function (viewModel) {
- throw new Error("ko.mapping.updateFromJSON, use ko.mapping.fromJSON instead. Please note that the order of parameters is different!");
- };
-
- ko.mapping.toJS = function (rootObject, options) {
- if (!defaultOptions) ko.mapping.resetDefaultOptions();
-
- if (arguments.length == 0) throw new Error("When calling ko.mapping.toJS, pass the object you want to convert.");
- if (!(defaultOptions.ignore instanceof Array)) throw new Error("ko.mapping.defaultOptions().ignore should be an array.");
- if (!(defaultOptions.include instanceof Array)) throw new Error("ko.mapping.defaultOptions().include should be an array.");
- if (!(defaultOptions.copy instanceof Array)) throw new Error("ko.mapping.defaultOptions().copy should be an array.");
-
- // Merge in the options used in fromJS
- options = fillOptions(options, rootObject[mappingProperty]);
-
- // We just unwrap everything at every level in the object graph
- return ko.mapping.visitModel(rootObject, function (x) {
- return ko.utils.unwrapObservable(x)
- }, options);
- };
-
- ko.mapping.toJSON = function (rootObject, options) {
- var plainJavaScriptObject = ko.mapping.toJS(rootObject, options);
- return ko.utils.stringifyJson(plainJavaScriptObject);
- };
-
- ko.mapping.defaultOptions = function () {
- if (arguments.length > 0) {
- defaultOptions = arguments[0];
- } else {
- return defaultOptions;
- }
- };
-
- ko.mapping.resetDefaultOptions = function () {
- defaultOptions = {
- include: _defaultOptions.include.slice(0),
- ignore: _defaultOptions.ignore.slice(0),
- copy: _defaultOptions.copy.slice(0)
- };
- };
-
- function getType(x) {
- if ((x) && (typeof (x) === "object") && (x.constructor == (new Date).constructor)) return "date";
- return typeof x;
- }
-
- function fillOptions(options, otherOptions) {
- options = options || {};
-
- // Is there only a root-level mapping present?
- if ((options.create instanceof Function) || (options.update instanceof Function) || (options.key instanceof Function) || (options.arrayChanged instanceof Function)) {
- options = {
- "": options
- };
- }
-
- if (otherOptions) {
- options.ignore = mergeArrays(otherOptions.ignore, options.ignore);
- options.include = mergeArrays(otherOptions.include, options.include);
- options.copy = mergeArrays(otherOptions.copy, options.copy);
- }
- options.ignore = mergeArrays(options.ignore, defaultOptions.ignore);
- options.include = mergeArrays(options.include, defaultOptions.include);
- options.copy = mergeArrays(options.copy, defaultOptions.copy);
-
- options.mappedProperties = options.mappedProperties || {};
- return options;
- }
-
- function mergeArrays(a, b) {
- if (!(a instanceof Array)) {
- if (getType(a) === "undefined") a = [];
- else a = [a];
- }
- if (!(b instanceof Array)) {
- if (getType(b) === "undefined") b = [];
- else b = [b];
- }
- return a.concat(b);
- }
-
- // When using a 'create' callback, we proxy the dependent observable so that it doesn't immediately evaluate on creation.
- // The reason is that the dependent observables in the user-specified callback may contain references to properties that have not been mapped yet.
- function withProxyDependentObservable(dependentObservables, callback) {
- var localDO = ko.dependentObservable;
- ko.dependentObservable = function (read, owner, options) {
- options = options || {};
-
- var realDeferEvaluation = options.deferEvaluation;
-
- if (read && typeof read == "object") { // mirrors condition in knockout implementation of DO's
- options = read;
- }
-
- var isRemoved = false;
-
- // We wrap the original dependent observable so that we can remove it from the 'dependentObservables' list we need to evaluate after mapping has
- // completed if the user already evaluated the DO themselves in the meantime.
- var wrap = function (DO) {
- var wrapped = realKoDependentObservable({
- read: function () {
- if (!isRemoved) {
- ko.utils.arrayRemoveItem(dependentObservables, DO);
- isRemoved = true;
- }
- return DO.apply(DO, arguments);
- },
- write: function (val) {
- return DO(val);
- },
- deferEvaluation: true
- });
- wrapped.__ko_proto__ = realKoDependentObservable;
- return wrapped;
- };
-
- options.deferEvaluation = true; // will either set for just options, or both read/options.
- var realDependentObservable = new realKoDependentObservable(read, owner, options);
- realDependentObservable.__ko_proto__ = realKoDependentObservable;
-
- if (!realDeferEvaluation) {
- dependentObservables.push(realDependentObservable);
- realDependentObservable = wrap(realDependentObservable);
- }
-
- return realDependentObservable;
- }
- ko.computed = ko.dependentObservable;
- var result = callback();
- ko.dependentObservable = localDO;
- ko.computed = ko.dependentObservable;
- return result;
- }
-
- function updateViewModel(mappedRootObject, rootObject, options, parentName, parent, parentPropertyName) {
- var isArray = ko.utils.unwrapObservable(rootObject) instanceof Array;
-
- parentPropertyName = parentPropertyName || "";
-
- // If this object was already mapped previously, take the options from there and merge them with our existing ones.
- if (ko.mapping.isMapped(mappedRootObject)) {
- var previousMapping = ko.utils.unwrapObservable(mappedRootObject)[mappingProperty];
- options = merge(previousMapping, options);
- }
-
- var callbackParams = {
- data: rootObject,
- parent: parent
- };
-
- var hasCreateCallback = function () {
- return options[parentName] && options[parentName].create instanceof Function;
- };
-
- var createCallback = function (data) {
- return withProxyDependentObservable(dependentObservables, function () {
- return options[parentName].create({
- data: data || callbackParams.data,
- parent: callbackParams.parent
- });
- });
- };
-
- var hasUpdateCallback = function () {
- return options[parentName] && options[parentName].update instanceof Function;
- };
-
- var updateCallback = function (obj, data) {
- var params = {
- data: data || callbackParams.data,
- parent: callbackParams.parent,
- target: ko.utils.unwrapObservable(obj)
- };
-
- if (ko.isWriteableObservable(obj)) {
- params.observable = obj;
- }
-
- return options[parentName].update(params);
- }
-
- var alreadyMapped = visitedObjects.get(rootObject);
- if (alreadyMapped) {
- return alreadyMapped;
- }
-
- parentName = parentName || "";
-
- if (!isArray) {
- // For atomic types, do a direct update on the observable
- if (!canHaveProperties(rootObject)) {
- switch (getType(rootObject)) {
- case "function":
- if (hasUpdateCallback()) {
- if (ko.isWriteableObservable(rootObject)) {
- rootObject(updateCallback(rootObject));
- mappedRootObject = rootObject;
- } else {
- mappedRootObject = updateCallback(rootObject);
- }
- } else {
- mappedRootObject = rootObject;
- }
- break;
- default:
- if (ko.isWriteableObservable(mappedRootObject)) {
- if (hasUpdateCallback()) {
- mappedRootObject(updateCallback(mappedRootObject));
- } else {
- mappedRootObject(ko.utils.unwrapObservable(rootObject));
- }
- } else {
- if (hasCreateCallback()) {
- mappedRootObject = createCallback();
- } else {
- mappedRootObject = ko.observable(ko.utils.unwrapObservable(rootObject));
- }
-
- if (hasUpdateCallback()) {
- mappedRootObject(updateCallback(mappedRootObject));
- }
- }
- break;
- }
-
- } else {
- mappedRootObject = ko.utils.unwrapObservable(mappedRootObject);
- if (!mappedRootObject) {
- if (hasCreateCallback()) {
- var result = createCallback();
-
- if (hasUpdateCallback()) {
- result = updateCallback(result);
- }
-
- return result;
- } else {
- if (hasUpdateCallback()) {
- return updateCallback(result);
- }
-
- mappedRootObject = {};
- }
- }
-
- if (hasUpdateCallback()) {
- mappedRootObject = updateCallback(mappedRootObject);
- }
-
- visitedObjects.save(rootObject, mappedRootObject);
-
- // For non-atomic types, visit all properties and update recursively
- visitPropertiesOrArrayEntries(rootObject, function (indexer) {
- var fullPropertyName = parentPropertyName.length ? parentPropertyName + "." + indexer : indexer;
-
- if (ko.utils.arrayIndexOf(options.ignore, fullPropertyName) != -1) {
- return;
- }
-
- if (ko.utils.arrayIndexOf(options.copy, fullPropertyName) != -1) {
- mappedRootObject[indexer] = rootObject[indexer];
- return;
- }
-
- // In case we are adding an already mapped property, fill it with the previously mapped property value to prevent recursion.
- // If this is a property that was generated by fromJS, we should use the options specified there
- var prevMappedProperty = visitedObjects.get(rootObject[indexer]);
- var value = prevMappedProperty || updateViewModel(mappedRootObject[indexer], rootObject[indexer], options, indexer, mappedRootObject, fullPropertyName);
-
- if (ko.isWriteableObservable(mappedRootObject[indexer])) {
- mappedRootObject[indexer](ko.utils.unwrapObservable(value));
- } else {
- mappedRootObject[indexer] = value;
- }
-
- options.mappedProperties[fullPropertyName] = true;
- });
- }
- } else {
- var changes = [];
-
- var hasKeyCallback = false;
- var keyCallback = function (x) {
- return x;
- }
- if (options[parentName] && options[parentName].key) {
- keyCallback = options[parentName].key;
- hasKeyCallback = true;
- }
-
- if (!ko.isObservable(mappedRootObject)) {
- // When creating the new observable array, also add a bunch of utility functions that take the 'key' of the array items into account.
- mappedRootObject = ko.observableArray([]);
-
- mappedRootObject.mappedRemove = function (valueOrPredicate) {
- var predicate = typeof valueOrPredicate == "function" ? valueOrPredicate : function (value) {
- return value === keyCallback(valueOrPredicate);
- };
- return mappedRootObject.remove(function (item) {
- return predicate(keyCallback(item));
- });
- }
-
- mappedRootObject.mappedRemoveAll = function (arrayOfValues) {
- var arrayOfKeys = filterArrayByKey(arrayOfValues, keyCallback);
- return mappedRootObject.remove(function (item) {
- return ko.utils.arrayIndexOf(arrayOfKeys, keyCallback(item)) != -1;
- });
- }
-
- mappedRootObject.mappedDestroy = function (valueOrPredicate) {
- var predicate = typeof valueOrPredicate == "function" ? valueOrPredicate : function (value) {
- return value === keyCallback(valueOrPredicate);
- };
- return mappedRootObject.destroy(function (item) {
- return predicate(keyCallback(item));
- });
- }
-
- mappedRootObject.mappedDestroyAll = function (arrayOfValues) {
- var arrayOfKeys = filterArrayByKey(arrayOfValues, keyCallback);
- return mappedRootObject.destroy(function (item) {
- return ko.utils.arrayIndexOf(arrayOfKeys, keyCallback(item)) != -1;
- });
- }
-
- mappedRootObject.mappedIndexOf = function (item) {
- var keys = filterArrayByKey(mappedRootObject(), keyCallback);
- var key = keyCallback(item);
- return ko.utils.arrayIndexOf(keys, key);
- }
-
- mappedRootObject.mappedCreate = function (value) {
- if (mappedRootObject.mappedIndexOf(value) !== -1) {
- throw new Error("There already is an object with the key that you specified.");
- }
-
- var item = hasCreateCallback() ? createCallback(value) : value;
- if (hasUpdateCallback()) {
- var newValue = updateCallback(item, value);
- if (ko.isWriteableObservable(item)) {
- item(newValue);
- } else {
- item = newValue;
- }
- }
- mappedRootObject.push(item);
- return item;
- }
- }
-
- var currentArrayKeys = filterArrayByKey(ko.utils.unwrapObservable(mappedRootObject), keyCallback).sort();
- var newArrayKeys = filterArrayByKey(rootObject, keyCallback);
- if (hasKeyCallback) newArrayKeys.sort();
- var editScript = ko.utils.compareArrays(currentArrayKeys, newArrayKeys);
-
- var ignoreIndexOf = {};
-
- var newContents = [];
- for (var i = 0, j = editScript.length; i < j; i++) {
- var key = editScript[i];
- var mappedItem;
- var fullPropertyName = parentPropertyName + "[" + i + "]";
- switch (key.status) {
- case "added":
- var item = getItemByKey(ko.utils.unwrapObservable(rootObject), key.value, keyCallback);
- mappedItem = ko.utils.unwrapObservable(updateViewModel(undefined, item, options, parentName, mappedRootObject, fullPropertyName));
-
- var index = ignorableIndexOf(ko.utils.unwrapObservable(rootObject), item, ignoreIndexOf);
- newContents[index] = mappedItem;
- ignoreIndexOf[index] = true;
- break;
- case "retained":
- var item = getItemByKey(ko.utils.unwrapObservable(rootObject), key.value, keyCallback);
- mappedItem = getItemByKey(mappedRootObject, key.value, keyCallback);
- updateViewModel(mappedItem, item, options, parentName, mappedRootObject, fullPropertyName);
-
- var index = ignorableIndexOf(ko.utils.unwrapObservable(rootObject), item, ignoreIndexOf);
- newContents[index] = mappedItem;
- ignoreIndexOf[index] = true;
- break;
- case "deleted":
- mappedItem = getItemByKey(mappedRootObject, key.value, keyCallback);
- break;
- }
-
- changes.push({
- event: key.status,
- item: mappedItem
- });
- }
-
- mappedRootObject(newContents);
-
- if (options[parentName] && options[parentName].arrayChanged) {
- ko.utils.arrayForEach(changes, function (change) {
- options[parentName].arrayChanged(change.event, change.item);
- });
- }
- }
-
- return mappedRootObject;
- }
-
- function ignorableIndexOf(array, item, ignoreIndices) {
- for (var i = 0, j = array.length; i < j; i++) {
- if (ignoreIndices[i] === true) continue;
- if (array[i] === item) return i;
- }
- return null;
- }
-
- function mapKey(item, callback) {
- var mappedItem;
- if (callback) mappedItem = callback(item);
- if (getType(mappedItem) === "undefined") mappedItem = item;
-
- return ko.utils.unwrapObservable(mappedItem);
- }
-
- function getItemByKey(array, key, callback) {
- var filtered = ko.utils.arrayFilter(ko.utils.unwrapObservable(array), function (item) {
- return mapKey(item, callback) === key;
- });
-
- if (filtered.length == 0) throw new Error("When calling ko.update*, the key '" + key + "' was not found!");
- if ((filtered.length > 1) && (canHaveProperties(filtered[0]))) throw new Error("When calling ko.update*, the key '" + key + "' was not unique!");
-
- return filtered[0];
- }
-
- function filterArrayByKey(array, callback) {
- return ko.utils.arrayMap(ko.utils.unwrapObservable(array), function (item) {
- if (callback) {
- return mapKey(item, callback);
- } else {
- return item;
- }
- });
- }
-
- function visitPropertiesOrArrayEntries(rootObject, visitorCallback) {
- if (rootObject instanceof Array) {
- for (var i = 0; i < rootObject.length; i++)
- visitorCallback(i);
- } else {
- for (var propertyName in rootObject)
- visitorCallback(propertyName);
- }
- };
-
- function canHaveProperties(object) {
- var type = getType(object);
- return (type === "object") && (object !== null) && (type !== "undefined");
- }
-
- // Based on the parentName, this creates a fully classified name of a property
-
- function getPropertyName(parentName, parent, indexer) {
- var propertyName = parentName || "";
- if (parent instanceof Array) {
- if (parentName) {
- propertyName += "[" + indexer + "]";
- }
- } else {
- if (parentName) {
- propertyName += ".";
- }
- propertyName += indexer;
- }
- return propertyName;
- }
-
- ko.mapping.visitModel = function (rootObject, callback, options) {
- options = options || {};
- options.visitedObjects = options.visitedObjects || new objectLookup();
-
- if (!options.parentName) {
- options = fillOptions(options);
- }
-
- var mappedRootObject;
- var unwrappedRootObject = ko.utils.unwrapObservable(rootObject);
- if (!canHaveProperties(unwrappedRootObject)) {
- return callback(rootObject, options.parentName);
- } else {
- // Only do a callback, but ignore the results
- callback(rootObject, options.parentName);
- mappedRootObject = unwrappedRootObject instanceof Array ? [] : {};
- }
-
- options.visitedObjects.save(rootObject, mappedRootObject);
-
- var parentName = options.parentName;
- visitPropertiesOrArrayEntries(unwrappedRootObject, function (indexer) {
- if (options.ignore && ko.utils.arrayIndexOf(options.ignore, indexer) != -1) return;
-
- var propertyValue = unwrappedRootObject[indexer];
- options.parentName = getPropertyName(parentName, unwrappedRootObject, indexer);
-
- // If we don't want to explicitly copy the unmapped property...
- if (ko.utils.arrayIndexOf(options.copy, indexer) === -1) {
- // ...find out if it's a property we want to explicitly include
- if (ko.utils.arrayIndexOf(options.include, indexer) === -1) {
- // The mapped properties object contains all the properties that were part of the original object.
- // If a property does not exist, and it is not because it is part of an array (e.g. "myProp[3]"), then it should not be unmapped.
- if (unwrappedRootObject[mappingProperty] && unwrappedRootObject[mappingProperty].mappedProperties && !unwrappedRootObject[mappingProperty].mappedProperties[indexer] && !(unwrappedRootObject instanceof Array)) {
- return;
- }
- }
- }
-
- var outputProperty;
- switch (getType(ko.utils.unwrapObservable(propertyValue))) {
- case "object":
- case "undefined":
- var previouslyMappedValue = options.visitedObjects.get(propertyValue);
- mappedRootObject[indexer] = (getType(previouslyMappedValue) !== "undefined") ? previouslyMappedValue : ko.mapping.visitModel(propertyValue, callback, options);
- break;
- default:
- mappedRootObject[indexer] = callback(propertyValue, options.parentName);
- }
- });
-
- return mappedRootObject;
- }
-
- function objectLookup() {
- var keys = [];
- var values = [];
- this.save = function (key, value) {
- var existingIndex = ko.utils.arrayIndexOf(keys, key);
- if (existingIndex >= 0) values[existingIndex] = value;
- else {
- keys.push(key);
- values.push(value);
- }
- };
- this.get = function (key) {
- var existingIndex = ko.utils.arrayIndexOf(keys, key);
- return (existingIndex >= 0) ? values[existingIndex] : undefined;
- };
- };
-
- ko.exportSymbol('ko.mapping', ko.mapping);
- ko.exportSymbol('ko.mapping.fromJS', ko.mapping.fromJS);
- ko.exportSymbol('ko.mapping.fromJSON', ko.mapping.fromJSON);
- ko.exportSymbol('ko.mapping.isMapped', ko.mapping.isMapped);
- ko.exportSymbol('ko.mapping.defaultOptions', ko.mapping.defaultOptions);
- ko.exportSymbol('ko.mapping.toJS', ko.mapping.toJS);
- ko.exportSymbol('ko.mapping.toJSON', ko.mapping.toJSON);
- ko.exportSymbol('ko.mapping.updateFromJS', ko.mapping.updateFromJS);
- ko.exportSymbol('ko.mapping.updateFromJSON', ko.mapping.updateFromJSON);
- ko.exportSymbol('ko.mapping.visitModel', ko.mapping.visitModel);
-})();
\ No newline at end of file