@openui5/sap.m 1.117.1 → 1.119.0

package/src/sap/m/DateTimePicker.js

@@ -25,7 +25,7 @@ sap.ui.define([
 	'./ResponsivePopover',
 	'./Button',
 	'sap/ui/core/IconPool',
-	'sap/ui/qunit/utils/waitForThemeApplied',
+	"sap/ui/core/Theming",
 	'sap/ui/core/Configuration',
 	'sap/ui/core/date/UI5Date',
 	'sap/ui/dom/jquery/cursorPos' // provides jQuery.fn.cursorPos
@@ -49,7 +49,7 @@ sap.ui.define([
 	ResponsivePopover,
 	Button,
 	IconPool,
-	waitForThemeApplied,
+	Theming,
 	Configuration,
 	UI5Date
 ) {
@@ -176,7 +176,7 @@ sap.ui.define([
 	 * mobile devices, it opens in full screen.
 	 *
 	 * @extends sap.m.DatePicker
-	 * @version 1.117.1
+	 * @version 1.119.0
 	 *
 	 * @constructor
 	 * @public
@@ -361,7 +361,7 @@ sap.ui.define([
 						new SegmentedButtonItem(this.getId() + "-Switch-Clk", {key: "Clk", text: sTimeText})
 					]
 				});
-				oSwitcher.attachSelect(this._handleSelect, this);
+				oSwitcher.attachSelectionChange(this._handleSelectionChange, this);
 
 				this.setAggregation("_switcher", oSwitcher);
 			}
@@ -390,9 +390,8 @@ sap.ui.define([
 			this.getCalendar().addDelegate(oOnAfterRenderingDelegate);
 		},
 
-		_handleSelect: function(oEvent) {
-
-			var sKey = oEvent.getParameter("key");
+		_handleSelectionChange: function(oEvent) {
+			var sKey = oEvent.getParameter("item").getKey();
 
 			this._switchVisibility(sKey);
 			if (sKey === "Clk") {
@@ -494,17 +493,7 @@ sap.ui.define([
 		DatePicker.prototype.onAfterRendering.apply(this, arguments);
 
 		if (this._getShowTimezone()) {
-			waitForThemeApplied().then(function() {
-				var oDummyContentDomRef = this.$().find(".sapMDummyContent"),
-					iDummyWidth;
-
-				if (!oDummyContentDomRef || !oDummyContentDomRef.length) {
-					return;
-				}
-
-				iDummyWidth = oDummyContentDomRef[0].getBoundingClientRect().width;
-				this.$("inner").css("max-width", (iDummyWidth + 2) + "px");
-			}.bind(this));
+			Theming.attachApplied(this._adjustInnerMaxWidth.bind(this));
 		}
 	};
 
@@ -578,6 +567,7 @@ sap.ui.define([
 
 		this._oTimezonePopup = undefined;
 		this._oPopupContent = undefined; // is destroyed via popup aggregation - just remove reference
+		Theming.detachApplied(this._adjustInnerMaxWidth);
 		Device.media.detachHandler(this._handleWindowResize, this);
 	};
 
@@ -661,6 +651,18 @@ sap.ui.define([
 		return this.setProperty("showCurrentTimeButton", bShow);
 	};
 
+	DateTimePicker.prototype._adjustInnerMaxWidth = function() {
+			var oDummyContentDomRef = this.$().find(".sapMDummyContent"),
+				iDummyWidth;
+
+			if (!oDummyContentDomRef || !oDummyContentDomRef.length) {
+				return;
+			}
+
+			iDummyWidth = oDummyContentDomRef[0].getBoundingClientRect().width;
+			this.$("inner").css("max-width", (iDummyWidth + 2) + "px");
+	};
+
 	DateTimePicker.prototype._getTimezoneNamePopup = function() {
 		var oResourceBundle;
 
@@ -1065,10 +1067,11 @@ sap.ui.define([
 				oDate = UI5Date.getInstance();
 				this._oCalendar.removeAllSelectedDates();
 			}
-			var iMaxTimeMillis = this._oMaxDate.getTime();
 
-			if (oDate.getTime() < this._oMinDate.getTime() || oDate.getTime() > iMaxTimeMillis) {
+			if (oDate.getTime() < this._oMinDate.getTime()) {
 				oDate = this._oMinDate;
+			} else if (oDate.getTime() > this._oMaxDate.getTime()) {
+				oDate = this._oMaxDate;
 			}
 			this._oOKButton.setEnabled(false);
 		}
@@ -1076,7 +1079,7 @@ sap.ui.define([
 		// convert the date to local date for the calendar and the clocks if binding is used
 		if (this._isTimezoneBinding()) {
 			sFormattedDate = this._getPickerParser().format(oDate, this._getTimezone(true));
-			oDate = this._getPickerParser().parse(sFormattedDate, TimezoneUtil.getLocalTimezone())[0];
+			oDate = this._getPickerParser().parse(sFormattedDate)[0];
 		}
 		this._oCalendar.focusDate(oDate);
 
@@ -1118,7 +1121,7 @@ sap.ui.define([
 		}
 
 		if (this._isTimezoneBinding()) {
-			sFormattedDate = this._getPickerParser().format(oDate, TimezoneUtil.getLocalTimezone());
+			sFormattedDate = this._getPickerParser().format(oDate);
 			oParts = this._getPickerParser().parse(sFormattedDate, this._getTimezone(true));
 			oDate = oParts && oParts[0];
 		}

package/src/sap/m/Dialog.js

@@ -173,7 +173,7 @@ function(
 		*
 		* @implements sap.ui.core.PopupInterface
 		* @author SAP SE
-		* @version 1.117.1
+		* @version 1.119.0
 		*
 		* @constructor
 		* @public

package/src/sap/m/DisplayListItem.js

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * @extends sap.m.ListItemBase
 	 *
 	 * @author SAP SE
-	 * @version 1.117.1
+	 * @version 1.119.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/DraftIndicator.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * @abstract
 	 *
 	 * @author SAP SE
-	 * @version 1.117.1
+	 * @version 1.119.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/DynamicDate.js

@@ -38,7 +38,7 @@ sap.ui.define([
 		 * @extends sap.ui.model.SimpleType
 		 *
 		 * @author SAP SE
-		 * @version 1.117.1
+		 * @version 1.119.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/DynamicDateFormat.js

@@ -254,6 +254,10 @@ sap.ui.define([
 				}, this);
 			}
 
+			if (aFormattedParams.length === 0) {
+				aFormattedParams = null;
+			}
+
 			return this._resourceBundle.getText("DYNAMIC_DATE_" + sKey.toUpperCase() + "_FORMAT", aFormattedParams);
 		};
 

package/src/sap/m/DynamicDateOption.js

@@ -40,7 +40,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Element
 		 *
 		 * @author SAP SE
-		 * @version 1.117.1
+		 * @version 1.119.0
 		 *
 		 * @public
 		 * @since 1.92
@@ -259,7 +259,7 @@ sap.ui.define([
 		 * 5 - Quarters
 		 * 6 - Years
 		 *
-		 * @returns {int} A group index
+		 * @returns { int | string} A group key from {@link sap.m.DynamicDateRangeGroups}
 		 * @public
 		 */
 		DynamicDateOption.prototype.getGroup = function() {

package/src/sap/m/DynamicDateRange.js

@@ -205,6 +205,21 @@ sap.ui.define([
 				"DATETIME"
 			];
 
+			var oDynamicDateRangeGroups = {
+
+				SingleDates: 1,
+
+				DateRanges: 2,
+
+				Weeks: 3,
+
+				Month: 4,
+
+				Quarters: 5,
+
+				Years: 6
+			};
+
 		/**
 		 * Constructor for a new DynamicDateRange.
 		 *
@@ -242,7 +257,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.117.1
+		 * @version 1.119.0
 		 *
 		 * @constructor
 		 * @public
@@ -835,6 +850,81 @@ sap.ui.define([
 			return this.getOption(sKey).toDates(oValue);
 		};
 
+		/**
+		 * Returns enumeration containing the current groups in <code>sap.m.DynamicDateRange</code>
+		 *
+		 * @private
+		 */
+		DynamicDateRange.prototype._getGroups = function() {
+			if (!this.oDynamicDateRangeGroups) {
+				this.oDynamicDateRangeGroups = JSON.parse(JSON.stringify(oDynamicDateRangeGroups)); // making a copy of the object to break the reference
+			}
+
+			return this.oDynamicDateRangeGroups;
+		};
+
+		/**
+		 * Returns the header of a custom group.
+		 *
+		 * @private
+		 */
+		DynamicDateRange.prototype._getCustomGroupHeader = function(sGroupName) {
+			var oGroup = this._customGroupHeaders.find( (x) => {
+				return x.name === sGroupName;
+			});
+
+			return oGroup.header;
+		};
+
+		/**
+		 * Adds a group to the enumeration containing the current groups in <code>sap.m.DynamicDateRange</code>
+		 * @param {string} sGroupName the name that the group will be selected by.
+		 * @param {string} sGroupHeader the group header that will be presented in the list.
+		 * @returns {void}
+		 * @public
+		 * @since 1.118
+		 */
+		DynamicDateRange.prototype.addGroup = function(sGroupName, sGroupHeader) {
+			this._getGroups()[sGroupName] = Object.keys(this._getGroups()).length + 1;
+
+			if (!this._customGroupHeaders) {
+				this._customGroupHeaders = [];
+			}
+
+			this._customGroupHeaders.push({
+				name: sGroupName,
+				header: sGroupHeader
+			});
+		};
+
+		/**
+		 * Sets a new header to an existing custom group.
+		 * @param {string} sGroupName the name that the group will be selected by.
+		 * @param {string} sGroupHeader the group header that will be presented in the list.
+		 * @returns {void}
+		 * @public
+		 */
+		 DynamicDateRange.prototype.setGroupHeader = function(sGroupName, sGroupHeader) {
+			this._customGroupHeaders.find((group) => group.name === sGroupName).header = sGroupHeader;
+		};
+
+		/**
+		 * Removes all additionally added groups
+		 * @returns {void}
+		 * @public
+		 */
+		DynamicDateRange.prototype.removeCustomGroups = function() {
+			const iCountOfStandardGroups = Object.keys(oDynamicDateRangeGroups).length;
+
+			for (const group in this._getGroups()) {
+				if (this._getGroups()[group] > iCountOfStandardGroups) {
+				  delete this._getGroups()[group];
+				}
+			}
+
+			delete this._customGroupHeaders;
+		};
+
 		/**
 		 * Returns an array of <code>sap.m.DynamicDateOptions</code> (standard and custom) instances used in the control.
 		 *
@@ -1180,17 +1270,18 @@ sap.ui.define([
 
 			// get the control options' metadata
 			var aOptions = aArray;
-
 			// sort by group
 			aOptions.sort(function(a, b) {
-				var iGroupDiff = a.getGroup() - b.getGroup();
+				var iGroupA = Number(a.getGroup()) ? a.getGroup() : this._getGroups()[a.getGroup()];
+				var iGroupB = Number(b.getGroup()) ? b.getGroup() : this._getGroups()[b.getGroup()];
+				var iGroupDiff = iGroupA - iGroupB;
 
 				if (iGroupDiff) {
 					return iGroupDiff;
 				}
 
 				return aStandardOptionsKeys.indexOf(a.getKey()) - aStandardOptionsKeys.indexOf(b.getKey());
-			});
+			}.bind(this));
 
 			if (bReduce) {
 				// for last x/next x options leave only the first of each, remove the rest
@@ -1218,9 +1309,14 @@ sap.ui.define([
 			}
 
 			if (this.getEnableGroupHeaders()) {
+
 				// insert a group header string before the options from each group
 				aOptions = aOptions.reduce(function(aResult, oCurrent) {
-					var sGroupHeader = oCurrent.getGroupHeader();
+					var iGroup = Number(oCurrent.getGroup()) ? oCurrent.getGroup() : this._getGroups()[oCurrent.getGroup()];
+					var sGroupName = Object.keys(this._getGroups()).find((key) => this._getGroups()[key] === iGroup);
+					var bGroupHasHeader = this._customGroupHeaders && this._customGroupHeaders.find((group) => group.name === sGroupName);
+					var sGroupHeader = bGroupHasHeader ? this.getGroupHeader(sGroupName) : oCurrent.getGroupHeader();
+
 					if (aGroupHeaders.indexOf(sGroupHeader) === -1) {
 						aGroupHeaders.push(sGroupHeader);
 						aResult.push(sGroupHeader);
@@ -1229,12 +1325,29 @@ sap.ui.define([
 					aResult.push(oCurrent);
 
 					return aResult;
-				}, []);
+				}.bind(this), []);
 			}
 
 			return aOptions;
 		};
 
+		/**
+		 * Provides the option's group header text.
+		 *
+		 * @returns {string} A group header
+		 * @public
+		 * @since 1.118
+		 */
+		 DynamicDateRange.prototype.getGroupHeader = function(sGroupName) {
+			var iGroupId = this._getGroups()[sGroupName];
+
+			if (iGroupId >= this._getGroups()["SingleDates"] && iGroupId <= this._getGroups()["Years"]) {
+				return oResourceBundle.getText("DDR_OPTIONS_GROUP_" + iGroupId);
+			}
+
+			return this._getCustomGroupHeader(sGroupName) ;
+		};
+
 		DynamicDateRange.prototype._createListItem = function(oOption) {
 			var bIsFixedOption = this._isFixedOption(oOption);
 

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.117.1
+		 * @version 1.119.0
 		 *
 		 * @public
 		 * @since 1.92

package/src/sap/m/ExpandableText.js

@@ -105,7 +105,7 @@ function(library,
 	 * @implements sap.ui.core.IFormContent, sap.m.IHyphenation
 	 *
 	 * @author SAP SE
-	 * @version 1.117.1
+	 * @version 1.119.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/FacetFilter.js

@@ -174,7 +174,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.core.Control
 	 * @implements sap.ui.core.IShrinkable
-	 * @version 1.117.1
+	 * @version 1.119.0
 	 *
 	 * @constructor
 	 * @public
@@ -1787,7 +1787,7 @@ sap.ui.define([
 	 * @private
 	 */
 	FacetFilter.prototype._createSelectAllCheckboxBar = function(oList) {
-		if (!oList.getMultiSelect()) {
+		if (oList.getMode() !== ListMode.MultiSelect) {
 			return null;
 		}
 

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.117.1
+	 * @version 1.119.0
 	 *
 	 * @constructor
 	 * @public
@@ -54,8 +54,9 @@ sap.ui.define(['./ListItemBase', './library', './FacetFilterItemRenderer'],
 		renderer: FacetFilterItemRenderer
 	});
 
-	/*
+	/**
 	 * Sets count for the FacetFilterList.
+	 * @deprecated as of version 1.18, replaced by <code>setCounter/code>
 	 * @param {int} iCount The counter to be set to
 	 * @returns {this} this for chaining
 	 */
@@ -74,6 +75,9 @@ sap.ui.define(['./ListItemBase', './library', './FacetFilterItemRenderer'],
 	 */
 	FacetFilterItem.prototype.setCounter = function(iCount) {
 
+		/**
+		 * @deprecated As of version 1.18
+		 */
 		this.setProperty("count", iCount);
 		this.setProperty("counter", iCount);
 		return this;

package/src/sap/m/FacetFilterList.js

@@ -52,7 +52,7 @@ sap.ui.define([
 	 * be closed.
 	 *
 	 * @extends sap.m.List
-	 * @version 1.117.1
+	 * @version 1.119.0
 	 *
 	 * @constructor
 	 * @public
@@ -204,13 +204,13 @@ sap.ui.define([
 		return this;
 	};
 
-	/*
+	/**
 	 * Sets the multiSelect property (default value is <code>true</code>).
+	 * @deprecated As of version 1.20, replaced by <code>setMode</code>
 	 * @param {boolean}	bVal New value for property multiSelect
-	 * @returns {this}	this to allow method chaining
+	 * @returns {this} <code>this</code> to allow method chaining
 	 */
 	FacetFilterList.prototype.setMultiSelect = function(bVal) {
-
 		this.setProperty("multiSelect", bVal, true);
 		var mode = bVal ? ListMode.MultiSelect : ListMode.SingleSelectMaster;
 		this.setMode(mode);
@@ -229,6 +229,9 @@ sap.ui.define([
 		if (mode === ListMode.MultiSelect || mode === ListMode.SingleSelectMaster) {
 
 			List.prototype.setMode.call(this, mode);
+			/**
+			 * @deprecated As of version 1.20
+			 */
 			this.setProperty("multiSelect", mode === ListMode.MultiSelect ? true : false, true);
 		}
 		return this;
@@ -704,7 +707,7 @@ sap.ui.define([
 			return oItem.getSelected();
 		}
 
-		if (this.getMultiSelect()) {
+		if (this.getMode() === ListMode.MultiSelect) {
 			oCheckbox = sap.ui.getCore().byId(this.getAssociation("allcheckbox"));
 			bAtLeastOneItemIsSelected = iItemsCount > 0 && iItemsCount === aItems.filter(isSelected).length;
 			bSelectAllSelected = this.getActive() && bAtLeastOneItemIsSelected;

package/src/sap/m/FeedContent.js

@@ -28,7 +28,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.117.1
+	 * @version 1.119.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.117.1
+	 * @version 1.119.0
 	 *
 	 * @constructor
 	 * @public
@@ -137,7 +137,7 @@ sap.ui.define([
 				 *
 				 * Please be aware that this property is relevant only for images and not for icons.
 				 *
-				 * Deprecated as of version 1.88. Image is replaced by avatar.
+				 * @deprecated as of version 1.88. Image replaced by {@link sap.m.Avatar }
 				 */
 				iconDensityAware : {type : "boolean", group : "Appearance", defaultValue : true},
 
@@ -153,7 +153,7 @@ sap.ui.define([
 				/**
 				 * Text for Picture which will be read by screenreader.
 				 * If a new ariaLabelForPicture is set, any previously set ariaLabelForPicture is deactivated.
-				 * Deprecated as of version 1.88. This will not have any effect in code now.
+				 * @deprecated as of version 1.88. This will not have any effect in code now.
 				 */
 				ariaLabelForPicture : {type : "string", group : "Accessibility", defaultValue : null}
 			},

package/src/sap/m/FeedListItem.js

@@ -58,7 +58,7 @@ function(
 	 * @extends sap.m.ListItemBase
 	 *
 	 * @author SAP SE
-	 * @version 1.117.1
+	 * @version 1.119.0
 	 *
 	 * @constructor
 	 * @public
@@ -148,8 +148,8 @@ function(
 				 *
 				 * If bandwidth is the key for the application, set this value to false.
 				 *
-				 * Deprecated as of version 1.88. Image is replaced by avatar.
-				 */
+				 * @deprecated as of version 1.88. Image is replaced by {@link sap.m.Avatar }
+				*/
 				iconDensityAware: {type: "boolean", defaultValue: true},
 
 				/**
@@ -373,7 +373,8 @@ function(
 	};
 
 	FeedListItem.prototype.onAfterRendering = function() {
-		var oFormattedText = this.getAggregation("_text");
+		var oFormattedText = this.getAggregation("_text"),
+			oDomRef = this.getDomRef();
 		if (document.getElementById(this.getAggregation("_actionButton"))) {
 			document.getElementById(this.getAggregation("_actionButton").getId()).setAttribute("aria-haspopup", "menu");
 		}
@@ -382,7 +383,7 @@ function(
 		}
 		this.$("realtext").find('a[target="_blank"]').on("click", openLink);
 
-		oFormattedText && oFormattedText._sanitizeCSSPosition(this.getDomRef()); // perform CSS position sanitize
+		oDomRef && oFormattedText && oFormattedText._sanitizeCSSPosition(oDomRef.querySelector(".sapMFeedListItemText")); // perform CSS position sanitize
 	};
 
 	FeedListItem.prototype.exit = function() {

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.117.1
+	 * @version 1.119.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/Fiori20Adapter.js

@@ -28,7 +28,7 @@ sap.ui.define([
 	 *
 	 *
 	 * @class text
-	 * @version 1.117.1
+	 * @version 1.119.0
 	 * @private
 	 * @since 1.38
 	 * @alias HeaderAdapter
@@ -228,7 +228,7 @@ sap.ui.define([
 	 * Constructor for an sap.m.Fiori20Adapter.
 	 *
 	 * @class text
-	 * @version 1.117.1
+	 * @version 1.119.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.117.1
+	 * @version 1.119.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.117.1
+	 * @version 1.119.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/FormattedText.js

@@ -46,7 +46,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.117.1
+		 * @version 1.119.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.117.1
+	 * @version 1.119.0
 	 *
 	 * @constructor
 	 * @public