@openui5/sap.ui.integration 1.132.1 → 1.134.0

package/src/sap/ui/integration/util/SkeletonCard.js

@@ -23,7 +23,7 @@ sap.ui.define([
 	 * @extends sap.ui.integration.widgets.Card
 	 *
 	 * @author SAP SE
-	 * @version 1.132.1
+	 * @version 1.134.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/util/SorterHelper.js

@@ -17,7 +17,7 @@ sap.ui.define([
 	 * Utility class helping with sap.ui.model.Sorter control.
 	 *
 	 * @author SAP SE
-	 * @version 1.132.1
+	 * @version 1.134.0
 	 *
 	 * @private
 	 * @alias sap.ui.integration.util.SorterHelper

package/src/sap/ui/integration/util/Utils.js

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * Utility class helping with JSON strings and formatters.
 	 *
 	 * @author SAP SE
-	 * @version 1.132.1
+	 * @version 1.134.0
 	 *
 	 * @private
 	 * @alias sap.ui.integration.util.Utils
@@ -37,7 +37,7 @@ sap.ui.define([
 	var Utils = { };
 
 	/**
-	 * Currently WZ language list does not match the one used by Card Editor
+	 * Currently language list of WZ Advanced Edition does not match the one used by Card Editor
 	 * Need to mapping the different languages
 	 * key/value:  language_code_in_WZ/language_code_in_CE
 	 * NOTES: skip the languages which does not match between Card Editor and UI5, eg: cy-GB/cy, nb-NO/no, sr-RS/sh
@@ -45,6 +45,7 @@ sap.ui.define([
 	Utils.languageMapping = {
 		//"cy": "cy-GB",
 		"da-DK": "da",
+		"en-US": "en",
 		"hi-IN": "hi",
 		"hu-HU": "hu",
 		"id-ID": "id",
@@ -66,10 +67,27 @@ sap.ui.define([
 		return Utils.languageMapping[language] || language;
 	};
 
+	/**
+	 * Replace underline to dash of language codes in translation texts of changes
+	 * @returns {object} translation texts
+	 */
+	Utils.formatLanguageCodesInTranslationTexts = function(oTexts) {
+		var oFormattedTexts;
+		if (oTexts) {
+			oFormattedTexts = {};
+			Object.keys(oTexts).forEach(function(sLanguage) {
+				var sFormattedLanguage = sLanguage.replaceAll('_', '-');
+				oFormattedTexts[sFormattedLanguage] = oTexts[sLanguage];
+			});
+		}
+		return oFormattedTexts;
+	};
+
 	Utils.mapLanguagesInManifestChanges = function(oManifestChanges) {
 		if (typeof oManifestChanges === "object") {
 			oManifestChanges.forEach(function (oChange) {
 				if (oChange.texts) {
+					oChange.texts = Utils.formatLanguageCodesInTranslationTexts(oChange.texts);
 					for (var [sLanguage, sMappingLanguage] of Object.entries(Utils.languageMapping)) {
 						if (oChange.texts[sLanguage]) {
 							var oTranslations = deepClone(oChange.texts[sLanguage], 500);

package/src/sap/ui/integration/util/Validators.js

@@ -11,7 +11,7 @@ sap.ui.define([], function () {
 	 * Utility class helping with input validations.
 	 *
 	 * @author SAP SE
-	 * @version 1.132.1
+	 * @version 1.134.0
 	 *
 	 * @private
 	 * @alias sap.ui.integration.util.Validators

package/src/sap/ui/integration/util/openCardDialog.js

@@ -62,15 +62,6 @@ sap.ui.define([
 		});
 	}
 
-	function _enableResizing(oDialog, oChildCard) {
-		// We can not set the contentHeight during resize as the dialog "jumps" if invalidated then.
-		// So it needs to be done after open.
-		oDialog.attachAfterOpen(() => {
-			oChildCard.setHeight("100%");
-			oDialog.setContentHeight(oDialog.getDomRef("cont").offsetHeight + "px");
-		});
-	}
-
 	function _setDialogHeader(oDialog, oChildCard) {
 		const oHeader = oChildCard.getCardHeader();
 		if (!oHeader) {
@@ -145,17 +136,24 @@ sap.ui.define([
 		oChildCard.attachEvent("_ready", () => {
 			_setDialogHeader(oDialog, oChildCard);
 			_setAriaAttributes(oDialog, oChildCard);
-			oDialog.open();
+			if (!oChildCard._isComponentCard()) {
+				oDialog.open();
+			}
 			_setFocus(oChildCard, oDialog);
 		});
 
 		if (!Device.system.phone) {
 			_addAnimationDelegate(oDialog, oParentCard);
-			_enableResizing(oDialog, oChildCard);
 		}
 
-		oChildCard.startManifestProcessing();
+		oChildCard.attachManifestReady(() => {
+			// component card does not trigger the ready event if it hasn't been rendered yet
+			if (oChildCard._isComponentCard()) {
+				oDialog.open();
+			}
+		});
 
+		oChildCard.startManifestProcessing();
 		return oDialog;
 	}
 

package/src/sap/ui/integration/util/openCardShowMore.js

@@ -0,0 +1,49 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+sap.ui.define([
+	"sap/base/util/uid",
+	"sap/ui/integration/util/openCardDialog"
+], (
+	uid,
+	openCardDialog
+) => {
+	"use strict";
+
+	function _createManifest(oCard) {
+		const oManifest = oCard.getManifestEntry("/");
+
+		oManifest["sap.app"].id = oManifest["sap.app"].id + uid();
+
+		oCard.getAggregation("_filterBar")?._getFilters().forEach((oFilter) => {
+			oFilter.writeValueToConfiguration(oManifest["sap.card"].configuration.filters[oFilter.getKey()]);
+		});
+
+		return oManifest;
+	}
+
+	/**
+	 * Opens the same card in a dialog with scrolling.
+	 * @function
+	 * @since 1.133
+	 * @private
+	 * @ui5-restricted sap.ui.integration
+	 * @param {sap.ui.integration.widgets.Card} oCard The card to be opened.
+	 * @returns {sap.m.Dialog} The opened dialog.
+	 */
+	function openCardShowMore(oCard) {
+		return openCardDialog(
+			oCard,
+			{
+				manifest: _createManifest(oCard),
+				baseUrl: oCard.getBaseUrl(),
+				showCloseButton: true
+			}
+		);
+	}
+
+	return openCardShowMore;
+});

package/src/sap/ui/integration/widgets/Card.js

@@ -28,7 +28,7 @@ sap.ui.define([
 	"sap/f/library",
 	"sap/ui/integration/library",
 	"sap/ui/integration/util/Destinations",
-	"sap/ui/integration/util/LoadingProvider",
+	"sap/ui/integration/util/DelayedLoadingProvider",
 	"sap/ui/integration/util/HeaderFactory",
 	"sap/ui/integration/util/ContentFactory",
 	"sap/ui/integration/util/BindingResolver",
@@ -67,7 +67,7 @@ sap.ui.define([
 	fLibrary,
 	library,
 	Destinations,
-	LoadingProvider,
+	DelayedLoadingProvider,
 	HeaderFactory,
 	ContentFactory,
 	BindingResolver,
@@ -84,7 +84,7 @@ sap.ui.define([
 ) {
 	"use strict";
 
-	var MANIFEST_PATHS = {
+	const MANIFEST_PATHS = {
 		TYPE: "/sap.card/type",
 		ACTIONS: "/sap.card/actions",
 		DATA: "/sap.card/data",
@@ -103,37 +103,39 @@ sap.ui.define([
 		MODEL_SIZE_LIMIT: "/sap.card/configuration/modelSizeLimit"
 	};
 
-	var RESERVED_PARAMETER_NAMES = ["visibleItems", "allItems"];
+	const RESERVED_PARAMETER_NAMES = ["visibleItems", "allItems"];
 
-	var HeaderPosition = fLibrary.cards.HeaderPosition;
+	const HeaderPosition = fLibrary.cards.HeaderPosition;
 
-	var SemanticRole = fLibrary.cards.SemanticRole;
+	const SemanticRole = fLibrary.cards.SemanticRole;
 
-	var ActionArea = library.CardActionArea;
+	const ActionArea = library.CardActionArea;
 
-	var CardArea = library.CardArea;
+	const CardArea = library.CardArea;
 
-	var CardDataMode = library.CardDataMode;
+	const CardDataMode = library.CardDataMode;
 
-	var CardDesign = library.CardDesign;
+	const CardDesign = library.CardDesign;
 
-	var CardDisplayVariant = library.CardDisplayVariant;
+	const CardDisplayVariant = library.CardDisplayVariant;
 
-	var CardPreviewMode = library.CardPreviewMode;
+	const CardPreviewMode = library.CardPreviewMode;
 
-	var CardBlockingMessageType = library.CardBlockingMessageType;
+	const CardOverflow = library.CardOverflow;
 
-	var CARD_DESTROYED_ERROR = "Card is destroyed!";
+	const CardBlockingMessageType = library.CardBlockingMessageType;
 
-	var MODULE_PREFIX = "module:";
+	const CARD_DESTROYED_ERROR = "Card is destroyed!";
 
-	var DEFAULT_MODEL_SIZE_LIMIT = 1000;
+	const MODULE_PREFIX = "module:";
+
+	const DEFAULT_MODEL_SIZE_LIMIT = 1000;
 
 	/**
 	 * Constructor for a new <code>Card</code>.
 	 *
-	 * @param {string} [sId] ID for the new control, generated automatically if no ID is given
-	 * @param {object} [mSettings] Initial settings for the new control
+	 * @param {string} [sId] ID for the new control. ID generated automatically if no ID is provided.
+	 * @param {object} [mSettings] Initial settings for the new control.
 	 *
 	 * @class
 	 * A control that represents a container with a header and content.
@@ -186,7 +188,7 @@ sap.ui.define([
 	 * @extends sap.f.CardBase
 	 *
 	 * @author SAP SE
-	 * @version 1.132.1
+	 * @version 1.134.0
 	 * @public
 	 * @constructor
 	 * @see {@link topic:5b46b03f024542ba802d99d67bc1a3f4 Cards}
@@ -356,6 +358,20 @@ sap.ui.define([
 					defaultValue: false
 				},
 
+				/**
+				 * Allows to control the overflow behaviour of the card.
+				 *
+				 * <b>Note</b>: If the "Default" option is used, the card must be allowed to grow in height as much as it needs to avoid overflowing. Use a layout which allows this.
+				 *
+				 * @experimental Since 1.133
+				 * @since 1.133
+				 */
+				overflow: {
+					type: "sap.ui.integration.CardOverflow",
+					group: "Behavior",
+					defaultValue: CardOverflow.Default
+				},
+
 				/**
 				 * @since 1.128
 				 */
@@ -583,7 +599,7 @@ sap.ui.define([
 	Card.prototype.init = function () {
 		CardBase.prototype.init.call(this);
 
-		this.setAggregation("_loadingProvider", new LoadingProvider());
+		this.setAggregation("_loadingProvider", new DelayedLoadingProvider());
 
 		this._oIntegrationRb = Library.getResourceBundleFor("sap.ui.integration");
 		this._iModelSizeLimit = DEFAULT_MODEL_SIZE_LIMIT;
@@ -608,7 +624,7 @@ sap.ui.define([
 		 * @experimental since 1.79
 		 * @public
 		 * @author SAP SE
-		 * @version 1.132.1
+		 * @version 1.134.0
 		 * @borrows sap.ui.integration.widgets.Card#getId as getId
 		 * @borrows sap.ui.integration.widgets.Card#getDomRef as getDomRef
 		 * @borrows sap.ui.integration.widgets.Card#setVisible as setVisible
@@ -789,9 +805,15 @@ sap.ui.define([
 	 * @private
 	 */
 	Card.prototype.onBeforeRendering = function () {
-		var oCardContent = this.getCardContent();
+		const oCardContent = this.getCardContent();
 		if (oCardContent && oCardContent.isA("sap.ui.integration.cards.BaseContent")) {
 			oCardContent.setDesign(this.getDesign());
+			oCardContent.setOverflowWithShowMore(this.getOverflow() === CardOverflow.ShowMore);
+		}
+
+		const oFooter = this.getCardFooter();
+		if (oFooter) {
+			oFooter.setDetectVisibility(this.getOverflow() === CardOverflow.ShowMore);
 		}
 
 		if (this._getActualDataMode() !== CardDataMode.Active) {
@@ -1891,6 +1913,7 @@ sap.ui.define([
 
 		this._applyModelSizeLimit();
 
+		this._applyLoadingDelay();
 		this._applyServiceManifestSettings();
 		this._applyFilterBarManifestSettings();
 		this._applyDataManifestSettings();
@@ -2142,6 +2165,7 @@ sap.ui.define([
 		if (oPrevHeader) {
 			oPrevHeader.setToolbar(null); // ensure that actionsToolbar won't be destroyed
 			oPrevHeader.destroy();
+			this._bMimicPressAttached = false;
 		}
 
 		var oHeader = this.createHeader();
@@ -2164,6 +2188,10 @@ sap.ui.define([
 				this.fireEvent("_headerReady");
 			}.bind(this));
 		}
+
+		if (this._shouldMimicHeaderAction()) {
+			this._mimicHeaderAction(oHeader);
+		}
 	};
 
 	Card.prototype._applyFilterBarManifestSettings = function () {
@@ -2198,6 +2226,14 @@ sap.ui.define([
 		this.fireEvent("_footerReady");
 	};
 
+	Card.prototype._applyLoadingDelay = function () {
+		const iLoadingDelay = parseInt(this.getManifestEntry("/sap.card/configuration/loadingPlaceholders/delay"));
+		if (!iLoadingDelay){
+			return;
+		}
+		this.getAggregation("_loadingProvider").applyDelay(iLoadingDelay);
+	};
+
 	/**
 	 * Gets the instance of the <code>host</code> association.
 	 *
@@ -2241,7 +2277,8 @@ sap.ui.define([
 				dataProviderFactory: this._oDataProviderFactory,
 				iconFormatter: this._oIconFormatter,
 				noDataConfiguration: this._oCardManifest.get(MANIFEST_PATHS.NO_DATA_MESSAGES),
-				paginator: this._oPaginator
+				paginator: this._oPaginator,
+				overflowWithShowMore: this.getOverflow() === CardOverflow.ShowMore
 			});
 		} catch (e) {
 			this._handleError({
@@ -2331,6 +2368,7 @@ sap.ui.define([
 	/**
 	 * Checks if this is a Component Card. Manifest must be loaded for that check.
 	 * @private
+	 * @ui5-restricted sap.ui.integration
 	 * @returns {boolean} True if this is a Component Card.
 	 */
 	Card.prototype._isComponentCard = function () {
@@ -2389,14 +2427,11 @@ sap.ui.define([
 	Card.prototype.createFooter = function () {
 		var oManifestFooter = this._oCardManifest.get(MANIFEST_PATHS.FOOTER);
 
-		if (!oManifestFooter) {
-			return null;
-		}
-
 		return Footer.create({
 			card: this,
 			configuration: oManifestFooter,
 			showCloseButton: this.getProperty("showCloseButton"),
+			detectVisibility: this.getOverflow() === CardOverflow.ShowMore,
 			paginator: this._oPaginator
 		});
 	};
@@ -2431,6 +2466,7 @@ sap.ui.define([
 		return this._oContentFactory.create(mContentConfig);
 	};
 
+
 	/**
 	 * Sets a card content.
 	 *
@@ -2704,6 +2740,10 @@ sap.ui.define([
 	 * @protected
 	 */
 	Card.prototype.getFocusDomRef = function () {
+		if (this.getGridItemRole()) {
+			return this.getDomRef();
+		}
+
 		if (this.isInteractive() && this.getSemanticRole() === SemanticRole.ListItem) {
 			return this.getDomRef();
 		}
@@ -3340,6 +3380,66 @@ sap.ui.define([
 		return bIsInteractive && this.getProperty("interactive");
 	};
 
+	/**
+	 * @override
+	 */
+	Card.prototype.isMouseInteractionDisabled = function() {
+		return this._shouldMimicHeaderAction();
+	};
+
+	/**
+	 * Checks if the header action must be mimicked by the card.
+	 * @private
+	 * @returns {boolean} Whether the header action should be mimicked.
+	 */
+	Card.prototype._shouldMimicHeaderAction = function () {
+		if (!this._isManifestReady) {
+			return false;
+		}
+
+		const oCardActions = this.getManifestEntry("/sap.card/actions");
+		const oHeaderActions = this.getManifestEntry("/sap.card/header/actions");
+		const bIsListItem = this.isRoleListItem();
+
+		if (bIsListItem && !oCardActions && oHeaderActions)	{
+			return true;
+		}
+
+		return false;
+	};
+
+	/**
+	 * Attaches the press event of the header to the card.
+	 * @private
+	 * @param {Object} oHeader The header.
+	 */
+	Card.prototype._mimicHeaderAction = function (oHeader) {
+		// header must be clickable, but not focusable
+		oHeader.setProperty("focusable", false);
+
+		// card must invalidate to update the mouse interactivity
+		this.invalidate();
+
+		oHeader.addEventDelegate({
+			onBeforeRendering: () => {
+				this.setProperty("interactive", oHeader.getInteractive());
+
+				if (!oHeader.getInteractive()) {
+					return;
+				}
+
+				if (!this._bMimicPressAttached) {
+					this.attachPress((oEvent) => {
+						oHeader.firePress({
+							originalEvent: oEvent.getParameter("originalEvent")
+						});
+					});
+					this._bMimicPressAttached = true;
+				}
+			}
+		});
+	};
+
 	/**
 	 * @private
 	 * @ui5-restricted sap.ui.integration

package/src/sap/ui/integration/widgets/CardRenderer.js

@@ -58,6 +58,11 @@ sap.ui.define([
 			if (oCard.getManifest() && (!oCard.getCardHeader() || oCard._getActualDataMode() !== CardDataMode.Active)) {
 				oRm.attr("tabindex", "0");
 			}
+
+			const oLoadingProvider = oCard.getAggregation("_loadingProvider");
+			if (oLoadingProvider.getDelayed()) {
+				oRm.class("sapFCardLoadingDelayed");
+			}
 		},
 
 		renderCardAppId: function (oRm, oCard) {

package/LICENSES/LicenseRef-tzdata-PublicDomain.txt

@@ -1,5 +0,0 @@
-Unless specified below, all files in the tz code and data (including
-this LICENSE file) are in the public domain.
-
-If the files date.c, newstrftime.3, and strftime.c are present, they
-contain material derived from BSD and use the BSD 3-clause license.

package/LICENSES/Unicode-DFS-2015.txt

@@ -1,51 +0,0 @@
-UNICODE, INC. LICENSE AGREEMENT - DATA FILES AND SOFTWARE
-
-Unicode Data Files include all data files under the directories http://www.unicode.org/Public/,
-http://www.unicode.org/reports/, and http://www.unicode.org/cldr/data/. Unicode
-Data Files do not include PDF online code charts under the directory http://www.unicode.org/Public/.
-Software includes any source code published in the Unicode Standard or under
-the directories http://www.unicode.org/Public/, http://www.unicode.org/reports/,
-and http://www.unicode.org/cldr/data/.
-
-NOTICE TO USER: Carefully read the following legal agreement. BY DOWNLOADING,
-INSTALLING, COPYING OR OTHERWISE USING UNICODE INC.'S DATA FILES ("DATA FILES"),
-AND/OR SOFTWARE ("SOFTWARE"), YOU UNEQUIVOCALLY ACCEPT, AND AGREE TO BE BOUND
-BY, ALL OF THE TERMS AND CONDITIONS OF THIS AGREEMENT. IF YOU DO NOT AGREE,
-DO NOT DOWNLOAD, INSTALL, COPY, DISTRIBUTE OR USE THE DATA FILES OR SOFTWARE.
-
-COPYRIGHT AND PERMISSION NOTICE
-
-Copyright © 1991-2015 Unicode, Inc. All rights reserved. Distributed under
-the Terms of Use in http://www.unicode.org/copyright.html.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of the Unicode data files and any associated documentation (the "Data Files")
-or Unicode software and any associated documentation (the "Software") to deal
-in the Data Files or Software without restriction, including without limitation
-the rights to use, copy, modify, merge, publish, distribute, and/or sell copies
-of the Data Files or Software, and to permit persons to whom the Data Files
-or Software are furnished to do so, provided that
-
-(a) this copyright and permission notice appear with all copies of the Data
-Files or Software,
-
-(b) this copyright and permission notice appear in associated documentation,
-and
-
-(c) there is clear notice in each modified Data File or in the Software as
-well as in the documentation associated with the Data File(s) or Software
-that the data or software has been modified.
-
-THE DATA FILES AND SOFTWARE ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
-KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
-IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE
-BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES,
-OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
-IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
-OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THE DATA FILES OR SOFTWARE.
-
-Except as contained in this notice, the name of a copyright holder shall not
-be used in advertising or otherwise to promote the sale, use or other dealings
-in these Data Files or Software without prior written authorization of the
-copyright holder.