@openui5/sap.ui.core 1.106.0 → 1.107.1

package/src/sap/ui/core/Renderer.js

@@ -10,15 +10,16 @@ sap.ui.define([
 	"sap/base/util/isPlainObject",
 	"sap/base/util/ObjectPath",
 	"sap/base/assert",
-	"sap/base/util/extend"
-], function(Log, isPlainObject, ObjectPath, assert, extend) {
+	"sap/base/util/extend",
+	"sap/ui/core/Configuration"
+], function(Log, isPlainObject, ObjectPath, assert, extend, Configuration) {
 	"use strict";
 
 	/**
 	 * @classdesc Base Class for a Renderer.
 	 *
 	 * @author SAP SE
-	 * @version 1.106.0
+	 * @version 1.107.1
 	 * @namespace
 	 * @public
 	 * @alias sap.ui.core.Renderer
@@ -237,7 +238,7 @@ sap.ui.define([
 		var TextDirection = sapUiCore.TextDirection;
 
 		var sTextAlign = "",
-			bRTL = sap.ui.getCore().getConfiguration().getRTL();
+			bRTL = Configuration.getRTL();
 
 		switch (oTextAlign) {
 		case TextAlign.End:

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

@@ -0,0 +1,251 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+// Provides class sap.ui.core.Rendering
+sap.ui.define([
+	"sap/base/Log",
+	"sap/ui/base/EventProvider",
+	"sap/ui/performance/trace/Interaction",
+	"sap/ui/performance/Measurement"
+], function(
+	Log,
+	EventProvider,
+	Interaction,
+	Measurement
+) {
+	"use strict";
+
+	/**
+	 * A private logger instance used for 'debugRendering' logging.
+	 *
+	 * It can be activated by setting the URL parameter sap-ui-xx-debugRerendering to true.
+	 * If activated, stack traces of invalidate() calls will be recorded and if new
+	 * invalidations occur during rendering, they will be logged to the console together
+	 * with the causing stack traces.
+	 *
+	 * @private
+	 */
+	var oRenderLog = Log.getLogger("sap.ui.Rendering",
+			(
+				// Note that the sap-ui-config option still is expected in camel case.
+				// Lower case is only accepted here because of the config normalization which will be removed in future
+				(window["sap-ui-config"] && (window["sap-ui-config"]["xx-debugRendering"] || window["sap-ui-config"]["xx-debugrendering"]) )
+				|| /sap-ui-xx-debug(R|-r)endering=(true|x|X)/.test(document.location.search)
+			) ? Log.Level.DEBUG : Math.min(Log.Level.INFO, Log.getLevel())
+		);
+
+	var MAX_RENDERING_ITERATIONS = 20;
+
+	/**
+	 * The ID of a timer that will execute the next rendering.
+	 *
+	 * A non-falsy value indicates that a timer exists already, or at least that no
+	 * new timer needs to be created as. During the boot phase, this member is set
+	 * to the special value <code>this</code> which is non-falsy and which should never
+	 * represent a valid timer ID (no chance of misinterpretation).
+	 */
+	var _sRerenderTimer = this; //eslint-disable-line consistent-this
+
+	var mUIAreas = {};
+
+	/**
+	 * Tasks that are called just before the rendering starts.
+	 * @private
+	 */
+	var aPrerenderingTasks = [];
+
+	var _oEventProvider = new EventProvider();
+
+	var _bRendering = false;
+
+	function _renderPendingUIUpdates(sCaller) {
+		// start performance measurement
+		Measurement.start("renderPendingUIUpdates","Render pending UI updates in all UIAreas");
+
+		oRenderLog.debug("Render pending UI updates: start (" + (sCaller || "by timer" ) + ")");
+
+		var bUIUpdated = false,
+			bLooped = MAX_RENDERING_ITERATIONS > 0,
+			iLoopCount = 0;
+
+		_bRendering = true;
+
+		do {
+
+			if ( bLooped ) {
+				// try to detect long running ('endless') rendering loops
+				iLoopCount++;
+				// if we run another iteration despite the tracking mode, we complain ourselves
+				if ( iLoopCount > MAX_RENDERING_ITERATIONS ) {
+					_bRendering = false;
+					throw new Error("Rendering has been re-started too many times (" + iLoopCount + "). Add URL parameter sap-ui-xx-debugRendering=true for a detailed analysis.");
+				}
+
+				if ( iLoopCount > 1 ) {
+					oRenderLog.debug("Render pending UI updates: iteration " + iLoopCount);
+				}
+			}
+
+			// clear a pending timer so that the next call to re-render will create a new timer
+			if (_sRerenderTimer) {
+				if ( _sRerenderTimer !== this ) { // 'this' is used as a marker for a delayed initial rendering, no timer to cleanup then
+					clearTimeout(_sRerenderTimer); // explicitly stop the timer, as this call might be a synchronous call (applyChanges) while still a timer is running
+				}
+				_sRerenderTimer = undefined;
+				if (Rendering.aFnDone.length > 0) {
+					Rendering.aFnDone.pop()();
+				}
+			}
+
+			runPrerenderingTasks();
+
+			var mUIAreasSnapshot = mUIAreas;
+			mUIAreas = {};
+			for (var sId in mUIAreasSnapshot) {
+				bUIUpdated = mUIAreasSnapshot[sId].rerender() || bUIUpdated;
+			}
+
+		// eslint-disable-next-line no-unmodified-loop-condition
+		} while ( bLooped && _sRerenderTimer ); // iterate if there are new rendering tasks
+
+		_bRendering = false;
+
+		// TODO: Provide information on what actually was re-rendered...
+		if (bUIUpdated) {
+			Rendering.fireUIUpdated();
+		}
+
+		oRenderLog.debug("Render pending UI updates: finished");
+
+		// end performance measurement
+		Measurement.end("renderPendingUIUpdates");
+	}
+
+	var Rendering = {
+		// to protect against nested rendering we use an array of Steps instead of a single one
+		aFnDone: [],
+
+		/**
+		 * Notify async Interaction step.
+		 *
+		 * @private
+		 * @ui5-restricted sap.ui.core.Core
+		 */
+		notifyInteractionStep: function () {
+			Rendering.aFnDone.push(Interaction.notifyAsyncStep());
+		},
+
+		/**
+		 * Adds a task that is guaranteed to run once, just before the next rendering. A rendering
+		 * request is not triggered.
+		 *
+		 * @param {function} fnPrerenderingTask
+		 *   A function that is called before the rendering
+		 * @param {boolean} [bFirst=false]
+		 *   Whether the task should become the first one, not the last one
+		 * @private
+		 */
+		addPrerenderingTask: function (fnPrerenderingTask, bFirst) {
+			if (bFirst) {
+				aPrerenderingTasks.unshift(fnPrerenderingTask);
+			} else {
+				aPrerenderingTasks.push(fnPrerenderingTask);
+			}
+		},
+		/**
+		 * Asks all UIAreas to execute any pending rendering tasks.
+		 *
+		 * The execution of rendering tasks might require multiple iterations
+		 * until either no more rendering tasks are produced or until
+		 * MAX_RENDERING_ITERATIONS are reached.
+		 *
+		 * With a value of MAX_RENDERING_ITERATIONS=0 the loop can be avoided
+		 * and the remaining tasks are executed after another timeout.
+		 *
+		 * @param {string} sCaller The Caller id
+		 * @private
+		 */
+		renderPendingUIUpdates: function(sCaller, iTimeout) {
+			if (iTimeout !== undefined) {
+				_sRerenderTimer = setTimeout(_renderPendingUIUpdates.bind(null, sCaller), iTimeout);
+			} else {
+				Rendering.aFnDone.push(Interaction.notifyAsyncStep());
+				_renderPendingUIUpdates(sCaller);
+			}
+		},
+		/**
+		 * Returns <code>true</code> if there are any pending rendering tasks or when
+		 * such rendering tasks are currently being executed.
+		 *
+		 * @return {boolean} true if there are pending (or executing) rendering tasks.
+		 * @private
+		 */
+		getUIDirty: function() {
+			return !!(_sRerenderTimer || _bRendering);
+		},
+
+		/**
+		 * @name sap.ui.core.Core#UIUpdated
+		 * @event
+		 * @private
+		 * @function
+		 */
+
+		attachUIUpdated: function(fnFunction, oListener) {
+			_oEventProvider.attachEvent("UIUpdated", fnFunction, oListener);
+		},
+
+		detachUIUpdated: function(fnFunction, oListener) {
+			_oEventProvider.detachEvent("UIUpdated", fnFunction, oListener);
+		},
+
+		fireUIUpdated: function(mParameters) {
+			_oEventProvider.fireEvent("UIUpdated", mParameters);
+		},
+
+		/**
+		 * Returns the internal rendering Logger.
+		 *
+		 * @returns {sap.base.Log} The Rendering logger
+		 * @private
+		 */
+		getLogger: function() {
+			return oRenderLog;
+		},
+
+		/**
+		 * Registers an invalidated UIArea for rerendering.
+		 *
+		 * @param {sap.ui.core.UIArea} oUIArea The invalidated UIArea
+		 * @private
+		 */
+		invalidateUIArea: function(oUIArea) {
+			mUIAreas[oUIArea.getId()] = oUIArea;
+			if ( !_sRerenderTimer ) {
+				// TODO: we should handle xx-waitForTheme here...
+				oRenderLog.debug("Registering timer for delayed re-rendering");
+				// start async interaction step
+				Rendering.aFnDone.push(Interaction.notifyAsyncStep());
+				Rendering.renderPendingUIUpdates('invalidated UIArea', 0); // decoupled for collecting several invalidations into one redraw
+			}
+		}
+	};
+
+	/**
+	 * Runs all prerendering tasks and resets the list.
+	 * @private
+	 */
+	function runPrerenderingTasks() {
+		var aTasks = aPrerenderingTasks.slice();
+
+		aPrerenderingTasks = [];
+		aTasks.forEach(function (fnPrerenderingTask) {
+			fnPrerenderingTask();
+		});
+	}
+
+	return Rendering;
+});

package/src/sap/ui/core/ResizeHandler.js

@@ -33,7 +33,7 @@ sap.ui.define([
 	 * @alias sap.ui.core.ResizeHandler
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.106.0
+	 * @version 1.107.1
 	 * @public
 	 */
 

package/src/sap/ui/core/ScrollBar.js

@@ -13,7 +13,8 @@ sap.ui.define([
 	"sap/ui/performance/trace/Interaction",
 	"sap/base/Log",
 	"sap/ui/events/jquery/EventSimulation",
-	"sap/ui/thirdparty/jquery"
+	"sap/ui/thirdparty/jquery",
+	"sap/ui/core/Configuration"
 ],
 	function(
 		Device,
@@ -23,7 +24,8 @@ sap.ui.define([
 		Interaction,
 		Log,
 		EventSimulation,
-		jQuery
+		jQuery,
+		Configuration
 	) {
 	"use strict";
 
@@ -42,12 +44,11 @@ sap.ui.define([
 	 * The ScrollBar control can be used for virtual scrolling of a certain area.
 	 * This means: to simulate a very large scrollable area when technically the area is small and the control takes care of displaying the respective part only. E.g. a Table control can take care of only rendering the currently visible rows and use this ScrollBar control to make the user think he actually scrolls through a long list.
 	 * @extends sap.ui.core.Control
-	 * @version 1.106.0
+	 * @version 1.107.1
 	 *
 	 * @public
 	 * @deprecated as of version 1.56
 	 * @alias sap.ui.core.ScrollBar
-	 * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	var ScrollBar = Control.extend("sap.ui.core.ScrollBar", /** @lends sap.ui.core.ScrollBar.prototype */ {
 		metadata : {
@@ -146,7 +147,7 @@ sap.ui.define([
 		this._bScrollPosIsChecked = false;
 
 		// RTL mode
-		this._bRTL = sap.ui.getCore().getConfiguration().getRTL();
+		this._bRTL = Configuration.getRTL();
 
 		// suppress scroll event
 		this._bSuppressScroll = false;
@@ -523,7 +524,6 @@ sap.ui.define([
 	 * @param {string} oOwnerDomRef
 	 *         Dom ref of the Control that uses the scrollbar
 	 * @public
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	ScrollBar.prototype.unbind = function (oOwnerDomRef) {
 		if (oOwnerDomRef) {
@@ -547,7 +547,6 @@ sap.ui.define([
 	 * @param {string} oOwnerDomRef
 	 *         Dom ref of the control that uses the scrollbar
 	 * @public
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	ScrollBar.prototype.bind = function (oOwnerDomRef) {
 		if (oOwnerDomRef) {
@@ -581,7 +580,6 @@ sap.ui.define([
 	 * Page Up is used to scroll one page back.
 	 *
 	 * @public
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	ScrollBar.prototype.pageUp = function() {
 		// call on scroll
@@ -592,7 +590,6 @@ sap.ui.define([
 	 * Page Down is used to scroll one page forward.
 	 *
 	 * @public
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	ScrollBar.prototype.pageDown = function() {
 		// call on scroll

package/src/sap/ui/core/ScrollBarRenderer.js

@@ -5,8 +5,8 @@
  */
 
 // A renderer for the ScrollBar control
-sap.ui.define(['sap/ui/Device', "sap/ui/dom/getScrollbarSize"],
-	function(Device, getScrollbarSize) {
+sap.ui.define(['sap/ui/Device', "sap/ui/dom/getScrollbarSize", "sap/ui/core/Configuration"],
+	function(Device, getScrollbarSize, Configuration) {
 	"use strict";
 
 
@@ -27,7 +27,7 @@ sap.ui.define(['sap/ui/Device', "sap/ui/dom/getScrollbarSize"],
 	 * @param {sap.ui.core.ScrollBar} oControl Object representation of the control that should be rendered
 	 */
 	ScrollBarRenderer.render = function(oRM, oScrollBar){
-		var bRTL = sap.ui.getCore().getConfiguration().getRTL();
+		var bRTL = Configuration.getRTL();
 
 		oRM.openStart("div", oScrollBar);
 		oRM.class("sapUiScrollBar");

package/src/sap/ui/core/SeparatorItem.js

@@ -23,11 +23,10 @@ sap.ui.define(['./Item', './library'],
 	 * @extends sap.ui.core.Item
 	 *
 	 * @author SAP SE
-	 * @version 1.106.0
+	 * @version 1.107.1
 	 *
 	 * @public
 	 * @alias sap.ui.core.SeparatorItem
-	 * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	var SeparatorItem = Item.extend("sap.ui.core.SeparatorItem", /** @lends sap.ui.core.SeparatorItem.prototype */ { metadata : {
 

package/src/sap/ui/core/Title.js

@@ -25,12 +25,11 @@ sap.ui.define(['./Element', './library'],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.106.0
+	 * @version 1.107.1
 	 *
 	 * @public
 	 * @since 1.16.0
 	 * @alias sap.ui.core.Title
-	 * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	var Title = Element.extend("sap.ui.core.Title", /** @lends sap.ui.core.Title.prototype */ { metadata : {
 

package/src/sap/ui/core/TooltipBase.js

@@ -30,11 +30,10 @@ sap.ui.define([
 	 * @class
 	 * Abstract class that can be extended in order to implement any extended tooltip. For example, RichTooltip Control is based on it. It provides the opening/closing behavior and the main "text" property.
 	 * @extends sap.ui.core.Control
-	 * @version 1.106.0
+	 * @version 1.107.1
 	 *
 	 * @public
 	 * @alias sap.ui.core.TooltipBase
-	 * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	var TooltipBase = Control.extend("sap.ui.core.TooltipBase", /** @lends sap.ui.core.TooltipBase.prototype */ {
 		metadata : {