Add cr_policy_indicator for settings controls

chrome/browser/resources/settings/checkbox/checkbox.js

 // Copyright 2015 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.
 
 /**
  * @fileoverview
  * `cr-settings-checkbox` is a checkbox that controls a supplied preference.
  *
  * Example:
  *      <cr-settings-checkbox pref="{{prefs.settings.enableFoo}}"
  *          label="Enable foo setting." subLabel="(bar also)">
  *      </cr-settings-checkbox>
  *
  * @element cr-settings-checkbox
  */
 Polymer({
   is: 'cr-settings-checkbox',
 
   properties: {
     /**
      * The boolean preference object to control.
      * @type {?chrome.settingsPrivate.PrefObject}
      */
     pref: {
       type: Object,
       notify: true,
-      value: null
+      value: null,
     },
 
+    /** Whether the checkbox should represent the inverted value. */
     inverted: {
       type: Boolean,
-      value: false
+      value: false,
     },
 
+    /** Whether the checkbox is checked. */
     checked: {
       type: Boolean,
       value: false,
-      observer: 'checkedChanged_'
+      observer: 'checkedChanged_',
     },
 
+    /** Set to disable the element programatically. */

[michaelpg, 2015/09/14 05:14:51]

programatically... or via HTML, like any other property.

[stevenjb, 2015/09/14 23:05:31]

Simplified not that checkboxDisabled_ is a method.

+    disabled: {
+      type: Boolean,
+      value: false,
+      observer: 'disabledChanged_',
+    },
+
+    /**
+     * Internal disabled state of the checkbox. Always false if |disabled| is
+     * false, otherwise may be set to false by a pref policy.

[michaelpg, 2015/09/14 05:14:51]

if you're going to keep this, make it @private

[stevenjb, 2015/09/14 23:05:31]

Acknowledged.

+     */
+    checkboxDisabled: {
+      type: Boolean,
+      value: false,
+    },
+
+    /** Checkbox label. */
     label: {
       type: String,
       value: '',
     },
 
+    /** Additional sub-label for the checkbox. */
     subLabel: {
       type: String,
       value: '',
     },
   },
 
   observers: [
-    'prefValueChanged_(pref.value)'
+    'prefPropertyChanged_(pref.*)'
   ],
 
   /** @override */
   ready: function() {
     this.$.events.forward(this.$.checkbox, ['change']);
   },
 
-  /** @private */
-  prefValueChanged_: function(prefValue) {
-    // prefValue is initially undefined when Polymer initializes pref.
-    if (prefValue !== undefined) {
-      this.checked = this.getNewValue_(prefValue);
+  /**
+   * Polymer observer for pref.
+   * @param {?{path: string, value: *}} change
+   * @private
+   */
+  prefPropertyChanged_: function(change) {
+    if (!this.pref)
+      return;
+    var path = change.path;
+    if (path == 'pref' || path == 'pref.value') {
+      this.checked = this.getNewValue_(this.pref.value);
+    }
+    if (path == 'pref' || path == 'pref.policySource' ||
+        path == 'pref.policyEnforcement') {
+      this.checkboxDisabled =
+          this.disabled || this.isSettingDisabled_(this.pref);
     }
   },
 
-  /** @private */
+  /**
+   * Polymer observer for checked.
+   * @private
+   */
   checkedChanged_: function() {
-    if (this.pref) {
-      this.set('pref.value', this.getNewValue_(this.checked));
-    }
+    if (!this.pref)
+      return;
+    this.set('pref.value', this.getNewValue_(this.checked));

[michaelpg, 2015/09/14 05:14:51]

this.set('pref.value', foo) does nothing if this.pref is not defined.

I don't think it's bad to check "if (!this.pref)", but because in this case
you're only doing it to be "safe", I would leave it out. 

[stevenjb, 2015/09/14 23:05:31]

I only changed this to match disabledChanged_, which is now gone, but done.

   },
 
-  /** @private */
-  getNewValue_: function(val) {
-    return this.inverted ? !val : val;
-  }
+  /**
+   * Polymer observer for disabled.
+   * @private
+   */
+  disabledChanged_: function() {
+    if (!this.pref)
+      return;
+    this.checkboxDisabled = this.disabled || this.isSettingDisabled_(this.pref);
+  },
+
+  /**
+   * @param {*} value
+   * @return {boolean} The value as a boolean, inverted if |inverted| is true.
+   * @private
+   */
+  getNewValue_: function(value) {
+    return this.inverted ? !value : !!value;
+  },
+
+  /**
+   * @param {?chrome.settingsPrivate.PrefObject} pref
+   * @return {boolean} True if the setting is either explicitly disabled, or
+   *     disabled by the policyEnforcement property.
+   */
+  isSettingDisabled_: function(pref) {
+    return !!pref && pref.policyEnforcement ==
+                         chrome.settingsPrivate.PolicyEnforcement.ENFORCED;
+  },
 });