@spw-ds/spw-stencil-library 1.15.0 → 1.17.0

package/dist/collection/components/spw-sidenav/spw-sidenav-item/spw-sidenav-item.js

@@ -0,0 +1,359 @@
+import { Host, h } from "@stencil/core";
+export class SpwSidenavItem {
+    constructor() {
+        /** Variante d'icône Font Awesome */
+        this.iconVariant = 'fa-regular';
+        /** Marque l'item comme actif */
+        this.active = false;
+        /** Désactive l'item */
+        this.disabled = false;
+        /** Si true, cliquer sur le label toggle les enfants au lieu de naviguer */
+        this.openOnClick = false;
+        this.hasChildren = false;
+        this.childrenOpen = false;
+        this.hasActiveChild = false;
+        this.mobileFocused = false;
+        this.handleChevronClick = (e) => {
+            e.preventDefault();
+            e.stopPropagation();
+            if (this.disabled)
+                return;
+            if (window.matchMedia('(max-width: 767px)').matches) {
+                this.el.dispatchEvent(new CustomEvent('spwMobileFocusRequest', {
+                    detail: { item: this.el },
+                    bubbles: true,
+                    composed: true,
+                }));
+                return;
+            }
+            this.toggleGroup();
+        };
+        this.handleLabelClick = (e) => {
+            if (this.disabled) {
+                e.preventDefault();
+                return;
+            }
+            if (this.openOnClick && this.hasChildren) {
+                e.preventDefault();
+                this.toggleGroup();
+            }
+        };
+    }
+    componentDidLoad() {
+        this.checkForChildren();
+        this.checkForActiveDescendants();
+        this.setupMutationObserver();
+        if (this.active) {
+            this.notifyParents();
+        }
+    }
+    componentDidUpdate() {
+        this.checkForChildren();
+    }
+    disconnectedCallback() {
+        var _a;
+        (_a = this.mutationObserver) === null || _a === void 0 ? void 0 : _a.disconnect();
+    }
+    setupMutationObserver() {
+        this.mutationObserver = new MutationObserver(() => this.checkForChildren());
+        this.mutationObserver.observe(this.el, {
+            childList: true,
+            subtree: true,
+            attributes: true,
+            attributeFilter: ['open', 'active'],
+        });
+    }
+    checkForChildren() {
+        var _a;
+        const group = this.el.querySelector(':scope > .spw-sidenav-item > spw-sidenav-group, :scope > spw-sidenav-group');
+        this.hasChildren = group !== null;
+        if (group) {
+            this.childrenOpen = !!group.open || ((_a = group.hasAttribute) === null || _a === void 0 ? void 0 : _a.call(group, 'open'));
+        }
+        else {
+            this.childrenOpen = false;
+        }
+    }
+    isActiveItem(el) {
+        const val = el.getAttribute('active');
+        return val === '' || val === 'true';
+    }
+    checkForActiveDescendants() {
+        const activeItems = Array.from(this.el.querySelectorAll('spw-sidenav-item')).filter(item => this.isActiveItem(item));
+        if (activeItems.length > 0) {
+            this.hasActiveChild = true;
+            this.openGroup();
+        }
+    }
+    notifyParents() {
+        var _a, _b, _c;
+        let parentItem = (_a = this.el.parentElement) === null || _a === void 0 ? void 0 : _a.closest('spw-sidenav-item');
+        while (parentItem) {
+            parentItem.hasActiveChild = true;
+            const group = parentItem.querySelector(':scope > .spw-sidenav-item > spw-sidenav-group, :scope > spw-sidenav-group');
+            if (group) {
+                group.open = true;
+                (_b = group.setAttribute) === null || _b === void 0 ? void 0 : _b.call(group, 'open', '');
+                parentItem.childrenOpen = true;
+            }
+            parentItem = (_c = parentItem.parentElement) === null || _c === void 0 ? void 0 : _c.closest('spw-sidenav-item');
+        }
+    }
+    openGroup() {
+        var _a;
+        const group = this.el.querySelector(':scope > .spw-sidenav-item > spw-sidenav-group, :scope > spw-sidenav-group');
+        if (group) {
+            group.open = true;
+            (_a = group.setAttribute) === null || _a === void 0 ? void 0 : _a.call(group, 'open', '');
+            this.childrenOpen = true;
+        }
+    }
+    toggleGroup() {
+        var _a, _b;
+        const group = this.el.querySelector(':scope > .spw-sidenav-item > spw-sidenav-group, :scope > spw-sidenav-group');
+        if (group) {
+            group.open = !group.open;
+            if (group.open)
+                (_a = group.setAttribute) === null || _a === void 0 ? void 0 : _a.call(group, 'open', '');
+            else
+                (_b = group.removeAttribute) === null || _b === void 0 ? void 0 : _b.call(group, 'open');
+            this.childrenOpen = group.open;
+        }
+    }
+    /** Ouvre les enfants */
+    async open() {
+        this.openGroup();
+    }
+    /** Ferme les enfants */
+    async close() {
+        var _a;
+        const group = this.el.querySelector(':scope > .spw-sidenav-item > spw-sidenav-group, :scope > spw-sidenav-group');
+        if (group) {
+            group.open = false;
+            (_a = group.removeAttribute) === null || _a === void 0 ? void 0 : _a.call(group, 'open');
+            this.childrenOpen = false;
+        }
+    }
+    /** Utilisé par spw-sidenav pour focaliser cet item en mobile */
+    async setMobileFocus(value) {
+        this.mobileFocused = value;
+    }
+    get isLink() {
+        return !!this.href && !this.disabled && !this.openOnClick;
+    }
+    render() {
+        const LabelTag = this.isLink ? 'a' : 'button';
+        return (h(Host, { key: '17607fea24545b9b75737d89a04f23bfd770c470' }, h("div", { key: 'b35c32d3848704761a361422d53d6c7f541c1c98', class: {
+                'spw-sidenav-item': true,
+                'spw-sidenav-item--active': this.active || this.hasActiveChild,
+                'spw-sidenav-item--disabled': this.disabled,
+                'spw-sidenav-item--has-children': this.hasChildren,
+                'spw-sidenav-item--children-open': this.childrenOpen,
+                'spw-sidenav-item--mobile-focused': this.mobileFocused,
+            } }, h("div", { key: 'fb937b1690063919eb303816ddf66ea6fefa5cd1', class: "spw-sidenav-item__row" }, h(LabelTag, { key: '6288f1a598107aa27a7fee5fcec30cf521792933', class: "spw-sidenav-item__label", href: this.isLink ? this.href : undefined, disabled: LabelTag === 'button' && this.disabled ? true : undefined, "aria-disabled": this.disabled ? 'true' : undefined, "aria-expanded": this.hasChildren ? this.childrenOpen.toString() : undefined, "aria-current": this.active ? 'page' : undefined, onClick: this.handleLabelClick }, this.icon && (h("span", { key: 'd4e427cb15f5b019a0ad4fe5373ec61faf415949', class: "spw-sidenav-item__icon" }, h("spw-icon", { key: '065d165607922c9d33f5300a72eaaa2c38e75d7e', variant: this.iconVariant, icon: this.icon }))), h("span", { key: 'f89a8915244e9346c0edef997c1277bd10c8c18c', class: "spw-sidenav-item__text" }, h("slot", { key: '97152c49d15ef22ba48b3d0a6d98d02a62f7a7fc' }))), this.hasChildren && (h("button", { key: '5ef0937493a17b9f09741fd15a2ade6d6ce0f0da', type: "button", class: {
+                'spw-sidenav-item__chevron': true,
+                'spw-sidenav-item__chevron--open': this.childrenOpen,
+            }, "aria-label": this.childrenOpen ? 'Réduire' : 'Développer', disabled: this.disabled, onClick: this.handleChevronClick }, h("spw-icon", { key: '42a4b347a3354c51af6f2b7fecd95d262721d2a7', icon: "fa-chevron-down" })))), h("slot", { key: 'e0627c82022966740d540a35854a74ddba926ad6', name: "children" }))));
+    }
+    static get is() { return "spw-sidenav-item"; }
+    static get originalStyleUrls() {
+        return {
+            "$": ["spw-sidenav-item.scss"]
+        };
+    }
+    static get styleUrls() {
+        return {
+            "$": ["spw-sidenav-item.css"]
+        };
+    }
+    static get properties() {
+        return {
+            "href": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "URL de destination"
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "href"
+            },
+            "icon": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Ic\u00F4ne Font Awesome (ex: fa-home)"
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "icon"
+            },
+            "iconVariant": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "'fa-solid' | 'fa-brands' | 'fa-regular'",
+                    "resolved": "\"fa-brands\" | \"fa-regular\" | \"fa-solid\"",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Variante d'ic\u00F4ne Font Awesome"
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "icon-variant",
+                "defaultValue": "'fa-regular'"
+            },
+            "active": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Marque l'item comme actif"
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "active",
+                "defaultValue": "false"
+            },
+            "disabled": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "D\u00E9sactive l'item"
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "disabled",
+                "defaultValue": "false"
+            },
+            "openOnClick": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Si true, cliquer sur le label toggle les enfants au lieu de naviguer"
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "open-on-click",
+                "defaultValue": "false"
+            }
+        };
+    }
+    static get states() {
+        return {
+            "hasChildren": {},
+            "childrenOpen": {},
+            "hasActiveChild": {},
+            "mobileFocused": {}
+        };
+    }
+    static get methods() {
+        return {
+            "open": {
+                "complexType": {
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Ouvre les enfants",
+                    "tags": []
+                }
+            },
+            "close": {
+                "complexType": {
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Ferme les enfants",
+                    "tags": []
+                }
+            },
+            "setMobileFocus": {
+                "complexType": {
+                    "signature": "(value: boolean) => Promise<void>",
+                    "parameters": [{
+                            "name": "value",
+                            "type": "boolean",
+                            "docs": ""
+                        }],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Utilis\u00E9 par spw-sidenav pour focaliser cet item en mobile",
+                    "tags": []
+                }
+            }
+        };
+    }
+    static get elementRef() { return "el"; }
+}