@openui5/sap.m 1.103.0 → 1.105.0

package/src/sap/m/DynamicDateOption.js

@@ -13,7 +13,8 @@ sap.ui.define([
 	'sap/ui/unified/Calendar',
 	'sap/ui/unified/DateRange',
 	'sap/ui/unified/calendar/MonthPicker',
-	'sap/ui/unified/calendar/CustomMonthPicker'],
+	'sap/ui/unified/calendar/CustomMonthPicker',
+	'sap/ui/core/format/TimezoneUtil'],
 	function(
 		Element,
 		Label,
@@ -22,7 +23,8 @@ sap.ui.define([
 		Calendar,
 		DateRange,
 		MonthPicker,
-		CustomMonthPicker) {
+		CustomMonthPicker,
+		TimezoneUtil) {
 		"use strict";
 
 		/**
@@ -36,7 +38,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Element
 		 *
 		 * @author SAP SE
-		 * @version 1.103.0
+		 * @version 1.105.0
 		 *
 		 * @public
 		 * @since 1.92
@@ -131,7 +133,12 @@ sap.ui.define([
 					);
 				}
 
-				oInputControl = this._createControl(i, aParams[i].getType(), oValue, fnControlsUpdated, valueHelpUiTypesCount);
+				var bUTC = false;
+				if (oControl && oValue) {
+					bUTC = oControl._checkFormatterUTCTimezone(oValue.operator);
+				}
+
+				oInputControl = this._createControl(i, aParams[i].getType(), oValue, fnControlsUpdated, valueHelpUiTypesCount, bUTC);
 
 				aControls.push(oInputControl);
 				oControl.aControlsByParameters[this.getKey()].push(oInputControl);
@@ -318,7 +325,7 @@ sap.ui.define([
 
 		// PRIVATE
 
-		DynamicDateOption.prototype._createControl = function(iIndex, sUIType, oValue, fnControlsUpdated, valueHelpUiTypesCount) {
+		DynamicDateOption.prototype._createControl = function(iIndex, sUIType, oValue, fnControlsUpdated, valueHelpUiTypesCount, bUTC) {
 			var oInputControl;
 
 			switch (sUIType) {
@@ -326,18 +333,18 @@ sap.ui.define([
 					oInputControl = this._createIntegerControl(oValue, iIndex, fnControlsUpdated);
 					break;
 				case "date":
-					oInputControl = this._createDateControl(oValue, iIndex, fnControlsUpdated);
+					oInputControl = this._createDateControl(oValue, iIndex, fnControlsUpdated, bUTC);
 					break;
 				case "datetime":
 					if (valueHelpUiTypesCount === 1) {
 						// Returns DateTimePicker PopupContent control (single "datetime" option)
-						oInputControl = this._createDateTimeInnerControl(oValue, iIndex, fnControlsUpdated);
+						oInputControl = this._createDateTimeInnerControl(oValue, iIndex, fnControlsUpdated, bUTC);
 					} else if (valueHelpUiTypesCount === 2) {
-						oInputControl = this._createDateTimeControl(oValue, iIndex, fnControlsUpdated);
+						oInputControl = this._createDateTimeControl(oValue, iIndex, fnControlsUpdated, bUTC);
 					}
 					break;
 				case "daterange":
-					oInputControl = this._createDateRangeControl(oValue, iIndex, fnControlsUpdated);
+					oInputControl = this._createDateRangeControl(oValue, iIndex, fnControlsUpdated, bUTC);
 					break;
 				case "month":
 					oInputControl = this._createMonthControl(oValue, iIndex, fnControlsUpdated);
@@ -371,7 +378,7 @@ sap.ui.define([
 		};
 
 		DynamicDateOption.prototype._createDateTimeControl = function(oValue, iIndex, fnControlsUpdated) {
-			var oControl = new DateTimePicker();
+			var oControl = new DateTimePicker({timezone: TimezoneUtil.getLocalTimezone()});
 
 			if (oValue && this.getKey() === oValue.operator) {
 				oControl.setDateValue(oValue.values[iIndex]);
@@ -386,14 +393,21 @@ sap.ui.define([
 			return oControl;
 		};
 
-		DynamicDateOption.prototype._createDateControl = function(oValue, iIndex, fnControlsUpdated) {
+		DynamicDateOption.prototype._createDateControl = function(oValue, iIndex, fnControlsUpdated, bUTC) {
 			var oControl = new Calendar({
 				width: "100%"
 			});
+			var oInputControlValue;
 
 			if (oValue && this.getKey() === oValue.operator) {
+				oInputControlValue = new Date(oValue.values[iIndex].getTime());
+
+				if (bUTC) {
+					oInputControlValue.setMinutes(oInputControlValue.getMinutes() + new Date().getTimezoneOffset());
+				}
+
 				oControl.addSelectedDate(new DateRange({
-					startDate: oValue.values[iIndex]
+					startDate: oInputControlValue
 				}));
 			}
 
@@ -409,7 +423,7 @@ sap.ui.define([
 		/**
 		 * Returns DateTimePicker PopupContent control (single "datetime" option)
 		 */
-		DynamicDateOption.prototype._createDateTimeInnerControl = function(oValue, iIndex, fnControlsUpdated) {
+		DynamicDateOption.prototype._createDateTimeInnerControl = function(oValue, iIndex, fnControlsUpdated, bUTC) {
 			var oControl = new DateTimePicker({
 					width: "100%"
 				}),
@@ -424,6 +438,11 @@ sap.ui.define([
 
 			if (oValue && this.getKey() === oValue.operator) {
 				var oValueCopy = new Date(oValue.values[iIndex]); // a copy is used to prevent time setting on pressing Cancel button
+
+				if (bUTC) {
+					oValueCopy.setMinutes(oValueCopy.getMinutes() + new Date().getTimezoneOffset());
+				}
+
 				oPopupContent.getCalendar().addSelectedDate(new DateRange({
 					startDate: oValueCopy
 				}));
@@ -453,7 +472,7 @@ sap.ui.define([
 			return oPopupContent;
 		};
 
-		DynamicDateOption.prototype._createDateRangeControl = function(oValue, iIndex, fnControlsUpdated) {
+		DynamicDateOption.prototype._createDateRangeControl = function(oValue, iIndex, fnControlsUpdated, bUTC) {
 			var oControl = new Calendar({
 				intervalSelection: true,
 				width: "100%"
@@ -461,9 +480,17 @@ sap.ui.define([
 			if (oValue && this.getKey() === oValue.operator) {
 				// a date range UI type maps to 2 consecutive date parameters from the value
 				// they also should be the last 2 parameters
+				var oInputControlStartValue = new Date(oValue.values[iIndex].getTime());
+				var oInputControlEndValue = new Date(oValue.values[iIndex + 1].getTime());
+
+				if (bUTC) {
+					oInputControlStartValue.setMinutes(oInputControlStartValue.getMinutes() + new Date().getTimezoneOffset());
+					oInputControlEndValue.setMinutes(oInputControlEndValue.getMinutes() + new Date().getTimezoneOffset());
+				}
+
 				oControl.addSelectedDate(new DateRange({
-					startDate: oValue.values[iIndex],
-					endDate: oValue.values[iIndex + 1]
+					startDate: oInputControlStartValue,
+					endDate: oInputControlEndValue
 				}));
 			}
 

package/src/sap/m/DynamicDateRange.js

@@ -121,7 +121,7 @@ sap.ui.define([
 		 * is opened. The dialog is closed via a date time period value selection or by pressing the "Cancel" button.
 		 *
 		 * @author SAP SE
-		 * @version 1.103.0
+		 * @version 1.105.0
 		 *
 		 * @constructor
 		 * @public
@@ -280,7 +280,23 @@ sap.ui.define([
 							"NEXTYEAR",
 							"DATETIME"
 						]
-					}
+					},
+
+					/**
+					 * Determines whether the input field of the control is hidden or visible.
+					 * When set to <code>true</code>, the input field becomes invisible and there is no way to open the value help popover.
+					 * In that case it can be opened by another control through calling of control's <code>openBy</code> method, and
+					 * the opening control's DOM reference must be provided as parameter.
+					 *
+					 * Note: Since the Dynamic Date Range is not responsible for accessibility attributes of the control which opens its popover,
+					 * those attributes should be added by the application developer. The following is recommended to be added to the
+					 * opening control: a text or tooltip that describes the action (example: "Open Dynamic Date Range"), and also aria-haspopup
+					 * attribute with value of <code>true</code>.
+					 *
+					 * @since 1.105
+					 */
+					 hideInput: { type: "boolean", group: "Misc", defaultValue: false }
+
 				},
 				aggregations: {
 					_input: { type: "sap.m.Input", multiple: false, visibility: "hidden" },
@@ -413,11 +429,12 @@ sap.ui.define([
 		/**
 		 * Opens the value help dialog.
 		 *
+		 * @param {HTMLElement} oDomRef DOM reference of the opening control. On tablet or desktop, the popover is positioned relatively to this control.
 		 * @returns {void}
 		 * @since 1.92
 		 * @public
 		 */
-		DynamicDateRange.prototype.open = function() {
+		DynamicDateRange.prototype.open = function(oDomRef) {
 			if (this.getEditable() && this.getEnabled()) {
 				this._createPopup();
 				this._createPopupContent();
@@ -456,7 +473,7 @@ sap.ui.define([
 				//reset value help page
 				this._oNavContainer.to(this._oNavContainer.getPages()[0]);
 
-				this._openPopup();
+				this._openPopup(oDomRef);
 			}
 		};
 
@@ -1177,13 +1194,37 @@ sap.ui.define([
 				oControl.isA("sap.ui.unified.calendar.Month");
 		};
 
-		DynamicDateRange.prototype._openPopup = function() {
+		/**
+		 * Opens the value help popover. The popover is positioned relatively to the control given as <code>oDomRef</code> parameter on tablet or desktop
+		 * and is full screen on phone. Therefore the control parameter is only used on tablet or desktop and is ignored on phone.
+		 *
+		 * Note: use this method to open the value help popover only when the <code>hideInput</code> property is set to <code>true</code>. Please consider
+		 * opening of the value help popover by another control only in scenarios that comply with Fiori guidelines. For example, opening the value help
+		 * popover by another popover is not recommended.
+		 * The application developer should implement the following accessibility attributes to the opening control: a text or tooltip that describes
+		 * the action (example: "Open Dynamic Date Range"), and aria-haspopup attribute with value of <code>true</code>.
+		 *
+		 * @since 1.105
+		 * @param {HTMLElement} oDomRef DOM reference of the opening control. On tablet or desktop, the popover is positioned relatively to this control.
+		 * @public
+		 */
+		DynamicDateRange.prototype.openBy = function(oDomRef) {
+			this.open(oDomRef);
+		};
+
+		/**
+		 * Opens the value help popup.
+		 *
+		 * @param {HTMLElement} oDomRef DOM reference of the opening control. On tablet or desktop, the value help popover is positioned relative to this control.
+		 * @private
+		 */
+		 DynamicDateRange.prototype._openPopup = function(oDomRef) {
 			if (!this._oPopup) {
 				return;
 			}
 
 			this._oPopup._getPopup().setExtraContent([this._oInput.getDomRef()]);
-			this._oPopup.openBy(this._oInput);
+			this._oPopup.openBy(oDomRef || this._oInput);
 		};
 
 		DynamicDateRange.prototype._applyValue = function() {
@@ -1428,8 +1469,9 @@ sap.ui.define([
 		};
 
 		DynamicDateRangeInput.prototype.onfocusin = function (oEvent) {
+			var oPopup = this._getControlOrigin()._oPopup;
 			Input.prototype.onfocusin.apply(this, arguments);
-			if (this._getControlOrigin()._oPopup && this._getControlOrigin()._oPopup.isOpen() && !this.isMobileDevice()) {
+			if (oPopup && oPopup.isOpen() && (Device.system.desktop || Device.system.combi)) {
 				this._getControlOrigin()._closePopup();
 			}
 		};

package/src/sap/m/DynamicDateRangeRenderer.js

@@ -3,8 +3,8 @@
  * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
-sap.ui.define(["sap/m/InputBaseRenderer", 'sap/ui/core/Renderer'],
-	function(InputBaseRenderer, Renderer) {
+sap.ui.define([],
+	function() {
 	"use strict";
 
 	/**
@@ -25,6 +25,9 @@ sap.ui.define(["sap/m/InputBaseRenderer", 'sap/ui/core/Renderer'],
 
 		oRm.openStart("div", oControl);
 		oRm.class("sapMDynamicDateRange");
+		if (oControl.getHideInput()) {
+			oRm.class("sapMDDRHiddenInput");
+		}
 		oRm.openEnd();
 
 		oRm.renderControl(oControl._oInput);

package/src/sap/m/DynamicDateUtil.js

@@ -8,9 +8,11 @@
 sap.ui.define([
 	"./StandardDynamicDateOption",
 	"sap/base/Log",
-	"./library"
+	"./library",
+	'sap/ui/core/format/TimezoneUtil',
+	'sap/ui/core/Core'
 ], function(
-	StandardDynamicDateOption, Log, library) {
+	StandardDynamicDateOption, Log, library, TimezoneUtil, Core) {
 	"use strict";
 
 	var STANDARD_KEYS_ARRAY = [
@@ -242,6 +244,25 @@ sap.ui.define([
 		return DynamicDateUtil._options[sKey].toDates(oValue);
 	};
 
+
+	/**
+	 * Returns a date in machine timezone setting, removing the offset added by the application configuration.
+	 *
+	 * @param {Date} oDate A local JS date with added offset
+	 * @returns {Date} A local JS date with removed offset
+	 * @static
+	 * @public
+	 */
+	DynamicDateUtil.removeTimezoneOffset = function(oDate) {
+		var oNewDate = new Date(oDate);
+		var sTimezone = Core.getConfiguration().getTimezone();
+		var iOffsetInSeconds = TimezoneUtil.calculateOffset(oNewDate, sTimezone) - oNewDate.getTimezoneOffset() * 60;
+
+		oNewDate.setSeconds(oNewDate.getSeconds() - iOffsetInSeconds);
+
+		return oNewDate;
+	};
+
 	return DynamicDateUtil;
 
 }, true);

package/src/sap/m/DynamicDateValueHelpUIType.js

@@ -20,7 +20,7 @@ sap.ui.define(['sap/ui/core/Element'],
 		 * @extends sap.ui.core.Element
 		 *
 		 * @author SAP SE
-		 * @version 1.103.0
+		 * @version 1.105.0
 		 *
 		 * @public
 		 * @since 1.92

package/src/sap/m/ExpandableText.js

@@ -100,7 +100,7 @@ function(library,
 	 * @implements sap.ui.core.IFormContent, sap.m.IHyphenation
 	 *
 	 * @author SAP SE
-	 * @version 1.103.0
+	 * @version 1.105.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/FacetFilter.js

@@ -170,7 +170,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.core.Control
 	 * @implements sap.ui.core.IShrinkable
-	 * @version 1.103.0
+	 * @version 1.105.0
 	 *
 	 * @constructor
 	 * @public
@@ -1205,7 +1205,7 @@ sap.ui.define([
 	/**
 	 *
 	 * @param {sap.m.Popover} oPopover the Popover to be opened
-	 * @param {sap.m.Control} oControl The control the popover will be opened "by"
+	 * @param {sap.ui.core.Control} oControl The control the popover will be opened "by"
 	 * @returns {this} <code>this</code> to allow method chaining
 	 * @private
 	 */

package/src/sap/m/FacetFilterItem.js

@@ -20,7 +20,7 @@ sap.ui.define(['./ListItemBase', './library', './FacetFilterItemRenderer'],
 	 * @class
 	 * Represents a value for the {@link sap.m.FacetFilterList} control.
 	 * @extends sap.m.ListItemBase
-	 * @version 1.103.0
+	 * @version 1.105.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/FacetFilterList.js

@@ -52,7 +52,7 @@ sap.ui.define([
 	 * be closed.
 	 *
 	 * @extends sap.m.List
-	 * @version 1.103.0
+	 * @version 1.105.0
 	 *
 	 * @constructor
 	 * @public
@@ -328,7 +328,7 @@ sap.ui.define([
 	 * Returns the keys of the selected elements as an associative array.
 	 * An empty object is returned if no items are selected.
 	 *
-	 * @returns {object} Object with the selected keys
+	 * @returns {Object.<string, string?>} Object with the selected keys
 
 	 * @public
 	 * @since 1.20.3
@@ -345,10 +345,10 @@ sap.ui.define([
 	/**
 	 * Used to pre-select FacetFilterItems, such as when restoring FacetFilterList selections from a variant.
 	 * Keys are cached separately from the actual FacetFilterItems so that they remain even when the physical items are removed by filtering or sorting.
-	 * If aKeys is <code>undefined</code>, <code>null</code>, or {} (empty object) then all keys are deleted.
+	 * If oKeys is <code>undefined</code>, <code>null</code>, or {} (empty object) then all items will be deselected.
 	 * After this method completes, only those items with matching keys will be selected. All other items in the list will be deselected.
 	 *
-	 * @param {object} oKeys
+	 * @param {Object.<string, string?>} oKeys
 	 *         Associative array indicating which FacetFilterItems should be selected in the list. Each property must be set to the value of a FacetFilterItem.key property. Each property value should be set to the FacetFilterItem.text property value. The text value is used to display the FacetFilterItem text when the FacetFilterList button or FacetFilter summary bar is displayed. If no property value is set then the property key is used for the text.
 	 * @type {void}
 	 * @public

package/src/sap/m/FeedContent.js

@@ -28,7 +28,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.103.0
+	 * @version 1.105.0
 	 * @since 1.34
 	 *
 	 * @public

package/src/sap/m/FeedInput.js

@@ -40,7 +40,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.103.0
+	 * @version 1.105.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/FeedListItem.js

@@ -54,7 +54,7 @@ function(
 	 * @extends sap.m.ListItemBase
 	 *
 	 * @author SAP SE
-	 * @version 1.103.0
+	 * @version 1.105.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/FeedListItemAction.js

@@ -19,7 +19,7 @@ sap.ui.define(["sap/ui/core/Element"],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.103.0
+	 * @version 1.105.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/Fiori20Adapter.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 *
 	 *
 	 * @class text
-	 * @version 1.103.0
+	 * @version 1.105.0
 	 * @private
 	 * @since 1.38
 	 * @alias HeaderAdapter
@@ -227,7 +227,7 @@ sap.ui.define([
 	 * Constructor for an sap.m.Fiori20Adapter.
 	 *
 	 * @class text
-	 * @version 1.103.0
+	 * @version 1.105.0
 	 * @private
 	 * @since 1.38
 	 * @alias sap.m.Fiori20Adapter

package/src/sap/m/FlexBox.js

@@ -62,7 +62,7 @@ function(
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.103.0
+	 * @version 1.105.0
 	 *
 	 * @public
 	 * @alias sap.m.FlexBox

package/src/sap/m/FlexItemData.js

@@ -24,7 +24,7 @@ sap.ui.define(["./FlexBoxStylingHelper", "./library", "sap/ui/core/LayoutData"],
 	 * @class
 	 * Holds layout data for a FlexBox / HBox / VBox.
 	 * @extends sap.ui.core.LayoutData
-	 * @version 1.103.0
+	 * @version 1.105.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/FormattedText.js

@@ -44,7 +44,7 @@ function(
 		 * @class
 		 * The FormattedText control allows the usage of a limited set of tags for inline display of formatted text in HTML format.
 		 * @extends sap.ui.core.Control
-		 * @version 1.103.0
+		 * @version 1.105.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/GenericTag.js

@@ -53,7 +53,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.103.0
+	 * @version 1.105.0
 	 *
 	 * @constructor
 	 * @public