OLD | NEW |
(Empty) | |
| 1 # Policy indicators |
| 2 |
| 3 Settings that can't be controlled by the current user often show an icon and a |
| 4 tooltip explaining why. This happens when a setting is: |
| 5 |
| 6 * enforced by user policy, or different from a policy's "recommended" value |
| 7 * overridden by an extension |
| 8 * or (on Chrome OS): |
| 9 * enforced/recommended by device policy (for enrolled devices) |
| 10 * set by the device owner (for non-enrolled devices) |
| 11 * controlled by the primary user (for multiple profile sessions) |
| 12 |
| 13 ## Indicator UI |
| 14 |
| 15 The badge icons are sourced from [cr_elements/icons.html] by default. |
| 16 |
| 17 Indicators show a tooltip with explanatory text on hover if `CrPolicyStrings` |
| 18 is set; see [settings_ui.js] for an example from MD Settings. |
| 19 |
| 20 ## Using an indicator |
| 21 |
| 22 Elements like `<cr-policy-pref-indicator>` and `<cr-policy-network-indicator>` |
| 23 are provided to be reused in WebUI pages: |
| 24 |
| 25 <cr-policy-pref-indicator pref="[[pref]]"></cr-policy-pref-indicator> |
| 26 |
| 27 Example: [settings-checkbox]. |
| 28 |
| 29 For one-off or composed elements, `CrPolicyIndicatorBehavior` provides some |
| 30 configurable properties and calculates dependent properties, such as the |
| 31 tooltip, icon, and visibility of the indicator. |
| 32 |
| 33 Example: [cr_policy_pref_indicator.js] overrides `indicatorType` and |
| 34 `indicatorTooltip`. [cr_policy_pref_indicator.html] displays the computed |
| 35 properties from `CrPolicyIndicatorBehavior`. |
| 36 |
| 37 |
| 38 [cr_elements/icons.html]: ../icons.html |
| 39 [settings_ui.js]: /chrome/browser/resources/settings/settings_ui/settings_ui.js |
| 40 [settings-checkbox]: /chrome/browser/resources/settings/controls/settings_checkb
ox.html |
| 41 [cr_policy_pref_indicator.js]: cr_policy_pref_indicator.js |
| 42 [cr_policy_pref_indicator.html]: cr_policy_pref_indicator.html |
OLD | NEW |