LEFT | RIGHT |
1 /* | 1 /* |
2 * This file is part of Adblock Plus <http://adblockplus.org/>, | 2 * This file is part of Adblock Plus <http://adblockplus.org/>, |
3 * Copyright (C) 2006-2013 Eyeo GmbH | 3 * Copyright (C) 2006-2013 Eyeo GmbH |
4 * | 4 * |
5 * Adblock Plus is free software: you can redistribute it and/or modify | 5 * Adblock Plus is free software: you can redistribute it and/or modify |
6 * it under the terms of the GNU General Public License version 3 as | 6 * it under the terms of the GNU General Public License version 3 as |
7 * published by the Free Software Foundation. | 7 * published by the Free Software Foundation. |
8 * | 8 * |
9 * Adblock Plus is distributed in the hope that it will be useful, | 9 * Adblock Plus is distributed in the hope that it will be useful, |
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of | 10 * but WITHOUT ANY WARRANTY; without even the implied warranty of |
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | 11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
12 * GNU General Public License for more details. | 12 * GNU General Public License for more details. |
13 * | 13 * |
14 * You should have received a copy of the GNU General Public License | 14 * You should have received a copy of the GNU General Public License |
15 * along with Adblock Plus. If not, see <http://www.gnu.org/licenses/>. | 15 * along with Adblock Plus. If not, see <http://www.gnu.org/licenses/>. |
16 */ | 16 */ |
17 | 17 |
18 /** | 18 /** |
19 * @fileOverview This emulates a subset of the CustomizableUI API from Firefox 2
8. | 19 * @fileOverview This emulates a subset of the CustomizableUI API from Firefox 2
8. |
20 */ | 20 */ |
21 | 21 |
| 22 let {XPCOMUtils} = Cu.import("resource://gre/modules/XPCOMUtils.jsm", null); |
| 23 |
22 let {Utils} = require("utils"); | 24 let {Utils} = require("utils"); |
| 25 |
| 26 // UI module has to be referenced lazily to avoid circular references |
| 27 XPCOMUtils.defineLazyGetter(this, "UI", function() require("ui").UI); |
23 | 28 |
24 let widgets = Map(); | 29 let widgets = Map(); |
25 | 30 |
26 function getToolbox(/**Window*/ window, /**Widget*/ widget) /**Element*/ | 31 function getToolbox(/**Window*/ window, /**Widget*/ widget) /**Element*/ |
27 { | 32 { |
28 if (!("defaultArea" in widget) || !widget.defaultArea) | 33 if (!("defaultArea" in widget) || !widget.defaultArea) |
29 return null; | 34 return null; |
30 | 35 |
31 let {UI} = require("ui"); | |
32 let toolbar = UI.findElement(window, widget.defaultArea); | 36 let toolbar = UI.findElement(window, widget.defaultArea); |
33 if (!toolbar) | 37 if (!toolbar) |
34 return null; | 38 return null; |
35 | 39 |
36 let toolbox = toolbar.toolbox; | 40 let toolbox = toolbar.toolbox; |
37 if (toolbox && ("palette" in toolbox) && toolbox.palette) | 41 if (toolbox && ("palette" in toolbox) && toolbox.palette) |
38 return toolbox; | 42 return toolbox; |
39 else | 43 else |
40 return null; | 44 return null; |
41 } | 45 } |
(...skipping 11 matching lines...) Expand all Loading... |
53 for (let child of toolbox.palette.children) | 57 for (let child of toolbox.palette.children) |
54 if (child.id == id) | 58 if (child.id == id) |
55 return child; | 59 return child; |
56 | 60 |
57 return null; | 61 return null; |
58 } | 62 } |
59 | 63 |
60 function restoreWidget(/**Element*/ toolbox, /**Widget*/ widget) | 64 function restoreWidget(/**Element*/ toolbox, /**Widget*/ widget) |
61 { | 65 { |
62 // Create node | 66 // Create node |
63 let node = toolbox.ownerDocument.createElement("toolbarbutton"); | 67 let node = widget.onBuild(toolbox.ownerDocument); |
64 node.setAttribute("id", widget.id); | |
65 if (typeof widget.onClick == "function") | 68 if (typeof widget.onClick == "function") |
66 node.addEventListener("click", widget.onClick, false); | 69 node.addEventListener("click", widget.onClick, false); |
67 if (typeof widget.onCommand == "function") | 70 if (typeof widget.onCommand == "function") |
68 node.addEventListener("command", widget.onCommand, false); | 71 node.addEventListener("command", widget.onCommand, false); |
69 if (typeof widget.onCreated == "function") | |
70 widget.onCreated(node); | |
71 | 72 |
72 // Insert into the palette first | 73 // Insert into the palette first |
73 toolbox.palette.insertBefore(node, toolbox.palette.firstChild); | 74 toolbox.palette.insertBefore(node, toolbox.palette.firstChild); |
74 | 75 |
75 // Now find out where we should put it | 76 // Now find out where we should put it |
76 let position = toolbox.getAttribute(widget.positionAttribute); | 77 let position = toolbox.getAttribute(widget.positionAttribute); |
77 if (!/^\S*,\S*,\S*$/.test(position)) | 78 if (!/^\S*,\S*,\S*$/.test(position)) |
78 position = null; | 79 position = null; |
79 | 80 |
80 if (position == null) | 81 if (position == null) |
(...skipping 44 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
125 if (visible == "visible" && !parent) | 126 if (visible == "visible" && !parent) |
126 { | 127 { |
127 let insertionPoint = { | 128 let insertionPoint = { |
128 parent: widget.defaultArea | 129 parent: widget.defaultArea |
129 }; | 130 }; |
130 if (typeof widget.defaultBefore != "undefined") | 131 if (typeof widget.defaultBefore != "undefined") |
131 insertionPoint.before = widget.defaultBefore; | 132 insertionPoint.before = widget.defaultBefore; |
132 if (typeof widget.defaultAfter != "undefined") | 133 if (typeof widget.defaultAfter != "undefined") |
133 insertionPoint.after = widget.defaultAfter; | 134 insertionPoint.after = widget.defaultAfter; |
134 | 135 |
135 let {UI} = require("ui"); | |
136 [parent, before] = UI.resolveInsertionPoint(toolbox.ownerDocument.defaultVie
w, insertionPoint); | 136 [parent, before] = UI.resolveInsertionPoint(toolbox.ownerDocument.defaultVie
w, insertionPoint); |
137 } | 137 } |
138 | 138 |
139 if (parent && parent.localName != "toolbar") | 139 if (parent && parent.localName != "toolbar") |
140 parent = null; | 140 parent = null; |
141 | 141 |
142 if (visible != "visible") | 142 if (visible != "visible") |
143 { | 143 { |
144 // Move to palette if the item is currently visible | 144 // Move to palette if the item is currently visible |
145 let node = toolbox.ownerDocument.getElementById(widget.id); | 145 let node = toolbox.ownerDocument.getElementById(widget.id); |
(...skipping 35 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
181 saveState(toolbox, widget); | 181 saveState(toolbox, widget); |
182 } | 182 } |
183 | 183 |
184 function saveState(/**Element*/ toolbox, /**Widget*/ widget) | 184 function saveState(/**Element*/ toolbox, /**Widget*/ widget) |
185 { | 185 { |
186 let node = toolbox.ownerDocument.getElementById(widget.id); | 186 let node = toolbox.ownerDocument.getElementById(widget.id); |
187 | 187 |
188 let position = toolbox.getAttribute(widget.positionAttribute) || "hidden,,"; | 188 let position = toolbox.getAttribute(widget.positionAttribute) || "hidden,,"; |
189 if (node) | 189 if (node) |
190 { | 190 { |
191 if (typeof widget.onCreated == "function") | 191 if (typeof widget.onAdded == "function") |
192 widget.onCreated(node); | 192 widget.onAdded(node) |
193 | 193 |
194 let toolbar = getToolbar(node); | 194 let toolbar = getToolbar(node); |
195 position = "visible," + toolbar.id + "," + (node.nextSibling ? node.nextSibl
ing.id : ""); | 195 position = "visible," + toolbar.id + "," + (node.nextSibling ? node.nextSibl
ing.id : ""); |
196 } | 196 } |
197 else | 197 else |
198 position = position.replace(/^visible,/, "hidden,") | 198 position = position.replace(/^visible,/, "hidden,") |
199 | 199 |
200 toolbox.setAttribute(widget.positionAttribute, position); | 200 toolbox.setAttribute(widget.positionAttribute, position); |
201 toolbox.ownerDocument.persist(toolbox.id, widget.positionAttribute); | 201 toolbox.ownerDocument.persist(toolbox.id, widget.positionAttribute); |
202 } | 202 } |
203 | 203 |
204 let CustomizableUI = exports.CustomizableUI = | 204 let CustomizableUI = exports.CustomizableUI = |
205 { | 205 { |
206 createWidget: function(widget) | 206 createWidget: function(widget) |
207 { | 207 { |
208 if (typeof widget.id == "undefined" || | 208 if (typeof widget.id == "undefined" || |
209 typeof widget.defaultArea == "undefined" || | 209 typeof widget.defaultArea == "undefined" || |
210 typeof widget.positionAttribute == "undefined") | 210 typeof widget.positionAttribute == "undefined") |
211 { | 211 { |
212 throw new Error("Unexpected: required property missing from the widget dat
a"); | 212 throw new Error("Unexpected: required property missing from the widget dat
a"); |
213 } | 213 } |
214 widgets.set(widget.id, widget); | 214 widgets.set(widget.id, widget); |
215 | 215 |
216 // Show widget in any existing windows | 216 // Show widget in any existing windows |
217 let {UI} = require("ui"); | |
218 for (let window of UI.applicationWindows) | 217 for (let window of UI.applicationWindows) |
219 { | 218 { |
220 let toolbox = getToolbox(window, widget); | 219 let toolbox = getToolbox(window, widget); |
221 if (toolbox) | 220 if (toolbox) |
222 { | 221 { |
223 toolbox.addEventListener("aftercustomization", onToolbarCustomization, f
alse); | 222 toolbox.addEventListener("aftercustomization", onToolbarCustomization, f
alse); |
224 restoreWidget(toolbox, widget); | 223 restoreWidget(toolbox, widget); |
225 } | 224 } |
226 } | 225 } |
227 }, | 226 }, |
228 | 227 |
229 destroyWidget: function(id) | 228 destroyWidget: function(id) |
230 { | 229 { |
231 // Don't do anything here. This function is called on shutdown, | 230 // Don't do anything here. This function is called on shutdown, |
232 // removeFromWindow will take care of cleaning up already. | 231 // removeFromWindow will take care of cleaning up already. |
233 }, | 232 }, |
234 | 233 |
235 getPlacementOfWidget: function(id) | 234 getPlacementOfWidget: function(id) |
236 { | 235 { |
237 let {UI} = require("ui"); | |
238 let window = UI.currentWindow; | 236 let window = UI.currentWindow; |
239 if (!window) | 237 if (!window) |
240 return null; | 238 return null; |
241 | 239 |
242 let widget = window.document.getElementById(id); | 240 let widget = window.document.getElementById(id); |
243 if (!widget) | 241 if (!widget) |
244 return null; | 242 return null; |
245 | 243 |
246 let toolbar = getToolbar(widget); | 244 let toolbar = getToolbar(widget); |
247 if (!toolbar) | 245 if (!toolbar) |
248 return null; | 246 return null; |
249 | 247 |
250 let items = toolbar.currentSet.split(","); | 248 return {area: toolbar.id}; |
251 let index = items.indexOf(id); | 249 }, |
252 if (index < 0) | 250 |
253 return null; | 251 addWidgetToArea: function(id) |
254 else | 252 { |
255 return {area: toolbar.id, placement: index}; | 253 // Note: the official API function also has area and position parameters. |
256 }, | 254 // We ignore those here and simply restore the previous position instead. |
257 | |
258 addWidgetToArea: function(id, area, position) | |
259 { | |
260 let {UI} = require("ui"); | |
261 let widget = widgets.get(id); | 255 let widget = widgets.get(id); |
262 for (let window of UI.applicationWindows) | 256 for (let window of UI.applicationWindows) |
263 { | 257 { |
264 let toolbox = getToolbox(window, widget); | 258 let toolbox = getToolbox(window, widget); |
265 if (!toolbox) | 259 if (!toolbox) |
266 continue; | 260 continue; |
267 | 261 |
268 let position = toolbox.getAttribute(widget.positionAttribute); | 262 let position = toolbox.getAttribute(widget.positionAttribute); |
269 if (position) | 263 if (position) |
270 position = position.replace(/^hidden,/, "visible,"); | 264 position = position.replace(/^hidden,/, "visible,"); |
271 showWidget(toolbox, widget, position); | 265 showWidget(toolbox, widget, position); |
272 } | 266 } |
273 }, | 267 }, |
274 | 268 |
275 removeWidgetFromArea: function(id) | 269 removeWidgetFromArea: function(id) |
276 { | 270 { |
277 let {UI} = require("ui"); | |
278 let widget = widgets.get(id); | 271 let widget = widgets.get(id); |
279 for (let window of UI.applicationWindows) | 272 for (let window of UI.applicationWindows) |
280 { | 273 { |
281 let toolbox = getToolbox(window, widget); | 274 let toolbox = getToolbox(window, widget); |
282 if (!toolbox) | 275 if (!toolbox) |
283 continue; | 276 continue; |
284 | 277 |
285 let position = toolbox.getAttribute(widget.positionAttribute); | 278 let position = toolbox.getAttribute(widget.positionAttribute); |
286 if (position) | 279 if (position) |
287 position = position.replace(/^visible,/, "hidden,"); | 280 position = position.replace(/^visible,/, "hidden,"); |
(...skipping 34 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
322 for (let [id, widget] of widgets) | 315 for (let [id, widget] of widgets) |
323 { | 316 { |
324 let toolbox = getToolbox(window, widget); | 317 let toolbox = getToolbox(window, widget); |
325 if (toolbox) | 318 if (toolbox) |
326 toolbox.removeEventListener("aftercustomization", onToolbarCustomization
, false); | 319 toolbox.removeEventListener("aftercustomization", onToolbarCustomization
, false); |
327 | 320 |
328 removeWidget(window, widget); | 321 removeWidget(window, widget); |
329 } | 322 } |
330 } | 323 } |
331 }); | 324 }); |
LEFT | RIGHT |