egroupware_official/api/js/etemplate/et2_widget_tabs.js
nathangray 9128d15bb2 Etemplate: Fix some load bugs
- tabs got doLoadingFinished() multiple times if tablist was modified by data
- selectbox with cached options did not load correctly first time
2021-02-26 15:22:47 -07:00

489 lines
19 KiB
JavaScript

"use strict";
/**
* EGroupware eTemplate2 - JS Tabs object
*
* @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License
* @package etemplate
* @subpackage api
* @link http://www.egroupware.org
* @author Andreas Stöckel
*/
var __extends = (this && this.__extends) || (function () {
var extendStatics = function (d, b) {
extendStatics = Object.setPrototypeOf ||
({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
return extendStatics(d, b);
};
return function (d, b) {
extendStatics(d, b);
function __() { this.constructor = d; }
d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
};
})();
Object.defineProperty(exports, "__esModule", { value: true });
/*egw:uses
jsapi.egw;
/vendor/bower-asset/jquery/dist/jquery.js;
et2_core_valueWidget;
*/
require("./et2_core_common");
var et2_core_inheritance_1 = require("./et2_core_inheritance");
var et2_core_widget_1 = require("./et2_core_widget");
var et2_core_valueWidget_1 = require("./et2_core_valueWidget");
var et2_extension_nextmatch_1 = require("./et2_extension_nextmatch");
/**
* Class which implements the tabbox-tag
*/
var et2_tabbox = /** @class */ (function (_super) {
__extends(et2_tabbox, _super);
/**
* Constructor
*/
function et2_tabbox(_parent, _attrs, _child) {
var _this =
// Call the inherited constructor
_super.call(this, _parent, _attrs, et2_core_inheritance_1.ClassWithAttributes.extendAttributes(et2_tabbox._attributes, _child || {})) || this;
/**
* Currently selected tab
*/
_this.selected_index = 0;
_this.tabData = [];
// Create the outer tabbox container
_this.container = jQuery(document.createElement("div"))
.addClass("et2_tabbox");
// Create the upper container for the tab flags
_this.flagContainer = jQuery(document.createElement("div"))
.addClass("et2_tabheader")
.appendTo(_this.container);
// Create the lower tab container
_this.tabContainer = jQuery(document.createElement("div"))
.addClass("et2_tabs")
.appendTo(_this.container);
return _this;
}
et2_tabbox.prototype.destroy = function () {
_super.prototype.destroy.call(this);
this.container = null;
this.flagContainer = null;
this.tabData = [];
};
et2_tabbox.prototype._readTabs = function (tabData, tabs) {
var selected = "";
this.selected_index = false;
var hidden = {};
if (this.id) {
// Set the value for this element
var contentMgr = this.getArrayMgr("content");
if (contentMgr != null) {
var val = contentMgr.getEntry(this.id);
if (val !== null) {
selected = val;
}
}
contentMgr = this.getArrayMgr("readonlys");
if (contentMgr != null) {
var val = contentMgr.getEntry(this.id);
if (val !== null && typeof val !== 'undefined') {
hidden = val;
}
}
}
var i = 0;
et2_filteredNodeIterator(tabs, function (node, nodeName) {
if (nodeName == "tab") {
var index_name = et2_readAttrWithDefault(node, "id", '');
var hide = false;
var widget_options = {};
if (index_name) {
if (selected == index_name)
this.selected_index = i;
if (hidden[index_name]) {
hide = true;
}
// Get the class attribute and add it as widget_options
var 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")),
"widget": null,
"widget_options": widget_options,
"contentDiv": null,
"flagDiv": null,
"hidden": hide,
"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 (var i = 0; i < tabData.length && this.selected_index === false; i++) {
if (!tabData[i].hidden)
this.selected_index = i;
}
};
et2_tabbox.prototype._readTabPanels = function (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);
};
et2_tabbox.prototype.loadFromXML = function (_node) {
// Get the tabs and tabpanels tags
var tabsElems = et2_directChildrenByTagName(_node, "tabs");
var tabpanelsElems = et2_directChildrenByTagName(_node, "tabpanels");
var tabData = [];
// Check for a parent height, we'll apply it to tab panels
var height = et2_readAttrWithDefault(_node.parentNode, "height", null);
if (height) {
this.tabContainer.css("height", height);
}
// if no tabs set or they should be added to tabs from xml
if (!this.options.tabs || this.options.add_tabs) {
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);
}
}
if (this.options.tabs) {
var readonly = this.getArrayMgr("readonlys").getEntry(this.id) || {};
for (var i = 0; i < this.options.tabs.length; i++) {
var tab = this.options.tabs[i];
var tab_id = tab.id || tab.template;
var tab_options = { id: tab_id, template: tab.template, url: tab.url, content: undefined };
if (tab.id) {
tab_options.content = tab.id;
}
tabData[tab.prepend ? 'unshift' : 'push'].call(tabData, {
"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);
};
/**
* Load is finished, set up tabs to load on their own
*/
et2_tabbox.prototype.doLoadingFinished = function () {
var tab_deferred = jQuery.Deferred();
var promises = [];
var tabs = this;
// Specially process the selected index so it shows up right away
this._loadTab(this.selected_index, promises);
// Avoid reloading if tabs were modified by data
if (this.isInTree() && this.isAttached())
return;
// Apply parent now, which actually puts into the DOM
// This has to be before loading the child, so the dom sub-tree is not
// disconnected, which causes problems for things like CKEditor
_super.prototype.doLoadingFinished.call(this);
// We can do this and not wind up with 2 because child is a template,
// which has special handling
this._children[0].loadingFinished(promises);
// Defer parsing & loading of other tabs until later
window.setTimeout(function () {
for (var i = 0; i < tabs.tabData.length; i++) {
if (i == tabs.selected_index)
continue;
tabs._loadTab(i, promises);
}
jQuery.when.apply(jQuery, promises).then(function () {
tab_deferred.resolve();
tabs.resetDirty();
});
}, 0);
return tab_deferred.promise();
};
/**
* Load & render a tab's content
*
* @param {number} index numerical index of tab in this.tabData array
* @param {array} promises
*/
et2_tabbox.prototype._loadTab = function (index, promises) {
var tabData = this.tabData[index];
if (!tabData || tabData.loaded)
return;
// Set loaded flag to not do this again, even if not fully done
tabData.loaded = true;
if (tabData.XMLNode != null) {
if (tabData.hidden) {
// Set hidden tab to readonly, so widgets aren't active
// Do not modify the XMLNode, or the change will be cached for all
tabData.XMLNode = tabData.XMLNode.cloneNode();
tabData.XMLNode.setAttribute('readonly', true);
}
tabData.widget = this.createElementFromNode(tabData.XMLNode, tabData.XMLNode.nodeName.toLowerCase());
// Release the XML node
tabData.XMLNode = null;
}
else if (tabData.widget_options) {
tabData.widget = et2_core_widget_1.et2_createWidget('template', tabData.widget_options, this);
}
// loadingFinished() will be called either when the promise from doLoadingFinished is resolved,
// or during the normal execution
};
/**
* Check for custom tabs
*
* @param {object} _attrs
*/
et2_tabbox.prototype.transformAttributes = function (_attrs) {
_super.prototype.transformAttributes.call(this, _attrs);
// Add in settings that are objects
var data = this.getArrayMgr("modifications").getEntry(this.id);
for (var key in data) {
if (typeof data[key] === 'object' && !_attrs[key])
_attrs[key] = data[key];
}
};
et2_tabbox.prototype.createTabs = function (tabData) {
this.tabData = tabData;
this.tabContainer.empty();
this.flagContainer.empty();
for (var i = 0; i < this.tabData.length; i++) {
var entry = this.tabData[i];
entry.flagDiv = jQuery(document.createElement("span"))
.addClass("et2_tabflag")
.appendTo(this.flagContainer);
// Class to tab's div container
if (entry.widget_options && typeof entry.widget_options.class != 'undefined') {
entry.flagDiv.addClass(entry.widget_options.class);
}
entry.flagDiv.text(entry.label || "Tab");
if (entry.hidden || this.tabData.length === 1) {
entry.flagDiv.hide();
}
else {
entry.flagDiv.click({ "tabs": this, "idx": i }, function (e) {
e.data.tabs.setActiveTab(e.data.idx);
});
}
entry.contentDiv = jQuery(document.createElement("div"))
.addClass("et2_tabcntr")
.appendTo(this.tabContainer);
if (this.options.align_tabs == 'v') {
entry.flagDiv.unbind('click');
entry.flagDiv.text("");
jQuery(document.createElement('div'))
.addClass('et2_tabtitle')
.text(entry.label || "Tab")
.click({ "tabs": this, "idx": i }, function (e) {
e.data.tabs.flagContainer.children(":eq(" + e.data.idx + ")").toggleClass('active');
if (e.data.tabs.selected_index != e.data.idx)
e.data.tabs.setActiveTab(e.data.idx);
})
.appendTo(entry.flagDiv);
entry.contentDiv.appendTo(entry.flagDiv);
}
}
if (this.options.align_tabs == 'v') {
this.container.addClass('vertical');
this.tabContainer.hide();
}
// Check for a passed in value
if (this.options.value) {
this.selected_index = 0;
for (var i = 0; i < this.tabData.length; i++) {
if (this.tabData[i].id == this.options.value) {
this.selected_index = i;
break;
}
}
}
this.setActiveTab(this.selected_index);
};
/**
* Gets the index of the currently active tab
*
* @returns {number}
*/
et2_tabbox.prototype.get_active_tab = function () {
return this.selected_index;
};
/**
* Sets the currently active tab by index
*
* @param {number} _idx
*/
et2_tabbox.prototype.setActiveTab = function (_idx) {
this.selected_index = _idx;
// Remove the "active" flag from all tabs-flags
jQuery(".et2_tabflag", this.flagContainer).removeClass("active");
// Hide all tab containers
this.tabContainer.children().hide();
// Set the tab flag with the given index active and show the corresponding
// container
this.flagContainer.children(":eq(" + _idx + ")").addClass("active");
this.tabContainer.children(":eq(" + _idx + ")").show();
// lookup for nm children and trigger a resize, since nm inside inactive
// tabs are not getting render due to tab's deffer loading.
if (this._children.length > 0 && this.tabData && this.tabData.length > 0) {
this.tabData[_idx]['widget'].iterateOver(function (nm) {
if (nm && nm._type == 'nextmatch')
nm.resize();
}, this.tabData[_idx]['widget'], et2_extension_nextmatch_1.et2_nextmatch);
}
};
/**
* Activate the tab containing the given widget
*
* @param {et2_widget} widget
* @return {bool} widget was found in a tab
*/
et2_tabbox.prototype.activateTab = function (widget) {
var tab = widget;
while (tab._parent && tab._parent._type != 'tabbox') {
tab = tab._parent;
}
var child_index = this._children.indexOf(tab);
for (var i = 0; i < this.tabData.length; i++) {
if (this.tabData[i].widget == tab) {
this.setActiveTab(i);
return true;
}
}
return false;
};
et2_tabbox.prototype.getDOMNode = function (_sender) {
if (_sender === this || typeof _sender === 'undefined') {
return this.container[0];
}
else {
for (var i = 0; i < this.tabData.length; i++) {
if (this.tabData[i].widget == _sender) {
return this.tabData[i].contentDiv[0];
}
}
return null;
}
};
et2_tabbox.prototype.set_tab_height = function (_height) {
this.tab_height = _height;
this.tabContainer.css("height", _height);
};
et2_tabbox.prototype.set_height = function (_value) {
this.height = _value;
this.tabContainer.css("height", _value);
};
/**
* getValue has to return the value of the input widget
*/
et2_tabbox.prototype.getValue = function () {
return this.selected_index !== false ? this.tabData[this.selected_index].id : undefined;
};
/**
* Is dirty returns true if the value of the widget has changed since it
* was loaded.
*/
et2_tabbox.prototype.isDirty = function () {
// We consider tab changes are not real changes
return false;
};
/**
* Causes the dirty flag to be reseted.
*/
et2_tabbox.prototype.resetDirty = function () {
this.value = this.selected_index;
};
et2_tabbox.prototype.isValid = function (messages) {
return true;
};
et2_tabbox.prototype.resize = function (_height) {
if (_height) {
this.set_height(this.tabContainer.height() + _height);
}
//Set the height of tabs with the heighest height
else if (_height === 0) {
this.set_height(this.tabContainer.height());
}
};
/**
* Set up for printing
*
* @return {undefined|Deferred} Return a jQuery Deferred object if not done setting up
* (waiting for data)
*/
et2_tabbox.prototype.beforePrint = function () {
// Remove the "active" flag from all tabs-flags
jQuery(".et2_tabflag", this.flagContainer).removeClass("active");
// Remove height limit
this.tabContainer.css("height", '');
// Show all enabled tabs
for (var i = 0; i < this.tabData.length; i++) {
var entry = this.tabData[i];
if (entry.hidden)
continue;
entry.flagDiv.insertBefore(entry.contentDiv);
entry.contentDiv.show();
}
};
/**
* Reset after printing
*/
et2_tabbox.prototype.afterPrint = function () {
for (var i = 0; i < this.tabData.length; i++) {
var entry = this.tabData[i];
entry.flagDiv.appendTo(this.flagContainer);
}
this.setActiveTab(this.get_active_tab());
};
et2_tabbox._attributes = {
'tabs': {
'name': 'Tabs',
'default': et2_no_init,
'description': "Array of [extra] tabs. Each tab needs {label:..., template:...}. Additional optional keys are prepend, hidden and id, for access into content array"
},
'add_tabs': {
'name': 'Add tabs',
'default': false,
'description': 'Set to true if tabs should be added to tabs from read from template, default false if not'
},
'tab_height': {
name: 'Tabs innerHeight',
default: '',
description: 'Set the innerHeight for the tab content'
},
'align_tabs': {
name: 'Tabs alignment',
type: 'string',
default: 'h',
description: 'Set tabs and their headers arrangment either horizental (h) or vertical (v). Default value is horizental.'
}
};
return et2_tabbox;
}(et2_core_valueWidget_1.et2_valueWidget));
et2_core_widget_1.et2_register_widget(et2_tabbox, ["tabbox"]);
//# sourceMappingURL=et2_widget_tabs.js.map