mirror of
https://github.com/EGroupware/egroupware.git
synced 2024-12-16 19:50:44 +01:00
1476 lines
38 KiB
TypeScript
1476 lines
38 KiB
TypeScript
import {et2_IDOMNode, et2_implements_registry} from "../et2_core_interfaces";
|
|
import {et2_arrayMgr} from "../et2_core_arrayMgr";
|
|
import {et2_attribute_registry, et2_registry, et2_widget} from "../et2_core_widget";
|
|
import type {etemplate2} from "../etemplate2";
|
|
import {et2_compileLegacyJS} from "../et2_core_legacyJSFunctions";
|
|
import {et2_cloneObject, et2_csvSplit} from "../et2_core_common";
|
|
// @ts-ignore
|
|
import type {IegwAppLocal} from "../../jsapi/egw_global";
|
|
import {egw} from "../../jsapi/egw_global";
|
|
import {ClassWithAttributes, ClassWithInterfaces} from "../et2_core_inheritance";
|
|
import {css, dedupeMixin, PropertyValues, unsafeCSS} from "@lion/core";
|
|
import type {et2_container} from "../et2_core_baseWidget";
|
|
import type {et2_DOMWidget} from "../et2_core_DOMWidget";
|
|
|
|
/**
|
|
* This mixin will allow any LitElement to become an Et2Widget
|
|
*
|
|
* Usage:
|
|
* @example
|
|
* export class Et2Loading extends Et2Widget(BXLoading) { ... }
|
|
* @example
|
|
* export class Et2Button extends Et2InputWidget(Et2Widget(BXButton)) { ... }
|
|
*
|
|
* @see Mixin explanation https://lit.dev/docs/composition/mixins/
|
|
*/
|
|
function applyMixins(derivedCtor : any, baseCtors : any[])
|
|
{
|
|
baseCtors.forEach(baseCtor =>
|
|
{
|
|
Object.getOwnPropertyNames(baseCtor.prototype).forEach(name =>
|
|
{
|
|
if(name !== 'constructor')
|
|
{
|
|
derivedCtor.prototype[name] = baseCtor.prototype[name];
|
|
}
|
|
});
|
|
});
|
|
}
|
|
|
|
const Et2WidgetMixin = (superClass) =>
|
|
{
|
|
class Et2WidgetClass extends superClass implements et2_IDOMNode
|
|
{
|
|
|
|
protected _mgrs : et2_arrayMgr[] = [];
|
|
protected _parent : Et2WidgetClass | et2_widget | null = null;
|
|
private _inst : etemplate2 | null = null;
|
|
|
|
/** et2_widget compatability **/
|
|
// @ts-ignore Some legacy widgets check their parent to see whats allowed
|
|
public supportedWidgetClasses = [];
|
|
|
|
/**
|
|
* If we put the widget somewhere other than as a child of its parent, we need to record that so
|
|
* we don't move it back to the parent.
|
|
* @type {Element}
|
|
* @protected
|
|
*/
|
|
protected _parent_node : Element;
|
|
/**
|
|
* Not actually required by et2_widget, but needed to keep track of non-webComponent children
|
|
*/
|
|
private _legacy_children : et2_widget[] = [];
|
|
|
|
/**
|
|
* Keep track of child widgets
|
|
* This can differ from this.children, as it only includes the widgets where this.children will be child DOM nodes,
|
|
* not guaranteed to be widgets
|
|
*/
|
|
private _children : (et2_widget | Et2WidgetClass)[] = [];
|
|
|
|
/**
|
|
* Internal Properties - default values, and actually creating them as fields
|
|
* Do not include public property defined in properties()
|
|
*/
|
|
protected _widget_id : string = "";
|
|
protected _dom_id : string = "";
|
|
|
|
/**
|
|
* TypeScript & LitElement ensure type correctness, so we can't have a string value like "$row_cont[disable_me]"
|
|
* as a boolean property so we store them here, and parse them when expanding. Strings do not have this problem,
|
|
* since $row_cont[disable_me] is still a valid string.
|
|
*/
|
|
protected _deferred_properties : { [key : string] : string } = {};
|
|
|
|
|
|
/** WebComponent **/
|
|
static get styles()
|
|
{
|
|
return [
|
|
...(super.styles ? (Array.isArray(super.styles) ? super.styles : [super.styles]) : []),
|
|
css`
|
|
:host([disabled]) {
|
|
display: none;
|
|
}
|
|
|
|
/* CSS to align internal inputs according to box alignment */
|
|
:host([align="center"]) .input-group__input {
|
|
justify-content: center;
|
|
}
|
|
:host([align="right"]) .input-group__input {
|
|
justify-content: flex-end;
|
|
}
|
|
`];
|
|
}
|
|
|
|
static get properties()
|
|
{
|
|
return {
|
|
...super.properties,
|
|
|
|
/**
|
|
* Widget ID. Optional, and not always the same as the DOM ID if the widget is inside something
|
|
* else that also has an ID.
|
|
* Putting this in the properties() list causes the parent portion of the DOM ID to be duplicated
|
|
* due to how LitElement processes the change
|
|
*/
|
|
//id: {type: String, reflect: false},
|
|
|
|
/**
|
|
* CSS Class. This class is applied to the _outside_, on the web component itself.
|
|
* Due to how WebComponents work, this might not change anything inside the component.
|
|
*/
|
|
class: {type: String, reflect: true},
|
|
|
|
/**
|
|
* Defines whether this widget is visible.
|
|
* Not to be confused with an input widget's HTML attribute 'disabled'.",
|
|
*/
|
|
disabled: {
|
|
type: Boolean,
|
|
reflect: true
|
|
},
|
|
|
|
/**
|
|
* Accesskey provides a hint for generating a keyboard shortcut for the current element.
|
|
* The attribute value must consist of a single printable character.
|
|
* @see https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/accesskey
|
|
*/
|
|
accesskey: {type: String, reflect: true},
|
|
|
|
/**
|
|
* Widget ID of another node to insert this node into instead of the normal location
|
|
* This isn't a normal property...
|
|
*/
|
|
parent_node: {type: String},
|
|
|
|
/**
|
|
* Tooltip which is shown for this element on hover
|
|
*/
|
|
statustext: {
|
|
type: String,
|
|
reflect: true,
|
|
translate: true
|
|
},
|
|
|
|
/**
|
|
* The label of the widget
|
|
* This is usually displayed in some way. It's also important for accessability.
|
|
* This is defined in the parent somewhere, and re-defining it causes labels to disappear
|
|
*
|
|
label: {
|
|
type: String,
|
|
translate: true
|
|
},
|
|
*/
|
|
|
|
onclick: {
|
|
type: Function
|
|
},
|
|
|
|
/*** Style type attributes ***/
|
|
/**
|
|
* Disable any translations for the widget
|
|
*/
|
|
no_lang: {
|
|
type: Boolean,
|
|
reflect: false
|
|
},
|
|
|
|
/**
|
|
* Used by Et2Box to determine alignment.
|
|
* Allowed values are left, right
|
|
*/
|
|
align: {
|
|
type: String,
|
|
reflect: true
|
|
}
|
|
};
|
|
}
|
|
|
|
/**
|
|
* List of properties that get translated
|
|
* Done separately to not interfere with properties - if we re-define label property,
|
|
* labels go missing.
|
|
* @returns {{statustext : boolean, label : boolean}}
|
|
*/
|
|
static get translate()
|
|
{
|
|
return {
|
|
label: true,
|
|
statustext: true
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Widget Mixin constructor
|
|
*
|
|
* Note the ...args parameter and super() call
|
|
*
|
|
* @param args
|
|
*/
|
|
constructor(...args : any[])
|
|
{
|
|
super(...args);
|
|
|
|
this.disabled = false;
|
|
this._handleClick = this._handleClick.bind(this);
|
|
}
|
|
|
|
connectedCallback()
|
|
{
|
|
super.connectedCallback();
|
|
|
|
this.addEventListener("click", this._handleClick);
|
|
|
|
if(this.statustext)
|
|
{
|
|
this.egw().tooltipBind(this, this.statustext);
|
|
}
|
|
}
|
|
|
|
disconnectedCallback()
|
|
{
|
|
this.egw()?.tooltipUnbind(this);
|
|
|
|
this.removeEventListener("click", this._handleClick);
|
|
}
|
|
|
|
/**
|
|
* NOT the setter, since we cannot add to the DOM before connectedCallback()
|
|
*
|
|
* TODO: This is not best practice. Should just set property, DOM modification should be done in render
|
|
* https://lit-element.polymer-project.org/guide/templates#design-a-performant-template
|
|
*
|
|
* @param value
|
|
*/
|
|
set_label(value : string)
|
|
{
|
|
let oldValue = this.label;
|
|
|
|
// Remove old
|
|
let oldLabels = this.getElementsByClassName("et2_label");
|
|
while(oldLabels[0])
|
|
{
|
|
this.removeChild(oldLabels[0]);
|
|
}
|
|
|
|
this.__label = value;
|
|
if(value)
|
|
{
|
|
if(this._labelNode)
|
|
{
|
|
this._labelNode.textContent = this.__label;
|
|
}
|
|
else
|
|
{
|
|
let label = document.createElement("span");
|
|
label.classList.add("et2_label");
|
|
label.textContent = this.__label;
|
|
// We should have a slot in the template for the label
|
|
label.slot = "label";
|
|
this.appendChild(label);
|
|
this.requestUpdate('label', oldValue);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* supports legacy set_statustext
|
|
* @deprecated use this.statustext
|
|
* @param value
|
|
*/
|
|
set_statustext(value : string)
|
|
{
|
|
this.statustext = value;
|
|
}
|
|
|
|
set statustext(value : string)
|
|
{
|
|
let oldValue = this.__statustext;
|
|
this.__statustext = value;
|
|
this.requestUpdate("statustext", oldValue);
|
|
}
|
|
|
|
get statustext() : string
|
|
{
|
|
return this.__statustext;
|
|
}
|
|
|
|
/**
|
|
* Wrapper on this.disabled because legacy had it.
|
|
*
|
|
* @param {boolean} value
|
|
*/
|
|
set_disabled(value : boolean)
|
|
{
|
|
let oldValue = this.disabled;
|
|
this.disabled = value;
|
|
this.requestUpdate("disabled", oldValue);
|
|
}
|
|
|
|
/**
|
|
* Get the actual DOM ID, which has been prefixed to make sure it's unique.
|
|
*
|
|
* @returns {string}
|
|
*/
|
|
get dom_id()
|
|
{
|
|
return this.getAttribute("id");
|
|
}
|
|
|
|
/**
|
|
* Set the ID of the widget
|
|
*
|
|
* This is the "widget" ID, which is used as an index into the managed arrays (content, etc) and when
|
|
* trying to find widgets by ID.
|
|
*
|
|
* This is not the DOM ID.
|
|
*
|
|
* @param {string} value
|
|
*/
|
|
set id(value)
|
|
{
|
|
this._widget_id = value;
|
|
let dom_id = "";
|
|
if(this._widget_id)
|
|
{
|
|
// Create a namespace for this object with new ID
|
|
if(this._createNamespace())
|
|
{
|
|
this.checkCreateNamespace();
|
|
}
|
|
|
|
let path = this.getPath();
|
|
if(this.getInstanceManager())
|
|
{
|
|
path.unshift(this.getInstanceManager().uniqueId);
|
|
}
|
|
path.push(value);
|
|
dom_id = path.join("_");
|
|
}
|
|
this.setAttribute("id", dom_id);
|
|
this.requestUpdate("id");
|
|
}
|
|
|
|
/**
|
|
* Get the ID of the widget
|
|
*
|
|
* @returns {string}
|
|
*/
|
|
get id()
|
|
{
|
|
return this._widget_id;
|
|
}
|
|
|
|
/**
|
|
* A property has changed, and we want to make adjustments to other things
|
|
* based on that
|
|
*
|
|
* @param {import('@lion/core').PropertyValues } changedProperties
|
|
*/
|
|
updated(changedProperties : PropertyValues)
|
|
{
|
|
super.updated(changedProperties);
|
|
|
|
// required changed, add / remove validator
|
|
if(changedProperties.has('label'))
|
|
{
|
|
this._set_label(this.label);
|
|
}
|
|
if(changedProperties.has("statustext"))
|
|
{
|
|
this.egw().tooltipUnbind(this);
|
|
if(this.statustext)
|
|
{
|
|
this.egw().tooltipBind(this, this.statustext);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Any attribute that refers to row content cannot be resolved immediately, but some like booleans cannot stay a
|
|
* string because it's a boolean attribute. We store them for later, and parse when they're fully in their row.
|
|
*/
|
|
get deferredProperties()
|
|
{
|
|
return this._deferred_properties;
|
|
}
|
|
|
|
set deferredProperties(value)
|
|
{
|
|
this._deferred_properties = value;
|
|
}
|
|
|
|
/**
|
|
* Do some fancy stuff on the label, splitting it up if there's a %s in it
|
|
*
|
|
* Normally called from updated(), the "normal" setter stuff has already been run before
|
|
* this is called. We only override our special cases (%s) because the normal label has
|
|
* been set by the parent
|
|
*
|
|
* @param value
|
|
* @protected
|
|
*/
|
|
protected _set_label(value : string)
|
|
{
|
|
if(!this._labelNode)
|
|
{
|
|
return;
|
|
}
|
|
// Remove any existing post label
|
|
let existing = (Array.from(this.children)).find(
|
|
(el : Element) => el.slot === "after" && el.tagName === "LABEL",
|
|
)
|
|
if(existing)
|
|
{
|
|
this.removeChild(existing);
|
|
}
|
|
|
|
// Split the label at the "%s"
|
|
let parts = et2_csvSplit(value, 2, "%s");
|
|
if(parts.length > 1)
|
|
{
|
|
let after = document.createElement("label");
|
|
after.slot = "after";
|
|
after.textContent = parts[1];
|
|
this.appendChild(after);
|
|
|
|
this._labelNode.textContent = parts[0];
|
|
}
|
|
}
|
|
|
|
set class(value : string)
|
|
{
|
|
let oldValue = this.classList.value;
|
|
this.classList.value = value;
|
|
|
|
this.requestUpdate('class', oldValue);
|
|
}
|
|
|
|
get class()
|
|
{
|
|
return this.classList.value;
|
|
}
|
|
|
|
/**
|
|
* Set the widget class
|
|
*
|
|
* @deprecated Use this.class or this.classList instead
|
|
* @param {string} new_class
|
|
*/
|
|
set_class(new_class : string)
|
|
{
|
|
this.class = new_class;
|
|
}
|
|
|
|
/**
|
|
* Event handlers
|
|
*/
|
|
|
|
/**
|
|
* Click handler calling custom handler set via onclick attribute to this.onclick
|
|
*
|
|
* @param _ev
|
|
* @returns
|
|
*/
|
|
_handleClick(_ev : MouseEvent) : boolean
|
|
{
|
|
if(typeof this.onclick == 'function')
|
|
{
|
|
// Make sure function gets a reference to the widget, splice it in as 2. argument if not
|
|
let args = Array.prototype.slice.call(arguments);
|
|
if(args.indexOf(this) == -1)
|
|
{
|
|
args.splice(1, 0, this);
|
|
}
|
|
|
|
return this.onclick(...args);
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/** et2_widget compatability **/
|
|
destroy()
|
|
{
|
|
// Not really needed, use the disconnectedCallback() and let the browser handle it
|
|
}
|
|
|
|
isInTree() : boolean
|
|
{
|
|
// TODO: Probably should watch the state or something
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Get property-values as object
|
|
*
|
|
* @deprecated use widget methods
|
|
*/
|
|
get options() : object
|
|
{
|
|
const options : { [key : string] : any } = {};
|
|
// @ts-ignore not sure how to tell TS this is a ReactiveElement and properties is a static getter
|
|
for(const name in this.constructor.properties)
|
|
{
|
|
options[name] = this[name];
|
|
}
|
|
// adding attributes too
|
|
this.getAttributeNames().forEach(name =>
|
|
{
|
|
options[name] = this.getAttribute(name);
|
|
});
|
|
// add some (not declared) known properties
|
|
if(typeof this.get_value === 'function')
|
|
{
|
|
options.value = this.get_value();
|
|
}
|
|
console.groupCollapsed("Deprecated widget.options use")
|
|
console.trace("Something called widget.options on ", this);
|
|
console.groupEnd();
|
|
return options;
|
|
}
|
|
|
|
/**
|
|
* Loads the widget tree from an XML node
|
|
*
|
|
* @param _node xml node
|
|
*/
|
|
loadFromXML(_node)
|
|
{
|
|
// Load the child nodes.
|
|
for(let i = 0; i < _node.childNodes.length; i++)
|
|
{
|
|
let node = _node.childNodes[i];
|
|
let widgetType = node.nodeName.toLowerCase();
|
|
|
|
if(widgetType == "#comment")
|
|
{
|
|
continue;
|
|
}
|
|
|
|
if(widgetType == "#text")
|
|
{
|
|
if(node.data.replace(/^\s+|\s+$/g, ''))
|
|
{
|
|
this.innerText = node.data;
|
|
}
|
|
continue;
|
|
}
|
|
|
|
// Create the new element
|
|
this.createElementFromNode(node);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Create a et2_widget from an XML node.
|
|
*
|
|
* First the type and attributes are read from the node. Then the readonly & modifications
|
|
* arrays are checked for changes specific to the loaded data. Then the appropriate
|
|
* constructor is called. After the constructor returns, the widget has a chance to
|
|
* further initialize itself from the XML node when the widget's loadFromXML() method
|
|
* is called with the node.
|
|
*
|
|
* @param _node XML node to read
|
|
* @param _name XML node name
|
|
*
|
|
* @return et2_widget
|
|
*/
|
|
createElementFromNode(_node, _name?)
|
|
{
|
|
let attributes = {};
|
|
|
|
// Parse the "readonly" and "type" flag for this element here, as they
|
|
// determine which constructor is used
|
|
let _nodeName = attributes["type"] = _node.getAttribute("type") ?
|
|
_node.getAttribute("type") : _node.nodeName.toLowerCase();
|
|
const readonly = attributes["readonly"] = this.getArrayMgr("readonlys") ?
|
|
(<any>this.getArrayMgr("readonlys")).isReadOnly(
|
|
_node.getAttribute("id"), _node.getAttribute("readonly"),
|
|
typeof this.readonly !== "undefined" ? this.readonly : false) : false;
|
|
|
|
// Check to see if modifications change type
|
|
let modifications = this.getArrayMgr("modifications");
|
|
if(modifications && _node.getAttribute("id"))
|
|
{
|
|
let entry : any = modifications.getEntry(_node.getAttribute("id"));
|
|
if(entry == null)
|
|
{
|
|
// Try again, but skip the fancy stuff
|
|
// TODO: Figure out why the getEntry() call doesn't always work
|
|
entry = modifications.data[_node.getAttribute("id")];
|
|
if(entry)
|
|
{
|
|
this.egw().debug("warn", "getEntry(" + _node.getAttribute("id") + ") failed, but the data is there.", modifications, entry);
|
|
}
|
|
else
|
|
{
|
|
// Try the root, in case a namespace got missed
|
|
entry = modifications.getRoot().getEntry(_node.getAttribute("id"));
|
|
}
|
|
}
|
|
if(entry && entry.type && typeof entry.type === 'string')
|
|
{
|
|
_nodeName = attributes["type"] = entry.type;
|
|
}
|
|
entry = null;
|
|
}
|
|
|
|
// if _nodeName / type-attribute contains something to expand (eg. type="@${row}[type]"),
|
|
// we need to expand it now as it defines the constructor and by that attributes parsed via parseXMLAttrs!
|
|
if(_nodeName.charAt(0) == '@' || _nodeName.indexOf('$') >= 0)
|
|
{
|
|
_nodeName = attributes["type"] = this.getArrayMgr('content').expandName(_nodeName);
|
|
}
|
|
|
|
let widget;
|
|
if(undefined == window.customElements.get(_nodeName))
|
|
{
|
|
// Get the constructor - if the widget is readonly, use the special "_ro"
|
|
// constructor if it is available
|
|
if (typeof et2_registry[_nodeName] === "undefined")
|
|
{
|
|
_nodeName = 'placeholder';
|
|
}
|
|
let constructor = et2_registry[_nodeName];
|
|
if(readonly === true && typeof et2_registry[_nodeName + "_ro"] != "undefined")
|
|
{
|
|
constructor = et2_registry[_nodeName + "_ro"];
|
|
}
|
|
|
|
// Parse the attributes from the given XML attributes object
|
|
this.parseXMLAttrs(_node.attributes, attributes, constructor.prototype);
|
|
|
|
// Do an sanity check for the attributes
|
|
ClassWithAttributes.generateAttributeSet(et2_attribute_registry[constructor.name], attributes);
|
|
|
|
// Creates the new widget, passes this widget as an instance and
|
|
// passes the widgetType. Then it goes on loading the XML for it.
|
|
widget = new constructor(this, attributes);
|
|
|
|
// Load the widget itself from XML
|
|
widget.loadFromXML(_node);
|
|
}
|
|
else
|
|
{
|
|
widget = loadWebComponent(_nodeName, _node, this);
|
|
|
|
if(this.addChild)
|
|
{
|
|
// webcomponent going into old et2_widget
|
|
this.addChild(widget);
|
|
}
|
|
}
|
|
return widget;
|
|
}
|
|
|
|
|
|
/**
|
|
* The parseXMLAttrs function takes an XML DOM attributes object
|
|
* and adds the given attributes to the _target associative array. This
|
|
* function also parses the legacyOptions.
|
|
*
|
|
* N.B. This is only used for legacy widgets. WebComponents use transformAttributes() and
|
|
* do their own handling of attributes.
|
|
*
|
|
* @param _attrsObj is the XML DOM attributes object
|
|
* @param {object} _target is the object to which the attributes should be written.
|
|
* @param {et2_widget} _proto prototype with attributes and legacyOptions attribute
|
|
*/
|
|
parseXMLAttrs(_attrsObj, _target, _proto)
|
|
{
|
|
// Check whether the attributes object is really existing, if not abort
|
|
if(typeof _attrsObj == "undefined")
|
|
{
|
|
return;
|
|
}
|
|
|
|
// Iterate over the given attributes and parse them
|
|
let mgr = this.getArrayMgr("content");
|
|
for(let i = 0; i < _attrsObj.length; i++)
|
|
{
|
|
let attrName = _attrsObj[i].name;
|
|
let attrValue = _attrsObj[i].value;
|
|
|
|
// Special handling for the legacy options
|
|
if(attrName == "options" && _proto.constructor.legacyOptions && _proto.constructor.legacyOptions.length > 0)
|
|
{
|
|
let legacy = _proto.constructor.legacyOptions || [];
|
|
// Check for modifications on legacy options here. Normal modifications
|
|
// are handled in widget constructor, but it's too late for legacy options then
|
|
if(_target.id && this.getArrayMgr("modifications").getEntry(_target.id))
|
|
{
|
|
let mod : any = this.getArrayMgr("modifications").getEntry(_target.id);
|
|
if(typeof mod.options != "undefined")
|
|
{
|
|
attrValue = _attrsObj[i].value = mod.options;
|
|
}
|
|
}
|
|
// expand legacyOptions with content
|
|
if(attrValue.charAt(0) == '@' || attrValue.indexOf('$') != -1)
|
|
{
|
|
attrValue = mgr.expandName(attrValue);
|
|
}
|
|
|
|
// Parse the legacy options (as a string, other types not allowed)
|
|
let splitted = et2_csvSplit(attrValue + "");
|
|
|
|
for(let j = 0; j < splitted.length && j < legacy.length; j++)
|
|
{
|
|
// Blank = not set, unless there's more legacy options provided after
|
|
if(splitted[j].trim().length === 0 && legacy.length >= splitted.length)
|
|
{
|
|
continue;
|
|
}
|
|
|
|
// Check to make sure we don't overwrite a current option with a legacy option
|
|
if(typeof _target[legacy[j]] === "undefined")
|
|
{
|
|
attrValue = splitted[j];
|
|
|
|
/**
|
|
If more legacy options than expected, stuff them all in the last legacy option
|
|
Some legacy options take a comma separated list.
|
|
*/
|
|
if(j == legacy.length - 1 && splitted.length > legacy.length)
|
|
{
|
|
attrValue = splitted.slice(j);
|
|
}
|
|
|
|
let attr = et2_attribute_registry[_proto.constructor.name][legacy[j]] || {};
|
|
|
|
// If the attribute is marked as boolean, parse the
|
|
// expression as bool expression.
|
|
if(attr.type == "boolean")
|
|
{
|
|
attrValue = mgr.parseBoolExpression(attrValue);
|
|
}
|
|
else if(typeof attrValue != "object")
|
|
{
|
|
attrValue = mgr.expandName(attrValue);
|
|
}
|
|
_target[legacy[j]] = attrValue;
|
|
}
|
|
}
|
|
}
|
|
else if(attrName == "readonly" && typeof _target[attrName] != "undefined")
|
|
{
|
|
// do NOT overwrite already evaluated readonly attribute
|
|
}
|
|
else
|
|
{
|
|
let attrs = et2_attribute_registry[_proto.constructor.name] || {};
|
|
if(mgr != null && typeof attrs[attrName] != "undefined")
|
|
{
|
|
let attr = attrs[attrName];
|
|
|
|
// If the attribute is marked as boolean, parse the
|
|
// expression as bool expression.
|
|
if(attr.type == "boolean")
|
|
{
|
|
attrValue = mgr.parseBoolExpression(attrValue);
|
|
}
|
|
else
|
|
{
|
|
attrValue = mgr.expandName(attrValue);
|
|
}
|
|
}
|
|
|
|
// Set the attribute
|
|
_target[attrName] = attrValue;
|
|
}
|
|
}
|
|
}
|
|
|
|
transformAttributes(attrs)
|
|
{
|
|
transformAttributes(this, this.getArrayMgr("content"), attrs);
|
|
|
|
// Add in additional modifications
|
|
if(this.id && this.getArrayMgr("modifications")?.getEntry(this.id))
|
|
{
|
|
transformAttributes(this, this.getArrayMgr("content"), this.getArrayMgr("modifications").getEntry(this.id));
|
|
}
|
|
}
|
|
|
|
iterateOver(_callback : Function, _context, _type)
|
|
{
|
|
if(typeof _type == "undefined" || _type == et2_widget || et2_implements_registry[_type] && et2_implements_registry[_type](this))
|
|
{
|
|
_callback.call(_context, this);
|
|
}
|
|
|
|
// Ask children
|
|
for(let i = 0; i < this._children.length; i++)
|
|
{
|
|
this._children[i].iterateOver(_callback, _context, _type);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Needed for legacy compatability.
|
|
*
|
|
* @param {Promise[]} promises List of promises from widgets that are not done. Pass an empty array, it will be filled if needed.
|
|
*/
|
|
loadingFinished(promises : Promise<any>[])
|
|
{
|
|
if(typeof promises === "undefined")
|
|
{
|
|
promises = [];
|
|
}
|
|
// Note that WebComponents don't do anything here, their lifecycle is different
|
|
// This is just to support legacy widgets
|
|
let doLoadingFinished = () =>
|
|
{
|
|
/**
|
|
* This is needed mostly as a bridge between non-WebComponent widgets and
|
|
* connectedCallback(). It's not really needed if the whole tree is WebComponent.
|
|
* WebComponents can be added as children immediately after creation, and they handle the
|
|
* rest themselves with their normal lifecycle (especially connectedCallback(), which is kind
|
|
* of the equivalent of doLoadingFinished()
|
|
*/
|
|
// @ts-ignore this is not an et2_widget, so getDOMNode(this) is bad
|
|
if(!this._parent_node && this.getParent() instanceof et2_widget && (<et2_DOMWidget>this.getParent()).getDOMNode(this) != this.parentNode)
|
|
{
|
|
// @ts-ignore this is not an et2_widget, and Et2Widget is not a Node
|
|
(<et2_DOMWidget>this.getParent()).getDOMNode(this).append(this);
|
|
}
|
|
|
|
// An empty text node causes problems with legacy widget children
|
|
// It throws off their insertion indexing, making them get added in the wrong place
|
|
if(this.childNodes[0]?.nodeType == this.TEXT_NODE)
|
|
{
|
|
this.removeChild(this.childNodes[0]);
|
|
}
|
|
for(let i = 0; i < this.getChildren().length; i++)
|
|
{
|
|
let child = this.getChildren()[i];
|
|
|
|
child.loadingFinished(promises);
|
|
}
|
|
};
|
|
doLoadingFinished();
|
|
|
|
promises.push(this.getUpdateComplete());
|
|
}
|
|
|
|
getWidgetById(_id)
|
|
{
|
|
if(this.id == _id)
|
|
{
|
|
return this;
|
|
}
|
|
if(this.getChildren().length == 0)
|
|
{
|
|
return null;
|
|
}
|
|
|
|
let check_children = children =>
|
|
{
|
|
for(let i = 0; i < children.length; i++)
|
|
{
|
|
let elem = children[i].getWidgetById(_id);
|
|
|
|
if(elem != null)
|
|
{
|
|
return elem;
|
|
}
|
|
}
|
|
if(this.id && _id.indexOf('[') > -1 && children.length)
|
|
{
|
|
let ids = (new et2_arrayMgr()).explodeKey(_id);
|
|
let widget : Et2WidgetClass = this;
|
|
for(let i = 0; i < ids.length && widget !== null; i++)
|
|
{
|
|
widget = widget.getWidgetById(ids[i]);
|
|
}
|
|
return widget;
|
|
}
|
|
};
|
|
|
|
return check_children(this.getChildren()) || null;
|
|
}
|
|
|
|
/**
|
|
* Parent is different than what is specified in the template / hierarchy.
|
|
* Find it and re-parent there.
|
|
*
|
|
* @param {string} parent
|
|
*/
|
|
set parent_node(parent : string | Element)
|
|
{
|
|
if(typeof parent === "string")
|
|
{
|
|
parent = document.querySelector("#" + parent);
|
|
}
|
|
if(parent)
|
|
{
|
|
parent.append(<Node><unknown>this);
|
|
this._parent_node = parent;
|
|
}
|
|
}
|
|
|
|
setParent(new_parent : Et2WidgetClass | et2_widget)
|
|
{
|
|
this._parent = new_parent;
|
|
|
|
if(this.id)
|
|
{
|
|
// Create a namespace for this object
|
|
if(this._createNamespace())
|
|
{
|
|
this.checkCreateNamespace();
|
|
}
|
|
}
|
|
// @ts-ignore
|
|
this._parent.addChild(this);
|
|
}
|
|
|
|
getParent() : Et2WidgetClass | et2_widget
|
|
{
|
|
if(this._parent)
|
|
{
|
|
return this._parent;
|
|
}
|
|
|
|
return null;
|
|
}
|
|
|
|
addChild(child : et2_widget | Et2WidgetClass)
|
|
{
|
|
if(this._children.indexOf(child) >= 0)
|
|
{
|
|
return;
|
|
}
|
|
if(child instanceof et2_widget)
|
|
{
|
|
// Type of et2_widget._parent is et2_widget, not Et2Widget. This might cause problems, but they
|
|
// should be fixed by getting rid of the legacy widget with problems
|
|
// @ts-ignore
|
|
child._parent = this;
|
|
|
|
// During legacy widget creation, the child's DOM node won't be available yet.
|
|
this._legacy_children.push(child);
|
|
let child_node = null;
|
|
try
|
|
{
|
|
//@ts-ignore Technically getDOMNode() is from et2_DOMWidget
|
|
child_node = typeof child.getDOMNode !== "undefined" ? child.getDOMNode(child) : null;
|
|
}
|
|
catch(e)
|
|
{
|
|
// Child did not give up its DOM node nicely but errored instead
|
|
}
|
|
if(child_node && child_node !== this)
|
|
{
|
|
this.append(child_node);
|
|
}
|
|
}
|
|
else
|
|
{
|
|
this.append(child);
|
|
}
|
|
this._children.push(child);
|
|
}
|
|
|
|
/**
|
|
* Get child widgets
|
|
* Use <obj>.children to get web component children
|
|
* @returns {et2_widget[]}
|
|
*/
|
|
getChildren()
|
|
{
|
|
return this._children;
|
|
}
|
|
|
|
getType() : string
|
|
{
|
|
return this.nodeName;
|
|
}
|
|
|
|
getDOMNode() : HTMLElement
|
|
{
|
|
return <HTMLElement><unknown>this;
|
|
}
|
|
|
|
/**
|
|
* Creates a copy of this widget.
|
|
*
|
|
* @param {et2_widget} _parent parent to set for clone, default null
|
|
*/
|
|
clone(_parent?) : Et2WidgetClass
|
|
{
|
|
// Default _parent to null
|
|
if(typeof _parent == "undefined")
|
|
{
|
|
_parent = null;
|
|
}
|
|
|
|
// Create the copy
|
|
let copy = <Et2WidgetClass>this.cloneNode();
|
|
copy.id = this._widget_id;
|
|
|
|
if(_parent)
|
|
{
|
|
copy.setParent(_parent);
|
|
}
|
|
else
|
|
{
|
|
// Copy a reference to the content array manager
|
|
copy.setArrayMgrs(this.getArrayMgrs());
|
|
|
|
// Pass on instance too
|
|
copy.setInstanceManager(this.getInstanceManager());
|
|
}
|
|
|
|
let widget_class = window.customElements.get(this.localName);
|
|
let properties = widget_class ? widget_class.properties : [];
|
|
for(let key in properties)
|
|
{
|
|
copy[key] = this[key];
|
|
}
|
|
|
|
// Keep the deferred properties
|
|
copy._deferred_properties = this._deferred_properties;
|
|
|
|
// Create a clone of all child widgets of the given object
|
|
for(let i = 0; i < this.getChildren().length; i++)
|
|
{
|
|
this.getChildren()[i].clone(copy);
|
|
}
|
|
|
|
return copy;
|
|
}
|
|
|
|
|
|
/**
|
|
* Sets the array manager for the given part
|
|
*
|
|
* @param {string} _part which array mgr to set
|
|
* @param {object} _mgr
|
|
*/
|
|
setArrayMgr(_part : string, _mgr : et2_arrayMgr)
|
|
{
|
|
this._mgrs[_part] = _mgr;
|
|
}
|
|
|
|
/**
|
|
* Returns the array manager object for the given part
|
|
*
|
|
* @param {string} managed_array_type name of array mgr to return
|
|
*/
|
|
getArrayMgr(managed_array_type : string) : et2_arrayMgr | null
|
|
{
|
|
if(this._mgrs && typeof this._mgrs[managed_array_type] != "undefined")
|
|
{
|
|
return this._mgrs[managed_array_type];
|
|
}
|
|
else if(this.getParent())
|
|
{
|
|
return this.getParent().getArrayMgr(managed_array_type);
|
|
}
|
|
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Sets all array manager objects - this function can be used to set the
|
|
* root array managers of the container object.
|
|
*
|
|
* @param {object} _mgrs
|
|
*/
|
|
setArrayMgrs(_mgrs)
|
|
{
|
|
this._mgrs = <et2_arrayMgr[]>et2_cloneObject(_mgrs);
|
|
}
|
|
|
|
/**
|
|
* Returns an associative array containing the top-most array managers.
|
|
*
|
|
* @param _mgrs is used internally and should not be supplied.
|
|
*/
|
|
getArrayMgrs(_mgrs? : object)
|
|
{
|
|
if(typeof _mgrs == "undefined")
|
|
{
|
|
_mgrs = {};
|
|
}
|
|
|
|
// Add all managers of this object to the result, if they have not already
|
|
// been set in the result
|
|
for(let key in this._mgrs)
|
|
{
|
|
if(typeof _mgrs[key] == "undefined")
|
|
{
|
|
_mgrs[key] = this._mgrs[key];
|
|
}
|
|
}
|
|
|
|
// Recursively applies this function to the parent widget
|
|
if(this._parent)
|
|
{
|
|
this._parent.getArrayMgrs(_mgrs);
|
|
}
|
|
|
|
return _mgrs;
|
|
}
|
|
|
|
/**
|
|
* Checks whether a namespace exists for this element in the content array.
|
|
* If yes, an own perspective of the content array is created. If not, the
|
|
* parent content manager is used.
|
|
*
|
|
* Constructor attributes are passed in case a child needs to make decisions
|
|
*/
|
|
checkCreateNamespace()
|
|
{
|
|
// Get the content manager
|
|
let mgrs = this.getArrayMgrs();
|
|
|
|
for(let key in mgrs)
|
|
{
|
|
let mgr = mgrs[key];
|
|
|
|
// Get the original content manager if we have already created a
|
|
// perspective for this node
|
|
if(typeof this._mgrs[key] != "undefined" && mgr.perspectiveData.owner == this)
|
|
{
|
|
mgr = mgr.parentMgr;
|
|
}
|
|
|
|
// Check whether the manager has a namespace for the id of this object
|
|
let entry = mgr.getEntry(this.id);
|
|
if(typeof entry === 'object' && entry !== null || this.id)
|
|
{
|
|
// The content manager has an own node for this object, so
|
|
// create an own perspective.
|
|
this._mgrs[key] = mgr.openPerspective(this, this.id);
|
|
}
|
|
else
|
|
{
|
|
// The current content manager does not have an own namespace for
|
|
// this element, so use the content manager of the parent.
|
|
delete (this._mgrs[key]);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Set the instance manager
|
|
* Normally this is not needed as it's set on the top-level container, and we just return that reference
|
|
*
|
|
*/
|
|
setInstanceManager(manager : etemplate2)
|
|
{
|
|
this._inst = manager;
|
|
}
|
|
|
|
/**
|
|
* Returns the instance manager
|
|
*
|
|
* @return {etemplate2}
|
|
*/
|
|
getInstanceManager()
|
|
{
|
|
if(this._inst != null)
|
|
{
|
|
return this._inst;
|
|
}
|
|
else if(this.getParent())
|
|
{
|
|
return this.getParent().getInstanceManager ? this.getParent().getInstanceManager() : null;
|
|
}
|
|
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Returns the base widget
|
|
* Usually this is the same as getInstanceManager().widgetContainer
|
|
*/
|
|
getRoot() : et2_container
|
|
{
|
|
if(this.getParent() != null)
|
|
{
|
|
return this.getParent().getRoot();
|
|
}
|
|
else
|
|
{
|
|
return <et2_container><unknown>this;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the path into the data array. By default, array manager takes care of
|
|
* this, but some extensions need to override this
|
|
*/
|
|
getPath()
|
|
{
|
|
let path = this.getArrayMgr("content")?.getPath() ?? [];
|
|
|
|
// Prevent namespaced widgets with value from going an extra layer deep
|
|
if(this.id && this._createNamespace() && path[path.length - 1] == this.id)
|
|
{
|
|
path.pop();
|
|
}
|
|
|
|
return path;
|
|
}
|
|
|
|
_createNamespace() : boolean
|
|
{
|
|
return false;
|
|
}
|
|
|
|
egw() : IegwAppLocal
|
|
{
|
|
if(this.getParent() != null && typeof this.getParent().egw === "function")
|
|
{
|
|
return (<et2_widget>this.getParent()).egw();
|
|
}
|
|
|
|
// Get the window this object belongs to
|
|
let wnd = null;
|
|
// @ts-ignore Technically this doesn't have implements(), but it's mixed in
|
|
if(this.implements(et2_IDOMNode))
|
|
{
|
|
let node = (<et2_IDOMNode><unknown>this).getDOMNode();
|
|
if(node && node.ownerDocument)
|
|
{
|
|
wnd = node.ownerDocument.parentNode || node.ownerDocument.defaultView;
|
|
}
|
|
}
|
|
|
|
// If we're the root object, return the phpgwapi API instance
|
|
return typeof egw === "function" ? egw('phpgwapi', wnd) : null;
|
|
}
|
|
}
|
|
|
|
// Add some more stuff in
|
|
applyMixins(Et2WidgetClass, [ClassWithInterfaces]);
|
|
|
|
return Et2WidgetClass;
|
|
}
|
|
export const Et2Widget = dedupeMixin(Et2WidgetMixin);
|
|
|
|
/**
|
|
* Load a Web Component
|
|
* @param _nodeName
|
|
* @param _template_node
|
|
* @param parent Parent widget
|
|
*/
|
|
// @ts-ignore Et2Widget is I guess not the right type
|
|
export function loadWebComponent(_nodeName : string, _template_node : Element|{[index: string]: any}, parent : Et2Widget|et2_widget|undefined) : HTMLElement
|
|
{
|
|
let attrs = {};
|
|
let load_children = true;
|
|
|
|
// support attributes object instead of an Element
|
|
if(typeof _template_node.getAttribute === 'undefined')
|
|
{
|
|
attrs = _template_node;
|
|
load_children = false;
|
|
}
|
|
else
|
|
{
|
|
_template_node.getAttributeNames().forEach(attribute =>
|
|
{
|
|
attrs[attribute] = _template_node.getAttribute(attribute);
|
|
});
|
|
}
|
|
|
|
// Try to find the class for the given node
|
|
let widget_class = window.customElements.get(_nodeName);
|
|
if(!widget_class)
|
|
{
|
|
// Given node has no registered class. Try some of our special things (remove type, fallback to actual node)
|
|
let tries = [_nodeName.split('-')[0]];
|
|
if (_template_node.nodeName) tries = tries.concat(_template_node.nodeName.toLowerCase());
|
|
for(let i = 0; i < tries.length && !window.customElements.get(_nodeName); i++)
|
|
{
|
|
_nodeName = tries[i];
|
|
}
|
|
widget_class = window.customElements.get(_nodeName);
|
|
if(!widget_class)
|
|
{
|
|
throw Error("Unknown or unregistered WebComponent '" + _nodeName + "', could not find class. Also checked for " + tries.join(','));
|
|
}
|
|
}
|
|
const readonly = parent?.getArrayMgr("readonlys") ?
|
|
(<any>parent.getArrayMgr("readonlys")).isReadOnly(
|
|
attrs["id"], attrs["readonly"],
|
|
typeof parent?.readonly !== "undefined" ? parent.readonly : false) : false;
|
|
if(readonly === true && typeof window.customElements.get(_nodeName + "_ro") != "undefined")
|
|
{
|
|
_nodeName += "_ro";
|
|
}
|
|
|
|
// @ts-ignore
|
|
let widget = <Et2Widget>document.createElement(_nodeName);
|
|
widget.textContent = _template_node.textContent;
|
|
|
|
if (parent) widget.setParent(parent);
|
|
|
|
// Set read-only. Doesn't really matter if it's a ro widget, but otherwise it needs set
|
|
widget.readOnly = readonly;
|
|
|
|
widget.transformAttributes(attrs);
|
|
|
|
// Children need to be loaded
|
|
if(load_children)
|
|
{
|
|
widget.loadFromXML(_template_node);
|
|
}
|
|
|
|
return widget;
|
|
}
|
|
|
|
/**
|
|
* Take attributes from a node in a .xet file and apply those to a WebComponent widget
|
|
*
|
|
* Any attributes provided that match a property (or attribute) on the widget will be adjusted according to
|
|
* the passed arrayManager, coerced into the proper type, and set.
|
|
* It is here that we find values or set attributes that should come from content.
|
|
*
|
|
* @param widget
|
|
* @param {et2_arrayMgr} mgr
|
|
* @param attributes
|
|
*/
|
|
function transformAttributes(widget, mgr : et2_arrayMgr, attributes)
|
|
{
|
|
const widget_class = window.customElements.get(widget.localName);
|
|
|
|
// Apply any set attributes - widget will do its own coercion
|
|
for(let attribute in attributes)
|
|
{
|
|
let attrValue = attributes[attribute];
|
|
|
|
// If there is no attribute set, ignore it. Widget sets its own default.
|
|
if(typeof attrValue === "undefined")
|
|
{
|
|
continue;
|
|
}
|
|
|
|
const property = widget_class.getPropertyOptions(attribute);
|
|
|
|
switch(typeof property === "object" ? property.type : property)
|
|
{
|
|
case Boolean:
|
|
if(typeof attrValue == "boolean")
|
|
{
|
|
// Already boolean, nothing needed
|
|
break;
|
|
}
|
|
// If the attribute is marked as boolean, parse the
|
|
// expression as bool expression.
|
|
attrValue = mgr ? mgr.parseBoolExpression(attrValue) : attrValue;
|
|
if(typeof attrValue === "string")
|
|
{
|
|
// Parse decided we still needed a string ($row most likely) so we'll defer it until later
|
|
// Repeating rows & nextmatch will parse it again when doing the row
|
|
widget.deferredProperties[attribute] = attrValue;
|
|
// Leave the current value at whatever the default is
|
|
continue;
|
|
}
|
|
break;
|
|
case Function:
|
|
// We parse it into a function here so we can pass in the widget as context.
|
|
// Leaving it to the LitElement conversion loses the widget as context
|
|
if(typeof attrValue !== "function")
|
|
{
|
|
attrValue = et2_compileLegacyJS(attrValue, widget, widget);
|
|
}
|
|
break;
|
|
default:
|
|
attrValue = mgr ? mgr.expandName("" + attrValue) : attrValue;
|
|
if(attrValue && !attributes.no_lang && widget_class.translate[attribute])
|
|
{
|
|
// allow attribute to contain multiple translated sub-strings eg: {Firstname}.{Lastname}
|
|
if(attrValue.indexOf('{') !== -1)
|
|
{
|
|
attrValue = attrValue.replace(/{([^}]+)}/g, function(str, p1)
|
|
{
|
|
return this.egw().lang(p1);
|
|
}.bind(widget));
|
|
}
|
|
else
|
|
{
|
|
attrValue = widget.egw().lang(attrValue);
|
|
}
|
|
}
|
|
break;
|
|
}
|
|
|
|
// TODO: Figure out how to bind handlers directly, since we can do that now
|
|
/* (handlers can only be bound _after_ the widget is added to the DOM
|
|
if(attribute.startsWith("on") && typeof attrValue == "function")
|
|
{
|
|
widget.addEventListener(attribute, attrValue);
|
|
}
|
|
*/
|
|
// Set as attribute or property, as appropriate. Don't set missing attributes.
|
|
if(widget.getAttributeNames().indexOf(attribute) >= 0 || property.reflect && attrValue)
|
|
{
|
|
// Set as attribute (reflected in DOM)
|
|
widget.setAttribute(attribute, attrValue);
|
|
}
|
|
else if (attribute === 'options')
|
|
{
|
|
console.trace('Ignored setting depricated "options" attribute for widget #'+widget.id, widget);
|
|
}
|
|
else
|
|
{
|
|
// Set as property, not attribute
|
|
widget[attribute] = attrValue;
|
|
}
|
|
}
|
|
|
|
if(widget_class.getPropertyOptions("value") && widget.set_value)
|
|
{
|
|
if(mgr != null)
|
|
{
|
|
let val = mgr.getEntry(widget.id, false, true);
|
|
if(val !== null)
|
|
{
|
|
widget.set_value(val);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Take the name of one of our images, find the full URL (including theme), and wrap it up so you can use it in a
|
|
* widget's css block.
|
|
*
|
|
* @example
|
|
* import {cssImage} from Et2Widget;
|
|
* ...
|
|
* static get styles()
|
|
* {
|
|
* return [
|
|
* ...super.styles,
|
|
* css`
|
|
* :host {
|
|
* background-image: ${cssImage("save")};
|
|
* }
|
|
* `];
|
|
* }
|
|
* @param image_name Name of the image
|
|
* @param app_name Optional, image is from an app instead of api
|
|
* @returns {CSSResult}
|
|
*/
|
|
export function cssImage(image_name : string, app_name? : string)
|
|
{
|
|
let url = egw?.image(image_name, app_name);
|
|
if(url)
|
|
{
|
|
return css`url(${unsafeCSS(url)})`;
|
|
}
|
|
else
|
|
{
|
|
return css``;
|
|
}
|
|
} |