@openui5/sap.f 1.117.0 → 1.118.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openui5/sap.f",
-  "version": "1.117.0",
+  "version": "1.118.0",
   "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.117.0",
-    "@openui5/sap.ui.core": "1.117.0",
-    "@openui5/sap.ui.layout": "1.117.0"
+    "@openui5/sap.m": "1.118.0",
+    "@openui5/sap.ui.core": "1.118.0",
+    "@openui5/sap.ui.layout": "1.118.0"
   }
 }

package/src/sap/f/.library

@@ -6,7 +6,7 @@
   <copyright>OpenUI5
  * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.</copyright>
-  <version>1.117.0</version>
+  <version>1.118.0</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.117.0
+	 * @version 1.118.0
 	 *
 	 * @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.117.0
+	 * @version 1.118.0
 	 *
 	 * @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.117.0
+	 * @version 1.118.0
 	 *
 	 * @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.117.0
+	 * @version 1.118.0
 	 *
 	 * @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.117.0
+	 * @version 1.118.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/Card.js

@@ -71,7 +71,7 @@ sap.ui.define([
 	 * @extends sap.f.CardBase
 	 *
 	 * @author SAP SE
-	 * @version 1.117.0
+	 * @version 1.118.0
 	 *
 	 * @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.117.0
+	 * @version 1.118.0
 	 *
 	 * @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.117.0
+	 * @version 1.118.0
 	 *
 	 * @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.117.0
+	 * @version 1.118.0
 	 *
 	 * @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.117.0
+		 * @version 1.118.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/f/DynamicPageTitle.js

@@ -44,10 +44,14 @@ sap.ui.define([
 ) {
 	"use strict";
 
-	// shortcut for sap.f.DynamicPageTitleArea
-	var DynamicPageTitleArea = library.DynamicPageTitleArea,
-		ToolbarStyle = mobileLibrary.ToolbarStyle,
-		InvisibleMessageMode = CoreLibrary.InvisibleMessageMode;
+	/**
+	 * @deprecated As of version 1.54
+	 */
+	var DynamicPageTitleArea = library.DynamicPageTitleArea;
+
+	var	ToolbarStyle = mobileLibrary.ToolbarStyle;
+
+	var	InvisibleMessageMode = CoreLibrary.InvisibleMessageMode;
 
 	/**
 	 * Constructor for a new <code>DynamicPageTitle</code>.
@@ -89,7 +93,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.117.0
+	 * @version 1.118.0
 	 *
 	 * @constructor
 	 * @public
@@ -508,6 +512,9 @@ sap.ui.define([
 
 		var oShrinkFactorsInfo = this._getShrinkFactorsObject();
 
+		/**
+		 * @deprecated As of version 1.54
+		 */
 		if (this.getPrimaryArea() === DynamicPageTitleArea.Middle) {
 			Log.warning("DynamicPageTitle :: Property primaryArea is disregarded when areaShrinkRatio is set.", this);
 		}
@@ -1296,11 +1303,17 @@ sap.ui.define([
 			bHasTopContent = oBreadcrumbs || bHasNavigationActions,
 			bHasOnlyBreadcrumbs = !!(oBreadcrumbs && !bHasNavigationActions),
 			bHasOnlyNavigationActions = bHasNavigationActions && !oBreadcrumbs,
-			sAreaShrinkRatioDefaultValue = this.getMetadata().getProperty("areaShrinkRatio").getDefaultValue();
+			sAreaShrinkRatioDefaultValue = this.getMetadata().getProperty("areaShrinkRatio").getDefaultValue(),
+			bAriaShrinkRatioDefault = this.getAreaShrinkRatio() === sAreaShrinkRatioDefaultValue;
+
+		/**
+		 * @deprecated As of version 1.54
+		 */
+		bAriaShrinkRatioDefault = bAriaShrinkRatioDefault && this.getPrimaryArea() === DynamicPageTitleArea.Middle;
 
-		// if areaShrinkRatio is set to default value (or not set at all) and primaryArea is set,
+		// if areaShrinkRatio is set to default value (or not set at all)
 		// use shrink factors defined for primaryArea
-		if (this.getAreaShrinkRatio() === sAreaShrinkRatioDefaultValue && this.getPrimaryArea() === DynamicPageTitleArea.Middle) {
+		if (bAriaShrinkRatioDefault) {
 			oShrinkFactorsInfo.headingAreaShrinkFactor = DynamicPageTitle.PRIMARY_AREA_MIDDLE_SHRINK_FACTORS.headingAreaShrinkFactor;
 			oShrinkFactorsInfo.contentAreaShrinkFactor = DynamicPageTitle.PRIMARY_AREA_MIDDLE_SHRINK_FACTORS.contentAreaShrinkFactor;
 			oShrinkFactorsInfo.actionsAreaShrinkFactor = DynamicPageTitle.PRIMARY_AREA_MIDDLE_SHRINK_FACTORS.actionsAreaShrinkFactor;
@@ -1463,7 +1476,7 @@ sap.ui.define([
 	};
 
 	DynamicPageTitle.prototype._updateARIAState = function (bExpanded) {
-		var sARIAText = this._getARIALabelReferences(bExpanded) || DynamicPageTitle.DEFAULT_HEADER_TEXT_ID,
+		var sARIAText = this._getARIALabelReferences(bExpanded),
 			$oFocusSpan = this._getFocusSpan();
 
 		if ($oFocusSpan) {
@@ -1489,7 +1502,7 @@ sap.ui.define([
 			sReferences += sTitleId || oHeading.getId();
 		}
 
-		return sReferences;
+		return sReferences || DynamicPageTitle.DEFAULT_HEADER_TEXT_ID;
 	};
 
 	DynamicPageTitle.prototype._focus = function () {

package/src/sap/f/DynamicPageTitleRenderer.js

@@ -25,7 +25,7 @@ sap.ui.define([
 		var oDynamicPageTitleState = oDynamicPageTitle._getState(),
 			sSapFDynamicPageTitle = "sapFDynamicPageTitle",
 			sBackgroundDesign = oDynamicPageTitle.getBackgroundDesign(),
-			sLabelledBy = oDynamicPageTitle._getARIALabelReferences(oDynamicPageTitle._bExpandedState) || oDynamicPageTitle.DEFAULT_HEADER_TEXT_ID,
+			sLabelledBy = oDynamicPageTitle._getARIALabelReferences(oDynamicPageTitle._bExpandedState),
 			sDescribedBy = oDynamicPageTitle._getAriaDescribedByReferences();
 
 		// DynamicPageTitle Root DOM Element.

package/src/sap/f/FlexibleColumnLayout.js

@@ -97,7 +97,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.core.Control
 	 * @author SAP SE
-	 * @version 1.117.0
+	 * @version 1.118.0
 	 *
 	 * @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.117.0
+	 * @version 1.118.0
 	 * @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.117.0
+	 * @version 1.118.0
 	 * @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.117.0
+	 * @version 1.118.0
 	 *
 	 * @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.117.0
+		 * @version 1.118.0
 		 *
 		 * @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.117.0
+	 * @version 1.118.0
 	 *
 	 * @extends sap.ui.base.ManagedObject
 	 *
 	 * @see {@link topic:32d4b9c2b981425dbc374d3e9d5d0c2e Grid Controls}
 	 *
 	 * @author SAP SE
-	 * @version 1.117.0
+	 * @version 1.118.0
 	 *
 	 * @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.117.0
+	 * @version 1.118.0
 	 *
 	 * @extends sap.m.ListBase
 	 * @implements sap.ui.layout.cssgrid.IGridConfigurable
@@ -291,9 +291,6 @@ sap.ui.define([
 				.setFocusedIndex(0);
 
 			this.addDelegate(this._oItemNavigation);
-
-			// set the tab index of active items
-			this._setItemNavigationTabIndex(0);
 		}
 
 		ListBase.prototype._startItemNavigation.apply(this, arguments);

package/src/sap/f/GridListItem.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.m.ListItemBase
 	 *
 	 * @author SAP SE
-	 * @version 1.117.0
+	 * @version 1.118.0
 	 *
 	 * @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.117.0
+	 * @version 1.118.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/Illustration.js

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * @extends sap.m.Illustration
 	 *
 	 * @author SAP SE
-	 * @version 1.117.0
+	 * @version 1.118.0
 	 *
 	 * @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.117.0
+		 * @version 1.118.0
 		 *
 		 * @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.117.0
+		 * @version 1.118.0
 		 *
 		 * @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.117.0
+		 * @version 1.118.0
 		 *
 		 * @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.117.0
+		 * @version 1.118.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/f/ShellBar.js

@@ -56,7 +56,7 @@ function(
 	 * @implements sap.f.IShellBar, sap.m.IBar, sap.tnt.IToolHeader
 	 *
 	 * @author SAP SE
-	 * @version 1.117.0
+	 * @version 1.118.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/SidePanel.js

@@ -149,7 +149,7 @@ sap.ui.define([
  	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.117.0
+	 * @version 1.118.0
 	 *
 	 * @constructor
 	 * @public
@@ -898,7 +898,9 @@ sap.ui.define([
 		if (iSidePanelWidth > SIDE_PANEL_SPLIT_BREAKPOINT) {
 			oSide.classList.add("sapFSPSplitView");
 		} else {
-			oSide.classList.contains("sapFSPSplitView") && this.setActionBarExpanded(false);
+			// TODO: revise the upcoming interaction as re-rendering is happening while resizing.
+			// Currently the action toolbar would not collapse if shriked via mouse. That makes the resizing via mouse usable.
+			// oSide.classList.contains("sapFSPSplitView") && this.setActionBarExpanded(false);
 			oSide.classList.remove("sapFSPSplitView");
 		}
 	};

package/src/sap/f/SidePanelItem.js

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

package/src/sap/f/SidePanelRenderer.js

@@ -104,7 +104,7 @@ sap.ui.define([
 
 		SidePanelRenderer.renderSide = function(oRm, oControl) {
 			var bPhone = Device.system.phone,
-				bRenderSplitter = oControl.getSidePanelResizable() && oControl._getSideContentExpanded() && !bPhone;
+				bRenderSplitter = oControl._isResizable();
 
 			oRm.openStart("aside");
 			oRm.class("sapFSPSide");

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

@@ -9,6 +9,7 @@ sap.ui.define([
 	"sap/ui/core/IntervalTrigger",
 	"sap/ui/core/format/DateFormat",
 	"sap/ui/core/date/UniversalDate",
+	"sap/ui/core/library",
 	"sap/m/Text"
 ], function (
 	Control,
@@ -16,6 +17,7 @@ sap.ui.define([
 	IntervalTrigger,
 	DateFormat,
 	UniversalDate,
+	coreLibrary,
 	Text
 ) {
 	"use strict";
@@ -25,6 +27,8 @@ sap.ui.define([
 	 */
 	var DATA_TIMESTAMP_REFRESH_INTERVAL = 60000;
 
+	var TextAlign = coreLibrary.TextAlign;
+
 	/**
 	 * Constructor for a new <code>BaseHeader</code>.
 	 *
@@ -38,7 +42,7 @@ sap.ui.define([
 	 * @abstract
 	 *
 	 * @author SAP SE
-	 * @version 1.117.0
+	 * @version 1.118.0
 	 *
 	 * @constructor
 	 * @public
@@ -77,7 +81,13 @@ sap.ui.define([
 				 * Set to false if header shouldn't be focusable.
 				 * @private
 				 */
-				focusable: { type: "boolean", defaultValue: true, visibility: "hidden" }
+				focusable: { type: "boolean", defaultValue: true, visibility: "hidden" },
+
+				/**
+				 * If the header should be rendered as a tile.
+				 * @private
+				 */
+				useTileLayout: { type: "boolean", group: "Appearance", visibility: "hidden" }
 			},
 			aggregations: {
 				/**
@@ -95,7 +105,14 @@ sap.ui.define([
 				/**
 				 * Defines an error which will be displayed in the header.
 				 */
-				_error: { type: "sap.ui.core.Control", multiple: false, visibility: "hidden" }
+				_error: { type: "sap.ui.core.Control", multiple: false, visibility: "hidden" },
+
+				/**
+				 * Show as a banner in the header area. Use for example for system info and application shortcut.
+				 * @experimental Since 1.118. For usage only by Work Zone.
+				 * @since 1.118
+				 */
+				bannerLines: { type: "sap.m.Text", group: "Appearance", multiple: true  }
 			}
 		}
 	});
@@ -120,12 +137,19 @@ sap.ui.define([
 	};
 
 	BaseHeader.prototype.onBeforeRendering = function () {
-		var oToolbar = this.getToolbar();
+		var oToolbar = this.getToolbar(),
+			aBannerLines = this.getBannerLines();
 
 		if (oToolbar) {
 			oToolbar.addStyleClass("sapFCardHeaderToolbar");
 			oToolbar.removeEventDelegate(this._oToolbarDelegate, this);
 		}
+
+		if (aBannerLines) {
+			aBannerLines.forEach((oText) => {
+				oText.setTextAlign(TextAlign.End);
+			});
+		}
 	};
 
 	BaseHeader.prototype.onAfterRendering = function () {

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

@@ -0,0 +1,68 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+// Provides default renderer for control sap.f.cards.NumericHeader
+sap.ui.define([], function () {
+	"use strict";
+
+	var BaseHeaderRenderer = {
+		apiVersion: 2
+	};
+
+	BaseHeaderRenderer.renderAvatar = function (oRm, oHeader) {
+		var oAvatar = oHeader.getAggregation("_avatar"),
+			oBindingInfos = oHeader.mBindingInfos,
+			bIconVisible = oHeader.shouldShowIcon();
+
+		if (bIconVisible && (!oHeader.isPropertyInitial("iconSrc") || !oHeader.isPropertyInitial("iconInitials"))) {
+			oRm.openStart("div")
+				.class("sapFCardHeaderImage")
+				.openEnd();
+
+			if (oBindingInfos.iconSrc && oBindingInfos.iconSrc.binding && !oBindingInfos.iconSrc.binding.getValue()) {
+				oAvatar.addStyleClass("sapFCardHeaderItemBinded");
+			}
+			oRm.renderControl(oAvatar);
+			oRm.renderControl(oHeader._oAriaAvatarText);
+			oRm.close("div");
+		}
+	};
+
+	BaseHeaderRenderer.renderBanner = function(oRm, oHeader) {
+		const aBannerLines = oHeader.getBannerLines() || [];
+		const aVisibleLines = aBannerLines.filter((oText) => {
+			return oText.getVisible();
+		});
+
+		if (!aVisibleLines.length) {
+			return;
+		}
+
+		oRm.openStart("div")
+			.class("sapFCardHeaderBanner")
+			.openEnd();
+
+		oRm.openStart("div")
+			.class("sapFCardHeaderBannerInner")
+			.openEnd();
+
+		aBannerLines.forEach((oBannerLine) => {
+			oRm.openStart("div")
+				.class("sapFCardHeaderBannerLine")
+				.openEnd();
+
+			oRm.renderControl(oBannerLine);
+
+			oRm.close("div");
+		});
+
+		oRm.close("div");
+
+		oRm.close("div");
+	};
+
+	return BaseHeaderRenderer;
+}, /* bExport= */ true);

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

@@ -24,6 +24,7 @@ sap.ui.define([
 
 	var AvatarShape = mLibrary.AvatarShape;
 	var AvatarColor = mLibrary.AvatarColor;
+	var AvatarImageFitType = mLibrary.AvatarImageFitType;
 
 	/**
 	 * Constructor for a new <code>Header</code>.
@@ -46,7 +47,7 @@ sap.ui.define([
 	 * @implements sap.f.cards.IHeader
 	 *
 	 * @author SAP SE
-	 * @version 1.117.0
+	 * @version 1.118.0
 	 *
 	 * @constructor
 	 * @public
@@ -166,10 +167,8 @@ sap.ui.define([
 	Header.prototype.exit = function () {
 		BaseHeader.prototype.exit.apply(this, arguments);
 
-		if (this._oAriaAvatarText) {
-			this._oAriaAvatarText.destroy();
-			this._oAriaAvatarText = null;
-		}
+		this._oAriaAvatarText.destroy();
+		this._oAriaAvatarText = null;
 	};
 
 	/**
@@ -208,7 +207,9 @@ sap.ui.define([
 	Header.prototype._getAvatar = function () {
 		var oAvatar = this.getAggregation("_avatar");
 		if (!oAvatar) {
-			oAvatar = new Avatar().addStyleClass("sapFCardIcon");
+			oAvatar = new Avatar({
+				imageFitType: AvatarImageFitType.Contain
+			}).addStyleClass("sapFCardIcon");
 			this.setAggregation("_avatar", oAvatar);
 		}
 		return oAvatar;