@openui5/sap.f 1.130.0 → 1.131.0

package/THIRDPARTY.txt

@@ -468,7 +468,7 @@ License: Apache-2.0
 License Text: https://github.com/SAP/openui5/blob/master/LICENSES/Apache-2.0.txt
 Contained in: lib/jsdoc/ui5/plugin.js
 
-Component: SAP Theming Base Content, version: 11.18.0
+Component: SAP Theming Base Content, version: 11.22.0
 Copyright: SAP SE or an SAP affiliate company and Theming Base Content contributors
 License: Apache-2.0
 License Text: https://github.com/SAP/openui5/blob/master/LICENSES/Apache-2.0.txt

package/package.json

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

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.130.0</version>
+  <version>1.131.0</version>
 
   <documentation>SAPUI5 library with Fiori controls.</documentation>
 

package/src/sap/f/Avatar.js

@@ -41,7 +41,7 @@ sap.ui.define([
 	 * @extends sap.m.Avatar
 	 *
 	 * @author SAP SE
-	 * @version 1.130.0
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/AvatarGroup.js

@@ -100,7 +100,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.130.0
+	 * @version 1.131.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.130.0
+	 * @version 1.131.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.130.0
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/CalendarInCard.js

@@ -45,7 +45,7 @@ sap.ui.define([
 	 * <code>sap.m.Toolbar</code> with <code>sap.m.Buttons</code>.
 	 *
 	 * @extends sap.ui.unified.Calendar
-	 * @version 1.130.0
+	 * @version 1.131.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.130.0
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/CardBase.js

@@ -8,17 +8,22 @@ sap.ui.define([
 	"sap/ui/core/InvisibleText",
 	"sap/f/CardRenderer",
 	"sap/ui/core/Lib",
-	"sap/f/cards/util/CardBadgeEnabler"
+	"sap/f/cards/util/CardBadgeEnabler",
+	"sap/f/library",
+	"sap/base/Log"
 ], function (
 	Control,
 	InvisibleText,
 	CardRenderer,
 	Library,
-	CardBadgeEnabler
+	CardBadgeEnabler,
+	library,
+	Log
 ) {
 	"use strict";
 
-	var BADGE_AUTOHIDE_TIME = 3000;
+	var BADGE_AUTOHIDE_TIME = 3000,
+		SemanticRole = library.cards.SemanticRole;
 
 	/**
 	 * Constructor for a new <code>CardBase</code>.
@@ -32,7 +37,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.130.0
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public
@@ -55,7 +60,14 @@ sap.ui.define([
 				/**
 				 * Defines the height of the card.
 				 */
-				height: {type: "sap.ui.core.CSSSize", group: "Appearance", defaultValue: "auto"}
+				height: {type: "sap.ui.core.CSSSize", group: "Appearance", defaultValue: "auto"},
+
+				/**
+				 * Defines the role of the Card Header.
+				 *
+				 * @experimental since 1.131
+				 */
+				semanticRole: { type: "sap.f.cards.SemanticRole", defaultValue: SemanticRole.Region}
 			},
 			aggregations: {
 
@@ -76,6 +88,14 @@ sap.ui.define([
 					multiple: false,
 					visibility: "hidden"
 				}
+			},
+			events: {
+				/**
+				 * Fired when action is added on card level.
+				 * Note: Can be used only if <code>semanticRole</code> is <code>sap.f.cards.SemanticRole.ListItem</code>.
+				 * @experimental since 1.131
+				 */
+				press: {}
 			}
 		},
 		renderer: CardRenderer
@@ -267,6 +287,38 @@ sap.ui.define([
 		return sTitleId;
 	};
 
+	/**
+	 * Listens for ontap event
+	 *
+	 * @param {object} oEvent event
+	 */
+	CardBase.prototype.ontap = function (oEvent) {
+		this._handleTapOrSelect(oEvent);
+	};
+
+	/**
+	 * Listens for onsapselect event
+	 *
+	 * @param {object} oEvent event
+	 */
+	CardBase.prototype.onsapselect = function (oEvent) {
+		this._handleTapOrSelect(oEvent);
+	};
+
+	/**
+	 * Handles interaction logic
+	 *
+	 * @param {object} oEvent event
+	 */
+	CardBase.prototype._handleTapOrSelect = function (oEvent) {
+		if (!this.isInteractive() || oEvent.isMarked() || this.getSemanticRole() !== SemanticRole.ListItem) {
+			return;
+		}
+
+		this.firePress();
+		oEvent.preventDefault();
+	};
+
 	/**
 	 * Returns if the control is inside a sap.f.GridContainer
 	 *
@@ -290,5 +342,14 @@ sap.ui.define([
 		return null;
 	};
 
+	CardBase.prototype.isInteractive = function() {
+		const bIsInteractive = this.hasListeners("press");
+
+		if (bIsInteractive && this.getSemanticRole() !== SemanticRole.ListItem) {
+			Log.error("The full card cannot be interactive if the 'semanticRole' is not 'ListItem'", this);
+		}
+		return bIsInteractive;
+	};
+
 	return CardBase;
 });

package/src/sap/f/CardRenderer.js

@@ -13,7 +13,8 @@ sap.ui.define([
 	library
 ) {
 	"use strict";
-	var HeaderPosition = library.cards.HeaderPosition;
+	var HeaderPosition = library.cards.HeaderPosition,
+		SemanticRole = library.cards.SemanticRole;
 
 	/**
 	 * <code>Card</code> renderer.
@@ -39,7 +40,7 @@ sap.ui.define([
 		this.renderContainerAttributes(oRm, oCard);
 		oRm.openEnd();
 
-		 if (bHasCardBadgeCustomData) {
+		if (bHasCardBadgeCustomData) {
 			this.renderCardBadge(oRm, oCard);
 		}
 
@@ -74,6 +75,8 @@ sap.ui.define([
 	 * @param {sap.f.Card} oCard An object representation of the control that should be rendered.
 	 */
 	CardRenderer.renderContainerAttributes = function (oRm, oCard) {
+		const bIsInteractive = oCard.isInteractive();
+
 		var sHeight = oCard.getHeight(),
 			oHeader = oCard.getCardHeader(),
 			oContent = oCard.getCardContent(),
@@ -99,6 +102,16 @@ sap.ui.define([
 			oRm.class("sapFCardSectionInteractive");
 		}
 
+
+		if (oCard.getSemanticRole() === SemanticRole.ListItem) {
+			oRm.class("sapFCardFocus");
+			oRm.attr("tabindex", "0");
+
+			if (bIsInteractive) {
+				oRm.class("sapFCardInteractive");
+			}
+		}
+
 		if (bCardHeaderBottom) {
 			oRm.class("sapFCardBottomHeader");
 		}
@@ -113,7 +126,8 @@ sap.ui.define([
 
 		//Accessibility state
 		oRm.accessibilityState(oCard, {
-			role: "region",
+			// TODO if role is not only used with accessibility values, this should be changed
+			role: oCard.getSemanticRole().toLowerCase(),
 			labelledby: { value: oCard._getAriaLabelledIds(), append: true },
 			describedby: {value: bHasCardBadgeCustomData ? oCard._getInvisibleCardBadgeText().getId() : undefined}
 		});

package/src/sap/f/DynamicPage.js

@@ -118,7 +118,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.130.0
+	 * @version 1.131.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.130.0
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/DynamicPageHeader.js

@@ -64,7 +64,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.130.0
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @public
@@ -385,7 +385,11 @@ sap.ui.define([
 		};
 
 		DynamicPageHeader.prototype.onThemeChanged = function () {
+			var oPinButton = this._getPinButton();
 			this._setPressedStatePinIcon();
+
+			// Theme change event may be fired after the control was rendered and _togglePinButton was already called (if icon should be pressed, we need to update it here)
+			oPinButton.setIcon(oPinButton.getPressed() ? this._sPressedStatePinIconURI : DynamicPageHeader.UNPRESSED_PIN_ICON);
 		};
 
 		/**

package/src/sap/f/DynamicPageTitle.js

@@ -95,7 +95,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.130.0
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/FlexibleColumnLayout.js

@@ -108,7 +108,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.core.Control
 	 * @author SAP SE
-	 * @version 1.130.0
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public
@@ -813,6 +813,21 @@ sap.ui.define([
 		return oNavContainer;
 	};
 
+	FlexibleColumnLayout.prototype.setLandmarkInfo = function (oLandmarkInfo) {
+		this.setAggregation("landmarkInfo", oLandmarkInfo);
+		oLandmarkInfo?.attachEvent("_changeColumnsLabel", this._onColumnsLabelChanged, this);
+
+		return this;
+	};
+
+	FlexibleColumnLayout.prototype.destroyLandmarkInfo = function () {
+		var oLandmarkInfo = this.getLandmarkInfo();
+
+		oLandmarkInfo?.detachEvent("_changeColumnsLabel", this._onColumnsLabelChanged, this);
+
+		return this.destroyAggregation("landmarkInfo");
+	};
+
 	/**
 	 * Formats <code>FlexibleColumnLayoutAccessibleLandmarkInfo</code> role and label of the provided <code>FlexibleColumnLayout</code> column.
 	 *
@@ -833,6 +848,14 @@ sap.ui.define([
 		};
 	};
 
+	FlexibleColumnLayout.prototype._onColumnsLabelChanged = function (oEvent) {
+		var sColumn = oEvent.getParameter("column"),
+			sLabel = oEvent.getParameter("label"),
+			$Column = this._$columns[sColumn];
+
+		$Column.attr("aria-label", sLabel);
+	};
+
 	/**
 	 * Proxies the navigation events from the internal nav containers to the app.
 	 * @param oEvent

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.130.0
+	 * @version 1.131.0
 	 * @since 1.95
 	 *
 	 * @constructor
@@ -84,5 +84,27 @@ sap.ui.define(['sap/ui/core/Element', './library'],
 		}
 	}});
 
+	FlexibleColumnLayoutAccessibleLandmarkInfo.prototype.setFirstColumnLabel = function (sLabel) {
+		return this._setColumnsLabel("firstColumnLabel", sLabel, "begin");
+	};
+
+	FlexibleColumnLayoutAccessibleLandmarkInfo.prototype.setMiddleColumnLabel = function (sLabel) {
+		return this._setColumnsLabel("middleColumnLabel", sLabel, "mid");
+	};
+
+	FlexibleColumnLayoutAccessibleLandmarkInfo.prototype.setLastColumnLabel = function (sLabel) {
+		return this._setColumnsLabel("lastColumnLabel", sLabel, "end");
+	};
+
+	FlexibleColumnLayoutAccessibleLandmarkInfo.prototype._setColumnsLabel = function (sProperty, sLabel, sColumn) {
+		this.setProperty(sProperty, sLabel, true);
+		this.fireEvent("_changeColumnsLabel", {
+			column: sColumn,
+			label: sLabel
+		});
+
+		return this;
+	};
+
 	return FlexibleColumnLayoutAccessibleLandmarkInfo;
 });

package/src/sap/f/FlexibleColumnLayoutData.js

@@ -21,7 +21,7 @@ sap.ui.define(["sap/ui/core/LayoutData", "sap/ui/base/ManagedObjectObserver", "s
 		 *
 		 *
 		 * @author SAP SE
-		 * @version 1.130.0
+		 * @version 1.131.0
 		 *
 		 * @extends sap.ui.core.LayoutData
 		 *

package/src/sap/f/FlexibleColumnLayoutDataForDesktop.js

@@ -20,7 +20,7 @@ sap.ui.define(['sap/ui/core/LayoutData'],
 		 *
 		 *
 		 * @author SAP SE
-		 * @version 1.130.0
+		 * @version 1.131.0
 		 *
 		 * @extends sap.ui.core.LayoutData
 		 *

package/src/sap/f/FlexibleColumnLayoutDataForTablet.js

@@ -20,7 +20,7 @@ sap.ui.define(['sap/ui/core/LayoutData'],
 		 *
 		 *
 		 * @author SAP SE
-		 * @version 1.130.0
+		 * @version 1.131.0
 		 *
 		 * @extends sap.ui.core.LayoutData
 		 *

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.130.0
+	 * @version 1.131.0
 	 * @param {sap.f.FlexibleColumnLayout} oFlexibleColumnLayout
 	 * The <code>sap.f.FlexibleColumnLayout</code> object whose state will be manipulated.
 	 *

package/src/sap/f/GridContainer.js

@@ -177,7 +177,7 @@ sap.ui.define([
 	 * @see {@link sap.f.dnd.GridDropInfo}
 	 *
 	 * @author SAP SE
-	 * @version 1.130.0
+	 * @version 1.131.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.130.0
+		 * @version 1.131.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.130.0
+	 * @version 1.131.0
 	 *
 	 * @extends sap.ui.base.ManagedObject
 	 *
 	 * @see {@link topic:32d4b9c2b981425dbc374d3e9d5d0c2e Grid Controls}
 	 *
 	 * @author SAP SE
-	 * @version 1.130.0
+	 * @version 1.131.0
 	 *
 	 * @since 1.65
 	 * @public

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.130.0
+	 * @version 1.131.0
 	 *
 	 * @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.130.0
+	 * @version 1.131.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.130.0
+	 * @version 1.131.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.130.0
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/PlanningCalendarInCardLegend.js

@@ -22,7 +22,7 @@ sap.ui.define(['sap/m/PlanningCalendarLegend', "sap/ui/core/Lib", 'sap/ui/unifie
 		 * @extends sap.m.PlanningCalendarLegend
 		 *
 		 * @author SAP SE
-		 * @version 1.130.0
+		 * @version 1.131.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.130.0
+		 * @version 1.131.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.130.0
+		 * @version 1.131.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.130.0
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/f/ShellBar.js

@@ -58,7 +58,7 @@ function(
 	 * @implements sap.f.IShellBar, sap.m.IBar, sap.tnt.IToolHeader
 	 *
 	 * @author SAP SE
-	 * @version 1.130.0
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/SidePanel.js

@@ -151,7 +151,7 @@ sap.ui.define([
  	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.130.0
+	 * @version 1.131.0
 	 *
 	 * @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.130.0
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -50,7 +50,7 @@ sap.ui.define([
 	 * @abstract
 	 *
 	 * @author SAP SE
-	 * @version 1.130.0
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * For more information, see {@link sap.ui.core.Element#data Element.prototype.data}
 	 * and {@link topic:91f0c3ee6f4d1014b6dd926db0e91070 Custom Data - Attaching Data Objects to Controls}.
 	 *
-	 * @extends sap..ui.core.CustomData
+	 * @extends sap.ui.core.CustomData
 	 * @since 1.128
 	 *
 	 * @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.130.0
+	 * @version 1.131.0
 	 *
 	 * @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.130.0
+	 * @version 1.131.0
 	 *
 	 * @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.130.0
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @private

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

@@ -28,7 +28,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.130.0
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public