@openui5/sap.ui.core 1.97.1 → 1.100.0

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

@@ -171,7 +171,7 @@ sap.ui.define(['sap/ui/core/date/UniversalDate', 'sap/ui/core/Locale', 'sap/ui/c
 		 *
 		 * @param {sap.ui.core.date.UniversalDate} [oUniversalDate=now] Base date, defaults to now
 		 * @param {string} [sLocale=format locale] An optional locale identifier, as BCP language tag;
-		 *   defaults to the current format local of UI5
+		 *   defaults to the current format localе of UI5
 		 * @returns {sap.ui.core.date.UniversalDate} First day of the week
 		 * @private
 		 * @ui5-restricted sap.ui.comp
@@ -186,6 +186,29 @@ sap.ui.define(['sap/ui/core/date/UniversalDate', 'sap/ui/core/Locale', 'sap/ui/c
 			return UniversalDateUtils.resetStartTime(oUniversalDate);
 		};
 
+		/**
+		 * Returns the last day of the week for the given date.
+		 *
+		 * The interpretation of 'last day of the week' depends on the given locale or, if none is given,
+		 * on the current {@link sap.ui.core.Configuration.FormatSettings#getFormatLocale UI5 format locale}.
+		 *
+		 * If no date is given, today is used, represented in the session's default calendar.
+		 * If a date is given, the returned date will use the same calendar.
+		 * The time portion of the returned date will be set to the start of the day (00:00:00:000).
+		 *
+		 * @param {sap.ui.core.date.UniversalDate} [oUniversalDate=now] Base date, defaults to now
+		 * @param {string} [sLocale=format locale] An optional locale identifier, as BCP language tag;
+		 *   defaults to the current format localе of UI5
+		 * @returns {sap.ui.core.date.UniversalDate} Last day of the week
+		 * @private
+		 * @ui5-restricted sap.ui.comp
+		 */
+		UniversalDateUtils.getWeekLastDate = function (oUniversalDate, sLocale) {
+			var oEndDate = UniversalDateUtils.getWeekStartDate(oUniversalDate, sLocale);
+			oEndDate.setDate(oEndDate.getDate() + 6);
+			return UniversalDateUtils.resetStartTime(oEndDate);
+		};
+
 		/**
 		 * Returns the first day of the month of the given date.
 		 *
@@ -204,6 +227,25 @@ sap.ui.define(['sap/ui/core/date/UniversalDate', 'sap/ui/core/Locale', 'sap/ui/c
 			return UniversalDateUtils.resetStartTime(oUniversalDate);
 		};
 
+		/**
+		 * Returns the last day of the month for the given date.
+		 *
+		 * If no date is given, today is used, represented in the session's default calendar.
+		 * If a date is given, the returned date will use the same calendar.
+		 * The time portion of the returned date will be set to the start of the day (00:00:00:000).
+		 *
+		 * @param {sap.ui.core.date.UniversalDate} [oUniversalDate=now] Base date, defaults to now
+		 * @returns {sap.ui.core.date.UniversalDate} Last day of the month
+		 * @private
+		 * @ui5-restricted sap.ui.comp
+		 */
+		UniversalDateUtils.getMonthEndDate = function (oUniversalDate) {
+			var oEndDate = UniversalDateUtils.getMonthStartDate(oUniversalDate);
+			oEndDate.setMonth(oEndDate.getMonth() + 1);
+			oEndDate.setDate(0);
+			return UniversalDateUtils.resetStartTime(oEndDate);
+		};
+
 		/**
 		 * Returns the first day of the quarter of the year of the given date.
 		 *
@@ -223,6 +265,25 @@ sap.ui.define(['sap/ui/core/date/UniversalDate', 'sap/ui/core/Locale', 'sap/ui/c
 			return UniversalDateUtils.resetStartTime(oUniversalDate);
 		};
 
+		/**
+		 * Returns the last day of the quarter of the year for the given date.
+		 *
+		 * If no date is given, today is used, represented in the session's default calendar.
+		 * If a date is given, the returned date will use the same calendar.
+		 * The time portion of the returned date will be set to the start of the day (00:00:00:000).
+		 *
+		 * @param {sap.ui.core.date.UniversalDate} [oUniversalDate=now] Base date, defaults to now
+		 * @returns {sap.ui.core.date.UniversalDate} Last day of the quarter of the year
+		 * @private
+		 * @ui5-restricted sap.ui.comp
+		 */
+		UniversalDateUtils.getQuarterEndDate = function (oUniversalDate) {
+			var oEndDate = UniversalDateUtils.getQuarterStartDate(oUniversalDate);
+			oEndDate.setMonth(oEndDate.getMonth() + 3);
+			oEndDate.setDate(0);
+			return UniversalDateUtils.resetStartTime(oEndDate);
+		};
+
 		/**
 		 * Returns the year's start date based on a given universal date.
 		 *
@@ -247,7 +308,7 @@ sap.ui.define(['sap/ui/core/date/UniversalDate', 'sap/ui/core/Locale', 'sap/ui/c
 		 *
 		 * If no date is given, today is used, represented in the session's default calendar.
 		 * If a date is given, the returned date will use the same calendar.
-		 * The time portion of the returned date will be set to the end of the day (23:59:59:999).
+		 * The time portion of the returned date will be set to the start of the day (00:00:00:000).
 		 *
 		 * @param {sap.ui.core.date.UniversalDate} [oUniversalDate=now] Base date, defaults to now
 		 * @returns {sap.ui.core.date.UniversalDate} The year's end date for the given universal date
@@ -259,7 +320,7 @@ sap.ui.define(['sap/ui/core/date/UniversalDate', 'sap/ui/core/Locale', 'sap/ui/c
 			oUniversalDate.setFullYear(oUniversalDate.getFullYear() + 1);
 			oUniversalDate.setMonth(0);
 			oUniversalDate.setDate(0);
-			return UniversalDateUtils.resetEndTime(oUniversalDate);
+			return UniversalDateUtils.resetStartTime(oUniversalDate);
 		};
 
 		/**
@@ -373,6 +434,33 @@ sap.ui.define(['sap/ui/core/date/UniversalDate', 'sap/ui/core/Locale', 'sap/ui/c
 			currentWeek: function () {
 				return UniversalDateUtils.getRange(0, "WEEK");
 			},
+
+			/**
+			 * @returns {sap.ui.core.date.UniversalDate[]} Array with start and end date of the first day of the current week
+			 * @private
+			 * @ui5-restricted sap.ui.comp
+			 */
+			firstDayOfWeek: function () {
+				var oStartDate = UniversalDateUtils.getWeekStartDate();
+				return [
+					oStartDate,
+					UniversalDateUtils.resetEndTime(oStartDate)
+				];
+			},
+
+			/**
+			 * @returns {sap.ui.core.date.UniversalDate[]} Array with start and end date of the last day of the current week
+			 * @private
+			 * @ui5-restricted sap.ui.comp
+			 */
+			lastDayOfWeek: function () {
+				var oEndDate = UniversalDateUtils.getWeekLastDate();
+				return [
+					oEndDate,
+					UniversalDateUtils.resetEndTime(oEndDate)
+				];
+			},
+
 			/**
 			 * @returns {sap.ui.core.date.UniversalDate[]} Array with start and end date of next week's
 			 * @private
@@ -409,13 +497,40 @@ sap.ui.define(['sap/ui/core/date/UniversalDate', 'sap/ui/core/Locale', 'sap/ui/c
 				return UniversalDateUtils.getRange(-1, "MONTH");
 			},
 			/**
-			 * @returns {sap.ui.core.date.UniversalDate[]} Array with start and end date of current month's
+			 * @returns {sap.ui.core.date.UniversalDate[]} Array with start and end date of current month
 			 * @private
 			 * @ui5-restricted sap.ui.comp
 			 */
 			currentMonth: function () {
 				return UniversalDateUtils.getRange(0, "MONTH");
 			},
+
+			/**
+			 * @returns {sap.ui.core.date.UniversalDate[]} Array with start and end date of first day of the current month
+			 * @private
+			 * @ui5-restricted sap.ui.comp
+			 */
+			firstDayOfMonth: function () {
+				var oStartDate = UniversalDateUtils.getMonthStartDate();
+				return [
+					oStartDate,
+					UniversalDateUtils.resetEndTime(oStartDate)
+				];
+			},
+
+			/**
+			 * @returns {sap.ui.core.date.UniversalDate[]} Array with start and end date of last day of the current month
+			 * @private
+			 * @ui5-restricted sap.ui.comp
+			 */
+			lastDayOfMonth: function () {
+				var oEndDate = UniversalDateUtils.getMonthEndDate();
+				return [
+					oEndDate,
+					UniversalDateUtils.resetEndTime(oEndDate)
+				];
+			},
+
 			/**
 			 * @returns {sap.ui.core.date.UniversalDate[]} Array with start and end date of next month's
 			 * @private
@@ -451,6 +566,33 @@ sap.ui.define(['sap/ui/core/date/UniversalDate', 'sap/ui/core/Locale', 'sap/ui/c
 			lastQuarter: function () {
 				return UniversalDateUtils.getRange(-1, "QUARTER");
 			},
+
+			/**
+			 * @returns {sap.ui.core.date.UniversalDate[]} Array with start and end date of first day of the current quarter
+			 * @private
+			 * @ui5-restricted sap.ui.comp
+			 */
+			firstDayOfQuarter: function () {
+				var oStartDate = UniversalDateUtils.getQuarterStartDate();
+				return [
+					oStartDate,
+					UniversalDateUtils.resetEndTime(oStartDate)
+				];
+			},
+
+			/**
+			 * @returns {sap.ui.core.date.UniversalDate[]} Array with start and end date of last day of the current quarter
+			 * @private
+			 * @ui5-restricted sap.ui.comp
+			 */
+			lastDayOfQuarter: function () {
+				var oEndDate = UniversalDateUtils.getQuarterEndDate();
+				return [
+					oEndDate,
+					UniversalDateUtils.resetEndTime(oEndDate)
+				];
+			},
+
 			/**
 			 * @returns {sap.ui.core.date.UniversalDate[]} Array with start and end date of current quarter
 			 * @private
@@ -510,6 +652,34 @@ sap.ui.define(['sap/ui/core/date/UniversalDate', 'sap/ui/core/Locale', 'sap/ui/c
 			lastYear: function () {
 				return UniversalDateUtils.getRange(-1, "YEAR");
 			},
+
+			/**
+			 * @returns {sap.ui.core.date.UniversalDate[]} Array with start and end date of first day of the current year
+			 * @private
+			 * @ui5-restricted sap.ui.comp
+			 */
+			firstDayOfYear: function () {
+				var oStartDate = UniversalDateUtils.getYearStartDate();
+				return [
+					oStartDate,
+					UniversalDateUtils.resetEndTime(oStartDate)
+				];
+			},
+
+			/**
+			 * @returns {sap.ui.core.date.UniversalDate[]} Array with start and end date of last day of the current year
+			 * @private
+			 * @ui5-restricted sap.ui.comp
+			 */
+			lastDayOfYear: function () {
+				var oEndDate = UniversalDateUtils.getYearEndDate();
+
+				return [
+					oEndDate,
+					UniversalDateUtils.resetEndTime(oEndDate)
+				];
+			},
+
 			/**
 			 * @returns {sap.ui.core.date.UniversalDate[]} Array with start and end date of current year
 			 * @private
@@ -558,7 +728,7 @@ sap.ui.define(['sap/ui/core/date/UniversalDate', 'sap/ui/core/Locale', 'sap/ui/c
 				var oToday = UniversalDateUtils.createNewUniversalDate();
 				return [
 					UniversalDateUtils.resetStartTime(oToday),
-					UniversalDateUtils.getYearEndDate(oToday)
+					UniversalDateUtils.resetEndTime(UniversalDateUtils.getYearEndDate(oToday))
 				];
 			}
 		};

package/src/sap/ui/core/delegate/ItemNavigation.js

@@ -82,7 +82,7 @@ sap.ui.define([
 	 * @param {Element[]} aItemDomRefs Array of DOM references representing the items for the navigation
 	 * @param {boolean} [bNotInTabChain=false] Whether the selected element should be in the tab chain or not
 	 *
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 * @alias sap.ui.core.delegate.ItemNavigation
 	 * @public
 	 */

package/src/sap/ui/core/delegate/ScrollEnablement.js

@@ -58,7 +58,7 @@ sap.ui.define([
 		 *
 		 * @protected
 		 * @alias sap.ui.core.delegate.ScrollEnablement
-		 * @version 1.97.1
+		 * @version 1.100.0
 		 * @author SAP SE
 		 */
 		var ScrollEnablement = BaseObject.extend("sap.ui.core.delegate.ScrollEnablement", /** @lends sap.ui.core.delegate.ScrollEnablement.prototype */ {
@@ -217,12 +217,12 @@ sap.ui.define([
 			},
 			/**
 			 * Scrolls to a specific position in scroll container.
-			 * @param {int} iHorizontalPosition Horizontal position of the scrollbar
-			 * @param {int} iVerticalPosition Vertical position of the scrollbar
-			 * @param {int} [iTime=0]
+			 * @param {int} x Horizontal position of the scrollbar
+			 * @param {int} y Vertical position of the scrollbar
+			 * @param {int} [time=0]
 			 *           The duration of animated scrolling in milliseconds. To scroll immediately without animation,
 			 *           give 0 as value.
-			 * @param {function} fnCallback
+			 * @param {function} fnScrollEndCallback
 			 * @returns {this}
 			 * @public
 			 */
@@ -246,7 +246,10 @@ sap.ui.define([
 					$OffsetParent = $Element.offsetParent(),
 					oAddUpPosition;
 
-				while (!$OffsetParent.is(this._$Container)) {
+				// Not positioned elements (position = "unset" or "fixed") are skipped and not returned as offsetParent.
+				// If the this._$Container is not positioned this function ends in infinite loop.
+				// Last value returned from offsetParent is the root html element or null.
+				while (!$OffsetParent.is(this._$Container) && !$OffsetParent.is("html") && $OffsetParent.length) {
 					oAddUpPosition = $OffsetParent.position();
 					oElementPosition.top += oAddUpPosition.top;
 					oElementPosition.left += oAddUpPosition.left;

package/src/sap/ui/core/dnd/DragAndDrop.js

@@ -4,15 +4,18 @@
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([
+	"../library",
 	"sap/ui/Device",
 	"../UIArea",
 	"sap/ui/thirdparty/jquery",
 	// jQuery Plugin "control"
 	"sap/ui/dom/jquery/control"
 ],
-function(Device, UIArea, jQuery) {
+function(lib, Device, UIArea, jQuery) {
 	"use strict";
 
+	var RelativeDropPosition = lib.dnd.RelativeDropPosition;
+
 	/**
 	 * Contains classes and helpers related to drag & drop functionality.
 	 *
@@ -267,7 +270,7 @@ function(Device, UIArea, jQuery) {
 			/**
 			 * Returns the calculated position of the drop action relative to the valid dropped control.
 			 *
-			 * @returns {string}
+			 * @returns {sap.ui.core.dnd.RelativeDropPosition}
 			 * @protected
 			 */
 			getDropPosition: function() {
@@ -323,7 +326,7 @@ function(Device, UIArea, jQuery) {
 			};
 
 		if (!sDropPosition || sDropPosition == "On") {
-			sRelativePosition = "On";
+			sRelativePosition = RelativeDropPosition.On;
 			sDropLayout = "";
 		} else if (sDropLayout == "Horizontal") {
 			var iCursorX = oEvent.pageX - mDropRect.left;
@@ -333,27 +336,27 @@ function(Device, UIArea, jQuery) {
 			if (sDropPosition == "Between") {
 				mStyle.width = "";
 				if (iCursorX < mDropRect.width * 0.5) {
-					sRelativePosition = "Before";
+					sRelativePosition = RelativeDropPosition.Before;
 					mStyle.left = mDropRect.left;
 				} else {
-					sRelativePosition = "After";
+					sRelativePosition = RelativeDropPosition.After;
 					mStyle.left = mDropRect.right;
 				}
 			} else if (sDropPosition == "OnOrBetween") {
 				if (iCursorX < mDropRect.width * 0.25) {
-					sRelativePosition = "Before";
+					sRelativePosition = RelativeDropPosition.Before;
 					mStyle.left = mDropRect.left;
 					mStyle.width = "";
 				} else if (iCursorX > mDropRect.width * 0.75) {
-					sRelativePosition = "After";
+					sRelativePosition = RelativeDropPosition.After;
 					mStyle.left = mDropRect.right;
 					mStyle.width = "";
 				} else {
-					sRelativePosition = "On";
+					sRelativePosition = RelativeDropPosition.On;
 				}
 			}
-			if (sRelativePosition != "On" && sap.ui.getCore().getConfiguration().getRTL()) {
-				sRelativePosition = (sRelativePosition == "After") ? "Before" : "After";
+			if (sRelativePosition != RelativeDropPosition.On && sap.ui.getCore().getConfiguration().getRTL()) {
+				sRelativePosition = (sRelativePosition == RelativeDropPosition.After) ? RelativeDropPosition.Before : RelativeDropPosition.After;
 			}
 		} else {
 			var iCursorY = oEvent.pageY - mDropRect.top;
@@ -363,23 +366,23 @@ function(Device, UIArea, jQuery) {
 			if (sDropPosition == "Between") {
 				mStyle.height = "";
 				if (iCursorY < mDropRect.height * 0.5) {
-					sRelativePosition = "Before";
+					sRelativePosition = RelativeDropPosition.Before;
 					mStyle.top = mDropRect.top;
 				} else {
-					sRelativePosition = "After";
+					sRelativePosition = RelativeDropPosition.After;
 					mStyle.top = mDropRect.bottom;
 				}
 			} else if (sDropPosition == "OnOrBetween") {
 				if (iCursorY < mDropRect.height * 0.25) {
-					sRelativePosition = "Before";
+					sRelativePosition = RelativeDropPosition.Before;
 					mStyle.top = mDropRect.top;
 					mStyle.height = "";
 				} else if (iCursorY > mDropRect.height * 0.75) {
-					sRelativePosition = "After";
+					sRelativePosition = RelativeDropPosition.After;
 					mStyle.top = mDropRect.bottom;
 					mStyle.height = "";
 				} else {
-					sRelativePosition = "On";
+					sRelativePosition = RelativeDropPosition.On;
 				}
 			}
 		}
@@ -388,7 +391,7 @@ function(Device, UIArea, jQuery) {
 			return sRelativePosition;
 		}
 
-		if (sRelativePosition == "On") {
+		if (sRelativePosition == RelativeDropPosition.On) {
 			mStyle.top = mDropRect.top;
 			mStyle.left = mDropRect.left;
 			mStyle.width = mDropRect.width;
@@ -595,8 +598,8 @@ function(Device, UIArea, jQuery) {
 		var aDropInfos = [];
 		oValidDropControl = oControl;
 
-		// find the first valid drop control and corresponding valid DropInfos at the control hierarchy
-		for (var i = 0; i < 20 && oValidDropControl; i++, oValidDropControl = oValidDropControl.getParent()) {
+		// find the first valid drop control and corresponding valid DropInfos from the dom-control hierarchy
+		for (var i = 0; i < 20 && oValidDropControl; i++, oValidDropControl = oValidDropControl.$ && oValidDropControl.$().parent().control(0, true)) {
 			aDropInfos = getValidDropInfos(oValidDropControl, aValidDragInfos, oEvent);
 			if (aDropInfos.length) {
 				break;

package/src/sap/ui/core/dnd/DragDropBase.js

@@ -38,7 +38,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.core.Element
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 *
 	 * @public
 	 * @since 1.52

package/src/sap/ui/core/dnd/DragDropInfo.js

@@ -22,7 +22,7 @@ sap.ui.define(["./DragInfo", "./DropInfo", "sap/ui/Device", "sap/base/Log"],
 	 * @extends sap.ui.core.dnd.DropInfo
 	 *
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 *
 	 * @public
 	 * @since 1.52

package/src/sap/ui/core/dnd/DragInfo.js

@@ -22,7 +22,7 @@ sap.ui.define(["./DragDropBase"],
 	 * @extends sap.ui.core.dnd.DragDropBase
 	 *
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 *
 	 * @public
 	 * @since 1.56

package/src/sap/ui/core/dnd/DropInfo.js

@@ -21,7 +21,7 @@ sap.ui.define(["./DragDropBase"],
 	 * @extends sap.ui.core.dnd.DragDropBase
 	 *
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 *
 	 * @public
 	 * @since 1.56
@@ -85,7 +85,7 @@ sap.ui.define(["./DragDropBase"],
 			 * @param {object} oControlEvent.getParameters
 			 * @param {sap.ui.core.Element} oControlEvent.getParameters.target The target element on which the dragged element will be dropped
 			 * @param {sap.ui.core.dnd.DragSession} oControlEvent.getParameters.dragSession The UI5 <code>dragSession</code> object that exists only during drag and drop
-			 * @param {string} oControlEvent.getParameters.dropPosition The calculated position of the drop action relative to the <code>target</code>, possible values are <code>Before</code>, <code>On</code>, <code>After</code>
+			 * @param {sap.ui.core.dnd.RelativeDropPosition} oControlEvent.getParameters.dropPosition The calculated position of the drop action relative to the <code>target</code>.
 			 * @param {Event} oControlEvent.getParameters.browserEvent The underlying browser event
 			 * @public
 			 * @since 1.56
@@ -104,7 +104,7 @@ sap.ui.define(["./DragDropBase"],
 			 * @param {sap.ui.core.dnd.DragSession} oControlEvent.getParameters.dragSession The UI5 <code>dragSession</code> object that exists only during drag and drop
 			 * @param {sap.ui.core.Element} oControlEvent.getParameters.draggedControl The element being dragged
 			 * @param {sap.ui.core.Element} oControlEvent.getParameters.droppedControl The element being dropped
-			 * @param {string} oControlEvent.getParameters.dropPosition The calculated position of the drop action relative to the <code>droppedControl</code>, possible values are <code>Before</code>, <code>On</code>, <code>After</code>
+			 * @param {sap.ui.core.dnd.RelativeDropPosition} oControlEvent.getParameters.dropPosition The calculated position of the drop action relative to the <code>droppedControl</code>.
 			 * @param {Event} oControlEvent.getParameters.browserEvent The underlying browser event
 			 * @public
 			 */