@ui5/webcomponents 0.0.0-07460127d → 0.0.0-07d38e78e

package/dist/Menu.d.ts

@@ -0,0 +1,116 @@
+import UI5Element from "@ui5/webcomponents-base/dist/UI5Element.js";
+import type I18nBundle from "@ui5/webcomponents-base/dist/i18nBundle.js";
+import "@ui5/webcomponents-icons/dist/slim-arrow-right.js";
+import { Timeout } from "@ui5/webcomponents-base/dist/types.js";
+import ResponsivePopover from "./ResponsivePopover.js";
+import type { ResponsivePopoverBeforeCloseEventDetail } from "./ResponsivePopover.js";
+import MenuItem from "./MenuItem.js";
+import type { ListItemClickEventDetail } from "./List.js";
+type MenuItemClickEventDetail = {
+    item: MenuItem;
+    text: string;
+};
+type MenuBeforeOpenEventDetail = {
+    item?: MenuItem;
+};
+type MenuBeforeCloseEventDetail = {
+    escPressed: boolean;
+};
+/**
+ * @class
+ *
+ * ### Overview
+ *
+ * `ui5-menu` component represents a hierarchical menu structure.
+ *
+ * ### Usage
+ *
+ * `ui5-menu` contains `ui5-menu-item` components.
+ * An arbitrary hierarchy structure can be represented by recursively nesting menu items.
+ *
+ * ### Keyboard Handling
+ *
+ * The `ui5-menu` provides advanced keyboard handling.
+ * The user can use the following keyboard shortcuts in order to navigate trough the tree:
+ *
+ * - `Arrow Up` / `Arrow Down` - Navigates up and down the menu items that are currently visible.
+ * - `Arrow Right`, `Space` or `Enter` - Opens a sub-menu if there are menu items nested
+ * in the currently clicked menu item.
+ * - `Arrow Left` or `Escape` - Closes the currently opened sub-menu.
+ *
+ * Note: if the text ditrection is set to Right-to-left (RTL), `Arrow Right` and `Arrow Left` functionality is swapped.
+ *
+ * ### ES6 Module Import
+ *
+ * `import "@ui5/webcomponents/dist/Menu.js";`
+ * @constructor
+ * @extends UI5Element
+ * @since 1.3.0
+ * @public
+ */
+declare class Menu extends UI5Element {
+    /**
+     * Defines the header text of the menu (displayed on mobile).
+     * @default ""
+     * @public
+     */
+    headerText: string;
+    /**
+     * Indicates if the menu is open
+     * @public
+     * @default false
+     * @since 1.10.0
+     */
+    open: boolean;
+    /**
+     * Defines if a loading indicator would be displayed inside the corresponding ui5-menu popover.
+     * @default false
+     * @public
+     * @since 1.13.0
+     */
+    loading: boolean;
+    /**
+     * Defines the delay in milliseconds, after which the loading indicator will be displayed inside the corresponding ui5-menu popover..
+     * @default 1000
+     * @public
+     * @since 1.13.0
+     */
+    loadingDelay: number;
+    /**
+     * Defines the ID or DOM Reference of the element at which the menu is shown.
+     * When using this attribute in a declarative way, you must only use the `id` (as a string) of the element at which you want to show the popover.
+     * You can only set the `opener` attribute to a DOM Reference when using JavaScript.
+     * @public
+     * @default ""
+     * @since 1.10.0
+     */
+    opener: HTMLElement | string;
+    /**
+     * Defines the items of this component.
+     *
+     * **Note:** Use `ui5-menu-item` for the intended design.
+     * @public
+     */
+    items: Array<MenuItem>;
+    static i18nBundle: I18nBundle;
+    _timeout?: Timeout;
+    static onDefine(): Promise<void>;
+    get isRtl(): boolean;
+    get labelClose(): string;
+    get isPhone(): boolean;
+    get _popover(): ResponsivePopover;
+    onBeforeRendering(): void;
+    _close(): void;
+    _openItemSubMenu(item: MenuItem): void;
+    _closeItemSubMenu(item: MenuItem): void;
+    _itemMouseOver(e: MouseEvent): void;
+    _startOpenTimeout(item: MenuItem): void;
+    _itemClick(e: CustomEvent<ListItemClickEventDetail>): void;
+    _itemKeyDown(e: KeyboardEvent): void;
+    _beforePopoverOpen(e: CustomEvent): void;
+    _afterPopoverOpen(): void;
+    _beforePopoverClose(e: CustomEvent<ResponsivePopoverBeforeCloseEventDetail>): void;
+    _afterPopoverClose(): void;
+}
+export default Menu;
+export type { MenuItemClickEventDetail, MenuBeforeCloseEventDetail, MenuBeforeOpenEventDetail, };

package/dist/Menu.js

@@ -0,0 +1,302 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var Menu_1;
+import UI5Element from "@ui5/webcomponents-base/dist/UI5Element.js";
+import customElement from "@ui5/webcomponents-base/dist/decorators/customElement.js";
+import property from "@ui5/webcomponents-base/dist/decorators/property.js";
+import slot from "@ui5/webcomponents-base/dist/decorators/slot.js";
+import event from "@ui5/webcomponents-base/dist/decorators/event.js";
+import DOMReference from "@ui5/webcomponents-base/dist/types/DOMReference.js";
+import { isLeft, isRight, isEnter, } from "@ui5/webcomponents-base/dist/Keys.js";
+import { isPhone, isDesktop, } from "@ui5/webcomponents-base/dist/Device.js";
+import { getI18nBundle } from "@ui5/webcomponents-base/dist/i18nBundle.js";
+import "@ui5/webcomponents-icons/dist/slim-arrow-right.js";
+import litRender from "@ui5/webcomponents-base/dist/renderer/LitRenderer.js";
+import "@ui5/webcomponents-base/dist/types.js";
+import Integer from "@ui5/webcomponents-base/dist/types/Integer.js";
+import ResponsivePopover from "./ResponsivePopover.js";
+import Button from "./Button.js";
+import List from "./List.js";
+import Icon from "./Icon.js";
+import BusyIndicator from "./BusyIndicator.js";
+import MenuItem from "./MenuItem.js";
+import menuTemplate from "./generated/templates/MenuTemplate.lit.js";
+import { MENU_CLOSE_BUTTON_ARIA_LABEL, } from "./generated/i18n/i18n-defaults.js";
+// Styles
+import menuCss from "./generated/themes/Menu.css.js";
+const MENU_OPEN_DELAY = 300;
+/**
+ * @class
+ *
+ * ### Overview
+ *
+ * `ui5-menu` component represents a hierarchical menu structure.
+ *
+ * ### Usage
+ *
+ * `ui5-menu` contains `ui5-menu-item` components.
+ * An arbitrary hierarchy structure can be represented by recursively nesting menu items.
+ *
+ * ### Keyboard Handling
+ *
+ * The `ui5-menu` provides advanced keyboard handling.
+ * The user can use the following keyboard shortcuts in order to navigate trough the tree:
+ *
+ * - `Arrow Up` / `Arrow Down` - Navigates up and down the menu items that are currently visible.
+ * - `Arrow Right`, `Space` or `Enter` - Opens a sub-menu if there are menu items nested
+ * in the currently clicked menu item.
+ * - `Arrow Left` or `Escape` - Closes the currently opened sub-menu.
+ *
+ * Note: if the text ditrection is set to Right-to-left (RTL), `Arrow Right` and `Arrow Left` functionality is swapped.
+ *
+ * ### ES6 Module Import
+ *
+ * `import "@ui5/webcomponents/dist/Menu.js";`
+ * @constructor
+ * @extends UI5Element
+ * @since 1.3.0
+ * @public
+ */
+let Menu = Menu_1 = class Menu extends UI5Element {
+    static async onDefine() {
+        Menu_1.i18nBundle = await getI18nBundle("@ui5/webcomponents");
+    }
+    get isRtl() {
+        return this.effectiveDir === "rtl";
+    }
+    get labelClose() {
+        return Menu_1.i18nBundle.getText(MENU_CLOSE_BUTTON_ARIA_LABEL);
+    }
+    get isPhone() {
+        return isPhone();
+    }
+    get _popover() {
+        return this.shadowRoot.querySelector("[ui5-responsive-popover]");
+    }
+    onBeforeRendering() {
+        const siblingsWithIcon = this.items.some(item => !!item.icon);
+        this.items.forEach(item => {
+            item._siblingsWithIcon = siblingsWithIcon;
+        });
+    }
+    _close() {
+        this.open = false;
+    }
+    _openItemSubMenu(item) {
+        clearTimeout(this._timeout);
+        if (!item._popover || item._popover.open) {
+            return;
+        }
+        this.fireEvent("before-open", {
+            item,
+        }, false, false);
+        item._popover.opener = item;
+        item._popover.open = true;
+        item.selected = true;
+    }
+    _closeItemSubMenu(item) {
+        if (item && item._popover) {
+            const openedSibling = item.items.find(menuItem => menuItem._popover && menuItem._popover.open);
+            if (openedSibling) {
+                this._closeItemSubMenu(openedSibling);
+            }
+            item._popover.open = false;
+            item.selected = false;
+        }
+    }
+    _itemMouseOver(e) {
+        if (isDesktop()) {
+            // respect mouseover only on desktop
+            const item = e.target;
+            item.focus();
+            // Opens submenu with 300ms delay
+            this._startOpenTimeout(item);
+        }
+    }
+    _startOpenTimeout(item) {
+        clearTimeout(this._timeout);
+        this._timeout = setTimeout(() => {
+            const opener = item.parentElement;
+            const openedSibling = opener && opener.items.find(menuItem => menuItem._popover && menuItem._popover.open);
+            if (openedSibling) {
+                this._closeItemSubMenu(openedSibling);
+            }
+            this._openItemSubMenu(item);
+        }, MENU_OPEN_DELAY);
+    }
+    _itemClick(e) {
+        const item = e.detail.item;
+        if (!item._popover) {
+            const prevented = !this.fireEvent("item-click", {
+                "item": item,
+                "text": item.text,
+            }, true, false);
+            if (!prevented && this._popover) {
+                item.fireEvent("close-menu", {});
+            }
+        }
+        else {
+            this._openItemSubMenu(item);
+        }
+    }
+    _itemKeyDown(e) {
+        const shouldCloseMenu = this.isRtl ? isRight(e) : isLeft(e);
+        const shouldOpenMenu = this.isRtl ? isLeft(e) : isRight(e);
+        const item = e.target;
+        const parentElement = item.parentElement;
+        if (isEnter(e)) {
+            e.preventDefault();
+        }
+        if (shouldOpenMenu) {
+            this._openItemSubMenu(item);
+        }
+        else if (shouldCloseMenu && parentElement.hasAttribute("ui5-menu-item") && parentElement._popover) {
+            parentElement._popover.open = false;
+            parentElement.selected = false;
+            parentElement._popover.opener?.focus();
+        }
+    }
+    _beforePopoverOpen(e) {
+        const prevented = !this.fireEvent("before-open", {}, true, true);
+        if (prevented) {
+            this.open = false;
+            e.preventDefault();
+        }
+    }
+    _afterPopoverOpen() {
+        this.open = true;
+        this.items[0]?.focus();
+        this.fireEvent("open", {}, false, true);
+    }
+    _beforePopoverClose(e) {
+        const prevented = !this.fireEvent("before-close", { escPressed: e.detail.escPressed }, true, true);
+        if (prevented) {
+            this.open = true;
+            e.preventDefault();
+        }
+    }
+    _afterPopoverClose() {
+        this.open = false;
+        this.fireEvent("close", {}, false, true);
+    }
+};
+__decorate([
+    property()
+], Menu.prototype, "headerText", void 0);
+__decorate([
+    property({ type: Boolean })
+], Menu.prototype, "open", void 0);
+__decorate([
+    property({ type: Boolean })
+], Menu.prototype, "loading", void 0);
+__decorate([
+    property({ validator: Integer, defaultValue: 1000 })
+], Menu.prototype, "loadingDelay", void 0);
+__decorate([
+    property({ validator: DOMReference, defaultValue: "" })
+], Menu.prototype, "opener", void 0);
+__decorate([
+    slot({ "default": true, type: HTMLElement, invalidateOnChildChange: true })
+], Menu.prototype, "items", void 0);
+Menu = Menu_1 = __decorate([
+    customElement({
+        tag: "ui5-menu",
+        renderer: litRender,
+        styles: menuCss,
+        template: menuTemplate,
+        dependencies: [
+            ResponsivePopover,
+            Button,
+            List,
+            MenuItem,
+            Icon,
+            BusyIndicator,
+        ],
+    })
+    /**
+     * Fired when an item is being clicked.
+     *
+     * **Note:** Since 1.17.0 the event is preventable, allowing the menu to remain open after an item is pressed.
+     * @allowPreventDefault
+     * @param { HTMLElement } item The currently clicked menu item.
+     * @param { string } text The text of the currently clicked menu item.
+     * @public
+     */
+    ,
+    event("item-click", {
+        detail: {
+            /**
+             * @public
+             */
+            item: {
+                type: HTMLElement,
+            },
+            /**
+             * @public
+             */
+            text: {
+                type: String,
+            },
+        },
+    })
+    /**
+     * Fired before the menu is opened. This event can be cancelled, which will prevent the menu from opening. **This event does not bubble.**
+     *
+     * **Note:** Since 1.14.0 the event is also fired before a sub-menu opens.
+     * @public
+     * @allowPreventDefault
+     * @since 1.10.0
+     * @param { HTMLElement } item The `ui5-menu-item` that triggers opening of the sub-menu or undefined when fired upon root menu opening.
+     */
+    ,
+    event("before-open", {
+        detail: {
+            /**
+             * @public
+             * @since 1.14.0
+             */
+            item: {
+                type: HTMLElement,
+            },
+        },
+    })
+    /**
+     * Fired after the menu is opened. **This event does not bubble.**
+     * @public
+     * @since 1.10.0
+     */
+    ,
+    event("open")
+    /**
+     * Fired before the menu is closed. This event can be cancelled, which will prevent the menu from closing. **This event does not bubble.**
+     * @public
+     * @allowPreventDefault
+     * @param {boolean} escPressed Indicates that `ESC` key has triggered the event.
+     * @since 1.10.0
+     */
+    ,
+    event("before-close", {
+        detail: {
+            /**
+             * @public
+             */
+            escPressed: {
+                type: Boolean,
+            },
+        },
+    })
+    /**
+     * Fired after the menu is closed. **This event does not bubble.**
+     * @public
+     * @since 1.10.0
+     */
+    ,
+    event("close")
+], Menu);
+Menu.define();
+export default Menu;
+//# sourceMappingURL=Menu.js.map

package/dist/Menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.js","sourceRoot":"","sources":["../src/Menu.ts"],"names":[],"mappings":"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","sourcesContent":["import UI5Element from \"@ui5/webcomponents-base/dist/UI5Element.js\";\nimport customElement from \"@ui5/webcomponents-base/dist/decorators/customElement.js\";\nimport property from \"@ui5/webcomponents-base/dist/decorators/property.js\";\nimport slot from \"@ui5/webcomponents-base/dist/decorators/slot.js\";\nimport event from \"@ui5/webcomponents-base/dist/decorators/event.js\";\nimport DOMReference from \"@ui5/webcomponents-base/dist/types/DOMReference.js\";\nimport {\n\tisLeft,\n\tisRight,\n\tisEnter,\n} from \"@ui5/webcomponents-base/dist/Keys.js\";\nimport {\n\tisPhone,\n\tisDesktop,\n} from \"@ui5/webcomponents-base/dist/Device.js\";\nimport { getI18nBundle } from \"@ui5/webcomponents-base/dist/i18nBundle.js\";\nimport type I18nBundle from \"@ui5/webcomponents-base/dist/i18nBundle.js\";\nimport \"@ui5/webcomponents-icons/dist/slim-arrow-right.js\";\nimport litRender from \"@ui5/webcomponents-base/dist/renderer/LitRenderer.js\";\nimport { Timeout } from \"@ui5/webcomponents-base/dist/types.js\";\nimport Integer from \"@ui5/webcomponents-base/dist/types/Integer.js\";\nimport ResponsivePopover from \"./ResponsivePopover.js\";\nimport type { ResponsivePopoverBeforeCloseEventDetail } from \"./ResponsivePopover.js\";\nimport Button from \"./Button.js\";\nimport List from \"./List.js\";\nimport Icon from \"./Icon.js\";\nimport BusyIndicator from \"./BusyIndicator.js\";\nimport MenuItem from \"./MenuItem.js\";\nimport type {\n\tListItemClickEventDetail,\n} from \"./List.js\";\nimport menuTemplate from \"./generated/templates/MenuTemplate.lit.js\";\nimport {\n\tMENU_CLOSE_BUTTON_ARIA_LABEL,\n} from \"./generated/i18n/i18n-defaults.js\";\n\n// Styles\nimport menuCss from \"./generated/themes/Menu.css.js\";\n\nconst MENU_OPEN_DELAY = 300;\n\ntype MenuItemClickEventDetail = {\n\titem: MenuItem,\n\ttext: string,\n}\n\ntype MenuBeforeOpenEventDetail = { item?: MenuItem };\ntype MenuBeforeCloseEventDetail = { escPressed: boolean };\n\n/**\n * @class\n *\n * ### Overview\n *\n * `ui5-menu` component represents a hierarchical menu structure.\n *\n * ### Usage\n *\n * `ui5-menu` contains `ui5-menu-item` components.\n * An arbitrary hierarchy structure can be represented by recursively nesting menu items.\n *\n * ### Keyboard Handling\n *\n * The `ui5-menu` provides advanced keyboard handling.\n * The user can use the following keyboard shortcuts in order to navigate trough the tree:\n *\n * - `Arrow Up` / `Arrow Down` - Navigates up and down the menu items that are currently visible.\n * - `Arrow Right`, `Space` or `Enter` - Opens a sub-menu if there are menu items nested\n * in the currently clicked menu item.\n * - `Arrow Left` or `Escape` - Closes the currently opened sub-menu.\n *\n * Note: if the text ditrection is set to Right-to-left (RTL), `Arrow Right` and `Arrow Left` functionality is swapped.\n *\n * ### ES6 Module Import\n *\n * `import \"@ui5/webcomponents/dist/Menu.js\";`\n * @constructor\n * @extends UI5Element\n * @since 1.3.0\n * @public\n */\n@customElement({\n\ttag: \"ui5-menu\",\n\trenderer: litRender,\n\tstyles: menuCss,\n\ttemplate: menuTemplate,\n\tdependencies: [\n\t\tResponsivePopover,\n\t\tButton,\n\t\tList,\n\t\tMenuItem,\n\t\tIcon,\n\t\tBusyIndicator,\n\t],\n})\n\n/**\n * Fired when an item is being clicked.\n *\n * **Note:** Since 1.17.0 the event is preventable, allowing the menu to remain open after an item is pressed.\n * @allowPreventDefault\n * @param { HTMLElement } item The currently clicked menu item.\n * @param { string } text The text of the currently clicked menu item.\n * @public\n */\n@event<MenuItemClickEventDetail>(\"item-click\", {\n\tdetail: {\n\t\t/**\n\t\t * @public\n\t\t */\n\t\titem: {\n\t\t\ttype: HTMLElement,\n\t\t},\n\t\t/**\n\t\t * @public\n\t\t */\n\t\ttext: {\n\t\t\ttype: String,\n\t\t},\n\t},\n})\n\n/**\n * Fired before the menu is opened. This event can be cancelled, which will prevent the menu from opening. **This event does not bubble.**\n *\n * **Note:** Since 1.14.0 the event is also fired before a sub-menu opens.\n * @public\n * @allowPreventDefault\n * @since 1.10.0\n * @param { HTMLElement } item The `ui5-menu-item` that triggers opening of the sub-menu or undefined when fired upon root menu opening.\n */\n@event<MenuBeforeOpenEventDetail>(\"before-open\", {\n\tdetail: {\n\t\t/**\n\t\t * @public\n\t\t * @since 1.14.0\n\t\t */\n\t\titem: {\n\t\t\ttype: HTMLElement,\n\t\t},\n\t},\n})\n\n/**\n * Fired after the menu is opened. **This event does not bubble.**\n * @public\n * @since 1.10.0\n */\n@event(\"open\")\n\n/**\n * Fired before the menu is closed. This event can be cancelled, which will prevent the menu from closing. **This event does not bubble.**\n * @public\n * @allowPreventDefault\n * @param {boolean} escPressed Indicates that `ESC` key has triggered the event.\n * @since 1.10.0\n */\n@event<MenuBeforeCloseEventDetail>(\"before-close\", {\n\tdetail: {\n\t\t/**\n\t\t * @public\n\t\t */\n\t\tescPressed: {\n\t\t\ttype: Boolean,\n\t\t},\n\t},\n})\n\n/**\n * Fired after the menu is closed. **This event does not bubble.**\n * @public\n * @since 1.10.0\n */\n@event(\"close\")\n\nclass Menu extends UI5Element {\n\t/**\n\t * Defines the header text of the menu (displayed on mobile).\n\t * @default \"\"\n\t * @public\n\t */\n\t@property()\n\theaderText!: string;\n\n\t/**\n\t * Indicates if the menu is open\n\t * @public\n\t * @default false\n\t * @since 1.10.0\n\t */\n\t@property({ type: Boolean })\n\topen!:boolean;\n\n\t/**\n\t * Defines if a loading indicator would be displayed inside the corresponding ui5-menu popover.\n\t * @default false\n\t * @public\n\t * @since 1.13.0\n\t */\n\t@property({ type: Boolean })\n\tloading!: boolean;\n\n\t/**\n\t * Defines the delay in milliseconds, after which the loading indicator will be displayed inside the corresponding ui5-menu popover..\n\t * @default 1000\n\t * @public\n\t * @since 1.13.0\n\t */\n\t@property({ validator: Integer, defaultValue: 1000 })\n\tloadingDelay!: number;\n\n\t/**\n\t * Defines the ID or DOM Reference of the element at which the menu is shown.\n\t * When using this attribute in a declarative way, you must only use the `id` (as a string) of the element at which you want to show the popover.\n\t * You can only set the `opener` attribute to a DOM Reference when using JavaScript.\n\t * @public\n\t * @default \"\"\n\t * @since 1.10.0\n\t */\n\t@property({ validator: DOMReference, defaultValue: \"\" })\n\topener!: HTMLElement | string;\n\n\t/**\n\t * Defines the items of this component.\n\t *\n\t * **Note:** Use `ui5-menu-item` for the intended design.\n\t * @public\n\t */\n\t@slot({ \"default\": true, type: HTMLElement, invalidateOnChildChange: true })\n\titems!: Array<MenuItem>;\n\n\tstatic i18nBundle: I18nBundle;\n\t_timeout?: Timeout;\n\n\tstatic async onDefine() {\n\t\tMenu.i18nBundle = await getI18nBundle(\"@ui5/webcomponents\");\n\t}\n\n\tget isRtl() {\n\t\treturn this.effectiveDir === \"rtl\";\n\t}\n\n\tget labelClose() {\n\t\treturn Menu.i18nBundle.getText(MENU_CLOSE_BUTTON_ARIA_LABEL);\n\t}\n\n\tget isPhone() {\n\t\treturn isPhone();\n\t}\n\n\tget _popover() {\n\t\treturn this.shadowRoot!.querySelector<ResponsivePopover>(\"[ui5-responsive-popover]\")!;\n\t}\n\n\tonBeforeRendering() {\n\t\tconst siblingsWithIcon = this.items.some(item => !!item.icon);\n\n\t\tthis.items.forEach(item => {\n\t\t\titem._siblingsWithIcon = siblingsWithIcon;\n\t\t});\n\t}\n\n\t_close() {\n\t\tthis.open = false;\n\t}\n\n\t_openItemSubMenu(item: MenuItem) {\n\t\tclearTimeout(this._timeout);\n\n\t\tif (!item._popover || item._popover.open) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.fireEvent<MenuBeforeOpenEventDetail>(\"before-open\", {\n\t\t\titem,\n\t\t}, false, false);\n\t\titem._popover.opener = item;\n\t\titem._popover.open = true;\n\t\titem.selected = true;\n\t}\n\n\t_closeItemSubMenu(item: MenuItem) {\n\t\tif (item && item._popover) {\n\t\t\tconst openedSibling = item.items.find(menuItem => menuItem._popover && menuItem._popover.open);\n\t\t\tif (openedSibling) {\n\t\t\t\tthis._closeItemSubMenu(openedSibling);\n\t\t\t}\n\n\t\t\titem._popover.open = false;\n\t\t\titem.selected = false;\n\t\t}\n\t}\n\n\t_itemMouseOver(e: MouseEvent) {\n\t\tif (isDesktop()) {\n\t\t\t// respect mouseover only on desktop\n\t\t\tconst item = e.target as MenuItem;\n\n\t\t\titem.focus();\n\n\t\t\t// Opens submenu with 300ms delay\n\t\t\tthis._startOpenTimeout(item);\n\t\t}\n\t}\n\n\t_startOpenTimeout(item: MenuItem) {\n\t\tclearTimeout(this._timeout);\n\n\t\tthis._timeout = setTimeout(() => {\n\t\t\tconst opener = item.parentElement as MenuItem | Menu;\n\t\t\tconst openedSibling = opener && opener.items.find(menuItem => menuItem._popover && menuItem._popover.open);\n\t\t\tif (openedSibling) {\n\t\t\t\tthis._closeItemSubMenu(openedSibling);\n\t\t\t}\n\n\t\t\tthis._openItemSubMenu(item);\n\t\t}, MENU_OPEN_DELAY);\n\t}\n\n\t_itemClick(e: CustomEvent<ListItemClickEventDetail>) {\n\t\tconst item = e.detail.item as MenuItem;\n\n\t\tif (!item._popover) {\n\t\t\tconst prevented = !this.fireEvent<MenuItemClickEventDetail>(\"item-click\", {\n\t\t\t\t\"item\": item,\n\t\t\t\t\"text\": item.text,\n\t\t\t}, true, false);\n\n\t\t\tif (!prevented && this._popover) {\n\t\t\t\titem.fireEvent(\"close-menu\", {});\n\t\t\t}\n\t\t} else {\n\t\t\tthis._openItemSubMenu(item);\n\t\t}\n\t}\n\n\t_itemKeyDown(e: KeyboardEvent) {\n\t\tconst shouldCloseMenu = this.isRtl ? isRight(e) : isLeft(e);\n\t\tconst shouldOpenMenu = this.isRtl ? isLeft(e) : isRight(e);\n\t\tconst item = e.target as MenuItem;\n\t\tconst parentElement = item.parentElement as MenuItem;\n\n\t\tif (isEnter(e)) {\n\t\t\te.preventDefault();\n\t\t}\n\t\tif (shouldOpenMenu) {\n\t\t\tthis._openItemSubMenu(item);\n\t\t} else if (shouldCloseMenu && parentElement.hasAttribute(\"ui5-menu-item\") && parentElement._popover) {\n\t\t\tparentElement._popover.open = false;\n\t\t\tparentElement.selected = false;\n\t\t\t(parentElement._popover.opener as HTMLElement)?.focus();\n\t\t}\n\t}\n\n\t_beforePopoverOpen(e: CustomEvent) {\n\t\tconst prevented = !this.fireEvent<MenuBeforeOpenEventDetail>(\"before-open\", {}, true, true);\n\n\t\tif (prevented) {\n\t\t\tthis.open = false;\n\t\t\te.preventDefault();\n\t\t}\n\t}\n\n\t_afterPopoverOpen() {\n\t\tthis.open = true;\n\t\tthis.items[0]?.focus();\n\t\tthis.fireEvent(\"open\", {}, false, true);\n\t}\n\n\t_beforePopoverClose(e: CustomEvent<ResponsivePopoverBeforeCloseEventDetail>) {\n\t\tconst prevented = !this.fireEvent<MenuBeforeCloseEventDetail>(\"before-close\", { escPressed: e.detail.escPressed }, true, true);\n\n\t\tif (prevented) {\n\t\t\tthis.open = true;\n\t\t\te.preventDefault();\n\t\t}\n\t}\n\n\t_afterPopoverClose() {\n\t\tthis.open = false;\n\t\tthis.fireEvent(\"close\", {}, false, true);\n\t}\n}\n\nMenu.define();\n\nexport default Menu;\nexport type {\n\tMenuItemClickEventDetail,\n\tMenuBeforeCloseEventDetail,\n\tMenuBeforeOpenEventDetail,\n};\n"]}

package/dist/MenuItem.d.ts

@@ -0,0 +1,151 @@
+import ListItem from "./ListItem.js";
+import ResponsivePopover from "./ResponsivePopover.js";
+import PopoverPlacement from "./types/PopoverPlacement.js";
+import type { ResponsivePopoverBeforeCloseEventDetail } from "./ResponsivePopover.js";
+type MenuBeforeOpenEventDetail = {
+    item?: MenuItem;
+};
+type MenuBeforeCloseEventDetail = {
+    escPressed: boolean;
+};
+/**
+ * @class
+ *
+ * ### Overview
+ *
+ * `ui5-menu-item` is the item to use inside a `ui5-menu`.
+ * An arbitrary hierarchy structure can be represented by recursively nesting menu items.
+ *
+ * ### Usage
+ *
+ * `ui5-menu-item` represents a node in a `ui5-menu`. The menu itself is rendered as a list,
+ * and each `ui5-menu-item` is represented by a list item in that list. Therefore, you should only use
+ * `ui5-menu-item` directly in your apps. The `ui5-li` list item is internal for the list, and not intended for public use.
+ *
+ * ### ES6 Module Import
+ *
+ * `import "@ui5/webcomponents/dist/MenuItem.js";`
+ * @constructor
+ * @extends ListItem
+ * @since 1.3.0
+ * @public
+ */
+declare class MenuItem extends ListItem {
+    static onDefine(): Promise<void>;
+    /**
+     * Defines the text of the tree item.
+     * @default ""
+     * @public
+     */
+    text: string;
+    /**
+     * Defines the `additionalText`, displayed in the end of the menu item.
+     *
+     * **Note:** The additional text would not be displayed if the item has a submenu.
+     * @default ""
+     * @public
+     * @since 1.8.0
+     */
+    additionalText: string;
+    /**
+     * Defines the icon to be displayed as graphical element within the component.
+     * The SAP-icons font provides numerous options.
+     *
+     * **Example:**
+     *
+     * See all the available icons in the [Icon Explorer](https://sdk.openui5.org/test-resources/sap/m/demokit/iconExplorer/webapp/index.html).
+     * @default ""
+     * @public
+     */
+    icon: string;
+    /**
+     * Defines whether a visual separator should be rendered before the item.
+     * @default false
+     * @public
+     */
+    startsSection: boolean;
+    /**
+     * Defines whether `ui5-menu-item` is in disabled state.
+     *
+     * **Note:** A disabled `ui5-menu-item` is noninteractive.
+     * @default false
+     * @public
+     */
+    disabled: boolean;
+    /**
+     * Defines the delay in milliseconds, after which the loading indicator will be displayed inside the corresponding ui5-menu popover.
+     *
+     * **Note:** If set to `true` a `ui5-busy-indicator` component will be displayed into the related one to the current `ui5-menu-item` sub-menu popover.
+     * @default false
+     * @public
+     * @since 1.13.0
+     */
+    loading: boolean;
+    /**
+     * Defines the delay in milliseconds, after which the loading indicator will be displayed inside the corresponding ui5-menu popover.
+     * @default 1000
+     * @public
+     * @since 1.13.0
+     */
+    loadingDelay: number;
+    /**
+     * Defines the accessible ARIA name of the component.
+     * @default ""
+     * @public
+     * @since 1.7.0
+     */
+    accessibleName: string;
+    /**
+     * Defines the text of the tooltip for the menu item.
+     * @default ""
+     * @public
+     * @since 1.23.0
+     */
+    tooltip: string;
+    /**
+     * Indicates whether any of the element siblings have icon.
+     */
+    _siblingsWithIcon: boolean;
+    /**
+     * Defines the items of this component.
+     * @public
+     */
+    items: Array<MenuItem>;
+    get placement(): `${PopoverPlacement}`;
+    get isRtl(): boolean;
+    get hasSubmenu(): boolean;
+    get hasIcon(): boolean;
+    get isSubMenuOpen(): boolean;
+    get ariaLabelledByText(): string;
+    get menuHeaderTextPhone(): string;
+    get isPhone(): boolean;
+    get labelBack(): string;
+    get labelClose(): string;
+    onBeforeRendering(): void;
+    get _focusable(): boolean;
+    get _accInfo(): {
+        role: string;
+        ariaHaspopup: "dialog" | "grid" | "listbox" | "menu" | "tree" | undefined;
+        ariaExpanded?: boolean | undefined;
+        ariaLevel?: number | undefined;
+        ariaLabel: string;
+        ariaLabelRadioButton: string;
+        ariaSelectedText?: string | undefined;
+        posinset?: number | undefined;
+        setsize?: number | undefined;
+        ariaSelected?: boolean | undefined;
+        ariaChecked?: boolean | undefined;
+        listItemAriaLabel?: string | undefined;
+        ariaOwns?: string | undefined;
+        tooltip?: string | undefined;
+    };
+    get _popover(): ResponsivePopover;
+    _closeAll(): void;
+    _close(): void;
+    _beforePopoverOpen(e: CustomEvent): void;
+    _afterPopoverOpen(): void;
+    _beforePopoverClose(e: CustomEvent<ResponsivePopoverBeforeCloseEventDetail>): void;
+    _afterPopoverClose(): void;
+}
+export default MenuItem;
+export type { MenuBeforeCloseEventDetail, MenuBeforeOpenEventDetail, };