@openui5/sap.ui.core 1.97.1 → 1.100.0

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

@@ -66,6 +66,9 @@ sap.ui.define([
 	// shortcut for sap.ui.core.OpenState
 	var OpenState = library.OpenState;
 
+	// shortcut for sap.ui.core.Collision
+	var Collision = library.Collision;
+
 	var oStaticUIArea;
 
 	var vGlobalWithinArea;
@@ -758,7 +761,7 @@ sap.ui.define([
 	/**
 	 * Opens the popup's content at the position either specified here or beforehand via {@link #setPosition}.
 	 * Content must be capable of being positioned via "position:absolute;"
-	 * All parameters are optional (open() may be called without any parameters). iDuration may just be omitted, but if any of "at", "of", "offset", "collision" is given, also the preceding positioning parameters ("my", at",...) must be given.
+	 * All parameters are optional (open() may be called without any parameters). iDuration may just be omitted, but if any of "at", "of", "offset", "collision" is given, also the preceding positional parameters ("my", at",...) must be given.
 	 *
 	 * If the Popup's OpenState is different from "CLOSED" (i.e. if the Popup is already open, opening or closing), the call is ignored.
 	 *
@@ -767,9 +770,9 @@ sap.ui.define([
 	 * @param {sap.ui.core.Popup.Dock} [at=sap.ui.core.Popup.Dock.CenterCenter] the "of" element's reference point for docking to
 	 * @param {string | sap.ui.core.Element | Element | jQuery | jQuery.Event} [of=document] specifies the reference element to which the given content should dock to
 	 * @param {string} [offset='0 0'] the offset relative to the docking point, specified as a string with space-separated pixel values (e.g. "10 0" to move the popup 10 pixels to the right). If the docking of both "my" and "at" are both RTL-sensitive ("begin" or "end"), this offset is automatically mirrored in the RTL case as well.
-	 * @param {string} [collision='flip'] defines how the position of an element should be adjusted in case it overflows the within area in some direction.
+	 * @param {sap.ui.core.Collision} [collision='flip'] defines how the position of an element should be adjusted in case it overflows the within area in some direction.
 	 * @param {string | sap.ui.core.Element | Element | Window} [within=Window] defines the area the popup should be placed in. This affects the collision detection.
-	 * @param {boolean} [followOf=false] defines whether the popup should follow the dock reference when the reference changes its position.
+	 * @param {boolean | function | null} [followOf=false] defines whether the popup should follow the dock reference when the reference changes its position.
 	 * @public
 	 */
 	Popup.prototype.open = function(iDuration, my, at, of, offset, collision, within, followOf) {
@@ -811,7 +814,7 @@ sap.ui.define([
 		assert(at === undefined || typeof at === "string", "at must be a string or empty");
 		assert(!of || typeof of === "object" || typeof of === "function", "of must be empty or an object");
 		assert(!offset || typeof offset === "string", "offset must be empty or a string");
-		assert(!collision || typeof collision === "string", "collision must be empty or a string");
+		assert(!collision || Collision.isValid(collision), "collision must be empty or of type sap.ui.core.Collision");
 		assert(!within || within === window || typeof within === "string" || within instanceof Element || within instanceof HTMLElement, "within must be either empty, or the global window object, or a string, or a sap.ui.core.Element, or a DOM element");
 		assert(!followOf || typeof followOf === "boolean" || typeof followOf === "function" || followOf === Popup.CLOSE_ON_SCROLL, "followOf must be either empty or a boolean");
 
@@ -1600,7 +1603,7 @@ sap.ui.define([
 	 * @param {sap.ui.core.Popup.Dock | {left: sap.ui.core.CSSSize, top: sap.ui.core.CSSSize}} at specifies the point of the reference element to which the given Content should be aligned
 	 * @param {string | sap.ui.core.Element | Element | jQuery | jQuery.Event} [of=document] specifies the reference element to which the given content should be aligned as specified in the other parameters
 	 * @param {string} [offset='0 0'] the offset relative to the docking point, specified as a string with space-separated pixel values (e.g. "0 10" to move the popup 10 pixels to the right). If the docking of both "my" and "at" are both RTL-sensitive ("begin" or "end"), this offset is automatically mirrored in the RTL case as well.
-	 * @param {string} [collision] defines how the position of an element should be adjusted in case it overflows the within area in some direction. The valid values that refer to jQuery-UI's position parameters are "flip", "fit" and "none".
+	 * @param {sap.ui.core.Collision} [collision] defines how the position of an element should be adjusted in case it overflows the within area in some direction.
 	 * @param {string | sap.ui.core.Element | Element | Window} [within=Window] defines the area the popup should be placed in. This affects the collision detection.
 	 * @return {this} <code>this</code> to allow method chaining
 	 * @public
@@ -1610,7 +1613,7 @@ sap.ui.define([
 		assert(typeof at === "string" || (typeof at === "object" && (typeof at.left === "number") && (typeof at.top === "number")), "my must be a string or an object with 'left' and 'top' properties");
 		assert(!of || typeof of === "object" || typeof of === "function", "of must be empty or an object");
 		assert(!offset || typeof offset === "string", "offset must be empty or a string");
-		assert(!collision || typeof collision === "string", "collision must be empty or a string");
+		assert(!collision || Collision.isValid(collision), "collision must be empty or of type sap.ui.core.Collision");
 		assert(!within || within === window || typeof within === "string" || within instanceof Element || within instanceof HTMLElement, "within must be either empty, or the global window object, or a string, or a sap.ui.core.Element, or a DOM element");
 
 		this._oPosition = this._createPosition(my, at, of, offset, collision, within);
@@ -1794,7 +1797,7 @@ sap.ui.define([
 	/**
 	 * Calculates the rect information of the given parameter.
 	 *
-	 * @param {String| DomNode | jQuery |sap.ui.core.Element | Event | jQuery.Event} oOf the DOM Element, UI Element instance on which the calculation is done
+	 * @param {string| Element | jQuery |sap.ui.core.Element | Event | jQuery.Event} oOf the DOM Element, UI Element instance on which the calculation is done
 	 * @returns {object} the rect information which contains the top, left, width, height of the given object. If Event or jQuery.Event type parameter is given, null is returned because there's no way to calculate the rect info based on an event object.
 	 * @private
 	 */
@@ -1811,7 +1814,7 @@ sap.ui.define([
 	/**
 	 * Get the DOM reference of the given parameter. The "of" parameter can be different types. This methods returns the referred DOM reference based on the given parameter. If Event or jQuery.Event type parameter is given, null is returned.
 	 *
-	 * @param {String| DomNode | jQuery |sap.ui.core.Element | Event | jQuery.Event} oOf the DOM Element, UI Element instance on which the calculation is done
+	 * @param {string| Element | jQuery |sap.ui.core.Element | Event | jQuery.Event} oOf the DOM Element, UI Element instance on which the calculation is done
 	 * @returns {DomNode} the DOM reference calculated based on the given parameter. If Event, or jQuery Event type parameter is given, null is returned.
 	 * @private
 	 */
@@ -2610,7 +2613,7 @@ sap.ui.define([
 				if ($ContentRef.length > 0) {
 					RenderManager.preserveContent($ContentRef[0], /* bPreserveRoot */ true, /* bPreserveNodesWithId */ false);
 				}
-				sap.ui.getCore().getRenderManager().render(this.oContent, sap.ui.getCore().getStaticAreaRef());
+				sap.ui.getCore().createRenderManager().render(this.oContent, sap.ui.getCore().getStaticAreaRef());
 				$ContentRef = this.oContent.$();
 			}
 		} else if (this.oContent instanceof Element) {

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

@@ -182,7 +182,7 @@ sap.ui.define([
 	 *
 	 * @extends Object
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 * @alias sap.ui.core.RenderManager
 	 * @public
 	 */

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

@@ -18,7 +18,7 @@ sap.ui.define([
 	 * @classdesc Base Class for a Renderer.
 	 *
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 * @namespace
 	 * @public
 	 * @alias sap.ui.core.Renderer

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

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

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.97.1
+	 * @version 1.100.0
 	 *
 	 * @public
 	 * @deprecated as of version 1.56

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

@@ -24,7 +24,7 @@ sap.ui.define(['sap/ui/Device', "sap/ui/dom/getScrollbarSize"],
 	 * Renders the HTML for the given control, using the provided {@link sap.ui.core.RenderManager}.
 	 *
 	 * @param {sap.ui.core.RenderManager} oRM RenderManager that can be used for writing to the Render-Output-Buffer
-	 * @param {sap.ui.core.Control} oControl Object representation of the control that should be rendered
+	 * @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();

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.97.1
+	 * @version 1.100.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.SeparatorItem

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.97.1
+	 * @version 1.100.0
 	 *
 	 * @public
 	 * @since 1.16.0

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

@@ -31,7 +31,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.97.1
+	 * @version 1.100.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.TooltipBase
@@ -136,7 +136,7 @@ sap.ui.define([
 			var oPopup = this._getPopup();
 			if (!(oPopup.isOpen() && oPopup.getContent() == this)) {
 				// Update Tooltip or create a new span with texts.
-				sap.ui.getCore().getRenderManager().render(this, sap.ui.getCore().getStaticAreaRef(), true);
+				sap.ui.getCore().createRenderManager().render(this, sap.ui.getCore().getStaticAreaRef(), true);
 			}
 
 			// Attach accessibility info to the control oSC

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

@@ -175,7 +175,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 * @param {sap.ui.core.Core} oCore internal API of the <core>Core</code> that manages this UIArea
 	 * @param {object} [oRootNode] reference to the DOM element that should be 'hosting' the UI Area.
 	 * @public

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

@@ -54,7 +54,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Component
 	 * @abstract
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 * @alias sap.ui.core.UIComponent
 	 * @since 1.9.2
 	 * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel

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

@@ -18,7 +18,7 @@ sap.ui.define(['./ComponentMetadata', 'sap/ui/core/mvc/ViewType'],
 	 * @experimental Since 1.15.1. The Component concept is still under construction, so some implementation details can be changed in future.
 	 * @class
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 * @since 1.15.1
 	 * @alias sap.ui.core.UIComponentMetadata
 	 * @extends sap.ui.core.ComponentMetadata

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

@@ -16,7 +16,7 @@ sap.ui.define(['./Element', './library', "sap/base/assert"],
 		 * Helper functionality for value state support.
 		 *
 		 * @author SAP SE
-		 * @version 1.97.1
+		 * @version 1.100.0
 		 * @public
 		 * @namespace sap.ui.core.ValueStateSupport
 		 */

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

@@ -20,7 +20,7 @@ sap.ui.define(['./LayoutData', './library'],
 	 * @class
 	 * Allows to add multiple LayoutData to one control in case that an easy switch of layouts (e.g. in a Form) is needed.
 	 * @extends sap.ui.core.LayoutData
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 *
 	 * @public
 	 * @since 1.9.2

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

@@ -143,7 +143,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.97.1
+		 * @version 1.100.0
 		 * @since 1.56.0
 		 * @alias sap.ui.core.XMLComposite
 		 * @see {@link topic:b83a4dcb7d0e46969027345b8d32fd44 XML Composite Controls}

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

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * @param {object} oClassInfo static info to construct the metadata from
 	 *
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 * @since 1.50.0
 	 * @alias sap.ui.core.XMLCompositeMetadata
 	 * @extends sap.ui.core.ElementMetadata

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

@@ -412,7 +412,7 @@ function(
 	 * @param {Element} xmlNode The current XMLNode which is being processed
 	 * @param {boolean} bAsync Whether the view is processed asynchronously
 	 *
-	 * @return {promise|undefined} The promise resolves after all modules are loaded. If the given xml node
+	 * @return {Promise|undefined} The promise resolves after all modules are loaded. If the given xml node
 	 *  doesn't have require context defined, undefined is returned.
 	 */
 	function parseAndLoadRequireContext(xmlNode, bAsync) {
@@ -1117,7 +1117,7 @@ function(
 								var mMetaContextsInfo = null;
 
 								try {
-									mMetaContextsInfo = XMLTemplateProcessor._calculatedModelMapping(sValue,oView._oContainingView.oController,true);
+									mMetaContextsInfo = XMLTemplateProcessor._calculatedModelMapping(sValue, oView._oContainingView.oController, true);
 								} catch (e) {
 									Log.error(oView + ":" + e.message);
 								}
@@ -1626,12 +1626,13 @@ function(
 	/**
 	 * Create a named map for models and binding
 	 *
-	 * @param{string} The string value of a complex binding containing one or more models
-	 * @param {object} oContext - The current context
+	 * @param {string} sBinding The string value of a complex binding containing one or more models
+	 * @param {object} oContext - The current context (controller)
+	 * @param {boolean} bAllowMultipleBindings - Whether to allow multiple bindings
 	 *
-	 * @return{object} a named map keyed by model name
+	 * @returns {object} a named map keyed by model name
 	 */
-	XMLTemplateProcessor._calculatedModelMapping = function(sBinding,oContext,bAllowMultipleBindings) {
+	XMLTemplateProcessor._calculatedModelMapping = function(sBinding, oContext, bAllowMultipleBindings) {
 		var oCtx,
 			mBinding = {},
 			oBinding = ManagedObject.bindingParser(sBinding, oContext);

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

@@ -9,11 +9,12 @@
  * Code other than the UI5 core library must not introduce dependencies to this module.
  */
 sap.ui.define([
-	'sap/ui/thirdparty/URI',
+	"sap/ui/thirdparty/jquery",
+	"sap/ui/thirdparty/URI",
 	"sap/base/i18n/ResourceBundle",
 	"sap/base/Log"
 ],
-	function(URI, ResourceBundle, Log) {
+	function(jQuery, URI, ResourceBundle, Log) {
 		"use strict";
 
 		/**
@@ -711,7 +712,16 @@ sap.ui.define([
 				'qr-code': 0x1e28f,
 				'space-navigation': 0xe290,
 				'in-progress': 0x1e291,
-				'not-editable': 0xe292
+				'not-editable': 0xe292,
+				'bookmark-2': 0xe296,
+				'detail-less': 0xe297,
+				'detail-more': 0xe298,
+				'flag-2': 0x1e299,
+				'folder-2': 0xe29a,
+				'heart': 0xe293,
+				'heart-2': 0xe294,
+				'paint-bucket': 0xe29b,
+				'tri-state': 0xe295
 			}
 		};
 

package/src/sap/ui/core/cache/CacheManager.js

@@ -110,7 +110,7 @@ sap.ui.define([
 				if (isSwitchedOn() && this._isSupportedEnvironment()) {
 					return LRUPersistentCache;
 				} else {
-					Log.warning("UI5 Cache Manager is switched off");
+					Log.debug("UI5 Cache Manager is switched off");
 					return CacheManagerNOP;
 				}
 			},

package/src/sap/ui/core/cache/LRUPersistentCache.js

@@ -773,7 +773,8 @@ sap.ui.define(["sap/base/Log", "sap/ui/performance/Measurement"],
 		/**
 		 * Tries to free space until the given new item is successfully added.
 		 * @param {sap.ui.core.cache.LRUPersistentCache} self the instance of the Cache Manager
-		 * @param {ItemData} oItem the item to free space for
+		 * @param {string|number} key the key to associate the value with
+		 * @param {any} value value to free space for
 		 * @returns {Promise} a promise that will resolve if the given item is added, or reject - if not.
 		 */
 		function cleanAndStore(self, key, value) {

package/src/sap/ui/core/cldr/en_AU.json

@@ -4914,7 +4914,7 @@
 		"one": "i = 1 and v = 0"
 	},
 	"weekData-minDays": 1,
-	"weekData-firstDay": 0,
+	"weekData-firstDay": 1,
 	"weekData-weekendStart": 6,
 	"weekData-weekendEnd": 0,
 	"timeData": {

package/src/sap/ui/core/date/Buddhist.js

@@ -88,10 +88,10 @@ sap.ui.define(['./UniversalDate', '../CalendarType', './_Calendars'],
 	}
 
 	/**
-	 * Convert arguments array from Buddhist date to gregorian data
+	 * Convert arguments array from Buddhist date to Gregorian data.
 	 *
-	 * @param {object} oBuddhist
-	 * @return {int}
+	 * @param {int[]} aArgs Array with year, month, day (optional) according to Buddhist calendar
+	 * @returns {int[]} Array with year, month, day according to Gregorian calendar
 	 */
 	function toGregorianArguments(aArgs) {
 		var oBuddhist, oGregorian;

package/src/sap/ui/core/date/Japanese.js

@@ -64,7 +64,7 @@ sap.ui.define(['./UniversalDate', '../CalendarType', './_Calendars'],
 	}
 
 	/**
-	 * Calculate gregorian year from japanes era and year
+	 * Calculate Gregorian year from Japanese era and year
 	 *
 	 * @param {object} oJapanese
 	 * @return {int}
@@ -79,10 +79,10 @@ sap.ui.define(['./UniversalDate', '../CalendarType', './_Calendars'],
 	}
 
 	/**
-	 * Convert arguments array from japanese date to gregorian data
+	 * Convert arguments array from Japanese date to Gregorian data.
 	 *
-	 * @param {object} oJapanese
-	 * @return {int}
+	 * @param {int[]|any[]} aArgs Array with year (or [era, year]), month and day (optional) according to Japanese calendar
+	 * @returns {int[]} Array with year, month and day according to the Gregorian calendar
 	 */
 	function toGregorianArguments(aArgs) {
 		var oJapanese, oGregorian,

package/src/sap/ui/core/date/UniversalDate.js

@@ -75,6 +75,11 @@ sap.ui.define(['sap/ui/base/Object', 'sap/ui/core/LocaleData', './_Calendars'],
 		} else if (!oDate) {
 			oDate = new Date();
 		}
+
+		if (isNaN(oDate.getTime())) {
+			throw new Error("The given date object is invalid");
+		}
+
 		if (!sCalendarType) {
 			sCalendarType = sap.ui.getCore().getConfiguration().getCalendarType();
 		}
@@ -265,6 +270,11 @@ sap.ui.define(['sap/ui/base/Object', 'sap/ui/core/LocaleData', './_Calendars'],
 			iFirstDayOfWeek = oLocaleData.getFirstDayOfWeek(),
 			oFirstDay = new clDate(clDate.UTC(iYear, 0, 1)),
 			iDayCount = 7;
+
+		if (isNaN(oFirstDay.getTime())) {
+			throw new Error("Could not determine the first day of the week, because the date " +
+				"object is invalid");
+		}
 		// Find the first day of the first week of the year
 		while (oFirstDay.getUTCDay() !== iFirstDayOfWeek) {
 			oFirstDay.setUTCDate(oFirstDay.getUTCDate() - 1);