Source code
Revision control
Copy as Markdown
Other Tools
/* 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
"use strict";
const EventEmitter = require("resource://devtools/shared/event-emitter.js");
function ToolSidebar(tabbox, panel, uid, options = {}) {
EventEmitter.decorate(this);
this._tabbox = tabbox;
this._uid = uid;
this._panelDoc = this._tabbox.ownerDocument;
this._toolPanel = panel;
this._options = options;
if (!options.disableTelemetry) {
this._telemetry = this._toolPanel.telemetry;
}
this._tabs = [];
if (this._options.hideTabstripe) {
this._tabbox.setAttribute("hidetabs", "true");
}
this.render();
this._toolPanel.emit("sidebar-created", this);
}
exports.ToolSidebar = ToolSidebar;
ToolSidebar.prototype = {
TABPANEL_ID_PREFIX: "sidebar-panel-",
// React
get React() {
return this._toolPanel.React;
},
get ReactDOM() {
return this._toolPanel.ReactDOM;
},
get browserRequire() {
return this._toolPanel.browserRequire;
},
get InspectorTabPanel() {
return this._toolPanel.InspectorTabPanel;
},
get TabBar() {
return this._toolPanel.TabBar;
},
// Rendering
render() {
const sidebar = this.TabBar({
menuDocument: this._toolPanel._toolbox.doc,
showAllTabsMenu: true,
allTabsMenuButtonTooltip: this._options.allTabsMenuButtonTooltip,
sidebarToggleButton: this._options.sidebarToggleButton,
onSelect: this.handleSelectionChange.bind(this),
});
this._tabbar = this.ReactDOM.render(sidebar, this._tabbox);
},
/**
* Adds all the queued tabs.
*/
addAllQueuedTabs() {
this._tabbar.addAllQueuedTabs();
},
/**
* Register a side-panel tab.
*
* @param {String} tab uniq id
* @param {String} title tab title
* @param {React.Component} panel component. See `InspectorPanelTab` as an example.
* @param {Boolean} selected true if the panel should be selected
* @param {Number} index the position where the tab should be inserted
*/
addTab(id, title, panel, selected, index) {
this._tabbar.addTab(id, title, selected, panel, null, index);
this.emit("new-tab-registered", id);
},
/**
* Helper API for adding side-panels that use existing DOM nodes
* (defined within inspector.xhtml) as the content.
*
* @param {String} tab uniq id
* @param {String} title tab title
* @param {Boolean} selected true if the panel should be selected
* @param {Number} index the position where the tab should be inserted
*/
addExistingTab(id, title, selected, index) {
const panel = this.InspectorTabPanel({
id,
idPrefix: this.TABPANEL_ID_PREFIX,
key: id,
title,
});
this.addTab(id, title, panel, selected, index);
},
/**
* Queues a side-panel tab to be added..
*
* @param {String} tab uniq id
* @param {String} title tab title
* @param {React.Component} panel component. See `InspectorPanelTab` as an example.
* @param {Boolean} selected true if the panel should be selected
* @param {Number} index the position where the tab should be inserted
*/
queueTab(id, title, panel, selected, index) {
this._tabbar.queueTab(id, title, selected, panel, null, index);
this.emit("new-tab-registered", id);
},
/**
* Helper API for queuing side-panels that use existing DOM nodes
* (defined within inspector.xhtml) as the content.
*
* @param {String} tab uniq id
* @param {String} title tab title
* @param {Boolean} selected true if the panel should be selected
* @param {Number} index the position where the tab should be inserted
*/
queueExistingTab(id, title, selected, index) {
const panel = this.InspectorTabPanel({
id,
idPrefix: this.TABPANEL_ID_PREFIX,
key: id,
title,
});
this.queueTab(id, title, panel, selected, index);
},
/**
* Remove an existing tab.
* @param {String} tabId The ID of the tab that was used to register it, or
* the tab id attribute value if the tab existed before the sidebar
* got created.
*/
removeTab(tabId) {
this._tabbar.removeTab(tabId);
this.emit("tab-unregistered", tabId);
},
/**
* Show or hide a specific tab.
* @param {Boolean} isVisible True to show the tab/tabpanel, False to hide it.
* @param {String} id The ID of the tab to be hidden.
*/
toggleTab(isVisible, id) {
this._tabbar.toggleTab(id, isVisible);
},
/**
* Select a specific tab.
*/
select(id) {
this._tabbar.select(id);
},
/**
* Return the id of the selected tab.
*/
getCurrentTabID() {
return this._currentTool;
},
/**
* Returns the requested tab panel based on the id.
* @param {String} id
* @return {DOMNode}
*/
getTabPanel(id) {
// Search with and without the ID prefix as there might have been existing
// tabpanels by the time the sidebar got created
return this._panelDoc.querySelector(
"#" + this.TABPANEL_ID_PREFIX + id + ", #" + id
);
},
/**
* Event handler.
*/
handleSelectionChange(id) {
if (this._destroyed) {
return;
}
const previousTool = this._currentTool;
if (previousTool) {
this.emit(previousTool + "-unselected");
}
this._currentTool = id;
this.updateTelemetryOnChange(id, previousTool);
this.emit(this._currentTool + "-selected");
this.emit("select", this._currentTool);
},
/**
* Log toolClosed and toolOpened events on telemetry.
*
* @param {String} currentToolId
* id of the tool being selected.
* @param {String} previousToolId
* id of the previously selected tool.
*/
updateTelemetryOnChange(currentToolId, previousToolId) {
if (currentToolId === previousToolId || !this._telemetry) {
// Skip telemetry if the tool id did not change or telemetry is unavailable.
return;
}
currentToolId = this.getTelemetryPanelNameOrOther(currentToolId);
if (previousToolId) {
previousToolId = this.getTelemetryPanelNameOrOther(previousToolId);
this._telemetry.toolClosed(previousToolId, this);
this._telemetry.recordEvent("sidepanel_changed", "inspector", null, {
oldpanel: previousToolId,
newpanel: currentToolId,
os: this._telemetry.osNameAndVersion,
});
}
this._telemetry.toolOpened(currentToolId, this);
},
/**
* Returns a panel id in the case of built in panels or "other" in the case of
* third party panels. This is necessary due to limitations in addon id strings,
* the permitted length of event telemetry property values and what we actually
* want to see in our telemetry.
*
* @param {String} id
* The panel id we would like to process.
*/
getTelemetryPanelNameOrOther(id) {
if (!this._toolNames) {
// Get all built in tool ids. We identify third party tool ids by checking
// for a "-", which shows it originates from an addon.
const ids = this._tabbar.state.tabs.map(({ id: toolId }) => {
return toolId.includes("-") ? "other" : toolId;
});
this._toolNames = new Set(ids);
}
if (!this._toolNames.has(id)) {
return "other";
}
return id;
},
/**
* Show the sidebar.
*
* @param {String} id
* The sidebar tab id to select.
*/
show(id) {
this._tabbox.hidden = false;
// If an id is given, select the corresponding sidebar tab.
if (id) {
this.select(id);
}
this.emit("show");
},
/**
* Show the sidebar.
*/
hide() {
this._tabbox.hidden = true;
this.emit("hide");
},
/**
* Clean-up.
*/
destroy() {
if (this._destroyed) {
return;
}
this._destroyed = true;
this.emit("destroy");
if (this._currentTool && this._telemetry) {
this._telemetry.toolClosed(this._currentTool, this);
}
this._toolPanel.emit("sidebar-destroyed", this);
this.ReactDOM.unmountComponentAtNode(this._tabbox);
this._tabs = null;
this._tabbox = null;
this._telemetry = null;
this._panelDoc = null;
this._toolPanel = null;
},
};