@openui5/sap.ui.core 1.108.2 → 1.110.0

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -231,6 +231,36 @@ sap.ui.define(['./UniversalDate', '../CalendarType', './_Calendars'],
 		return this._setUTCJapanese(oJapanese);
 	};
 
+	/**
+	 * Note: The resulting year is the Gregorian year
+	 *
+	 * @override
+	 * @see sap.ui.core.date.UniversalDate#getWeek
+	 */
+	Japanese.prototype.getWeek = function(oLocale, vCalendarWeekNumbering) {
+		// Use the Gregorian year (from this.oDate), because the Japanese emperor year lacks the
+		// information of the era which makes the year not unique.
+		// Using the Gregorian year is valid, because Japanese#constructor is able to calculate the
+		// era and Japanese emperor year from the Gregorian year.
+		return UniversalDate.getWeekByDate(this.sCalendarType, this.oDate.getFullYear(),
+			this.getMonth(), this.getDate(), oLocale, vCalendarWeekNumbering);
+	};
+
+	/**
+	 * Note: The resulting year is the Gregorian year
+	 *
+	 * @override
+	 * @see sap.ui.core.date.UniversalDate#getUTCWeek
+	 */
+	Japanese.prototype.getUTCWeek = function(oLocale, vCalendarWeekNumbering) {
+		// Use the Gregorian year (from this.oDate), because the Japanese emperor year lacks the
+		// information of the era which makes the year not unique.
+		// Using the Gregorian year is valid, because Japanese#constructor is able to calculate the
+		// era and Japanese emperor year from the Gregorian year.
+		return UniversalDate.getWeekByDate(this.sCalendarType, this.oDate.getUTCFullYear(),
+			this.getUTCMonth(), this.getUTCDate(), oLocale, vCalendarWeekNumbering);
+	};
+
 	_Calendars.set(CalendarType.Japanese, Japanese);
 
 	return Japanese;

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,6 +1,6 @@
 /*
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -81,7 +81,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.108.2
+	 * @version 1.110.0
 	 * @alias sap.ui.core.delegate.ItemNavigation
 	 * @public
 	 */
@@ -144,9 +144,10 @@ sap.ui.define([
 	};
 
 	/**
-	 * The 'beforeFocus' event is fired before the actual item is focused.
+	 * The <code>BeforeFocus</code> event is fired before the actual item is focused.
+	 * Listeners may prevent the focus by calling the <code>preventDefault</code> method on the event object.
 	 *
-	 * @name sap.ui.core.delegate.ItemNavigation#beforeFocus
+	 * @name sap.ui.core.delegate.ItemNavigation#BeforeFocus
 	 * @event
 	 * @param {int} index Index of the item
 	 * @param {jQuery.Event} event Event that leads to the focus change
@@ -154,10 +155,10 @@ sap.ui.define([
 	 */
 
 	/**
-	 * The 'afterFocus' event is fired after the actual item is focused.
+	 * The <code>AfterFocus</code> event is fired after the actual item is focused.
 	 * The control can register to this event and react on the focus change.
 	 *
-	 * @name sap.ui.core.delegate.ItemNavigation#afterFocus
+	 * @name sap.ui.core.delegate.ItemNavigation#AfterFocus
 	 * @event
 	 * @param {int} index Index of the item
 	 * @param {jQuery.Event} event Event that leads to the focus change
@@ -165,12 +166,12 @@ sap.ui.define([
 	 */
 
 	/**
-	 * The 'borderReached' event is fired if the border of the items is reached and
+	 * The <code>BorderReached</code> event is fired if the border of the items is reached and
 	 * no cycling is used, meaning an application can react on this.
 	 *
 	 * For example if the first item is focused and the Arrow Left key is pressed.
 	 *
-	 * @name sap.ui.core.delegate.ItemNavigation#borderReached
+	 * @name sap.ui.core.delegate.ItemNavigation#BorderReached
 	 * @event
 	 * @param {int} index Index of the item
 	 * @param {jQuery.Event} event Event that leads to the focus change
@@ -178,10 +179,10 @@ sap.ui.define([
 	 */
 
 	/**
-	 * The 'focusAgain' event is fired if the current focused item is focused again
+	 * The <code>FocusAgain</code> event is fired if the current focused item is focused again
 	 * (e.g. click again on focused item.)
 	 *
-	 * @name sap.ui.core.delegate.ItemNavigation#focusAgain
+	 * @name sap.ui.core.delegate.ItemNavigation#FocusAgain
 	 * @event
 	 * @param {int} index Index of the item
 	 * @param {jQuery.Event} event Event that leads to the focus change
@@ -189,9 +190,9 @@ sap.ui.define([
 	 */
 
 	/**
-	 * The 'focusLeave' event fired if the focus is set outside the control handled by the <code>ItemNavigation</code>.
+	 * The <code>FocusLeave</code> event fired if the focus is set outside the control handled by the <code>ItemNavigation</code>.
 	 *
-	 * @name sap.ui.core.delegate.ItemNavigation#focusLeave
+	 * @name sap.ui.core.delegate.ItemNavigation#FocusLeave
 	 * @event
 	 * @param {int} index Index of the item
 	 * @param {jQuery.Event} event Event that leads to the focus change
@@ -575,10 +576,13 @@ sap.ui.define([
 			return;
 		}
 
-		this.fireEvent(ItemNavigation.Events.BeforeFocus, {
+		if (!this.fireEvent(ItemNavigation.Events.BeforeFocus, {
 			index: iIndex,
 			event: oEvent
-		});
+		}, /* bAllowPreventDefault */ true)) {
+			Log.info("Focus prevented on ID: " + this.aItemDomRefs[this.iFocusedIndex].id, "focusItem", "ItemNavigation");
+			return;
+		}
 
 		this.setFocusedIndex(iIndex);
 		this.bISetFocus = true;

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -58,7 +58,7 @@ sap.ui.define([
 		 *
 		 * @protected
 		 * @alias sap.ui.core.delegate.ScrollEnablement
-		 * @version 1.108.2
+		 * @version 1.110.0
 		 * @author SAP SE
 		 */
 		var ScrollEnablement = BaseObject.extend("sap.ui.core.delegate.ScrollEnablement", /** @lends sap.ui.core.delegate.ScrollEnablement.prototype */ {
@@ -77,6 +77,7 @@ sap.ui.define([
 				this._scrollY = 0;
 				this._scrollCoef = 0.9; // Approximation coefficient used to mimic page down and page up behaviour when [CTRL] + [RIGHT] and [CTRL] + [LEFT] is used
 				this._iLastMaxScrollTop = 0;
+				this._iScrollPaddingTop = 0;
 
 				initDelegateMembers(this);
 
@@ -219,6 +220,21 @@ sap.ui.define([
 				}
 				return this;
 			},
+			/**
+			 * Sets the top offset of the optimal viewing region of the scrollport:
+			 * the region used as the target region for placing things in view of the user.
+			 * This offset is required when the topmost part of the scroll container is overlapped
+			 * by other content (e.g. overlapped by the sticky header content of the scrollable page)
+			 *
+			 * @param {number} iValue
+			 * @private
+			 * @ui5-restricted sap.uxap.ObjectPageLayout, sap.f.DynamicPage
+			 */
+			setScrollPaddingTop : function(iValue) {
+				if (typeof iValue === 'number') {
+					this._iScrollPaddingTop = iValue;
+				}
+			},
 			/**
 			 * Scrolls to a specific position in scroll container.
 			 * @param {int} x Horizontal position of the scrollbar
@@ -272,10 +288,12 @@ sap.ui.define([
 			 * @param {int[]} [aOffset=[0,0]]
 			 *           Specifies an additional left and top offset of the target scroll position, relative to
 			 *           the upper left corner of the DOM element
+			 * @param {boolean} [bSkipElementsInScrollport] The configuration of the parameter for scrolling only if the element is not in the view port -
+			 * i.e. if bSkipElementsInScrollport is set to true, there will be no scrolling if the element is already in the view port
 			 * @returns {this}
 			 * @protected
 			 */
-			scrollToElement: function(oElement, iTime, aOffset) {
+			scrollToElement: function(oElement, iTime, aOffset, bSkipElementsInScrollport) {
 				aOffset = aOffset || [0, 0];
 
 				// do nothing if _$Container is not a (grand)parent of oElement
@@ -285,6 +303,15 @@ sap.ui.define([
 						return this;
 				}
 
+				// the visible part of the scrollport is positioned below the
+				// <code>this._iScrollPaddingTop</code>, so we offset that padding as well
+				aOffset[1] -= this._iScrollPaddingTop;
+
+				if (bSkipElementsInScrollport && this._isInScrollport(oElement, aOffset)) {
+					return this;
+				}
+
+
 				var $Element = jQuery(oElement),
 					oScrollPosition = this.getChildPosition($Element),
 					iLeftScroll = this.getScrollLeft() + oScrollPosition.left + aOffset[0],
@@ -797,6 +824,16 @@ sap.ui.define([
 						fnScrollEndCallback && fnScrollEndCallback();
 					}
 				}
+			},
+
+			//checks if the element is already visible in the view port
+			_isInScrollport: function(oElement, aOffset) {
+				var oElementRect = oElement.getBoundingClientRect(),
+					oContainerRect = this._$Container[0].getBoundingClientRect(),
+					iContainerRectTop = oContainerRect.top - aOffset[1];
+
+				return Math.ceil(oElementRect.top) >= Math.floor(iContainerRectTop)
+					&& Math.floor(oElementRect.bottom) <= Math.ceil(oContainerRect.bottom);
 			}
 		};
 

package/src/sap/ui/core/designtime/ComponentContainer.designtime.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/core/designtime/Icon.designtime.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/core/designtime/library.designtime.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/core/designtime/mvc/ControllerExtensionTemplate.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/core/designtime/mvc/View.designtime.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/core/designtime/mvc/XMLView.designtime.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([
@@ -309,8 +309,8 @@ function(lib, Device, Element, UIArea, jQuery, Configuration) {
 			return;
 		}
 
-		var mIndicatorConfig = oEvent.dragSession && oEvent.dragSession.getIndicatorConfig(),
-			mClientRect = oDropTarget.getBoundingClientRect(),
+		var mClientRect = oValidDropControl.getDropAreaRect ? oValidDropControl.getDropAreaRect() : oDropTarget.getBoundingClientRect(),
+			mIndicatorConfig = oEvent.dragSession && oEvent.dragSession.getIndicatorConfig(),
 			iPageYOffset = window.pageYOffset,
 			iPageXOffset = window.pageXOffset,
 			$Indicator = getDropIndicator(),

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -37,7 +37,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.core.Element
 	 * @author SAP SE
-	 * @version 1.108.2
+	 * @version 1.110.0
 	 *
 	 * @public
 	 * @since 1.52

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -22,7 +22,7 @@ sap.ui.define(["./DragInfo", "./DropInfo", "sap/base/Log"],
 	 * @extends sap.ui.core.dnd.DropInfo
 	 *
 	 * @author SAP SE
-	 * @version 1.108.2
+	 * @version 1.110.0
 	 *
 	 * @public
 	 * @since 1.52

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -22,7 +22,7 @@ sap.ui.define(["./DragDropBase"],
 	 * @extends sap.ui.core.dnd.DragDropBase
 	 *
 	 * @author SAP SE
-	 * @version 1.108.2
+	 * @version 1.110.0
 	 *
 	 * @public
 	 * @since 1.56

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -21,7 +21,7 @@ sap.ui.define(["./DragDropBase"],
 	 * @extends sap.ui.core.dnd.DragDropBase
 	 *
 	 * @author SAP SE
-	 * @version 1.108.2
+	 * @version 1.110.0
 	 *
 	 * @public
 	 * @since 1.56