@openui5/sap.f 1.120.12 → 1.120.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openui5/sap.f",
-  "version": "1.120.12",
+  "version": "1.120.14",
   "description": "OpenUI5 UI Library sap.f",
   "author": "SAP SE (https://www.sap.com)",
   "license": "Apache-2.0",
@@ -14,8 +14,8 @@
     "url": "https://github.com/SAP/openui5.git"
   },
   "dependencies": {
-    "@openui5/sap.m": "1.120.12",
-    "@openui5/sap.ui.core": "1.120.12",
-    "@openui5/sap.ui.layout": "1.120.12"
+    "@openui5/sap.m": "1.120.14",
+    "@openui5/sap.ui.core": "1.120.14",
+    "@openui5/sap.ui.layout": "1.120.14"
   }
 }

package/src/sap/f/.library

@@ -6,7 +6,7 @@
   <copyright>OpenUI5
  * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.</copyright>
-  <version>1.120.12</version>
+  <version>1.120.14</version>
 
   <documentation>SAPUI5 library with Fiori controls.</documentation>
 

package/src/sap/f/Avatar.js

@@ -40,7 +40,7 @@ sap.ui.define([
 	 * @extends sap.m.Avatar
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/AvatarGroup.js

@@ -98,7 +98,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/AvatarGroupItem.js

@@ -32,7 +32,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/CalendarAppointmentInCard.js

@@ -21,7 +21,7 @@ sap.ui.define([
 	 * This calendar appointment is used in card content of type Calendar.
 	 *
 	 * @extends sap.ui.unified.CalendarAppointment
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/CalendarInCard.js

@@ -43,7 +43,7 @@ sap.ui.define([
 	 * <code>sap.m.Toolbar</code> with <code>sap.m.Buttons</code>.
 	 *
 	 * @extends sap.ui.unified.Calendar
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/Card.js

@@ -71,7 +71,7 @@ sap.ui.define([
 	 * @extends sap.f.CardBase
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/CardBase.js

@@ -37,7 +37,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/DynamicPage.js

@@ -112,7 +112,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/DynamicPageAccessibleLandmarkInfo.js

@@ -23,7 +23,7 @@ sap.ui.define(['sap/ui/core/Element', './library'],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/DynamicPageHeader.js

@@ -62,7 +62,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.120.12
+		 * @version 1.120.14
 		 *
 		 * @constructor
 		 * @public
@@ -122,6 +122,8 @@ sap.ui.define([
 			return sap.ui.getCore().getLibraryResourceBundle("sap.f");
 		};
 
+		DynamicPageHeader.UNPRESSED_PIN_ICON = "sap-icon://pushpin-off";
+
 		DynamicPageHeader.ARIA = {
 			ARIA_CONTROLS: "aria-controls",
 			ARIA_LABEL: "aria-label",
@@ -146,6 +148,11 @@ sap.ui.define([
 			if (!this._oInvisibleMessage) {
 				this._oInvisibleMessage = InvisibleMessage.getInstance();
 			}
+			// Required if the parent has "headerPinned" set to "true" initially.
+			// Without the explicit "_setPressedStatePinIcon" an empty button is rendered.
+			if (this.getPinnable()) {
+				this._setPressedStatePinIcon();
+			}
 		};
 
 		/*************************************** Private members ******************************************/
@@ -157,6 +164,7 @@ sap.ui.define([
 		 */
 		DynamicPageHeader.prototype._togglePinButton = function (bValue) {
 			this._getPinButton().setPressed(bValue);
+			this._getPinButton().setIcon(bValue ? this._sPressedStatePinIconURI : DynamicPageHeader.UNPRESSED_PIN_ICON);
 		};
 
 		/**
@@ -172,8 +180,9 @@ sap.ui.define([
 		 * Fires the pin/unpin press event.
 		 * @private
 		 */
-		DynamicPageHeader.prototype._pinUnpinFireEvent = function () {
+		DynamicPageHeader.prototype._pinUnpinFireEvent = function (oEvent) {
 			this.fireEvent("_pinUnpinPress");
+			this._togglePinButton(oEvent.getSource().getPressed());
 		};
 
 		/**
@@ -247,7 +256,7 @@ sap.ui.define([
 			if (!this.getAggregation("_pinButton")) {
 				var oPinButton = new ToggleButton({
 					id: this.getId() + "-pinBtn",
-					icon: "sap-icon://pushpin-off",
+					icon: DynamicPageHeader.UNPRESSED_PIN_ICON,
 					tooltip: DynamicPageHeader.ARIA.LABEL_PINNED,
 					press: this._pinUnpinFireEvent.bind(this)
 				}).addStyleClass("sapFDynamicPageHeaderPinButton");
@@ -359,15 +368,18 @@ sap.ui.define([
 			};
 		};
 
+		DynamicPageHeader.prototype.onThemeChanged = function () {
+			this._setPressedStatePinIcon();
+		};
+
 		/**
-		 * Sets the icon of the pin button depending on the current theme
+		 * Sets the icon URI for the pressed state of the pin button
+		 * @private
 		 */
-		DynamicPageHeader.prototype.onThemeChanged = function () {
-			var sIcon = IconPool.getIconURI(ThemeParameters.get({
+		DynamicPageHeader.prototype._setPressedStatePinIcon = function () {
+			this._sPressedStatePinIconURI = IconPool.getIconURI(ThemeParameters.get({
 				name: "_sap_f_DynamicPageHeader_PinButton_Icon"
 			}));
-
-			this._getPinButton().setIcon(sIcon);
 		};
 
 		return DynamicPageHeader;

package/src/sap/f/DynamicPageTitle.js

@@ -93,7 +93,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/FlexibleColumnLayout.js

@@ -97,7 +97,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.core.Control
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/FlexibleColumnLayoutAccessibleLandmarkInfo.js

@@ -22,7 +22,7 @@ sap.ui.define(['sap/ui/core/Element', './library'],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 * @since 1.95
 	 *
 	 * @constructor

package/src/sap/f/FlexibleColumnLayoutSemanticHelper.js

@@ -49,7 +49,7 @@ sap.ui.define([
 	 *
 	 * For more information, see {@link sap.f.FlexibleColumnLayoutSemanticHelper#getCurrentUIState} and {@link sap.f.FlexibleColumnLayoutSemanticHelper#getNextUIState}
 	 *
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 * @param {sap.f.FlexibleColumnLayout} oFlexibleColumnLayout
 	 * The <code>sap.f.FlexibleColumnLayout</code> object whose state will be manipulated.
 	 *

package/src/sap/f/GridContainer.js

@@ -171,7 +171,7 @@ sap.ui.define([
 	 * @see {@link sap.f.dnd.GridDropInfo}
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @extends sap.ui.core.Control
 	 *

package/src/sap/f/GridContainerItemLayoutData.js

@@ -21,7 +21,7 @@ sap.ui.define(['sap/ui/core/LayoutData'],
 		 * @see {@link topic:32d4b9c2b981425dbc374d3e9d5d0c2e Grid Controls}
 		 *
 		 * @author SAP SE
-		 * @version 1.120.12
+		 * @version 1.120.14
 		 *
 		 * @extends sap.ui.core.LayoutData
 		 *

package/src/sap/f/GridContainerSettings.js

@@ -58,14 +58,14 @@ sap.ui.define([
 	 * Can be used to define the sizes of columns and rows for different screen sizes, by using the <code>layout</code> aggregations of <code>sap.f.GridContainer</code>.
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @extends sap.ui.base.ManagedObject
 	 *
 	 * @see {@link topic:32d4b9c2b981425dbc374d3e9d5d0c2e Grid Controls}
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @experimental Since 1.65 This class is experimental. The API may change.
 	 * @since 1.65

package/src/sap/f/GridList.js

@@ -93,7 +93,7 @@ sap.ui.define([
 	 * @see {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Grid_Layout MDN web docs: CSS Grid Layout}
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @extends sap.m.ListBase
 	 * @implements sap.ui.layout.cssgrid.IGridConfigurable

package/src/sap/f/GridListItem.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.m.ListItemBase
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @since 1.70
 	 * @constructor

package/src/sap/f/IllustratedMessage.js

@@ -56,7 +56,7 @@ sap.ui.define([
 	 * @extends sap.m.IllustratedMessage
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/Illustration.js

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * @extends sap.m.Illustration
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/PlanningCalendarInCardLegend.js

@@ -22,7 +22,7 @@ sap.ui.define(['sap/m/PlanningCalendarLegend', 'sap/ui/unified/CalendarLegendIte
 		 * @extends sap.m.PlanningCalendarLegend
 		 *
 		 * @author SAP SE
-		 * @version 1.120.12
+		 * @version 1.120.14
 		 *
 		 * @constructor
 		 * @private

package/src/sap/f/ProductSwitch.js

@@ -34,7 +34,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.120.12
+		 * @version 1.120.14
 		 *
 		 * @constructor
 		 * @public

package/src/sap/f/ProductSwitchItem.js

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

package/src/sap/f/SearchManager.js

@@ -23,7 +23,7 @@ sap.ui.define(['sap/ui/core/Element', 'sap/ui/base/ManagedObjectObserver', './sh
 		 * @extends sap.ui.core.Element
 		 *
 		 * @author SAP SE
-		 * @version 1.120.12
+		 * @version 1.120.14
 		 *
 		 * @constructor
 		 * @public

package/src/sap/f/ShellBar.js

@@ -14,6 +14,7 @@ sap.ui.define([
 	"sap/m/BarInPageEnabler",
 	"sap/m/BadgeCustomData",
 	"sap/m/Button",
+	"sap/ui/Device",
 	"sap/m/library",
 	"./ShellBarRenderer"
 ],
@@ -26,6 +27,7 @@ function(
 	BarInPageEnabler,
 	BadgeCustomData,
 	Button,
+	Device,
 	mobileLibrary,
 	ShellBarRenderer
 ) {
@@ -56,7 +58,7 @@ function(
 	 * @implements sap.f.IShellBar, sap.m.IBar, sap.tnt.IToolHeader
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @public
@@ -197,8 +199,13 @@ function(
 					parameters: {
 						/**
 						 * Reference to the button that has been pressed
+						 * @deprecated Since version 1.120
 						 */
-						image : {type: "sap.m.Image"}
+						image : {type: "sap.m.Image"},
+						/**
+						 * Reference to the button that has been pressed
+						 */
+						button : {type: "sap.m.Button"}
 					}
 				},
 				/**
@@ -254,6 +261,10 @@ function(
 	// Enhance the prototype with additional content aggregation support
 	AdditionalContentSupport.apply(ShellBar.prototype);
 
+	var SHELBAR_RANGE_SET = "ShellBarRangeSet";
+
+	Device.media.initRangeSet(SHELBAR_RANGE_SET, [600, 1024, 1440, 1920], "px", ["Phone", "Tablet", "Desktop", "LargeDesktop", "ExtraLargeDesktop"], true);
+
 	// Lifecycle
 	ShellBar.prototype.init = function () {
 		this._oFactory = new Factory(this);
@@ -275,12 +286,21 @@ function(
 		this._oResponsiveHandler = new ResponsiveHandler(this);
 
 		this._oAcc = new Accessibility(this);
+
+		this._sRangeSet = SHELBAR_RANGE_SET;
 	};
 
 	ShellBar.prototype.onBeforeRendering = function () {
 		this._assignControls();
 	};
 
+	ShellBar.prototype.onAfterRendering = function () {
+		if (!this.sCurrentRange) {
+			this._assignSearch();
+			this.invalidate();
+		}
+	};
+
 	ShellBar.prototype.exit = function () {
 		this._aLeftControls = [];
 		this._aRightControls = [];
@@ -411,30 +431,36 @@ function(
 		if (oConfig) {
 			if (!this._oManagedSearch) {
 				this._oManagedSearch = this._oFactory.getManagedSearch();
+				this.addStyleClass("sapFShellBarWithSearch", true);
 			}
 		} else {
 			this._oManagedSearch = null;
+			this.addStyleClass("sapFShellBarWithSearch", false);
 		}
 
 		this._bOTBUpdateNeeded = true;
 
+
 		return this;
 	};
 
 	ShellBar.prototype.setShowNotifications = function (bShow) {
-		var oShellbar = this;
+		var oShellbar = this,
+			oParent;
 
 		if (bShow) {
 			if (!this._oNotifications) {
+				oParent = this.getParent();
+
 				this._oNotifications = this._oFactory.getNotifications();
 				this._oNotifications._onBeforeEnterOverflow = function () {
-					var oOTBButtonBadgeData = this.getParent()._getOverflowButton().getBadgeCustomData();
+					var oOTBButtonBadgeData = oParent && oParent._getOverflowButton().getBadgeCustomData();
 					this._bInOverflow = true;
 					oOTBButtonBadgeData && oOTBButtonBadgeData.setVisible(this.getBadgeCustomData().getVisible());
 				};
 
 				this._oNotifications._onAfterExitOverflow = function () {
-					var oOTBButtonBadgeData = this.getParent()._getOverflowButton().getBadgeCustomData();
+					var oOTBButtonBadgeData = oParent && oParent._getOverflowButton().getBadgeCustomData();
 					this._bInOverflow = false;
 					oOTBButtonBadgeData && oOTBButtonBadgeData.setVisible(false);
 				};
@@ -604,7 +630,10 @@ function(
 
 	// Utility
 	ShellBar.prototype._assignControlsToOverflowToolbar = function () {
-		var aAdditionalContent;
+		var aAdditionalContent,
+			sMediaRange = this._getCurrentMediaRange();
+
+		this.sCurrentRange = sMediaRange;
 
 		if (!this._oOverflowToolbar) {return;}
 
@@ -612,14 +641,16 @@ function(
 
 		this.addControlToCollection(this._oToolbarSpacer, this._oOverflowToolbar);
 
-		if (this._oManagedSearch) {
-			this.addControlToCollection(this._oManagedSearch, this._oOverflowToolbar);
-		}
+		this._assignSearch();
 
 		if (this._oSearch) {
 			this.addControlToCollection(this._oSearch, this._oOverflowToolbar);
 		}
 
+		if (this._oCopilot) {
+			this.addControlToCollection(this._oCopilot, this._oOverflowToolbar);
+		}
+
 		if (this._oNotifications) {
 			this.addControlToCollection(this._oNotifications, this._oOverflowToolbar);
 		}
@@ -637,6 +668,25 @@ function(
 		return this._oOverflowToolbar;
 	};
 
+	// Utility for assigning Search to the relevant container
+	ShellBar.prototype._assignSearch = function () {
+		var sMediaRange = this._getCurrentMediaRange();
+		this.sCurrentRange = sMediaRange;
+
+		if (this._oManagedSearch && this.sCurrentRange !== "ExtraLargeDesktop") {
+			this.addControlToCollection(this._oManagedSearch, this._oOverflowToolbar);
+			this._oManagedSearch._switchOpenStateOnSearch();
+		} else if (this._oManagedSearch && this.sCurrentRange === "ExtraLargeDesktop") {
+			this._oManagedSearch.setIsOpen(true);
+			this.removeControlFromCollection(this._oManagedSearch, this._oOverflowToolbar);
+		}
+	};
+
+	// Utility for getting current media range
+	ShellBar.prototype._getCurrentMediaRange = function () {
+		return this.$().length && Device.media.getCurrentRange(this._sRangeSet, this.$().outerWidth()).name;
+	};
+
 	//Utility method for preparing and adding control to proper collection
 	ShellBar.prototype.addControlToCollection = function(oControl, aEntity) {
 		var fnAction;
@@ -649,6 +699,17 @@ function(
 		aEntity[fnAction](oControl);
 	};
 
+
+	//Utility method for preparing and adding control to proper collection
+	ShellBar.prototype.removeControlFromCollection = function(oControl, aEntity) {
+		var fnAction;
+		if (!Array.isArray(aEntity)) {
+			fnAction = aEntity === this._oAdditionalBox ? "removeItem" : "removeContent";
+		}
+
+		aEntity[fnAction](oControl);
+	};
+
 	ShellBar.prototype._updateNotificationsIndicators = function(sNotificationsNumber) {
 		var oOTBButton;
 

package/src/sap/f/ShellBarRenderer.js

@@ -50,10 +50,10 @@ function() {
 				oControl._aLeftControls.forEach(oRm.renderControl, oRm);
 
 				oRm.close("div");
-
 			}
-			if (oControl._oCopilot) {
-				oRm.renderControl(oControl._oCopilot);
+
+			if (oControl._oManagedSearch && oControl.sCurrentRange === "ExtraLargeDesktop") {
+				oRm.renderControl(oControl._oManagedSearch);
 			}
 
 			if (oControl._aRightControls && oControl._aRightControls.length) {

package/src/sap/f/SidePanel.js

@@ -149,7 +149,7 @@ sap.ui.define([
  	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/SidePanelItem.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Item
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/cards/BaseHeader.js

@@ -42,7 +42,7 @@ sap.ui.define([
 	 * @abstract
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/cards/Header.js

@@ -48,7 +48,7 @@ sap.ui.define([
 	 * @implements sap.f.cards.IHeader
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/cards/NumericHeader.js

@@ -57,7 +57,7 @@ sap.ui.define([
 	 * @extends sap.f.cards.BaseHeader
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/cards/NumericIndicators.js

@@ -25,7 +25,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/cards/NumericSideIndicator.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/cards/loading/AnalyticalPlaceholder.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/cards/loading/CalendarPlaceholder.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @extends sap.f.cards.loading.ListPlaceholder
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/cards/loading/GenericPlaceholder.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.120.12
+	 * @version 1.120.14
 	 *
 	 * @constructor
 	 * @private