Index: chrome/common/extensions/docs/examples/extensions/plugin_settings/domui/js/cr.js |
diff --git a/chrome/common/extensions/docs/examples/extensions/plugin_settings/domui/js/cr.js b/chrome/common/extensions/docs/examples/extensions/plugin_settings/domui/js/cr.js |
new file mode 100644 |
index 0000000000000000000000000000000000000000..2a370a1c0ab5f2b3a9d5d75cbc21c42c51f459b2 |
--- /dev/null |
+++ b/chrome/common/extensions/docs/examples/extensions/plugin_settings/domui/js/cr.js |
@@ -0,0 +1,381 @@ |
+// Copyright (c) 2011 The Chromium Authors. All rights reserved. |
+// Use of this source code is governed by a BSD-style license that can be |
+// found in the LICENSE file. |
+ |
+const cr = (function() { |
+ |
+ /** |
+ * Whether we are using a Mac or not. |
+ * @type {boolean} |
+ */ |
+ const isMac = /Mac/.test(navigator.platform); |
+ |
+ /** |
+ * Whether this is on the Windows platform or not. |
+ * @type {boolean} |
+ */ |
+ const isWindows = /Win/.test(navigator.platform); |
+ |
+ /** |
+ * Whether this is on chromeOS or not. |
+ * @type {boolean} |
+ */ |
+ const isChromeOS = /CrOS/.test(navigator.userAgent); |
+ |
+ /** |
+ * Whether this is on touchui build or not. |
+ * @type {boolean} |
+ */ |
+ const isTouch = /Touch/.test(navigator.userAgent); |
+ |
+ /** |
+ * Whether this is on vanilla Linux (not chromeOS). |
+ * @type {boolean} |
+ */ |
+ const isLinux = /Linux/.test(navigator.userAgent); |
+ |
+ /** |
+ * Whether this uses GTK or not. |
+ * @type {boolean} |
+ */ |
+ const isGTK = /GTK/.test(chrome.toolkit); |
+ |
+ /** |
+ * Whether this uses the views toolkit or not. |
+ * @type {boolean} |
+ */ |
+ const isViews = /views/.test(chrome.toolkit); |
+ |
+ /** |
+ * Sets the os and toolkit attributes in the <html> element so that platform |
+ * specific css rules can be applied. |
+ */ |
+ function enablePlatformSpecificCSSRules() { |
+ if (isMac) |
+ doc.documentElement.setAttribute('os', 'mac'); |
+ if (isWindows) |
+ doc.documentElement.setAttribute('os', 'windows'); |
+ if (isChromeOS) |
+ doc.documentElement.setAttribute('os', 'chromeos'); |
+ if (isLinux) |
+ doc.documentElement.setAttribute('os', 'linux'); |
+ if (isGTK) |
+ doc.documentElement.setAttribute('toolkit', 'gtk'); |
+ if (isViews) |
+ doc.documentElement.setAttribute('toolkit', 'views'); |
+ } |
+ |
+ /** |
+ * Builds an object structure for the provided namespace path, |
+ * ensuring that names that already exist are not overwritten. For |
+ * example: |
+ * "a.b.c" -> a = {};a.b={};a.b.c={}; |
+ * @param {string} name Name of the object that this file defines. |
+ * @param {*=} opt_object The object to expose at the end of the path. |
+ * @param {Object=} opt_objectToExportTo The object to add the path to; |
+ * default is {@code window}. |
+ * @private |
+ */ |
+ function exportPath(name, opt_object, opt_objectToExportTo) { |
+ var parts = name.split('.'); |
+ var cur = opt_objectToExportTo || window /* global */; |
+ |
+ for (var part; parts.length && (part = parts.shift());) { |
+ if (!parts.length && opt_object !== undefined) { |
+ // last part and we have an object; use it |
+ cur[part] = opt_object; |
+ } else if (part in cur) { |
+ cur = cur[part]; |
+ } else { |
+ cur = cur[part] = {}; |
+ } |
+ } |
+ return cur; |
+ }; |
+ |
+ // cr.Event is called CrEvent in here to prevent naming conflicts. We also |
+ // store the original Event in case someone does a global alias of cr.Event. |
+ const DomEvent = Event; |
+ |
+ /** |
+ * Creates a new event to be used with cr.EventTarget or DOM EventTarget |
+ * objects. |
+ * @param {string} type The name of the event. |
+ * @param {boolean=} opt_bubbles Whether the event bubbles. Default is false. |
+ * @param {boolean=} opt_preventable Whether the default action of the event |
+ * can be prevented. |
+ * @constructor |
+ * @extends {DomEvent} |
+ */ |
+ function CrEvent(type, opt_bubbles, opt_preventable) { |
+ var e = cr.doc.createEvent('Event'); |
+ e.initEvent(type, !!opt_bubbles, !!opt_preventable); |
+ e.__proto__ = CrEvent.prototype; |
+ return e; |
+ } |
+ |
+ CrEvent.prototype = { |
+ __proto__: DomEvent.prototype |
+ }; |
+ |
+ /** |
+ * Fires a property change event on the target. |
+ * @param {EventTarget} target The target to dispatch the event on. |
+ * @param {string} propertyName The name of the property that changed. |
+ * @param {*} newValue The new value for the property. |
+ * @param {*} oldValue The old value for the property. |
+ */ |
+ function dispatchPropertyChange(target, propertyName, newValue, oldValue) { |
+ var e = new CrEvent(propertyName + 'Change'); |
+ e.propertyName = propertyName; |
+ e.newValue = newValue; |
+ e.oldValue = oldValue; |
+ target.dispatchEvent(e); |
+ } |
+ |
+ /** |
+ * The kind of property to define in {@code defineProperty}. |
+ * @enum {number} |
+ */ |
+ const PropertyKind = { |
+ /** |
+ * Plain old JS property where the backing data is stored as a "private" |
+ * field on the object. |
+ */ |
+ JS: 'js', |
+ |
+ /** |
+ * The property backing data is stored as an attribute on an element. |
+ */ |
+ ATTR: 'attr', |
+ |
+ /** |
+ * The property backing data is stored as an attribute on an element. If the |
+ * element has the attribute then the value is true. |
+ */ |
+ BOOL_ATTR: 'boolAttr' |
+ }; |
+ |
+ /** |
+ * Helper function for defineProperty that returns the getter to use for the |
+ * property. |
+ * @param {string} name |
+ * @param {cr.PropertyKind} kind |
+ * @return {function():*} The getter for the property. |
+ */ |
+ function getGetter(name, kind) { |
+ switch (kind) { |
+ case PropertyKind.JS: |
+ var privateName = name + '_'; |
+ return function() { |
+ return this[privateName]; |
+ }; |
+ case PropertyKind.ATTR: |
+ return function() { |
+ return this.getAttribute(name); |
+ }; |
+ case PropertyKind.BOOL_ATTR: |
+ return function() { |
+ return this.hasAttribute(name); |
+ }; |
+ } |
+ } |
+ |
+ /** |
+ * Helper function for defineProperty that returns the setter of the right |
+ * kind. |
+ * @param {string} name The name of the property we are defining the setter |
+ * for. |
+ * @param {cr.PropertyKind} kind The kind of property we are getting the |
+ * setter for. |
+ * @param {function(*):void} opt_setHook A function to run after the property |
+ * is set, but before the propertyChange event is fired. |
+ * @return {function(*):void} The function to use as a setter. |
+ */ |
+ function getSetter(name, kind, opt_setHook) { |
+ switch (kind) { |
+ case PropertyKind.JS: |
+ var privateName = name + '_'; |
+ return function(value) { |
+ var oldValue = this[privateName]; |
+ if (value !== oldValue) { |
+ this[privateName] = value; |
+ if (opt_setHook) |
+ opt_setHook.call(this, value, oldValue); |
+ dispatchPropertyChange(this, name, value, oldValue); |
+ } |
+ }; |
+ |
+ case PropertyKind.ATTR: |
+ return function(value) { |
+ var oldValue = this[name]; |
+ if (value !== oldValue) { |
+ if (value == undefined) |
+ this.removeAttribute(name); |
+ else |
+ this.setAttribute(name, value); |
+ if (opt_setHook) |
+ opt_setHook.call(this, value, oldValue); |
+ dispatchPropertyChange(this, name, value, oldValue); |
+ } |
+ }; |
+ |
+ case PropertyKind.BOOL_ATTR: |
+ return function(value) { |
+ var oldValue = this[name]; |
+ if (value !== oldValue) { |
+ if (value) |
+ this.setAttribute(name, name); |
+ else |
+ this.removeAttribute(name); |
+ if (opt_setHook) |
+ opt_setHook.call(this, value, oldValue); |
+ dispatchPropertyChange(this, name, value, oldValue); |
+ } |
+ }; |
+ } |
+ } |
+ |
+ /** |
+ * Defines a property on an object. When the setter changes the value a |
+ * property change event with the type {@code name + 'Change'} is fired. |
+ * @param {!Object} obj The object to define the property for. |
+ * @param {string} name The name of the property. |
+ * @param {cr.PropertyKind=} opt_kind What kind of underlying storage to use. |
+ * @param {function(*):void} opt_setHook A function to run after the |
+ * property is set, but before the propertyChange event is fired. |
+ */ |
+ function defineProperty(obj, name, opt_kind, opt_setHook) { |
+ if (typeof obj == 'function') |
+ obj = obj.prototype; |
+ |
+ var kind = opt_kind || PropertyKind.JS; |
+ |
+ if (!obj.__lookupGetter__(name)) { |
+ obj.__defineGetter__(name, getGetter(name, kind)); |
+ } |
+ |
+ if (!obj.__lookupSetter__(name)) { |
+ obj.__defineSetter__(name, getSetter(name, kind, opt_setHook)); |
+ } |
+ } |
+ |
+ /** |
+ * Counter for use with createUid |
+ */ |
+ var uidCounter = 1; |
+ |
+ /** |
+ * @return {number} A new unique ID. |
+ */ |
+ function createUid() { |
+ return uidCounter++; |
+ } |
+ |
+ /** |
+ * Returns a unique ID for the item. This mutates the item so it needs to be |
+ * an object |
+ * @param {!Object} item The item to get the unique ID for. |
+ * @return {number} The unique ID for the item. |
+ */ |
+ function getUid(item) { |
+ if (item.hasOwnProperty('uid')) |
+ return item.uid; |
+ return item.uid = createUid(); |
+ } |
+ |
+ /** |
+ * Dispatches a simple event on an event target. |
+ * @param {!EventTarget} target The event target to dispatch the event on. |
+ * @param {string} type The type of the event. |
+ * @param {boolean=} opt_bubbles Whether the event bubbles or not. |
+ * @param {boolean=} opt_cancelable Whether the default action of the event |
+ * can be prevented. |
+ * @return {boolean} If any of the listeners called {@code preventDefault} |
+ * during the dispatch this will return false. |
+ */ |
+ function dispatchSimpleEvent(target, type, opt_bubbles, opt_cancelable) { |
+ var e = new cr.Event(type, opt_bubbles, opt_cancelable); |
+ return target.dispatchEvent(e); |
+ } |
+ |
+ /** |
+ * @param {string} name |
+ * @param {!Function} fun |
+ */ |
+ function define(name, fun) { |
+ var obj = exportPath(name); |
+ var exports = fun(); |
+ for (var propertyName in exports) { |
+ // Maybe we should check the prototype chain here? The current usage |
+ // pattern is always using an object literal so we only care about own |
+ // properties. |
+ var propertyDescriptor = Object.getOwnPropertyDescriptor(exports, |
+ propertyName); |
+ if (propertyDescriptor) |
+ Object.defineProperty(obj, propertyName, propertyDescriptor); |
+ } |
+ } |
+ |
+ /** |
+ * Document used for various document related operations. |
+ * @type {!Document} |
+ */ |
+ var doc = document; |
+ |
+ |
+ /** |
+ * Allows you to run func in the context of a different document. |
+ * @param {!Document} document The document to use. |
+ * @param {function():*} func The function to call. |
+ */ |
+ function withDoc(document, func) { |
+ var oldDoc = doc; |
+ doc = document; |
+ try { |
+ func(); |
+ } finally { |
+ doc = oldDoc; |
+ } |
+ } |
+ |
+ /** |
+ * Adds a {@code getInstance} static method that always return the same |
+ * instance object. |
+ * @param {!Function} ctor The constructor for the class to add the static |
+ * method to. |
+ */ |
+ function addSingletonGetter(ctor) { |
+ ctor.getInstance = function() { |
+ return ctor.instance_ || (ctor.instance_ = new ctor()); |
+ }; |
+ } |
+ |
+ return { |
+ addSingletonGetter: addSingletonGetter, |
+ isChromeOS: isChromeOS, |
+ isMac: isMac, |
+ isWindows: isWindows, |
+ isLinux: isLinux, |
+ isViews: isViews, |
+ isTouch: isTouch, |
+ enablePlatformSpecificCSSRules: enablePlatformSpecificCSSRules, |
+ define: define, |
+ defineProperty: defineProperty, |
+ PropertyKind: PropertyKind, |
+ createUid: createUid, |
+ getUid: getUid, |
+ dispatchSimpleEvent: dispatchSimpleEvent, |
+ dispatchPropertyChange: dispatchPropertyChange, |
+ |
+ /** |
+ * The document that we are currently using. |
+ * @type {!Document} |
+ */ |
+ get doc() { |
+ return doc; |
+ }, |
+ withDoc: withDoc, |
+ Event: CrEvent |
+ }; |
+})(); |