@openui5/sap.ui.core 1.91.0 → 1.93.2

package/src/sap/ui/core/mvc/View.js

@@ -6,6 +6,7 @@
 
 // Provides control sap.ui.core.mvc.View.
 sap.ui.define([
+	"sap/base/util/isEmptyObject",
 	"sap/ui/base/ManagedObject",
 	"sap/ui/core/Control",
 	"sap/ui/core/mvc/Controller",
@@ -19,6 +20,7 @@ sap.ui.define([
 	"sap/ui/core/Core" // to ensure correct behaviour of sap.ui.getCore()
 ],
 	function(
+		isEmptyObject,
 		ManagedObject,
 		Control,
 		Controller,
@@ -138,7 +140,7 @@ sap.ui.define([
 	 * The default implementation of this method returns <code>false</code>.
 	 *
 	 * @extends sap.ui.core.Control
-	 * @version 1.91.0
+	 * @version 1.93.2
 	 *
 	 * @public
 	 * @alias sap.ui.core.mvc.View
@@ -440,14 +442,30 @@ sap.ui.define([
 				bAsync = mSettings.async;
 
 			if (!oController && oThis.getControllerName) {
+				oThis.bControllerIsViewManaged = true;
 				// get optional default controller name
 				var defaultController = oThis.getControllerName();
 				if (defaultController) {
 					// check for controller replacement
-					var CustomizingConfiguration = sap.ui.require('sap/ui/core/CustomizingConfiguration');
-					var sControllerReplacement = CustomizingConfiguration && CustomizingConfiguration.getControllerReplacement(defaultController, ManagedObject._sOwnerId);
-					if (sControllerReplacement) {
-						defaultController = typeof sControllerReplacement === "string" ? sControllerReplacement : sControllerReplacement.controllerName;
+					var Component = sap.ui.require("sap/ui/core/Component");
+
+					if (Component && ManagedObject._sOwnerId) {
+						var oOwnerComponent = Component.get(ManagedObject._sOwnerId);
+
+						if (oOwnerComponent) {
+							var oControllerExtensionCarrier = oOwnerComponent;
+							if (oOwnerComponent.getExtensionComponent) {
+								oControllerExtensionCarrier = oOwnerComponent.getExtensionComponent();
+								if (!oControllerExtensionCarrier) {
+									throw new Error("getExtensionComponent() must return an instance.");
+								}
+							}
+
+							var sControllerReplacement = oControllerExtensionCarrier._getManifestEntry("/sap.ui5/extends/extensions/sap.ui.controllerReplacements/" + defaultController, true);
+							if (sControllerReplacement) {
+								defaultController = typeof sControllerReplacement === "string" ? sControllerReplacement : sControllerReplacement.controllerName;
+							}
+						}
 					}
 					// create controller
 					if (bAsync) {
@@ -457,6 +475,7 @@ sap.ui.define([
 					}
 				}
 			} else if (oController) {
+				oThis.bControllerIsViewManaged = false;
 				// if passed controller is not extended yet we need to do it.
 				var sOwnerId = ManagedObject._sOwnerId;
 				if (!oController._isExtended()) {
@@ -510,6 +529,11 @@ sap.ui.define([
 		// remember the name of this View
 		this.sViewName = mSettings.viewName;
 
+		// typed views are prefixed with "module:" and contains slashes
+		if (this.sViewName && this.sViewName.startsWith("module:")) {
+			this.sViewName = this.sViewName.slice("module:".length).replace(/\//g, ".");
+		}
+
 		var that = this;
 
 		initPreprocessorQueues(this, mSettings);
@@ -519,28 +543,54 @@ sap.ui.define([
 			initAsyncState(this);
 		}
 
-		//check if there are custom properties configured for this view, and only if there are, create a settings preprocessor applying these
-		var CustomizingConfiguration = sap.ui.require('sap/ui/core/CustomizingConfiguration');
-		if (CustomizingConfiguration && CustomizingConfiguration.hasCustomProperties(this.sViewName, this)) {
-			this._fnSettingsPreprocessor = function(mSettings) {
-				var sId = this.getId();
-				if (CustomizingConfiguration && sId) {
-					if (that.isPrefixedId(sId)) {
-						sId = sId.substring((that.getId() + "--").length);
-					}
-					var mCustomSettings = CustomizingConfiguration.getCustomProperties(that.sViewName, sId, that);
-					if (mCustomSettings) {
-						mSettings = extend(mSettings, mCustomSettings); // override original property initialization with customized property values
+		var Component = sap.ui.require("sap/ui/core/Component");
+		var oOwnerComponent = Component && Component.getOwnerComponentFor(this);
+
+		// view modifications
+		// check if there are custom properties configured for this view, and only if there are, create a settings preprocessor applying these
+		if (!sap.ui.getCore().getConfiguration().getDisableCustomizing()) {
+			if (oOwnerComponent) {
+				var oViewModificationCarrier = oOwnerComponent;
+				if (oOwnerComponent.getExtensionComponent) {
+					oViewModificationCarrier = oOwnerComponent.getExtensionComponent();
+					if (!oViewModificationCarrier) {
+						throw new Error("getExtensionComponent() must return an instance.");
 					}
 				}
-			};
+
+				var mCustomSettings = oViewModificationCarrier._getManifestEntry("/sap.ui5/extends/extensions/sap.ui.viewModifications/" + this.sViewName, true);
+
+				if (!isEmptyObject(mCustomSettings)) {
+					// NOTE:
+					// nested views do not inherit the preprocessor settings function from the parent
+					// controls within fragments however do inherit the settings function from the containing view (see Fragment#init)
+					this._fnSettingsPreprocessor = function(mSettings) {
+						var sId = this.getId();
+						if (sId) {
+							if (that.isPrefixedId(sId)) {
+								sId = sId.substring((that.getId() + "--").length);
+							}
+							var oCustomSetting = Object.assign({}, mCustomSettings[sId]);
+							if (oCustomSetting) {
+								// only 'visible' property can be customized
+								for (var sProperty in oCustomSetting) {
+									if (sProperty !== "visible") {
+										Log.warning("Customizing: custom value for property '" + sProperty + "' of control '" + sId + "' in View '" + that.sViewName + "' ignored: only the 'visible' property can be customized.");
+										delete oCustomSetting[sProperty];
+									}
+								}
+								Log.info("Customizing: custom value for property 'visible' of control '" + sId + "' in View '" + that.sViewName + "' applied: " + oCustomSetting.visible);
+								mSettings = extend(mSettings, oCustomSetting); // override original property initialization with customized property values
+							}
+						}
+					};
+				}
+			}
 		}
 
 		var fnPropagateOwner = function(fnCallback, bAsync) {
 			assert(typeof fnCallback === "function", "fn must be a function");
 
-			var Component = sap.ui.require("sap/ui/core/Component");
-			var oOwnerComponent = Component && Component.getOwnerComponentFor(that);
 			if (oOwnerComponent) {
 				if (bAsync) {
 					// special treatment when component loading is async but instance creation is sync
@@ -694,7 +744,10 @@ sap.ui.define([
 	 */
 	View.prototype.exit = function() {
 		this.fireBeforeExit();
-		delete this.oController;
+		if (this.oController && this.bControllerIsViewManaged) {
+			this.oController.destroy();
+			delete this.oController;
+		}
 		delete this.oPreprocessorInfo;
 		if (this.oAsyncState) {
 			var fnDelete = deleteAsyncState.bind(this);
@@ -1066,51 +1119,47 @@ sap.ui.define([
 	 * @private
 	 * @ui5-restricted sap.ui.core
 	 * @see {sap.ui.view}
+	 * @function
 	 */
 	View._create = viewFactory;
 
 	/**
 	 * Creates a view of the given type, name and with the given ID.
 	 *
-	 * The <code>vView</code> configuration object can have the following properties for the view
-	 * instantiation:
-	 * <ul>
-	 * <li>The ID <code>vView.id</code> specifies an ID for the View instance. If no ID is given,
-	 * an ID will be generated.</li>
-	 * <li>The view name <code>vView.viewName</code> corresponds to an XML module that can be loaded
-	 * via the module system (vView.viewName + suffix ".view.xml")</li>
-	 * <li>The controller instance <code>vView.controller</code> must be a valid controller implementation.
-	 * The given controller instance overrides the controller defined in the view definition</li>
-	 * <li>The view type <code>vView.type</code> specifies what kind of view will be instantiated. All valid
-	 * view types are listed in the enumeration sap.ui.core.mvc.ViewType.</li>
-	 * <li>The view data <code>vView.viewData</code> can hold user specific data. This data is available
-	 * during the whole lifecycle of the view and the controller</li>
-	 * <li>The view loading mode <code>vView.async</code> must be a boolean and defines if the view source is loaded
-	 * synchronously or asynchronously. In async mode, the view is rendered empty initially, and re-rendered with the
-	 * loaded view content.</li>
-	 * <li><code>vView.preprocessors</code></li> can hold a map from the specified preprocessor type (e.g. "xml") to an array of
-	 * preprocessor configurations; each configuration consists of a <code>preprocessor</code> property (optional when
-	 * registered as on-demand preprocessor) and may contain further preprocessor-specific settings. The preprocessor can
-	 * be either a module name as string implementation of {@link sap.ui.core.mvc.View.Preprocessor} or a function according to
-	 * {@link sap.ui.core.mvc.View.Preprocessor.process}. Do not set properties starting with underscore like <code>_sProperty</code>
-	 * property, these are reserved for internal purposes. When several preprocessors are provided for one hook, it has to be made
-	 * sure that they do not conflict when being processed serially.
-	 *
-	 * <strong>Note</strong>: These preprocessors are only available to this instance. For global or
+	 * @param {string} [sId] The ID of the newly created view, only allowed for instance creation. If no ID is given,
+	 * an ID will be generated. For view definition, skip this parameter and use <code>vView</code> as the first parameter.
+	 * @param {string|object} [vView] The view name or view configuration object.
+	 * @param {object} [vView.id] Specifies an ID for the view instance. If no ID is given,
+	 * an ID will be generated.
+	 * @param {object} [vView.viewName] Corresponds to an XML module that can be loaded
+	 * via the module system (vView.viewName + suffix ".view.xml").
+	 * @param {sap.ui.core.mvc.Controller} [vView.controller] The controller instance must be a valid controller implementation.
+	 * The given controller instance overrides the controller defined in the view definition.
+	 * @param {boolean} [vView.async] Whether the view source is loaded asynchronously. In asynchronous mode, the view is returned empty,
+	 * and the view content is loaded asynchronously.
+	 * @param {sap.ui.core.mvc.ViewType} [vView.type] Specifies what kind of view will be instantiated. All valid
+	 * view types are listed in the enumeration {@link sap.ui.core.mvc.ViewType}.
+	 * @param {object} [vView.viewData] Holds application specific data. This data is available
+	 * during the whole lifecycle of the view and the controller, for example in the constructor and in the {@link sap.ui.core.mvc.Controller.onInit onInit} hook.
+	 * @param {Map<string,object[]>} [vView.preprocessors] Holds a map from the specified preprocessor type (e.g. "xml") to an array of
+	 * preprocessor configurations. Each configuration consists of a <code>preprocessor</code> property (optional when
+	 * registered as on-demand preprocessor) and may contain further preprocessor-specific settings.
+	 * @param {string|sap.ui.core.mvc.View.Preprocessor|function} [vView.preprocessors.preprocessor]
+	 * The used preprocessor. For further information see {@link sap.ui.core.mvc.View.Preprocessor.process}.
+	 * Do not set properties starting with an underscore, such as <code>_sProperty</code>, as these are reserved for internal purposes.
+	 * When several preprocessors are provided for one hook, it has to be made sure that they do not conflict when being processed serially.
+	 *
+	 * </br><strong>Note</strong>: These preprocessors are only available to this instance. For global or
 	 * on-demand availability use {@link sap.ui.core.mvc.XMLView.registerPreprocessor}.
 	 *
-	 * <strong>Note</strong>: Please note that preprocessors in general are currently only available
-	 * to XMLViews.
+	 * </br><strong>Note</strong>: Please note that preprocessors in general are currently only available
+	 * for {@link sap.ui.core.mvc.XMLView XMLViews}.
 	 *
-	 * <strong>Note</strong>: Preprocessors only work in async views and will be ignored when the view is instantiated
-	 * in sync mode by default, as this could have unexpected side effects. You may override this behaviour by setting the
-	 * bSyncSupport flag of the preprocessor to true.
+	 * </br><strong>Note</strong>: Preprocessors only work in asynchronous views and will be ignored by default
+	 * when the view is instantiated synchronously, as this could have unexpected side effects.
+	 * You may override this behaviour by setting the <code>bSyncSupport</code> flag
+	 * of the preprocessor to <code>true</code>.
 	 *
-	 * @param {string} sId id of the newly created view, only allowed for instance creation
-	 * @param {string|object} [vView] the view name or view configuration object
-	 * @param {sap.ui.core.mvc.ViewType} sType Specifies what kind of view will be instantiated. All valid
-	 * view types are listed in the enumeration  {@link sap.ui.core.mvc.ViewType}.
-	 * @param {boolean} [vView.async] whether the view source is loaded asynchronously
 	 * @public
 	 * @static
 	 * @deprecated Since 1.56. Use {@link sap.ui.core.mvc.View.extend View.extend} to define the view class
@@ -1118,7 +1167,7 @@ sap.ui.define([
 	 * @return {sap.ui.core.mvc.View} the created View instance
 	 * @ui5-global-only
 	 */
-	sap.ui.view = function(sId, vView, sType /* used by factory functions */) {
+	sap.ui.view = function(sId, vView, sType /* internal, used by factory functions */) {
 		var sViewName = typeof sId === "string" ? sId : vView;
 		sViewName = typeof sViewName === "object" ? sViewName.viewName : sViewName;
 
@@ -1186,15 +1235,38 @@ sap.ui.define([
 			oView.processingMode = oView.processingMode || XMLProcessingMode.SequentialLegacy;
 		}
 
+
+
 		// view replacement
-		var CustomizingConfiguration = sap.ui.require('sap/ui/core/CustomizingConfiguration');
-		if (CustomizingConfiguration) {
-			var customViewConfig = CustomizingConfiguration.getViewReplacement(oView.viewName, ManagedObject._sOwnerId);
-			if (customViewConfig) {
-				Log.info("Customizing: View replacement for view '" + oView.viewName + "' found and applied: " + customViewConfig.viewName + " (type: " + customViewConfig.type + ")");
-				extend(oView, customViewConfig);
-			} else {
-				Log.debug("Customizing: no View replacement found for view '" + oView.viewName + "'.");
+		if (!sap.ui.getCore().getConfiguration().getDisableCustomizing()) {
+			// get current owner component
+			var Component = sap.ui.require("sap/ui/core/Component");
+			var oOwnerComponent;
+
+			if (Component && ManagedObject._sOwnerId) {
+				oOwnerComponent = Component.get(ManagedObject._sOwnerId);
+			}
+
+			if (oOwnerComponent) {
+				var oViewReplacementCarrier = oOwnerComponent;
+				if (oOwnerComponent.getExtensionComponent) {
+					var oViewReplacementCarrier = oOwnerComponent.getExtensionComponent();
+					if (!oViewReplacementCarrier) {
+						throw new Error("getExtensionComponent() must return an instance.");
+					}
+				}
+
+				var customViewConfig = oViewReplacementCarrier._getManifestEntry("/sap.ui5/extends/extensions/sap.ui.viewReplacements/" + oView.viewName, true);
+
+				if (customViewConfig) {
+					// make sure that "async=true" will not be overriden
+					delete customViewConfig.async;
+
+					Log.info("Customizing: View replacement for view '" + oView.viewName + "' found and applied: " + customViewConfig.viewName + " (type: " + customViewConfig.type + ")");
+					extend(oView, customViewConfig);
+				} else {
+					Log.debug("Customizing: no View replacement found for view '" + oView.viewName + "'.");
+				}
 			}
 		}
 
@@ -1208,6 +1280,9 @@ sap.ui.define([
 
 		// view creation
 		if (sViewClass) {
+			if (oViewSettings.type) {
+				Log.error("When using the view factory, the 'type' setting must be omitted for typed views. When embedding typed views in XML, don't use the <JSView> tag, use the <View> tag instead.");
+			}
 			return sViewClass;
 		}
 		if (!oViewSettings.type) {
@@ -1382,17 +1457,19 @@ sap.ui.define([
 		};
 
 		return ManagedObject.runWithPreprocessors(function() {
+			var vContent = this.createContent(oController);
 			if (mSettings.async) {
-				var vContent = this.createContent(oController);
-				vContent = vContent instanceof Promise ? vContent : Promise.resolve(vContent);
+				vContent = Promise.resolve(vContent);
 				return vContent.then(function(vContent) {
 					this.applySettings({
 						content : vContent
 					});
 				}.bind(this));
+			} else if (vContent instanceof Promise) {
+				throw new Error("An asynchronous view (createContent) cannot be instantiated synchronously. Affected view: '" + this.getMetadata().getName() + "'.");
 			} else {
 				this.applySettings({
-					content : this.createContent(oController)
+					content : vContent
 				});
 			}
 		}.bind(this), mPreprocessorSettings);

package/src/sap/ui/core/mvc/ViewType.js

@@ -11,6 +11,8 @@ sap.ui.define([], function () {
 	/**
 	 * Specifies possible view types.
 	 *
+	 * <b>Note:</b> Typed views do not rely on a <code>ViewType</code>, it must be omitted in the view settings.
+	 *
 	 * @enum {string}
 	 * @public
 	 * @alias sap.ui.core.mvc.ViewType

package/src/sap/ui/core/mvc/XMLView.js

@@ -96,7 +96,7 @@ sap.ui.define([
 	 * control's dependents aggregation or add it by using {@link sap.ui.core.mvc.XMLView#addDependent}.
 	 *
 	 * @extends sap.ui.core.mvc.View
-	 * @version 1.91.0
+	 * @version 1.93.2
 	 *
 	 * @public
 	 * @alias sap.ui.core.mvc.XMLView
@@ -260,6 +260,8 @@ sap.ui.define([
 	/**
 	 * Flag for feature detection of asynchronous loading/rendering
 	 * @public
+	 * @readonly
+	 * @type {boolean}
 	 * @since 1.30
 	 */
 	XMLView.asyncSupport = true;
@@ -350,15 +352,17 @@ sap.ui.define([
 		var Component = sap.ui.require("sap/ui/core/Component"),
 			oComponent;
 
-		while (oSrcElement && Component) {
-			var oCandidateComponent = Component.getOwnerComponentFor(oSrcElement);
-			if (oCandidateComponent) {
-				oSrcElement = oComponent = oCandidateComponent;
-			} else {
-				if (oSrcElement instanceof Component) {
-					oComponent = oSrcElement;
+		if (Component) {
+			while (oSrcElement) {
+				var oCandidateComponent = Component.getOwnerComponentFor(oSrcElement);
+				if (oCandidateComponent) {
+					oSrcElement = oComponent = oCandidateComponent;
+				} else {
+					if (oSrcElement instanceof Component) {
+						oComponent = oSrcElement;
+					}
+					oSrcElement = oSrcElement.getParent && oSrcElement.getParent();
 				}
-				oSrcElement = oSrcElement.getParent && oSrcElement.getParent();
 			}
 		}
 		return oComponent;

package/src/sap/ui/core/plugin/DeclarativeSupport.js

@@ -21,7 +21,7 @@ sap.ui.define([
 	 * @see sap.ui.core.DeclarativeSupport
 	 * @public
 	 * @since 1.7.0
-	 * @version 1.91.0
+	 * @version 1.93.2
 	 * @alias sap.ui.core.plugin.DeclarativeSupport
 	 */
 	var DeclarativeSupportPlugin = function() {

package/src/sap/ui/core/plugin/LessSupport.js

@@ -37,7 +37,7 @@
 			 *        feature - DO NOT USE IN PRODUCTIVE SCENARIOS!!
 			 *
 			 * @author Peter Muessig
-			 * @version 1.91.0
+			 * @version 1.93.2
 			 * @private
 			 * @alias sap.ui.core.plugin.LessSupport
 			 */

package/src/sap/ui/core/plugin/TemplatingSupport.js

@@ -20,7 +20,7 @@ sap.ui.define([
 	 * @author Peter Muessig
 	 * @public
 	 * @since 1.15.0
-	 * @version 1.91.0
+	 * @version 1.93.2
 	 * @alias sap.ui.core.plugin.TemplatingSupport
 	 */
 	var TemplatingSupport = function() {

package/src/sap/ui/core/postmessage/Bus.js

@@ -38,7 +38,7 @@ function (
 	 * @alias sap.ui.core.postmessage.Bus
 	 * @author SAP SE
 	 * @since 1.56.0
-	 * @version 1.91.0
+	 * @version 1.93.2
 	 * @private
 	 * @ui5-restricted sap.ui.core.support, sap.ui.support, sap.ui.rta
 	 */

package/src/sap/ui/core/postmessage/confirmationDialog.js

@@ -13,7 +13,7 @@ sap.ui.define(function () {
 	 *
 	 * @author SAP SE
 	 * @since 1.56.0
-	 * @version 1.91.0
+	 * @version 1.93.2
 	 *
 	 * @function
 	 * @param {string} sMessage - Dialog message

package/src/sap/ui/core/routing/HashChangerBase.js

@@ -106,13 +106,20 @@ sap.ui.define([
 	 * Replaces the hash with a certain value. When using the replace function, no browser history entry is written.
 	 * If you want to have an entry in the browser history, please use the {@link #setHash} function.
 	 *
+	 * The <code>sDirection</code> parameter can be used to provide direction information on the navigation which
+	 * leads to this hash replacement. This is typically used when synchronizing the hashes between multiple frames to
+	 * provide information to the frame where the hash is replaced with the navigation direction in the other frame
+	 * where the navigation occurs.
+	 *
 	 * @param {string} sHash New hash
+	 * @param {sap.ui.core.routing.HistoryDirection} sDirection The direction information for this hash replacement
 	 * @protected
 	 */
-	HashChangerBase.prototype.replaceHash = function(sHash) {
+	HashChangerBase.prototype.replaceHash = function(sHash, sDirection) {
 		this.fireEvent("hashReplaced", {
 			sHash: sHash, //deprecated
-			hash: sHash
+			hash: sHash,
+			direction: sDirection
 		});
 	};