@sapui5/sap.ushell 1.120.7 → 1.121.0

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

@@ -27,18 +27,18 @@ sap.ui.define([
     "use strict";
 
     /**
-     * Constructor for a new ui/launchpad/LinkTileWrapper.
+     * @alias sap.ushell.ui.launchpad.LinkTileWrapper
+     * @class
+     * @classdesc Constructor for a new ui/launchpad/LinkTileWrapper.
      * A link tile to be displayed in the tile container. This control acts as container for specialized tile implementations.
      *
      * @param {string} [sId] id for the new control, generated automatically if no id is given
      * @param {object} [mSettings] initial settings for the new control
      *
-     * @alias sap.ushell.ui.launchpad.LinkTileWrapper
-     * @class
      * @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 LinkTileWrapper = Control.extend("sap.ushell.ui.launchpad.LinkTileWrapper", /** @lends sap.ushell.ui.launchpad.LinkTileWrapper.prototype */ {
         metadata: {

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

@@ -20,7 +20,8 @@ sap.ui.define([
     var LoadState = mobileLibrary.LoadState;
 
     /**
-     * @name LinkTileWrapper renderer.
+     * LinkTileWrapper renderer.
+     * @namespace
      * @static
      * @private
      */

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

@@ -23,15 +23,17 @@ sap.ui.define([
     "use strict";
 
     /**
-     * Constructor for a new ui/launchpad/LoadingDialog.
+     * @alias sap.ushell.ui.launchpad.LoadingDialog
+     * @class
+     * @classdesc Constructor for a new ui/launchpad/LoadingDialog.
+     * Displays a loading dialog with an indicator that an app is loading
      *
      * @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 Displays a loading dialog with an indicator that an app is loading
+     *
      * @extends sap.ui.core.Control
-     * @public
-     * @name sap.ushell.ui.launchpad.LoadingDialog
-     * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
+     *
+     * @private
      */
     var LoadingDialog = Control.extend("sap.ushell.ui.launchpad.LoadingDialog", /** @lends sap.ushell.ui.launchpad.LoadingDialog.prototype */ {
         metadata: {
@@ -49,12 +51,6 @@ sap.ui.define([
         renderer: LoadingDialogRenderer
     });
 
-    /**
-     * LoadingDialog
-     *
-     * @name sap.ushell.ui.launchpad.LoadingDialog
-     * @private
-     */
     LoadingDialog.prototype.init = function () {
         this._oPopup = new Popup();
         this._oPopup.restoreFocus = false;

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

@@ -4,8 +4,8 @@ sap.ui.define([], function () {
     "use strict";
 
     /**
-     * @class sap.ushell.ui.launchpad.LoadingDialogRenderer
-     * @static
+     * @alias sap.ushell.ui.launchpad.LoadingDialogRenderer
+     * @namespace
      * @private
      */
     var LoadingDialogRenderer = {

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

@@ -32,28 +32,24 @@ sap.ui.define([
     // shortcut for sap.ui.core.TextAlign
     var TextAlign = coreLibrary.TextAlign;
 
-    // shortcut for InvisiblesMessageMode
+    // shortcut for InvisibleMessageMode
     var InvisibleMessageMode = coreLibrary.InvisibleMessageMode;
 
     // shortcut for sap.ushell.DisplayFormat
     var DisplayFormat = ushellLibrary.DisplayFormat;
 
     /**
-     * Constructor for a new Page.
+     * @alias sap.ushell.ui.launchpad.Page
+     * @class
+     * @classdesc Constructor for a new Page.
+     * The Page represents a collection of sections.
      *
      * @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
-     * The Page represents a collection of sections.
      * @extends sap.ui.core.Control
      *
-     * @author SAP SE
-     * @version 1.120.7
-     *
      * @private
-     * @alias sap.ushell.ui.launchpad.Page
-     * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
      */
     var Page = Control.extend("sap.ushell.ui.launchpad.Page", /** @lends sap.ushell.ui.launchpad.Page.prototype */ {
         metadata: {
@@ -608,9 +604,9 @@ sap.ui.define([
         }
 
         var oSection, aItems;
-        /*Hint for future debugging:
-        The GridContainer currently has its own logic regarding HOME/END navigation.
-        Therefore the HOME/END navigation happens per area and not per section.*/
+        // Hint for future debugging:
+        // The GridContainer currently has its own logic regarding HOME/END navigation.
+        // Therefore the HOME/END navigation happens per area and not per section.
 
         var bLast = false;
         if (oEvent.type === "saphome") {

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

@@ -4,8 +4,8 @@ sap.ui.define([], function () {
     "use strict";
 
     /**
-     * @name Page renderer.
      * @namespace
+     * @description Page renderer.
      */
     var PageRenderer = {
         apiVersion: 2
@@ -32,6 +32,7 @@ sap.ui.define([], function () {
         rm.openStart("div", page);
         rm.class("sapUshellPage");
         rm.class("sapContrastPlus");
+        rm.attr("role", "region");
         rm.attr("aria-label", sTitle);
         rm.attr("data-sap-ui-customfastnavgroup", "true");
         if (sDataHelpId) {

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

@@ -17,18 +17,17 @@ sap.ui.define([
     "use strict";
 
     /**
-     * Constructor for a new ui/launchpad/PlusTile.
+     * @alias sap.ushell.ui.launchpad.PlusTile
+     * @class
+     * @classdesc Constructor for a new ui/launchpad/PlusTile.
+     * A specialized tile showing a plus icon.
      *
      * @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
-     * A specialized tile showing a plus icon.
      * @extends sap.ushell.ui.launchpad.Tile
      *
-     * @public
-     * @name sap.ushell.ui.launchpad.PlusTile
-     * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
+     * @private
      */
     var PlusTile = Tile.extend("sap.ushell.ui.launchpad.PlusTile", /** @lends sap.ushell.ui.launchpad.PlusTile.prototype */ {
         metadata: {
@@ -52,11 +51,6 @@ sap.ui.define([
         renderer: PlusTileRenderer
     });
 
-    /**
-     * @name sap.ushell.ui.launchpad.PlusTile
-     *
-     * @private
-     */
     PlusTile.prototype.init = function () {
         this.oIcon = new Icon({
             src: "sap-icon://add",

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

@@ -9,7 +9,7 @@ sap.ui.define([
     /**
      * PlusTile renderer.
      *
-     * @class
+     * @namespace
      * @static
      * @private
      */

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

@@ -3,7 +3,7 @@
 /**
  * @fileOverview Provides control sap.ushell.ui.launchpad.Section
  *
- * @version 1.120.7
+ * @version 1.121.0
  */
 sap.ui.define([
     "sap/base/Log",
@@ -22,8 +22,8 @@ sap.ui.define([
     "sap/m/OverflowToolbar",
     "sap/m/OverflowToolbarLayoutData",
     "sap/ui/core/Control",
-    "sap/ui/core/Core",
     "sap/ui/core/CustomData",
+    "sap/ui/core/Lib",
     "sap/ui/core/dnd/DragInfo",
     "sap/ui/core/dnd/DropInfo",
     "sap/ui/core/InvisibleMessage",
@@ -53,8 +53,8 @@ sap.ui.define([
     OverflowToolbar,
     OverflowToolbarLayoutData,
     Control,
-    Core,
     CustomData,
+    Library,
     DragInfo,
     DropInfo,
     InvisibleMessage,
@@ -150,21 +150,17 @@ sap.ui.define([
     }
 
     /**
-     * Constructor for a new Section.
+     * @alias sap.ushell.ui.launchpad.Section
+     * @class
+     * @classdesc Constructor for a new Section.
+     * The Section represents a structured collection of visualizations.
      *
      * @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
-     * The Section represents a structured collection of visualizations.
-     * @extends sap.ui.core.XMLComposite
-     *
-     * @author SAP SE
-     * @version 1.120.7
+     * @extends sap.ui.core.Control
      *
      * @private
-     * @alias sap.ushell.ui.launchpad.Section
-     * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
      */
     var Section = Control.extend("sap.ushell.ui.launchpad.Section", /** @lends sap.ushell.ui.launchpad.Section.prototype */ {
         metadata: {
@@ -178,6 +174,11 @@ sap.ui.define([
                  */
                 dataHelpId: { type: "string", group: "Misc", defaultValue: "" },
 
+                /**
+                 * Aria label for screen reader support. Will be rendered into the HTML element.
+                 */
+                ariaLabel: { type: "string", group: "Misc", defaultValue: "" },
+
                 /**
                  * Specifies if the section is a default section.
                  * A default section contains tiles that are added to a page using the App Finder.
@@ -844,7 +845,7 @@ sap.ui.define([
                     press: function () {
                         var bValue = !this.getShowSection();
                         // temporary work around until sap.m.Button announces a label change to the user.
-                        var oMResources = Core.getLibraryResourceBundle("sap.m");
+                        var oMResources = Library.getResourceBundleFor("sap.m");
                         this._oInvisibleMessageInstance.announce([
                             resources.i18n.getText(bValue ? "Section.nowBeingShown" : "Section.nowBeingHidden"),
                             resources.i18n.getText("Section.ButtonLabelChanged"),
@@ -1326,19 +1327,6 @@ sap.ui.define([
         }
     };
 
-    /**
-     * Generates the localized aria label string for the section.
-     *
-     * @returns {string} the localized aria label containing the title of the section.
-     */
-    Section.prototype.getAriaLabel = function () {
-        var sTitle = this.getTitle() && this.getTitle().trim();
-        if (sTitle) {
-            return resources.i18n.getText("Section.Description", [sTitle]);
-        }
-        return resources.i18n.getText("Section.Description.EmptySectionTitle");
-    };
-
     /**
      * @returns {sap.m.Input} the title input from the section header.
      *

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

@@ -4,7 +4,8 @@ sap.ui.define([], function () {
     "use strict";
 
     /**
-     * @name Section renderer.
+     * Section renderer.
+     * @namespace
      * @static
      * @private
      */
@@ -48,7 +49,7 @@ sap.ui.define([], function () {
         if (sHelpId) {
             rm.attr("data-help-id", sHelpId);
         }
-        rm.attr("role", "group");
+        rm.attr("role", "region");
         rm.attr("aria-label", section.getAriaLabel());
         rm.openEnd(); // div - tag
 

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

@@ -4,7 +4,7 @@ sap.ui.define([
     "sap/m/Text",
     "sap/ui/base/ManagedObject",
     "sap/ui/core/Control",
-    "sap/ui/core/Core",
+    "sap/ui/core/EventBus",
     "sap/ui/core/Icon",
     "sap/ui/thirdparty/jquery",
     "sap/ushell/library", // css style dependency
@@ -16,7 +16,7 @@ sap.ui.define([
     Text,
     ManagedObject,
     Control,
-    Core,
+    EventBus,
     Icon,
     jQuery,
     ushellLibrary,
@@ -27,15 +27,17 @@ sap.ui.define([
     "use strict";
 
     /**
-     * Constructor for a new ui/launchpad/Tile.
+     * @alias sap.ushell.ui.launchpad.Tile
+     * @class
+     * @classdesc Constructor for a new ui/launchpad/Tile.
+     * A tile to be displayed in the tile container. This tile acts as container for specialized tile implementations.
      *
      * @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 A tile to be displayed in the tile container. This tile acts as container for specialized tile implementations.
+     *
      * @extends sap.ui.core.Control
-     * @public
-     * @name sap.ushell.ui.launchpad.Tile
-     * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
+     *
+     * @private
      */
     var Tile = Control.extend("sap.ushell.ui.launchpad.Tile", /** @lends sap.ushell.ui.launchpad.Tile.prototype */ {
         metadata: {
@@ -145,11 +147,6 @@ sap.ui.define([
         renderer: TileRenderer
     });
 
-    /**
-     * @name sap.ushell.ui.launchpad.Tile
-     * @private
-     */
-
     Tile.prototype.init = function () {
         this.addDelegate({
             onkeyup: function (oEvent) {
@@ -465,7 +462,7 @@ sap.ui.define([
                         this.fireShowActions();
                         this.addStyleClass("showTileActionsIcon");
 
-                        var oEventBus = Core.getEventBus(),
+                        var oEventBus = EventBus.getInstance(),
                             eventFunction = function (name, name2, tile) {
                                 tile.removeStyleClass("showTileActionsIcon");
                                 oEventBus.unsubscribe("dashboard", "actionSheetClose", eventFunction);

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

@@ -8,7 +8,7 @@ sap.ui.define([
     "sap/m/Text",
     "sap/ui/base/ManagedObject",
     "sap/ui/core/Control",
-    "sap/ui/core/Core",
+    "sap/ui/core/EventBus",
     "sap/ui/core/Icon",
     "sap/ushell/override",
     "sap/ushell/library", // css style dependency
@@ -23,7 +23,7 @@ sap.ui.define([
     Text,
     ManagedObject,
     Control,
-    Core,
+    EventBus,
     Icon,
     override,
     ushellLibrary,
@@ -37,14 +37,17 @@ sap.ui.define([
     var HeaderLevel = MobileLibrary.HeaderLevel;
 
     /**
-     * Constructor for a new ui/launchpad/TileContainer.
+     * @alias sap.ushell.ui.launchpad.TileContainer
+     * @class
+     * @classdesc Constructor for a new ui/launchpad/TileContainer.
+     * A container that arranges Tile controls.
      *
      * @param {string} [sId] The ID for the new control, generated automatically if no ID is given
      * @param {object} [mSettings] The initial settings for the new control
-     * @class A container that arranges Tile controls.
+     *
      * @extends sap.ui.core.Control
-     * @name sap.ushell.ui.launchpad.TileContainer
-     * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
+     *
+     * @private
      */
     var TileContainer = Control.extend("sap.ushell.ui.launchpad.TileContainer", /** @lends sap.ushell.ui.launchpad.TileContainer.prototype */ {
         metadata: {
@@ -140,10 +143,6 @@ sap.ui.define([
         renderer: TileContainerRenderer
     });
 
-    /**
-     * @name sap.ushell.ui.launchpad.TileContainer
-     * @private
-     */
     TileContainer.prototype.init = function () {
         this.bIsFirstTitleChange = true;
 
@@ -263,7 +262,7 @@ sap.ui.define([
 
         this._resizeCards(aCards);
 
-        Core.getEventBus().publish("launchpad", "GroupHeaderVisibility");
+        EventBus.getInstance().publish("launchpad", "GroupHeaderVisibility");
 
         this.fireAfterRendering();
     };

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

@@ -18,7 +18,8 @@ sap.ui.define([
     "use strict";
 
     /**
-     * @name TileContainer renderer.
+     * TileContainer renderer.
+     * @namespace
      * @static
      * @private
      */
@@ -140,7 +141,7 @@ sap.ui.define([
                 oRm.openStart(sTagName, tileContainer.getId() + "-titleText");
                 oRm.class("sapUshellContainerTitle");
                 oRm.attr("title", tileContainer.getHeaderText());
-                oRm.attr("data-role", "group");
+                oRm.attr("role", "region");
                 if (tileContainer.getTileActionModeActive() && !tileContainer.getIsGroupLocked() && !tileContainer.getDefaultGroup()) {
                     oRm.attr("tabindex", "0");
                 }

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

@@ -7,7 +7,8 @@ sap.ui.define([
     "use strict";
 
     /**
-     * @name Tile renderer.
+     * Tile renderer.
+     * @namespace
      * @static
      * @private
      */

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

@@ -6,38 +6,30 @@
  * @see sap.ushell.ui.launchpad.LinkTileWrapper
  */
 sap.ui.define([
-    "sap/ui/core/Control",
-    "sap/ui/core/Icon",
-    "sap/ushell/resources",
-    "sap/ui/core/HTML",
-    "./TileStateRenderer",
-    "sap/ushell/library" // css style dependency
+    "sap/ushell/ui/launchpad/TileStateInternal",
+    "./TileStateRenderer"
 ], function (
-    Control,
-    Icon,
-    resources,
-    HTML,
+    TileStateInternal,
     TileStateRenderer
-    // library
 ) {
     "use strict";
 
     /**
-     * Constructor for a new ui/launchpad/TileState.
+     * @alias sap.ushell.ui.launchpad.TileState
+     * @class
+     * @classdesc Constructor for a new ui/launchpad/TileState.
      * The tile state control that displays loading indicator,
      * while tile view is loading and failed status in case tile view is not available.
      *
      * @param {string} [sId] id for the new control, generated automatically if no id is given
      * @param {object} [mSettings] initial settings for the new control
      *
-     * @alias sap.ushell.ui.launchpad.TileState
-     * @class
      * @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 TileState = Control.extend("sap.ushell.ui.launchpad.TileState", /** @lends sap.ushell.ui.launchpad.TileState.prototype */ {
+    var TileState = TileStateInternal.extend("sap.ushell.ui.launchpad.TileState", /** @lends sap.ushell.ui.launchpad.TileState.prototype */ {
         metadata: {
             library: "sap.ushell",
             properties: {
@@ -51,70 +43,5 @@ sap.ui.define([
         renderer: TileStateRenderer
     });
 
-    TileState.prototype.init = function () {
-        this._rb = resources.i18n;
-
-        this._sFailedToLoad = this._rb.getText("cannotLoadTile");
-
-        this._oWarningIcon = new Icon(this.getId() + "-warn-icon", {
-            src: "sap-icon://notification",
-            size: "1.37rem"
-        }).addStyleClass("sapSuiteGTFtrFldIcnMrk");
-
-        this.attachPress(this._onPress);
-    };
-
-    /**
-     * Mapping of the native browser event to the UI5 semantic event.
-     *
-     * @param {object} [oEvent] The event object coming from the browser (not from UI5).
-     * @private
-     */
-    TileState.prototype.onclick = function (/*oEvent*/) {
-        this.firePress();
-    };
-
-    /**
-     * Handler of the "press" event.
-     * Checks whether the tile is in the "Failed" state and, if so, opens the FailedTileDialog. Does nothing otherwise.
-     *
-     * @param {sap.ui.base.Event} [oEvent] The event object.
-     * @private
-     */
-    TileState.prototype._onPress = function (oEvent) {
-        if (this.getState() !== "Failed") { return; }
-        if (!this.FailedTileDialog) {
-            sap.ui.require(["sap/ushell/ui/launchpad/FailedTileDialog"], function (FailedTileDialog) {
-                this.FailedTileDialog = new FailedTileDialog();
-                this._onPress(oEvent);
-            }.bind(this));
-        } else {
-            this.FailedTileDialog.openFor(this);
-        }
-    };
-
-    TileState.prototype._getBusyContainer = function () {
-        if (!this._oBusyContainer) {
-            this._oBusyContainer = new HTML({
-                content: "<div class='sapUshellTileStateLoading'><div>"
-            });
-            this._oBusyContainer.setBusy(true);
-        }
-
-        return this._oBusyContainer;
-    };
-
-    TileState.prototype.exit = function () {
-        this._oWarningIcon.destroy();
-        if (this._oBusyContainer) {
-            this._oBusyContainer.destroy();
-        }
-    };
-
-    TileState.prototype.setState = function (oState, isSuppressed) {
-        this.setProperty("state", oState, isSuppressed);
-        return this;
-    };
-
     return TileState;
 });