@openui5/sap.ui.core 1.94.0 → 1.97.0

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

@@ -60,7 +60,7 @@ sap.ui.define([
 	 * @private
 	 */
 	var XMLViewRenderer = {
-		apiVersion: 1 // HTML fragments still require write (fragments are explicitly not wellformed HTML)
+		apiVersion: 2
 	};
 
 
@@ -72,9 +72,8 @@ sap.ui.define([
 	 */
 	XMLViewRenderer.render = function(rm, oControl) {
 		// write the HTML into the render manager
-		var vFragment,
-		 $oldContent = oControl._$oldContent = RenderManager.findPreservedContent(oControl.getId());
-
+		var aParsedContent = oControl._aParsedContent;
+		var $oldContent = oControl._$oldContent = RenderManager.findPreservedContent(oControl.getId());
 		if ( $oldContent.length === 0) {
 			// Log.debug("rendering " + oControl + " anew");
 			var bSubView = oControl.isSubView();
@@ -91,19 +90,17 @@ sap.ui.define([
 				rm.style("height", oControl.getHeight());
 				rm.openEnd();
 			}
-			if (oControl._aParsedContent) {
-				for (var i = 0; i < oControl._aParsedContent.length; i++) {
-					vFragment = oControl._aParsedContent[i];
-					if (vFragment && typeof (vFragment) === "string") {
-						// Due to the possibility of mixing (X)HTML and UI5 controls in the XML content,
-						// the XMLViewRenderer cannot be migrated fully to API version 2 yet.
-						// Here we need to pass the raw strings to the RenderManager as it was written in the *.view.xml.
-						rm.write(vFragment);
+			if (aParsedContent) {
+				for (var i = 0; i < aParsedContent.length; i++) {
+					var vRmInfo = aParsedContent[i];
+					// apply RenderManagerAPI calls which might have been recorded during XML processing for all encountered HTML elements in an XMLView
+					if (Array.isArray(vRmInfo)) {
+						rm[vRmInfo[0]].apply(rm, vRmInfo[1]);
 					} else {
-						rm.renderControl(vFragment);
-						// when the child control did not render anything (e.g. visible=false), we add a placeholder to know where to render the child later
-						if ( !vFragment.bOutput ) {
-							rm.openStart("div", PREFIX_DUMMY + vFragment.getId());
+						rm.renderControl(vRmInfo);
+						// when the child control did not render anything, we add a placeholder to know where to render the child later
+						if ( !vRmInfo.bOutput ) {
+							rm.openStart("div", PREFIX_DUMMY + vRmInfo.getId());
 							rm.class("sapUiHidden");
 							rm.openEnd();
 							rm.close("div");
@@ -124,10 +121,10 @@ sap.ui.define([
 			rm.openStart("div", PREFIX_TEMPORARY + oControl.getId());
 			rm.class("sapUiHidden");
 			rm.openEnd();
-			for (var k = 0; k < oControl._aParsedContent.length; k++) {
-				vFragment = oControl._aParsedContent[k];
-				if ( typeof (vFragment) !== "string") {
-
+			for (var i = 0; i < aParsedContent.length; i++) {
+				var vFragment = aParsedContent[i];
+				// if the parsed content does not have a corresponding _renderManagerAPICall, it's a control
+				if (!Array.isArray(vFragment)) {
 					// render DOM string for child control
 					rm.renderControl(vFragment);
 

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.94.0
+	 * @version 1.97.0
 	 * @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.94.0
+			 * @version 1.97.0
 			 * @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.94.0
+	 * @version 1.97.0
 	 * @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.94.0
+	 * @version 1.97.0
 	 * @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.94.0
+	 * @version 1.97.0
 	 *
 	 * @function
 	 * @param {string} sMessage - Dialog message

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

@@ -234,7 +234,16 @@ sap.ui.define([
 					// suspend the dynamic targets
 					if (this._oConfig.dynamicTarget) {
 						this._oRouter._oTargets.suspend(this._oConfig.dynamicTarget);
-						delete this._oConfig.dynamicTarget;
+					}
+				}
+			},
+
+			_resume: function() {
+				if (this._oRouter._oTargets) {
+					this._oRouter._oTargets.resume(this._oConfig.target);
+
+					if (this._oConfig.dynamicTarget) {
+						this._oRouter._oTargets.resume(this._oConfig.dynamicTarget);
 					}
 				}
 			},

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

@@ -435,10 +435,14 @@ sap.ui.define([
 				// shouldn't be processed.
 				this.oHashChanger.attachEvent("hashChanged", this.fnHashChanged);
 
-				// The HashChanger returns an InvalidHash when one of its ancestors is currently in
-				// the collect mode of preparing the next hash change. In this case, the Router should
-				// not be initialized and wait for the next 'hashChanged' event.
-				if (!bIgnoreInitialHash && sHash !== RouterHashChanger.InvalidHash) {
+				if (bIgnoreInitialHash) {
+					if (this._oMatchedRoute) {
+						this._oMatchedRoute._resume();
+					}
+				} else if (sHash !== RouterHashChanger.InvalidHash) {
+					// The HashChanger returns an InvalidHash when one of its ancestors is currently in
+					// the collect mode of preparing the next hash change. In this case, the Router should
+					// not parse the current hash and wait for the next 'hashChanged' event.
 					this.parse(sHash);
 				}
 
@@ -490,7 +494,6 @@ sap.ui.define([
 
 				if (this._oMatchedRoute) {
 					this._oMatchedRoute._routeSwitched();
-					this._oMatchedRoute = null;
 				}
 
 				this._bIsInitialized = false;
@@ -655,12 +658,19 @@ sap.ui.define([
 				}
 			},
 
+			/**
+			 * @typedef {Object} sap.ui.core.routing.RouteInfo
+			 * @property {string} name The route name
+			 * @property {Object.<string, string>} arguments The route data
+			 * @public
+			 */
+
 			/**
 			 * Returns a route info object containing the name and arguments of the route
 			 * which matches the given hash or <code>undefined</code>.
 			 *
 			 * @param {string} sHash The hash to be matched
-			 * @returns {object|undefined} An object containing the route <code>name</code> and the <code>arguments</code> or <code>undefined</code>
+			 * @returns {sap.ui.core.routing.RouteInfo|undefined} An object containing the route <code>name</code> and the <code>arguments</code> or <code>undefined</code>
 			 * @public
 			 * @since 1.75
 			 */

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

@@ -511,6 +511,32 @@ sap.ui.define([
 				return this;
 			},
 
+			/**
+			 * Resumes the targets which are specified by the parameter
+			 *
+			 * @param {string|string[]|object|object[]} vTargets The key of the target
+			 *  or an object which has the key of the target under property 'name' as
+			 *  specified in the {@link #constructor}. To suspend multiple targets you
+			 *  may also pass an array of keys or objects which have the key saved
+			 *  under the 'name' property
+			 * @return {sap.ui.core.routing.Targets} The 'this' for call chaining
+			 * @private
+			 */
+			resume : function (vTargets) {
+				var aTargetsInfo = this._alignTargetsInfo(vTargets);
+
+				aTargetsInfo.forEach(function(oTargetInfo) {
+					var sTargetName = oTargetInfo.name;
+					var oTarget = this.getTarget(sTargetName);
+
+					if (oTarget) {
+						oTarget.resume();
+					}
+				}.bind(this));
+
+				return this;
+			},
+
 			/**
 			 * Will be fired when a target is displayed.
 			 *

package/src/sap/ui/core/routing/async/Route.js

@@ -35,12 +35,15 @@ sap.ui.define(["sap/base/Log", "sap/base/util/extend", "sap/ui/core/Component"],
 				oTargetData,
 				oCurrentPromise,
 				aAlignedTargets,
-				bRepeated = false;
+				bRepeated = (oRouter._oMatchedRoute === this);
 
 			oRouter._stopWaitingTitleChangedFromChild();
-			if (oRouter._oMatchedRoute === this) {
-				bRepeated = true;
+
+			if (oRouter._oMatchedRoute) {
+				// clear the dynamicTarget of the previous matched route
+				delete oRouter._oMatchedRoute._oConfig.dynamicTarget;
 			}
+
 			oRouter._oMatchedRoute = this;
 			oRouter._bMatchingProcessStarted = true;
 

package/src/sap/ui/core/routing/async/Target.js

@@ -82,6 +82,32 @@ sap.ui.define([
 				Log.warning("The target with name '" + this._oOptions._name + "' can't be suspended because it's being loaded or not loaded yet");
 			}
 
+			return this;
+		},
+
+		/**
+		 * Resumes the object which is loaded by the target.
+		 *
+		 * Currently this function initializes the router of the component without parsing the current hash when
+		 * the object which is loaded by this target is an instance of
+		 * UIComponent.
+		 *
+		 * @return {sap.ui.core.routing.Target} The 'this' to chain the call
+		 * @private
+		 */
+		resume: function() {
+			if (this._oParent) {
+				this._oParent.resume();
+			}
+
+			if (this._isLoaded()) {
+				var oObject = this._get(),
+					oRouter;
+
+				if (oObject.isA("sap.ui.core.UIComponent") && (oRouter = oObject.getRouter()) && oObject.hasNativeRouter()) {
+					oRouter.initialize(true);
+				}
+			}
 
 			return this;
 		},
@@ -380,7 +406,7 @@ sap.ui.define([
 				bIsComponentTarget = oOptions.type === "Component",
 				bHasPlaceholderConfig = false,
 				oPlaceholderConfig = oTargetCreateInfo.placeholder || oOptions.placeholder || {},
-				pPlaceholder;
+				pPlaceholder = Promise.resolve();
 
 			if (Placeholder.hasProviders()) {
 				Object.assign(oPlaceholderConfig, Placeholder.getPlaceholderFromProviders({
@@ -452,13 +478,11 @@ sap.ui.define([
 					});
 				}
 
-				if (oPlaceholderConfig.placeholder) {
+				if (oPlaceholderConfig.placeholder && sap.ui.getCore().getConfiguration().getPlaceholder()) {
 					pPlaceholder = this.showPlaceholder(oPlaceholderConfig);
 				}
 			}
 
-			pPlaceholder = pPlaceholder || Promise.resolve();
-
 			// wait for placeholder to load
 			return pPlaceholder.then(function(sPlaceholderContent) {
 				// returning view info object

package/src/sap/ui/core/routing/sync/Target.js

@@ -50,6 +50,21 @@ sap.ui.define(["sap/base/Log"], function(Log) {
 			return this;
 		},
 
+		/**
+		 * Resumes the object which is loaded by the target.
+		 *
+		 * Currently this function doesn't do anything because the sync
+		 * version of the Target can only load Views but no Components.
+		 *
+		 * @return {sap.ui.core.routing.Target} The 'this' to chain the call
+		 * @private
+		 */
+		resume : function () {
+			// the sync target can only load view and not component
+			// therefore it's not needed to do anything in this function
+			return this;
+		},
+
 		/**
 		 * Places the target on the screen
 		 *

package/src/sap/ui/core/rules/Misc.support.js

@@ -106,8 +106,58 @@ sap.ui.define(["sap/ui/support/library", "./CoreHelper.support", "sap/ui/thirdpa
 		}
 	};
 
+	/**
+	 * Checks if the corresponding Component or Library of a Component is already loaded in case the Component is embeddedBy a resource.
+	 */
+	var oMissingEmbeddedByLibrary = {
+		id: "embeddedByLibNotLoaded",
+		audiences: [Audiences.Application],
+		categories: [Categories.Performance],
+		enabled: true,
+		minversion: "1.97",
+		title: "Embedding Component or Library not loaded",
+		description: "Checks if the corresponding Component or Library of a Component is already loaded in case the Component is embedded by a resource.",
+		resolution: "Before using a Component embedded by a Library or another Component, it's necessary to load the embedding Library or Component in advance. " +
+			"The 'sap.app/embeddedBy' property must be relative path inside the deployment unit (library or component).",
+		resolutionurls: [],
+		check: function(oIssueManager) {
+			var oRegisteredComponents = {}, sComponentName;
+			var filterComponents = function (sComponentName) {
+				return function (oComponent) {
+					return oComponent.getManifestObject().getEntry("/sap.app/id") === sComponentName;
+				};
+			};
+			var createIssue = function (oComponentWithMissingEmbeddedBy) {
+				return function (oComponent) {
+					oIssueManager.addIssue({
+						severity: Severity.High,
+						details: oComponentWithMissingEmbeddedBy.message,
+						context: {
+							id: oComponent.getId()
+						}
+					});
+				};
+			};
+
+			Log.getLogEntries().forEach(function(oLogEntry) {
+				var oRegexGetComponentName = /^Component '([a-zA-Z0-9\.]*)'.*$/;
+				if (oLogEntry.component === "sap.ui.core.Component#embeddedBy") {
+					oRegisteredComponents[oRegexGetComponentName.exec(oLogEntry.message)[1]] = oLogEntry;
+				}
+			});
+
+			for (sComponentName in oRegisteredComponents) {
+				if (Object.hasOwnProperty.call(oRegisteredComponents, sComponentName)) {
+					var aComponents = sap.ui.core.Component.registry.filter(filterComponents(sComponentName));
+					aComponents.forEach(createIssue(oRegisteredComponents[sComponentName]));
+				}
+			}
+		}
+	};
+
 	return [
 		oEventBusLogs,
-		oErrorLogs
+		oErrorLogs,
+		oMissingEmbeddedByLibrary
 	];
 }, true);

package/src/sap/ui/core/rules/Rendering.support.js

@@ -42,10 +42,7 @@ sap.ui.define([
 			var aControls = oScope.getElements().filter(function (oElement) { return oElement.isA("sap.ui.core.Control"); });
 
 			aControls.forEach(function (oControl) {
-				// The XMLView is excluded for now to not produce false-positive results
-				// Due to the possibility of mixing XHTML and UI5 content in the XML content,
-				// the XMLViewRenderer cannot be migrated fully to API version 2 yet.
-				if (RenderManager.getApiVersion(oControl.getRenderer()) < 2 && !oControl.isA("sap.ui.core.mvc.XMLView")) {
+				if (RenderManager.getApiVersion(oControl.getRenderer()) < 2) {
 					var sControlName = oControl.getMetadata().getName();
 
 					oIssueManager.addIssue({

package/src/sap/ui/core/rules/View.support.js

@@ -6,8 +6,8 @@
 /**
  * Defines support rules related to the view.
  */
-sap.ui.define(["sap/ui/support/library", "sap/ui/core/Element", "sap/ui/thirdparty/jquery", "sap/base/util/isEmptyObject", "sap/ui/base/DataType"],
-	function(SupportLib, Element, jQuery, isEmptyObject, DataType) {
+sap.ui.define(["sap/base/Log", "sap/ui/support/library", "sap/ui/core/Element", "sap/ui/thirdparty/jquery", "sap/base/util/isEmptyObject", "sap/ui/base/DataType"],
+	function(Log, SupportLib, Element, jQuery, isEmptyObject, DataType) {
 	"use strict";
 
 	// shortcuts
@@ -103,52 +103,20 @@ sap.ui.define(["sap/ui/support/library", "sap/ui/core/Element", "sap/ui/thirdpar
 		title: "Control tag in XML view starts with lower case",
 		description: "Control tags with lower case cannot be loaded in Linux-based systems",
 		resolution: "Start the Control tag with upper case",
-		resolutionurls: [],
+		resolutionurls: [{
+			text: "Documentation: SAPUI5 Control Development Guidelines",
+			href: "https://sapui5.hana.ondemand.com/#/topic/4549da61e2d949d6a3d20ad8a9d17a6f"
+		}],
 		check: function (oIssueManager, oCoreFacade, oScope) {
-
-			//get all aggregations of each element
-			var aAggregationsOfElements = oScope.getElements().map(
-					function (oElement) {
-						return Object.keys(oElement.getMetadata().getAllAggregations());
-					}
-			);
-			//flatten array of arrays and filter duplicates
-			var aAggregations = aAggregationsOfElements.reduce(
-				function(a, b) {
-					return a.concat(b);
-				}).filter(
-					function (x, i, a) {
-						return a.indexOf(x) === i;
-					});
-
-			var aXMLViews = oScope.getElements().filter(function (oControl) {
-				return oControl.getMetadata().getName() === "sap.ui.core.mvc.XMLView";
+			var aRelevantLogMessages = Log.getLogEntries().filter(function(oEntry) {
+				return oEntry.component === "sap.ui.core.XMLTemplateProcessor#lowerCase";
 			});
-
-			aXMLViews.forEach(function (oXMLView) {
-				var aLocalName = [];
-				var _getTags = function (oXcontent) {
-					aLocalName.push(oXcontent.localName);
-					for (var i = 0; i < oXcontent.children.length; i++) {
-						_getTags(oXcontent.children[i]);
-					}
-				};
-
-				_getTags(oXMLView._xContent);
-				aLocalName = jQuery.uniqueSort(aLocalName);
-
-				aLocalName.forEach(function (sTag) 	{
-					var sFirstLetter = sTag.charAt(0);
-					// check for lowercase, aggregations are excluded
-					if ((sFirstLetter.toLowerCase() === sFirstLetter) && !aAggregations.includes(sTag)) {
-						var sViewName = oXMLView.getViewName().split("\.").pop();
-						oIssueManager.addIssue({
-							severity: Severity.High,
-							details: "View '" + sViewName + "' (" + oXMLView.getId() + ") contains a Control tag that starts with lower case '" + sTag + "'",
-							context: {
-								id: oXMLView.getId()
-							}
-						});
+			aRelevantLogMessages.forEach(function(oMessage) {
+				oIssueManager.addIssue({
+					severity: Severity.High,
+					details: oMessage.message,
+					context: {
+						id: oMessage.details
 					}
 				});
 			});

package/src/sap/ui/core/search/OpenSearchProvider.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * @class
 	 * A SearchProvider which uses the OpenSearch protocol (either JSON or XML).
 	 * @extends sap.ui.core.search.SearchProvider
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.search.OpenSearchProvider

package/src/sap/ui/core/search/SearchProvider.js

@@ -23,7 +23,7 @@ sap.ui.define(['sap/ui/core/Element', "sap/base/Log", 'sap/ui/core/library'],
 	 *
 	 * Do not create instances of this class, but use a concrete subclass instead.
 	 * @extends sap.ui.core.Element
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.search.SearchProvider

package/src/sap/ui/core/service/Service.js

@@ -71,7 +71,7 @@ sap.ui.define(['sap/ui/base/Object', "sap/base/assert", "sap/base/Log"],
 	 *
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 * @alias sap.ui.core.service.Service
 	 * @abstract
 	 * @private

package/src/sap/ui/core/service/ServiceFactory.js

@@ -83,7 +83,7 @@ sap.ui.define(['sap/ui/base/Object', 'sap/ui/core/service/Service', "sap/base/as
 	 *
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 * @alias sap.ui.core.service.ServiceFactory
 	 * @private
 	 * @ui5-restricted sap.ushell

package/src/sap/ui/core/service/ServiceFactoryRegistry.js

@@ -18,7 +18,7 @@ sap.ui.define(['./ServiceFactory', "sap/base/assert"],
 	 * The service factory registry.
 	 *
 	 * @author SAP SE
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 * @alias sap.ui.core.service.ServiceFactoryRegistry
 	 * @private
 	 * @ui5-restricted sap.ushell

package/src/sap/ui/core/support/Plugin.js

@@ -17,7 +17,7 @@ sap.ui.define(['sap/ui/base/Object', "sap/ui/thirdparty/jquery", "sap/base/util/
 	 *
 	 * @abstract
 	 * @extends sap.ui.base.Object
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 * @private
 	 * @ui5-restricted
 	 * @alias sap.ui.core.support.Plugin
@@ -183,7 +183,7 @@ sap.ui.define(['sap/ui/base/Object', "sap/ui/thirdparty/jquery", "sap/base/util/
 	 *
 	 * A <link> tag will be added to the head of the HTML page, referring to the given
 	 * CSS resource. The URL of the resource is determined from the given resource name
-	 * by calling {@link jQuery.sap.getResourcePath}.
+	 * by calling {@link sap.ui.require.toUrl}.
 	 *
 	 * A plugin should call this method only when it is {@link #runsAsToolPlugin running inside the tool window}.
 	 *

package/src/sap/ui/core/support/RuleEngineOpaExtension.js

@@ -120,7 +120,6 @@ sap.ui.define([
 						metadata = options.metadata,
 						executionScope = options.executionScope;
 
-					// private API provided by jquery.sap.global
 					RuleAnalyzer.analyze(executionScope, rules || preset, metadata).then(function () {
 						var analysisHistory = RuleAnalyzer.getAnalysisHistory(),
 							lastAnalysis = { issues: [] };

package/src/sap/ui/core/support/Support.js

@@ -26,7 +26,7 @@ sap.ui.define(['sap/ui/base/EventProvider', './Plugin', "sap/base/util/UriParame
 	 * @class This class provides the support tool functionality of UI5. This class is internal and all its functions must not be used by an application.
 	 *
 	 * @extends sap.ui.base.EventProvider
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 * @private
 	 * @alias sap.ui.core.support.Support
 	 */

package/src/sap/ui/core/support/controls/TreeViewer.js

@@ -4,7 +4,7 @@
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([
-	'jquery.sap.global',
+	'sap/ui/thirdparty/jquery',
 	'sap/ui/base/ManagedObject',
 	"sap/base/security/encodeXML"
 ],