@watermarkinsights/ripple 5.13.0 → 5.13.1-alpha.0

package/dist/collection/components/wm-file/wm-file.js

@@ -0,0 +1,423 @@
+import { h, Host, forceUpdate } from "@stencil/core";
+import { debounce, hideTooltip, intl, showTooltip, truncateText } from "../../global/functions";
+export class File {
+    constructor() {
+        this.fileActions = "download delete"; // accepts any combination of preview, download, delete
+        this.showInfo = "last-updated"; // defaults to last-updated but inherits from parent
+        this.fullFilename = `${this.name}.${this.type}`;
+        this.debouncedUpdate = debounce(async () => {
+            forceUpdate(this.el);
+        }, 10);
+    }
+    get isCondensed() {
+        return this.el.clientWidth < 500;
+    }
+    get isUploading() {
+        return this.progress !== undefined && this.progress < 100;
+    }
+    get previewButtonTooltip() {
+        return intl.formatMessage({
+            id: "file.previewButtonTooltip",
+            defaultMessage: "Preview",
+            description: "Tooltip of a button that triggers a file to be previewed",
+        });
+    }
+    get downloadButtonTooltip() {
+        return intl.formatMessage({
+            id: "file.downloadButtonTooltip",
+            defaultMessage: "Download",
+            description: "Tooltip of a button that triggers a file to be downloaded",
+        });
+    }
+    get deleteButtonTooltip() {
+        return intl.formatMessage({
+            id: "file.deleteButtonTooltip",
+            defaultMessage: "Delete",
+            description: "Tooltip of a button that triggers a file to be deleted",
+        });
+    }
+    get previewActionMessage() {
+        return intl.formatMessage({
+            id: "file.previewAction",
+            defaultMessage: "Preview File",
+            description: "Label of a button that triggers a file to be previewed",
+        });
+    }
+    get downloadActionMessage() {
+        return intl.formatMessage({
+            id: "file.downloadAction",
+            defaultMessage: "Download File",
+            description: "Label of a button that triggers a file to be downloaded",
+        });
+    }
+    get deleteActionMessage() {
+        return intl.formatMessage({
+            id: "file.deleteAction",
+            defaultMessage: "Delete File",
+            description: "Label of a button that triggers a file to be delete",
+        });
+    }
+    get actionMenuLabel() {
+        return intl.formatMessage({
+            id: "file.actionMenuLabel",
+            defaultMessage: "Actions",
+            description: "Label of a button that opens a menu of file actions",
+        });
+    }
+    get clearButtonText() {
+        return intl.formatMessage({
+            id: "file.clearErrorText",
+            defaultMessage: "Clear",
+            description: "Text for a button used to clear an error",
+        });
+    }
+    generateClearButtonLabel(filename) {
+        return intl.formatMessage({
+            id: "file.clearErrorLabel",
+            defaultMessage: "Clear {fileName} error",
+            description: "Label for a button used to clear an error, including filename",
+        }, { fileName: filename });
+    }
+    componentWillLoad() {
+        if (!this.el.id) {
+            console.error("wm-file: a file id is required");
+        }
+        if (!this.name) {
+            console.error('wm-file: "name" is a required property');
+        }
+        if (!this.type) {
+            console.error('wm-file: "type" is a required property');
+        }
+        // inherit showInfo property from parent
+        if (this.el.parentElement && this.el.parentElement.showInfo) {
+            this.showInfo = this.el.parentElement.showInfo;
+        }
+        if (this.showInfo === "time") {
+            console.warn("wm-file: show-info='time' is deprecated, use show-info='last-updated'");
+            this.showInfo = "last-updated";
+        }
+        // rerender on resize in case layout needs to change
+        const resizeObserver = new ResizeObserver(() => this.debouncedUpdate());
+        resizeObserver.observe(this.el);
+    }
+    setFilename() {
+        // calc is not accurate and last letter may be cropped if we don't wait
+        requestAnimationFrame(() => {
+            const fileNameEl = this.el.shadowRoot.querySelector(".filename");
+            const leftBoundary = this.el.shadowRoot.querySelector(".left-group").getBoundingClientRect().left;
+            const rightGroup = this.el.shadowRoot.querySelector(".right-group");
+            const file = this.el.shadowRoot.querySelector(".file");
+            const colGap = file ? getComputedStyle(file).getPropertyValue("column-gap") : "0";
+            const rightBoundary = rightGroup
+                ? rightGroup.getBoundingClientRect().left - parseFloat(colGap)
+                : this.el.shadowRoot.querySelector(".file-wrapper").getBoundingClientRect().right - 20;
+            fileNameEl.textContent = truncateText(fileNameEl, this.fullFilename, rightBoundary - leftBoundary, 7);
+        });
+    }
+    componentDidRender() {
+        this.setFilename();
+    }
+    previewFile() {
+        this.wmFilePreview.emit();
+    }
+    downloadFile() {
+        this.wmFileDownload.emit();
+    }
+    deleteFile() {
+        this.wmFileDelete.emit();
+    }
+    handleFilenameMouseEnter(ev) {
+        // only show tooltip if file name is being truncated (has ellipses)
+        if (ev.target.textContent !== this.fullFilename) {
+            showTooltip("bottom", ev.target, this.fullFilename);
+        }
+    }
+    renderFileName() {
+        return (h("div", { class: "left-group" }, h("div", { class: "name-wrapper" }, h("span", { class: "sr-only" }, this.fullFilename), h("span", { "aria-hidden": "true", class: "filename", onMouseEnter: (ev) => this.handleFilenameMouseEnter(ev), onMouseLeave: () => hideTooltip() }), this.isUploading && h("span", { class: "sr-only" }, "uploading"))));
+    }
+    renderFileInfo() {
+        return (h("div", { class: "file-info" }, (this.showInfo === "uploaded-by" || this.showInfo === "all") && (h("div", { class: "details uploader-name" }, this.uploadedBy)), (this.showInfo === "last-updated" || this.showInfo === "all") && h("div", { class: "details" }, this.lastUpdated), (this.showInfo === "size" || this.showInfo === "all") && h("div", { class: "details" }, this.size)));
+    }
+    renderActionMenu() {
+        const previewItem = (h("wm-menuitem", { icon: "#show", onClick: () => this.previewFile() }, this.previewActionMessage));
+        const downloadItem = (h("wm-menuitem", { icon: "#download", onClick: () => this.downloadFile() }, this.downloadActionMessage));
+        const deleteItem = (h("wm-menuitem", { icon: "#delete", onClick: () => this.deleteFile() }, this.deleteActionMessage));
+        return (h("wm-action-menu", { "action-menu-type": "icon", tooltip: this.actionMenuLabel, "tooltip-position": "bottom", "label-for-identical-buttons": `${this.name} ${this.actionMenuLabel}` }, this.fileActions.includes("preview") && previewItem, this.fileActions.includes("download") && downloadItem, this.fileActions.includes("delete") && deleteItem));
+    }
+    renderFileActionButtons() {
+        const previewButton = (h("wm-button", { class: "preview-button", "button-type": "icononly", tooltip: this.previewButtonTooltip, "tooltip-position": "bottom", "label-for-identical-buttons": `preview ${this.name}`, icon: "#show", onClick: () => this.previewFile() }));
+        const downloadButton = (h("wm-button", { class: "download-button", "button-type": "icononly", tooltip: this.downloadButtonTooltip, "tooltip-position": "bottom", "label-for-identical-buttons": `download ${this.name}`, icon: "#download", onClick: () => this.downloadFile() }));
+        const deleteButton = (h("wm-button", { class: "delete-button", "button-type": "icononly", tooltip: this.deleteButtonTooltip, "tooltip-position": "bottom", "label-for-identical-buttons": `delete ${this.name}`, icon: "#delete", onClick: () => this.deleteFile() }));
+        return (h("div", { class: "file-controls" }, this.fileActions.includes("preview") && previewButton, this.fileActions.includes("download") && downloadButton, this.fileActions.includes("delete") && deleteButton));
+    }
+    renderFileInProgress() {
+        return (h("div", { class: "file-wrapper" }, h("div", { class: "file --progress" }, h("div", { class: "progress", style: {
+                background: `linear-gradient(to right, var(--wmcolor-file-progress) ${this.progress}%, transparent ${this.progress}%)`,
+            } }), this.renderFileName())));
+    }
+    renderFileControls() {
+        const hasSingleFileAction = this.fileActions.split(" ").length === 1;
+        const showActionMenu = this.isCondensed && !hasSingleFileAction;
+        return showActionMenu ? this.renderActionMenu() : this.renderFileActionButtons();
+    }
+    renderFile() {
+        return (h("div", { class: `file-wrapper` }, h("div", { class: `file ${this.errorMessage ? "--error" : ""}  ${this.isCondensed ? "condensed" : ""}` }, this.renderFileName(), !this.errorMessage && (h("div", { class: "right-group" }, this.renderFileInfo(), this.fileActions !== "" && this.renderFileControls())), this.errorMessage && (h("wm-button", { "permanently-delete": true, "button-type": "textonly", "label-for-identical-buttons": this.generateClearButtonLabel(this.name), onClick: () => this.wmFileErrorCleared.emit() }, this.clearButtonText)), this.progress == 100 && h("span", { class: "svg-icon svg-success" })), this.errorMessage && h("div", { class: "error-message" }, this.errorMessage)));
+    }
+    render() {
+        return h(Host, { key: '534c481a5423a9f1a1ec811ec6b736e462a981ea', role: "listitem" }, this.isUploading ? this.renderFileInProgress() : this.renderFile());
+    }
+    static get is() { return "wm-file"; }
+    static get encapsulation() { return "shadow"; }
+    static get delegatesFocus() { return true; }
+    static get originalStyleUrls() {
+        return {
+            "$": ["wm-file.scss"]
+        };
+    }
+    static get styleUrls() {
+        return {
+            "$": ["wm-file.css"]
+        };
+    }
+    static get properties() {
+        return {
+            "name": {
+                "type": "string",
+                "attribute": "name",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": true,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false
+            },
+            "type": {
+                "type": "string",
+                "attribute": "type",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": true,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false
+            },
+            "fileActions": {
+                "type": "string",
+                "attribute": "file-actions",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "defaultValue": "\"download delete\""
+            },
+            "lastUpdated": {
+                "type": "string",
+                "attribute": "last-updated",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false
+            },
+            "progress": {
+                "type": "number",
+                "attribute": "progress",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true
+            },
+            "size": {
+                "type": "string",
+                "attribute": "size",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false
+            },
+            "uploadedBy": {
+                "type": "string",
+                "attribute": "uploaded-by",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false
+            },
+            "errorMessage": {
+                "type": "string",
+                "attribute": "error-message",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false
+            },
+            "showInfo": {
+                "type": "string",
+                "attribute": "show-info",
+                "mutable": true,
+                "complexType": {
+                    "original": "\"time\" | \"last-updated\" | \"size\" | \"uploaded-by\" | \"all\" | \"none\"",
+                    "resolved": "\"all\" | \"last-updated\" | \"none\" | \"size\" | \"time\" | \"uploaded-by\" | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "defaultValue": "\"last-updated\""
+            }
+        };
+    }
+    static get events() {
+        return [{
+                "method": "wmFilePreview",
+                "name": "wmFilePreview",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "complexType": {
+                    "original": "any",
+                    "resolved": "any",
+                    "references": {}
+                }
+            }, {
+                "method": "wmFileDownload",
+                "name": "wmFileDownload",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "complexType": {
+                    "original": "any",
+                    "resolved": "any",
+                    "references": {}
+                }
+            }, {
+                "method": "wmFileDelete",
+                "name": "wmFileDelete",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "complexType": {
+                    "original": "any",
+                    "resolved": "any",
+                    "references": {}
+                }
+            }, {
+                "method": "wmFileErrorCleared",
+                "name": "wmFileErrorCleared",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "complexType": {
+                    "original": "any",
+                    "resolved": "any",
+                    "references": {}
+                }
+            }];
+    }
+    static get elementRef() { return "el"; }
+}