@openui5/sap.f 1.141.2 → 1.142.1

package/src/sap/f/gen/ui5/webcomponents/dist/ListItemGroup.js

@@ -0,0 +1,207 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+sap.ui.define(
+  [
+    "sap/ui/core/webc/WebComponent",
+    "sap/f/gen/ui5/webcomponents",
+    "sap/f/thirdparty/SearchItemGroup"
+  ],
+  function (WebComponentBaseClass) {
+    "use strict";
+
+    /**
+     * @class
+     * ### Overview
+     * The `ui5-li-group` is a special list item, used only to create groups of list items.
+     *
+     * This is the item to use inside a `ui5-list`.
+     *
+     * ### ES6 Module Import
+     * `import "@ui5/webcomponents/dist/ListItemGroup.js";`
+     *
+     * @extends sap.ui.core.webc.WebComponent
+     * @constructor
+     * @private
+     * @alias module:sap/f/gen/ui5/webcomponents/dist/ListItemGroup
+     */
+
+    const WrapperClass = WebComponentBaseClass.extend(
+      "sap.f.gen.ui5.webcomponents.dist.ListItemGroup",
+      {
+        metadata: {
+          tag: "ui5-li-group-cc48984a",
+
+          namespace: "sap.f.gen.ui5.webcomponents",
+
+          library: "sap.f",
+
+          designtime: "sap/f/gen/ui5/webcomponents/designtime/ListItemGroup.designtime",
+
+          interfaces: [],
+
+          defaultAggregation: "items",
+
+          properties: {
+            /**
+             * Defines the header text of the <code>ui5-li-group</code>.
+             */
+            headerText: { type: "string", mapping: "property" },
+            /**
+             * Defines the accessible name of the header.
+             */
+            headerAccessibleName: { type: "string", mapping: "property" },
+            /**
+             * Defines if the text of the component should wrap when it's too long.
+             * When set to "Normal", the content (title, description) will be wrapped
+             * using the `ui5-expandable-text` component.<br/>
+             *
+             * The text can wrap up to 100 characters on small screens (size S) and
+             * up to 300 characters on larger screens (size M and above). When text exceeds
+             * these limits, it truncates with an ellipsis followed by a text expansion trigger.
+             *
+             * Available options are:
+             * - `None` (default) - The text will truncate with an ellipsis.
+             * - `Normal` - The text will wrap (without truncation).
+             * @type module:sap/f/gen/ui5/webcomponents.WrappingType
+             */
+            wrappingType: {
+              type: "sap.f.gen.ui5.webcomponents.WrappingType",
+              mapping: "property",
+              defaultValue: "None"
+            },
+            /**
+             * The text-content of the Web Component.
+             */
+            text: { type: "string", mapping: "textContent" },
+            /**
+             * The 'width' of the Web Component in <code>sap.ui.core.CSSSize</code>.
+             */
+            width: { type: "sap.ui.core.CSSSize", mapping: "style" },
+            /**
+             * The 'height' of the Web Component in <code>sap.ui.core.CSSSize</code>.
+             */
+            height: { type: "sap.ui.core.CSSSize", mapping: "style" }
+          },
+
+          aggregations: {
+            /**
+             * Defines the items of the <code>ui5-li-group</code>.
+             * @type module:sap/f/gen/ui5/webcomponents/dist/ListItemBase
+             */
+            items: {
+              type: "sap.f.gen.ui5.webcomponents.dist.ListItemBase",
+              multiple: true
+            },
+            /**
+             * Defines the header of the component.
+             *
+             * **Note:** Using this slot, the default header text of group and the value of `headerText` property will be overwritten.
+             * @type module:sap/f/gen/ui5/webcomponents/dist/ListItemBase
+             */
+            header: {
+              type: "sap.f.gen.ui5.webcomponents.dist.ListItemBase",
+              multiple: true,
+              slot: "header"
+            }
+          },
+
+          associations: {},
+
+          events: {
+            /**
+             * Fired when a movable list item is moved over a potential drop target during a dragging operation.
+             *
+             * If the new position is valid, prevent the default action of the event using `preventDefault()`.
+             */
+            moveOver: {
+              allowPreventDefault: true,
+              enableEventBubbling: true,
+              parameters: {
+                /**
+                 * Contains information about the moved element under `element` property.
+                 */
+                source: {
+                  type: "object",
+                  types: [
+                    {
+                      origType: "object",
+                      multiple: false,
+                      dedicatedTypes: [{ dtsType: "object", ui5Type: "object" }]
+                    }
+                  ],
+                  dtsParamDescription:
+                    "Contains information about the moved element under `element` property."
+                },
+                /**
+                 * Contains information about the destination of the moved element. Has `element` and `placement` properties.
+                 */
+                destination: {
+                  type: "object",
+                  types: [
+                    {
+                      origType: "object",
+                      multiple: false,
+                      dedicatedTypes: [{ dtsType: "object", ui5Type: "object" }]
+                    }
+                  ],
+                  dtsParamDescription:
+                    "Contains information about the destination of the moved element. Has `element` and `placement` properties."
+                }
+              }
+            },
+
+            /**
+             * Fired when a movable list item is dropped onto a drop target.
+             *
+             * **Note:** `move` event is fired only if there was a preceding `move-over` with prevented default action.
+             */
+            move: {
+              enableEventBubbling: true,
+              parameters: {
+                /**
+                 * Contains information about the moved element under `element` property.
+                 */
+                source: {
+                  type: "object",
+                  types: [
+                    {
+                      origType: "object",
+                      multiple: false,
+                      dedicatedTypes: [{ dtsType: "object", ui5Type: "object" }]
+                    }
+                  ],
+                  dtsParamDescription:
+                    "Contains information about the moved element under `element` property."
+                },
+                /**
+                 * Contains information about the destination of the moved element. Has `element` and `placement` properties.
+                 */
+                destination: {
+                  type: "object",
+                  types: [
+                    {
+                      origType: "object",
+                      multiple: false,
+                      dedicatedTypes: [{ dtsType: "object", ui5Type: "object" }]
+                    }
+                  ],
+                  dtsParamDescription:
+                    "Contains information about the destination of the moved element. Has `element` and `placement` properties."
+                }
+              }
+            }
+          },
+
+          getters: [],
+
+          methods: []
+        }
+      }
+    );
+
+    return WrapperClass;
+  }
+);

package/src/sap/f/gen/ui5/webcomponents/dist/Menu.js

@@ -0,0 +1,280 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+sap.ui.define(
+  [
+    "sap/ui/core/webc/WebComponent",
+    "sap/f/gen/ui5/webcomponents",
+    "sap/f/thirdparty/Menu"
+  ],
+  function (WebComponentBaseClass) {
+    "use strict";
+
+    /**
+     * @class
+     * ### Overview
+     *
+     * `ui5-menu` component represents a hierarchical menu structure.
+     *
+     * ### Structure
+     *
+     * The `ui5-menu` can hold two types of entities:
+     *
+     * - `ui5-menu-item` components
+     * - `ui5-menu-separator` - used to separate menu items with a line
+     *
+     * 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.
+     *
+     * when there is `endContent` :
+     * - `Arrow Left` or `ArrowRight` - Navigate between the menu item actions and the menu item itself
+     * - `Arrow Up` / `Arrow Down` - Navigates up and down the currently visible menu items
+     *
+     * **Note:** If the text direction is set to Right-to-left (RTL), `Arrow Right` and `Arrow Left` functionality is swapped.
+     *
+     * Application developers are responsible for ensuring that interactive elements placed in the `endContent` slot
+     * have the correct accessibility behaviour, including their enabled or disabled states.
+     * The menu does not manage these aspects when the menu item state changes.
+     *
+     * ### ES6 Module Import
+     *
+     * `import "@ui5/webcomponents/dist/Menu.js";`
+     *
+     * @extends sap.ui.core.webc.WebComponent
+     * @constructor
+     * @private
+     * @alias module:sap/f/gen/ui5/webcomponents/dist/Menu
+     */
+
+    const WrapperClass = WebComponentBaseClass.extend(
+      "sap.f.gen.ui5.webcomponents.dist.Menu",
+      {
+        metadata: {
+          tag: "ui5-menu-cc48984a",
+
+          namespace: "sap.f.gen.ui5.webcomponents",
+
+          library: "sap.f",
+
+          designtime: "sap/f/gen/ui5/webcomponents/designtime/Menu.designtime",
+
+          interfaces: [],
+
+          defaultAggregation: "items",
+
+          properties: {
+            /**
+             * Defines the header text of the menu (displayed on mobile).
+             */
+            headerText: { type: "string", mapping: "property" },
+            /**
+             * Indicates if the menu is open.
+             */
+            open: { type: "boolean", mapping: "property", defaultValue: false },
+            /**
+             * Determines the horizontal alignment of the menu relative to its opener control.
+             * @type module:sap/f/gen/ui5/webcomponents.PopoverHorizontalAlign
+             */
+            horizontalAlign: {
+              type: "sap.f.gen.ui5.webcomponents.PopoverHorizontalAlign",
+              mapping: "property",
+              defaultValue: "Start"
+            },
+            /**
+             * Defines if a loading indicator would be displayed inside the corresponding ui5-menu popover.
+             */
+            loading: {
+              type: "boolean",
+              mapping: "property",
+              defaultValue: false
+            },
+            /**
+             * Defines the delay in milliseconds, after which the loading indicator will be displayed inside the corresponding ui5-menu popover.
+             */
+            loadingDelay: {
+              type: "float",
+              mapping: "property",
+              defaultValue: 1000
+            },
+            /**
+             * The text-content of the Web Component.
+             */
+            text: { type: "string", mapping: "textContent" },
+            /**
+             * The 'width' of the Web Component in <code>sap.ui.core.CSSSize</code>.
+             */
+            width: { type: "sap.ui.core.CSSSize", mapping: "style" },
+            /**
+             * The 'height' of the Web Component in <code>sap.ui.core.CSSSize</code>.
+             */
+            height: { type: "sap.ui.core.CSSSize", mapping: "style" }
+          },
+
+          aggregations: {
+            /**
+             * Defines the items of this component.
+             *
+             * **Note:** Use `ui5-menu-item` and `ui5-menu-separator` for their intended design.
+             * @type module:sap/f/gen/ui5/webcomponents.IMenuItem
+             */
+            items: { type: "sap.f.gen.ui5.webcomponents.IMenuItem", multiple: true }
+          },
+
+          associations: {
+            /**
+             * 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.
+             */
+            opener: { mapping: { type: "property", to: "opener" } }
+          },
+
+          events: {
+            /**
+             * 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.
+             */
+            itemClick: {
+              allowPreventDefault: true,
+              parameters: {
+                /**
+                 * The currently clicked menu item.
+                 */
+                item: {
+                  type: "sap.ui.core.Control",
+                  types: [
+                    {
+                      origType: "HTMLElement",
+                      multiple: false,
+                      dedicatedTypes: [
+                        {
+                          dtsType: "Control",
+                          packageName: "sap/ui/core/Control",
+                          moduleType: "module:sap/ui/core/Control",
+                          ui5Type: "sap.ui.core.Control",
+                          isClass: true
+                        }
+                      ]
+                    }
+                  ],
+                  dtsParamDescription: "The currently clicked menu item."
+                },
+                /**
+                 * The text of the currently clicked menu item.
+                 */
+                text: {
+                  type: "string",
+                  types: [
+                    {
+                      origType: "string",
+                      multiple: false,
+                      dedicatedTypes: [{ dtsType: "string", ui5Type: "string" }]
+                    }
+                  ],
+                  dtsParamDescription:
+                    "The text of the currently clicked menu item."
+                }
+              }
+            },
+
+            /**
+             * Fired before the menu is opened. This event can be cancelled, which will prevent the menu from opening.
+             *
+             * **Note:** Since 1.14.0 the event is also fired before a sub-menu opens.
+             */
+            beforeOpen: {
+              allowPreventDefault: true,
+              enableEventBubbling: true,
+              parameters: {
+                /**
+                 * The `ui5-menu-item` that triggers opening of the sub-menu or undefined when fired upon root menu opening.
+                 */
+                item: {
+                  type: "sap.ui.core.Control",
+                  types: [
+                    {
+                      origType: "HTMLElement",
+                      multiple: false,
+                      dedicatedTypes: [
+                        {
+                          dtsType: "Control",
+                          packageName: "sap/ui/core/Control",
+                          moduleType: "module:sap/ui/core/Control",
+                          ui5Type: "sap.ui.core.Control",
+                          isClass: true
+                        }
+                      ]
+                    }
+                  ],
+                  dtsParamDescription:
+                    "The `ui5-menu-item` that triggers opening of the sub-menu or undefined when fired upon root menu opening."
+                }
+              }
+            },
+
+            /**
+             * Fired after the menu is opened.
+             */
+            onOpen: {
+              enableEventBubbling: true,
+              mapping: "open",
+              parameters: {}
+            },
+
+            /**
+             * Fired before the menu is closed. This event can be cancelled, which will prevent the menu from closing.
+             */
+            beforeClose: {
+              allowPreventDefault: true,
+              enableEventBubbling: true,
+              parameters: {
+                /**
+                 * Indicates that `ESC` key has triggered the event.
+                 */
+                escPressed: {
+                  type: "boolean",
+                  types: [
+                    {
+                      origType: "boolean",
+                      multiple: false,
+                      dedicatedTypes: [
+                        { dtsType: "boolean", ui5Type: "boolean" }
+                      ]
+                    }
+                  ],
+                  dtsParamDescription:
+                    "Indicates that `ESC` key has triggered the event."
+                }
+              }
+            },
+
+            /**
+             * Fired after the menu is closed.
+             */
+            close: {
+              parameters: {}
+            }
+          },
+
+          getters: [],
+
+          methods: []
+        }
+      }
+    );
+
+    return WrapperClass;
+  }
+);