mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-08 20:47:44 +00:00
359 lines
9.7 KiB
JavaScript
359 lines
9.7 KiB
JavaScript
// -*- Mode: js2; tab-width: 2; indent-tabs-mode: nil; js2-basic-offset: 2; js2-skip-preprocessor-directives: t; -*-
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
|
|
* You can obtain one at http://mozilla.org/MPL/2.0/. */
|
|
|
|
"use strict";
|
|
|
|
this.EXPORTED_SYMBOLS = ["Home"];
|
|
|
|
const { classes: Cc, interfaces: Ci, utils: Cu } = Components;
|
|
|
|
Cu.import("resource://gre/modules/Services.jsm");
|
|
Cu.import("resource://gre/modules/SharedPreferences.jsm");
|
|
Cu.import("resource://gre/modules/Messaging.jsm");
|
|
|
|
// See bug 915424
|
|
function resolveGeckoURI(aURI) {
|
|
if (!aURI)
|
|
throw "Can't resolve an empty uri";
|
|
|
|
if (aURI.startsWith("chrome://")) {
|
|
let registry = Cc['@mozilla.org/chrome/chrome-registry;1'].getService(Ci["nsIChromeRegistry"]);
|
|
return registry.convertChromeURL(Services.io.newURI(aURI, null, null)).spec;
|
|
} else if (aURI.startsWith("resource://")) {
|
|
let handler = Services.io.getProtocolHandler("resource").QueryInterface(Ci.nsIResProtocolHandler);
|
|
return handler.resolveURI(Services.io.newURI(aURI, null, null));
|
|
}
|
|
return aURI;
|
|
}
|
|
|
|
function BannerMessage(options) {
|
|
let uuidgen = Cc["@mozilla.org/uuid-generator;1"].getService(Ci.nsIUUIDGenerator);
|
|
this.id = uuidgen.generateUUID().toString();
|
|
|
|
if ("text" in options && options.text != null)
|
|
this.text = options.text;
|
|
|
|
if ("icon" in options && options.icon != null)
|
|
this.iconURI = resolveGeckoURI(options.icon);
|
|
|
|
if ("onshown" in options && typeof options.onshown === "function")
|
|
this.onshown = options.onshown;
|
|
|
|
if ("onclick" in options && typeof options.onclick === "function")
|
|
this.onclick = options.onclick;
|
|
|
|
if ("ondismiss" in options && typeof options.ondismiss === "function")
|
|
this.ondismiss = options.ondismiss;
|
|
}
|
|
|
|
let HomeBanner = (function () {
|
|
// Holds the messages that will rotate through the banner.
|
|
let _messages = {};
|
|
|
|
// A queue used to keep track of which message to show next.
|
|
let _queue = [];
|
|
|
|
|
|
let _handleGet = function() {
|
|
// Get the message from the front of the queue, then add it back
|
|
// to the end of the queue to show it again later.
|
|
let id = _queue.shift();
|
|
_queue.push(id);
|
|
|
|
let message = _messages[id];
|
|
sendMessageToJava({
|
|
type: "HomeBanner:Data",
|
|
id: message.id,
|
|
text: message.text,
|
|
iconURI: message.iconURI
|
|
});
|
|
|
|
if (message.onshown)
|
|
message.onshown();
|
|
};
|
|
|
|
let _handleClick = function(id) {
|
|
let message = _messages[id];
|
|
if (message.onclick)
|
|
message.onclick();
|
|
};
|
|
|
|
let _handleDismiss = function(id) {
|
|
let message = _messages[id];
|
|
if (message.ondismiss)
|
|
message.ondismiss();
|
|
};
|
|
|
|
return Object.freeze({
|
|
observe: function(subject, topic, data) {
|
|
switch(topic) {
|
|
case "HomeBanner:Get":
|
|
_handleGet();
|
|
break;
|
|
|
|
case "HomeBanner:Click":
|
|
_handleClick(data);
|
|
break;
|
|
|
|
case "HomeBanner:Dismiss":
|
|
_handleDismiss(data);
|
|
break;
|
|
}
|
|
},
|
|
|
|
/**
|
|
* Adds a new banner message to the rotation.
|
|
*
|
|
* @return id Unique identifer for the message.
|
|
*/
|
|
add: function(options) {
|
|
let message = new BannerMessage(options);
|
|
_messages[message.id] = message;
|
|
|
|
// Add the new message to the end of the queue.
|
|
_queue.push(message.id);
|
|
|
|
// If this is the first message we're adding, add
|
|
// observers to listen for requests from the Java UI.
|
|
if (Object.keys(_messages).length == 1) {
|
|
Services.obs.addObserver(this, "HomeBanner:Get", false);
|
|
Services.obs.addObserver(this, "HomeBanner:Click", false);
|
|
Services.obs.addObserver(this, "HomeBanner:Dismiss", false);
|
|
|
|
// Send a message to Java, in case there's an active HomeBanner
|
|
// waiting for a response.
|
|
_handleGet();
|
|
}
|
|
|
|
return message.id;
|
|
},
|
|
|
|
/**
|
|
* Removes a banner message from the rotation.
|
|
*
|
|
* @param id The id of the message to remove.
|
|
*/
|
|
remove: function(id) {
|
|
if (!(id in _messages)) {
|
|
throw "Home.banner: Can't remove message that doesn't exist: id = " + id;
|
|
}
|
|
|
|
delete _messages[id];
|
|
|
|
// Remove the message from the queue.
|
|
let index = _queue.indexOf(id);
|
|
_queue.splice(index, 1);
|
|
|
|
// If there are no more messages, remove the observers.
|
|
if (Object.keys(_messages).length == 0) {
|
|
Services.obs.removeObserver(this, "HomeBanner:Get");
|
|
Services.obs.removeObserver(this, "HomeBanner:Click");
|
|
Services.obs.removeObserver(this, "HomeBanner:Dismiss");
|
|
}
|
|
}
|
|
});
|
|
})();
|
|
|
|
function Panel(id, options) {
|
|
this.id = id;
|
|
this.title = options.title;
|
|
|
|
if ("layout" in options)
|
|
this.layout = options.layout;
|
|
|
|
if ("views" in options)
|
|
this.views = options.views;
|
|
}
|
|
|
|
// We need this function to have access to the HomePanels
|
|
// private members without leaking it outside Home.jsm.
|
|
let handlePanelsGet;
|
|
|
|
let HomePanels = (function () {
|
|
// Holds the current set of registered panels that can be
|
|
// installed, updated, uninstalled, or unregistered. It maps
|
|
// panel ids with the functions that dynamically generate
|
|
// their respective panel options. This is used to retrieve
|
|
// the current list of available panels in the system.
|
|
// See HomePanels:Get handler.
|
|
let _registeredPanels = {};
|
|
|
|
// Valid layouts for a panel.
|
|
let Layout = Object.freeze({
|
|
FRAME: "frame"
|
|
});
|
|
|
|
// Valid types of views for a dataset.
|
|
let View = Object.freeze({
|
|
LIST: "list",
|
|
GRID: "grid"
|
|
});
|
|
|
|
// Valid item types for a panel view.
|
|
let Item = Object.freeze({
|
|
ARTICLE: "article",
|
|
IMAGE: "image"
|
|
});
|
|
|
|
// Valid item handlers for a panel view.
|
|
let ItemHandler = Object.freeze({
|
|
BROWSER: "browser",
|
|
INTENT: "intent"
|
|
});
|
|
|
|
let _generatePanel = function(id) {
|
|
let panel = new Panel(id, _registeredPanels[id]());
|
|
|
|
if (!panel.id || !panel.title) {
|
|
throw "Home.panels: Can't create a home panel without an id and title!";
|
|
}
|
|
|
|
if (!panel.layout) {
|
|
// Use FRAME layout by default
|
|
panel.layout = Layout.FRAME;
|
|
} else if (!_valueExists(Layout, panel.layout)) {
|
|
throw "Home.panels: Invalid layout for panel: panel.id = " + panel.id + ", panel.layout =" + panel.layout;
|
|
}
|
|
|
|
for (let view of panel.views) {
|
|
if (!_valueExists(View, view.type)) {
|
|
throw "Home.panels: Invalid view type: panel.id = " + panel.id + ", view.type = " + view.type;
|
|
}
|
|
|
|
if (!view.itemType) {
|
|
if (view.type == View.LIST) {
|
|
// Use ARTICLE item type by default in LIST views
|
|
view.itemType = Item.ARTICLE;
|
|
} else if (view.type == View.GRID) {
|
|
// Use IMAGE item type by default in GRID views
|
|
view.itemType = Item.IMAGE;
|
|
}
|
|
} else if (!_valueExists(Item, view.itemType)) {
|
|
throw "Home.panels: Invalid item type: panel.id = " + panel.id + ", view.itemType = " + view.itemType;
|
|
}
|
|
|
|
if (!view.itemHandler) {
|
|
// Use BROWSER item handler by default
|
|
view.itemHandler = ItemHandler.BROWSER;
|
|
} else if (!_valueExists(ItemHandler, view.itemHandler)) {
|
|
throw "Home.panels: Invalid item handler: panel.id = " + panel.id + ", view.itemHandler = " + view.itemHandler;
|
|
}
|
|
|
|
if (!view.dataset) {
|
|
throw "Home.panels: No dataset provided for view: panel.id = " + panel.id + ", view.type = " + view.type;
|
|
}
|
|
}
|
|
|
|
return panel;
|
|
};
|
|
|
|
handlePanelsGet = function(data) {
|
|
let requestId = data.requestId;
|
|
let ids = data.ids || null;
|
|
|
|
let panels = [];
|
|
for (let id in _registeredPanels) {
|
|
// Null ids means we want to fetch all available panels
|
|
if (ids == null || ids.indexOf(id) >= 0) {
|
|
try {
|
|
panels.push(_generatePanel(id));
|
|
} catch(e) {
|
|
Cu.reportError("Home.panels: Invalid options, panel.id = " + id + ": " + e);
|
|
}
|
|
}
|
|
}
|
|
|
|
sendMessageToJava({
|
|
type: "HomePanels:Data",
|
|
panels: panels,
|
|
requestId: requestId
|
|
});
|
|
};
|
|
|
|
// Helper function used to see if a value is in an object.
|
|
let _valueExists = function(obj, value) {
|
|
for (let key in obj) {
|
|
if (obj[key] == value) {
|
|
return true;
|
|
}
|
|
}
|
|
return false;
|
|
};
|
|
|
|
let _assertPanelExists = function(id) {
|
|
if (!(id in _registeredPanels)) {
|
|
throw "Home.panels: Panel doesn't exist: id = " + id;
|
|
}
|
|
};
|
|
|
|
return Object.freeze({
|
|
Layout: Layout,
|
|
View: View,
|
|
Item: Item,
|
|
ItemHandler: ItemHandler,
|
|
|
|
register: function(id, optionsCallback) {
|
|
// Bail if the panel already exists
|
|
if (id in _registeredPanels) {
|
|
throw "Home.panels: Panel already exists: id = " + id;
|
|
}
|
|
|
|
if (!optionsCallback || typeof optionsCallback !== "function") {
|
|
throw "Home.panels: Panel callback must be a function: id = " + id;
|
|
}
|
|
|
|
_registeredPanels[id] = optionsCallback;
|
|
},
|
|
|
|
unregister: function(id) {
|
|
_assertPanelExists(id);
|
|
|
|
delete _registeredPanels[id];
|
|
},
|
|
|
|
install: function(id) {
|
|
_assertPanelExists(id);
|
|
|
|
sendMessageToJava({
|
|
type: "HomePanels:Install",
|
|
panel: _generatePanel(id)
|
|
});
|
|
},
|
|
|
|
uninstall: function(id) {
|
|
_assertPanelExists(id);
|
|
|
|
sendMessageToJava({
|
|
type: "HomePanels:Uninstall",
|
|
id: id
|
|
});
|
|
},
|
|
|
|
update: function(id) {
|
|
_assertPanelExists(id);
|
|
|
|
sendMessageToJava({
|
|
type: "HomePanels:Update",
|
|
panel: _generatePanel(id)
|
|
});
|
|
}
|
|
});
|
|
})();
|
|
|
|
// Public API
|
|
this.Home = Object.freeze({
|
|
banner: HomeBanner,
|
|
panels: HomePanels,
|
|
|
|
// Lazy notification observer registered in browser.js
|
|
observe: function(subject, topic, data) {
|
|
switch(topic) {
|
|
case "HomePanels:Get":
|
|
handlePanelsGet(JSON.parse(data));
|
|
break;
|
|
}
|
|
}
|
|
});
|