@openui5/sap.f 1.127.0 → 1.128.0

package/src/sap/f/FlexibleColumnLayoutData.js

@@ -0,0 +1,52 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+// Provides element sap.f.FlexibleColumnLayoutData
+sap.ui.define(['sap/ui/core/LayoutData'],
+	function(LayoutData) {
+		"use strict";
+
+		/**
+		 * Constructor for a new <code>sap.f.FlexibleColumnLayoutData</code>.
+		 *
+		 * @param {string} [sId] ID for the new element, generated automatically if no ID is given
+		 * @param {object} [mSettings] Initial settings for the new element.
+		 *
+		 * @class
+		 * Holds layout data for <code>sap.f.FlexibleColumnLayout</code>.
+		 * Allows LayoutData of type <code>sap.f.FlexibleColumnLayoutDataForDesktop</code> or <code>sap.f.FlexibleColumnLayoutFlexibleColumnLayoutDataForTablet</code>
+		 *
+		 *
+		 * @author SAP SE
+		 * @version 1.128.0
+		 *
+		 * @extends sap.ui.core.LayoutData
+		 *
+		 * @since 1.128
+		 * @public
+		 * @constructor
+		 * @alias sap.f.FlexibleColumnLayoutData
+		 */
+		var FlexibleColumnLayoutData = LayoutData.extend("sap.f.FlexibleColumnLayoutData", /** @lends sap.f.FlexibleColumnLayoutData.prototype */ {
+			metadata: {
+
+				library: "sap.f",
+				aggregations: {
+
+					/**
+					 * Allows LayoutData of type <code>sap.f.FlexibleColumnLayoutDataForDesktop</code>
+					 */
+					desktopLayoutData: {type: "sap.f.FlexibleColumnLayoutDataForDesktop", multiple: false, singularName: "desktopLayoutData"},
+					/**
+					 * Allows LayoutData of type <code>sap.f.FlexibleColumnLayoutDataForTablet</code>
+					 */
+					tabletLayoutData: {type: "sap.f.FlexibleColumnLayoutDataForTablet", multiple: false, singularName: "tabletLayoutData"}
+				}
+			}
+		});
+
+		return FlexibleColumnLayoutData;
+	});

package/src/sap/f/FlexibleColumnLayoutDataForDesktop.js

@@ -0,0 +1,72 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+// Provides element sap.f.FlexibleColumnLayoutDataForDesktop
+sap.ui.define(['sap/ui/core/LayoutData'],
+	function(LayoutData) {
+		"use strict";
+
+		/**
+		 * Constructor for a new <code>sap.f.FlexibleColumnLayoutDataForDesktop</code>.
+		 *
+		 * @param {string} [sId] ID for the new element, generated automatically if no ID is given
+		 * @param {object} [mSettings] Initial settings for the new element.
+		 *
+		 * @class
+		 * Holds layout data for columns of <code>sap.f.FlexibleColumnLayout</code> on desktop.
+		 *
+		 *
+		 * @author SAP SE
+		 * @version 1.128.0
+		 *
+		 * @extends sap.ui.core.LayoutData
+		 *
+		 * @since 1.128
+		 * @public
+		 * @constructor
+		 * @alias sap.f.FlexibleColumnLayoutDataForDesktop
+		 */
+		var FlexibleColumnLayoutDataForDesktop = LayoutData.extend("sap.f.FlexibleColumnLayoutDataForDesktop", /** @lends sap.f.FlexibleColumnLayoutDataForDesktop.prototype */ {
+			metadata: {
+
+				library: "sap.f",
+				properties: {
+
+					/**
+					 * Columns distribution of TwoColumnsBeginExpanded layout in the format "begin/mid/end", where values are set in percentages.
+					 */
+					twoColumnsBeginExpanded: {type: "string", group: "Appearance", defaultValue: "67/33/0"},
+
+					/**
+					 * Columns distribution of TwoColumnsMidExpanded layout in the format "begin/mid/end", where values are set in percentages.
+					 */
+					twoColumnsMidExpanded: {type: "string", group: "Appearance", defaultValue: "33/67/0"},
+
+					/**
+					 * Columns distribution of ThreeColumnsBeginExpandedEndHidden layout in the format "begin/mid/end", where values are set in percentages.
+					 */
+					threeColumnsBeginExpandedEndHidden: {type: "string", group: "Appearance", defaultValue: "67/33/0"},
+
+					/**
+					 * Columns distribution of ThreeColumnsEndExpanded layout in the format "begin/mid/end", where values are set in percentages.
+					 */
+					threeColumnsEndExpanded: {type: "string", group: "Appearance", defaultValue: "25/25/50"},
+
+					/**
+					 * Columns distribution of ThreeColumnsMidExpanded layout in the format "begin/mid/end", where values are set in percentages.
+					 */
+					threeColumnsMidExpanded: {type: "string", group: "Appearance", defaultValue: "25/50/25"},
+
+					/**
+					 * Columns distribution of ThreeColumnsMidExpandedEndHidden layout in the format "begin/mid/end", where values are set in percentages.
+					 */
+					threeColumnsMidExpandedEndHidden: {type: "string", group: "Appearance", defaultValue: "33/67/0"}
+				}
+			}
+		});
+
+		return FlexibleColumnLayoutDataForDesktop;
+	});

package/src/sap/f/FlexibleColumnLayoutDataForTablet.js

@@ -0,0 +1,71 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+// Provides element sap.f.FlexibleColumnLayoutDataForTablet
+sap.ui.define(['sap/ui/core/LayoutData'],
+	function(LayoutData) {
+		"use strict";
+
+		/**
+		 * Constructor for a new <code>sap.f.FlexibleColumnLayoutDataForTablet</code>.
+		 *
+		 * @param {string} [sId] ID for the new element, generated automatically if no ID is given
+		 * @param {object} [mSettings] Initial settings for the new element.
+		 *
+		 * @class
+		 * Holds layout data for columns of <code>sap.f.FlexibleColumnLayout</code> on tablet.
+		 *
+		 *
+		 * @author SAP SE
+		 * @version 1.128.0
+		 *
+		 * @extends sap.ui.core.LayoutData
+		 *
+		 * @since 1.128
+		 * @public
+		 * @constructor
+		 * @alias sap.f.FlexibleColumnLayoutDataForTablet
+		 */
+		var FlexibleColumnLayoutDataForTablet = LayoutData.extend("sap.f.FlexibleColumnLayoutDataForTablet", /** @lends sap.f.FlexibleColumnLayoutDataForTablet.prototype */ {
+			metadata: {
+
+				library: "sap.f",
+				properties: {
+					/**
+					 * Columns distribution of TwoColumnsBeginExpanded layout in the format "begin/mid/end", where values are set in percentages.
+					 */
+					twoColumnsBeginExpanded: {type: "string", group: "Appearance", defaultValue: "67/33/0"},
+
+					/**
+					 * Columns distribution of TwoColumnsMidExpanded layout in the format "begin/mid/end", where values are set in percentages.
+					 */
+					twoColumnsMidExpanded: {type: "string", group: "Appearance", defaultValue: "33/67/0"},
+
+					/**
+					 * Columns distribution of ThreeColumnsBeginExpandedEndHidden layout in the format "begin/mid/end", where values are set in percentages.
+					 */
+					threeColumnsBeginExpandedEndHidden: {type: "string", group: "Appearance", defaultValue: "67/33/0"},
+
+					/**
+					 * Columns distribution of ThreeColumnsEndExpanded layout in the format "begin/mid/end", where values are set in percentages.
+					 */
+					threeColumnsEndExpanded: {type: "string", group: "Appearance", defaultValue: "0/33/67"},
+
+					/**
+					 * Columns distribution of ThreeColumnsMidExpanded layout in the format "begin/mid/end", where values are set in percentages.
+					 */
+					threeColumnsMidExpanded: {type: "string", group: "Appearance", defaultValue: "0/67/33"},
+
+					/**
+					 * Columns distribution of ThreeColumnsMidExpandedEndHidden layout in the format "begin/mid/end", where values are set in percentages.
+					 */
+					threeColumnsMidExpandedEndHidden: {type: "string", group: "Appearance", defaultValue: "33/67/0"}
+				}
+			}
+		});
+
+		return FlexibleColumnLayoutDataForTablet;
+	});

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.127.0
+	 * @version 1.128.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.127.0
+	 * @version 1.128.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.127.0
+		 * @version 1.128.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.127.0
+	 * @version 1.128.0
 	 *
 	 * @extends sap.ui.base.ManagedObject
 	 *
 	 * @see {@link topic:32d4b9c2b981425dbc374d3e9d5d0c2e Grid Controls}
 	 *
 	 * @author SAP SE
-	 * @version 1.127.0
+	 * @version 1.128.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.127.0
+	 * @version 1.128.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.127.0
+	 * @version 1.128.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.127.0
+	 * @version 1.128.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.127.0
+	 * @version 1.128.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.127.0
+		 * @version 1.128.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.127.0
+		 * @version 1.128.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.127.0
+		 * @version 1.128.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.127.0
+		 * @version 1.128.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.127.0
+	 * @version 1.128.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.127.0
+	 * @version 1.128.0
 	 *
 	 * @constructor
 	 * @public
@@ -1082,13 +1082,18 @@ sap.ui.define([
 	};
 
 	SidePanel.prototype._getSideContentHeaderIcon = function() {
-		var oSelectedItem = this._getSelectedItem();
+		var oSelectedItem = this._getSelectedItem(),
+			sSrc = oSelectedItem && oSelectedItem.getIcon();
+
+		if (!sSrc) {
+			return null;
+		}
 
 		if (!this._contentHeaderIcon) {
 			this._contentHeaderIcon = new Icon();
 		}
 
-		oSelectedItem && this._contentHeaderIcon.setSrc(oSelectedItem.getIcon());
+		oSelectedItem && this._contentHeaderIcon.setSrc(sSrc);
 
 		return this._contentHeaderIcon;
 	};

package/src/sap/f/SidePanelItem.js

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

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

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

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

@@ -0,0 +1,123 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+// Provides element sap.f.cards.CardBadgeCustomData.
+sap.ui.define([
+	'sap/ui/core/CustomData',
+	'sap/f/library',
+	'sap/ui/core/library'
+], function(CustomData, library,coreLibrary) {
+	"use strict";
+
+	const CardBadgeVisibilityMode = library.CardBadgeVisibilityMode,
+		IndicationColor = coreLibrary.IndicationColor;
+
+	/**
+	 * Constructor for a new <code>CardBadgeCustomData</code> element.
+	 *
+	 * @param {string} [sId] ID for the new element, generated automatically if no ID is given
+	 * @param {object} [mSettings] Initial settings for the new element
+	 *
+	 * @class
+	 * Contains a single key/value pair of custom data attached to an <code>Element</code>.
+	 *
+	 * 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
+	 * @since 1.128
+	 *
+	 * @public
+	 * @alias sap.f.cards.CardBadgeCustomData
+	 */
+
+	var CardBadgeCustomData = CustomData.extend("sap.f.cards.CardBadgeCustomData", {
+		metadata: {
+			properties: {
+
+				/**
+				 * Icon URI. This may be either an icon font or image path.
+				 * @since 1.128
+				 */
+				icon: {type: "sap.ui.core.URI", group: "Data", defaultValue: null},
+
+				/**
+				 * Describes the corresponding visibility mode, see also {@link sap.f.CardBadgeVisibilityMode}.
+				 * @since 1.128
+				 */
+				visibilityMode: {type: "sap.f.CardBadgeVisibilityMode", group: "Data", defaultValue: CardBadgeVisibilityMode.Disappear},
+
+				/**
+				 * Defines the color of the badge.
+				 * The allowed values are from the enum type <code>sap.ui.core.IndicationColor</code>.
+				 * Additionally values from <code>sap.ui.core.ValueState</code> can be used, but this is not recommended by design guidelines.
+				 * @since 1.128
+				 */
+				state: {type : "string", group : "Misc", defaultValue : IndicationColor.Indication05},
+
+				/**
+				 * Defines the cards badge visibility.
+				 * @since 1.128
+				 */
+				visible: {type: "boolean", group: "Appearance", defaultValue: true},
+
+				/**
+				 * Defines text which will is overriding default announcement.
+				 *
+				 * @since 1.128
+				 */
+				announcementText : {type : "string", group : "Misc", defaultValue: ""}
+			}
+		}
+	});
+
+	CardBadgeCustomData.prototype.setVisible =  function (bVisible) {
+		if (this.getVisible() === bVisible) { return this; }
+
+		this.setProperty("visible", bVisible, true);
+
+		this.getParent()?._updateBadgeProperty(this.getId(), "visible", bVisible);
+	};
+
+	CardBadgeCustomData.prototype.setIcon =  function (sSrc) {
+		if (this.getIcon() === sSrc) { return this; }
+
+		this.setProperty("icon", sSrc, true);
+
+		this.getParent()?._updateBadgeProperty(this.getId(), "icon", sSrc);
+	};
+
+	CardBadgeCustomData.prototype.setState =  function (sColor) {
+		if (this.getState() === sColor) { return this; }
+
+		this.setProperty("state", sColor, true);
+
+		this.getParent()?._updateBadgeProperty(this.getId(), "state", sColor);
+	};
+
+	CardBadgeCustomData.prototype.setValue =  function (sValue) {
+		if (this.getValue() === sValue) { return this; }
+
+		if (sValue === null || sValue === undefined) {
+			sValue = "";
+		}
+
+		var sValue = sValue.toString();
+		CustomData.prototype.setValue.call(this, sValue);
+
+		this.getParent()?._updateBadgeProperty(this.getId(), "text", sValue);
+	};
+
+	CardBadgeCustomData.prototype.setAnnouncementText =  function (sValue) {
+		if (this.getAnnouncementText() === sValue) { return this; }
+
+		this.setProperty("announcementText", sValue, true);
+
+		this.getParent()?._updateBadgeProperty(this.getId(), "stateAnnouncementText", sValue);
+	};
+
+	return CardBadgeCustomData;
+});

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

@@ -48,7 +48,7 @@ sap.ui.define([
 	 * @implements sap.f.cards.IHeader
 	 *
 	 * @author SAP SE
-	 * @version 1.127.0
+	 * @version 1.128.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.127.0
+	 * @version 1.128.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.127.0
+	 * @version 1.128.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.127.0
+	 * @version 1.128.0
 	 *
 	 * @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.127.0
+	 * @version 1.128.0
 	 *
 	 * @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.127.0
+	 * @version 1.128.0
 	 *
 	 * @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.127.0
+	 * @version 1.128.0
 	 *
 	 * @constructor
 	 * @private

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

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

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

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.127.0
+	 * @version 1.128.0
 	 *
 	 * @constructor
 	 * @private

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

@@ -22,7 +22,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.127.0
+	 * @version 1.128.0
 	 *
 	 * @constructor
 	 * @private

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

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

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

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