Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(29)

Unified Diff: appengine/config_service/ui/bower_components/polymer/lib/mixins/mutable-data.html

Issue 2923973003: Added base template for config ui. (Closed)
Patch Set: Created 3 years, 6 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: appengine/config_service/ui/bower_components/polymer/lib/mixins/mutable-data.html
diff --git a/appengine/config_service/ui/bower_components/polymer/lib/mixins/mutable-data.html b/appengine/config_service/ui/bower_components/polymer/lib/mixins/mutable-data.html
new file mode 100644
index 0000000000000000000000000000000000000000..9cb64930fe09f8139bb2afbec2cf25beb86858c9
--- /dev/null
+++ b/appengine/config_service/ui/bower_components/polymer/lib/mixins/mutable-data.html
@@ -0,0 +1,194 @@
+<!--
+@license
+Copyright (c) 2017 The Polymer Project Authors. All rights reserved.
+This code may only be used under the BSD style license found at http://polymer.github.io/LICENSE.txt
+The complete set of authors may be found at http://polymer.github.io/AUTHORS.txt
+The complete set of contributors may be found at http://polymer.github.io/CONTRIBUTORS.txt
+Code distributed by Google as part of the polymer project is also
+subject to an additional IP rights grant found at http://polymer.github.io/PATENTS.txt
+-->
+
+<link rel="import" href="../utils/mixin.html">
+
+<script>
+(function() {
+ 'use strict';
+
+ // Common implementation for mixin & behavior
+ function mutablePropertyChange(inst, property, value, old, mutableData) {
+ let isObject;
+ if (mutableData) {
+ isObject = (typeof value === 'object' && value !== null);
+ // Pull `old` for Objects from temp cache, but treat `null` as a primitive
+ if (isObject) {
+ old = inst.__dataTemp[property];
+ }
+ }
+ // Strict equality check, but return false for NaN===NaN
+ let shouldChange = (old !== value && (old === old || value === value));
+ // Objects are stored in temporary cache (cleared at end of
+ // turn), which is used for dirty-checking
+ if (isObject && shouldChange) {
+ inst.__dataTemp[property] = value;
+ }
+ return shouldChange;
+ }
+
+ /**
+ * Element class mixin to skip strict dirty-checking for objects and arrays
+ * (always consider them to be "dirty"), for use on elements utilizing
+ * `Polymer.PropertyEffects`
+ *
+ * By default, `Polymer.PropertyEffects` performs strict dirty checking on
+ * objects, which means that any deep modifications to an object or array will
+ * not be propagated unless "immutable" data patterns are used (i.e. all object
+ * references from the root to the mutation were changed).
+ *
+ * Polymer also provides a proprietary data mutation and path notification API
+ * (e.g. `notifyPath`, `set`, and array mutation API's) that allow efficient
+ * mutation and notification of deep changes in an object graph to all elements
+ * bound to the same object graph.
+ *
+ * In cases where neither immutable patterns nor the data mutation API can be
+ * used, applying this mixin will cause Polymer to skip dirty checking for
+ * objects and arrays (always consider them to be "dirty"). This allows a
+ * user to make a deep modification to a bound object graph, and then either
+ * simply re-set the object (e.g. `this.items = this.items`) or call `notifyPath`
+ * (e.g. `this.notifyPath('items')`) to update the tree. Note that all
+ * elements that wish to be updated based on deep mutations must apply this
+ * mixin or otherwise skip strict dirty checking for objects/arrays.
+ *
+ * In order to make the dirty check strategy configurable, see
+ * `Polymer.OptionalMutableData`.
+ *
+ * Note, the performance characteristics of propagating large object graphs
+ * will be worse as opposed to using strict dirty checking with immutable
+ * patterns or Polymer's path notification API.
+ *
+ * @polymerMixin
+ * @memberof Polymer
+ * @summary Element class mixin to skip strict dirty-checking for objects
+ * and arrays
+ */
+ Polymer.MutableData = Polymer.dedupingMixin(superClass => {
+
+ /**
+ * @polymerMixinClass
+ * @implements {Polymer_MutableData}
+ */
+ class MutableData extends superClass {
+ /**
+ * Overrides `Polymer.PropertyEffects` to provide option for skipping
+ * strict equality checking for Objects and Arrays.
+ *
+ * This method pulls the value to dirty check against from the `__dataTemp`
+ * cache (rather than the normal `__data` cache) for Objects. Since the temp
+ * cache is cleared at the end of a turn, this implementation allows
+ * side-effects of deep object changes to be processed by re-setting the
+ * same object (using the temp cache as an in-turn backstop to prevent
+ * cycles due to 2-way notification).
+ *
+ * @param {string} property Property name
+ * @param {*} value New property value
+ * @param {*} old Previous property value
+ * @return {boolean} Whether the property should be considered a change
+ * @protected
+ */
+ _shouldPropertyChange(property, value, old) {
+ return mutablePropertyChange(this, property, value, old, true);
+ }
+
+ }
+
+ return MutableData;
+
+ });
+
+ /**
+ * Element class mixin to add the optional ability to skip strict
+ * dirty-checking for objects and arrays (always consider them to be
+ * "dirty") by setting a `mutable-data` attribute on an element instance.
+ *
+ * By default, `Polymer.PropertyEffects` performs strict dirty checking on
+ * objects, which means that any deep modifications to an object or array will
+ * not be propagated unless "immutable" data patterns are used (i.e. all object
+ * references from the root to the mutation were changed).
+ *
+ * Polymer also provides a proprietary data mutation and path notification API
+ * (e.g. `notifyPath`, `set`, and array mutation API's) that allow efficient
+ * mutation and notification of deep changes in an object graph to all elements
+ * bound to the same object graph.
+ *
+ * In cases where neither immutable patterns nor the data mutation API can be
+ * used, applying this mixin will allow Polymer to skip dirty checking for
+ * objects and arrays (always consider them to be "dirty"). This allows a
+ * user to make a deep modification to a bound object graph, and then either
+ * simply re-set the object (e.g. `this.items = this.items`) or call `notifyPath`
+ * (e.g. `this.notifyPath('items')`) to update the tree. Note that all
+ * elements that wish to be updated based on deep mutations must apply this
+ * mixin or otherwise skip strict dirty checking for objects/arrays.
+ *
+ * While this mixin adds the ability to forgo Object/Array dirty checking,
+ * the `mutableData` flag defaults to false and must be set on the instance.
+ *
+ * Note, the performance characteristics of propagating large object graphs
+ * will be worse by relying on `mutableData: true` as opposed to using
+ * strict dirty checking with immutable patterns or Polymer's path notification
+ * API.
+ *
+ * @polymerMixin
+ * @memberof Polymer
+ * @summary Element class mixin to optionally skip strict dirty-checking
+ * for objects and arrays
+ */
+ Polymer.OptionalMutableData = Polymer.dedupingMixin(superClass => {
+
+ /**
+ * @polymerMixinClass
+ * @implements {Polymer_OptionalMutableData}
+ */
+ class OptionalMutableData extends superClass {
+
+ static get properties() {
+ return {
+ /**
+ * Instance-level flag for configuring the dirty-checking strategy
+ * for this element. When true, Objects and Arrays will skip dirty
+ * checking, otherwise strict equality checking will be used.
+ */
+ mutableData: Boolean
+ };
+ }
+
+ /**
+ * Overrides `Polymer.PropertyEffects` to provide option for skipping
+ * strict equality checking for Objects and Arrays.
+ *
+ * When `this.mutableData` is true on this instance, this method
+ * pulls the value to dirty check against from the `__dataTemp` cache
+ * (rather than the normal `__data` cache) for Objects. Since the temp
+ * cache is cleared at the end of a turn, this implementation allows
+ * side-effects of deep object changes to be processed by re-setting the
+ * same object (using the temp cache as an in-turn backstop to prevent
+ * cycles due to 2-way notification).
+ *
+ * @param {string} property Property name
+ * @param {*} value New property value
+ * @param {*} old Previous property value
+ * @return {boolean} Whether the property should be considered a change
+ * @protected
+ */
+ _shouldPropertyChange(property, value, old) {
+ return mutablePropertyChange(this, property, value, old, this.mutableData);
+ }
+ }
+
+ return OptionalMutableData;
+
+ });
+
+ // Export for use by legacy behavior
+ Polymer.MutableData._mutablePropertyChange = mutablePropertyChange;
+
+})();
+</script>

Powered by Google App Engine
This is Rietveld 408576698