@openui5/sap.ui.core 1.120.0 → 1.120.2

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

@@ -41,7 +41,7 @@ sap.ui.define([
 ) {
 	"use strict";
 
-	var oVersion = new Version("1.120.0");
+	var oVersion = new Version("1.120.2");
 	var oFormatSettings;
 
 	// Lazy dependency to core
@@ -223,8 +223,7 @@ sap.ui.define([
 		 *     bindings in existing Elements, Controls, UIAreas or Components</li>
 		 * <li>ResourceModels currently assigned to the Core, a UIArea, Component,
 		 *     Element or Control</li>
-		 * <li>Elements or Controls that implement the <code>onlocalizationChanged</code> hook
-		 *     (note the lowercase 'l' in onlocalizationChanged)</li>
+		 * <li>Elements or Controls that implement the <code>onLocalizationChanged</code> hook</li>
 		 * </ul>
 		 *
 		 * It furthermore derives the RTL mode from the new language, if no explicit RTL
@@ -1061,8 +1060,8 @@ sap.ui.define([
 	 * @borrows module:sap/base/i18n/Formatting.getLegacyDateFormat as #getLegacyDateFormat
 	 * @borrows module:sap/base/i18n/Formatting.getLegacyTimeFormat as #getLegacyTimeFormat
 	 * @borrows module:sap/base/i18n/Formatting.getLegacyNumberFormat as #getLegacyNumberFormat
-	 * @borrows module:sap/base/i18n/Formatting.getLegacyDateCalendarCustomizing as #getLegacyDateCalendarCustomizing
-	 * @borrows module:sap/base/i18n/Formatting.setLegacyDateCalendarCustomizing as #setLegacyDateCalendarCustomizing
+	 * @borrows module:sap/base/i18n/Formatting.getCustomIslamicCalendarData as #getLegacyDateCalendarCustomizing
+	 * @borrows module:sap/base/i18n/Formatting.setCustomIslamicCalendarData as #setLegacyDateCalendarCustomizing
 	 * @borrows module:sap/base/i18n/Formatting.getTrailingCurrencyCode as #getTrailingCurrencyCode
 	 * @borrows module:sap/base/i18n/Formatting.setTrailingCurrencyCode as #setTrailingCurrencyCode
 	 * @borrows module:sap/base/i18n/Formatting.getCustomLocaleData as #getCustomLocaleData
@@ -1314,11 +1313,11 @@ sap.ui.define([
 		},
 
 		setLegacyDateCalendarCustomizing : function() {
-			Formatting.setLegacyDateCalendarCustomizing.apply(Formatting, arguments);
+			Formatting.setCustomIslamicCalendarData.apply(Formatting, arguments);
 			return this;
 		},
 
-		getLegacyDateCalendarCustomizing : Formatting.getLegacyDateCalendarCustomizing,
+		getLegacyDateCalendarCustomizing : Formatting.getCustomIslamicCalendarData,
 
 		setTrailingCurrencyCode : function() {
 			Formatting.setTrailingCurrencyCode.apply(Formatting, arguments);
@@ -1350,6 +1349,9 @@ sap.ui.define([
 			if (["ABAPDateFormat", "ABAPTimeFormat", "ABAPNumberFormat"].includes(sName)) {
 				mParameters[sName.replace("ABAP", "legacy")] = mParameters[sName];
 				delete mParameters[sName];
+			} else if (sName === 'customIslamicCalendarData') {
+				mParameters['legacyDateCalendarCustomizing'] = mParameters[sName];
+				delete mParameters[sName];
 			}
 		});
 		if (!mChanges && Core) {

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

@@ -9,6 +9,7 @@ sap.ui.define([
 	'./CustomStyleClassSupport',
 	'./Core',
 	'./Element',
+	'./ElementRegistry',
 	'./UIArea',
 	'./StaticArea',
 	'./RenderManager',
@@ -22,6 +23,7 @@ sap.ui.define([
 		CustomStyleClassSupport,
 		Core,
 		Element,
+		ElementRegistry,
 		UIArea,
 		StaticArea,
 		RenderManager,
@@ -81,7 +83,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Element
 	 * @abstract
 	 * @author SAP SE
-	 * @version 1.120.0
+	 * @version 1.120.2
 	 * @alias sap.ui.core.Control
 	 */
 	var Control = Element.extend("sap.ui.core.Control", /** @lends sap.ui.core.Control.prototype */ {
@@ -662,7 +664,7 @@ sap.ui.define([
 
 			if (oContainer instanceof Element) {
 				if (!isSuitableAsContainer(oContainer)) {
-					Log.warning("placeAt cannot be processed because container " + oContainer + " does not have an aggregation 'content'.");
+					Log.warning("[FUTURE FATAL] placeAt cannot be processed because container " + oContainer + " does not have an aggregation 'content'.");
 					return this;
 				}
 			} else {
@@ -691,7 +693,7 @@ sap.ui.define([
 						oContainer.addContent(this);
 						break;
 					default:
-						Log.warning("Position " + vPosition + " is not supported for function placeAt.");
+						Log.warning("[FUTURE FATAL] Position " + vPosition + " is not supported for function placeAt.");
 				}
 			}
 		}.bind(this));
@@ -1269,7 +1271,7 @@ sap.ui.define([
 	 * @public
 	 */
 	Control.getControlsByFieldGroupId = function(vFieldGroupIds) {
-		return Element.registry.filter((oElement) => {
+		return ElementRegistry.filter((oElement) => {
 			return oElement.isA("sap.ui.core.Control") && oElement.checkFieldGroupIds(vFieldGroupIds);
 		});
 	};

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

@@ -11,6 +11,7 @@ sap.ui.define([
 	"./Configuration",
 	"./ControlBehavior",
 	"./Element",
+	"./ElementRegistry",
 	"./ElementMetadata",
 	"./Lib",
 	"./Rendering",
@@ -25,7 +26,6 @@ sap.ui.define([
 	"sap/base/Event",
 	"sap/base/Log",
 	"sap/base/util/Deferred",
-	"sap/base/util/each",
 	"sap/base/util/isEmptyObject",
 	"sap/base/util/ObjectPath",
 	"sap/base/util/Version",
@@ -37,6 +37,7 @@ sap.ui.define([
 	"sap/ui/base/Object",
 	"sap/ui/base/syncXHRFix",
 	"sap/ui/core/support/Hotkeys",
+	"sap/ui/core/util/_LocalizationHelper",
 	"sap/ui/dom/getComputedStyleFix",
 	"sap/ui/performance/Measurement",
 	"sap/ui/performance/trace/initTraces",
@@ -56,6 +57,7 @@ sap.ui.define([
 		Configuration,
 		ControlBehavior,
 		Element,
+		ElementRegistry,
 		ElementMetadata,
 		Library,
 		Rendering,
@@ -70,7 +72,6 @@ sap.ui.define([
 		BaseEvent,
 		Log,
 		Deferred,
-		each,
 		isEmptyObject,
 		ObjectPath,
 		Version,
@@ -82,6 +83,7 @@ sap.ui.define([
 		BaseObject,
 		syncXHRFix,
 		Hotkeys,
+		_LocalizationHelper,
 		getComputedStyleFix,
 		Measurement,
 		initTraces,
@@ -358,7 +360,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.Object
 	 * @final
 	 * @author SAP SE
-	 * @version 1.120.0
+	 * @version 1.120.2
 	 * @alias sap.ui.core.Core
 	 * @public
 	 * @hideconstructor
@@ -427,8 +429,8 @@ sap.ui.define([
 
 			Object.defineProperty(this, "mElements", {
 				get: function() {
-					Log.error("oCore.mElements was a private member and has been removed. Use one of the methods in sap.ui.core.Element.registry instead");
-					return Element.registry.all(); // this is a very costly snapshot!
+					Log.error("oCore.mElements was a private member and has been removed. Use one of the methods in sap.ui.core.ElementRegistry instead");
+					return ElementRegistry.all(); // this is a very costly snapshot!
 				},
 				configurable: false
 			});
@@ -495,7 +497,7 @@ sap.ui.define([
 			const paths = {};
 			const oResourceRoots = BaseConfig.get({
 				name: "sapUiResourceRoots",
-				type: BaseConfig.Type.Object
+				type: BaseConfig.Type.MergedObject
 			}) ?? {};
 			for (const n in oResourceRoots) {
 				paths[ui5ToRJS(n)] = oResourceRoots[n] || ".";
@@ -620,7 +622,14 @@ sap.ui.define([
 
 			Log.info("Declared libraries: " + this.aLibs, METHOD);
 
-			this._setupContentDirection();
+			_LocalizationHelper.init();
+
+			/**
+			 * @deprecated As of Version 1.120
+			 */
+			_LocalizationHelper.registerForUpdate("Core", () => {
+				return {"Core": this};
+			});
 
 			this._setupBrowser();
 
@@ -630,6 +639,7 @@ sap.ui.define([
 
 			this._setupAnimation();
 
+
 			// create accessor to the Core API early so that initLibrary and others can use it
 			/**
 			 * Retrieve the {@link sap.ui.core.Core SAPUI5 Core} instance for the current window.
@@ -919,18 +929,6 @@ sap.ui.define([
 		};
 	};
 
-	/**
-	 * Set the document's dir property
-	 * @private
-	 */
-	Core.prototype._setupContentDirection = function() {
-		var METHOD = "sap.ui.core.Core",
-			sDir = Configuration.getRTL() ? "rtl" : "ltr";
-
-		document.documentElement.setAttribute("dir", sDir); // webkit does not allow setting document.dir before the body exists
-		Log.info("Content direction set to '" + sDir + "'",null,METHOD);
-	};
-
 	/**
 	 * Set the body's browser-related attributes.
 	 * @private
@@ -2198,61 +2196,11 @@ sap.ui.define([
 
 	/**
 	 * @private
+	 * @deprecated As of Version 1.120
 	 */
 	Core.prototype.fireLocalizationChanged = function(mChanges) {
-		var sEventId = Core.M_EVENTS.LocalizationChanged,
-			oBrowserEvent = jQuery.Event(sEventId, {changes : mChanges}),
-			fnAdapt = ManagedObject._handleLocalizationChange;
-
-		Log.info("localization settings changed: " + Object.keys(mChanges).join(","), null, "sap.ui.core.Core");
-
-		/*
-		 * Notify models that are able to handle a localization change
-		 */
-		each(this.oModels, function (prop, oModel) {
-			if (oModel && oModel._handleLocalizationChange) {
-				oModel._handleLocalizationChange();
-			}
-		});
-
-		/*
-		 * Notify all UIAreas, Components, Elements to first update their models (phase 1)
-		 * and then to update their bindings and corresponding data types (phase 2)
-		 */
-		function notifyAll(iPhase) {
-			UIArea.registry.forEach(function(oUIArea) {
-				fnAdapt.call(oUIArea, iPhase);
-			});
-			Component.registry.forEach(function(oComponent) {
-				fnAdapt.call(oComponent, iPhase);
-			});
-			Element.registry.forEach(function(oElement) {
-				fnAdapt.call(oElement, iPhase);
-			});
-		}
-
-		notifyAll.call(this,1);
-		notifyAll.call(this,2);
-
-		// special handling for changes of the RTL mode
-		if ( mChanges.rtl != undefined ) {
-			// update the dir attribute of the document
-			document.documentElement.setAttribute("dir", mChanges.rtl ? "rtl" : "ltr");
-
-			// invalidate all UIAreas
-			UIArea.registry.forEach(function(oUIArea) {
-				oUIArea.invalidate();
-			});
-			Log.info("RTL mode " + mChanges.rtl ? "activated" : "deactivated");
-		}
-
-		// notify Elements via a pseudo browser event (onlocalizationChanged, note the lower case 'l')
-		Element.registry.forEach(function(oElement) {
-			oElement._handleEvent(oBrowserEvent);
-		});
-
 		// notify registered Core listeners
-		_oEventProvider.fireEvent(sEventId, {changes : mChanges});
+		_oEventProvider.fireEvent(Core.M_EVENTS.LocalizationChanged, {changes : mChanges});
 	};
 
 	/**

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

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * in the documentation.
 	 *
 	 * @extends sap.ui.core.Element
-	 * @version 1.120.0
+	 * @version 1.120.2
 	 *
 	 * @public
 	 * @alias sap.ui.core.CustomData

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

@@ -40,7 +40,7 @@ sap.ui.define([
 	 * @class Static class for enabling declarative UI support.
 	 *
 	 * @author Peter Muessig, Tino Butz
-	 * @version 1.120.0
+	 * @version 1.120.2
 	 * @since 1.7.0
 	 * @public
 	 * @alias sap.ui.core.DeclarativeSupport

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

@@ -9,7 +9,6 @@ sap.ui.define([
 	'../base/DataType',
 	'../base/Object',
 	'../base/ManagedObject',
-	'../base/ManagedObjectRegistry',
 	'./ElementMetadata',
 	'../Device',
 	"sap/ui/performance/trace/Interaction",
@@ -20,13 +19,14 @@ sap.ui.define([
 	"./RenderManager",
 	"./Configuration",
 	"./EnabledPropagator",
-	"./Theming"
+	"./ElementRegistry",
+	"./Theming",
+	"sap/ui/core/util/_LocalizationHelper"
 ],
 	function(
 		DataType,
 		BaseObject,
 		ManagedObject,
-		ManagedObjectRegistry,
 		ElementMetadata,
 		Device,
 		Interaction,
@@ -37,7 +37,9 @@ sap.ui.define([
 		RenderManager,
 		Configuration,
 		EnabledPropagator,
-		Theming
+		ElementRegistry,
+		Theming,
+		_LocalizationHelper
 	) {
 	"use strict";
 
@@ -132,7 +134,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.120.0
+	 * @version 1.120.2
 	 * @public
 	 * @alias sap.ui.core.Element
 	 */
@@ -210,27 +212,7 @@ sap.ui.define([
 
 	}, /* Metadata constructor */ ElementMetadata);
 
-	// apply the registry mixin
-	ManagedObjectRegistry.apply(Element, {
-		onDuplicate: function(sId, oldElement, newElement) {
-			if ( oldElement._sapui_candidateForDestroy ) {
-				Log.debug("destroying dangling template " + oldElement + " when creating new object with same ID");
-				oldElement.destroy();
-			} else {
-				var sMsg = "adding element with duplicate id '" + sId + "'";
-				/**
-				 * duplicate ID detected => fail or at least log a warning
-				 * @deprecated As of Version 1.120.
-				 */
-				if (!Configuration.getNoDuplicateIds()) {
-					Log.warning(sMsg);
-					return;
-				}
-				Log.error(sMsg);
-				throw new Error("Error: " + sMsg);
-			}
-		}
-	});
+	ElementRegistry.init(Element);
 
 	/**
 	 * Creates metadata for a UI Element by extending the Object Metadata.
@@ -566,6 +548,14 @@ sap.ui.define([
 	/**
 	 * This triggers immediate rerendering of its parent and thus of itself and its children.
 	 *
+	 * @deprecated As of 1.70, using this method is no longer recommended, but still works. Synchronous DOM
+	 *   updates via this method have several drawbacks: they only work when the control has been rendered
+	 *   before (no initial rendering possible), multiple state changes won't be combined automatically into
+	 *   a single re-rendering, they might cause additional layout trashing, standard invalidation might
+	 *   cause another async re-rendering.
+	 *
+	 *   The recommended alternative is to rely on invalidation and standard re-rendering.
+	 *
 	 * As <code>sap.ui.core.Element</code> "bubbles up" the rerender, changes to
 	 * child-<code>Elements</code> will also result in immediate rerendering of the whole sub tree.
 	 * @protected
@@ -576,7 +566,6 @@ sap.ui.define([
 		}
 	};
 
-
 	/**
 	 * Returns the UI area of this element, if any.
 	 *
@@ -1259,7 +1248,7 @@ sap.ui.define([
 		var value = this.getValue();
 
 		function error(reason) {
-			Log.error("CustomData with key " + key + " should be written to HTML of " + oRelated + " but " + reason);
+			Log.error("[FUTURE FATAL] CustomData with key " + key + " should be written to HTML of " + oRelated + " but " + reason);
 			return null;
 		}
 
@@ -1483,7 +1472,7 @@ sap.ui.define([
 		var argLength = arguments.length;
 		if ( argLength === 1 && arguments[0] !== null && typeof arguments[0] == "object"
 			 || argLength > 1 && argLength < 4 && arguments[1] !== null ) {
-			Log.error("Cannot create custom data on an already destroyed element '" + this + "'");
+			Log.error("[FUTURE FATAL] Cannot create custom data on an already destroyed element '" + this + "'");
 			return this;
 		}
 		return Element.prototype.data.apply(this, arguments);
@@ -1891,7 +1880,7 @@ sap.ui.define([
 			oDomRef = vParam;
 		} else if (vParam.jquery) {
 			oDomRef = vParam[0];
-			Log.error("[FUTURE] Do not call Element.closestTo() with jQuery object as parameter. \
+			Log.error("[FUTURE FATAL] Do not call Element.closestTo() with jQuery object as parameter. \
 				The function should be called with either a DOM Element or a CSS selector. \
 				(future error, ignored for now)");
 		} else {
@@ -1931,7 +1920,7 @@ sap.ui.define([
 	 * @function
 	 * @since 1.119
 	 */
-	Element.getElementById = Element.registry.get;
+	Element.getElementById = ElementRegistry.get;
 
 	/**
 	 * Returns the element currently in focus.
@@ -1957,127 +1946,26 @@ sap.ui.define([
 	 * @namespace sap.ui.core.Element.registry
 	 * @public
 	 * @since 1.67
+	 * @deprecated As of version 1.120. Use {@link module:sap/ui/core/ElementRegistry} instead.
+	 * @borrows module:sap/ui/core/ElementRegistry.size as size
+	 * @borrows module:sap/ui/core/ElementRegistry.all as all
+	 * @borrows module:sap/ui/core/ElementRegistry.get as get
+	 * @borrows module:sap/ui/core/ElementRegistry.forEach as forEach
+	 * @borrows module:sap/ui/core/ElementRegistry.filter as filter
 	 */
-
-	/**
-	 * Number of existing elements.
-	 *
-	 * @type {int}
-	 * @readonly
-	 * @name sap.ui.core.Element.registry.size
-	 * @public
-	 */
-
-	/**
-	 * Return an object with all instances of <code>sap.ui.core.Element</code>,
-	 * keyed by their ID.
-	 *
-	 * Each call creates a new snapshot object. Depending on the size of the UI,
-	 * this operation therefore might be expensive. Consider to use the <code>forEach</code>
-	 * or <code>filter</code> method instead of executing similar operations on the returned
-	 * object.
-	 *
-	 * <b>Note</b>: The returned object is created by a call to <code>Object.create(null)</code>,
-	 * and therefore lacks all methods of <code>Object.prototype</code>, e.g. <code>toString</code> etc.
-	 *
-	 * @returns {Object<sap.ui.core.ID,sap.ui.core.Element>} Object with all elements, keyed by their ID
-	 * @name sap.ui.core.Element.registry.all
-	 * @function
-	 * @public
-	 */
-
-	/**
-	 * Retrieves an Element by its ID.
-	 *
-	 * When the ID is <code>null</code> or <code>undefined</code> or when there's no element with
-	 * the given ID, then <code>undefined</code> is returned.
-	 *
-	 * @param {sap.ui.core.ID} id ID of the element to retrieve
-	 * @returns {sap.ui.core.Element|undefined} Element with the given ID or <code>undefined</code>
-	 * @name sap.ui.core.Element.getElementById
-	 * @function
-	 * @public
-	 */
-
-	/**
-	 * Calls the given <code>callback</code> for each element.
-	 *
-	 * The expected signature of the callback is
-	 * <pre>
-	 *    function callback(oElement, sID)
-	 * </pre>
-	 * where <code>oElement</code> is the currently visited element instance and <code>sID</code>
-	 * is the ID of that instance.
-	 *
-	 * The order in which the callback is called for elements is not specified and might change between
-	 * calls (over time and across different versions of UI5).
-	 *
-	 * If elements are created or destroyed within the <code>callback</code>, then the behavior is
-	 * not specified. Newly added objects might or might not be visited. When an element is destroyed during
-	 * the filtering and was not visited yet, it might or might not be visited. As the behavior for such
-	 * concurrent modifications is not specified, it may change in newer releases.
-	 *
-	 * If a <code>thisArg</code> is given, it will be provided as <code>this</code> context when calling
-	 * <code>callback</code>. The <code>this</code> value that the implementation of <code>callback</code>
-	 * sees, depends on the usual resolution mechanism. E.g. when <code>callback</code> was bound to some
-	 * context object, that object wins over the given <code>thisArg</code>.
-	 *
-	 * @param {function(sap.ui.core.Element,sap.ui.core.ID)} callback
-	 *        Function to call for each element
-	 * @param {Object} [thisArg=undefined]
-	 *        Context object to provide as <code>this</code> in each call of <code>callback</code>
-	 * @throws {TypeError} If <code>callback</code> is not a function
-	 * @name sap.ui.core.Element.registry.forEach
-	 * @function
-	 * @public
-	 */
-
-	/**
-	 * Returns an array with elements for which the given <code>callback</code> returns a value that coerces
-	 * to <code>true</code>.
-	 *
-	 * The expected signature of the callback is
-	 * <pre>
-	 *    function callback(oElement, sID)
-	 * </pre>
-	 * where <code>oElement</code> is the currently visited element instance and <code>sID</code>
-	 * is the ID of that instance.
-	 *
-	 * If elements are created or destroyed within the <code>callback</code>, then the behavior is
-	 * not specified. Newly added objects might or might not be visited. When an element is destroyed during
-	 * the filtering and was not visited yet, it might or might not be visited. As the behavior for such
-	 * concurrent modifications is not specified, it may change in newer releases.
-	 *
-	 * If a <code>thisArg</code> is given, it will be provided as <code>this</code> context when calling
-	 * <code>callback</code>. The <code>this</code> value that the implementation of <code>callback</code>
-	 * sees, depends on the usual resolution mechanism. E.g. when <code>callback</code> was bound to some
-	 * context object, that object wins over the given <code>thisArg</code>.
-	 *
-	 * This function returns an array with all elements matching the given predicate. The order of the
-	 * elements in the array is not specified and might change between calls (over time and across different
-	 * versions of UI5).
-	 *
-	 * @param {function(sap.ui.core.Element,sap.ui.core.ID):boolean} callback
-	 *        predicate against which each element is tested
-	 * @param {Object} [thisArg=undefined]
-	 *        context object to provide as <code>this</code> in each call of <code>callback</code>
-	 * @returns {sap.ui.core.Element[]}
-	 *        Array of elements matching the predicate; order is undefined and might change in newer versions of UI5
-	 * @throws {TypeError} If <code>callback</code> is not a function
-	 * @name sap.ui.core.Element.registry.filter
-	 * @function
-	 * @public
-	 */
+	Element.registry = ElementRegistry;
 
 	Theming.attachApplied(function(oEvent) {
 		// notify all elements/controls via a pseudo browser event
 		var oJQueryEvent = jQuery.Event("ThemeChanged");
 		oJQueryEvent.theme = oEvent.theme;
-		Element.registry.forEach(function(oElement) {
+		ElementRegistry.forEach(function(oElement) {
 			oElement._handleEvent(oJQueryEvent);
 		});
 	});
 
+	_LocalizationHelper.registerForUpdate("Elements", ElementRegistry.all);
+
 	return Element;
 
 });

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

@@ -36,7 +36,7 @@ sap.ui.define([
 	 *
 	 * @class
 	 * @author SAP SE
-	 * @version 1.120.0
+	 * @version 1.120.2
 	 * @since 0.8.6
 	 * @alias sap.ui.core.ElementMetadata
 	 * @extends sap.ui.base.ManagedObjectMetadata