@openui5/sap.f 1.141.2 → 1.142.0

package/src/sap/f/cards/loading/ObjectPlaceholder.js

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * @extends sap.f.cards.loading.PlaceholderBase
 	 *
 	 * @author SAP SE
-	 * @version 1.141.2
+	 * @version 1.142.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/cards/loading/PlaceholderBase.js

@@ -22,7 +22,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.141.2
+	 * @version 1.142.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/cards/loading/TablePlaceholder.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @extends sap.f.cards.loading.PlaceholderBase
 	 *
 	 * @author SAP SE
-	 * @version 1.141.2
+	 * @version 1.142.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/cards/loading/TimelinePlaceholder.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @extends sap.f.cards.loading.PlaceholderBase
 	 *
 	 * @author SAP SE
-	 * @version 1.141.2
+	 * @version 1.142.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/changeHandler/MoveDynamicPageTitleActions.js

@@ -16,7 +16,7 @@ sap.ui.define([
 		 *
 		 * @alias sap.f.changeHandler.MoveDynamicPageTitleActions
 		 * @author SAP SE
-		 * @version 1.141.2
+		 * @version 1.142.0
 		 */
 		var MoveActions = { };
 		var ACTION_AGGREGATION_NAME = "actions";

package/src/sap/f/delegate/GridContainerItemNavigation.js

@@ -25,7 +25,7 @@ sap.ui.define([
 	 *
 	 *
 	 * @author SAP SE
-	 * @version 1.141.2
+	 * @version 1.142.0
 	 *
 	 * @extends sap.f.delegate.GridItemNavigation
 	 *

package/src/sap/f/delegate/GridItemNavigation.js

@@ -34,7 +34,7 @@ sap.ui.define([
 	 *
 	 *
 	 * @author SAP SE
-	 * @version 1.141.2
+	 * @version 1.142.0
 	 *
 	 * @extends sap.ui.core.delegate.ItemNavigation
 	 *

package/src/sap/f/dnd/GridDragOver.js

@@ -18,7 +18,7 @@ sap.ui.define([
 	 * Handles dragging of a control over a given grid container.
 	 *
 	 * @author SAP SE
-	 * @version 1.141.2
+	 * @version 1.142.0
 	 *
 	 * @extends sap.ui.base.Object
 	 *

package/src/sap/f/dnd/GridDropInfo.js

@@ -37,7 +37,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.dnd.DropInfo
 	 *
 	 * @author SAP SE
-	 * @version 1.141.2
+	 * @version 1.142.0
 	 *
 	 * @public
 	 * @since 1.68

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

@@ -0,0 +1,238 @@
+/*!
+ * 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/ui/core/EnabledPropagator",
+    "sap/f/gen/ui5/webcomponents",
+    "sap/f/thirdparty/Avatar"
+  ],
+  function (WebComponentBaseClass, EnabledPropagator) {
+    "use strict";
+
+    /**
+     * @class
+     * ### Overview
+     *
+     * An image-like component that has different display options for representing images and icons
+     * in different shapes and sizes, depending on the use case.
+     *
+     * The shape can be circular or square. There are several predefined sizes, as well as an option to
+     * set a custom size.
+     *
+     * ### Keyboard Handling
+     *
+     * - [Space] / [Enter] or [Return] - Fires the `click` event if the `interactive` property is set to true.
+     * - [Shift] - If [Space] is pressed, pressing [Shift] releases the component without triggering the click event.
+     *
+     * ### ES6 Module Import
+     * `import "sap/f/gen/ui5/webcomponents/dist/Avatar.js";`
+     *
+     * @implements module:sap/f/gen/ui5/webcomponents.IAvatarGroupItem
+     * @extends sap.ui.core.webc.WebComponent
+     * @constructor
+     * @private
+     * @alias module:sap/f/gen/ui5/webcomponents/dist/Avatar
+     */
+
+    const WrapperClass = WebComponentBaseClass.extend(
+      "sap.f.gen.ui5.webcomponents.dist.Avatar",
+      {
+        metadata: {
+          tag: "ui5-avatar-87689b96",
+
+          namespace: "sap.f.gen.ui5.webcomponents",
+
+          library: "sap.f",
+
+          designtime: "sap/f/gen/ui5/webcomponents/designtime/Avatar.designtime",
+
+          interfaces: ["sap.f.gen.ui5.webcomponents.IAvatarGroupItem"],
+
+          defaultAggregation: "image",
+
+          properties: {
+            /**
+             * Defines whether the component is disabled.
+             * A disabled component can't be pressed or
+             * focused, and it is not in the tab chain.
+             */
+            enabled: {
+              type: "boolean",
+              defaultValue: "true",
+              mapping: {
+                type: "property",
+                to: "disabled",
+                formatter: "_mapEnabled"
+              }
+            },
+            /**
+             * Defines if the avatar is interactive (focusable and pressable).
+             *
+             * **Note:** This property won't have effect if the `disabled`
+             * property is set to `true`.
+             */
+            interactive: {
+              type: "boolean",
+              mapping: "property",
+              defaultValue: false
+            },
+            /**
+             * Defines the name of the UI5 Icon, that will be displayed.
+             *
+             * **Note:** If `image` slot is provided, the property will be ignored.
+             *
+             * **Note:** You should import the desired icon first, then use its name as "icon".
+             *
+             * `import "sap/f/gen/ui5/webcomponents-icons/dist/{icon_name}.js"`
+             *
+             * `<ui5-avatar icon="employee">`
+             *
+             * **Note:** If no icon or an empty one is provided, by default the "employee" icon should be displayed.
+             *
+             * See all the available icons in the [Icon Explorer](https://sdk.openui5.org/test-resources/sap/m/demokit/iconExplorer/webapp/index.html).
+             */
+            icon: { type: "string", mapping: "property" },
+            /**
+             * Defines the name of the fallback icon, which should be displayed in the following cases:
+             *
+             * 	- If the initials are not valid (more than 3 letters, unsupported languages or empty initials).
+             * 	- If there are three initials and they do not fit in the shape (e.g. WWW for some of the sizes).
+             * 	- If the image src is wrong.
+             *
+             * **Note:** If not set, a default fallback icon "employee" is displayed.
+             *
+             * **Note:** You should import the desired icon first, then use its name as "fallback-icon".
+             *
+             * `import "sap/f/gen/ui5/webcomponents-icons/dist/{icon_name}.js"`
+             *
+             * `<ui5-avatar fallback-icon="alert">`
+             *
+             * See all the available icons in the [Icon Explorer](https://sdk.openui5.org/test-resources/sap/m/demokit/iconExplorer/webapp/index.html).
+             */
+            fallbackIcon: {
+              type: "string",
+              mapping: "property",
+              defaultValue: "employee"
+            },
+            /**
+             * Defines the displayed initials.
+             *
+             * Up to three Latin letters can be displayed as initials.
+             */
+            initials: { type: "string", mapping: "property" },
+            /**
+             * Defines the shape of the component.
+             * @type module:sap/f/gen/ui5/webcomponents.AvatarShape
+             */
+            shape: {
+              type: "sap.f.gen.ui5.webcomponents.AvatarShape",
+              mapping: "property",
+              defaultValue: "Circle"
+            },
+            /**
+             * Defines predefined size of the component.
+             * @type module:sap/f/gen/ui5/webcomponents.AvatarSize
+             */
+            size: {
+              type: "sap.f.gen.ui5.webcomponents.AvatarSize",
+              mapping: "property",
+              defaultValue: "S"
+            },
+            /**
+             * Defines the background color of the desired image.
+             * If `colorScheme` is set to `Auto`, the avatar will be displayed with the `Accent6` color.
+             * @type module:sap/f/gen/ui5/webcomponents.AvatarColorScheme
+             */
+            colorScheme: {
+              type: "sap.f.gen.ui5.webcomponents.AvatarColorScheme",
+              mapping: "property",
+              defaultValue: "Auto"
+            },
+            /**
+             * Defines the text alternative of the component.
+             * If not provided a default text alternative will be set, if present.
+             */
+            accessibleName: { type: "string", mapping: "property" },
+            /**
+             * Defines the additional accessibility attributes that will be applied to the component.
+             * The following field is supported:
+             *
+             * - **hasPopup**: Indicates the availability and type of interactive popup element, such as menu or dialog, that can be triggered by the button.
+             * Accepts the following string values: `dialog`, `grid`, `listbox`, `menu` or `tree`.
+             */
+            accessibilityAttributes: {
+              type: "any",
+              mapping: "property",
+              defaultValue: "{}"
+            },
+            /**
+             * 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: {
+            /**
+             * Receives the desired `<img>` tag
+             *
+             * **Note:** If you experience flickering of the provided image, you can hide the component until it is defined with the following CSS:<br/>
+             * `ui5-avatar:not(:defined) {`<br/>
+             * &nbsp;&nbsp;&nbsp;&nbsp;`visibility: hidden;`<br/>
+             * `}`
+             * @type module:sap/ui/core/Control
+             */
+            image: { type: "sap.ui.core.Control", multiple: true },
+            /**
+             * Defines the optional badge that will be used for visual affordance.
+             *
+             * **Note:** While the slot allows for custom badges, to achieve
+             * the Fiori design, you can use the `ui5-tag` with `ui5-icon`
+             * in the corresponding `icon` slot, without text nodes.
+             * @type module:sap/ui/core/Control
+             */
+            badge: {
+              type: "sap.ui.core.Control",
+              multiple: true,
+              slot: "badge"
+            }
+          },
+
+          associations: {},
+
+          events: {
+            /**
+             * Fired on mouseup, space and enter if avatar is interactive
+             *
+             * **Note:** The event will not be fired if the `disabled`
+             * property is set to `true`.
+             */
+            click: {
+              enableEventBubbling: true,
+              parameters: {}
+            }
+          },
+
+          getters: [],
+
+          methods: []
+        }
+      }
+    );
+
+    EnabledPropagator.call(WrapperClass.prototype);
+
+    return WrapperClass;
+  }
+);

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

@@ -0,0 +1,339 @@
+/*!
+ * 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/ui/core/EnabledPropagator",
+    "sap/f/gen/ui5/webcomponents",
+    "sap/f/thirdparty/Button"
+  ],
+  function (WebComponentBaseClass, EnabledPropagator) {
+    "use strict";
+
+    /**
+     * @class
+     * ### Overview
+     *
+     * The `ui5-button` component represents a simple push button.
+     * It enables users to trigger actions by clicking or tapping the `ui5-button`, or by pressing
+     * certain keyboard keys, such as Enter.
+     *
+     * ### Usage
+     *
+     * For the `ui5-button` UI, you can define text, icon, or both. You can also specify
+     * whether the text or the icon is displayed first.
+     *
+     * You can choose from a set of predefined types that offer different
+     * styling to correspond to the triggered action.
+     *
+     * You can set the `ui5-button` as enabled or disabled. An enabled
+     * `ui5-button` can be pressed by clicking or tapping it. The button changes
+     * its style to provide visual feedback to the user that it is pressed or hovered over with
+     * the mouse cursor. A disabled `ui5-button` appears inactive and cannot be pressed.
+     *
+     * ### ES6 Module Import
+     *
+     * `import "sap/f/gen/ui5/webcomponents/dist/Button.js";`
+     *
+     * @implements module:sap/f/gen/ui5/webcomponents.IButton
+     * @extends sap.ui.core.webc.WebComponent
+     * @constructor
+     * @private
+     * @alias module:sap/f/gen/ui5/webcomponents/dist/Button
+     */
+
+    const WrapperClass = WebComponentBaseClass.extend(
+      "sap.f.gen.ui5.webcomponents.dist.Button",
+      {
+        metadata: {
+          tag: "ui5-button-87689b96",
+
+          namespace: "sap.f.gen.ui5.webcomponents",
+
+          library: "sap.f",
+
+          designtime: "sap/f/gen/ui5/webcomponents/designtime/Button.designtime",
+
+          interfaces: ["sap.f.gen.ui5.webcomponents.IButton"],
+
+          defaultAggregation: "",
+
+          properties: {
+            /**
+             * Defines the component design.
+             * @type module:sap/f/gen/ui5/webcomponents.ButtonDesign
+             */
+            design: {
+              type: "sap.f.gen.ui5.webcomponents.ButtonDesign",
+              mapping: "property",
+              defaultValue: "Default"
+            },
+            /**
+             * Defines whether the component is disabled.
+             * A disabled component can't be pressed or
+             * focused, and it is not in the tab chain.
+             */
+            enabled: {
+              type: "boolean",
+              defaultValue: "true",
+              mapping: {
+                type: "property",
+                to: "disabled",
+                formatter: "_mapEnabled"
+              }
+            },
+            /**
+             * Defines the icon, displayed as graphical element within the component.
+             * The SAP-icons font provides numerous options.
+             *
+             * Example:
+             * See all the available icons within the [Icon Explorer](https://sdk.openui5.org/test-resources/sap/m/demokit/iconExplorer/webapp/index.html).
+             */
+            icon: { type: "string", mapping: "property" },
+            /**
+             * Defines the icon, displayed as graphical element within the component after the button text.
+             *
+             * **Note:** It is highly recommended to use `endIcon` property only together with `icon` and/or `text` properties.
+             * Usage of `endIcon` only should be avoided.
+             *
+             * The SAP-icons font provides numerous options.
+             *
+             * Example:
+             * See all the available icons within the [Icon Explorer](https://sdk.openui5.org/test-resources/sap/m/demokit/iconExplorer/webapp/index.html).
+             */
+            endIcon: { type: "string", mapping: "property" },
+            /**
+             * When set to `true`, the component will
+             * automatically submit the nearest HTML form element on `press`.
+             *
+             * **Note:** This property is only applicable within the context of an HTML Form element.`
+             */
+            submits: {
+              type: "boolean",
+              mapping: "property",
+              defaultValue: false
+            },
+            /**
+             * Defines the accessible ARIA name of the component.
+             */
+            accessibleName: { type: "string", mapping: "property" },
+            /**
+             * Defines the additional accessibility attributes that will be applied to the component.
+             * The following fields are supported:
+             *
+             * - **expanded**: Indicates whether the button, or another grouping element it controls, is currently expanded or collapsed.
+             * Accepts the following string values: `true` or `false`
+             *
+             * - **hasPopup**: Indicates the availability and type of interactive popup element, such as menu or dialog, that can be triggered by the button.
+             * Accepts the following string values: `dialog`, `grid`, `listbox`, `menu` or `tree`.
+             *
+             * - **ariaLabel**: Defines the accessible ARIA name of the component.
+             * Accepts any string value.
+             *
+             *  - **ariaKeyShortcuts**: Defines keyboard shortcuts that activate or give focus to the button.
+             *
+             * - **controls**: Identifies the element (or elements) whose contents or presence are controlled by the button element.
+             * Accepts a lowercase string value.
+             */
+            accessibilityAttributes: {
+              type: "any",
+              mapping: "property",
+              defaultValue: "{}"
+            },
+            /**
+             * Defines the accessible description of the component.
+             */
+            accessibleDescription: { type: "string", mapping: "property" },
+            /**
+             * Defines whether the button has special form-related functionality.
+             *
+             * **Note:** This property is only applicable within the context of an HTML Form element.
+             * @type module:sap/f/gen/ui5/webcomponents.ButtonType
+             */
+            type: {
+              type: "sap.f.gen.ui5.webcomponents.ButtonType",
+              mapping: "property",
+              defaultValue: "Button"
+            },
+            /**
+             * Describes the accessibility role of the button.
+             *
+             * **Note:** Use <code>ButtonAccessibleRole.Link</code> role only with a press handler, which performs a navigation. In all other scenarios the default button semantics are recommended.
+             * @type module:sap/f/gen/ui5/webcomponents.ButtonAccessibleRole
+             */
+            accessibleRole: {
+              type: "sap.f.gen.ui5.webcomponents.ButtonAccessibleRole",
+              mapping: "property",
+              defaultValue: "Button"
+            },
+            /**
+             * Defines whether the button shows a loading indicator.
+             *
+             * **Note:** If set to `true`, a busy indicator component will be displayed on the related button.
+             */
+            loading: {
+              type: "boolean",
+              mapping: "property",
+              defaultValue: false
+            },
+            /**
+             * Specifies the delay in milliseconds before the loading indicator appears within the associated button.
+             */
+            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: {
+            /**
+             * Adds a badge to the button.
+             * @type module:sap/f/gen/ui5/webcomponents/dist/ButtonBadge
+             */
+            badge: {
+              type: "sap.f.gen.ui5.webcomponents.dist.ButtonBadge",
+              multiple: true,
+              slot: "badge"
+            }
+          },
+
+          associations: {
+            /**
+             * Receives id(or many ids) of the elements that label the component.
+             */
+            ariaLabelledBy: {
+              type: "sap.ui.core.Control",
+              multiple: true,
+              mapping: {
+                type: "property",
+                to: "accessibleNameRef",
+                formatter: "_getAriaLabelledByForRendering"
+              }
+            }
+          },
+
+          events: {
+            /**
+             * Fired when the component is activated either with a mouse/tap or by using the Enter or Space key.
+             *
+             * **Note:** The event will not be fired if the `disabled` property is set to `true`.
+             */
+            click: {
+              allowPreventDefault: true,
+              enableEventBubbling: true,
+              parameters: {
+                /**
+                 * Returns original event that comes from user's **click** interaction
+                 */
+                originalEvent: {
+                  type: "object",
+                  types: [
+                    {
+                      origType: "Event",
+                      multiple: false,
+                      dedicatedTypes: [{ dtsType: "Event", ui5Type: "object" }]
+                    }
+                  ],
+                  dtsParamDescription:
+                    "Returns original event that comes from user's **click** interaction"
+                },
+                /**
+                 * Returns whether the "ALT" key was pressed when the event was triggered.
+                 */
+                altKey: {
+                  type: "boolean",
+                  types: [
+                    {
+                      origType: "boolean",
+                      multiple: false,
+                      dedicatedTypes: [
+                        { dtsType: "boolean", ui5Type: "boolean" }
+                      ]
+                    }
+                  ],
+                  dtsParamDescription:
+                    'Returns whether the "ALT" key was pressed when the event was triggered.'
+                },
+                /**
+                 * Returns whether the "CTRL" key was pressed when the event was triggered.
+                 */
+                ctrlKey: {
+                  type: "boolean",
+                  types: [
+                    {
+                      origType: "boolean",
+                      multiple: false,
+                      dedicatedTypes: [
+                        { dtsType: "boolean", ui5Type: "boolean" }
+                      ]
+                    }
+                  ],
+                  dtsParamDescription:
+                    'Returns whether the "CTRL" key was pressed when the event was triggered.'
+                },
+                /**
+                 * Returns whether the "META" key was pressed when the event was triggered.
+                 */
+                metaKey: {
+                  type: "boolean",
+                  types: [
+                    {
+                      origType: "boolean",
+                      multiple: false,
+                      dedicatedTypes: [
+                        { dtsType: "boolean", ui5Type: "boolean" }
+                      ]
+                    }
+                  ],
+                  dtsParamDescription:
+                    'Returns whether the "META" key was pressed when the event was triggered.'
+                },
+                /**
+                 * Returns whether the "SHIFT" key was pressed when the event was triggered.
+                 */
+                shiftKey: {
+                  type: "boolean",
+                  types: [
+                    {
+                      origType: "boolean",
+                      multiple: false,
+                      dedicatedTypes: [
+                        { dtsType: "boolean", ui5Type: "boolean" }
+                      ]
+                    }
+                  ],
+                  dtsParamDescription:
+                    'Returns whether the "SHIFT" key was pressed when the event was triggered.'
+                }
+              }
+            }
+          },
+
+          getters: [],
+
+          methods: []
+        }
+      }
+    );
+
+    EnabledPropagator.call(WrapperClass.prototype);
+
+    return WrapperClass;
+  }
+);