/** * EGroupware eTemplate2 - Common button code * * @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License * @package etemplate * @subpackage api * @link https://www.egroupware.org * @author Nathan Gray */ import {css, LitElement, PropertyValues} from "lit"; import '../Et2Image/Et2Image'; import shoelace from "../Styles/shoelace"; import {egw_registerGlobalShortcut} from "../../egw_action/egw_keymanager"; type Constructor = new (...args : any[]) => T; export const ButtonMixin = (superclass : T) => class extends superclass { protected clicked : boolean = false; /** * images to be used as background-image, if none is explicitly applied and id matches given regular expression */ static readonly default_background_images : object = { save: /save(&|\]|$)/, apply: /apply(&|\]|$)/, cancel: /cancel(&|\]|$)/, delete: /delete(&|\]|$)/, discard: /discard(&|\]|$)/, edit: /edit(&|\[\]|$)/, next: /(next|continue)(&|\]|$)/, finish: /finish(&|\]|$)/, back: /(back|previous)(&|\]|$)/, copy: /copy(&|\]|$)/, more: /more(&|\]|$)/, check: /(yes|check)(&|\]|$)/, cancelled: /no(&|\]|$)/, ok: /ok(&|\]|$)/, close: /close(&|\]|$)/, link: /link(&|\]|_|$)/, add: /(add(&|\]|$)|create)/ // customfields use create* }; /** * Classnames added automatically to buttons to set certain hover background colors */ static readonly default_classes : object = { et2_button_cancel: /cancel(&|\]|$)/, // yellow et2_button_question: /(yes|no)(&|\]|$)/, // yellow et2_button_delete: /delete(&|\]|$)/ // red }; static readonly default_keys : object = { //egw_shortcutIdx : id regex _83_C: /save(&|\]|$)/, // CTRL+S _27_: /cancel(&|\]|$)/, // Esc }; static get styles() { return [ ...shoelace, ...(super.styles || []), css` :host { padding: 0; /* These should probably come from somewhere else */ max-width: 125px; min-width: fit-content; display: block; } /* Override general disabled=hide from Et2Widget */ :host([disabled]) { display: block; } :host([hideonreadonly][disabled]) { display:none !important; } /* Leave label there for accessability, but position it so it can't be seen */ :host(.imageOnly) .button__label { position: absolute; left: -999px } /* Set size for icon */ ::slotted(img.imageOnly) { padding-right: 0px !important; width: 16px !important; } ::slotted(et2-image) { width: 20px; max-width: 20px; display: flex; } ::slotted([slot="icon"][src='']) { display: none; } .imageOnly { width:18px; height: 18px; } /* Make hover border match other widgets (select) */ .button--standard.button--default:hover:not(.button--disabled) { background-color: var(--sl-color-gray-150); border-color: var(--sl-input-border-color-hover); color: var(--sl-input-color-hover); } .button { justify-content: left; } .button--has-label.button--medium .button__label { padding: 0 var(--sl-spacing-medium); } .button__label { text-overflow: ellipsis; overflow-x: hidden; } .button__prefix { padding-left: 1px; } /* Only image, no label */ .button--has-prefix:not(.button--has-label) { justify-content: center; width: var(--sl-input-height-medium); padding-inline-start: 0; } /* Override primary styling - we use variant=primary on first dialog button */ .button--standard.button--primary { background-color: hsl(240deg 5% 96%); border-color: var(--sl-color-gray-400); color: var(--sl-input-color-hover); } .button--standard.button--primary:hover:not(.button--disabled), .button--standard.button--primary.button--checked:not(.button--disabled) { background-color: var(--sl-color-gray-150); border-color: var(--sl-color-gray-600); color: initial; } .button--standard.button--primary:active:not(.button--disabled) { border-color: var(--sl-color-gray-700); background-color: var(--sl-color-gray-300); color: initial; } `, ]; } static get properties() { return { ...super.properties, image: {type: String, noAccessor: true}, /** * If button is set to readonly, do we want to hide it completely (old behaviour) or show it as disabled * (default) * Something's not quite right here, as the attribute shows up as "hideonreadonly" instead of "hide" but * it does not show up without the "attribute", and attribute:"hideonreadonly" does not show as an attribute */ hideOnReadonly: {type: Boolean, reflect: true, attribute: "hide"}, /** * Button should submit the etemplate * Return false from the click handler to cancel the submit, or set noSubmit to true to skip submitting. */ noSubmit: {type: Boolean, reflect: false}, /** * When submitting, skip the validation step. Allows to submit etemplates directly to the server. */ noValidation: {type: Boolean} } } constructor(...args : any[]) { super(...args); // Property default values this.__image = ''; this.noSubmit = false; this.hideOnReadonly = false; this.noValidation = false; // Do not add icon here, no children can be added in constructor } set image(new_image : string) { let oldValue = this.__image; if(new_image.indexOf("http") >= 0 || new_image.indexOf(this.egw().webserverUrl) >= 0) { this.__image = new_image } else { this.__image = this.egw().image(new_image); } this.requestUpdate("image", oldValue); } get image() { return this.__image; } _handleClick(event : MouseEvent) : boolean { // ignore click on readonly button if(this.disabled || this.readonly || event.defaultPrevented) { event.preventDefault(); event.stopImmediatePropagation(); return false; } this.clicked = true; // Cancel buttons don't trigger the close confirmation prompt if(this.classList.contains("et2_button_cancel")) { this.getInstanceManager()?.skip_close_prompt(); } if(!super._handleClick(event)) { this.clicked = false; return false; } // Submit the form if(!this.noSubmit) { return this.getInstanceManager().submit(this, undefined, this.noValidation); } this.clicked = false; this.getInstanceManager()?.skip_close_prompt(false); return true; } /** * Handle changes that have to happen based on changes to properties * */ requestUpdate(name : PropertyKey, oldValue) { super.requestUpdate(name, oldValue); // "disabled" is the attribute from the spec if(name == 'readonly') { if(this.readonly) { this.setAttribute('disabled', ""); } else { this.removeAttribute("disabled"); } } // Default image & class are determined based on ID if(name == "id" && this._widget_id) { // Check against current value to avoid triggering another update if(!this.image) { let image = this._get_default_image(this._widget_id); if(image && image != this.__image) { this.image = image; } } let default_class = this._get_default_class(this._widget_id); if(default_class && !this.classList.contains(default_class)) { this.classList.add(default_class); } } } updated(changedProperties : PropertyValues) { super.updated(changedProperties); if(changedProperties.has("image")) { if(this.image && !this._iconNode) { const image = document.createElement("et2-image"); image.slot = "prefix"; this.prepend(image); image.src = this.__image; } else if(this._iconNode) { this._iconNode.src = this.__image; } } } /** * Get a default image for the button based on ID * * @param {string} check_id */ _get_default_image(check_id : string) : string { if(!check_id) { return ""; } if(!this.image) { // @ts-ignore for(const image in this.constructor.default_background_images) { // @ts-ignore if(check_id.match(this.constructor.default_background_images[image])) { return image; } } } return ""; } /** * If button ID has a default keyboard shortcut (eg: Save: Ctrl+S), register with egw_keymanager * * @param {string} check_id */ _register_default_keyhandler(check_id : string) { if(!check_id) { return; } // @ts-ignore for(const keyindex in this.constructor.default_keys) { // @ts-ignore if(check_id.match(this.constructor.default_keys[keyindex])) { let [keycode, modifiers] = keyindex.substring(1).split("_"); egw_registerGlobalShortcut( parseInt(keycode), modifiers.includes("S"), modifiers.includes("C"), modifiers.includes("A"), () => { this.dispatchEvent(new MouseEvent("click")); return true; }, this ) } } } /** * Get a default class for the button based on ID * * @param check_id * @returns {string} */ _get_default_class(check_id) { if(!check_id) { return ""; } for(var name in ButtonMixin.default_classes) { if(check_id.match(ButtonMixin.default_classes[name])) { return name; } } return ""; } get _iconNode() : HTMLImageElement { return (Array.from(this.children)).find( el => (el).slot === "prefix", ); } get _labelNode() : HTMLElement { return (Array.from(this.childNodes)).find( el => (el).nodeType === 3, ); } /** * Implementation of the et2_IInput interface */ /** * Always return false as a button is never dirty */ isDirty() { return false; } resetDirty() { } getValue() { if(this.clicked) { return true; } // If "null" is returned, the result is not added to the submitted // array. return null; } }