@openui5/sap.f 1.141.1 → 1.142.0

package/src/sap/f/gen/ui5/webcomponents_fiori/dist/IllustratedMessage.js

@@ -0,0 +1,211 @@
+/*!
+ * 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_fiori",
+    "sap/f/thirdparty/IllustratedMessage"
+  ],
+  function (WebComponentBaseClass) {
+    "use strict";
+
+    /**
+     * @class
+     * ### Overview
+     * An IllustratedMessage is a recommended combination of a solution-oriented message, an engaging
+     * illustration, and conversational tone to better communicate an empty or a success state than just show
+     * a message alone.
+     *
+     * Each illustration has default internationalised title and subtitle texts. Also they can be managed with
+     * `titleText` and `subtitleText` properties.
+     *
+     * To display the desired illustration, use the `name` property, where you can find the list of all available illustrations.
+     *
+     * **Note:** By default the “BeforeSearch” illustration is loaded. To use other illustrations, make sure you import them in addition, for example:
+     *
+     * `import "sap/f/gen/ui5/webcomponents_fiori/dist/illustrations/NoData.js"`
+     *
+     * **Note:** Illustrations starting with the “Tnt” prefix are part of another illustration set. For example to use the “TntSuccess” illustration, add the following import::
+     *
+     * `import "sap/f/gen/ui5/webcomponents_fiori/dist/illustrations/tnt/Success.js"`
+     *
+     * ### Structure
+     * The IllustratedMessage consists of the following elements, which are displayed below each other in the following order:
+     *
+     * - Illustration
+     * - Title
+     * - Subtitle
+     * - Actions
+     *
+     * ### Usage
+     * `ui5-illustrated-message` is meant to be used inside container component, for example a `ui5-card`,
+     * a `ui5-dialog` or a `ui5-page`
+     *
+     * ### ES6 Module Import
+     *
+     * `import "sap/f/gen/ui5/webcomponents_fiori/dist/IllustratedMessage.js";`
+     *
+     * @extends sap.ui.core.webc.WebComponent
+     * @constructor
+     * @private
+     * @alias module:sap/f/gen/ui5/webcomponents_fiori/dist/IllustratedMessage
+     */
+
+    const WrapperClass = WebComponentBaseClass.extend(
+      "sap.f.gen.ui5.webcomponents_fiori.dist.IllustratedMessage",
+      {
+        metadata: {
+          tag: "ui5-illustrated-message-87689b96",
+
+          namespace: "sap.f.gen.ui5.webcomponents_fiori",
+
+          library: "sap.f",
+
+          designtime:
+            "sap/f/gen/ui5/webcomponents_fiori/designtime/IllustratedMessage.designtime",
+
+          interfaces: [],
+
+          defaultAggregation: "actions",
+
+          properties: {
+            /**
+             * Defines the illustration name that will be displayed in the component.
+             *
+             * Example:
+             *
+             * `name='BeforeSearch'`, `name='UnableToUpload'`, etc..
+             *
+             * **Note:** To use the TNT illustrations,
+             * you need to set the `tnt` or `Tnt` prefix in front of the icon's name.
+             *
+             * Example:
+             *
+             * `name='tnt/Avatar'` or `name='TntAvatar'`.
+             *
+             * **Note:** By default the `BeforeSearch` illustration is loaded.
+             * When using an illustration type, other than the default, it should be loaded in addition:
+             *
+             * `import "sap/f/gen/ui5/webcomponents_fiori/dist/illustrations/NoData.js";`
+             *
+             * For TNT illustrations:
+             *
+             * `import "sap/f/gen/ui5/webcomponents_fiori/dist/illustrations/tnt/SessionExpired.js";`
+             */
+            name: {
+              type: "string",
+              mapping: "property",
+              defaultValue: "BeforeSearch"
+            },
+            /**
+             * Determines which illustration breakpoint variant is used.
+             *
+             * As `IllustratedMessage` adapts itself around the `Illustration`, the other
+             * elements of the component are displayed differently on the different breakpoints/illustration designs.
+             * @type module:sap/f/gen/ui5/webcomponents_fiori.IllustrationMessageDesign
+             */
+            design: {
+              type: "sap.f.gen.ui5.webcomponents_fiori.IllustrationMessageDesign",
+              mapping: "property",
+              defaultValue: "Auto"
+            },
+            /**
+             * Defines the subtitle of the component.
+             *
+             * **Note:** Using this property, the default subtitle text of illustration will be overwritten.
+             *
+             * **Note:** Using `subtitle` slot, the default of this property will be overwritten.
+             */
+            subtitleText: { type: "string", mapping: "property" },
+            /**
+             * Defines the title of the component.
+             *
+             * **Note:** Using this property, the default title text of illustration will be overwritten.
+             */
+            titleText: { type: "string", mapping: "property" },
+            /**
+             * Defines whether the illustration is decorative.
+             *
+             * When set to `true`, the attributes `role="presentation"` and `aria-hidden="true"` are applied to the SVG element.
+             */
+            decorative: {
+              type: "boolean",
+              mapping: "property",
+              defaultValue: false
+            },
+            /**
+             * 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 title of the component.
+             *
+             * **Note:** Using this slot, the default title text of illustration and the value of `title` property will be overwritten.
+             * @type module:sap/ui/core/Control
+             */
+            title: {
+              type: "sap.ui.core.Control",
+              multiple: true,
+              slot: "title"
+            },
+            /**
+             * Defines the subtitle of the component.
+             *
+             * **Note:** Using this slot, the default subtitle text of illustration and the value of `subtitleText` property will be overwritten.
+             * @type module:sap/ui/core/Control
+             */
+            subtitle: {
+              type: "sap.ui.core.Control",
+              multiple: true,
+              slot: "subtitle"
+            },
+            /**
+             * Defines the component actions.
+             *
+             * **Note:** Not displayed when the `design` property is set to `Base`.
+             * @type module:sap/f/gen/ui5/webcomponents.IButton
+             */
+            actions: { type: "sap.f.gen.ui5.webcomponents.IButton", multiple: true }
+          },
+
+          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: {},
+
+          getters: [],
+
+          methods: []
+        }
+      }
+    );
+
+    return WrapperClass;
+  }
+);

package/src/sap/f/gen/ui5/webcomponents_fiori/dist/NotificationList.js

@@ -0,0 +1,204 @@
+/*!
+ * 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_fiori",
+    "sap/f/thirdparty/NotificationList"
+  ],
+  function (WebComponentBaseClass) {
+    "use strict";
+
+    /**
+     * @class
+     * ### Overview
+     * The `ui5-notification-list` web component represents
+     * a container for `ui5-li-notification-group` and `ui5-li-notification`.
+     *
+     * ### Keyboard Handling
+     *
+     * #### Basic Navigation
+     * The `ui5-notification-list` provides advanced keyboard handling.
+     * When a list is focused the user can use the following keyboard
+     * shortcuts in order to perform a navigation:
+     *
+     * - [Up] or [Left] - Navigates up the items
+     * - [Down] or [Right] - Navigates down the items
+     * - [Home] - Navigates to first item
+     * - [End] - Navigates to the last item
+     *
+     * #### Fast Navigation
+     * This component provides a build in fast navigation group which can be used via [F6] / [Shift] + [F6] / [Ctrl] + [Alt/Option] / [Down] or [Ctrl] + [Alt/Option] + [Up].
+     * In order to use this functionality, you need to import the following module:
+     * `import "sap/f/gen/ui5/webcomponents_base/dist/features/F6Navigation.js"`
+     *
+     * ### ES6 Module Import
+     *
+     * `import "sap/f/gen/ui5/webcomponents_fiori/dist/NotificationList.js";``
+     *
+     * @extends sap.ui.core.webc.WebComponent
+     * @constructor
+     * @private
+     * @alias module:sap/f/gen/ui5/webcomponents_fiori/dist/NotificationList
+     */
+
+    const WrapperClass = WebComponentBaseClass.extend(
+      "sap.f.gen.ui5.webcomponents_fiori.dist.NotificationList",
+      {
+        metadata: {
+          tag: "ui5-notification-list-87689b96",
+
+          namespace: "sap.f.gen.ui5.webcomponents_fiori",
+
+          library: "sap.f",
+
+          designtime:
+            "sap/f/gen/ui5/webcomponents_fiori/designtime/NotificationList.designtime",
+
+          interfaces: [],
+
+          defaultAggregation: "items",
+
+          properties: {
+            /**
+             * Defines the text that is displayed when the component contains no items.
+             */
+            noDataText: { type: "string", mapping: "property" },
+            /**
+             * 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 component.
+             * @type module:sap/f/gen/ui5/webcomponents_fiori/dist/NotificationListItemBase
+             */
+            items: {
+              type: "sap.f.gen.ui5.webcomponents_fiori.dist.NotificationListItemBase",
+              multiple: true
+            }
+          },
+
+          associations: {},
+
+          events: {
+            /**
+             * Fired when an item is clicked.
+             */
+            itemClick: {
+              allowPreventDefault: true,
+              enableEventBubbling: true,
+              parameters: {
+                /**
+                 * The clicked 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 clicked item."
+                }
+              }
+            },
+
+            /**
+             * Fired when the `Close` button of any item is clicked.
+             */
+            itemClose: {
+              allowPreventDefault: true,
+              enableEventBubbling: true,
+              parameters: {
+                /**
+                 * the item about to be closed.
+                 */
+                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 item about to be closed."
+                }
+              }
+            },
+
+            /**
+             * Fired when an item is toggled.
+             */
+            itemToggle: {
+              allowPreventDefault: true,
+              enableEventBubbling: true,
+              parameters: {
+                /**
+                 * the toggled 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 toggled item."
+                }
+              }
+            }
+          },
+
+          getters: [],
+
+          methods: []
+        }
+      }
+    );
+
+    return WrapperClass;
+  }
+);

package/src/sap/f/gen/ui5/webcomponents_fiori/dist/NotificationListGroupItem.js

@@ -0,0 +1,164 @@
+/*!
+ * 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/f/gen/ui5/webcomponents_fiori/dist/NotificationListItemBase",
+    "sap/f/gen/ui5/webcomponents_fiori",
+    "sap/f/thirdparty/NotificationListGroupItem"
+  ],
+  function (WebComponentBaseClass) {
+    "use strict";
+
+    /**
+     * @class
+     * ### Overview
+     * The `ui5-li-notification-group` is a special type of list item,
+     * that unlike others can group items within self, usually `ui5-li-notification` items.
+     *
+     * The component consists of:
+     *
+     * - `Toggle` button to expand and collapse the group
+     * - `TitleText` to entitle the group
+     * - Items of the group
+     *
+     * ### Usage
+     * The component should be used inside a `ui5-notification-list`.
+     *
+     * ### Keyboard Handling
+     * The `ui5-li-notification-group` provides advanced keyboard handling.
+     * This component provides fast navigation when the header is focused using the following keyboard shortcuts:
+     *
+     * - [Space] - toggles expand / collapse of the group
+     * - [Plus] - expands the group
+     * - [Minus] - collapses the group
+     * - [Right] - expands the group
+     * - [Left] - collapses the group
+     *
+     * ### ES6 Module Import
+     *
+     * `import "sap/f/gen/ui5/webcomponents_fiori/dist/NotificationListGroupItem.js";`
+     *
+     * @extends module:sap/f/gen/ui5/webcomponents_fiori/dist/NotificationListItemBase
+     * @constructor
+     * @private
+     * @alias module:sap/f/gen/ui5/webcomponents_fiori/dist/NotificationListGroupItem
+     */
+
+    const WrapperClass = WebComponentBaseClass.extend(
+      "sap.f.gen.ui5.webcomponents_fiori.dist.NotificationListGroupItem",
+      {
+        metadata: {
+          tag: "ui5-li-notification-group-87689b96",
+
+          namespace: "sap.f.gen.ui5.webcomponents_fiori",
+
+          library: "sap.f",
+
+          designtime:
+            "sap/f/gen/ui5/webcomponents_fiori/designtime/NotificationListGroupItem.designtime",
+
+          interfaces: [],
+
+          defaultAggregation: "items",
+
+          properties: {
+            /**
+             * Defines if the group is collapsed or expanded.
+             */
+            collapsed: {
+              type: "boolean",
+              mapping: "property",
+              defaultValue: false
+            },
+            /**
+             * Defines whether the component will have growing capability by pressing a `More` button.
+             * When button is pressed `load-more` event will be fired.
+             * @type module:sap/f/gen/ui5/webcomponents.NotificationListGrowingMode
+             */
+            growing: {
+              type: "sap.f.gen.ui5.webcomponents.NotificationListGrowingMode",
+              mapping: "property",
+              defaultValue: "None"
+            },
+            /**
+             * Defines the `titleText` of the item.
+             */
+            titleText: { type: "string", mapping: "property" },
+            /**
+             * Defines if the `notification` is new or has been already read.
+             *
+             * **Note:** if set to `false` the `titleText` has bold font,
+             * if set to true - it has a normal font.
+             */
+            read: { type: "boolean", mapping: "property", defaultValue: false },
+            /**
+             * Defines if a busy indicator would be displayed over the item.
+             */
+            loading: {
+              type: "boolean",
+              mapping: "property",
+              defaultValue: false
+            },
+            /**
+             * Defines the delay in milliseconds, after which the busy indicator will show up for this component.
+             */
+            loadingDelay: {
+              type: "float",
+              mapping: "property",
+              defaultValue: 1000
+            },
+            /**
+             * 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 `ui5-li-notification-group`,
+             * usually `ui5-li-notification` items.
+             * @type module:sap/f/gen/ui5/webcomponents_fiori/dist/NotificationListItem
+             */
+            items: {
+              type: "sap.f.gen.ui5.webcomponents_fiori.dist.NotificationListItem",
+              multiple: true
+            }
+          },
+
+          associations: {},
+
+          events: {
+            /**
+             * Fired when the `ui5-li-notification-group` is expanded/collapsed by user interaction.
+             */
+            toggle: {
+              enableEventBubbling: true,
+              parameters: {}
+            },
+
+            /**
+             * Fired when additional items are requested.
+             */
+            loadMore: {
+              enableEventBubbling: true,
+              parameters: {}
+            }
+          },
+
+          getters: [],
+
+          methods: []
+        }
+      }
+    );
+
+    return WrapperClass;
+  }
+);