egroupware_official/api/js/etemplate/et2_widget_link.ts
2022-05-27 14:11:35 -06:00

1580 lines
40 KiB
TypeScript

/**
* EGroupware eTemplate2 - JS Link object
*
* @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
* @copyright 2011 Nathan Gray
*/
/*egw:uses
/vendor/bower-asset/jquery/dist/jquery.js;
/vendor/bower-asset/jquery-ui/jquery-ui.js;
et2_core_inputWidget;
et2_core_valueWidget;
et2_widget_selectbox;
// Include menu system for list context menu
egw_action.egw_menu_dhtmlx;
*/
import {et2_createWidget, et2_register_widget, et2_widget, WidgetConfig} from "./et2_core_widget";
import {ClassWithAttributes} from "./et2_core_inheritance";
import {et2_valueWidget} from "./et2_core_valueWidget";
import {et2_inputWidget} from "./et2_core_inputWidget";
import {et2_selectbox} from "./et2_widget_selectbox";
import {et2_button} from "./et2_widget_button";
import {et2_file} from "./et2_widget_file";
import {et2_vfsSelect} from "./et2_widget_vfs";
import {egw} from "../jsapi/egw_global";
import {et2_tabbox} from "./et2_widget_tabs";
import {et2_csvSplit, et2_no_init} from "./et2_core_common";
import {et2_IDetachedDOM} from "./et2_core_interfaces";
import {et2_DOMWidget} from "./et2_core_DOMWidget";
import {Et2LinkList} from "./Et2Link/Et2LinkList";
import type {Et2LinkString} from "./Et2Link/Et2LinkString";
import {Et2Link} from "./Et2Link/Et2Link";
/**
* UI widgets for Egroupware linking system
*/
export class et2_link_to extends et2_inputWidget
{
static readonly _attributes: any = {
"only_app": {
"name": "Application",
"type": "string",
"default": "",
"description": "Limit to just this one application - hides app selection"
},
"application_list": {
"name": "Application list",
"type": "any",
"default": "",
"description": "Limit to the listed application or applications (comma seperated)"
},
"blur": {
"name": "Placeholder",
"type": "string",
"default": "",
"description": "This text get displayed if an input-field is empty and does not have the input-focus (blur). It can be used to show a default value or a kind of help-text.",
translate: true
},
"no_files": {
"name": "No files",
"type": "boolean",
"default": false,
"description": "Suppress attach-files"
},
"search_label": {
"name": "Search label",
"type": "string",
"default": "",
"description": "Label to use for search"
},
"link_label": {
"name": "Link label",
"type": "string",
"default": "Link",
"description": "Label for the link button"
},
"value": {
// Could be string or int if application is provided, or an Object
"type": "any"
}
};
private div: JQuery;
private link_button: JQuery;
private link_div: JQuery;
private filemanager_button: JQuery;
private file_div: JQuery;
private status_span: JQuery;
private link_entry: et2_link_entry;
private vfs_select: et2_vfsSelect;
private file_upload: et2_file;
/**
* Constructor
*
* @memberOf et2_link_to
*/
constructor(_parent: et2_widget, _attrs?: WidgetConfig, _child?: object)
{
super(_parent, _attrs, ClassWithAttributes.extendAttributes(et2_link_to._attributes, _child || {}));
this.div = jQuery(document.createElement("div")).addClass("et2_link_to et2_toolbar");
this.link_button = null;
this.status_span = null;
this.link_entry = null;
this.file_upload = null;
this.createInputWidget();
}
destroy()
{
this.link_button = null;
this.status_span = null;
if (this.link_entry)
{
this.link_entry.destroy();
this.link_entry = null;
}
if (this.file_upload)
{
this.file_upload.destroy();
this.file_upload = null;
}
this.div = null;
super.destroy.apply(this, arguments);
}
/**
* Override to provide proper node for sub widgets to go in
*
* @param {Object} _sender
*/
getDOMNode(_sender)
{
if (_sender == this)
{
return this.div[0];
}
else if (_sender._type == 'link-entry')
{
return this.link_div[0];
}
else if (_sender._type == 'file')
{
return this.file_div[0];
}
else if (_sender._type == 'vfs-select')
{
return this.filemanager_button[0];
}
}
createInputWidget()
{
// Need a div for file upload widget
this.file_div = jQuery(document.createElement("div")).css({display: 'inline-block'}).appendTo(this.div);
// Filemanager link popup
this.filemanager_button = jQuery(document.createElement("div")).css({display: 'inline-block'}).appendTo(this.div);
// Need a div for link-to widget
this.link_div = jQuery(document.createElement("div"))
.addClass('div_link')
// Leave room for link button
.appendTo(this.div);
if (!this.options.readonly)
{
// One common link button
this.link_button = jQuery(document.createElement("button"))
.text(this.egw().lang(this.options.link_label))
.appendTo(this.div).hide()
.addClass('link')
.click(this, this.createLink);
// Span for indicating status
this.status_span = jQuery(document.createElement("span"))
.appendTo(this.div).addClass("status").hide();
}
this.setDOMNode(this.div[0]);
}
doLoadingFinished()
{
super.doLoadingFinished.apply(this, arguments);
var self = this;
if (this.link_entry && this.vfs_select && this.file_upload)
{
// Already done
return false;
}
// Link-to
var link_entry_attrs = {
id: this.id + '_link_entry',
only_app: this.options.only_app,
application_list: this.options.application_list,
blur: this.options.search_label ? this.options.search_label : this.egw().lang('Search...'),
query: function ()
{
self.link_button.hide();
return true;
},
select: function ()
{
self.link_button.show();
return true;
},
readonly: this.options.readonly
};
this.link_entry = <et2_link_entry>et2_createWidget("link-entry", link_entry_attrs, this);
// Filemanager select
var select_attrs: any = {
button_label: egw.lang('Link'),
button_caption: '',
button_icon: 'link',
readonly: this.options.readonly,
dialog_title: egw.lang('Link'),
extra_buttons: [{text: egw.lang("copy"), id: "copy", image: "copy"},
{text: egw.lang("move"), id: "move", image: "move"}],
onchange: function ()
{
var values = true;
// If entry not yet saved, store for linking on server
if (!self.options.value.to_id || typeof self.options.value.to_id == 'object')
{
values = self.options.value.to_id || {};
var files = self.vfs_select.getValue();
if (typeof files !== 'undefined')
{
for (var i = 0; i < files.length; i++)
{
values['link:' + files[i]] = {
app: 'link',
id: files[i],
type: 'unknown',
icon: 'link',
remark: '',
title: files[i]
};
}
}
}
self._link_result(values);
}
};
// only set server-side callback, if we have a real application-id (not null or array)
// otherwise it only gives an error on server-side
if (self.options.value && self.options.value.to_id && typeof self.options.value.to_id != 'object')
{
select_attrs.method = 'EGroupware\\Api\\Etemplate\\Widget\\Link::ajax_link_existing';
select_attrs.method_id = self.options.value.to_app + ':' + self.options.value.to_id;
}
this.vfs_select = <et2_vfsSelect>et2_createWidget("vfs-select", select_attrs, this);
this.vfs_select.set_readonly(this.options.readonly);
// File upload
var file_attrs = {
multiple: true,
id: this.id + '_file',
label: '',
// Make the whole template a drop target
drop_target: this.getInstanceManager().DOMContainer.getAttribute("id"),
readonly: this.options.readonly,
// Change to this tab when they drop
onStart: function (event, file_count)
{
// Find the tab widget, if there is one
var tabs: et2_widget = self;
do
{
tabs = tabs.getParent();
}
while (tabs != self.getRoot() && tabs.getType() != 'tabbox');
if (tabs != self.getRoot())
{
(<et2_tabbox><unknown>tabs).activateTab(self);
}
return true;
},
onFinish: function (event, file_count)
{
event.data = self;
self.filesUploaded(event);
// Auto-link uploaded files
self.createLink(event);
}
};
this.file_upload = <et2_file>et2_createWidget("file", file_attrs, this);
this.file_upload.set_readonly(this.options.readonly);
return true;
}
getValue()
{
return this.options.value;
}
filesUploaded(event)
{
var self = this;
this.link_button.show();
}
/**
* Create a link using the current internal values
*
* @param {Object} event
*/
createLink(event)
{
// Disable link button
event.data.link_button.attr("disabled", true);
var values = event.data.options.value;
var self = event.data;
var links = [];
// Links to other entries
event.data = self.link_entry;
self.link_entry.createLink(event, links);
// Files
if (!self.options.no_files)
{
for (var file in self.file_upload.options.value)
{
links.push({
app: 'file',
id: file,
name: self.file_upload.options.value[file].name,
type: self.file_upload.options.value[file].type,
remark: jQuery("li[file='" + self.file_upload.options.value[file].name.replace(/'/g, '&quot') + "'] > input", self.file_upload.progress)
.filter(function ()
{
return jQuery(this).attr("placeholder") != jQuery(this).val();
}).val()
});
}
}
if (links.length == 0)
{
return;
}
var request = egw.json("EGroupware\\Api\\Etemplate\\Widget\\Link::ajax_link",
[values.to_app, values.to_id, links],
self._link_result,
self,
true,
self
);
request.sendRequest();
}
/**
* Sent some links, server has a result
*
* @param {Object} success
*/
_link_result(success)
{
if (success)
{
this.link_button.hide().attr("disabled", false);
this.status_span.removeClass("error").addClass("success");
this.status_span.fadeIn().delay(1000).fadeOut();
delete this.options.value.app;
delete this.options.value.id;
for (var file in this.file_upload.options.value)
{
delete this.file_upload.options.value[file];
}
this.file_upload.progress.empty();
// Server says it's OK, but didn't store - we'll send this again on submit
// This happens if you link to something before it's saved to the DB
if (typeof success == "object")
{
// Save as appropriate in value
if (typeof this.options.value != "object")
{
this.options.value = {};
}
this.options.value.to_id = success;
for (let link in success)
{
// Icon should be in registry
if (typeof success[link].icon == 'undefined')
{
success[link].icon = egw.link_get_registry(success[link].app, 'icon');
// No icon, try by mime type - different place for un-saved entries
if (success[link].icon == false && success[link].id.type)
{
// Triggers icon by mime type, not thumbnail or app
success[link].type = success[link].id.type;
success[link].icon = true;
}
}
// Special handling for file - if not existing, we can't ask for title
if (success[link].app == 'file' && typeof success[link].title == 'undefined')
{
success[link].title = success[link].id.name || '';
}
}
}
// Look for a link-list with the same ID, refresh it
var self = this;
var list_widget = null;
this.getRoot().iterateOver(
function (widget)
{
if (widget.id == self.id)
{
list_widget = widget;
if (success === true)
{
widget._get_links();
}
}
},
this, et2_link_list
);
// If there's an array of data (entry is not yet saved), updating the list will
// not work, so add them in explicitly.
if (list_widget && success)
{
// Clear list
list_widget.set_value(null);
// Add temp links in
for (var link_id in success)
{
let link = success[link_id];
if (typeof link.title == 'undefined')
{
// Callback to server for title
egw.link_title(link.app, link.id, true).then(title =>
{
link.title = title;
list_widget._add_link(link);
});
}
else
{
// Add direct
list_widget._add_link(link);
}
}
}
// Update any neighbouring link lists
(<Et2LinkList><unknown>(<et2_DOMWidget>this.getParent()).getDOMNode().querySelector('et2-link-list'))?.get_links(Object.values(success));
}
else
{
this.status_span.removeClass("success").addClass("error")
.fadeIn();
}
this.div.trigger('link.et2_link_to', success);
}
set_no_files(no_files)
{
if (this.options.readonly) return;
if (no_files)
{
this.file_div.hide();
this.filemanager_button.hide();
}
else
{
this.file_div.show();
this.filemanager_button.show();
}
this.options.no_files = no_files;
}
}
et2_register_widget(et2_link_to, ["link-to"]);
/**
* List of applications that support link
*/
export class et2_link_apps extends et2_selectbox
{
static readonly _attributes: any = {
"only_app": {
"name": "Application",
"type": "string",
"default": "",
"description": "Limit to just this one application - hides app selection"
},
"application_list": {
"name": "Application list",
"type": "any",
"default": "",
"description": "Limit to the listed application or applications (comma seperated)"
}
};
/**
* Constructor
*
*/
constructor(_parent: et2_widget, _attrs?: WidgetConfig, _child?: object)
{
super(_parent, _attrs, ClassWithAttributes.extendAttributes(et2_link_apps._attributes, _child || {}));
if (this.options.select_options != null)
{
// Preset to last application
if (!this.options.value)
{
this.set_value(egw.preference('link_app', this.egw().getAppName()));
}
// Register to update preference
var self = this;
this.input.bind("click", function ()
{
if (typeof self.options.value != 'undefined') var appname = self.options.value.to_app;
egw.set_preference(appname || self.egw().getAppName(), 'link_app', self.getValue());
});
}
}
/**
* We get some minor speedups by overriding parent searching and directly setting select options
*
* @param {Array} _attrs an array of attributes
*/
transformAttributes(_attrs)
{
var select_options = {};
// Limit to one app
if (_attrs.only_app)
{
select_options[_attrs.only_app] = this.egw().lang(_attrs.only_app);
}
else if (_attrs.application_list)
{
select_options = _attrs.application_list;
}
else
{
select_options = egw.link_app_list('query');
if (typeof select_options['addressbook-email'] !== 'undefined')
{
delete select_options['addressbook-email'];
}
}
_attrs.select_options = select_options;
super.transformAttributes(_attrs);
}
}
et2_register_widget(et2_link_apps, ["link-apps"]);
/**
* Search and select an entry for linking
*/
export class et2_link_entry extends et2_inputWidget
{
static readonly _attributes: any = {
"value": {
"type": "any",
"default": {}
},
"only_app": {
"name": "Application",
"type": "string",
"default": "",
"description": "Limit to just this one application - hides app selection"
},
"application_list": {
"name": "Application list",
"type": "any",
"default": "",
"description": "Limit to the listed applications (comma seperated)"
},
"app_icons": {
"name": "Application icons",
"type": "boolean",
"default": false,
"description": "Show application icons instead of names"
},
"blur": {
"name": "Placeholder",
"type": "string",
"default": et2_no_init,
"description": "This text get displayed if an input-field is empty and does not have the input-focus (blur). It can be used to show a default value or a kind of help-text.",
translate: true
},
"query": {
"name": "Query callback",
"type": "js",
"default": et2_no_init,
"description": "Callback before query to server. It will be passed the request & et2_link_entry objects. Must return true, or false to abort query."
},
"select": {
"name": "Select callback",
"type": "js",
"default": et2_no_init,
"description": "Callback when user selects an option. Must return true, or false to abort normal action."
}
};
public static readonly legacyOptions = ["only_app", "application_list"];
protected static readonly search_timeout = 500; //ms after change to send query
protected static readonly minimum_characters = 4; // Don't send query unless there's at least this many chars
private cache: any = {};
protected div: JQuery;
protected app_select: JQuery;
protected search: JQuery;
protected clear: JQuery;
protected link_button: JQuery;
private request: any;
private last_search: string;
processing: boolean = false;
/**
* Constructor
*
* @memberOf et2_link_entry
*/
constructor(_parent: et2_widget, _attrs?: WidgetConfig, _child?: object)
{
super(_parent, _attrs, ClassWithAttributes.extendAttributes(et2_link_entry._attributes, _child || {}));
this.search = null;
this.clear = null;
this.app_select = null;
this._oldValue = {
id: null,
app: this.options.value && this.options.value.app ? this.options.value.app : this.options.only_app
};
if (typeof this.options.value == 'undefined' || this.options.value == null)
{
this.options.value = {};
}
this.cache = {};
this.request = null;
this.createInputWidget();
var self = this;
jQuery(this.getInstanceManager().DOMContainer).on('clear', function ()
{
// We need to unbind events to prevent a second triggerd event handler
// (eg. setting a project in infolog edit dialog) when the widget gets cleared.
jQuery(self.getDOMNode()).off();
});
}
destroy()
{
super.destroy.apply(this, arguments);
this.div = null;
if (this.search.data("ui-autocomplete"))
{
this.search.autocomplete("destroy");
}
this.search = null;
this.clear = null;
this.app_select = null;
this.request = null;
}
createInputWidget()
{
var self = this;
this.div = jQuery(document.createElement("div")).addClass("et2_link_entry");
this.app_select = jQuery(document.createElement("et2-link-apps")).appendTo(this.div)
.on("change", function(e)
{
// Clear cache when app changes
self.cache = {};
// Update preference with new value
egw.set_preference(self.options.value.to_app || self.egw().getAppName(), 'link_app', self.app_select.val());
if(typeof self.options.value != 'object')
{
self.options.value = {};
}
self.options.value.app = self.app_select.val();
})
.attr("aria-label", egw.lang("linkapps"));
if (this.options.only_app)
{
this.app_select.val(this.options.only_app);
this.app_select.hide();
this.div.addClass("no_app");
}
else
{
// Now that options are in, set to last used app
this.app_select.val(this.options.value.app || '');
}
// Search input
this.search = jQuery(document.createElement("input"))
// .attr("type", "search") // Fake it for all browsers below
.focus(function ()
{
if (!self.options.only_app)
{
// Adjust width, leave room for app select & link button
self.div.removeClass("no_app");
self.app_select.show();
}
})
.blur(function (e)
{
if (self.div.has(e.relatedTarget).length) return;
if (self.options.app_icons)
{
// Adjust width, leave room for app select & link button
self.div.addClass("no_app");
}
else if (self.search.val())
{
if (self.options.only_app)
{
// Adjust width, leave room for app select & link button
self.div.addClass("no_app");
}
}
})
.attr("aria-label", egw.lang("Link search"))
.attr("role", "searchbox")
.appendTo(this.div);
this.set_blur(this.options.blur ? this.options.blur : this.egw().lang("search"), this.search);
// Autocomplete
/*
this.search.autocomplete({
source: function (request, response)
{
return self.query(request, response);
},
select: function (event, item)
{
event.data = self;
// Correct changed value from server
if (item.item.value)
{
item.item.value = ("" + item.item.value).trim();
}
self.select(event, item);
return false;
},
focus: function (event, item)
{
event.stopPropagation();
self.search.val(item.item.label);
return false;
},
minLength: et2_link_entry.minimum_characters,
delay: et2_link_entry.search_timeout,
disabled: self.options.disabled,
appendTo: self.div
});
*/
// Custom display (colors)
/*
this.search.data("uiAutocomplete")._renderItem = function (ul, item)
{
var li = jQuery(document.createElement('li'))
.data("item.autocomplete", item);
var extra: any = {};
// Extra stuff
if (typeof item.label == 'object')
{
extra = item.label;
item.label = extra.label ? extra.label : extra;
if (extra['style.backgroundColor'] || extra.color)
{
li.css({'border-left': '5px solid ' + (extra.color ? extra.color : extra['style.backgroundColor'])});
}
// Careful with this, some browsers may have trouble loading all at once, which can slow display
if (extra.icon)
{
var img = self.egw().image(extra.icon);
if (img)
{
jQuery(document.createElement("img"))
.attr("src", img)
.css("float", "right")
.appendTo(li);
}
}
}
// Normal stuff
li.append(jQuery("<a></a>").text(item.label))
.appendTo(ul);
window.setTimeout(function ()
{
ul.css('max-width', jQuery('.et2_container').width() - ul.offset().left);
}, 300);
return li;
};
*/
// Bind to enter key to start search early
this.search.keydown(function(e)
{
var keycode = (e.keyCode ? e.keyCode : e.which);
if(keycode == 13 && !self.processing)
{
self.search.autocomplete("option", "minLength", 0);
self.search.autocomplete("search");
self.search.autocomplete("option", "minLength", self.minimum_characters);
return false;
}
});
// Clear / last button
this.clear = jQuery(document.createElement("span"))
.addClass("ui-icon ui-icon-close")
.click(function (e)
{
if (!self.search) return; // only gives an error, we should never get into that situation
// No way to tell if the results is open, so if they click the button while open, it clears
if (self.last_search && self.last_search != self.search.val())
{
// Repeat last search (should be cached)
self.search.val(self.last_search);
self.last_search = "";
self.search.autocomplete("search");
}
else
{
// Clear
self.search.autocomplete("close");
self.set_value(null);
self.search.val("");
// call trigger, after finishing this handler, not in the middle of it
window.setTimeout(function ()
{
self.search.trigger("change");
}, 0);
}
self.search.focus();
})
.appendTo(this.div)
.hide();
this.setDOMNode(this.div[0]);
}
getDOMNode()
{
return this.div ? this.div[0] : null;
}
transformAttributes(_attrs)
{
super.transformAttributes.apply(this, arguments);
_attrs["select_options"] = {};
if (_attrs["application_list"])
{
var apps = (typeof _attrs["application_list"] == "string") ? et2_csvSplit(_attrs["application_list"], null, ",") : _attrs["application_list"];
for (var i = 0; i < apps.length; i++)
{
_attrs["select_options"][apps[i]] = this.egw().lang(apps[i]);
}
}
else
{
_attrs["select_options"] = this.egw().link_app_list('query');
if (typeof _attrs["select_options"]["addressbook-email"] != 'undefined') delete _attrs["select_options"]["addressbook-email"];
}
// Check whether the options entry was found, if not read it from the
// content array.
if (_attrs["select_options"] == null)
{
_attrs["select_options"] = this.getArrayMgr('content')
.getEntry("options-" + this.id);
}
// Default to an empty object
if (_attrs["select_options"] == null)
{
_attrs["select_options"] = {};
}
}
doLoadingFinished()
{
if (typeof this.options.value == 'object' && !this.options.value.app)
{
this.options.value.app = egw.preference('link_app', this.options.value.to_app || this.egw().getAppName());
// If there's no value set for app, then take the first one from the selectbox
if (typeof this.options.value.app == 'undefined' || !this.options.value.app)
{
this.options.value.app = Object.keys(this.options.select_options)[0];
}
this.app_select.val(this.options.value.app);
}
return super.doLoadingFinished.apply(this, arguments);
}
getValue()
{
var value = this.options && this.options.only_app ? this.options.value.id : this.options ? this.options.value : null;
if (this.options && !this.options.only_app && this.search)
{
value.search = this.search.val();
}
return value;
}
set_value(_value)
{
if (typeof _value == 'string' || typeof _value == 'number')
{
if (typeof _value == 'string' && _value.indexOf(",") > 0) _value = _value.replace(",", ":");
if (typeof _value == 'string' && _value.indexOf(":") >= 0)
{
var split = _value.split(":");
_value = {
app: split.shift(),
id: split.length == 1 ? split[0] : split
};
}
else if (_value && this.options.only_app)
{
_value = {
app: this.options.only_app,
id: _value
};
}
}
// display a search query, not a selected entry
else if (_value !== null && typeof _value === 'object' && typeof _value.query === 'string')
{
this.options.value = { app: _value.app || this.options.only_app, id: null };
this.search.val(_value.query);
return;
}
this._oldValue = this.options.value;
if (!_value || _value.length == 0 || _value == null || jQuery.isEmptyObject(_value))
{
this.search.val("");
this.clear.hide();
this.options.value = _value = {'id': null};
}
if (!_value.app) _value.app = this.options.only_app || this.app_select.val();
if (_value.id)
{
// Remove specific display and revert to CSS file
// show() would use inline, should be inline-block
this.clear.css('display', '');
}
else
{
this.clear.hide();
return;
}
if (typeof _value != 'object' || (!_value.app && !_value.id))
{
console.warn("Bad value for link widget. Need an object with keys 'app', 'id', and optionally 'title'", _value);
return;
}
if (!_value.title)
{
var title = this.egw().link_title(_value.app, _value.id, false);
if (title != null)
{
_value.title = title;
}
else
{
// Title will be fetched from server and then set
var title = this.egw().link_title(_value.app, _value.id, true).then(title =>
{
this.search.removeClass("loading").val(title + "");
// Remove specific display and revert to CSS file
// show() would use inline, should be inline-block
this.clear.css('display', '');
});
this.search.addClass("loading");
}
}
if (_value.title)
{
this.search.val(_value.title + "");
}
this.options.value = _value;
jQuery("option[value='" + _value.app + "']", this.app_select).prop("selected", true);
this.app_select.hide();
this.div.addClass("no_app");
}
set_blur(_value, input)
{
if (typeof input == 'undefined') input = this.search;
if (_value)
{
input.attr("placeholder", _value); // HTML5
if (!input[0].placeholder)
{
// Not HTML5
if (input.val() == "") input.val(_value);
input.focus(input, function (e)
{
var placeholder = _value;
if (e.data.val() == placeholder) e.data.val("");
}).blur(input, function (e)
{
var placeholder = _value;
if (e.data.val() == "") e.data.val(placeholder);
});
if (input.val() == "")
{
input.val(_value);
}
}
}
else
{
this.search.removeAttr("placeholder");
}
}
/**
* Set the query callback
*
* @param {function} f
*/
set_query(f)
{
this.options.query = f;
}
/**
* Set the select callback
*
* @param {function} f
*/
set_select(f)
{
this.options.select = f;
}
/**
* Ask server for entries matching selected app/type and filtered by search string
*
* @param {Object} request
* @param {Object} response
*/
query(request, response)
{
// If there is a pending request, abort it
if (this.request)
{
this.request.abort();
this.request = null;
}
// Remember last search
this.last_search = this.search.val();
// Allow hook / tie in
if (this.options.query && typeof this.options.query == 'function')
{
if (!this.options.query(request, this)) return false;
}
if ((typeof request.no_cache == 'undefined' && !request.no_cache) && request.term in this.cache)
{
return response(this.cache[request.term]);
}
this.search.addClass("loading");
// Remove specific display and revert to CSS file
// show() would use inline, should be inline-block
this.clear.css('display', '');
this.request = egw.request("EGroupware\\Api\\Etemplate\\Widget\\Link::ajax_link_search",
[this.app_select.val(), '', request.term, request.options]);
this.request.then((data) =>
{
if (this.request)
{
this.request = null;
}
this.search.removeClass("loading");
let result = [];
for (var id in data)
{
result.push({"value": id, "label": data[id]});
}
this.cache[this.search.val()] = result;
response(result);
});
}
/**
* User selected a value
*
* @param {Object} event
* @param {Object} selected
*
*/
select(event, selected)
{
if (selected.item.value !== null && typeof selected.item.value == "string")
{
// Correct changed value from server
selected.item.value = selected.item.value.trim();
}
if (this.options.select && typeof this.options.select == 'function')
{
if (!this.options.select(event, selected)) return false;
}
if (typeof event.data.options.value != 'object' || event.data.options.value == null)
{
event.data.options.value = {};
}
event.data.options.value.id = selected.item.value;
// Set a processing flag to filter some events
event.data.processing = true;
// Remove specific display and revert to CSS file
// show() would use inline, should be inline-block
this.clear.css('display', '');
event.data.search.val(selected.item.label);
// Fire change event
this.search.change();
// Turn off processing flag when done
window.setTimeout(jQuery.proxy(function ()
{
delete this.processing;
}, event.data));
}
/**
* Create a link using the current internal values
*
* @param {Object} event
* @param {Object} _links
*/
createLink(event, _links)
{
var values = event.data.options.value;
var self = event.data;
var links = [];
if (typeof _links == 'undefined')
{
links = [];
}
else
{
links = _links;
}
// Links to other entries
if (values.id)
{
links.push({
app: values.app,
id: values.id
});
self.search.val("");
}
// If a link array was passed in, don't make the ajax call
if (typeof _links == 'undefined')
{
var request = egw.json("EGroupware\\Api\\Etemplate\\Widget\\Link::ajax_link",
[values.to_app, values.to_id, links],
self._link_result,
this,
true
);
request.sendRequest();
}
}
/**
* Sent some links, server has a result
*
* @param {Object} success
*
*/
_link_result(success)
{
if (success)
{
this.status_span.fadeIn().delay(1000).fadeOut();
delete this.options.value.app;
delete this.options.value.id;
}
}
}
et2_register_widget(et2_link_entry, ["link-entry"]);
/**
* @deprecated use Et2Link
*/
export type et2_link = Et2Link;
/**
* UI widget for a single (read-only) link
*
*/
export class et2_link_entry_ro extends et2_valueWidget implements et2_IDetachedDOM
{
static readonly _attributes: any = {
"only_app": {
"name": "Application",
"type": "string",
"default": "",
"description": "Use the given application, so you can pass just the ID for value"
},
"value": {
description: "Array with keys app, id, and optionally title",
type: "any"
},
"needed": {
"ignore": true
},
"link_hook": {
"name": "Type",
"type": "string",
"default": "view",
"description": "Hook used for displaying link (view/edit/add)"
},
"target_app": {
"name": "Target application",
"type": "string",
"default": "",
"description": "Optional parameter to be passed to egw().open in order to open links in specified application"
},
"extra_link_target": {
"name": "Link target",
"type": "string",
"default": null,
"description": "Optional parameter to be passed to egw().open in order to open links in specified target eg. _blank"
},
"break_title": {
"name": "break title",
"type": "string",
"default": null,
"description": "Breaks title into multiple lines based on selected delimiter by replacing it with '\r\n'"
}
};
public static readonly legacyOptions = ["only_app"];
private label_span: JQuery;
private link: JQuery;
/**
* Constructor
*
* @memberOf et2_link
*/
constructor(_parent: et2_widget, _attrs?: WidgetConfig, _child?: object)
{
super(_parent, _attrs, ClassWithAttributes.extendAttributes(et2_valueWidget._attributes, _child || {}));
this.label_span = jQuery(document.createElement("label"))
.addClass("et2_label");
this.link = jQuery(document.createElement("span"))
.addClass("et2_link")
.appendTo(this.label_span);
if (this.options['class']) this.label_span.addClass(this.options['class']);
this.setDOMNode(this.label_span[0]);
}
destroy()
{
if (this.link) this.link.unbind();
this.link = null;
super.destroy.apply(this, arguments);
}
set_label(label)
{
// Remove current label
this.label_span.contents()
.filter(function ()
{
return this.nodeType == 3;
}).remove();
var parts = et2_csvSplit(label, 2, "%s");
this.label_span.prepend(parts[0]);
this.label_span.append(parts[1]);
this.label = label;
// add class if label is empty
this.label_span.toggleClass('et2_label_empty', !label || !parts[0]);
}
set_value(_value)
{
if (typeof _value != 'object' && _value && !this.options.only_app)
{
if (_value.indexOf(':') >= 0)
{
var app = _value.split(':', 1);
var id = _value.substr(app[0].length + 1);
_value = {'app': app[0], 'id': id};
}
else
{
console.warn("Bad value for link widget. Need an object with keys 'app', 'id', and optionally 'title'", _value);
return;
}
}
// Application set, just passed ID
else if (typeof _value != "object")
{
_value = {
app: this.options.only_app,
id: _value
};
}
if (!_value || jQuery.isEmptyObject(_value))
{
this.link.text("").unbind();
return;
}
var self = this;
this.link.unbind();
if (_value.id && _value.app)
{
this.link.addClass("et2_link");
this.link.click(function (e)
{
// try to fetch value.title if it wasn't fetched during initiation.
if (!_value.title) _value.title = self.egw().link_title(_value.app, _value.id, false);
if (!self.options.target_app)
{
self.options.target_app = _value.app;
}
const target = self.options.extra_link_target || _value.app;
self.egw().open(_value, "", self.options.link_hook, _value.extra_args, target, self.options.target_app);
e.stopImmediatePropagation();
});
}
else
{
this.link.removeClass("et2_link");
}
if (!_value.title)
{
const node = this.link[0];
if (_value.app && _value.id)
{
this.egw().link_title(_value.app, _value.id, true).then(title =>
{
this.set_title(node, title);
});
// Title will be fetched from server and then set
return;
}
_value.title = "";
}
this.set_title(this.link, _value.title);
}
/**
* Sets the text to be displayed.
* Used as a callback, so node is provided to make sure we get the right one
*
* @param {Object} node
* @param {String} _value description
*/
set_title(node, _value)
{
if (_value === false || _value === null) _value = "";
if (this.options.break_title)
{
// Set up title to optionally break on the provided character - replace all space with nbsp, add a
// zero-width space after the break string
_value = _value
.replace(this.options.break_title, this.options.break_title.trimEnd() + "\u200B")
.replace(/ /g, '\u00a0');
}
jQuery(node).text(_value + "");
}
/**
* Creates a list of attributes which can be set when working in the
* "detached" mode. The result is stored in the _attrs array which is provided
* by the calling code.
*
* @param {Array} _attrs an array of attributes
*/
getDetachedAttributes(_attrs)
{
_attrs.push("label", "value");
}
/**
* Returns an array of DOM nodes. The (relatively) same DOM-Nodes have to be
* passed to the "setDetachedAttributes" function in the same order.
*/
getDetachedNodes()
{
return [this.node, this.link[0]];
}
/**
* Sets the given associative attribute->value array and applies the
* attributes to the given DOM-Node.
*
* @param _nodes is an array of nodes which have to be in the same order as
* the nodes returned by "getDetachedNodes"
* @param _values is an associative array which contains a subset of attributes
* returned by the "getDetachedAttributes" function and sets them to the
* given values.
*/
setDetachedAttributes(_nodes, _values)
{
this.node = _nodes[0];
this.label_span = jQuery(_nodes[0]);
this.link = jQuery(_nodes[1]);
if (typeof _values["id"] !== "undefined") this.set_id(_values['id']);
if (typeof _values["label"] !== "undefined") this.set_label(_values['label']);
if (typeof _values["value"] !== "undefined") this.set_value(_values["value"]);
}
}
et2_register_widget(et2_link_entry_ro, ["link-entry_ro"]);
/**
* UI widget for one or more links, comma separated
*
* @deprecated use Et2LinkString
*/
export type et2_link_string = Et2LinkString;
/**
* UI widget for one or more links in a list (table)
*
* @deprecated use Et2LinkList
*/
// can't just define as type, as tracker/app.ts uses it with iterateOver()!
// export type et2_link_list = Et2LinkList;
export class et2_link_list extends Et2LinkList {}
/**
*
*
*/
export class et2_link_add extends et2_inputWidget
{
static readonly _attributes: any = {
"value": {
"description": "Either an array of link information (see egw_link::link()) or array with keys to_app and to_id",
"type": "any"
},
"application": {
"name": "Application",
"type": "string",
"default": "",
"description": "Limit to the listed application or applications (comma seperated)"
}
};
private span: JQuery;
private div: JQuery;
private app_select: et2_link_apps;
private button: et2_button;
/**
* Constructor
*/
constructor(_parent: et2_widget, _attrs?: WidgetConfig, _child?: object)
{
super(_parent, _attrs, ClassWithAttributes.extendAttributes(et2_link_add._attributes, _child || {}));
this.span = jQuery(document.createElement("span"))
.text(this.egw().lang("Add new"))
.addClass('et2_link_add_span');
this.div = jQuery(document.createElement("div")).append(this.span);
this.setDOMNode(this.div[0]);
}
doLoadingFinished()
{
super.doLoadingFinished.apply(this, arguments);
if (this.app_select && this.button)
{
// Already done
return false;
}
this.app_select = <et2_link_apps>et2_createWidget("link-apps", jQuery.extend({}, this.options, {
'id': this.options.id + 'app',
value: this.options.application ? this.options.application : this.options.value && this.options.value.add_app ? this.options.value.add_app : null,
application_list: this.options.application ? this.options.application : null
}), this);
this.div.append(this.app_select.getDOMNode());
this.button = <et2_button>et2_createWidget("button", {
id: this.options.id + "_add",
label: this.egw().lang("add")
}, this);
this.button.set_label(this.egw().lang("add"));
var self = this;
this.button.click = function ()
{
self.egw().open(self.options.value.to_app + ":" + self.options.value.to_id, self.app_select.get_value(), 'add');
return false;
};
this.div.append(this.button.getDOMNode());
return true;
}
/**
* Should be handled client side.
* Return null to avoid overwriting other link values, in case designer used the same ID for multiple widgets
*/
getValue()
{
return null;
}
}
et2_register_widget(et2_link_add, ["link-add"]);