@openui5/sap.ui.core 1.130.1 → 1.131.0

package/src/sap/ui/core/LayoutData.js

@@ -23,7 +23,7 @@ sap.ui.define(['./Element', "sap/ui/thirdparty/jquery", './library'],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.LayoutData

package/src/sap/ui/core/ListItem.js

@@ -23,7 +23,7 @@ sap.ui.define(['./Item', './library'],
 	 * @extends sap.ui.core.Item
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.ListItem

package/src/sap/ui/core/LocalBusyIndicator.js

@@ -32,7 +32,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @public
 	 * @since 1.11.0

package/src/sap/ui/core/Locale.js

@@ -20,7 +20,7 @@ sap.ui.define(['sap/base/assert', 'sap/ui/base/Object', "sap/base/i18n/Localizat
 	 *
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 * @public
 	 * @alias sap.ui.core.Locale
 	 */

package/src/sap/ui/core/LocaleData.js

@@ -78,7 +78,7 @@ sap.ui.define([
 	 *   {@link https://cldr.unicode.org/ Unicode CLDR}.
 	 * @hideconstructor
 	 * @public
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 */
 	var LocaleData = BaseObject.extend("sap.ui.core.LocaleData", /** @lends sap.ui.core.LocaleData.prototype */ {
 
@@ -2818,7 +2818,7 @@ sap.ui.define([
 	/**
 	 * Creates an instance of <code>LocaleData</code> for the given locale.
 	 *
-	 * @param {sap.ui.core.Locale|sap.base.i18n.LanguageTag} vLocale The locale or language tag
+	 * @param {sap.ui.core.Locale|module:sap/base/i18n/LanguageTag} vLocale The locale or language tag
 	 * @returns {sap.ui.core.LocaleData} An instance of <code>LocaleData</code>
 	 *
 	 * @public
@@ -2832,7 +2832,7 @@ sap.ui.define([
 	/**
 	 * Creates an instance of <code>LocaleData</code> asynchronously for the given language tag.
 	 *
-	 * @param {sap.base.i18n.LanguageTag} oLanguageTag
+	 * @param {module:sap/base/i18n/LanguageTag} oLanguageTag
 	 *   The language tag
 	 * @returns {Promise<sap.ui.core.LocaleData>}
 	 *   A <code>Promise</code> which resolves with an instance of <code>LocaleData</code>; the <code>Promise</code>

package/src/sap/ui/core/Manifest.js

@@ -165,7 +165,7 @@ sap.ui.define([
 	 * @class The Manifest class.
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 * @alias sap.ui.core.Manifest
 	 * @since 1.33.0
 	 */
@@ -445,7 +445,7 @@ sap.ui.define([
 
 			/**
 			 * Load JS files.
-			 * @eprecated As of version 1.94, standard dependencies should be used instead.
+			 * @deprecated As of version 1.94, standard dependencies should be used instead.
 			 */
 			if (mResources["js"]) {
 				var aJSResources = mResources["js"];

package/src/sap/ui/core/Message.js

@@ -26,7 +26,7 @@ sap.ui.define(['./Element', './library', "./Theming", "sap/base/Log"],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.Message

package/src/sap/ui/core/Popup.js

@@ -2800,6 +2800,12 @@ sap.ui.define([
 				FocusHandler.removeFocusInfoExtender(this._extendFocusInfo, this);
 			}
 
+			// remove custom css classes if available
+			const aCurrentCustomClasses = this._sModalCSSClass?.split(" ") ?? [];
+			aCurrentCustomClasses.forEach((sModalCSSClass) => {
+				oBlockLayerDomRef.classList.remove(sModalCSSClass);
+			});
+
 			// if there are more z-indices this means there are more dialogs stacked
 			// up. So redisplay the block layer (with new z-index) under the new
 			// current dialog which should be displayed.
@@ -2811,6 +2817,12 @@ sap.ui.define([
 				// set the block layer z-index to the last z-index in the stack and show it
 				oBlockLayerDomRef.style.zIndex = oLastPopupInfo.zIndex;
 
+				// restore custom css classes if available
+				const aModalCSSClasses = oLastPopupInfo.popup._sModalCSSClass?.split(" ") ?? [];
+				aModalCSSClasses.forEach((sModalCSSClass) => {
+					oBlockLayerDomRef.classList.add(sModalCSSClass);
+				});
+
 				oBlockLayerDomRef.style.visibility = "visible";
 				oBlockLayerDomRef.style.display = "block";
 

package/src/sap/ui/core/RenderManager.js

@@ -241,7 +241,7 @@ sap.ui.define([
 	 *
 	 * @extends Object
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 * @alias sap.ui.core.RenderManager
 	 * @hideconstructor
 	 * @public
@@ -1987,6 +1987,9 @@ sap.ui.define([
 					};
 				}
 			);
+			/**
+			 * @deprecated As of version 1.120
+			 */
 			IconPool = sap.ui.requireSync("sap/ui/core/IconPool"); // legacy-relevant: Sync fallback
 		}
 

package/src/sap/ui/core/Renderer.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @classdesc Base Class for a Renderer.
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 * @namespace
 	 * @public
 	 * @alias sap.ui.core.Renderer

package/src/sap/ui/core/ResizeHandler.js

@@ -36,7 +36,7 @@ sap.ui.define([
 	 * @alias sap.ui.core.ResizeHandler
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 * @public
 	 */
 

package/src/sap/ui/core/ScrollBar.js

@@ -44,7 +44,7 @@ sap.ui.define([
 	 * The ScrollBar control can be used for virtual scrolling of a certain area.
 	 * This means: to simulate a very large scrollable area when technically the area is small and the control takes care of displaying the respective part only. E.g. a Table control can take care of only rendering the currently visible rows and use this ScrollBar control to make the user think he actually scrolls through a long list.
 	 * @extends sap.ui.core.Control
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @public
 	 * @deprecated As of version 1.56, the concept has been discarded.

package/src/sap/ui/core/SeparatorItem.js

@@ -23,7 +23,7 @@ sap.ui.define(['./Item', './library'],
 	 * @extends sap.ui.core.Item
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.SeparatorItem

package/src/sap/ui/core/Title.js

@@ -25,7 +25,7 @@ sap.ui.define(['./Element', './library'],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @public
 	 * @since 1.16.0

package/src/sap/ui/core/TooltipBase.js

@@ -32,7 +32,7 @@ sap.ui.define([
 	 * @class
 	 * Abstract class that can be extended in order to implement any extended tooltip. For example, RichTooltip Control is based on it. It provides the opening/closing behavior and the main "text" property.
 	 * @extends sap.ui.core.Control
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.TooltipBase

package/src/sap/ui/core/UIArea.js

@@ -170,7 +170,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 * @param {object} [oRootNode] reference to the DOM element that should be 'hosting' the UI Area.
 	 * @public
 	 * @alias sap.ui.core.UIArea

package/src/sap/ui/core/UIComponent.js

@@ -59,7 +59,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Component
 	 * @abstract
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 * @alias sap.ui.core.UIComponent
 	 * @since 1.9.2
 	 */

package/src/sap/ui/core/UIComponentMetadata.js

@@ -18,7 +18,7 @@ sap.ui.define(['./ComponentMetadata', 'sap/ui/core/mvc/ViewType'],
 	 * @experimental Since 1.15.1. The Component concept is still under construction, so some implementation details can be changed in future.
 	 * @class
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 * @since 1.15.1
 	 * @alias sap.ui.core.UIComponentMetadata
 	 * @extends sap.ui.core.ComponentMetadata

package/src/sap/ui/core/ValueStateSupport.js

@@ -16,7 +16,7 @@ sap.ui.define(['./Element', './library', './Lib', "sap/base/assert"],
 		 * Helper functionality for value state support.
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 * @public
 		 * @namespace sap.ui.core.ValueStateSupport
 		 */

package/src/sap/ui/core/VariantLayoutData.js

@@ -20,7 +20,7 @@ sap.ui.define(['./LayoutData', './library'],
 	 * @class
 	 * Allows to add multiple LayoutData to one control in case that an easy switch of layouts (e.g. in a Form) is needed.
 	 * @extends sap.ui.core.LayoutData
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @public
 	 * @since 1.9.2

package/src/sap/ui/core/XMLComposite.js

@@ -148,7 +148,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 * @since 1.56.0
 		 * @alias sap.ui.core.XMLComposite
 		 * @see {@link topic:b83a4dcb7d0e46969027345b8d32fd44 XML Composite Controls}

package/src/sap/ui/core/XMLCompositeMetadata.js

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * @param {object} oClassInfo static info to construct the metadata from
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 * @since 1.50.0
 	 * @alias sap.ui.core.XMLCompositeMetadata
 	 * @extends sap.ui.core.ElementMetadata

package/src/sap/ui/core/_IconRegistry.js

@@ -739,6 +739,7 @@ sap.ui.define([
 				'da-2': 0x1e2a4,
 				'ai': 0x1e2a5,
 				'in-progress-2': 0x1e2a6,
+				'unsynchronize': 0x1e2a7,
 				'gender-male-and-female': 0x1e300,
 				'rotate': 0xe301,
 				'locate-me-2': 0xe302,

package/src/sap/ui/core/cldr/ca.json

@@ -5976,7 +5976,7 @@
 		}
 	},
 	"sap-calendarWeek": {
-		"narrow": "Setmana natural {0}",
+		"narrow": "SN {0}",
 		"wide": "Setmana natural {0}"
 	}
 }

package/src/sap/ui/core/cldr/cs.json

@@ -6274,6 +6274,6 @@
 	},
 	"sap-calendarWeek": {
 		"narrow": "KT {0}",
-		"wide": "Kalendářní týdny{0}"
+		"wide": "Kalendářní týden {0}"
 	}
 }

package/src/sap/ui/core/cldr/es.json

@@ -5996,7 +5996,7 @@
 		}
 	},
 	"sap-calendarWeek": {
-		"narrow": "SC {0}",
-		"wide": "Semana de calendario {0}"
+		"narrow": "SN {0}",
+		"wide": "Semana natural {0}"
 	}
 }

package/src/sap/ui/core/cldr/es_AR.json

@@ -6003,7 +6003,7 @@
 		}
 	},
 	"sap-calendarWeek": {
-		"narrow": "SC {0}",
-		"wide": "Semana de calendario {0}"
+		"narrow": "SN {0}",
+		"wide": "Semana natural {0}"
 	}
 }

package/src/sap/ui/core/cldr/es_BO.json

@@ -6001,7 +6001,7 @@
 		}
 	},
 	"sap-calendarWeek": {
-		"narrow": "SC {0}",
-		"wide": "Semana de calendario {0}"
+		"narrow": "SN {0}",
+		"wide": "Semana natural {0}"
 	}
 }

package/src/sap/ui/core/cldr/es_CL.json

@@ -5894,7 +5894,7 @@
 		}
 	},
 	"sap-calendarWeek": {
-		"narrow": "SC {0}",
-		"wide": "Semana de calendario {0}"
+		"narrow": "SN {0}",
+		"wide": "Semana natural {0}"
 	}
 }

package/src/sap/ui/core/cldr/es_CO.json

@@ -5894,7 +5894,7 @@
 		}
 	},
 	"sap-calendarWeek": {
-		"narrow": "SC {0}",
-		"wide": "Semana de calendario {0}"
+		"narrow": "SN {0}",
+		"wide": "Semana natural {0}"
 	}
 }

package/src/sap/ui/core/cldr/es_PE.json

@@ -5785,7 +5785,7 @@
 		}
 	},
 	"sap-calendarWeek": {
-		"narrow": "SC {0}",
-		"wide": "Semana de calendario {0}"
+		"narrow": "SN {0}",
+		"wide": "Semana natural {0}"
 	}
 }

package/src/sap/ui/core/cldr/es_UY.json

@@ -5787,7 +5787,7 @@
 		}
 	},
 	"sap-calendarWeek": {
-		"narrow": "SC {0}",
-		"wide": "Semana de calendario {0}"
+		"narrow": "SN {0}",
+		"wide": "Semana natural {0}"
 	}
 }

package/src/sap/ui/core/cldr/es_VE.json

@@ -5786,7 +5786,7 @@
 		}
 	},
 	"sap-calendarWeek": {
-		"narrow": "SC {0}",
-		"wide": "Semana de calendario {0}"
+		"narrow": "SN {0}",
+		"wide": "Semana natural {0}"
 	}
 }

package/src/sap/ui/core/cldr/fi.json

@@ -6089,7 +6089,7 @@
 		}
 	},
 	"sap-calendarWeek": {
-		"narrow": "Vk {0}",
+		"narrow": "KV {0}",
 		"wide": "Kalenteriviikko {0}"
 	}
 }

package/src/sap/ui/core/cldr/hu.json

@@ -5850,6 +5850,6 @@
 	},
 	"sap-calendarWeek": {
 		"narrow": "{0}. NH",
-		"wide": "{0}. naptári hét"
+		"wide": "Naptári hét {0}"
 	}
 }

package/src/sap/ui/core/cldr/id.json

@@ -5746,7 +5746,7 @@
 		"islamic-tbla"
 	],
 	"sap-calendarWeek": {
-		"narrow": "CW {0}",
-		"wide": "Minggu Kalender {0}"
+		"narrow": "KM {0}",
+		"wide": "Kalender Minggu {0}"
 	}
 }

package/src/sap/ui/core/cldr/mk.json

@@ -5948,7 +5948,7 @@
 		}
 	},
 	"sap-calendarWeek": {
-		"narrow": "КС {0}",
-		"wide": "Календарска седмица {0}"
+		"narrow": "КН {0}",
+		"wide": "Календарска недела {0}"
 	}
 }

package/src/sap/ui/core/cldr/tr.json

@@ -6000,7 +6000,7 @@
 		"islamic-tbla"
 	],
 	"sap-calendarWeek": {
-		"narrow": "CW {0}",
+		"narrow": "TH {0}",
 		"wide": "Takvim haftası {0}"
 	}
 }

package/src/sap/ui/core/cldr/vi.json

@@ -5794,7 +5794,7 @@
 		}
 	},
 	"sap-calendarWeek": {
-		"narrow": "Lịch tuần {0}",
-		"wide": "Lịch tuần {0}"
+		"narrow": "Tuần theo lịch {0}",
+		"wide": "Tuần theo lịch {0}"
 	}
 }

package/src/sap/ui/core/date/CalendarWeekNumbering.js

@@ -25,7 +25,7 @@ sap.ui.define([
 	 * @enum {string}
 	 * @public
 	 * @since 1.108.0
-	 * @deprecated As of Version 1.120. Please use {@link module:sap/base/18n/date/CalendarWeekNumbering} instead.
+	 * @deprecated As of Version 1.120. Please use {@link module:sap/base/i18n/date/CalendarWeekNumbering} instead.
 	 * @name sap.ui.core.date.CalendarWeekNumbering
 	 * @borrows module:sap/base/i18n/date/CalendarWeekNumbering.Default as Default
 	 * @borrows module:sap/base/i18n/date/CalendarWeekNumbering.ISO_8601 as ISO_8601

package/src/sap/ui/core/date/UI5Date.js

@@ -66,7 +66,7 @@ sap.ui.define([
 	 * @hideconstructor
 	 * @public
 	 * @since 1.111.0
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 */
 	function UI5Date(vDateParts, sTimezoneID) {
 		var oDateInstance = UI5Date._createDateInstance(vDateParts);

package/src/sap/ui/core/delegate/ItemNavigation.js

@@ -82,7 +82,7 @@ sap.ui.define([
 	 * @param {Element[]} aItemDomRefs Array of DOM references representing the items for the navigation
 	 * @param {boolean} [bNotInTabChain=false] Whether the selected element should be in the tab chain or not
 	 *
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 * @alias sap.ui.core.delegate.ItemNavigation
 	 * @public
 	 */

package/src/sap/ui/core/delegate/ScrollEnablement.js

@@ -59,7 +59,7 @@ sap.ui.define([
 		 *
 		 * @protected
 		 * @alias sap.ui.core.delegate.ScrollEnablement
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 * @author SAP SE
 		 */
 		var ScrollEnablement = BaseObject.extend("sap.ui.core.delegate.ScrollEnablement", /** @lends sap.ui.core.delegate.ScrollEnablement.prototype */ {

package/src/sap/ui/core/dnd/DragDropBase.js

@@ -37,7 +37,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.core.Element
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @public
 	 * @since 1.52

package/src/sap/ui/core/dnd/DragDropInfo.js

@@ -22,7 +22,7 @@ sap.ui.define(["sap/ui/core/Element", "./DragInfo", "./DropInfo", "sap/base/Log"
 	 * @extends sap.ui.core.dnd.DropInfo
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @public
 	 * @since 1.52

package/src/sap/ui/core/dnd/DragInfo.js

@@ -22,7 +22,7 @@ sap.ui.define(["./DragDropBase"],
 	 * @extends sap.ui.core.dnd.DragDropBase
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @public
 	 * @since 1.56

package/src/sap/ui/core/dnd/DropInfo.js

@@ -21,7 +21,7 @@ sap.ui.define(["./DragDropBase"],
 	 * @extends sap.ui.core.dnd.DragDropBase
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @public
 	 * @since 1.56

package/src/sap/ui/core/fieldhelp/FieldHelpCustomData.js

@@ -31,7 +31,11 @@ sap.ui.define([
 	 * @ui5-restricted sap.ui.comp.filterbar, sap.fe.templates.ListReport
 	 * @alias sap.ui.core.fieldhelp.FieldHelpCustomData
 	 */
-	const FieldHelpCustomData = CustomData.extend("sap.ui.core.fieldhelp.FieldHelpCustomData");
+	const FieldHelpCustomData = CustomData.extend("sap.ui.core.fieldhelp.FieldHelpCustomData", {
+		metadata: {
+			library: "sap.ui.core"
+		}
+	});
 
 	FieldHelpCustomData.DOCUMENTATION_REF_KEY = "sap-ui-DocumentationRef";
 

package/src/sap/ui/core/format/FormatUtils.js

@@ -11,7 +11,7 @@ sap.ui.define([], function() {
 	 * Formatter related utility functions
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 * @namespace
 	 * @private
 	 */

package/src/sap/ui/core/format/NumberFormat.js

@@ -544,8 +544,12 @@ sap.ui.define([
 	 *   to "0.005".
 	 * @param {string} [oFormatOptions.pattern] CLDR number pattern which is used to format the number
 	 * @param {string} [oFormatOptions.plusSign] defines the used plus symbol
-	 * @param {int} [oFormatOptions.precision] defines the numerical precision; the number of decimals
-	 *   is calculated dependent on the integer digits
+	 * @param {int} [oFormatOptions.precision] The maximum number of digits in the formatted representation of a number;
+	 *   if the <code>precision</code> is less than the overall length of the number, its fractional part is truncated
+	 *   through rounding. As the <code>precision</code> only affects the rounding of a number, its integer part can
+	 *   retain more digits than defined by this parameter.
+	 *   <b>Example:</b> With a <code>precision</code> of 2, <code>234.567</code> is formatted to <code>235</code>.
+	 *   <b>Note:</b> The formatted output may differ depending on locale.
 	 * @param {boolean} [oFormatOptions.preserveDecimals=false] Whether {@link #format} preserves
 	 *   decimal digits except trailing zeros in case there are more decimals than the
 	 *   <code>maxFractionDigits</code> format option allows.
@@ -638,8 +642,15 @@ sap.ui.define([
 	 *   to "5000".
 	 * @param {string} [oFormatOptions.pattern] CLDR number pattern which is used to format the number
 	 * @param {string} [oFormatOptions.plusSign] defines the used plus symbol
-	 * @param {int} [oFormatOptions.precision] defines the numerical precision; the number of decimals
-	 *   is calculated dependent on the integer digits
+	 * @param {int} [oFormatOptions.precision] <b>Note:</b> Only considered if the number format leads to a
+	 *   representation with decimal places, e.g. if the option <code>style: "short"</code> is set.
+	 *   The maximum number of digits in the formatted representation of a number; if the <code>precision</code> is
+	 *   less than the overall length of the number, its fractional part is truncated through rounding.
+	 *   As the <code>precision</code> only affects the rounding of a number, its integer part can retain more digits
+	 *   than defined by this parameter.
+	 *   <b>Example:</b> With a <code>precision</code> of 2 and <code>style: "short"</code>,
+	 *   <code>234567</code> is formatted to <code>"235K"</code>.
+	 *   <b>Note:</b> The formatted output may differ depending on locale.
 	 * @param {boolean} [oFormatOptions.preserveDecimals=false] Whether {@link #format} preserves
 	 *   decimal digits except trailing zeros in case there are more decimals than the
 	 *   <code>maxFractionDigits</code> format option allows.
@@ -909,8 +920,13 @@ sap.ui.define([
 	 *   to "0.005".
 	 * @param {string} [oFormatOptions.pattern] CLDR number pattern which is used to format the number
 	 * @param {string} [oFormatOptions.plusSign] defines the used plus symbol
-	 * @param {int} [oFormatOptions.precision] defines the numerical precision; the number of decimals
-	 *   is calculated dependent on the integer digits
+	 * @param {int} [oFormatOptions.precision] The maximum number of digits in the formatted representation of a number;
+	 *   if the <code>precision</code> is less than the overall length of the number, its fractional part is truncated
+	 *   through rounding. As the <code>precision</code> only affects the rounding of a number, its integer part can
+	 *   retain more digits than defined by this parameter.
+	 *   <b>Example:</b> With a <code>precision</code> of 2, the parameters <code>"234.567", "mass-kilogram"</code> are
+	 *   formatted to <code>"235 kg"</code>.
+	 *   <b>Note:</b> The formatted output may differ depending on locale.
 	 * @param {boolean} [oFormatOptions.preserveDecimals=false] Whether {@link #format} preserves
 	 *   decimal digits except trailing zeros in case there are more decimals than the
 	 *   <code>maxFractionDigits</code> format option allows.
@@ -1008,8 +1024,13 @@ sap.ui.define([
 	 * @param {string} [oFormatOptions.pattern] CLDR number pattern which is used to format the number
 	 * @param {string} [oFormatOptions.percentSign] defines the used percent symbol
 	 * @param {string} [oFormatOptions.plusSign] defines the used plus symbol
-	 * @param {int} [oFormatOptions.precision] defines the numerical precision; the number of decimals
-	 *   is calculated dependent on the integer digits
+	 * @param {int} [oFormatOptions.precision] The maximum number of digits in the formatted representation of a number;
+	 *   if the <code>precision</code> is less than the overall length of the number, its fractional part is truncated
+	 *   through rounding. As the <code>precision</code> only affects the rounding of a number, its integer part
+	 *   can retain more digits than defined by this parameter.
+	 *   <b>Example:</b> With a <code>precision</code> of 2, <code>234.567</code> is formatted to
+	 *   <code>"23,457%"</code>.
+	 *   <b>Note:</b> The formatted output may differ depending on locale.
 	 * @param {boolean} [oFormatOptions.preserveDecimals=false] Whether {@link #format} preserves
 	 *   decimal digits except trailing zeros in case there are more decimals than the
 	 *   <code>maxFractionDigits</code> format option allows.