@openui5/sap.ui.core 1.117.1 → 1.119.0

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

@@ -44,7 +44,7 @@ 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.117.1
+	 * @version 1.119.0
 	 *
 	 * @public
 	 * @deprecated as of version 1.56

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

@@ -23,7 +23,7 @@ sap.ui.define(['./Item', './library'],
 	 * @extends sap.ui.core.Item
 	 *
 	 * @author SAP SE
-	 * @version 1.117.1
+	 * @version 1.119.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.SeparatorItem

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

@@ -49,7 +49,7 @@ sap.ui.define([
 		};
 
 		ShortcutHint.prototype._getShortcutHintFromMessageBundle = function(oControl, sMessageBundleKey) {
-			var oResourceBundle = Library.get(oControl.getMetadata().getLibraryName()).getResourceBundle();
+			var oResourceBundle = Library.getResourceBundleFor(oControl.getMetadata().getLibraryName());
 
 			return oResourceBundle.getText(sMessageBundleKey);
 		};

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

@@ -95,7 +95,7 @@ sap.ui.define([
 		var oControl;
 
 		for (var sControlId in oHintRegistry.mControls) {
-			oControl = Element.registry.get(sControlId);
+			oControl = Element.getElementById(sControlId);
 
 			if (oControl) {
 				oControl._shortcutHintsMixin.hideShortcutHint();
@@ -126,7 +126,7 @@ sap.ui.define([
 		var oControl;
 
 		if (!ShortcutHintsMixin.isControlRegistered(this.sControlId)) {
-			oControl = Element.registry.get(this.sControlId);
+			oControl = Element.getElementById(this.sControlId);
 			oControl.addEventDelegate(oHintsEventDelegate, this);
 		}
 	};
@@ -139,7 +139,7 @@ sap.ui.define([
 		this._attachToEvents();
 
 		if (!ShortcutHintsMixin.isControlRegistered(this.sControlId)) {
-			var oControl = Element.registry.get(this.sControlId);
+			var oControl = Element.getElementById(this.sControlId);
 
 			oControl._originalExit = oControl.exit;
 			oControl.exit = function() {
@@ -353,7 +353,7 @@ sap.ui.define([
 	 */
 	ShortcutHintsMixin.prototype._getControlTooltips = function() {
 		var aInfos = this.getRegisteredShortcutInfos(),
-			oControl = Element.registry.get(this.sControlId);
+			oControl = Element.getElementById(this.sControlId);
 
 		return aInfos.reduce(function(mResult, oHintInfo) {
 			var sTooltip = oControl._getTitleAttribute && oControl._getTitleAttribute(oHintInfo.id);
@@ -386,7 +386,7 @@ sap.ui.define([
 			return;
 		}
 
-		oControl = Element.registry.get(this.sControlId);
+		oControl = Element.getElementById(this.sControlId);
 
 		if (!oControl.getAriaDescribedBy) {
 			return;

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

@@ -5,8 +5,8 @@
  */
 
 // Provides inactive support for controls
-sap.ui.define(["sap/base/assert"],
-	function(assert) {
+sap.ui.define(["sap/base/assert", "sap/ui/core/Element"],
+	function(assert, Element) {
 		"use strict";
 
 		/**
@@ -15,7 +15,7 @@ sap.ui.define(["sap/base/assert"],
 		 * NOTE: stashingh of <code>sap.ui.core.Fragments</code> and <code>sap.ui.core.mvc.View</code> is not supported!
 		 *
 		 * <code>stashed</code> Controls are created as placeholder control without any content and bindings
-		 * and added to the Control tree. That means it is available with <code>sap.ui.getCore().byId</code>
+		 * and added to the Control tree. That means it is available with <code>Element.getElementById</code>
 		 * and as child in the parents aggregation. It is unstashable by calling <code>unstash</code>.
 		 * Currently this is a one-time operation. Once unstashed, a control cannot be re-stashed again.
 		 *
@@ -131,7 +131,7 @@ sap.ui.define(["sap/base/assert"],
 			var aStashedChildren = [];
 			for (var sId in stashedControls) {
 				// get placeholder for stashed-control
-				var oPlaceholder = sap.ui.getCore().byId(stashedControls[sId].wrapperId);
+				var oPlaceholder = Element.getElementById(stashedControls[sId].wrapperId);
 				var vInstanceOrId = bAsInstance ? oPlaceholder : sId;
 				// A stashed-control without a placeholder can happen if the placeholder was already destroyed.
 				// In this case we also don't have a parent.

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

@@ -4,25 +4,24 @@
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([
-	"sap/base/assert",
-	"./Configuration",
+	"sap/base/i18n/Localization",
 	"./UIArea",
 	"sap/ui/dom/_ready"
-],
-	function(
-		assert,
-		Configuration,
-		UIArea,
-		_ready
-	) {
+], (
+	Localization,
+	UIArea,
+	_ready
+) => {
 	"use strict";
 
+	let oStaticArea;
+
 	/**
 	 * Whether the DOM is ready (document.ready)
 	 */
-	var bDomReady = false;
+	let bDomReady = false;
 
-	_ready().then(function() {
+	_ready().then(() => {
 		bDomReady = true;
 	});
 
@@ -35,39 +34,62 @@ sap.ui.define([
 	 *
 	 * All methods throw an <code>Error</code> when they are called before the document is ready.
 	 *
-	 * @private
-	 * @ui5-restricted SAPUI5 Dist
-	 * @alias module:sap/ui/core/StaticArea
 	 * @namespace
+	 * @alias module:sap/ui/core/StaticArea
+	 * @public
 	 */
-	var StaticArea = {};
-
-	/**
-	 * The unique ID of the static area.
-	 *
-	 * @private
-	 * @ui5-restricted SAPUI5 Dist
-	 * @type {string}
-	 */
-	StaticArea.STATIC_UIAREA_ID = "sap-ui-static";
-
-	var oStaticArea;
-
-	/**
-	 * Returns the <code>UIArea</code> instance for the static area. If none exists yet, one gets created.
-	 *
-	 * @returns {sap.ui.core.UIArea} The <code>UIArea</code> instance for the static area
-	 * @throws {Error} if the document is not ready yet
-	 *
-	 * @private
-	 * @ui5-restricted SAPUI5 Dist
-	 */
-	StaticArea.getUIArea = function() {
-		if (!oStaticArea) {
-			oStaticArea = UIArea.registry.get(StaticArea.STATIC_UIAREA_ID) || UIArea.create(_createStaticAreaRef());
-			oStaticArea.bInitial = false;
+	const StaticArea = {
+		/**
+		 * The unique ID of the static area.
+		 *
+		 * @private
+		 * @ui5-restricted SAPUI5 Dist
+		 * @type {string}
+		 */
+		STATIC_UIAREA_ID: "sap-ui-static",
+
+		/**
+		 * Returns the <code>UIArea</code> instance for the static area. If none exists yet, one gets created.
+		 *
+		 * @returns {sap.ui.core.UIArea} The <code>UIArea</code> instance for the static area
+		 * @throws {Error} if the document is not ready yet
+		 *
+		 * @public
+		 */
+		getUIArea: () => {
+			if (!oStaticArea) {
+				oStaticArea = UIArea.registry.get(StaticArea.STATIC_UIAREA_ID) || UIArea.create(_createStaticAreaRef());
+				oStaticArea.bInitial = false;
+			}
+			return oStaticArea;
+		},
+		/**
+		 * Returns the root element of the static, hidden area.
+		 *
+		 * It can be used e.g. for hiding elements like Popup, Shadow, Blocklayer etc.
+		 * If it is not yet available, a DIV element is created and appended to the body.
+		 *
+		 * @returns {Element} the root DOM element of the static, hidden area
+		 * @throws {Error} if the document is not ready yet
+		 *
+		 * @public
+		 */
+		getDomRef: () => {
+			return StaticArea.getUIArea().getRootNode();
+		},
+
+		/**
+		 * Checks whether the given DOM element is part of the static area.
+		 *
+		 * @param {Element} oDomRef The DOM element to check
+		 * @returns {boolean} Whether the given DOM reference is part of the static UIArea
+		 * @throws {Error} if the document is not ready yet
+		 *
+		 * @public
+		 */
+		contains: (oDomRef) => {
+			return StaticArea.getDomRef().contains(oDomRef);
 		}
-		return oStaticArea;
 	};
 
 	/*
@@ -76,11 +98,11 @@ sap.ui.define([
 	 *
 	 * @private
 	 */
-	function _createStaticAreaRef() {
+	const _createStaticAreaRef = () => {
 		if (!bDomReady) {
 			throw new Error("DOM is not ready yet. Static UIArea cannot be created.");
 		}
-		var oStaticArea = document.getElementById(StaticArea.STATIC_UIAREA_ID);
+		let oStaticArea = document.getElementById(StaticArea.STATIC_UIAREA_ID);
 
 		if (!oStaticArea) {
 
@@ -93,7 +115,7 @@ sap.ui.define([
 				"height": "0",
 				"width": "0",
 				"overflow": "hidden",
-				"float":  Configuration.getRTL() ? "right" : "left"
+				"float":  Localization.getRTL() ? "right" : "left"
 			});
 
 			oFirstFocusElement.setAttribute("id", StaticArea.STATIC_UIAREA_ID + "-firstfe");
@@ -105,36 +127,6 @@ sap.ui.define([
 			document.body.insertBefore(oStaticArea, document.body.firstChild);
 		}
 		return oStaticArea;
-	}
-
-	/**
-	 * Returns the root element of the static, hidden area.
-	 *
-	 * It can be used e.g. for hiding elements like Popup, Shadow, Blocklayer etc.
-	 * If it is not yet available, a DIV element is created and appended to the body.
-	 *
-	 * @returns {Element} the root DOM element of the static, hidden area
-	 * @throws {Error} if the document is not ready yet
-	 *
-	 * @private
-	 * @ui5-restricted SAPUI5 Dist
-	 */
-	StaticArea.getDomRef = function() {
-		return StaticArea.getUIArea().getRootNode();
-	};
-
-	/**
-	 * Checks whether the given DOM element is part of the static area.
-	 *
-	 * @param {Element} oDomRef
-	 * @returns {boolean} Whether the given DOM reference is part of the static UIArea
-	 * @throws {Error} if the document is not ready yet
-	 *
-	 * @private
-	 * @ui5-restricted SAPUI5 Dist
-	 */
-	StaticArea.contains = function(oDomRef) {
-		return StaticArea.getDomRef().contains(oDomRef);
 	};
 
 	return StaticArea;

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

@@ -10,7 +10,8 @@ sap.ui.define([
 	"sap/base/Eventing",
 	"sap/base/Log",
 	"sap/base/i18n/Localization",
-	"sap/base/util/deepEqual"
+	"sap/base/util/deepEqual",
+	"sap/ui/core/theming/ThemeHelper"
 ], function(
 	assert,
 	BaseConfig,
@@ -18,7 +19,8 @@ sap.ui.define([
 	Eventing,
 	Log,
 	Localization,
-	deepEqual
+	deepEqual,
+	ThemeHelper
 ) {
 	"use strict";
 
@@ -31,8 +33,8 @@ sap.ui.define([
 	 *
 	 * @alias module:sap/ui/core/Theming
 	 * @namespace
-	 * @private
-	 * @ui5-restricted sap.ui.core
+	 * @public
+	 * @since 1.118
 	 */
 	var Theming = {
 		/**
@@ -53,10 +55,12 @@ sap.ui.define([
 				external: true
 			});
 
-			// empty string is a valid value wrt. the <String> type
-			// this is a semantic check if we need to default to a valid theme
+			// Empty string is a valid value wrt. the <String> type.
+			// An empty string is equivalent to "no theme given" here.
+			// We apply the default, but also automatically detect the dark mode.
 			if (sTheme === "") {
-				sTheme = "base";
+				const mDefaultThemeInfo = ThemeHelper.getDefaultThemeInfo();
+				sTheme = `${mDefaultThemeInfo.DEFAULT_THEME}${mDefaultThemeInfo.DARK_MODE ? "_dark" : ""}`;
 			}
 
 			// It's only possible to provide a themeroot via theme parameter using
@@ -71,7 +75,11 @@ sap.ui.define([
 					Theming.setThemeRoot(sTheme, sThemeRoot);
 				}
 			}
-			return normalizeTheme(sTheme, Theming.getThemeRoot(sTheme));
+
+			// validate theme and fallback to the fixed default, in case the configured theme is not valid
+			sTheme = ThemeHelper.validateAndFallbackTheme(sTheme, Theming.getThemeRoot(sTheme));
+
+			return sTheme;
 		},
 
 		/**
@@ -85,6 +93,7 @@ sap.ui.define([
 				if (sTheme.indexOf("@") !== -1) {
 					throw new TypeError("Providing a theme root as part of the theme parameter is not allowed.");
 				}
+
 				var bFireChange = !mChanges;
 				mChanges = mChanges || {};
 				var sOldTheme = Theming.getTheme();
@@ -109,19 +118,6 @@ sap.ui.define([
 			return this;
 		},
 
-		/**
-		 * Returns true, if the styles of the current theme are already applied, false otherwise.
-		 *
-		 * If the styles are not yet applied a theme changed event will follow when the styles will be applied.
-		 *
-		 * @return {boolean} whether the styles of the current theme are already applied
-		 * @private
-		 * @ui5-restricted sap.ui.core.Core
-		 */
-		isApplied: function() {
-			return !oThemeManager || oThemeManager.themeLoaded;
-		},
-
 		/**
 		 *
 		 * @param {string} sTheme The Theme
@@ -154,8 +150,8 @@ sap.ui.define([
 		 *
 		 * Example:
 		 * <pre>
-		 *   sap.ui.getCore().setThemeRoot("my_theme", "https://mythemeserver.com/allThemes");
-		 *   sap.ui.getCore().applyTheme("my_theme");
+		 *   Theming.setThemeRoot("my_theme", "https://mythemeserver.com/allThemes");
+		 *   Theming.setTheme("my_theme");
 		 * </pre>
 		 *
 		 * will cause the following file to be loaded (assuming that the bootstrap is configured to load
@@ -171,7 +167,7 @@ sap.ui.define([
 		 * different location than the UI5 resources), you can also specify for which control libraries the setting
 		 * should be used, by giving an array with the names of the respective control libraries as second parameter:
 		 * <pre>
-		 *   sap.ui.getCore().setThemeRoot("sap_belize", ["my.own.library"], "https://mythemeserver.com/allThemes");
+		 *   Theming.setThemeRoot("sap_belize", ["my.own.library"], "https://mythemeserver.com/allThemes");
 		 * </pre>
 		 *
 		 * This will cause the Belize theme to be loaded from the UI5 location for all standard libraries.
@@ -186,7 +182,7 @@ sap.ui.define([
 		 *
 		 * If the custom theme should be loaded initially (via bootstrap attribute), the <code>themeRoots</code>
 		 * property of the <code>window["sap-ui-config"]</code> object must be used instead of calling
-		 * <code>sap.ui.getCore().setThemeRoot(...)</code> in order to configure the theme location early enough.
+		 * <code>Theming.setThemeRoot(...)</code> in order to configure the theme location early enough.
 		 *
 		 * @param {string} sThemeName Name of the theme for which to configure the location
 		 * @param {string} sThemeBaseUrl Base URL below which the CSS file(s) will be loaded from
@@ -272,7 +268,7 @@ sap.ui.define([
 		 *       has been applied for it</li>
 		 * </ul>
 		 *
-		 * @name sap.ui.core.Theming#applied
+		 * @name module:sap/ui/core/Theming.applied
 		 * @event
 		 * @param {module:sap/base/Event} oEvent
 		 * @param {sap.ui.base.EventProvider} oEvent.target
@@ -283,6 +279,9 @@ sap.ui.define([
 		/**
 		 * Attaches event handler <code>fnFunction</code> to the {@link #event:applied applied} event
 		 *
+		 * The given handler is called when the the applied event is fired. If the theme is already applied
+		 * the handler will be called immediately.
+		 *
 		 * @param {function} fnFunction The function to be called, when the event occurs
 		 * @private
 		 * @ui5-restricted sap.ui.core.Core
@@ -290,14 +289,22 @@ sap.ui.define([
 		attachAppliedOnce: function(fnFunction) {
 			var sId = "applied";
 			if (oThemeManager) {
-				Theming.attachEventOnce(sId, fnFunction);
+				if (oThemeManager.themeLoaded) {
+					fnFunction.call(Theming, new BaseEvent(sId, Theming, {theme: Theming.getTheme()}));
+				} else {
+					Theming.attachEventOnce(sId, fnFunction);
+				}
 			} else {
 				fnFunction.call(Theming, new BaseEvent(sId, Theming, {theme: Theming.getTheme()}));
 			}
 		},
 
 		/**
-		 * Attaches event handler <code>fnFunction</code> to the {@link #event:applied applied} event
+		 * Attaches event handler <code>fnFunction</code> to the {@link #event:applied applied} event.
+		 *
+		 * The given handler is called when the the applied event is fired. If the theme is already applied
+		 * the handler will be called immediately. The handler stays attached to the applied event for future
+		 * theme changes.
 		 *
 		 * @param {function} fnFunction The function to be called, when the event occurs
 		 * @public
@@ -305,10 +312,15 @@ sap.ui.define([
 		attachApplied: function(fnFunction) {
 			var sId = "applied";
 			Theming.attachEvent(sId, fnFunction);
-			if (!oThemeManager) {
+			if (oThemeManager) {
+				if (oThemeManager.themeLoaded) {
+					fnFunction.call(Theming, new BaseEvent(sId, Theming, {theme: Theming.getTheme()}));
+				}
+			} else {
 				fnFunction.call(Theming, new BaseEvent(sId, Theming, {theme: Theming.getTheme()}));
 			}
 		},
+
 		/**
 		 * Detaches event handler <code>fnFunction</code> from the {@link #event:applied applied} event
 		 *
@@ -361,12 +373,67 @@ sap.ui.define([
 			Theming.detachEvent("change", fnFunction);
 		},
 
+		/**
+		 * Fired when a scope class has been added or removed on a control/element
+		 * by using the custom style class API <code>addStyleClass</code>,
+		 * <code>removeStyleClass</code> or <code>toggleStyleClass</code>.
+		 *
+		 * Scope classes are defined by the library theme parameters coming from the
+		 * current theme.
+		 *
+		 * <b>Note:</b> The event will only be fired after the
+		 * <code>sap.ui.core.theming.Parameters</code> module has been loaded.
+		 * By default this is not the case.
+		 *
+		 * @name module:sap/ui/core/Theming.themeScopingChanged
+		 * @event
+		 * @param {module:sap/base/Event} oEvent
+		 * @param {string[]} oEvent.scopes Array of the CSS scope classes
+		 * @param {boolean} oEvent.added Whether the class has been added or removed
+		 * @param {sap.ui.core.Element} oEvent.element Element instance on which the scope change happened
+		 * @private
+		 * @ui5-restricted SAPUI5 Distribution Layer Libraries
+		 */
 
 		/**
-		 * Notify content density changes
+		 * Attaches the <code>fnFunction</code> event handler to the {@link #event:themeScopingChanged change} event
+		 * of <code>sap.ui.core.Theming</code>.
 		 *
+		 * @param {function} fnFunction The function to be called when the event occurs
 		 * @private
-		 * @ui5-restricted sap.ui.core.Core
+		 * @ui5-restricted SAPUI5 Distribution Layer Libraries
+		 */
+		attachThemeScopingChanged: function(fnFunction) {
+			Theming.attachEvent("themeScopingChanged", fnFunction);
+		},
+
+		/**
+		 * Detaches event handler <code>fnFunction</code> from the {@link #event:themeScopingChanged change} event of
+		 * this <code>sap.ui.core.Theming</code>.
+		 *
+		 * @param {function} fnFunction Function to be called when the event occurs
+		 * @private
+		 * @ui5-restricted SAPUI5 Distribution Layer Libraries
+		 */
+		detachThemeScopingChanged: function(fnFunction) {
+			Theming.detachEvent("themeScopingChanged", fnFunction);
+		},
+
+		/**
+		 * Fire themeScopingChanged event.
+		 *
+		 * @param {function} fnFunction Function to be called when the event occurs
+		 * @private
+		 * @ui5-restricted SAPUI5 Distribution Layer Libraries
+		 */
+		fireThemeScopingChanged: function(mParameters) {
+			Theming.fireEvent("themeScopingChanged", mParameters);
+		},
+
+		/**
+		 * Notify content density changes
+		 *
+		 * @public
 		 */
 		notifyContentDensityChanged: function() {
 			fireApplied({theme: Theming.getTheme()});
@@ -379,7 +446,7 @@ sap.ui.define([
 		*/
 		registerThemeManager: function(oManager) {
 			oThemeManager = oManager;
-			oThemeManager.attachEvent("ThemeChanged", function(oEvent) {
+			oThemeManager.attachEvent("applied", function(oEvent) {
 				fireApplied(BaseEvent.getParameters(oEvent));
 			});
 			// handle RTL changes
@@ -446,13 +513,6 @@ sap.ui.define([
 		}
 	}
 
-	function normalizeTheme(sTheme, sThemeBaseUrl) {
-		if ( sTheme && sThemeBaseUrl == null && sTheme.match(/^sap_corbu$/i) ) {
-			return "sap_fiori_3";
-		}
-		return sTheme;
-	}
-
 	Eventing.apply(Theming);
 	return Theming;
 });

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

@@ -25,7 +25,7 @@ sap.ui.define(['./Element', './library'],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.117.1
+	 * @version 1.119.0
 	 *
 	 * @public
 	 * @since 1.16.0

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

@@ -30,7 +30,7 @@ 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.117.1
+	 * @version 1.119.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.TooltipBase