OLD | NEW |
---|---|
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 cr.define('options', function() { | 5 cr.define('options', function() { |
6 /** @const */ var SettingsDialog = options.SettingsDialog; | 6 /** @const */ var SettingsDialog = options.SettingsDialog; |
7 | 7 |
8 /** | 8 /** |
9 * A dialog that will pop up when the user attempts to set the value of the | 9 * A dialog that will pop up when the user attempts to set the value of the |
10 * Boolean |pref| to |true|, asking for confirmation. If the user clicks OK, | 10 * Boolean |pref| to |true|, asking for confirmation. If the user clicks OK, |
11 * the new value is committed to Chrome. If the user clicks Cancel or leaves | 11 * the new value is committed to Chrome. If the user clicks Cancel or leaves |
12 * the settings page, the new value is discarded. | 12 * the settings page, the new value is discarded. |
13 * @constructor | 13 * @constructor |
14 * @param {string} name See Page constructor. | 14 * @param {string} name See Page constructor. |
15 * @param {string} title See Page constructor. | 15 * @param {string} title See Page constructor. |
16 * @param {string} pageDivName See Page constructor. | 16 * @param {string} pageDivName See Page constructor. |
17 * @param {HTMLInputElement} okButton The confirmation button element. | 17 * @param {HTMLInputElement} okButton The confirmation button element. |
18 * @param {HTMLInputElement} cancelButton The cancellation button element. | 18 * @param {HTMLInputElement} cancelButton The cancellation button element. |
19 * @param {string} pref The pref that requires confirmation. | 19 * @param {string} pref The pref that requires confirmation. |
20 * @param {string} metric User metrics identifier. | 20 * @param {string} metric User metrics identifier. |
21 * @param {string} confirmed_pref A pref used to remember whether the user has | 21 * @param {string=} opt_confirmedPref A pref used to remember whether the |
22 * confirmed the dialog before. This ensures that the user is presented | 22 * user has confirmed the dialog before. This ensures that the user is |
23 * with the dialog only once. If left |undefined| or |null|, the dialog | 23 * presented with the dialog only once. If left |undefined|, the dialog |
24 * will pop up every time the user attempts to set |pref| to |true|. | 24 * will pop up every time the user attempts to set |pref| to |true|. |
25 * @extends {options.SettingsDialog} | 25 * @extends {options.SettingsDialog} |
26 */ | 26 */ |
27 function ConfirmDialog(name, title, pageDivName, okButton, cancelButton, pref, | 27 function ConfirmDialog(name, title, pageDivName, okButton, cancelButton, pref, |
28 metric, confirmed_pref) { | 28 metric, opt_confirmedPref) { |
29 SettingsDialog.call(this, name, title, pageDivName, okButton, cancelButton); | 29 SettingsDialog.call(this, name, title, pageDivName, okButton, cancelButton); |
30 this.pref = pref; | 30 this.pref = pref; |
31 this.metric = metric; | 31 this.metric = metric; |
Dan Beam
2014/09/11 22:51:08
/** @private */
Vitaly Pavlenko
2014/09/11 23:13:09
Done.
| |
32 this.confirmed_pref = confirmed_pref; | 32 this.confirmedPref_ = opt_confirmedPref; |
33 this.confirmed_ = false; | 33 this.confirmed_ = false; |
34 } | 34 } |
35 | 35 |
36 ConfirmDialog.prototype = { | 36 ConfirmDialog.prototype = { |
37 // Set up the prototype chain | 37 // Set up the prototype chain |
38 __proto__: SettingsDialog.prototype, | 38 __proto__: SettingsDialog.prototype, |
39 | 39 |
40 /** | 40 /** |
41 * Handle changes to |pref|. Only uncommitted changes are relevant as these | 41 * Handle changes to |pref|. Only uncommitted changes are relevant as these |
42 * originate from user and need to be explicitly committed to take effect. | 42 * originate from user and need to be explicitly committed to take effect. |
43 * Pop up the dialog or commit the change, depending on whether confirmation | 43 * Pop up the dialog or commit the change, depending on whether confirmation |
44 * is needed. | 44 * is needed. |
45 * @param {Event} event Change event. | 45 * @param {Event} event Change event. |
46 * @private | 46 * @private |
47 */ | 47 */ |
48 onPrefChanged_: function(event) { | 48 onPrefChanged_: function(event) { |
49 if (!event.value.uncommitted) | 49 if (!event.value.uncommitted) |
50 return; | 50 return; |
51 | 51 |
52 if (event.value.value && !this.confirmed_) | 52 if (event.value.value && !this.confirmed_) |
53 PageManager.showPageByName(this.name, false); | 53 PageManager.showPageByName(this.name, false); |
54 else | 54 else |
55 Preferences.getInstance().commitPref(this.pref, this.metric); | 55 Preferences.getInstance().commitPref(this.pref, this.metric); |
56 }, | 56 }, |
57 | 57 |
58 /** | 58 /** |
59 * Handle changes to |confirmed_pref| by caching them. | 59 * Handle changes to |confirmedPref_| by caching them. |
60 * @param {Event} event Change event. | 60 * @param {Event} event Change event. |
61 * @private | 61 * @private |
62 */ | 62 */ |
63 onConfirmedChanged_: function(event) { | 63 onConfirmedChanged_: function(event) { |
64 this.confirmed_ = event.value.value; | 64 this.confirmed_ = event.value.value; |
65 }, | 65 }, |
66 | 66 |
67 /** @override */ | 67 /** @override */ |
68 initializePage: function() { | 68 initializePage: function() { |
69 SettingsDialog.prototype.initializePage.call(this); | 69 SettingsDialog.prototype.initializePage.call(this); |
70 | 70 |
71 this.okButton.onclick = this.handleConfirm.bind(this); | 71 this.okButton.onclick = this.handleConfirm.bind(this); |
72 this.cancelButton.onclick = this.handleCancel.bind(this); | 72 this.cancelButton.onclick = this.handleCancel.bind(this); |
73 Preferences.getInstance().addEventListener( | 73 Preferences.getInstance().addEventListener( |
74 this.pref, this.onPrefChanged_.bind(this)); | 74 this.pref, this.onPrefChanged_.bind(this)); |
75 if (this.confirmed_pref) { | 75 if (this.confirmedPref_) { |
76 Preferences.getInstance().addEventListener( | 76 Preferences.getInstance().addEventListener( |
77 this.confirmed_pref, this.onConfirmedChanged_.bind(this)); | 77 this.confirmedPref_, this.onConfirmedChanged_.bind(this)); |
78 } | 78 } |
79 }, | 79 }, |
80 | 80 |
81 /** | 81 /** |
82 * Handle the confirm button by committing the |pref| change. If | 82 * Handle the confirm button by committing the |pref| change. If |
83 * |confirmed_pref| has been specified, also remember that the dialog has | 83 * |confirmedPref_| has been specified, also remember that the dialog has |
84 * been confirmed to avoid bringing it up in the future. | 84 * been confirmed to avoid bringing it up in the future. |
85 * @override | 85 * @override |
86 */ | 86 */ |
87 handleConfirm: function() { | 87 handleConfirm: function() { |
88 SettingsDialog.prototype.handleConfirm.call(this); | 88 SettingsDialog.prototype.handleConfirm.call(this); |
89 | 89 |
90 Preferences.getInstance().commitPref(this.pref, this.metric); | 90 Preferences.getInstance().commitPref(this.pref, this.metric); |
91 if (this.confirmed_pref) | 91 if (this.confirmedPref_) |
92 Preferences.setBooleanPref(this.confirmed_pref, true, true); | 92 Preferences.setBooleanPref(this.confirmedPref_, true, true); |
93 }, | 93 }, |
94 | 94 |
95 /** | 95 /** |
96 * Handle the cancel button by rolling back the |pref| change without it | 96 * Handle the cancel button by rolling back the |pref| change without it |
97 * ever taking effect. | 97 * ever taking effect. |
98 * @override | 98 * @override |
99 */ | 99 */ |
100 handleCancel: function() { | 100 handleCancel: function() { |
101 SettingsDialog.prototype.handleCancel.call(this); | 101 SettingsDialog.prototype.handleCancel.call(this); |
102 Preferences.getInstance().rollbackPref(this.pref); | 102 Preferences.getInstance().rollbackPref(this.pref); |
103 }, | 103 }, |
104 | 104 |
105 /** | 105 /** |
106 * When a user navigates away from a confirm dialog, treat as a cancel. | 106 * When a user navigates away from a confirm dialog, treat as a cancel. |
107 * @protected | 107 * @protected |
108 * @override | 108 * @override |
109 */ | 109 */ |
110 willHidePage: function() { | 110 willHidePage: function() { |
111 if (this.visible) | 111 if (this.visible) |
112 Preferences.getInstance().rollbackPref(this.pref); | 112 Preferences.getInstance().rollbackPref(this.pref); |
113 }, | 113 }, |
114 }; | 114 }; |
115 | 115 |
116 return { | 116 return { |
117 ConfirmDialog: ConfirmDialog | 117 ConfirmDialog: ConfirmDialog |
118 }; | 118 }; |
119 }); | 119 }); |
OLD | NEW |