/* 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";
{
class PanelList extends HTMLElement {
static get observedAttributes() {
return ["open"];
}
static get fragment() {
if (!this._template) {
let parser = new DOMParser();
let doc = parser.parseFromString(
`
`,
"text/html"
);
this._template = document.importNode(
doc.querySelector("template"),
true
);
}
let frag = this._template.content.cloneNode(true);
if (window.IS_STORYBOOK) {
frag.querySelector("link").href = "./panel-list.css";
}
return frag;
}
constructor() {
super();
this.attachShadow({ mode: "open" });
// Ensure that the element is hidden even if its main stylesheet hasn't
// loaded yet. On initial load, or with cache disabled, the element could
// briefly flicker before the stylesheet is loaded without this.
let style = document.createElement("style");
style.textContent = `
:host(:not([open])) {
display: none;
}
`;
this.shadowRoot.appendChild(style);
this.shadowRoot.appendChild(this.constructor.fragment);
}
connectedCallback() {
this.setAttribute("role", "menu");
}
attributeChangedCallback(name, oldVal, newVal) {
if (name == "open" && newVal != oldVal) {
if (this.open) {
this.onShow();
} else {
this.onHide();
}
}
}
get open() {
return this.hasAttribute("open");
}
set open(val) {
this.toggleAttribute("open", val);
}
getTargetForEvent(event) {
if (!event) {
return null;
}
if (event.composed) {
event._savedComposedTarget =
event.composedTarget || event.composedPath()[0];
}
if (event._savedComposedTarget) {
return event._savedComposedTarget;
}
return event.target;
}
show(triggeringEvent) {
this.triggeringEvent = triggeringEvent;
this.lastAnchorNode = this.getTargetForEvent(this.triggeringEvent);
this.wasOpenedByKeyboard =
triggeringEvent &&
(triggeringEvent.mozInputSource == MouseEvent.MOZ_SOURCE_KEYBOARD ||
triggeringEvent.mozInputSource == MouseEvent.MOZ_SOURCE_UNKNOWN);
this.open = true;
}
hide(triggeringEvent, { force = false } = {}) {
// It's possible this is being used in an unprivileged context, in which
// case it won't have access to Services / Services will be undeclared.
const autohideDisabled = this.hasServices()
? Services.prefs.getBoolPref("ui.popup.disable_autohide", false)
: false;
if (autohideDisabled && !force) {
// Don't hide if this wasn't "forced" (using escape or click in menu).
return;
}
let openingEvent = this.triggeringEvent;
this.triggeringEvent = triggeringEvent;
this.open = false;
let target = this.getTargetForEvent(openingEvent);
// Refocus the button that opened the menu if we have one.
if (target && this.wasOpenedByKeyboard) {
target.focus();
}
}
toggle(triggeringEvent) {
if (this.open) {
this.hide(triggeringEvent, { force: true });
} else {
this.show(triggeringEvent);
}
}
hasServices() {
// Safely check for Services without throwing a ReferenceError.
return typeof Services !== "undefined";
}
isDocumentRTL() {
if (this.hasServices()) {
return Services.locale.isAppLocaleRTL;
}
return document.dir === "rtl";
}
async setAlign() {
if (!this.parentElement) {
// This could get called before we're added to the DOM.
// Nothing to do in that case.
return;
}
// Set the showing attribute to hide the panel until its alignment is set.
this.setAttribute("showing", "true");
// Tell the parent node to hide any overflow in case the panel extends off
// the page before the alignment is set.
this.parentElement.style.overflow = "hidden";
// Wait for a layout flush, then find the bounds.
let {
anchorHeight,
anchorLeft,
anchorTop,
anchorWidth,
panelHeight,
panelWidth,
winHeight,
winScrollY,
winScrollX,
winWidth,
} = await new Promise(resolve => {
this.style.left = 0;
this.style.top = 0;
requestAnimationFrame(() =>
setTimeout(() => {
let target = this.getTargetForEvent(this.triggeringEvent);
let anchorNode = target || this.parentElement;
// It's possible this is being used in a context where windowUtils is
// not available. In that case, fallback to using the element.
let getBounds = el =>
window.windowUtils
? window.windowUtils.getBoundsWithoutFlushing(el)
: el.getBoundingClientRect();
// Use y since top is reserved.
let anchorBounds = getBounds(anchorNode);
let panelBounds = getBounds(this);
resolve({
anchorHeight: anchorBounds.height,
anchorLeft: anchorBounds.left,
anchorTop: anchorBounds.top,
anchorWidth: anchorBounds.width,
panelHeight: panelBounds.height,
panelWidth: panelBounds.width,
winHeight: innerHeight,
winWidth: innerWidth,
winScrollX: scrollX,
winScrollY: scrollY,
});
}, 0)
);
});
// Calculate the left/right alignment.
let align;
let leftOffset;
let leftAlignX = anchorLeft;
let rightAlignX = anchorLeft + anchorWidth - panelWidth;
if (this.isDocumentRTL()) {
// Prefer aligning on the right.
align = rightAlignX < 0 ? "left" : "right";
} else {
// Prefer aligning on the left.
align = leftAlignX + panelWidth > winWidth ? "right" : "left";
}
leftOffset = align === "left" ? leftAlignX : rightAlignX;
let bottomAlignY = anchorTop + anchorHeight;
let valign;
let topOffset;
if (bottomAlignY + panelHeight > winHeight) {
topOffset = anchorTop - panelHeight;
valign = "top";
} else {
topOffset = bottomAlignY;
valign = "bottom";
}
// Set the alignments and show the panel.
this.setAttribute("align", align);
this.setAttribute("valign", valign);
this.parentElement.style.overflow = "";
this.style.left = `${leftOffset + winScrollX}px`;
this.style.top = `${topOffset + winScrollY}px`;
this.removeAttribute("showing");
}
addHideListeners() {
if (this.hasAttribute("stay-open")) {
// This is intended for inspection in Storybook.
return;
}
// Hide when a panel-item is clicked in the list.
this.addEventListener("click", this);
document.addEventListener("keydown", this);
// Hide when a click is initiated outside the panel.
document.addEventListener("mousedown", this);
// Hide if focus changes and the panel isn't in focus.
document.addEventListener("focusin", this);
// Reset or focus tracking, we treat the first focusin differently.
this.focusHasChanged = false;
// Hide on resize, scroll or losing window focus.
window.addEventListener("resize", this);
window.addEventListener("scroll", this, { capture: true });
window.addEventListener("blur", this);
}
removeHideListeners() {
this.removeEventListener("click", this);
document.removeEventListener("keydown", this);
document.removeEventListener("mousedown", this);
document.removeEventListener("focusin", this);
window.removeEventListener("resize", this);
window.removeEventListener("scroll", this, { capture: true });
window.removeEventListener("blur", this);
}
handleEvent(e) {
// Ignore the event if it caused the panel to open.
if (e == this.triggeringEvent) {
return;
}
let target = this.getTargetForEvent(e);
let inPanelList = e.composed
? e.composedPath().some(el => el == this)
: e.target.closest && e.target.closest("panel-list") == this;
switch (e.type) {
case "resize":
case "scroll":
case "blur":
this.hide();
break;
case "click":
if (inPanelList) {
this.hide(undefined, { force: true });
} else {
// Avoid falling through to the default click handler of the parent.
e.stopPropagation();
}
break;
case "mousedown":
// Close if there's a click started outside the panel.
if (!inPanelList) {
this.hide();
}
break;
case "keydown":
if (e.key === "ArrowDown" || e.key === "ArrowUp" || e.key === "Tab") {
// Ignore tabbing with a modifer other than shift.
if (e.key === "Tab" && (e.altKey || e.ctrlKey || e.metaKey)) {
return;
}
// Don't scroll the page or let the regular tab order take effect.
e.preventDefault();
// Keep moving to the next/previous element sibling until we find a
// panel-item that isn't hidden.
let moveForward =
e.key === "ArrowDown" || (e.key === "Tab" && !e.shiftKey);
// If the menu is opened with the mouse, the active element might be
// somewhere else in the document. In that case we should ignore it
// to avoid walking unrelated DOM nodes.
this.focusWalker.currentNode = this.contains(
this.getRootNode().activeElement
)
? this.getRootNode().activeElement
: this;
let nextItem = moveForward
? this.focusWalker.nextNode()
: this.focusWalker.previousNode();
// If the next item wasn't found, try looping to the top/bottom.
if (!nextItem) {
this.focusWalker.currentNode = this;
if (moveForward) {
nextItem = this.focusWalker.firstChild();
} else {
nextItem = this.focusWalker.lastChild();
}
}
break;
} else if (e.key === "Escape") {
this.hide(undefined, { force: true });
} else if (!e.metaKey && !e.ctrlKey && !e.shiftKey && !e.altKey) {
// Check if any of the children have an accesskey for this letter.
let item = this.querySelector(
`[accesskey="${e.key.toLowerCase()}"],
[accesskey="${e.key.toUpperCase()}"]`
);
if (item) {
item.click();
}
}
break;
case "focusin":
if (
this.triggeringEvent &&
target == this.getTargetForEvent(this.triggeringEvent) &&
!this.focusHasChanged
) {
// There will be a focusin after the mousedown that opens the panel
// using the mouse. Ignore the first focusin event if it's on the
// triggering target.
this.focusHasChanged = true;
} else if (!target || !inPanelList) {
// If the target isn't in the panel, hide. This will close when focus
// moves out of the panel.
this.hide();
} else {
// Just record that there was a focusin event.
this.focusHasChanged = true;
}
break;
}
}
/**
* A TreeWalker that can be used to focus elements. The returned element will
* be the element that has gained focus based on the requested movement
* through the tree.
*
* Example:
*
* this.focusWalker.currentNode = this;
* // Focus and get the first focusable child.
* let focused = this.focusWalker.nextNode();
* // Focus the second focusable child.
* this.focusWalker.nextNode();
*/
get focusWalker() {
if (!this._focusWalker) {
this._focusWalker = document.createTreeWalker(
this,
NodeFilter.SHOW_ELEMENT,
{
acceptNode: node => {
// No need to look at hidden nodes.
if (node.hidden) {
return NodeFilter.FILTER_REJECT;
}
// Focus the node, if it worked then this is the node we want.
node.focus();
if (node === node.getRootNode().activeElement) {
return NodeFilter.FILTER_ACCEPT;
}
// Continue into child nodes if the parent couldn't be focused.
return NodeFilter.FILTER_SKIP;
},
}
);
}
return this._focusWalker;
}
async onShow() {
this.sendEvent("showing");
this.addHideListeners();
await this.setAlign();
// Wait until the next paint for the alignment to be set and panel to be
// visible.
requestAnimationFrame(() => {
if (this.wasOpenedByKeyboard) {
// Focus the first focusable panel-item if opened by keyboard.
this.focusWalker.currentNode = this;
this.focusWalker.nextNode();
}
this.lastAnchorNode?.setAttribute("aria-expanded", "true");
this.sendEvent("shown");
});
}
onHide() {
requestAnimationFrame(() => {
this.sendEvent("hidden");
this.lastAnchorNode?.setAttribute("aria-expanded", "false");
});
this.removeHideListeners();
}
sendEvent(name, detail) {
this.dispatchEvent(new CustomEvent(name, { detail }));
}
}
customElements.define("panel-list", PanelList);
class PanelItem extends HTMLElement {
static get observedAttributes() {
return ["accesskey"];
}
constructor() {
super();
this.attachShadow({ mode: "open" });
let style = document.createElement("link");
style.rel = "stylesheet";
style.href = window.IS_STORYBOOK
? "./panel-item.css"
: "chrome://global/content/elements/panel-item.css";
// When click listeners are added to the panel-item it creates a node in
// the a11y tree for this element. This breaks the association between the
// menu and the button[role="menuitem"] in this shadow DOM and causes
// announcement issues with screen readers. (bug 995064)
this.setAttribute("role", "presentation");
this.button = document.createElement("button");
this.button.setAttribute("role", "menuitem");
this.button.setAttribute("part", "button");
// Use a XUL label element if possible to show the accesskey.
this.label = document.createXULElement
? document.createXULElement("label")
: document.createElement("span");
this.button.appendChild(this.label);
let supportLinkSlot = document.createElement("slot");
supportLinkSlot.name = "support-link";
let defaultSlot = document.createElement("slot");
defaultSlot.style.display = "none";
this.shadowRoot.append(style, this.button, supportLinkSlot, defaultSlot);
this.setLabelContents = () => {
this.label.textContent = defaultSlot
.assignedNodes()
.map(node => node.textContent)
.join("");
};
this.setLabelContents();
// When our content changes, move the text into the label. It doesn't work
// with a , unfortunately.
new MutationObserver(this.setLabelContents).observe(this, {
characterData: true,
childList: true,
subtree: true,
});
}
connectedCallback() {
this.panel = this.closest("panel-list");
if (this.panel) {
this.panel.addEventListener("hidden", this);
this.panel.addEventListener("shown", this);
}
}
disconnectedCallback() {
if (this.panel) {
this.panel.removeEventListener("hidden", this);
this.panel.removeEventListener("shown", this);
this.panel = null;
}
}
attributeChangedCallback(name, oldVal, newVal) {
if (name === "accesskey") {
// Bug 1037709 - Accesskey doesn't work in shadow DOM.
// Ideally we'd have the accesskey set in shadow DOM, and on
// attributeChangedCallback we'd just update the shadow DOM accesskey.
// Skip this change event if we caused it.
if (this._modifyingAccessKey) {
this._modifyingAccessKey = false;
return;
}
this.label.accessKey = newVal || "";
// Bug 1588156 - Accesskey is not ignored for hidden non-input elements.
// Since the accesskey won't be ignored, we need to remove it ourselves
// when the panel is closed, and move it back when it opens.
if (!this.panel || !this.panel.open) {
// When the panel isn't open, just store the key for later.
this._accessKey = newVal || null;
this._modifyingAccessKey = true;
this.accessKey = "";
} else {
this._accessKey = null;
}
}
}
get disabled() {
return this.button.hasAttribute("disabled");
}
set disabled(val) {
this.button.toggleAttribute("disabled", val);
}
get checked() {
return this.hasAttribute("checked");
}
set checked(val) {
this.toggleAttribute("checked", val);
}
focus() {
this.button.focus();
}
handleEvent(e) {
// Bug 1588156 - Accesskey is not ignored for hidden non-input elements.
// Since the accesskey won't be ignored, we need to remove it ourselves
// when the panel is closed, and move it back when it opens.
switch (e.type) {
case "shown":
if (this._accessKey) {
this.accessKey = this._accessKey;
this._accessKey = null;
}
break;
case "hidden":
if (this.accessKey) {
this._accessKey = this.accessKey;
this._modifyingAccessKey = true;
this.accessKey = "";
}
break;
}
}
}
customElements.define("panel-item", PanelItem);
}