@openui5/sap.ui.mdc 1.141.2 → 1.143.0

package/README.md

@@ -14,7 +14,7 @@ The APIs in this library are experimental. See the [OpenUI5 Compatibility Rules]
 
 ## Usage
 
-Add this library as a dependency to your UI5 project by using [UI5 Tooling](https://sap.github.io/ui5-tooling/):
+Add this library as a dependency to your UI5 project by using [UI5 CLI](https://ui5.github.io/cli/):
 
 
 
@@ -27,7 +27,7 @@ ui5 add sap.ui.mdc
 
 
 
-For more information, please refer to our documentation on [Consuming OpenUI5 Libraries](https://sap.github.io/ui5-tooling/pages/OpenUI5/).
+For more information, please refer to our documentation on [Consuming OpenUI5 Libraries](https://ui5.github.io/cli/pages/OpenUI5/).
 
 
 

package/REUSE.toml

@@ -21,6 +21,44 @@ SPDX-License-Identifier = "Apache-2.0"
 #
 
 
+# Library: sap.f:
+
+[[annotations]]
+path = "src/sap.f/src/sap/f/thirdparty/**"
+precedence = "aggregate"
+SPDX-FileCopyrightText = "SAP"
+SPDX-License-Identifier = "Apache-2.0"
+SPDX-FileComment = "these files belong to: UI5 Web Components"
+
+[[annotations]]
+path = "src/sap.f/src/sap/f/thirdparty/**"
+precedence = "aggregate"
+SPDX-FileCopyrightText = "SAP"
+SPDX-License-Identifier = "Apache-2.0"
+SPDX-FileComment = "these files belong to: UI5 Web Components Fiori"
+
+[[annotations]]
+path = "src/sap.f/src/sap/f/thirdparty/**"
+precedence = "aggregate"
+SPDX-FileCopyrightText = "SAP"
+SPDX-License-Identifier = "Apache-2.0"
+SPDX-FileComment = "these files belong to: UI5 Web Components Icons"
+
+[[annotations]]
+path = "src/sap.f/src/sap/f/thirdparty/**"
+precedence = "aggregate"
+SPDX-FileCopyrightText = "SAP"
+SPDX-License-Identifier = "Apache-2.0"
+SPDX-FileComment = "these files belong to: UI5 Web Components Icons Business Suite"
+
+[[annotations]]
+path = "src/sap.f/src/sap/f/thirdparty/**"
+precedence = "aggregate"
+SPDX-FileCopyrightText = "SAP"
+SPDX-License-Identifier = "Apache-2.0"
+SPDX-FileComment = "these files belong to: UI5 Web Components Icons TNT"
+
+
 # Library: sap.m:
 
 [[annotations]]
@@ -347,7 +385,7 @@ SPDX-FileComment = "these files belong to: handlebars"
 [[annotations]]
 path = "src/sap.ui.core/src/sap/ui/thirdparty/require.js"
 precedence = "aggregate"
-SPDX-FileCopyrightText = "2010-2012, The Dojo Foundation"
+SPDX-FileCopyrightText = "2010-2024, jQuery Foundation and other contributors"
 SPDX-License-Identifier = "MIT"
 SPDX-FileComment = "these files belong to: requireJS"
 

package/THIRDPARTY.txt

@@ -4,6 +4,39 @@ each subcomponent.
 The full text of all referenced licenses is appended at the end of this file.
 
 
+Library: sap.f:
+
+Component: UI5 Web Components, version: 2.15.0
+Copyright: SAP
+License: Apache-2.0
+License Text: https://github.com/UI5/openui5/blob/master/LICENSES/Apache-2.0.txt
+Contained in: src/sap.f/src/sap/f/thirdparty/**
+
+Component: UI5 Web Components Fiori, version: 2.15.0
+Copyright: SAP
+License: Apache-2.0
+License Text: https://github.com/UI5/openui5/blob/master/LICENSES/Apache-2.0.txt
+Contained in: src/sap.f/src/sap/f/thirdparty/**
+
+Component: UI5 Web Components Icons, version: 2.15.0
+Copyright: SAP
+License: Apache-2.0
+License Text: https://github.com/UI5/openui5/blob/master/LICENSES/Apache-2.0.txt
+Contained in: src/sap.f/src/sap/f/thirdparty/**
+
+Component: UI5 Web Components Icons Business Suite, version: 2.15.0
+Copyright: SAP
+License: Apache-2.0
+License Text: https://github.com/UI5/openui5/blob/master/LICENSES/Apache-2.0.txt
+Contained in: src/sap.f/src/sap/f/thirdparty/**
+
+Component: UI5 Web Components Icons TNT, version: 2.15.0
+Copyright: SAP
+License: Apache-2.0
+License Text: https://github.com/UI5/openui5/blob/master/LICENSES/Apache-2.0.txt
+Contained in: src/sap.f/src/sap/f/thirdparty/**
+
+
 Library: sap.m:
 
 Component: purify.js, version: 3.2.4
@@ -221,8 +254,8 @@ License: MIT
 License Text: https://github.com/UI5/openui5/blob/master/LICENSES/MIT.txt
 Contained in: src/sap.ui.core/src/sap/ui/thirdparty/handlebars.js
 
-Component: requireJS, version: 2.1.8
-Copyright: 2010-2012, The Dojo Foundation
+Component: requireJS, version: 2.3.7
+Copyright: 2010-2024, jQuery Foundation and other contributors
 License: MIT
 License Text: https://github.com/UI5/openui5/blob/master/LICENSES/MIT.txt
 Contained in: src/sap.ui.core/src/sap/ui/thirdparty/require.js
@@ -354,7 +387,7 @@ Contained in: src/sap.ui.documentation/src/sap/ui/documentation/sdk/thirdparty/D
 
 Library: sap.ui.integration:
 
-Component: UI5 Web Components, version: 1.7.0
+Component: UI5 Web Components, version: 2.15.0
 Copyright: SAP
 License: Apache-2.0
 License Text: https://github.com/UI5/openui5/blob/master/LICENSES/Apache-2.0.txt

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openui5/sap.ui.mdc",
-  "version": "1.141.2",
+  "version": "1.143.0",
   "description": "OpenUI5 UI Library sap.ui.mdc",
   "author": "SAP SE (https://www.sap.com)",
   "license": "Apache-2.0",
@@ -14,8 +14,8 @@
     "url": "https://github.com/UI5/openui5.git"
   },
   "dependencies": {
-    "@openui5/sap.m": "1.141.2",
-    "@openui5/sap.ui.core": "1.141.2",
-    "@openui5/sap.ui.layout": "1.141.2"
+    "@openui5/sap.m": "1.143.0",
+    "@openui5/sap.ui.core": "1.143.0",
+    "@openui5/sap.ui.layout": "1.143.0"
   }
 }

package/src/sap/ui/mdc/.library

@@ -6,7 +6,7 @@
 	<copyright>OpenUI5
  * (c) Copyright 2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.</copyright>
-	<version>1.141.2</version>
+	<version>1.143.0</version>
 
 	<documentation>UI5 library: sap.ui.mdc</documentation>
 

package/src/sap/ui/mdc/ActionToolbar.js

@@ -33,7 +33,7 @@ sap.ui.define([
 	 * The content aggregation of the control must not be used.
 	 * @extends sap.m.OverflowToolbar
 	 * @author SAP SE
-	 * @version 1.141.2
+	 * @version 1.143.0
 	 * @constructor
 	 * @since 1.58
 	 * @private
@@ -53,17 +53,6 @@ sap.ui.define([
 					type: "boolean",
 					group: "Behavior",
 					defaultValue: true
-				},
-
-				/**
-				 * Defines the order of the end aggregation.
-				 * @private
-				 * @ui5-private sap.ui.mdc
-				 */
-				_endOrder: {
-					type: "string[]",
-					defaultValue: [],
-					visibility: "hidden"
 				}
 			},
 			aggregations: {
@@ -97,6 +86,15 @@ sap.ui.define([
 				end: {
 					type: "sap.ui.core.Control",
 					multiple: true
+				},
+
+				/**
+				 * Actions that are combined with the <code>end</code> aggregation according to the <code>position</code> information provided via the {@link sap.ui.mdc.IActionLayoutData IActionLayoutData} interface as <code>layoutData</code>.
+				 * @since 1.143
+				 */
+				controlActions: {
+					type: "sap.ui.core.Control",
+					multiple: true
 				}
 			}
 		},
@@ -107,7 +105,8 @@ sap.ui.define([
 		"begin",
 		"between",
 		"actions",
-		"end"
+		"end",
+		"controlActions"
 	];
 
 	const fnGetOverflowToolbarConfig = function() {
@@ -121,6 +120,40 @@ sap.ui.define([
 		return oConfig;
 	};
 
+	const fnGetGroupNameOfAction = (oAction) => {
+		const oLayoutData = oAction.getLayoutData();
+		if (oLayoutData?.isA("sap.ui.mdc.IActionLayoutData")) {
+			const sPosition = oLayoutData.getPosition();
+			return `${sPosition}`.split("Actions")[0];
+		}
+	};
+
+	const fnActionsSorter = (oAction1, oAction2) => {
+		const oLayoutData1 = oAction1.getLayoutData();
+		const oLayoutData2 = oAction2.getLayoutData();
+		const bAction1ImplementsIActionLayoutData = oLayoutData1?.isA("sap.ui.mdc.IActionLayoutData");
+		const bAction2ImplementsIActionLayoutData = oLayoutData2?.isA("sap.ui.mdc.IActionLayoutData");
+
+		if (!bAction1ImplementsIActionLayoutData && !bAction2ImplementsIActionLayoutData) {
+			return 0; // No layout data, so no sorting
+		}
+		if (bAction1ImplementsIActionLayoutData && !bAction2ImplementsIActionLayoutData) {
+			return -1; // Action 1 implements IActionLayoutData, so it should come first
+		}
+		if (!bAction1ImplementsIActionLayoutData && bAction2ImplementsIActionLayoutData) {
+			return 1; // Action 2 implements IActionLayoutData, so it should come first
+		}
+
+		const mPositionEnum1 = oLayoutData1.getMetadata().getProperty("position").getType().getEnumValues();
+		const mPositionEnum2 = oLayoutData2.getMetadata().getProperty("position").getType().getEnumValues();
+		const iPosition1 = Object.getOwnPropertyNames(mPositionEnum1).indexOf(oLayoutData1.getPosition());
+		const iPosition2 = Object.getOwnPropertyNames(mPositionEnum2).indexOf(oLayoutData2.getPosition());
+
+		return iPosition1 - iPosition2;
+	};
+
+	ActionToolbar.ShowGroupSeparators = window.location.search.includes("sap-ui-action-toolbar-separators");
+
 	ActionToolbar.prototype.init = function() {
 		OverflowToolbar.prototype.init.apply(this, arguments);
 		// Separator between begin (title) and between (variant) content of the toolbar.
@@ -166,23 +199,11 @@ sap.ui.define([
 		}
 	};
 
-	ActionToolbar.prototype.setProperty = function(sProperty) {
-		if (sProperty === "_endOrder") {
-			this._bEnforceEndOrder = true;
-		}
-
-		return OverflowToolbar.prototype.setProperty.apply(this, arguments);
-	};
-
 	ActionToolbar.prototype.addAggregation = function(sAggregationName, oControl) {
 		if (sAggregationName === "content") {
 			throw new Error("Mutator functions of the content aggregation of the ActionToolbar '" + this.getId() + "' must not be used.");
 		}
 
-		if (sAggregationName === "end") {
-			this._bEnforceEndOrder = true;
-		}
-
 		const aArguments = arguments;
 		if (aAggregations.includes(sAggregationName)) {
 			this._registerControlListener(oControl);
@@ -226,10 +247,6 @@ sap.ui.define([
 			throw new Error("Mutator functions of the content aggregation of the ActionToolbar '" + this.getId() + "' must not be used.");
 		}
 
-		if (sAggregationName === "end") {
-			this._bEnforceEndOrder = true;
-		}
-
 		if (aAggregations.includes(sAggregationName)) {
 			this._registerControlListener(oControl);
 			this._resetAndInvalidateToolbar(false);
@@ -306,29 +323,6 @@ sap.ui.define([
 		});
 	};
 
-	ActionToolbar.prototype.onBeforeRendering = function() {
-		OverflowToolbar.prototype.onBeforeRendering.apply(this, arguments);
-
-		if (this._bEnforceEndOrder) {
-
-			this.getProperty("_endOrder").reduce((iOrder, sElementId) => {
-				const oElement = Element.getElementById(sElementId);
-				if (!oElement) {
-					return iOrder;
-				}
-
-				const iIndex = this.indexOfEnd(oElement);
-				if (iIndex != iOrder) {
-					this.insertEnd(this.removeEnd(oElement), iOrder);
-				}
-
-				return iOrder + 1;
-			}, 0);
-
-			this._bEnforceEndOrder = false;
-		}
-	};
-
 	// According to visual designs currently no separator between actions and end content, only title separator is handled below
 	/* Begin Title Separator handling */
 	ActionToolbar.prototype.onAfterRendering = function() {
@@ -387,6 +381,34 @@ sap.ui.define([
 		}
 	};
 
+	ActionToolbar.prototype._getGroupSeparator = function(sGroupName) {
+		const sSeparatorId = `${this.getId()}-${sGroupName}-separator`;
+		let oSeparator = Element.getElementById(sSeparatorId);
+		if (!oSeparator) {
+			oSeparator = new ToolbarSeparator(sSeparatorId);
+			this.addDependent(oSeparator);
+		}
+		return oSeparator;
+	};
+
+	ActionToolbar.prototype._insertGroupSeparators = function(aActions) {
+		const aVisibleActions = aActions.filter((oAction) => oAction.getVisible());
+		aVisibleActions.forEach((oVisibleAction, iVisibleIndex) => {
+			const oNextVisibleAction = aVisibleActions[iVisibleIndex + 1];
+			if (!oNextVisibleAction) {
+				return;
+			}
+
+			const sGroupNameOfVisibleAction = fnGetGroupNameOfAction(oVisibleAction);
+			const sGroupNameOfNextVisibleAction = fnGetGroupNameOfAction(oNextVisibleAction);
+			if (sGroupNameOfVisibleAction !== sGroupNameOfNextVisibleAction) {
+				const oSeparator = this._getGroupSeparator(sGroupNameOfVisibleAction);
+				const iActualIndexOfVisibleAction = aActions.indexOf(oVisibleAction);
+				aActions.splice(iActualIndexOfVisibleAction + 1, 0, oSeparator);
+			}
+		});
+	};
+
 	/*
 	 * Overwrite generated functions to use internal array to look for aggregation
 	 */
@@ -396,17 +418,21 @@ sap.ui.define([
 
 	// Overwrite content aggregation functions
 	ActionToolbar.prototype.getContent = function() {
-		let aContent = this.getBegin();
-		aContent.push(this._oBeginSeparator);
-		aContent = aContent.concat(this.getBetween());
-		aContent.push(this._oSpacer);
-		aContent = aContent.concat(this.getEndActionsBegin());
-		aContent.push(this._oEndActionsBeginSeparator);
-		aContent = aContent.concat(this.getEnd());
-		aContent.push(this._oEndActionsEndSeparator);
-		aContent = aContent.concat(this.getEndActionsEnd());
-
-		return aContent;
+		const aEndAndControlActions = [...this.getEnd(), ...this.getControlActions()];
+		const aSortedEndAndControlActions = aEndAndControlActions.sort(fnActionsSorter);
+		ActionToolbar.ShowGroupSeparators && this._insertGroupSeparators(aSortedEndAndControlActions);
+
+		return [
+			...this.getBegin(),
+			this._oBeginSeparator,
+			...this.getBetween(),
+			this._oSpacer,
+			...this.getEndActionsBegin(),
+			this._oEndActionsBeginSeparator,
+			...aSortedEndAndControlActions,
+			this._oEndActionsEndSeparator,
+			...this.getEndActionsEnd()
+		];
 	};
 
 	ActionToolbar.prototype.getCurrentState = function() {

package/src/sap/ui/mdc/Chart.js

@@ -79,7 +79,7 @@ sap.ui.define([
 		 * @extends sap.ui.mdc.Control
 		 * @borrows sap.ui.mdc.mixin.FilterIntegrationMixin.rebind as #rebind
 		 * @author SAP SE
-		 * @version 1.141.2
+		 * @version 1.143.0
 		 * @constructor
 		 *
 		 * @public

package/src/sap/ui/mdc/Control.js

@@ -23,7 +23,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 * @abstract
 	 * @author SAP SE
-	 * @version 1.141.2
+	 * @version 1.143.0
 	 * @alias sap.ui.mdc.Control
 	 *
 	 * @borrows sap.ui.mdc.mixin.DelegateMixin.awaitControlDelegate as #awaitControlDelegate

package/src/sap/ui/mdc/DefaultTypeMap.js

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.141.2
+	 * @version 1.143.0
 	 * @public
 	 * @since 1.114.0
 	 * @namespace

package/src/sap/ui/mdc/Element.js

@@ -23,7 +23,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Element
 	 * @abstract
 	 * @author SAP SE
-	 * @version 1.141.2
+	 * @version 1.143.0
 	 * @alias sap.ui.mdc.Element
 	 *
 	 * @borrows sap.ui.mdc.mixin.DelegateMixin.awaitControlDelegate as #awaitControlDelegate

package/src/sap/ui/mdc/Field.js

@@ -50,10 +50,10 @@ sap.ui.define([
 	 *
 	 * <ul>
 	 * <li>In display mode, usually a {@link sap.m.Text Text} control is rendered.</li>
-	 * <li>If <code>multipleLines</code> is set, an {@link sap.m.ExpandableText ExpandableText} control is rendered.</li>
-	 * <li>If <code>fieldInfo</code> is set and it is configured to be triggerable, a {@link sap.m.Link Link} control is rendered. The <code>multipleLines</code> property is forwarded to the <code>wrapping</code> property of the {@link sap.m.Link Link} control.</li>
+	 * <li>If {@link sap.ui.mdc.field.FieldBase#getMultipleLines multipleLines} is set, an {@link sap.m.ExpandableText ExpandableText} control is rendered.</li>
+	 * <li>If {@link sap.ui.mdc.field.FieldBase#getFieldInfo fieldInfo} is set and it is configured to be triggerable, a {@link sap.m.Link Link} control is rendered. The {@link sap.ui.mdc.field.FieldBase#getMultipleLines multipleLines} property is forwarded to the {@link sap.m.Link#setWrapping wrapping} property of the {@link sap.m.Link Link} control.</li>
 	 * <li>In edit mode, usually an {@link sap.m.Input Input} control is rendered.</li>
-	 * <li>If <code>multipleLines</code> is set, a {@link sap.m.TextArea TextArea} control is rendered.</li>
+	 * <li>If {@link sap.ui.mdc.field.FieldBase#getMultipleLines multipleLines} is set, a {@link sap.m.TextArea TextArea} control is rendered.</li>
 	 * <li>If a date type is used, a {@link sap.m.DatePicker DatePicker} control is rendered.</li>
 	 * <li>If a date/time type is used, a {@link sap.m.DateTimePicker DateTimePicker} control is rendered.</li>
 	 * <li>If a time type is used, a {@link sap.m.TimePicker TimePicker} control is rendered.</li>
@@ -64,13 +64,13 @@ sap.ui.define([
 	 * @implements sap.ui.core.IFormContent, sap.ui.core.ISemanticFormContent, sap.m.IOverflowToolbarContent
 	 *
 	 * @author SAP SE
-	 * @version 1.141.2
+	 * @version 1.143.0
 	 *
 	 * @constructor
 	 * @alias sap.ui.mdc.Field
 	 * @see {@link topic:1dd2aa91115d43409452a271d11be95b sap.ui.mdc}
 	 * @see {@link topic:5260b9ca249f465ab33769b9edb442aa Field Building Block (OData V4)}
-	 * @version 1.141.2
+	 * @version 1.143.0
 	 * @since 1.54.0
 	 * @public
 	 */
@@ -84,6 +84,9 @@ sap.ui.define([
 				 *
 				 * To display the key and the description in one field,
 				 * the key must be set on the <code>value</code> property.
+				 *
+				 * <b>Warning:</b> Don't use a <code>Formatter</code> in the binding of this property since this only allows one-way binding.
+				 * Therefore, no parsing of user input and no model updates are possible.
 				 */
 				value: {
 					type: "any",
@@ -96,6 +99,9 @@ sap.ui.define([
 				 *
 				 * To display the key and the description in one field,
 				 * the description must be set on the <code>additionalValue</code> property.
+				 *
+				 * <b>Warning:</b> Don't use a <code>Formatter</code> in the binding of this property since this only allows one-way binding.
+				 * Therefore, no parsing of user input and no model updates are possible.
 				 */
 				additionalValue: {
 					type: "any",
@@ -105,7 +111,7 @@ sap.ui.define([
 			},
 			events: {
 				/**
-				 * This event is fired when the <code>value</code> property of the field is changed by user interaction.
+				 * This event is fired when the {@link #getValue value} property of the field is changed by user interaction.
 				 *
 				 * <b>Note</b> This event is only triggered if the used content control has a change event.
 				 */
@@ -115,7 +121,7 @@ sap.ui.define([
 						/**
 						 * The new value of the <code>Field</code>.
 						 *
-						 * If a <code>ValueHelp</code> is assigned to the <code>Field</code>, the <code>value</code> is used as key for the <code>ValueHelp</code> items.
+						 * If a {@link sap.ui.mdc.field.FieldBase#getValueHelp ValueHelp} is assigned to the <code>Field</code>, the <code>value</code> is used as key for the {@link sap.ui.mdc.field.FieldBase#getValueHelp ValueHelp} items.
 						 */
 						value: { type: "string" },
 
@@ -239,6 +245,8 @@ sap.ui.define([
 				this.getContentFactory().updateConditionType();
 				this.invalidate(); // as new inner control might be needed
 			}
+		} else if (oBindingInfo.formatter && (sName === "value" || sName === "additionalValue")) { // a formatter is used -> not really supported (no parsing, no model update....)
+			Log.error("Binding for property '" + sName + " uses Formatter, this is not fully supported. Field: " + this);
 		}
 
 		FieldBase.prototype.bindProperty.apply(this, arguments);
@@ -726,6 +734,21 @@ sap.ui.define([
 
 	};
 
+	Field.prototype.shouldFireValidationSuccessOnConditionUpdate = function (aConditions) {
+
+		const vOldValue = this.getValue();
+		let vValue = this.getResultForChangePromise(aConditions);
+		vValue = _updateEmptyValue.call(this, vValue, vOldValue);
+
+		if (_compareValues.call(this, vValue, vOldValue, true)) {
+			// value will not be updated, therefore ValidationSuccess need to be fired manually
+			return true;
+		}
+
+		return false;
+
+	};
+
 	const HANDLEDBYMIXIN = Symbol("sap.ui.core.message.MessageMixin");
 	Field.prototype.refreshDataState = function (sName, oDataState) {
 
@@ -768,7 +791,7 @@ sap.ui.define([
 				// map message to inner control, if needed
 				const oBinding = this.getBinding("value"); // only check value binding
 				let sControlId = this.getId();
-				if (oBinding.isA("sap.ui.model.CompositeBinding") && this.getContentFactory().isMeasure()) {
+				if (oBinding?.isA("sap.ui.model.CompositeBinding") && this.getContentFactory().isMeasure()) {
 					const aContent = this.getCurrentContent();
 					if (aContent.length > 0) {
 						if (oMessage.getMessageProcessor().isA("sap.ui.model.Model")) {

package/src/sap/ui/mdc/FilterBar.js

@@ -42,7 +42,7 @@ sap.ui.define([
 	 * The metadata information is provided via the {@link module:sap/ui/mdc/FilterBarDelegate FilterBarDelegate} implementation. This implementation has to be provided by the application.
 	 * @extends sap.ui.mdc.filterbar.FilterBarBase
 	 * @author SAP SE
-	 * @version 1.141.2
+	 * @version 1.143.0
 	 * @constructor
 	 * @public
 	 * @since 1.61.0

package/src/sap/ui/mdc/FilterField.js

@@ -29,18 +29,18 @@ sap.ui.define([
 	 * @class
 	 * The <code>FilterField</code> control is used to filter data based on the conditions. The conditions are managed
 	 * in the corresponding {@link sap.ui.mdc.FilterBar FilterBar}.
-	 * That is why the <code>conditions</code> property must be bound to the related conditions in the {@link sap.ui.mdc.FilterBar FilterBar}.
-	 * The type of this data must be defined in the <code>dataType</code> property.
+	 * That is why the {@link sap.ui.mdc.field.FieldBase#bindConditions conditions} property must be bound to the related conditions in the {@link sap.ui.mdc.FilterBar FilterBar}.
+	 * The type of this data must be defined in the {@link sap.ui.mdc.field.FieldBase#setDataType dataType} property.
 	 *
 	 * Based on the data type settings, a default control is rendered by the <code>FilterField</code> as follows:
 	 *
 	 * <ul>
 	 * <li>In display mode, usually a {@link sap.m.Text Text} control is rendered.</li>
-	 * <li>If <code>multipleLines</code> is set, an {@link sap.m.ExpandableText ExpandableText} control is rendered.</li>
+	 * <li>If {@link sap.ui.mdc.field.FieldBase#getMultipleLines multipleLines} is set, an {@link sap.m.ExpandableText ExpandableText} control is rendered.</li>
 	 * <li>If multiple values are allowed, a {@link sap.m.Tokenizer Tokenizer} control is rendered.</li>
 	 * <li>In edit mode, usually an {@link sap.m.Input Input} control is rendered.</li>
 	 * <li>If multiple values are allowed, a {@link sap.m.MultiInput MultiInput} control is rendered.</li>
-	 * <li>If <code>multipleLines</code> is set, a {@link sap.m.TextArea TextArea} control is rendered.</li>
+	 * <li>If {@link sap.ui.mdc.field.FieldBase#getMultipleLines multipleLines} is set, a {@link sap.m.TextArea TextArea} control is rendered.</li>
 	 * <li>If a date type or a date/time type is used and only one condition is supported, a {@link sap.m.DynamicDateRange DynamicDateRange} control is rendered.</li>
 	 * <li>If a date type is used and only single values are allowed, a {@link sap.m.DatePicker DatePicker} control is rendered.</li>
 	 * <li>If a date type is used and only single ranges are allowed, a {@link sap.m.DateRangeSelection DateRangeSelection} control is rendered.</li>
@@ -53,13 +53,13 @@ sap.ui.define([
 	 * @implements sap.ui.core.IFormContent, sap.ui.core.ISemanticFormContent, sap.m.IOverflowToolbarContent
 	 *
 	 * @author SAP SE
-	 * @version 1.141.2
+	 * @version 1.143.0
 	 *
 	 * @constructor
 	 * @alias sap.ui.mdc.FilterField
 	 * @see {@link topic:1dd2aa91115d43409452a271d11be95b sap.ui.mdc}
 	 * @see {@link topic:2df783760a8e4540ad19ce5ec3ed91c8 FilterField Building Block (OData V4)}
-	 * @version 1.141.2
+	 * @version 1.143.0
 	 * @since 1.48.0
 	 * @public
 	 */
@@ -88,7 +88,7 @@ sap.ui.define([
 				 * Default operator name for conditions.
 				 * If empty, the relevant default operator depending on the data type used is taken.
 				 *
-				 * <b>Note</b>: <code>defaultOperator</code> can be the name of an {@link sap.ui.mdc.condition.Operator Operator} or the instance itself.
+				 * <b>Note:</b> <code>defaultOperator</code> can be the name of an {@link sap.ui.mdc.condition.Operator Operator} or the instance itself.
 				 *
 				 * @since 1.88.0
 				 */
@@ -123,7 +123,7 @@ sap.ui.define([
 			},
 			events: {
 				/**
-				 * This event is fired when the <code>conditions</code> property of the <code>FilterField</code> is changed by a user interaction.
+				 * This event is fired when the {@link sap.ui.mdc.field.FieldBase#getConditions conditions} property of the <code>FilterField</code> is changed by a user interaction.
 				 *
 				 * <b>Note</b> This event is only triggered if the used content control has a change event.
 				 */
@@ -296,7 +296,7 @@ sap.ui.define([
 	/**
 	 * Adds an operator to the list of known operators.
 	 *
-	 * <b>Note</b>: If no operator is set, the used <code>datatType</code> of the <code>FilterField</code> defines the set of default operators.
+	 * <b>Note:</b> If no operator is set, the used {@link sap.ui.mdc.field.FieldBase#getDataType dataType} of the <code>FilterField</code> defines the set of default operators.
 	 * The standard operators are mentioned in {@link sap.ui.mdc.enums.OperatorName OperatorName}.
 	 *
 	 * @param {sap.ui.mdc.condition.Operator|string} vOperator The operator instance or operator name
@@ -323,7 +323,7 @@ sap.ui.define([
 	/**
 	 * Adds an array of operators to the list of known operators.
 	 *
-	 * <b>Note</b>: <code>aOperators</code> can be the name of an {@link sap.ui.mdc.condition.Operator Operator}, the instance itself, or multiple operators inside an array.
+	 * <b>Note:</b> <code>aOperators</code> can be the name of an {@link sap.ui.mdc.condition.Operator Operator}, the instance itself, or multiple operators inside an array.
 	 * The standard operators are mentioned in {@link sap.ui.mdc.enums.OperatorName OperatorName}.
 	 *
 	 * @param {sap.ui.mdc.condition.Operator[]} aOperators Array of operators
@@ -369,7 +369,7 @@ sap.ui.define([
 	/**
 	 * Removes all given operators from the list of known operators.
 	 *
-	 * <b>Note</b>: <code>aOperators</code> can be the name of an {@link sap.ui.mdc.condition.Operator Operator}, the instance itself, or multiple operators inside an array.
+	 * <b>Note:</b> <code>aOperators</code> can be the name of an {@link sap.ui.mdc.condition.Operator Operator}, the instance itself, or multiple operators inside an array.
 	 * The standard operators are mentioned in {@link sap.ui.mdc.enums.OperatorName OperatorName}.
 	 *
 	 * @param {sap.ui.mdc.condition.Operator[]} aOperators Array of operators