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_',
     },
 
+    /** Disabled property for the element. */
+    disabled: {
+      type: Boolean,
+      value: false,
+    },
+
+    /** Checkbox label. */
     label: {
       type: String,
       value: '',
     },
 
+    /** Additional sub-label for the checkbox. */
     subLabel: {
       type: String,
       value: '',
     },
   },
 
   observers: [
     'prefValueChanged_(pref.value)'
   ],
 
   /** @override */
   ready: function() {
     this.$.events.forward(this.$.checkbox, ['change']);
   },
 
-  /** @private */
+  /**
+   * Polymer observer for pref.value
+   * @param {?chrome.settingsPrivate.PrefObject} prefValue

[michaelpg, 2015/09/16 18:58:52]

the type of value is {*} -- pref is the PrefObject

[stevenjb, 2015/09/16 21:45:53]

Ah, right, pref.value.
Done.

+   * @private
+   */
   prefValueChanged_: function(prefValue) {
     // prefValue is initially undefined when Polymer initializes pref.
-    if (prefValue !== undefined) {
+    if (prefValue !== undefined)

[michaelpg, 2015/09/16 18:58:52]

should be able to remove this upon rebase

[stevenjb, 2015/09/16 21:45:53]

Done.

       this.checked = this.getNewValue_(prefValue);
-    }
   },
 
-  /** @private */
+  /**
+   * Polymer observer for checked.
+   * @private
+   */
   checkedChanged_: function() {
-    if (this.pref) {
-      this.set('pref.value', this.getNewValue_(this.checked));
-    }
+    this.set('pref.value', this.getNewValue_(this.checked));
   },
 
-  /** @private */
-  getNewValue_: function(val) {
-    return this.inverted ? !val : val;
-  }
+  /**
+   * @param {*} value
+   * @return {boolean} The value as a boolean, inverted if |inverted| is true.
+   * @private
+   */
+  getNewValue_: function(value) {
+    return this.inverted ? !value : !!value;
+  },
+
+  /**
+   * @param {boolean} disabled
+   * @param {?chrome.settingsPrivate.PrefObject} pref
+   * @return {boolean} Whether the checkbox should be disabled.
+   * @private
+   */
+  checkboxDisabled_: function(disabled, pref) {
+    return disabled || (!!pref &&
+                        pref.policyEnforcement ==
+                            chrome.settingsPrivate.PolicyEnforcement.ENFORCED);
+  },
 });