@sapui5/sap.ushell 1.120.8 → 1.121.0

package/src/main/js/sap/ushell/ui/footerbar/SaveAsTile.controller.js

@@ -1,5 +1,8 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
-
+/**
+ * @fileoverview Save As Tile controller for the classical home page
+ * @deprecated As of version 1.120
+ */
 sap.ui.define([
     "sap/ui/core/mvc/Controller",
     "sap/base/Log",

package/src/main/js/sap/ushell/ui/footerbar/SaveAsTile.view.js

@@ -1,5 +1,8 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
-
+/**
+ * @fileoverview Save As Tile view for the classical home page
+ * @deprecated As of version 1.120
+ */
 sap.ui.define([
     "sap/m/FlexBox",
     "sap/m/GenericTile",

package/src/main/js/sap/ushell/ui/footerbar/SendAsEmailButton.js

@@ -22,18 +22,18 @@ sap.ui.define([
     var URLHelper = mobileLibrary.URLHelper;
 
     /**
-     * Constructor for a new ui/footerbar/SendAsEmailButton.
+     * @alias sap.ushell.ui.footerbar.SendAsEmailButton
+     * @class
+     * @classdesc Constructor for a new ui/footerbar/SendAsEmailButton.
+     * Add your documentation for the new ui/footerbar/SendAsEmailButton
      *
      * @param {string} [sId] id for the new control, generated automatically if no id is given
      * @param {object} [mSettings] initial settings for the new control
      *
-     * @class
-     * Add your documentation for the new ui/footerbar/SendAsEmailButton
      * @extends sap.m.Button
      *
-     * @public
-     * @name sap.ushell.ui.footerbar.SendAsEmailButton
-     * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
+     * @since 1.71.0
+     * @private
      */
     var SendAsEmailButton = Button.extend("sap.ushell.ui.footerbar.SendAsEmailButton", /** @lends sap.ushell.ui.footerbar.SendAsEmailButton.prototype */ {
         metadata: {
@@ -46,13 +46,6 @@ sap.ui.define([
         renderer: ButtonRenderer
     });
 
-    /**
-     * SendAsEmailButton
-     *
-     * @name sap.ushell.ui.footerbar.SendAsEmailButton
-     * @private
-     * @since 1.71.0
-     */
     SendAsEmailButton.prototype.init = function () {
         // call the parent sap.m.Button init method
         if (Button.prototype.init) {

package/src/main/js/sap/ushell/ui/launchpad/AccessibilityCustomData.js

@@ -1,9 +1,9 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
 sap.ui.define([
-    "sap/ui/core/CustomData",
-    "sap/ui/core/Configuration"
-], function (CustomData, Configuration) {
+    "sap/ui/core/ControlBehavior",
+    "sap/ui/core/CustomData"
+], function (ControlBehavior, CustomData) {
     "use strict";
 
     var AccessibilityCustomData = CustomData.extend("sap.ushell.ui.launchpad.AccessibilityCustomData", {
@@ -13,8 +13,7 @@ sap.ui.define([
     });
 
     AccessibilityCustomData.prototype._checkWriteToDom = function () {
-        var bIsAccessibilityOn = Configuration.getAccessibility();
-        if (!bIsAccessibilityOn) {
+        if (!ControlBehavior.isAccessibilityEnabled()) {
             return null;
         }
 

package/src/main/js/sap/ushell/ui/launchpad/ActionItem.js

@@ -16,15 +16,16 @@ sap.ui.define([
     var ButtonType = mobileLibrary.ButtonType;
 
     /**
-     * Constructor for a new ui/launchpad/ActionItem.
+     * @alias sap.ushell.ui.launchpad.ActionItem
+     * @class
+     * @classdesc Constructor for a new ui/launchpad/ActionItem.
      *
      * @param {string} [sId] id for the new control, generated automatically if no id is given
      * @param {object} [mSettings] initial settings for the new control
-     * @class
+     *
      * @extends sap.m.Button
+     *
      * @public
-     * @name sap.ushell.ui.launchpad.ActionItem
-     * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
      */
     var ActionItem = Button.extend("sap.ushell.ui.launchpad.ActionItem", /** @lends sap.ushell.ui.launchpad.ActionItem.prototype */ {
         metadata: {

package/src/main/js/sap/ushell/ui/launchpad/AnchorItem.js

@@ -1,6 +1,9 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
-// Provides control sap.ushell.ui.launchpad.AnchorItem.
+/**
+ * @fileoverview Provides control sap.ushell.ui.launchpad.AnchorItem.
+ * @deprecated As of version 1.120
+ */
 sap.ui.define([
     "sap/ui/core/Control",
     "sap/ushell/ui/launchpad/AnchorItemRenderer",
@@ -12,18 +15,17 @@ sap.ui.define([
     "use strict";
 
     /**
-     * Constructor for a new ui/launchpad/AnchorItem.
+     * @alias sap.ushell.ui.launchpad.AnchorItem
+     * @class
+     * @classdesc Constructor for a new ui/launchpad/AnchorItem.
+     * Add your documentation for the new ui/launchpad/AnchorItem
      *
      * @param {string} [sId] id for the new anchorItem, generated automatically if no id is given
      * @param {object} [mSettings] initial settings for the new anchorItem
      *
-     * @class
-     * Add your documentation for the new ui/launchpad/AnchorItem
      * @extends sap.ui.core.Control
      *
      * @private
-     * @name sap.ushell.ui.launchpad.AnchorItem
-     * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
      */
     var AnchorItem = Control.extend("sap.ushell.ui.launchpad.AnchorItem", /** @lends sap.ushell.ui.launchpad.AnchorItem.prototype */ {
         metadata: {
@@ -112,11 +114,6 @@ sap.ui.define([
         renderer: AnchorItemRenderer
     });
 
-    /**
-     * @name sap.ushell.ui.launchpad.AnchorItem
-     *
-     * @private
-     */
     AnchorItem.prototype.init = function () {
         this.addDelegate({
             onAfterRendering: this.fireAfterRendering.bind(this),

package/src/main/js/sap/ushell/ui/launchpad/AnchorItemRenderer.js

@@ -1,10 +1,14 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
-
+/**
+ * @fileoverview Renderer for sap.ushell.ui.launchpad.AnchorItem.
+ * @deprecated As of version 1.120
+ */
 sap.ui.define(function () {
     "use strict";
 
     /**
-     * @name AnchorItem renderer.
+     * AnchorItem renderer.
+     * @namespace
      * @static
      * @private
      */

package/src/main/js/sap/ushell/ui/launchpad/AnchorNavigationBar.js

@@ -1,13 +1,16 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
-// Provides control sap.ushell.ui.launchpad.AnchorNavigationBar.
+/**
+ * @fileoverview Provides control sap.ushell.ui.launchpad.AnchorNavigationBar.
+ * @deprecated As of version 1.120
+ */
 sap.ui.define([
     "./AnchorNavigationBarRenderer",
+    "sap/base/i18n/Localization",
     "sap/base/util/isEmptyObject",
     "sap/m/Bar",
     "sap/m/Button",
-    "sap/ui/core/Configuration",
-    "sap/ui/core/Core",
+    "sap/ui/core/Element",
     "sap/ui/core/ResizeHandler",
     "sap/ui/Device",
     "sap/ui/thirdparty/jquery",
@@ -15,11 +18,11 @@ sap.ui.define([
     "sap/ushell/resources"
 ], function (
     AnchorNavigationBarRenderer,
+    Localization,
     isEmptyObject,
     Bar,
     Button,
-    Configuration,
-    Core,
+    Element,
     ResizeHandler,
     Device,
     jQuery,
@@ -29,18 +32,19 @@ sap.ui.define([
     "use strict";
 
     /**
-     * Constructor for a new ui/launchpad/AnchorNavigationBar.
+     * @alias sap.ushell.ui.launchpad.AnchorNavigationBar
+     * @class
+     * @classdesc Constructor for a new ui/launchpad/AnchorNavigationBar.
+     * Add your documentation for the new ui/launchpad/AnchorNavigationBar
      *
      * @param {string} [sId] id for the new control, generated automatically if no id is given
      * @param {object} [mSettings] initial settings for the new control
-     * @class Add your documentation for the newui/launchpad/AnchorNavigationBar
+     *
      * @extends sap.m.Bar
-     * @lends sap.ushell.ui.launchpad.AnchorNavigationBar.prototype
-     * @public
-     * @name sap.ushell.ui.launchpad.AnchorNavigationBar
-     * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
+     *
+     * @private
      */
-    var AnchorNavigationBar = Bar.extend("sap.ushell.ui.launchpad.AnchorNavigationBar", {
+    var AnchorNavigationBar = Bar.extend("sap.ushell.ui.launchpad.AnchorNavigationBar", /** @lends sap.ushell.ui.launchpad.AnchorNavigationBar.prototype */{
         metadata: {
             library: "sap.ushell",
             properties: {
@@ -60,13 +64,9 @@ sap.ui.define([
         renderer: AnchorNavigationBarRenderer
     });
 
-    /**
-     * @name sap.ushell.ui.launchpad.AnchorNavigationBar
-     * @private
-     */
     AnchorNavigationBar.prototype.init = function () {
         this.bGroupWasPressed = false;
-        this.bIsRtl = Configuration.getRTL();
+        this.bIsRtl = Localization.getRTL();
         this._bIsRenderedCompletely = false;
 
         this.fnNavigationBarItemsVisibility = this.setNavigationBarItemsVisibility.bind(this);
@@ -132,6 +132,9 @@ sap.ui.define([
             this.anchorItems[this.getSelectedItemIndex()].setIsGroupVisible(true);
         } else {
             setTimeout(function () {
+                if (this.isDestroyed()) {
+                    return;
+                }
                 this.setNavigationBarItemsVisibility();
             }.bind(this), 200);
         }
@@ -353,7 +356,7 @@ sap.ui.define([
                     beforeOpen: function () {
                         //place the popover under the overflow button
                         var jqOverflowBtn = jQuery(".sapUshellAnchorItemOverFlow"),
-                            bIsRtl = Configuration.getRTL(),
+                            bIsRtl = Localization.getRTL(),
                             offset = bIsRtl ? -1 * jqOverflowBtn.outerWidth() : jqOverflowBtn.outerWidth();
                         this.setOffsetX(offset);
                     },
@@ -391,7 +394,7 @@ sap.ui.define([
                     filters: [visibleGroupFilter]
                 });
                 var sSelectedGroupId = jQuery(".sapUshellAnchorItemSelected").attr("id");
-                var oSelectedGroup = Core.byId(sSelectedGroupId);
+                var oSelectedGroup = Element.getElementById(sSelectedGroupId);
                 this.oList.getItems().forEach(function (oItem) {
                     if (oSelectedGroup.mProperties.groupId === oItem.mProperties.groupId) {
                         oItem.addStyleClass("sapUshellAnchorPopoverItemSelected");

package/src/main/js/sap/ushell/ui/launchpad/AnchorNavigationBarRenderer.js

@@ -1,5 +1,9 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
+/**
+ * @fileoverview Render sap.ushell.ui.launchpad.AnchorNavigationBar.
+ * @deprecated As of version 1.120
+ */
 sap.ui.define([
     "sap/ushell/resources",
     "sap/ui/core/library"
@@ -10,7 +14,8 @@ sap.ui.define([
     var AccessibleLandmarkRole = coreLibrary.AccessibleLandmarkRole;
 
     /**
-     * @name AnchorNavigationBar renderer.
+     * AnchorNavigationBar renderer.
+     * @namespace
      * @static
      * @private
      */

package/src/main/js/sap/ushell/ui/launchpad/CatalogEntryContainer.js

@@ -1,9 +1,5 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
-/**
- * @name sap.ushell.ui.launchpad.CatalogContainer
- * @private
- */
 sap.ui.define([
     "sap/base/Log",
     "sap/ui/core/Control",
@@ -19,7 +15,15 @@ sap.ui.define([
 ) {
     "use strict";
 
-    var CatalogEntryContainer = Control.extend("sap.ushell.ui.launchpad.CatalogEntryContainer", {
+    /**
+     * @alias sap.ushell.ui.launchpad.CatalogEntryContainer
+     * @class
+     *
+     * @extends sap.ui.core.Control
+     *
+     * @private
+     */
+    var CatalogEntryContainer = Control.extend("sap.ushell.ui.launchpad.CatalogEntryContainer", /** @lends sap.ushell.ui.launchpad.CatalogEntryContainer.prototype */{
         metadata: {
             library: "sap.ushell",
             properties: {
@@ -163,7 +167,7 @@ sap.ui.define([
                 }
             }
 
-            sap.ushell.Container.getServiceAsync("LaunchPage").then(function (oLaunchpageService) {
+            sap.ushell.Container.getServiceAsync("FlpLaunchPage").then(function (oLaunchpageService) {
                 oLaunchpageService.getCatalogTileViewControl(elementToDisplay.getProperty("src")).done(
                     function (catalogTielView) {
                         elementToDisplay.getProperty("content")[0] = catalogTielView;

package/src/main/js/sap/ushell/ui/launchpad/CatalogsContainer.js

@@ -1,9 +1,5 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
-/**
- * @name sap.ushell.ui.launchpad.CatalogsContainer
- * @private
- */
 sap.ui.define([
     "sap/base/Log",
     "sap/ui/core/Control",
@@ -19,7 +15,15 @@ sap.ui.define([
 ) {
     "use strict";
 
-    var CatalogsContainer = Control.extend("sap.ushell.ui.launchpad.CatalogsContainer", {
+    /**
+     * @alias sap.ushell.ui.launchpad.CatalogsContainer
+     * @class
+     *
+     * @extends sap.ui.core.Control
+     *
+     * @private
+     */
+    var CatalogsContainer = Control.extend("sap.ushell.ui.launchpad.CatalogsContainer", /** @lends sap.ushell.ui.launchpad.CatalogsContainer.prototype */{
         metadata: {
             library: "sap.ushell",
             properties: {

package/src/main/js/sap/ushell/ui/launchpad/DashboardGroupsContainer.js

@@ -1,5 +1,8 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
-
+/**
+ * @fileoverview Dashboard groups container
+ * @deprecated As ov version 1.120, since it's used in classical FLP only
+ */
 sap.ui.define([
     "sap/ui/base/ManagedObject",
     "sap/ui/core/Control",
@@ -26,16 +29,17 @@ sap.ui.define([
     "use strict";
 
     /**
-     * Constructor for "sap.ushell.ui.launchpad.DashboardGroupsContainer".
+     * @alias sap.ushell.ui.launchpad.DashboardGroupsContainer
+     * @class
+     * @classdesc Constructor for "sap.ushell.ui.launchpad.DashboardGroupsContainer".
      *
      * @param {string} [sId] ID for the new control, generated automatically if no id is given.
      * @param {object} [mSettings] Initial settings for the new control.
-     * @class
-     * @alias sap.ushell.ui.launchpad.DashboardGroupsContainer
+     *
      * @extends sap.ui.core.Control
+     *
      * @public
      * @deprecated since 1.120
-     * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
      */
     var DashboardGroupsContainer = Control.extend("sap.ushell.ui.launchpad.DashboardGroupsContainer", /** @lends sap.ushell.ui.launchpad.DashboardGroupsContainer.prototype */ {
         metadata: {

package/src/main/js/sap/ushell/ui/launchpad/DashboardGroupsContainerRenderer.js

@@ -1,11 +1,16 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
+/**
+ * @fileoverview Dashboard groups container renderer
+ * @deprecated As ov version 1.120, since it's used in classical FLP only
+ */
 sap.ui.define([
     "sap/ushell/utils"
 ], function (utils) {
     "use strict";
 
     /**
-     * @name DashboardGroupsContainer renderer.
+     * DashboardGroupsContainer renderer.
+     * @namespace
      * @static
      * @private
      */

package/src/main/js/sap/ushell/ui/launchpad/ExtendedChangeDetection.js

@@ -7,7 +7,7 @@
  * of recreating them. Items which get removed from the aggregation get destroyed and items which get added to the
  * aggregation get created.
  *
- * @version 1.120.8
+ * @version 1.121.0
  */
 sap.ui.define([
     "sap/ui/base/ManagedObject",

package/src/main/js/sap/ushell/ui/launchpad/GroupHeaderActions.js

@@ -21,15 +21,17 @@ sap.ui.define([
     var PlacementType = mobileLibrary.PlacementType;
 
     /**
-     * Constructor for a new ui/launchpad/GroupHeaderActions.
+     * @alias sap.ushell.ui.launchpad.GroupHeaderActions
+     * @class
+     * @classdesc Constructor for a new ui/launchpad/GroupHeaderActions.
+     * Add your documentation for the new ui/launchpad/GroupHeaderActions
      *
      * @param {string} [sId] id for the new control, generated automatically if no id is given
      * @param {object} [mSettings] initial settings for the new control
-     * @class Add your documentation for the new ui/launchpad/GroupHeaderActions
+     *
      * @extends sap.ui.core.Control
-     * @public
-     * @name sap.ushell.ui.launchpad.GroupHeaderActions
-     * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
+     *
+     * @private
      */
     var GroupHeaderActions = Control.extend("sap.ushell.ui.launchpad.GroupHeaderActions", /** @lends sap.ushell.ui.launchpad.GroupHeaderActions.prototype */ {
         metadata: {
@@ -77,10 +79,6 @@ sap.ui.define([
         }
     });
 
-    /**
-     * @name sap.ushell.ui.launchpad.GroupHeaderActions
-     * @private
-     */
     GroupHeaderActions.prototype.exit = function () {
         if (this._oOverflowButton) {
             this._oOverflowButton.destroy();

package/src/main/js/sap/ushell/ui/launchpad/GroupListItem.js

@@ -1,6 +1,4 @@
-/*!
- * Copyright (c) 2009-2023 SAP SE, All Rights Reserved
- */
+// Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
 // Provides control sap.ushell.ui.launchpad.GroupListItem.
 sap.ui.define([
@@ -16,73 +14,67 @@ sap.ui.define([
 ) {
     "use strict";
 
-/**
- * Constructor for a new ui/launchpad/GroupListItem.
- *
- * @param {string} [sId] id for the new control, generated automatically if no id is given
- * @param {object} [mSettings] initial settings for the new control
- *
- * @class
- * Add your documentation for the new ui/launchpad/GroupListItem
- * @extends sap.m.ListItemBase
- *
- * @public
- * @name sap.ushell.ui.launchpad.GroupListItem
- * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
- */
-var GroupListItem = ListItemBase.extend("sap.ushell.ui.launchpad.GroupListItem", /** @lends sap.ushell.ui.launchpad.GroupListItem.prototype */ {
-    metadata: {
-        library: "sap.ushell",
-        properties: {
-
-            /**
-             */
-            title: { type: "string", group: "Misc", defaultValue: null },
-
-            /**
-             */
-            defaultGroup: { type: "boolean", group: "Misc", defaultValue: false },
-
-            /**
-             */
-            show: { type: "boolean", group: "Misc", defaultValue: true },
-
-            /**
-             */
-            groupId: { type: "string", group: "Misc", defaultValue: null },
-
-            /**
-             */
-            index: { type: "int", group: "Misc", defaultValue: null },
-
-            /**
-             */
-            numberOfTiles: { type: "int", group: "Misc", defaultValue: 0 },
-
-            /**
-             */
-            isGroupVisible: { type: "boolean", group: "Misc", defaultValue: true }
+    /**
+     * @alias sap.ushell.ui.launchpad.GroupListItem
+     * @class
+     * @classdesc Constructor for a new ui/launchpad/GroupListItem.
+     * Add your documentation for the new ui/launchpad/GroupListItem
+     *
+     * @param {string} [sId] id for the new control, generated automatically if no id is given
+     * @param {object} [mSettings] initial settings for the new control
+     *
+     * @extends sap.m.ListItemBase
+     *
+     * @private
+     */
+    var GroupListItem = ListItemBase.extend("sap.ushell.ui.launchpad.GroupListItem", /** @lends sap.ushell.ui.launchpad.GroupListItem.prototype */ {
+        metadata: {
+            library: "sap.ushell",
+            properties: {
+
+                /**
+                 */
+                title: { type: "string", group: "Misc", defaultValue: null },
+
+                /**
+                 */
+                defaultGroup: { type: "boolean", group: "Misc", defaultValue: false },
+
+                /**
+                 */
+                show: { type: "boolean", group: "Misc", defaultValue: true },
+
+                /**
+                 */
+                groupId: { type: "string", group: "Misc", defaultValue: null },
+
+                /**
+                 */
+                index: { type: "int", group: "Misc", defaultValue: null },
+
+                /**
+                 */
+                numberOfTiles: { type: "int", group: "Misc", defaultValue: 0 },
+
+                /**
+                 */
+                isGroupVisible: { type: "boolean", group: "Misc", defaultValue: true }
+            },
+            events: {
+
+                /**
+                 */
+                press: {},
+
+                /**
+                 */
+                afterRendering: {}
+            }
         },
-        events: {
 
-            /**
-             */
-            press: {},
+        renderer: GroupListItemRenderer
+    });
 
-            /**
-             */
-            afterRendering: {}
-        }
-    },
-
-    renderer: GroupListItemRenderer
-});
-
-/**
- * @name sap.ushell.ui.launchpad.GroupListItem
- *
- * @private
- */
     GroupListItem.prototype.exit = function () {
         ListItemBase.prototype.exit.apply(this, arguments);
     };

package/src/main/js/sap/ushell/ui/launchpad/GroupListItemRenderer.js

@@ -1,8 +1,7 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
 /**
- * @class GroupListItem renderer.
- * @static
+ * GroupListItem renderer.
  * @private
  */
 sap.ui.define([
@@ -12,7 +11,8 @@ sap.ui.define([
     "use strict";
 
     /**
-     * @class GroupListItem renderer.
+     * GroupListItem renderer.
+     * @namespace
      * @static
      */
     var GroupListItemRenderer = Renderer.extend(ListItemBaseRenderer);
@@ -30,24 +30,24 @@ sap.ui.define([
      * @param {sap.ui.core.RenderManager} oRm the RenderManager that can be used for writing to the render output buffer
      * @param {sap.ui.core.Control} oLI an object representation of the list item control that should be rendered
      */
-    GroupListItemRenderer.renderLIContent = function (rm, oLI) {
-        rm.openStart("div", oLI);
-        rm.class("sapMSLIDiv");
-        rm.class("sapMSLITitleDiv");
+    GroupListItemRenderer.renderLIContent = function (oRm, oLI) {
+        oRm.openStart("div", oLI);
+        oRm.class("sapMSLIDiv");
+        oRm.class("sapMSLITitleDiv");
 
         if (!oLI.getVisible()) {
-            rm.style("display", "none");
+            oRm.style("display", "none");
         }
-        rm.openEnd();
+        oRm.openEnd();
 
         // List item text (also written when no title for keeping the space)
-        rm.openStart("div", oLI);
-        rm.class("sapMSLITitleOnly");
-        rm.openEnd();
-        rm.text(oLI.getTitle());
-        rm.close("div");
+        oRm.openStart("div", oLI);
+        oRm.class("sapMSLITitleOnly");
+        oRm.openEnd();
+        oRm.text(oLI.getTitle());
+        oRm.close("div");
 
-        rm.close("div");
+        oRm.close("div");
     };
 
     return GroupListItemRenderer;