egroupware_official/api/js/etemplate/Et2Link/Et2LinkList.ts

651 lines
17 KiB
TypeScript

/**
* EGroupware eTemplate2 - JS Link list 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 2022 Nathan Gray
*/
import {css, html, repeat, TemplateResult} from "@lion/core";
import {Et2Link, LinkInfo} from "./Et2Link";
import {egw} from "../../jsapi/egw_global";
import {Et2LinkString} from "./Et2LinkString";
import {egwMenu} from "../../egw_action/egw_menu";
import {Et2Dialog} from "../Et2Dialog/Et2Dialog";
import {et2_vfsSelect} from "../et2_widget_vfs";
import {et2_createWidget} from "../et2_core_widget";
/**
* Display a list of entries in a comma separated list
*
* Given an application & entry ID, will query the list of links and display
*
* @see Et2Link
*
* To make things easy and consistent for ExposeMixin, we don't want children in the shadow dom, so they are slotted
* in. When rendering we generate a slot for each link, then let browser slot them in using the slot name.
*
* Templates:
* _listTemplate - generates the list
* _rowTemplate - creates the slots
* _linkTemplate - generates the content _inside_ each slot
* _thumbnailTemplate - generates the thumbnail image
*/
// @ts-ignore TypeScript says there's something wrong with types
export class Et2LinkList extends Et2LinkString
{
static get styles()
{
return [
...super.styles,
css`
:host {
display: flex;
flex-direction: column;
column-gap: 10px;
overflow: hidden;
}
div {
display: flex;
gap: 10px;
}
div:hover {
background-color: var(--highlight-background-color);
}
div.zip_highlight {
animation-name: new_entry_pulse, new_entry_clear;
animation-duration: 5s;
animation-delay: 0s, 30s;
animation-fill-mode: forwards;
}
/* CSS for child elements */
::slotted(*):after {
/* Reset from Et2LinkString */
content: initial;
}
::slotted(*)::part(icon) {
width: 1rem;
}
::slotted(et2-link) {
flex: 1 1 auto;
}
::slotted(.remark) {
flex: 1 1 auto;
width: 20%;
}
::slotted(.delete_button) {
visibility: hidden;
width: 16px;
order: 5;
}
`
];
}
static get properties()
{
return {
...super.properties,
// JS code which is executed when the links change
onchange: {type: Function},
// Does NOT allow user to enter data, just displays existing data
// Disables delete, etc.
readonly: {type: Boolean}
}
}
constructor()
{
super();
this.readonly = false;
this._handleRowHover = this._handleRowHover.bind(this);
this._handleRowContext = this._handleRowContext.bind(this);
this._handleChange = this._handleChange.bind(this);
this._handleLinkToChange = this._handleLinkToChange.bind(this);
}
connectedCallback()
{
super.connectedCallback();
this._createContextMenu();
// Look for LinkTo and listen for change so we can update
if(this.getInstanceManager())
{
this.getInstanceManager().DOMContainer.querySelectorAll("et2-link-to").forEach(link =>
{
link.addEventListener("et2-change", this._handleLinkToChange);
})
}
this.addEventListener("change", this._handleChange);
}
disconnectedCallback()
{
super.disconnectedCallback();
if(this.getInstanceManager())
{
this.getInstanceManager().DOMContainer.querySelectorAll("et2-link-to").forEach(link =>
{
link.removeEventListener("et2-change", this._handleLinkToChange);
})
}
this.removeEventListener("change", this._handleChange);
}
protected _listTemplate()
{
return html`
${repeat(this._link_list,
(link) => link.app + ":" + link.id,
(link) => this._rowTemplate(link))
}`;
}
/**
* Render a list of links inside the list
* These get put inside the shadow dom rather than slotted
*
* @param links
* @protected
*/
protected _addLinks(links : LinkInfo[])
{
this._link_list = links;
this.requestUpdate();
this.updateComplete.then(() => super._addLinks(links));
}
/**
* Render one link
* These elements are slotted and are found in the light DOM (use this.querySelector(...) to find them)
*
* @param link
* @returns {TemplateResult}
* @protected
*/
protected _linkTemplate(link) : TemplateResult
{
const id = typeof link.id === "string" ? link.id : link.link_id;
return html`
<et2-link slot="${this._get_row_id(link)}" app="${link.app}" entryId="${id}" statustext="${link.title}"
._parent=${this}
.value=${link}></et2-link>
${this._deleteButtonTemplate(link)}
`;
}
/**
* Render the row for one link.
* This is just the structure and slot, actual row contents are done in _linkTemplate.
* These rows are found in the shadowRoot. Use this.shadowRoot.querySelector(...) to find them.
*
* @param link
* @returns {TemplateResult}
* @protected
*/
protected _rowTemplate(link) : TemplateResult
{
return html`
<div id="${this._get_row_id(link)}"
@mouseover=${this._handleRowHover}
@mouseout=${this._handleRowHover}
@contextmenu=${this._handleRowContext}>
<slot name="${this._get_row_id(link)}"></slot>
</div>`;
}
/**
* Handle show/hide delete button
* @param _ev
* @protected
*/
protected _handleRowHover(_ev)
{
if(this.readonly)
{
return;
}
let slot_name = "";
let target = _ev.target;
// Fist check if target is the row div
if(target.firstElementChild?.localName == "slot")
{
slot_name = target.firstElementChild.name;
}
do
{
// Look up tree for the slot
if(target.slot)
{
slot_name = target.slot;
}
target = target.parentNode;
}
while(!slot_name && target.parentNode)
if(!slot_name)
{
return;
}
if(_ev.type == "mouseout")
{
this.querySelectorAll(".delete_button").forEach(b => b.style.visibility = "");
}
if(_ev.type == "mouseover")
{
this.querySelector(".delete_button[slot='" + slot_name + "']").style.visibility = "initial";
}
}
/**
* Handle & pass on an internal change
* @param {ChangeEvent} _event
* @protected
*/
protected _handleChange(_event : Event)
{
if(!this.onchange)
{
return;
}
this.onchange(this, _event.data, _event)
}
/**
* We listen to LinkTo widgets so we can update
*
* @param _ev
* @protected
*/
protected _handleLinkToChange(_ev)
{
if(_ev && typeof _ev.currentTarget)
{
this.get_links(_ev.detail || []);
}
}
/**
* Build the delete button
*
* @param {LinkInfo} link
* @returns {TemplateResult}
* @protected
*/
protected _deleteButtonTemplate(link : LinkInfo) : TemplateResult
{
if(this.readonly)
{
return html``;
}
return html`
<et2-image class="delete_button" slot="${this._get_row_id(link)}" src="delete"
part="delete-button"
._parent=${this}
.onclick=${() =>
{
this._delete_link(link);
}}
aria-label="${this.egw().lang(link.app === "file" ? "Delete" : "Unlink")}"
>
</et2-image>`;
}
/**
* Get an ID for a link
* @param {LinkInfo} link
* @protected
*/
protected _get_row_id(link : any) : string
{
return "link_" + (link.dom_id ? link.dom_id : (typeof link.link_id == "string" ? link.link_id.replace(/[:.]/g, '_') : link.link_id || link.id));
}
/**
* Delete a link
* @protected
*/
protected _delete_link(link : LinkInfo)
{
let link_element = <HTMLElement>this.querySelector("et2-link[slot='" + this._get_row_id(link) + "']");
link_element.classList.add("loading");
this.dispatchEvent(new CustomEvent("et2-before-delete", {detail: link}));
let removeLink = () =>
{
this.querySelectorAll("[slot='" + this._get_row_id(link) + "']").forEach(e => e.remove());
if(this._link_list.indexOf(link) != -1)
{
this._link_list.splice(this._link_list.indexOf(link), 1);
}
this.dispatchEvent(new CustomEvent("et2-delete", {bubbles: true, detail: link}));
let change = new Event("change", {bubbles: true});
change['data'] = link;
this.dispatchEvent(change);
};
// Unsaved entry, had no ID yet
if(!this.entryId || typeof this.entryId !== "string" && this.entryId[link.link_id])
{
if(this.entryId)
{
delete this.entryId[link.link_id];
}
removeLink();
}
else if(typeof this.entryId == "string" && link.link_id)
{
egw.json("EGroupware\\Api\\Etemplate\\Widget\\Link::ajax_delete", [link.link_id]).sendRequest()
.then((data) =>
{
if(data)
{
removeLink();
}
});
}
}
/**
* Handle values passed as an array
*
* @param _value
*/
set value(_value : { to_app : string, to_id : string } | LinkInfo[])
{
this._link_list = [];
// Handle case where server passed a list of links that aren't ready yet
if(_value && typeof _value == "object")
{
let list = [];
if(!Array.isArray(_value) && _value.to_id && typeof _value.to_id == "object")
{
list = _value.to_id;
}
else if(Array.isArray(_value) && _value.length)
{
list = _value;
}
if(list.length > 0)
{
for(let id in list)
{
let link = list[id];
if(!link.app && typeof list.splice !== "undefined")
{
list.splice(parseInt(id), 1);
continue;
}
else if(link.app)
{
// Temp IDs can cause problems since the ID includes the file name or :
if(link.link_id && typeof link.link_id != 'number')
{
link.dom_id = 'temp_' + egw.uid();
}
// Icon should be in registry
if(!link.icon)
{
link.icon = egw.link_get_registry(link.app, 'icon');
// No icon, try by mime type - different place for un-saved entries
if(link.icon == false && link.id.type)
{
// Triggers icon by mime type, not thumbnail or app
link.type = link.id.type;
link.icon = true;
}
}
// Special handling for file - if not existing, we can't ask for title
if(typeof link.id == 'object' && !link.title)
{
link.title = link.id.name || '';
}
}
}
this._addLinks(list);
}
else
{
super.set_value(_value);
}
}
}
protected _createContextMenu()
{
// Set up context menu
this.context = new egwMenu();
this.context.addItem("comment", this.egw().lang("Comment"), "", () =>
{
Et2Dialog.show_prompt(
(button, comment) =>
{
if(button != Et2Dialog.OK_BUTTON)
{
return;
}
this._set_comment(this.context.data, comment);
},
'', this.egw().lang("Comment"), this.context.data.remark || ''
);
});
this.context.addItem("file_info", this.egw().lang("File information"), this.egw().image("edit"), () =>
{
let link_data = this.context.data;
if(link_data.app == 'file')
{
// File info is always the same
let url = '/apps/' + link_data.app2 + '/' + link_data.id2 + '/' + decodeURIComponent(link_data.id);
if(typeof url == 'string' && url.indexOf('webdav.php'))
{
// URL is url to file in webdav, so get rid of that part
url = url.replace('/webdav.php', '');
}
this.egw().open(url, "filemanager", "edit");
}
});
this.context.addItem("-", "-");
this.context.addItem("save", this.egw().lang("Save as"), this.egw().image('save'), () =>
{
let link_data = this.context.data;
// Download file
if(link_data.download_url)
{
let url = link_data.download_url;
if(url[0] == '/')
{
url = egw.link(url);
}
let a = document.createElement('a');
if(typeof a.download == "undefined")
{
window.location.href = url + "?download";
return false;
}
// Multiple file download for those that support it
a.setAttribute("href",url);
a.setAttribute("download",link_data.title || "");
this.getInstanceManager().DOMContainer.appendChild(a);
let evt = document.createEvent('MouseEvent');
evt.initMouseEvent('click', true, true, window, 1, 0, 0, 0, 0, false, false, false, false, 0, null);
a.dispatchEvent(evt);
a.remove();
return false;
}
this.egw().open(link_data, "", "view", 'download', link_data.target ? link_data.target : link_data.app, link_data.app);
});
this.context.addItem("zip", this.egw().lang("Save as Zip"), this.egw().image('save_zip'), () =>
{
// Highlight files for nice UI indicating what will be in the zip.
// Files have negative IDs.
this.shadowRoot.querySelectorAll('div[id^="link_-"]').forEach((row) => row.classList.add("zip_highlight"));
// Download ZIP
window.location.href = this.egw().link('/index.php', {
menuaction: 'api.EGroupware\\Api\\Etemplate\\Widget\\Link.download_zip',
app: this.application,
id: this.entryId
});
});
// Only allow this option if the entry has been saved, and has a real ID
if(this.to_id && typeof this.to_id != 'object')
{
this.context.addItem("copy_to", this.egw().lang("Copy to"), this.egw().image('copy'), () =>
{
// Highlight files for nice UI indicating what will be copied
this.shadowRoot.querySelectorAll('div[id^="link_-"]').forEach((row) => row.classList.add("zip_highlight"));
// Get target
let select_attrs : any = {
mode: "select-dir",
button_caption: '',
button_icon: 'copy',
button_label: egw.lang("copy"),
//extra_buttons: [{text: egw.lang("link"), id:"link", image: "link"}],
dialog_title: egw.lang('Copy to'),
method: "EGroupware\\Api\\Etemplate\\Widget\\Link::ajax_copy_to",
method_id: this.context.data
};
let vfs_select = <et2_vfsSelect>et2_createWidget("vfs-select", select_attrs, self);
// No button, just open it
vfs_select.button.hide();
vfs_select.click(null);
});
}
this.context.addItem("-", "-");
this.context.addItem("delete", this.egw().lang("Delete link"), this.egw().image("delete"), () =>
{
Et2Dialog.show_dialog(
(button) =>
{
if(button == Et2Dialog.YES_BUTTON)
{
this._delete_link(this.context.data);
}
},
egw.lang('Delete link?')
);
});
}
protected _handleRowContext(_ev)
{
// Do not trigger expose view if one of the operator keys are held
if(this.readonly || _ev.altKey || _ev.ctrlKey || _ev.shiftKey || _ev.metaKey)
{
return;
}
// Find the link
let link = this.querySelector("et2-link[slot='" + _ev.currentTarget.id + "']");
let _link_data = Object.assign({app: link.app, id: link.entryId}, link.dataset);
// Comment only available if link_id is there and not readonly
this.context.getItem("comment").set_enabled(typeof _link_data.link_id != 'undefined' && !this.readonly);
// File info only available for existing files
this.context.getItem("file_info").set_enabled(typeof _link_data.id != 'object' && _link_data.app == 'file');
this.context.getItem("save").set_enabled(typeof _link_data.id != 'object' && _link_data.app == 'file');
// Zip download only offered if there are at least 2 files
this.context.getItem("zip").set_enabled(this._link_list.length >= 2);
// Show delete item only if the widget is not readonly
this.context.getItem("delete").set_enabled(!this.readonly);
this.context.getItem("delete").caption = _link_data.app === "file" ? this.egw().lang("Delete file") : this.egw().lang("Delete link");
this.context.data = _link_data;
this.context.showAt(_ev.pageX, _ev.pageY, true);
_ev.preventDefault();
}
protected _set_comment(link, comment)
{
let remark = this.querySelector("et2-link[slot='" + this._get_row_id(link) + "']");
if(!remark)
{
console.warn("Could not find link to comment on", link);
return;
}
/* // TODO
if(isNaN(link.link_id)) // new entry, not yet stored
{
remark.text(comment);
// Look for a link-to with the same ID, refresh it
if(link.link_id)
{
var _widget = link_id.widget || null;
self.getRoot().iterateOver(
function(widget)
{
if(widget.id == self.id)
{
_widget = widget;
}
},
self, et2_link_to
);
var value = _widget != null ? _widget.getValue() : false;
if(_widget && value && value.to_id)
{
value.to_id[self.context.data.link_id].remark = comment;
}
}
return;
}
*/
remark.classList.add("loading");
egw.json("EGroupware\\Api\\Etemplate\\Widget\\Link::ajax_link_comment",
[link.link_id, comment]).sendRequest()
.then(() =>
{
if(remark)
{
// Append "" to make sure it's a string, not undefined
remark.classList.remove("loading");
// Update internal data
link.remark = comment + "";
// Update link widget
remark.value = link;
}
});
}
}
// @ts-ignore TypeScript says there's something wrong with types
customElements.define("et2-link-list", Et2LinkList);