@sapui5/sap.ushell 1.113.0 → 1.115.0

package/src/main/js/sap/ushell/renderers/fiori2/ShellAsync.view.js

@@ -1,157 +1,151 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
 sap.ui.define([
-    "sap/ui/core/library",
-    "sap/ushell/library",
+    "sap/base/Log",
     "sap/ui/Device",
     "sap/ushell/components/_HeaderManager/ControlManager",
     "sap/ushell/components/_HeaderManager/ShellHeader.controller",
     "sap/ushell/ui/launchpad/AccessibilityCustomData",
+    "sap/ushell/EventHub",
     "sap/ushell/resources",
     "sap/ushell/utils",
     "sap/ushell/Config",
-    "sap/ushell/EventHub",
     "sap/ui/model/json/JSONModel",
     "sap/ui/core/mvc/View",
     "sap/ui/core/mvc/XMLView",
-    "sap/ui/core/Fragment"
+    "sap/ui/core/Fragment",
+    "sap/ui/core/Core",
+    "sap/ushell/renderers/fiori2/ShellLayout"
 ], function (
-    coreLibrary,
-    library,
+    Log,
     Device,
     HeaderControlManager,
     ShellHeaderController,
     AccessibilityCustomData,
+    EventHub,
     resources,
     utils,
     Config,
-    EventHub,
     JSONModel,
     View,
     XMLView,
-    Fragment
+    Fragment,
+    Core,
+    ShellLayout
 ) {
     "use strict";
+
+    var ShellLayoutMapping = ShellLayout.LAYOUT_MAPPING;
+
     function fnShellUpdateAggItem (sId, oContext) {
         return sap.ui.getCore().byId(oContext.getObject());
     }
 
+    var BINDING_TYPE = {
+        Property: "Property",
+        List: "List"
+    };
+
     return View.extend("sap.ushell.renderers.fiori2.ShellAsync", {
-        /**
-         * Most of the following code acts just as placeholder for new Unified Shell Control.
-         *
-         * @param {Object} oController oController
-         * @returns {sap.ushell.ui.Shell} oUnifiedShell
-         * @public
-         */
-        createContent: function (oController) {
-            this.oController = oController;
-            var oViewData = this.getViewData() || {},
-                oConfig = oViewData.config || {};
+        getControllerName: function () {
+            return "sap.ushell.renderers.fiori2.Shell";
+        },
 
-            this.oConfig = oConfig;
-            this.aDanglingControls = [];
+        waitForShellLayout: function () {
+            if (!this._oShellLayoutPromise) {
+                this._oShellLayoutPromise = new Promise(function (resolve) {
+                    this.getController().addDoable(EventHub.once("ShellLayoutApplied").do(resolve));
+                }.bind(this));
+            }
+            return this._oShellLayoutPromise;
+        },
+
+        getShellModel: function () {
+            return this.getViewData().shellModel;
+        },
+
+        getHelperModel: function () {
+            return this.getViewData().helperModel;
+        },
+
+        getViewDataConfig: function () {
+            var oViewData = this.getViewData() || {};
+            var oConfig = oViewData.config || {};
+            return oConfig;
+        },
 
+        createContent: function () {
             // Change config if more then three buttons moved to the header
-            this._allowUpToThreeActionInShellHeader(oConfig);
+            this._allowUpToThreeActionInShellHeader();
+
+            // BackgroundImage
+            this.initBackgroundImage();
+
+            // ShellHeader + HeaderControlManager.init
+            var oShellHeaderPromise = this.createShellHeader();
+
+            // NavigationBar
+            this.setNavigationBarMinHeight();
+
+            // RendererRootView / viewPortContainer
+            var oRendererRootViewPromise = this.createRendererRootView();
+
+            this.setDisplayBlock(true);
+
+            utils.setPerformanceMark("FLP - Shell.view rendering started!");
 
             return Promise.all([
-                this.createShellLayout(oController),
-                this.createShellHeader(oConfig, this.getViewData().shellModel)
+                oRendererRootViewPromise,
+                oShellHeaderPromise // we have to wait as well otherwise the HeaderControlManager is initialized late
             ]).then(function (aResults) {
-                var oUnifiedShell = aResults[0];
-                var oShellHeader = aResults[1];
-
-                oUnifiedShell.setHeader(oShellHeader);
-                oShellHeader.setShellLayout(oUnifiedShell);
-
-                // handling of ToolArea lazy creation
-                EventHub.once("CreateToolArea").do(function () {
-                    sap.ui.require(["sap/ushell/ui/shell/ToolArea"], function (ToolArea) {
-                        var oShellToolArea = new ToolArea({
-                            id: "shell-toolArea",
-                            toolAreaItems: {
-                                path: "/currentState/toolAreaItems",
-                                factory: fnShellUpdateAggItem
-                            }
-                        });
-                        oShellToolArea.updateAggregation = this.updateShellAggregation;
-                        oShellToolArea.addEventDelegate({
-                            onAfterRendering: function () {
-                                oUnifiedShell.applySplitContainerSecondaryContentSize();
-                            }
-                        });
-                        oUnifiedShell.setToolArea(oShellToolArea);
-                    }.bind(this));
-                }.bind(this));
+                var oRendererRootView = aResults[0];
 
-                this.setOUnifiedShell(oUnifiedShell);
+                this.initCanvasShapesManager();
 
-                this.setDisplayBlock(true);
-                this.addDanglingControl(sap.ui.getCore().byId("viewPortContainer"));
-
-                utils.setPerformanceMark("FLP - Shell.view rendering started!");
-                return oUnifiedShell;
+                return oRendererRootView;
             }.bind(this));
         },
 
-        /**
-         * allow up to 3 actions in shell header
-         * @param {Object} oConfig view configuration
-         */
-        _allowUpToThreeActionInShellHeader: function (oConfig) {
-            // in order to save performance time when these properties are not defined
-            if (Object.keys(oConfig).length > 3) {
-                var aParameter = [
-                        "moveAppFinderActionToShellHeader",
-                        "moveUserSettingsActionToShellHeader",
-                        "moveContactSupportActionToShellHeader",
-                        "moveEditHomePageActionToShellHeader"
-                    ],
-                    count = 0,
-                    sParameter;
-
-                // count the number of "true" values, once get to three, force the other to be "false"
-                for (var index = 0; index < 5; index++) {
-                    sParameter = aParameter[index];
-                    if (count === 3) {
-                        // if 3 user actions have allready been moved to the shell header, assign false to every other parameter
-                        oConfig[sParameter] = false;
-                    } else if (oConfig[sParameter]) {
-                        count++;
-                    }
-                }
-            }
+        initBackgroundImage: function () {
+            this.waitForShellLayout().then(function () {
+                var oDomRef = document.getElementById(ShellLayoutMapping.BackgroundImage);
+                var sBackgroundHtml = [
+                    // "Shell Canvas" category in ThemeDesigner
+                    "<div class='sapUiShellBackgroundImage sapUiGlobalBackgroundImageForce sapUshellShellBG sapContrastPlus'></div>",
+                    // "Application Background" category in ThemeDesigner
+                    "<div class='sapUshellShellBGsapMShellBG sapUiGlobalBackgroundImage'></div>"
+                ].join("\n");
+                oDomRef.insertAdjacentHTML("afterbegin", sBackgroundHtml);
+            });
         },
 
-        createShellLayout: function (oController) {
+        createRendererRootView: function () {
+            var oController = this.getController();
             return Fragment.load({
-                name: "sap.ushell.ui.ShellLayout",
+                name: "sap.ushell.ui.RendererRootView",
                 controller: oController
-            }).then(function (oFragment) {
-                var oComponentContainer = sap.ui.getCore().byId("menuBarComponentContainer");
-                return sap.ushell.Container.getServiceAsync("Menu")
-                    .then(function (oMenuService) {
-                        return oMenuService.isMenuEnabled();
-                    }).then(function (bMenuEnabled) {
-                        if (bMenuEnabled) {
-                            oComponentContainer.addStyleClass("sapUshellMenuBarHeight");
-                        }
-                        return oFragment;
-                    });
-            });
+            }).then(function (oRendererRootView) {
+                oRendererRootView.updateAggregation = this.updateShellAggregation;
+
+                sap.ui.getCore().byId("viewPortContainer");
+
+                return oRendererRootView;
+            }.bind(this));
         },
 
-        createShellHeader: function (oConfig, oShellModel) {
+        createShellHeader: function () {
+            var oConfig = this.getViewDataConfig();
+            var oShellModel = this.getShellModel();
             // Create own model for the header
-            var oShellHeaderModel = Config.createModel("/core/shellHeader", JSONModel),
-                oHeaderController = new ShellHeaderController();
+            var oShellHeaderModel = Config.createModel("/core/shellHeader", JSONModel);
+            var oHeaderController = new ShellHeaderController();
             oHeaderController.onInit();
 
             return Fragment.load({
                 name: "sap.ushell.ui.ShellHeader",
                 controller: oHeaderController
             }).then(function (oShellHeader) {
+                oShellHeader.updateAggregation = this.updateShellAggregation;
                 HeaderControlManager.init(oConfig, oHeaderController, oShellModel);
 
                 if (oConfig.appState === "embedded") {
@@ -161,48 +155,209 @@ sap.ui.define([
                 // Assign models to the Shell Header
                 oShellHeader.setModel(oShellHeaderModel);
                 oShellHeader.setModel(resources.i18nModel, "i18n");
-                oShellHeader.createUIArea();
+                this.addDanglingControl(oShellHeader);
+                // save for later use
+                this._oShellHeader = oShellHeader;
 
-                return oShellHeader;
-            });
+                this.waitForShellLayout().then(function () {
+                    oShellHeader.placeAt(ShellLayoutMapping.ShellHeader, "only");
+                });
+            }.bind(this));
         },
 
-        /**
-         * Begin factory functions for lazy instantiation of Shell Layout controls
-         */
+        setNavigationBarMinHeight: function () {
+            return sap.ushell.Container.getServiceAsync("Menu")
+                .then(function (oMenuService) {
+                    return oMenuService.isMenuEnabled();
+                }).then(function (bMenuEnabled) {
+                    if (!bMenuEnabled) {
+                        return;
+                    }
 
-        createPostCoreExtControls: function () {
-            // In order to minimize core-min we delay the FloatingContainer, ShellFloatingActions creation.
-            sap.ui.require([
-                "sap/ushell/ui/shell/FloatingContainer",
-                "sap/ushell/ui/shell/ShellFloatingActions"
-            ], function (FloatingContainer, ShellFloatingActions) {
-                var oShell = sap.ui.getCore().byId("shell");
-
-                // qUnit specific: the function may be called after the shell is destroyed
-                if (!oShell) {
-                    return;
+                    this.waitForShellLayout().then(function () {
+                        var navigationBar = document.getElementById(ShellLayoutMapping.NavigationBar);
+                        navigationBar.classList.add("sapUshellMenuBarHeight");
+                    });
+                }.bind(this))
+                .catch(function (vError) {
+                    Log.info("Could not apply min-height of the navigationBar", vError);
+                });
+        },
+
+        createRightFloatingContainer: function () {
+            this.addPendingInitialization(new Promise(function (resolve) {
+                sap.ui.require(["sap/ushell/ui/shell/RightFloatingContainer"], function (RightFloatingContainer) {
+                    var oRightFloatingContainer = new RightFloatingContainer({
+                        id: "right-floating-container",
+                        top: "2",
+                        hideItemsAfterPresentation: true,
+                        visible: "{/currentState/showRightFloatingContainer}",
+                        floatingContainerItems: {
+                            path: "/currentState/RightFloatingContainerItems",
+                            factory: fnShellUpdateAggItem
+                        }
+                    });
+                    oRightFloatingContainer.updateAggregation = this.updateShellAggregation;
+
+                    oRightFloatingContainer.setModel(this.getShellModel());
+                    this.addDanglingControl(oRightFloatingContainer);
+                    // save for later use
+                    this._oRightFloatingContainer = oRightFloatingContainer;
+                    resolve();
+
+                    this.waitForShellLayout().then(function () {
+                        oRightFloatingContainer.placeAt(ShellLayoutMapping.RightFloatingContainer, "only");
+                    });
+                }.bind(this));
+            }.bind(this)));
+        },
+
+        initCanvasShapesManager: function () {
+            this.bindFactory({
+                model: this.getShellModel(),
+                factory: this.createCanvasShapesManager.bind(this),
+                bindingPath: "/enableBackGroundShapes",
+                bindingType: BINDING_TYPE.Property,
+                valueCheck: function (bValue) {
+                    return !!bValue;
+                }
+            });
+        },
+
+        createCanvasShapesManager: function () {
+            var iInterval = setInterval(function () {
+                if (Core.isThemeApplied()) {
+                    clearInterval(iInterval);
+                    sap.ui.require(["sap/ushell/CanvasShapesManager"], function (CanvasShapesManager) {
+                        CanvasShapesManager.drawShapes();
+                    });
                 }
+            }, 200);
+        },
 
-                var oShellFloatingContainer = new FloatingContainer({
-                    id: "shell-floatingContainer",
+        createSubHeader: function () {
+            sap.ui.require(["sap/ushell/ui/shell/SubHeader"], function (SubHeader) {
+                var oSubHeader = new SubHeader({
+                    id: "subhdr",
                     content: {
-                        path: "/currentState/floatingContainerContent",
+                        path: "/currentState/subHeader",
                         factory: fnShellUpdateAggItem
                     }
                 });
-                if (Device.system.desktop) {
-                    // add tabindex for the floating container so it can be tab/f6
-                    oShellFloatingContainer.addCustomData(new AccessibilityCustomData({
-                        key: "tabindex",
-                        value: "-1",
-                        writeToDom: true
-                    }));
-                }
+                oSubHeader.updateAggregation = this.updateShellAggregation;
 
-                oShellFloatingContainer.setModel(oShell.getModel());
+                oSubHeader.setModel(this.getShellModel());
+                this.addDanglingControl(oSubHeader);
 
-                this.addDanglingControl(oShellFloatingContainer);
+                this.waitForShellLayout().then(function () {
+                    oSubHeader.placeAt(ShellLayoutMapping.SubHeader, "only");
+                });
+            }.bind(this));
+        },
+
+        createFloatingContainer: function () {
+            return new Promise(function (resolve, reject) {
+                sap.ui.require([
+                    "sap/ushell/ui/shell/FloatingContainer",
+                    "sap/ui/util/Storage"
+                ], function (FloatingContainer, Storage) {
+                    var oFloatingContainer = new FloatingContainer({
+                        id: "shell-floatingContainer",
+                        visible: "{helper>/shell/floatingContainerVisible}",
+                        content: {
+                            path: "/currentState/floatingContainerContent",
+                            factory: fnShellUpdateAggItem
+                        }
+                    });
+                    oFloatingContainer.updateAggregation = this.updateShellAggregation;
+
+                    if (Device.system.desktop) {
+                        // add tabindex for the floating container so it can be tab/f6
+                        oFloatingContainer.addCustomData(new AccessibilityCustomData({
+                            key: "tabindex",
+                            value: "-1",
+                            writeToDom: true
+                        }));
+                    }
+
+                    oFloatingContainer.setModel(this.getShellModel());
+                    oFloatingContainer.setModel(this.getHelperModel(), "helper");
+                    this.addDanglingControl(oFloatingContainer);
+
+                    this.waitForShellLayout().then(function () {
+                        oFloatingContainer.placeAt(ShellLayoutMapping.FloatingContainer, "only");
+
+                        var oStorage = new Storage(Storage.Type.local, "com.sap.ushell.adapters.local.FloatingContainer");
+                        var oFloatingContainerWrapper = document.getElementById(ShellLayoutMapping.FloatingContainer);
+
+                        var bFirstTimeRender = !oFloatingContainerWrapper.classList.contains("sapUshellFloatingContainerWrapper");
+                        var sCssStyles = oStorage.get("floatingContainerStyle");
+
+                        if (bFirstTimeRender && !sCssStyles) {
+                            var emSize = jQuery(".sapUshellShellHeadItm").position() ? jQuery(".sapUshellShellHeadItm").position().left : 0;
+                            var iLeftPos = (jQuery(window).width() - jQuery("#shell-floatingContainer").width() - emSize) * 100 / jQuery(window).width();
+                            var iTopPos = jQuery(".sapUshellShellHeader").height() * 100 / jQuery(window).height();
+                            oFloatingContainerWrapper.style.left = iLeftPos + "%";
+                            oFloatingContainerWrapper.style.top = iTopPos + "%";
+                            oFloatingContainerWrapper.style.position = "absolute";
+                            oStorage.put("floatingContainerStyle", oFloatingContainerWrapper.style.cssText);
+
+                        } else if (sCssStyles) {
+                            oFloatingContainerWrapper.style.cssText = sCssStyles;
+                        }
+
+                        oFloatingContainerWrapper.classList.add("sapUshellFloatingContainerWrapper");
+
+                        resolve();
+                    });
+                }.bind(this));
+            }.bind(this));
+        },
+
+        createSidePane: function () {
+            sap.ui.require(["sap/ushell/ui/shell/SidePane"], function (SidePane) {
+                var oSidePane = new SidePane({
+                    id: "shell-sidePane",
+                    visible: "{/currentState/showPane}",
+                    content: {
+                        path: "/currentState/paneContent",
+                        factory: fnShellUpdateAggItem
+                    }
+                });
+                oSidePane.updateAggregation = this.updateShellAggregation;
+
+                oSidePane.setModel(this.getShellModel());
+                this.addDanglingControl(oSidePane);
+
+                this.waitForShellLayout().then(function () {
+                    oSidePane.placeAt(ShellLayoutMapping.SidePane, "only");
+                });
+            }.bind(this));
+        },
+
+        createToolArea: function () {
+            sap.ui.require(["sap/ushell/ui/shell/ToolArea"], function (ToolArea) {
+                var oShellToolArea = new ToolArea({
+                    id: "shell-toolArea",
+                    visible: "{/currentState/toolAreaVisible}",
+                    toolAreaItems: {
+                        path: "/currentState/toolAreaItems",
+                        factory: fnShellUpdateAggItem
+                    }
+                });
+                oShellToolArea.updateAggregation = this.updateShellAggregation;
+
+                oShellToolArea.setModel(this.getShellModel());
+                this.addDanglingControl(oShellToolArea);
+
+                this.waitForShellLayout().then(function () {
+                    oShellToolArea.placeAt(ShellLayoutMapping.ToolArea, "only");
+                });
+            }.bind(this));
+        },
+
+        createFloatingActions: function () {
+            sap.ui.require(["sap/ushell/ui/shell/ShellFloatingActions"], function (ShellFloatingActions) {
                 var oShellFloatingActions = new ShellFloatingActions({
                     id: "shell-floatingActions",
                     floatingActions: {
@@ -210,56 +365,159 @@ sap.ui.define([
                         factory: fnShellUpdateAggItem
                     }
                 });
-
                 oShellFloatingActions.updateAggregation = this.updateShellAggregation;
 
-                var oShellLayout = this.getOUnifiedShell();
-                oShellLayout.setFloatingContainer(oShellFloatingContainer);
-                oShellLayout.setFloatingActionsContainer(oShellFloatingActions);
+                oShellFloatingActions.setModel(this.getShellModel());
+                this.addDanglingControl(oShellFloatingActions);
 
-                this._createAllMyAppsView();
+                this.waitForShellLayout().then(function () {
+                    oShellFloatingActions.placeAt(ShellLayoutMapping.FloatingActions, "only");
+                });
             }.bind(this));
         },
 
-        _createAllMyAppsView: function () {
-            var onServiceLoaded = function (oAllMyApps) {
+        initAllMyAppsView: function () {
+            return sap.ushell.Container.getServiceAsync("AllMyApps").then(function (oAllMyApps) {
                 if (oAllMyApps.isEnabled()) {
-                    this._initializeAllMyAppsView();
+                    return this.createAllMyAppsView();
                 }
-            }.bind(this);
-
-            sap.ushell.Container.getServiceAsync("AllMyApps").then(onServiceLoaded);
+            }.bind(this));
         },
 
-        _initializeAllMyAppsView: function () {
-            XMLView.create({
+        createAllMyAppsView: function () {
+            return XMLView.create({
                 id: "allMyAppsView",
                 viewName: "sap.ushell.renderers.fiori2.allMyApps.AllMyApps"
             }).then(function (allMyAppsView) {
-                var oModel = this.getModel();
-                allMyAppsView.setModel(oModel);
+                allMyAppsView.setModel(this.getShellModel());
                 allMyAppsView.setModel(resources.i18nModel, "i18n");
                 allMyAppsView.addCustomData(new AccessibilityCustomData({
                     key: "aria-label",
                     value: resources.i18n.getText("allMyApps_headerTitle"),
                     writeToDom: true
                 }));
-                this.getOUnifiedShell().getHeader().getAppTitle().setAllMyApps(allMyAppsView);
+                this.addDanglingControl(allMyAppsView);
+                this.getShellHeader().getAppTitle().setAllMyApps(allMyAppsView);
             }.bind(this));
         },
 
-        getOUnifiedShell: function () {
-            return this.oUnifiedShell;
+        /**
+         * Begin factory functions for lazy instantiation of Shell Layout controls
+         */
+        createPostCoreExtControls: function () {
+            var oShellModel = this.getShellModel();
+
+            // apply the highest z-index used by the shell
+            sap.ui.require(["sap/ui/core/Popup"], function (Popup) {
+                Popup.setInitialZIndex(11);
+            });
+
+            // RightFloatingContainer
+            this.bindFactory({
+                model: oShellModel,
+                factory: this.createRightFloatingContainer.bind(this),
+                bindingPath: "/currentState/showRightFloatingContainer",
+                bindingType: BINDING_TYPE.Property,
+                valueCheck: function (bValue) {
+                    return !!bValue;
+                }
+            });
+
+            // SubHeader
+            this.bindFactory({
+                model: oShellModel,
+                factory: this.createSubHeader.bind(this),
+                bindingPath: "/currentState/subHeader",
+                bindingType: BINDING_TYPE.List,
+                valueCheck: function (aValues) {
+                    return !!aValues.length;
+                }
+            });
+
+            // ToolArea
+            this.bindFactory({
+                model: oShellModel,
+                factory: this.createToolArea.bind(this),
+                bindingPath: "/currentState/toolAreaVisible",
+                bindingType: BINDING_TYPE.Property,
+                valueCheck: function (bValue) {
+                    return !!bValue;
+                }
+            });
+
+            // (Left)SidePane
+            this.bindFactory({
+                model: oShellModel,
+                factory: this.createSidePane.bind(this),
+                bindingPath: "/currentState/showPane",
+                bindingType: BINDING_TYPE.Property,
+                valueCheck: function (bValue) {
+                    return !!bValue;
+                }
+            });
+
+            // FloatingActions (deprecated)
+            this.bindFactory({
+                model: oShellModel,
+                factory: this.createFloatingActions.bind(this),
+                bindingPath: "/currentState/floatingActions",
+                bindingType: BINDING_TYPE.List,
+                valueCheck: function (aValues) {
+                    return !!aValues.length;
+                }
+            });
+
+            this.addPendingInitialization(this.initAllMyAppsView());
         },
 
-        setOUnifiedShell: function (oUnifiedShell) {
-            this.oUnifiedShell = oUnifiedShell;
+        /**
+         * allow up to 3 actions in shell header
+         */
+        _allowUpToThreeActionInShellHeader: function () {
+            var oConfig = this.getViewDataConfig();
+            // in order to save performance time when these properties are not defined
+            if (Object.keys(oConfig).length > 3) {
+                var aParameter = [
+                    "moveAppFinderActionToShellHeader",
+                    "moveUserSettingsActionToShellHeader",
+                    "moveContactSupportActionToShellHeader",
+                    "moveEditHomePageActionToShellHeader"
+                ];
+                var count = 0;
+                var sParameter;
+
+                // count the number of "true" values, once get to three, force the other to be "false"
+                for (var index = 0; index < 5; index++) {
+                    sParameter = aParameter[index];
+                    if (count === 3) {
+                        // if 3 user actions have already been moved to the shell header, assign false to every other parameter
+                        oConfig[sParameter] = false;
+                    } else if (oConfig[sParameter]) {
+                        count++;
+                    }
+                }
+            }
+        },
+
+        /**
+         * @returns {sap.ui.core.Control} The ShellHeader
+         *
+         * @private
+         * @ui5-restricted sap.ui.rta
+         * @since 1.114.0
+         */
+        getShellHeader: function () {
+            return this._oShellHeader;
+        },
+
+        getRightFloatingContainer: function () {
+            return this._oRightFloatingContainer;
         },
 
         updateShellAggregation: function (sName) {
-            var oBindingInfo = this.mBindingInfos[sName],
-                oAggregationInfo = this.getMetadata().getJSONKeys()[sName],
-                oClone;
+            var oBindingInfo = this.mBindingInfos[sName];
+            var oAggregationInfo = this.getMetadata().getJSONKeys()[sName];
+            var oClone;
 
             this[oAggregationInfo._sGetter]().forEach(function (v) {
                 this[oAggregationInfo._sRemoveMutator](v);
@@ -272,23 +530,99 @@ sap.ui.define([
             }.bind(this));
         },
 
-        getControllerName: function () {
-            return "sap.ushell.renderers.fiori2.Shell";
+        /**
+         * Executes the factory instantly in case the <code>model already fulfills the valueCheck.
+         * Otherwise binds the factory against the model path.
+         * Once the binding fulfills the valueCheck the binding gets destroyed.
+         *
+         * @param {object} oSettings The settings
+         * @param {sap.ui.model.Model} oSettings.model The model
+         * @param {function} oSettings.factory The handler which gets executed
+         * @param {string} oSettings.bindingPath The binding path
+         * @param {string} oSettings.bindingType The type of binding. Either "Property" or "List".
+         * @param {function} oSettings.valueCheck The check function.
+         *  it receives the bound property as argument. It should return true once the value fulfills the requirements.
+         *
+         * @private
+         * @since 1.115.0
+         */
+        bindFactory: function (oSettings) {
+            var oModel = oSettings.model;
+            var fnFactory = oSettings.factory;
+            var sPath = oSettings.bindingPath;
+            var sBindingType = oSettings.bindingType;
+            var fnValueCheck = oSettings.valueCheck;
+
+            var vValue = oModel.getProperty(sPath);
+            if (fnValueCheck(vValue)) { // model already fulfills the requirements
+                fnFactory();
+            } else {
+                var oBinding;
+                switch (sBindingType) {
+                    case BINDING_TYPE.List:
+                        oBinding = oModel.bindList(sPath);
+                        break;
+                    default: // BINDING_TYPE.Property
+                        oBinding = oModel.bindProperty(sPath);
+                }
+                this.addDanglingBinding(oBinding);
+                oBinding.attachChange(function () {
+                    vValue = oBinding.getModel().getProperty(oBinding.getPath());
+                    if (fnValueCheck(vValue)) {
+                        this.removeDanglingBinding(oBinding);
+                        oBinding.destroy();
+
+                        fnFactory();
+                    }
+                }, this);
+            }
+        },
+
+        /**
+         * Adds a binding which is destroyed on Renderer destroy
+         * @param {sap.ui.model.Binding} oBinding The Binding
+         * @see sap.ushell.renderers.fiori2.Shell.controller#onExit
+         *
+         * @private
+         * @since 1.114.0
+         */
+        addDanglingBinding: function (oBinding) {
+            this.getController().addDanglingBinding(oBinding);
+        },
+
+        /**
+         * @param {sap.ui.model.Binding} oBinding The Binding
+         * @see sap.ushell.renderers.fiori2.Shell.controller#onExit
+         *
+         * @private
+         * @since 1.114.0
+         */
+        removeDanglingBinding: function (oBinding) {
+            this.getController().removeDanglingBinding(oBinding);
         },
 
+        /**
+         * @param {sap.ui.core.Control} oControl The Control
+         * @see sap.ushell.renderers.fiori2.Shell.controller#onExit
+         *
+         * @private
+         * @since 1.114.0
+         */
         addDanglingControl: function (oControl) {
-            this.aDanglingControls.push(oControl);
+            this.getController().addDanglingControl(oControl);
         },
 
-        destroyDanglingControls: function () {
-            if (this.aDanglingControls) {
-                this.aDanglingControls.forEach(function (oControl) {
-                    if (oControl.destroyContent) {
-                        oControl.destroyContent();
-                    }
-                    oControl.destroy();
-                });
-            }
+        /**
+         * Adds a promise to the list of initializations
+         * Only used in test environments!
+         * @param {Promise} oPromise A Promise
+         * @returns {Promise} Returns the provided promise to allow chaining
+         *
+         * @private
+         * @since 1.114.0
+         */
+        addPendingInitialization: function (oPromise) {
+            return this.getController().addPendingInitialization(oPromise);
         }
     });
 });