/** * EGroupware eTemplate2 - Box widget * * @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License * @package etemplate * @subpackage api * @link https://www.egroupware.org * @author Nathan Gray */ import {SlTab, SlTabGroup, SlTabPanel} from "@shoelace-style/shoelace"; import {loadWebComponent} from "../../Et2Widget/Et2Widget"; import {et2_directChildrenByTagName, et2_filteredNodeIterator, et2_readAttrWithDefault} from "../../et2_core_xml"; import {css, PropertyValues} from "lit"; import shoelace from "../../Styles/shoelace"; import {et2_createWidget} from "../../et2_core_widget"; import {colorsDefStyles} from "../../Styles/colorsDefStyles"; import {Et2InputWidget} from "../../Et2InputWidget/Et2InputWidget"; import {et2_IResizeable} from "../../et2_core_interfaces"; export class Et2Tabs extends Et2InputWidget(SlTabGroup) implements et2_IResizeable { static get styles() { return [ ...super.styles, colorsDefStyles, ...shoelace, //keyframes definition can't get into shadow root from css files, so we declare it here css` /*scroll detection detect if scrollbar is available scroll detection only works in chromium not in Firefox or Safari*/ @keyframes detect-scroll { from, to { --can-scroll:0;} } .tab-group--top { height: 100%; min-height: fit-content; } .tab-group__body { flex: 1 1 auto; overflow: hidden auto; } .tab-group__body-fixed-height { flex: 0 0 auto; } ::slotted([hidden]) { display: none; } ::slotted(et2-tab-panel) { flex: 1 1 auto; } ::slotted(et2-tab-panel:not([active])) { display: none; } ` ]; } static get properties() { return { ...super.properties, /** * Array of [extra] tabs. * Each tab needs {label:..., template:...}. * Additional optional keys are prepend, hidden and id, for access into content array */ extraTabs: {type: Object}, /** * Add tabs to template * Set to true if tabs specified in tabs property should be added to tabs read from template, * default false if not which replaces what's in template */ addTabs: {type: Boolean}, /** * Set the height for tabs * Leave unset to size automatically from either parent height attribute, or height of first tabpanel * Set to 'auto' to allow tab height to flex to fill parent element */ tabHeight: {type: String}, /** * @deprecated use "placement" instead * @see https://shoelace.style/components/tab-group */ alignTabs: {type: String}, /** * active tab is the value */ value: {type: String} } } /** * Index of currently selected tab * @type {number} * @private */ protected _selectedIndex = -1; protected tabData = []; protected lazyLoaded = false; constructor() { super(); this.extraTabs = []; this.addTabs = false; if (egwIsMobile()) { this.placement = 'end'; } } get value() { return this.getActiveTab()?.panel; } set value(tab) { if (this.tabs && Array.isArray(this.tabs) && this.tabs.length) { this.show(this.__value = tab); } else { this.__value = tab; } } connectedCallback() { super.connectedCallback(); this.updateComplete.then(() => { if (this.__value) { this.show(this.__value); } }); } isDirty(): boolean { return false; } loadFromXML(_node) { // Get the tabs and tabpanels tags const tabsElems = et2_directChildrenByTagName(_node, "tabs"); const tabpanelsElems = et2_directChildrenByTagName(_node, "tabpanels"); const tabData = []; // Check for a parent height, we'll apply it to tab panels var height = et2_readAttrWithDefault(_node.parentNode, "height", null); if(height && !this.tabHeight) { this.tabHeight = height; } // if no tabs set or they should be added to tabs from xml if(!this.extraTabs || this.extraTabs.length == 0 || this.addTabs) { if(tabsElems.length == 1 && tabpanelsElems.length == 1) { var tabs = tabsElems[0]; var tabpanels = tabpanelsElems[0]; // Parse the "tabs" tag this._readTabs(tabData, tabs); // Read and create the widgets defined in the "tabpanels" this._readTabPanels(tabData, tabpanels); } else { this.egw().debug("error", "Error while parsing tabbox, none or multiple tabs or tabpanels tags!", this); } } // Add in additional tabs if(this.extraTabs) { let readonly = this.getArrayMgr("readonlys").getEntry(this.id) || {}; for(let i = 0; i < this.extraTabs.length; i++) { let tab = this.extraTabs[i]; let tab_id = tab.id || tab.template; let tab_options = {id: tab_id, template: tab.template, url: tab.url, content: tab.content, title: tab.statustext}; let pos = tabData.length; if (typeof tab.prepend === "string") { if ((pos = tabData.findIndex(t => t.id === tab.prepend)) === -1) { pos = tabData.length; } } else if (tab.prepend) { pos = 0; } tabData.splice(pos, 0, { "id": tab_id, "label": this.egw().lang(tab.label), "widget": null, "widget_options": tab_options, "contentDiv": null, "flagDiv": null, "hidden": typeof tab.hidden != "undefined" ? tab.hidden : readonly[tab_id] || false, "XMLNode": null, "promise": null }); } } // Create the tab DOM-Nodes this.createTabs(tabData); // Use the height of the first tab if height not set this._sizeTabs(tabData); // Load any additional child nodes for(let i = 0; i < _node.childNodes.length; i++) { let node = _node.childNodes[i]; let widgetType = node.nodeName.toLowerCase(); // Skip text & already handled nodes if(["#comment", "#text", "tabs", "tabpanels"].includes(widgetType)) { continue; } // Create the new element this.createElementFromNode(node); } } /** * Use the height of the first tab if height not set * @protected */ protected _sizeTabs(tabData : Array) { if(!this.tabHeight && tabData.length > 0) { const firstTab = tabData[0].contentDiv; firstTab.updateComplete.then(async() => { // Wait for children to load let wait = []; let walk = (widget) => { if(widget.loading) { wait.push(widget.loading); } wait.push(widget.updateComplete); widget.getChildren().forEach(child => walk(child)); } walk(firstTab); await Promise.all(wait); const maxHeight = getComputedStyle(this.shadowRoot.querySelector('.tab-group__body')).height; const initial = firstTab.hasAttribute("active"); firstTab.setAttribute("active", ''); const tabHeight = getComputedStyle(firstTab).height; if (parseInt(maxHeight) > 50 && parseInt(maxHeight) < parseInt(tabHeight)) //there was a reasonable max height set { this.tabHeight = maxHeight; } else if(maxHeight != '0px'){ //max height was set but is unreasonable small this.tabHeight = '86vh' // use most of available space, but not all so Tabbox header fits too, and does not need second scrollbar } else { this.tabHeight = tabHeight; } if(!initial) { firstTab.removeAttribute("active"); } }) } } _readTabs(tabData, tabs) { let selected = ""; this._selectedIndex = -1; let hidden = {}; if(this.id) { // Set the value for this element let contentMgr = this.getArrayMgr("content"); if(contentMgr != null) { let val = contentMgr.getEntry(this.id); if(val !== null) { selected = val; } } contentMgr = this.getArrayMgr("readonlys"); if(contentMgr != null) { let val = contentMgr.getEntry(this.id); if(val !== null && typeof val !== 'undefined') { hidden = val; } } } let i = 0; et2_filteredNodeIterator(tabs, function(node, nodeName) { if(nodeName == "tab") { const index_name = et2_readAttrWithDefault(node, "id", ''); const hide = et2_readAttrWithDefault(node, "hidden", hidden[index_name]); var widget_options = {}; if(index_name) { if(selected == index_name) { this.selected_index = i; } // Get the class attribute and add it as widget_options const classAttr = et2_readAttrWithDefault(node, "class", ''); if(classAttr) { widget_options = {'class': classAttr}; } } tabData.push({ "id": index_name, "label": this.egw().lang(et2_readAttrWithDefault(node, "label", "Tab")), "onclick": et2_readAttrWithDefault(node, "onclick", ''), "ondblclick": et2_readAttrWithDefault(node, "ondblclick", ''), "widget": null, "widget_options": widget_options, "contentDiv": null, "flagDiv": null, "tabNode": node, "hidden": et2_readAttrWithDefault(node, "hidden", hidden[index_name] ?? false), "disabled": et2_readAttrWithDefault(node, "disabled", false), "XMLNode": null, "promise": null }); } else { throw("Error while parsing: Invalid tag '" + nodeName + "' in tabs tag"); } i++; }, this); // Make sure we don't try to display a hidden tab for(let i = 0; i < tabData.length && this._selectedIndex < 0; i++) { if(!tabData[i].hidden) { this._selectedIndex = i; } } } _readTabPanels(tabData, tabpanels) { var i = 0; et2_filteredNodeIterator(tabpanels, function(node, nodeName) { if(i < tabData.length) { // Store node for later evaluation tabData[i].XMLNode = node; } else { throw("Error while reading tabpanels tag, too many widgets!"); } i++; }, this); } protected update(changedProperties : PropertyValues) { super.update(changedProperties); if(changedProperties.has("tabHeight")) { const body = this.shadowRoot.querySelector(".tab-group__body"); if(body) { body.style.setProperty("height", this.tabHeight == parseInt(this.tabHeight) + "" ? this.tabHeight + "px" : this.tabHeight); body.classList.toggle("tab-group__body-fixed-height", this.tabHeight !== '' && this.tabHeight !== 'auto'); } } } /** * Create the nodes for tabs * * @param tabData * @protected */ protected createTabs(tabData) { this.tabData = tabData; tabData.forEach((tab, index) => { // Tab - SlTabGroup looks for sl-tab, so we can't use our own without overriding a lot tab.flagDiv = loadWebComponent("et2-tab", { slot: "nav", panel: tab.id, active: index == this._selectedIndex, hidden: tab.hidden, disabled: tab.disabled, onclick: tab.onclick, ondblclick: tab.ondblclick }, this); // Set tab label const node = document.createElement("span") node.appendChild(document.createTextNode(tab.label)); node.classList.add("tabLabel") tab.flagDiv.appendChild(node); if(tab.tabNode && tab.tabNode.children.length) { tab.flagDiv.loadFromXML(tab.tabNode); } }); tabData.forEach((tab, index) => { this.createPanel(tab); }); } protected createPanel(tab, active = false) { // Tab panel tab.contentDiv = loadWebComponent('et2-tab-panel', { id: tab.id, name: tab.id, active: active, hidden: tab.hidden, // Set readonly so it gets passed on to children readonly: tab.readonly }, this); // Tab content if(tab.XMLNode) { // Just read the XMLNode let tabContent = tab.contentDiv.createElementFromNode(tab.XMLNode); tab.contentDiv.appendChild( typeof window.customElements.get(tab.XMLNode.nodeName) == "undefined" ? tabContent.getDOMNode() : tabContent ); } else { et2_createWidget('template', tab.widget_options, tab.contentDiv); } return tab.contentDiv; } getAllTabs(includeDisabled = false) { const slot = this.shadowRoot.querySelector('slot[name="nav"]'); const tabNames = ["sl-tab", "et2-tab"]; return [...slot.assignedElements()].filter((el) => { return includeDisabled ? tabNames.indexOf(el.tagName.toLowerCase()) != -1 : tabNames.indexOf(el.tagName.toLowerCase()) !== -1 && !el.disabled; }); } /** * Overridden to allow et2-tab-panel as well as sl-tab-panel * * @returns {[SlTabPanel]} */ getAllPanels() { const slot = this.body!; return [...slot.assignedElements()].filter(el => ['et2-tab-panel', 'sl-tab-panel'].indexOf(el.tagName.toLowerCase()) != -1) as [SlTabPanel]; } handleClick(event : MouseEvent) { const target = event.target as HTMLElement; const tab = target.closest('et2-tab'); const tabGroup = tab?.closest('sl-tab-group') || tab?.closest('et2-tabbox'); // Ensure the target tab is in this tab group if(tabGroup !== this) { return; } if(tab !== null) { this.setActiveTab(tab, {scrollBehavior: 'smooth'}); } } /** * Keyboard navigation * Copy + Paste from parent due to tagname differences (sl-tab vs et2-tab) * * @param event */ handleKeyDown(event) { const target = event.target; const tab = target.closest("et2-tab"); const tabGroup = tab == null ? void 0 : tab.closest("et2-tabbox"); if(tabGroup !== this) { return; } if(["Enter", " "].includes(event.key)) { if(tab !== null) { this.setActiveTab(tab, {scrollBehavior: "smooth"}); event.preventDefault(); } } if(["ArrowLeft", "ArrowRight", "ArrowUp", "ArrowDown", "Home", "End"].includes(event.key)) { const activeEl = document.activeElement; const isRtl = this.localize.dir() === "rtl"; if((activeEl == null ? void 0 : activeEl.tagName.toLowerCase()) === "et2-tab") { let index = this.tabs.indexOf(activeEl); if(event.key === "Home") { index = 0; } else if(event.key === "End") { index = this.tabs.length - 1; } else if(["top", "bottom"].includes(this.placement) && event.key === (isRtl ? "ArrowRight" : "ArrowLeft") || ["start", "end"].includes(this.placement) && event.key === "ArrowUp") { index--; } else if(["top", "bottom"].includes(this.placement) && event.key === (isRtl ? "ArrowLeft" : "ArrowRight") || ["start", "end"].includes(this.placement) && event.key === "ArrowDown") { index++; } if(index < 0) { index = this.tabs.length - 1; } if(index > this.tabs.length - 1) { index = 0; } this.tabs[index].focus({preventScroll: true}); if(this.activation === "auto") { this.setActiveTab(this.tabs[index], {scrollBehavior: "smooth"}); } if(["top", "bottom"].includes(this.placement)) { scrollIntoView(this.tabs[index], this.nav, "horizontal"); } event.preventDefault(); } } } /** * Set up for printing * * @return {undefined|Deferred} Return a jQuery Deferred object if not done setting up * (waiting for data) */ beforePrint() { // Remove the "active" flag from all tabs-flags this.querySelector("[active]").removeAttribute("active"); // Remove height limit this.style.height = ''; // Show all enabled tabs for(let i = 0; i < this.tabData.length; i++) { let entry = this.tabData[i]; if(entry.hidden) { continue; } entry.flagDiv.insertBefore(entry.contentDiv); entry.contentDiv.show(); } } /** * Reset after printing */ afterPrint() { this.setActiveTab(this._selectedIndex); } /** * Activate the tab containing the given widget * * @param {et2_widget} widget * @return {bool} widget was found in a tab */ activateTab(widget) { let tab = widget; while(tab._parent && tab._parent.nodeName !== 'ET2-TABBOX') { tab = tab._parent; } if (tab.nodeName === 'ET2-TAB-PANEL') { this.show(tab.name); return true; } return false; } /** * get tab panel-name or label the given widget is in * * @param widget * @param label true: return label, otherwise return panel-name / id * @return string panel-name or undefined */ static getTabPanel(widget, label? : boolean) : string|undefined { let tab = widget; while(tab._parent && tab._parent.nodeName !== 'ET2-TABBOX') { tab = tab._parent; } if (tab.nodeName === 'ET2-TAB-PANEL') { if (label) { return tab._parent?.querySelector('et2-tab[panel="'+tab.name+'"]')?.innerText; } return tab.name; } return undefined; } /** * Reimplement to allow our existing function signatures too * * @deprecated use this.show(name : string) * @param tab number or name of tab (Sl uses that internally with a SlTab!) * @param options */ setActiveTab(tab: SlTab|String|Number, options?: { emitEvents?: boolean; scrollBehavior?: 'auto' | 'smooth'; }) { if (typeof tab === 'number') { tab = this.getAllTabs()[tab]; return this.show(tab.panel); } if (typeof tab === 'string') { return this.show(tab); } return super.setActiveTab(tab, options); } resize(_height) { if(_height && this.tabHeight != 'auto') { this.tabHeight = parseInt(this.tabHeight) + parseInt(_height); } } } customElements.define("et2-tabbox", Et2Tabs);