/* 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/. */
import {
classMap,
html,
ifDefined,
when,
} from "chrome://global/content/vendor/lit.all.mjs";
import { MozLitElement } from "chrome://global/content/lit-utils.mjs";
/**
* A collapsible card container to be used throughout Firefox View
*
* @property {string} sectionLabel - The aria-label used for the section landmark if the header is hidden with hideHeader
* @property {boolean} hideHeader - Optional property given if the card container should not display a header
* @property {boolean} isEmptyState - Optional property given if the card is used within an empty state
* @property {boolean} isInnerCard - Optional property given if the card a nested card within another card and given a border rather than box-shadow
* @property {boolean} preserveCollapseState - Whether or not the expanded/collapsed state should persist
* @property {string} shortPageName - Page name that the 'View all' link will navigate to and the preserveCollapseState pref will use
* @property {boolean} showViewAll - True if you need to display a 'View all' header link to navigate
* @property {boolean} toggleDisabled - Optional property given if the card container should not be collapsible
* @property {boolean} removeBlockEndMargin - True if you need to remove the block end margin on the card container
*/
class CardContainer extends MozLitElement {
constructor() {
super();
this.initiallyExpanded = true;
this.isExpanded = false;
this.visible = false;
}
static properties = {
sectionLabel: { type: String },
hideHeader: { type: Boolean },
isExpanded: { type: Boolean },
isEmptyState: { type: Boolean },
isInnerCard: { type: Boolean },
preserveCollapseState: { type: Boolean },
shortPageName: { type: String },
showViewAll: { type: Boolean },
toggleDisabled: { type: Boolean },
removeBlockEndMargin: { type: Boolean },
visible: { type: Boolean },
};
static queries = {
detailsEl: "details",
mainSlot: "slot[name=main]",
summaryEl: "summary",
viewAllLink: ".view-all-link",
};
get detailsExpanded() {
return this.detailsEl.hasAttribute("open");
}
get detailsOpenPrefValue() {
const prefName = this.shortPageName
? `browser.tabs.firefox-view.ui-state.${this.shortPageName}.open`
: null;
if (prefName && Services.prefs.prefHasUserValue(prefName)) {
return Services.prefs.getBoolPref(prefName);
}
return null;
}
connectedCallback() {
super.connectedCallback();
this.isExpanded = this.detailsOpenPrefValue ?? this.initiallyExpanded;
}
onToggleContainer() {
if (this.isExpanded == this.detailsExpanded) {
return;
}
this.isExpanded = this.detailsExpanded;
this.updateTabLists();
if (!this.shortPageName) {
return;
}
if (this.preserveCollapseState) {
const prefName = this.shortPageName
? `browser.tabs.firefox-view.ui-state.${this.shortPageName}.open`
: null;
Services.prefs.setBoolPref(prefName, this.isExpanded);
}
// Record telemetry
Services.telemetry.recordEvent(
"firefoxview_next",
this.isExpanded ? "card_expanded" : "card_collapsed",
"card_container",
null,
{
data_type: this.shortPageName,
}
);
}
viewAllClicked() {
this.dispatchEvent(
new CustomEvent("card-container-view-all", {
bubbles: true,
composed: true,
})
);
}
willUpdate(changes) {
if (changes.has("visible")) {
this.updateTabLists();
}
}
updateTabLists() {
let tabLists = this.querySelectorAll("fxview-tab-list");
if (tabLists) {
tabLists.forEach(tabList => {
tabList.updatesPaused = !this.visible || !this.isExpanded;
});
}
}
render() {
return html`
${when(
this.toggleDisabled,
() => html`