@openui5/sap.ui.integration 1.138.0 → 1.140.0

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

@@ -190,7 +190,7 @@ sap.ui.define([
 	 * @extends sap.f.CardBase
 	 *
 	 * @author SAP SE
-	 * @version 1.138.0
+	 * @version 1.140.0
 	 * @public
 	 * @constructor
 	 * @see {@link topic:5b46b03f024542ba802d99d67bc1a3f4 Cards}
@@ -384,6 +384,16 @@ sap.ui.define([
 					visibility: "hidden"
 				},
 
+				/**
+				 * @since 1.140
+				 */
+				isPaginationCard: {
+					type: "boolean",
+					group: "Behavior",
+					defaultValue: false,
+					visibility: "hidden"
+				},
+
 				/**
 				 * Defines if the card is interactive.
 				 */
@@ -626,7 +636,7 @@ sap.ui.define([
 		 * @experimental since 1.79
 		 * @public
 		 * @author SAP SE
-		 * @version 1.138.0
+		 * @version 1.140.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
@@ -1451,21 +1461,24 @@ sap.ui.define([
 		this.destroyAggregation("_filterBar");
 		this.destroyAggregation("_footer");
 
-		this._cleanupOldManifest();
+		this._cleanupOldManifest(false);
 	};
 
 	/**
 	 * Cleans up internal models and other before new manifest processing.
+	 * @param {boolean} [bResetInternalModels=true] If true, the internal models will be reset.
 	 */
-	Card.prototype._cleanupOldManifest = function() {
+	Card.prototype._cleanupOldManifest = function(bResetInternalModels = true) {
 		if (this._fnOnModelChange) {
 			this.getModel().detachEvent("change", this._fnOnModelChange, this);
 			delete this._fnOnModelChange;
 		}
 
-		for (const modelName in this._INTERNAL_MODELS) {
-			if (this._INTERNAL_MODELS[modelName].reset) {
-				this._INTERNAL_MODELS[modelName].reset();
+		if (bResetInternalModels) {
+			for (const modelName in this._INTERNAL_MODELS) {
+				if (this._INTERNAL_MODELS[modelName].reset) {
+					this._INTERNAL_MODELS[modelName].reset();
+				}
 			}
 		}
 
@@ -1672,7 +1685,7 @@ sap.ui.define([
 	};
 
 	/**
-	 * Settings for blocking message that ocurred in a {@link sap.ui.integration.widgets.Card}
+	 * Settings for blocking message that occurred in a {@link sap.ui.integration.widgets.Card}
 	 *
 	 * @typedef {object} sap.ui.integration.BlockingMessageSettings
 	 * @property {sap.ui.integration.CardBlockingMessageType} type Blocking message type
@@ -1852,11 +1865,24 @@ sap.ui.define([
 			this._oDataProviderFactory.destroy();
 		}
 
-		this._oDestinations = new Destinations({
-			host: this.getHostInstance(),
-			card: this,
-			manifestConfig: this._oCardManifest.get(MANIFEST_PATHS.DESTINATIONS)
+		try {
+			this._oDestinations = Destinations.create({
+				card: this,
+				mainCard: this.getMainCard(),
+				isPaginationCard: this.getProperty("isPaginationCard")
 		});
+		} catch (oError) {
+			this.getMainCard()._handleError({
+				illustrationType: IllustratedMessageType.UnableToLoad,
+				title: oResourceBundle.getText("CARD_ERROR_CONFIGURATION_TITLE"),
+				description: oResourceBundle.getText("CARD_ERROR_CONFIGURATION_DESCRIPTION"),
+				details: " ",
+				originalError: oError
+			});
+
+			return Promise.reject(oError);
+		}
+
 		this._oIconFormatter = new IconFormatter({
 			card: this
 		});
@@ -1938,7 +1964,8 @@ sap.ui.define([
 			return;
 		}
 
-		this.bindObject(BindingResolver.resolveValue(oDataSettings.path || "/", this));
+		this._sBindingPath = oDataSettings.path || "/";
+		this.bindObject(BindingResolver.resolveValue(this._sBindingPath, this));
 
 		if (this._oDataProvider) {
 			this._oDataProvider.destroy();
@@ -2230,24 +2257,44 @@ sap.ui.define([
 	};
 
 	/**
-	 * Creates specific type of card content based on sap.card/content part of the manifest
+	 * Generates accessibility texts based on the rendering style of the card.
 	 *
 	 * @private
 	 */
-	Card.prototype._applyContentManifestSettings = function () {
-		var sCardType = this._oCardManifest.get(MANIFEST_PATHS.TYPE),
-			oContentManifest = this.getContentManifest(),
-			sAriaText,
-			oContent;
+	Card.prototype._applyAriaTexts = function () {
+		const sCardType = this._oCardManifest.get(MANIFEST_PATHS.TYPE);
+		const bIsTileDisplayVariant = this.isTileDisplayVariant();
+		let sAriaText;
 
-		if (sCardType) {
+
+		if (sCardType  && !bIsTileDisplayVariant) {
 			sAriaText = this._oIntegrationRb.getText("ARIA_DESCRIPTION_CARD_TYPE_" + sCardType.toUpperCase());
+
+			// @TODO: This adds the same text to the card. The region has an aria-describedby = card type. Group has aria-labelledby with the card type. Leads to duplicate hidden text.
+			// Suggestion for a fix: delete _ariaText and add _describedByCardTypeText to aria-labelled by of the region.
+			this._describedByCardTypeText.setText(sAriaText);
+		} else if (bIsTileDisplayVariant) {
+			sAriaText = this._oIntegrationRb.getText("ARIA_LABELLEDBY_DISPLAY_VARIANT_TILE");
 		} else {
 			sAriaText = this._oRb.getText("ARIA_ROLEDESCRIPTION_CARD");
 		}
-		this.destroyAggregation("_content");
+
 		this._ariaText.setText(sAriaText);
-		this._describedByCardTypeText.setText(sAriaText);
+	};
+
+	/**
+	 * Creates specific type of card content based on sap.card/content part of the manifest.
+	 *
+	 * @private
+	 */
+	Card.prototype._applyContentManifestSettings = function () {
+		var sCardType = this._oCardManifest.get(MANIFEST_PATHS.TYPE),
+			oContentManifest = this.getContentManifest(),
+			oContent;
+
+		this.destroyAggregation("_content");
+
+		this._applyAriaTexts();
 
 		if (this._shouldIgnoreContent()) {
 			this.fireEvent("_contentReady");
@@ -2362,6 +2409,15 @@ sap.ui.define([
 		return sCardType?.toLowerCase() === "component";
 	};
 
+	/**
+	 * @private
+	 * @ui5-restricted sap.ui.integration
+	 * @returns {string|undefined} The binding path for the card.
+	 */
+	Card.prototype._getDataPath = function () {
+		return this._sBindingPath || "/";
+	};
+
 	/**
 	 * Checks if the content section should be ignored.
 	 * @private
@@ -2759,10 +2815,30 @@ sap.ui.define([
 	};
 
 	/**
-	 * Performs an HTTP request using the given configuration.
+	 * Settings for card request error.
 	 *
+	 * <b>Note:</b> For backward compatibility, the object can also be accessed as an array
+	 * with the properties in the order - message, response, and responseText.
+	 *
+	 * @typedef {object} sap.ui.integration.CardRequestError
+	 * @property {string} message The error message
+	 * @property {object} response The response object
+	 * @property {string} responseText The response text
 	 * @public
-	 * @experimental since 1.79
+	 * @experimental As of version 1.139
+	 */
+
+	/**
+	 * Performs an asynchronous network request using the specified request settings,
+	 * enabling dynamic bindings to card configurations, such as CSRF tokens, destinations, and parameters.
+	 * If the request is successful, it returns a Promise that resolves with the response data.
+	 *
+	 * If an error occurs during the request, the Promise will reject with a {@link sap.ui.integration.CardRequestError}.
+	 *
+	 * For more details on card data handling and request settings see [Card Explorer Data Section]{@link https://ui5.sap.com/test-resources/sap/ui/integration/demokit/cardExplorer/webapp/index.html#/learn/features/data}.
+	 *
+	 * @public
+	 * @since 1.79
 	 * @param {object} oConfiguration The configuration of the request.
 	 * @param {string} oConfiguration.url The URL of the resource.
 	 * @param {string} [oConfiguration.mode="cors"] The mode of the request. Possible values are "cors", "no-cors", "same-origin".
@@ -2798,7 +2874,8 @@ sap.ui.define([
 	 *</ul>
 	 * @param {string} [oConfiguration.dataType="json"] Deprecated. Use the correct <code>Accept</code> headers and set correct <code>Content-Type</code> header in the response.
 	 * @param {object} [oConfiguration.headers] The HTTP headers of the request.
-	 * @param {boolean} [oConfiguration.withCredentials=false] Indicates whether cross-site requests should be made using credentials.
+	 * @param {boolean} [oConfiguration.withCredentials=false] Indicates whether
+	 * cross-site requests should be made using credentials. Same-origin requests are always made using credentials.
 	 * @returns {Promise<any>} Resolves when the request is successful, rejects otherwise.
 	 */
 	Card.prototype.request = function (oConfiguration) {
@@ -2812,7 +2889,19 @@ sap.ui.define([
 					true)
 				.setAllowCustomDataType(true)
 				.attachDataChanged((e) => { resolve(e.getParameter("data")); })
-				.attachError((e) => { reject([e.getParameter("message"), e.getParameter("response"), e.getParameter("responseText"), e.getParameter("settings")]); })
+				.attachError((e) => {
+					const oResult = [e.getParameter("message"),
+						e.getParameter("response"),
+						e.getParameter("responseText"),
+						e.getParameter("settings")];
+
+					oResult.message = e.getParameter("message");
+					oResult.response = e.getParameter("response");
+					oResult.responseText = e.getParameter("responseText");
+					oResult._requestSettings = e.getParameter("settings");
+
+					reject(oResult);
+				})
 				.triggerDataUpdate();
 			});
 		});
@@ -3292,6 +3381,7 @@ sap.ui.define([
 
 		oChildCard.setAssociation("openerReference", this);
 		oChildCard.setProperty("showCloseButton", !!oParameters.showCloseButton);
+		oChildCard.setProperty("isPaginationCard", !!oParameters.isPaginationCard);
 
 		if (oData) {
 			each(oData, function (sModelName, oModelData) {
@@ -3462,5 +3552,20 @@ sap.ui.define([
 		return !!this._bDataReady;
 	};
 
+	/**
+	 * @private
+	 * @ui5-restricted sap.ui.integration
+	 * @returns {sap.ui.integration.widgets.Card} The main card of the current card.
+	 */
+	Card.prototype.getMainCard = function () {
+		let oParentCard = Element.getElementById(this.getAssociation("openerReference"));
+
+		while (oParentCard && oParentCard.getAssociation("openerReference")) {
+			oParentCard = Element.getElementById(oParentCard.getAssociation("openerReference"));
+		}
+
+		return oParentCard || this;
+	};
+
 	return Card;
 });

package/ui5.yaml

@@ -44,8 +44,6 @@ builder:
               - "!sap/ui/integration/*-preload.js"
               - "!sap/ui/integration/designtime/"
               - "!sap/ui/integration/editor/"
-              - "!sap/viz/"
-              - "!sap/suite/ui/commons/"
               - sap/ui/core/support/Hotkeys.js
               - "!sap/ui/integration/thirdparty/"
               - "!sap/ui/integration/designtime/thirdparty/"
@@ -111,8 +109,6 @@ builder:
               - "!sap/ui/integration/*-preload.js"
               - "!sap/ui/integration/designtime/"
               - "!sap/ui/integration/editor/"
-              - "!sap/viz/"
-              - "!sap/suite/ui/commons/"
               - sap/ui/core/support/Hotkeys.js
               - "!sap/ui/integration/thirdparty/"
               - "!sap/ui/integration/designtime/thirdparty/"
@@ -169,6 +165,8 @@ builder:
               - sap/ui/core/Core.js
               - sap/ui/core/CustomData.js
               - sap/ui/core/UIComponent.js
+              - sap/ui/core/boot/FieldHelpEndpoint.js
+              - sap/ui/core/boot/KeyboardInteractionEndpoint.js
               - sap/ui/core/mvc/XMLView.js
               - sap/ui/integration/
               - sap/f/cards/
@@ -185,35 +183,64 @@ builder:
               - "!sap/ui/integration/*-preload.js"
               - "!sap/ui/integration/designtime/"
               - "!sap/ui/integration/editor/"
-              - "!sap/viz/"
-              - "!sap/suite/ui/commons/"
               - sap/ui/core/support/Hotkeys.js
               - "!sap/ui/integration/thirdparty/"
               - "!sap/ui/integration/designtime/thirdparty/"
+              # own manifest
+              - sap/ui/integration/manifest.json
+              # manifests for library dependencies
+              - sap/ui/core/manifest.json
+              - sap/m/manifest.json
+              - sap/f/manifest.json
+              - sap/ui/unified/manifest.json
+              - sap/ui/layout/manifest.json
             resolve: true
             renderer: true
           - mode: require
             filters:
               - sap/ui/integration/library-bootstrap.js
+          - mode: bundleInfo
+            name: sap-ui-integration-nojQuery-ext.js
+            filters:
+               - sap/ui/core/
+               - "!sap/ui/core/support/"
+               - "!sap/ui/core/plugin/"
+               - sap/ui/integration/
+               - "!sap/ui/integration/editor/"
+               - "!sap/ui/integration/thirdparty/"
+               - "!sap/ui/fl/"
+               - sap/m/
+               - sap/f/
+               - sap/ui/layout/
+               - sap/ui/unified/
+               - "!**/designtime/"
+               - "!**/library-preload-lazy.js"
+               - "!**/*.support.js"
+               - "!**/*.flexibility.js"
+            resolve: true
+            renderer: true
       bundleOptions:
         optimize: true
         usePredefineCalls: true
         decorateBootstrapModule: true
         addTryCatchRestartWrapper: true
     - bundleDefinition:
-        name: sap-ui-integration-card-editor.js
+        name: sap-ui-integration-nojQuery-ext.js
         sections:
           - mode: provided
             filters:
-              - sap/ui/integration/sap-ui-integration-config.js
-              - ui5loader-autoconfig.js
+              - sap/ui/thirdparty/jquery-compat.js
               - sap/ui/core/Core.js
               - sap/ui/core/CustomData.js
               - sap/ui/core/UIComponent.js
+              - sap/ui/core/boot/FieldHelpEndpoint.js
+              - sap/ui/core/boot/KeyboardInteractionEndpoint.js
               - sap/ui/core/mvc/XMLView.js
               - sap/ui/integration/
               - sap/f/cards/
               - sap/ui/core/date/Gregorian.js
+              - "!sap/ui/thirdparty/jquery.js"
+              - "!sap/ui/thirdparty/jquery-mobile-custom.js"
               - "!sap/ui/integration/sap-ui-integration-config.js"
               - "!sap/ui/integration/customElements/CustomElementCardEditor.js"
               - "!sap/ui/integration/customElements/CustomElementEditor.js"
@@ -224,29 +251,44 @@ builder:
               - "!sap/ui/integration/*-preload.js"
               - "!sap/ui/integration/designtime/"
               - "!sap/ui/integration/editor/"
-              - "!sap/viz/"
-              - "!sap/suite/ui/commons/"
               - sap/ui/core/support/Hotkeys.js
               - "!sap/ui/integration/thirdparty/"
               - "!sap/ui/integration/designtime/thirdparty/"
+              # own manifest
+              - sap/ui/integration/manifest.json
+              # manifests for library dependencies
+              - sap/ui/core/manifest.json
+              - sap/m/manifest.json
+              - sap/f/manifest.json
+              - sap/ui/unified/manifest.json
+              - sap/ui/layout/manifest.json
             resolve: true
             renderer: true
           - mode: preload
-            name: sap-ui-integration-card-editor
+            name: sap-ui-integration-nojQuery-ext.js
             filters:
-              - sap/ui/integration/customElements/CustomElementCardEditor.js
-              - sap/ui/integration/editor/
-              - sap/ui/integration/designtime/editor/
+              - sap/ui/core/
+              - "!sap/ui/core/support/"
+              - "!sap/ui/core/plugin/"
+              - sap/ui/integration/
+              - "!sap/ui/integration/editor/"
+              - "!sap/ui/integration/thirdparty/"
+              - "!sap/ui/fl/"
+              - sap/m/
+              - sap/f/
+              - sap/ui/layout/
+              - sap/ui/unified/
+              - "!**/designtime/"
+              - "!**/library-preload-lazy.js"
+              - "!**/*.support.js"
+              - "!**/*.flexibility.js"
             resolve: true
             renderer: true
-          - mode: require
-            filters:
-              - sap/ui/integration/customElements/CustomElementCardEditor.js
       bundleOptions:
         optimize: true
         usePredefineCalls: true
     - bundleDefinition:
-        name: sap-ui-integration-cardEditor.js
+        name: sap-ui-integration-card-editor.js
         sections:
           - mode: provided
             filters:
@@ -277,18 +319,21 @@ builder:
             resolve: true
             renderer: true
           - mode: preload
-            name: sap-ui-integration-cardEditor
+            name: sap-ui-integration-card-editor
             filters:
-              - sap/ui/integration/designtime/baseEditor/
-              - sap/ui/integration/designtime/cardEditor/
-              - "!sap/ui/integration/designtime/cardEditor/ConfigurationTemplate.js"
+              - sap/ui/integration/customElements/CustomElementCardEditor.js
+              - sap/ui/integration/editor/
+              - sap/ui/integration/designtime/editor/
             resolve: true
             renderer: true
+          - mode: require
+            filters:
+              - sap/ui/integration/customElements/CustomElementCardEditor.js
       bundleOptions:
         optimize: true
         usePredefineCalls: true
     - bundleDefinition:
-        name: sap-ui-integration-editor.js
+        name: sap-ui-integration-cardEditor.js
         sections:
           - mode: provided
             filters:
@@ -319,31 +364,23 @@ builder:
             resolve: true
             renderer: true
           - mode: preload
-            name: sap-ui-integration-editor
+            name: sap-ui-integration-cardEditor
             filters:
-              - sap/ui/integration/customElements/CustomElementEditor.js
-              - sap/ui/integration/editor/
+              - sap/ui/integration/designtime/baseEditor/
+              - sap/ui/integration/designtime/cardEditor/
+              - "!sap/ui/integration/designtime/cardEditor/ConfigurationTemplate.js"
             resolve: true
             renderer: true
-          - mode: require
-            filters:
-              - sap/ui/integration/customElements/CustomElementEditor.js
       bundleOptions:
         optimize: true
         usePredefineCalls: true
     - bundleDefinition:
-        name: sap-ui-integration-shell-toolkit.js
+        name: sap-ui-integration-editor.js
         sections:
-          - mode: raw
+          - mode: provided
             filters:
               - sap/ui/integration/sap-ui-integration-config.js
               - ui5loader-autoconfig.js
-            declareRawModules: false
-            resolve: true
-            sort: true
-          - mode: preload
-            name: sap-ui-integration
-            filters:
               - sap/ui/core/Core.js
               - sap/ui/core/CustomData.js
               - sap/ui/core/UIComponent.js
@@ -351,10 +388,6 @@ builder:
               - sap/ui/integration/
               - sap/f/cards/
               - sap/ui/core/date/Gregorian.js
-              - sap/m/IconTabBar.js
-              - sap/m/GenericTile.js
-              - sap/m/TileContent.js
-              - sap/m/ImageContent.js
               - "!sap/ui/integration/sap-ui-integration-config.js"
               - "!sap/ui/integration/customElements/CustomElementCardEditor.js"
               - "!sap/ui/integration/customElements/CustomElementEditor.js"
@@ -372,14 +405,19 @@ builder:
               - "!sap/ui/integration/designtime/thirdparty/"
             resolve: true
             renderer: true
+          - mode: preload
+            name: sap-ui-integration-editor
+            filters:
+              - sap/ui/integration/customElements/CustomElementEditor.js
+              - sap/ui/integration/editor/
+            resolve: true
+            renderer: true
           - mode: require
             filters:
-              - sap/ui/integration/library-bootstrap.js
+              - sap/ui/integration/customElements/CustomElementEditor.js
       bundleOptions:
         optimize: true
         usePredefineCalls: true
-        decorateBootstrapModule: true
-        addTryCatchRestartWrapper: true
   jsdoc:
     excludes:
       - "sap/ui/integration/thirdparty/**"
@@ -391,6 +429,5 @@ builder:
       - sap-ui-integration-editor.js
       - sap-ui-integration-card-editor.js
       - sap-ui-integration-cardEditor.js
-      - sap-ui-integration-shell-toolkit.js
       - sap/ui/integration/thirdparty/**
       - sap/ui/integration/designtime/cardEditor/ConfigurationTemplate.js