From ba41421ed1c15200aab32957909fc2974cbd7022 Mon Sep 17 00:00:00 2001 From: Andreas Kunz Date: Wed, 4 Mar 2026 09:57:21 +0100 Subject: [PATCH] =?UTF-8?q?=F0=9F=A4=96=20Merge=20PR=20#74626=20[openui5]?= =?UTF-8?q?=20Update=20the=20definition=20files=20for=20OpenUI5=201.145=20?= =?UTF-8?q?by=20@akudev?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- types/openui5/openui5-tests.ts | 2 + types/openui5/package.json | 2 +- types/openui5/sap.f.d.ts | 2 +- types/openui5/sap.m.d.ts | 41 ++- types/openui5/sap.tnt.d.ts | 30 +- types/openui5/sap.ui.codeeditor.d.ts | 2 +- types/openui5/sap.ui.commons.d.ts | 2 +- types/openui5/sap.ui.core.d.ts | 239 ++++++++------ types/openui5/sap.ui.dt.d.ts | 2 +- types/openui5/sap.ui.fl.d.ts | 6 +- types/openui5/sap.ui.integration.d.ts | 2 +- types/openui5/sap.ui.layout.d.ts | 2 +- types/openui5/sap.ui.mdc.d.ts | 428 ++++++++++++++++++++++--- types/openui5/sap.ui.rta.d.ts | 2 +- types/openui5/sap.ui.suite.d.ts | 2 +- types/openui5/sap.ui.support.d.ts | 2 +- types/openui5/sap.ui.table.d.ts | 8 +- types/openui5/sap.ui.testrecorder.d.ts | 2 +- types/openui5/sap.ui.unified.d.ts | 40 ++- types/openui5/sap.ui.ux3.d.ts | 2 +- types/openui5/sap.ui.webc.common.d.ts | 2 +- types/openui5/sap.ui.webc.fiori.d.ts | 2 +- types/openui5/sap.ui.webc.main.d.ts | 2 +- types/openui5/sap.uxap.d.ts | 26 +- 24 files changed, 652 insertions(+), 198 deletions(-) diff --git a/types/openui5/openui5-tests.ts b/types/openui5/openui5-tests.ts index 775d75f4f89c14..e9ed2c1980c046 100644 --- a/types/openui5/openui5-tests.ts +++ b/types/openui5/openui5-tests.ts @@ -288,3 +288,5 @@ const p13nEngine = new Engine(); // version 1.143.0 added - tests are not required as the type definitions are generated and the generator is sufficiently tested // version 1.144.0 added - tests are not required as the type definitions are generated and the generator is sufficiently tested + +// version 1.145.0 added - tests are not required as the type definitions are generated and the generator is sufficiently tested diff --git a/types/openui5/package.json b/types/openui5/package.json index 6d916a16e21f9b..c292d24fa5f6d3 100644 --- a/types/openui5/package.json +++ b/types/openui5/package.json @@ -1,7 +1,7 @@ { "private": true, "name": "@types/openui5", - "version": "1.144.9999", + "version": "1.145.9999", "nonNpm": true, "nonNpmDescription": "openui5", "projects": [ diff --git a/types/openui5/sap.f.d.ts b/types/openui5/sap.f.d.ts index ae9c11dc760df4..867536778f7bd7 100644 --- a/types/openui5/sap.f.d.ts +++ b/types/openui5/sap.f.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/tnt/library" { export interface IToolHeader { diff --git a/types/openui5/sap.m.d.ts b/types/openui5/sap.m.d.ts index 84a37ad2dab10c..6f7e0c2ac6a61d 100644 --- a/types/openui5/sap.m.d.ts +++ b/types/openui5/sap.m.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/f/library" { export interface IShellBar { @@ -3996,6 +3996,12 @@ declare module "sap/m/library" { * @since 1.54 */ export enum TimePickerMaskMode { + /** + * The mask will always be enforced for any time patterns. **Note:** The mask functions correctly only with + * fixed-length time formats. Using the `Enforce` value with time formats that do not have a fixed length + * may lead to unpredictable behavior. + */ + Enforce = "Enforce", /** * The mask is disabled for the `sap.m.TimePicker`. */ @@ -4539,6 +4545,20 @@ declare module "sap/m/library" { * @returns The enablement of the vertical scrolling enablement for the `sap.m.p13n.Popup`. */ getVerticalScrolling?(): boolean; + /** + * Optional hook that will be executed when the panel is used by a `sap.m.p13n.Popup` that is called before + * the popup is closed + * + * @since 1.145 + * + * @returns A Promise that is fullfilled if the panel is ready to be closed + */ + onBeforeClose?( + /** + * reason for closing the container + */ + sReason: string + ): Promise; /** * Optional hook that will be executed when the panel is used by a `sap.m.p13n.Popup` that may trigger a * reset on the panel @@ -14767,7 +14787,6 @@ declare module "sap/m/ColorPalette" { * The last selected color in the ColorPalette. * * @since 1.122 - * @experimental As of version 1.122. this property is in a beta state. * * @returns Value of property `selectedColor` */ @@ -14811,7 +14830,6 @@ declare module "sap/m/ColorPalette" { * When called with a value of `null` or `undefined`, the default value of the property will be restored. * * @since 1.122 - * @experimental As of version 1.122. this property is in a beta state. * * @returns Reference to `this` in order to allow method chaining */ @@ -14835,7 +14853,6 @@ declare module "sap/m/ColorPalette" { * The last selected color in the ColorPalette. * * @since 1.122 - * @experimental As of version 1.122. this property is in a beta state. */ selectedColor?: CSSColor | PropertyBindingInfo | `{${string}}`; @@ -15223,7 +15240,6 @@ declare module "sap/m/ColorPalettePopover" { * The last selected color in the ColorPalette. * * @since 1.122 - * @experimental As of version 1.122. this property is in a beta state. * * @returns Value of property `selectedColor` */ @@ -15356,7 +15372,6 @@ declare module "sap/m/ColorPalettePopover" { * When called with a value of `null` or `undefined`, the default value of the property will be restored. * * @since 1.122 - * @experimental As of version 1.122. this property is in a beta state. * * @returns Reference to `this` in order to allow method chaining */ @@ -15442,7 +15457,6 @@ declare module "sap/m/ColorPalettePopover" { * The last selected color in the ColorPalette. * * @since 1.122 - * @experimental As of version 1.122. this property is in a beta state. */ selectedColor?: CSSColor | PropertyBindingInfo | `{${string}}`; @@ -86235,7 +86249,7 @@ declare module "sap/m/Page" { * * The (optional) custom header of this page. Use this aggregation only when a custom header is constructed * where the default header consisting of title text + nav button is not sufficient. If this aggregation - * is set, the simple properties "title", "showNavButton", "NavButtonText" and "icon" are not used. + * is set, the simple properties "title", "showNavButton", "navButtonText" and "icon" are not used. */ getCustomHeader(): IBar; /** @@ -87062,7 +87076,7 @@ declare module "sap/m/Page" { /** * The (optional) custom header of this page. Use this aggregation only when a custom header is constructed * where the default header consisting of title text + nav button is not sufficient. If this aggregation - * is set, the simple properties "title", "showNavButton", "NavButtonText" and "icon" are not used. + * is set, the simple properties "title", "showNavButton", "navButtonText" and "icon" are not used. */ customHeader?: IBar; @@ -135965,7 +135979,8 @@ declare module "sap/m/StandardListItem" { /** * Gets current value of property {@link #getIcon icon}. * - * Defines the list item icon. + * Defines the list item icon. **Note:** The icon is decorative. For more advanced use cases and configuration + * options, use the `avatar` aggregation. * * * @returns Value of property `icon` @@ -136176,7 +136191,8 @@ declare module "sap/m/StandardListItem" { /** * Sets a new value for property {@link #getIcon icon}. * - * Defines the list item icon. + * Defines the list item icon. **Note:** The icon is decorative. For more advanced use cases and configuration + * options, use the `avatar` aggregation. * * When called with a value of `null` or `undefined`, the default value of the property will be restored. * @@ -136411,7 +136427,8 @@ declare module "sap/m/StandardListItem" { description?: string | PropertyBindingInfo; /** - * Defines the list item icon. + * Defines the list item icon. **Note:** The icon is decorative. For more advanced use cases and configuration + * options, use the `avatar` aggregation. */ icon?: URI | PropertyBindingInfo | `{${string}}`; diff --git a/types/openui5/sap.tnt.d.ts b/types/openui5/sap.tnt.d.ts index 0b2d886eee2f79..ca9afc2fe318c3 100644 --- a/types/openui5/sap.tnt.d.ts +++ b/types/openui5/sap.tnt.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/tnt/library" { /** @@ -1658,8 +1658,8 @@ declare module "sap/tnt/NavigationListItem" { /** * Gets current value of property {@link #getDesign design}. * - * Specifies if the item has a special design. NOTE: If `design` is not `NavigationListItemDesign.Default` - * sub-items can't be added. + * Specifies if the item has a special design. **Note:** If the `design` property is not set to `NavigationListItemDesign.Default`, + * sub-items cannot be added. * * Default value is `Default`. * @@ -1684,6 +1684,8 @@ declare module "sap/tnt/NavigationListItem" { * * Specifies the icon for the item. * + * **Note:** By design, icons on second-level (child) navigation items are not rendered. + * * Default value is `empty string`. * * @@ -1823,8 +1825,8 @@ declare module "sap/tnt/NavigationListItem" { /** * Sets a new value for property {@link #getDesign design}. * - * Specifies if the item has a special design. NOTE: If `design` is not `NavigationListItemDesign.Default` - * sub-items can't be added. + * Specifies if the item has a special design. **Note:** If the `design` property is not set to `NavigationListItemDesign.Default`, + * sub-items cannot be added. * * When called with a value of `null` or `undefined`, the default value of the property will be restored. * @@ -1863,6 +1865,8 @@ declare module "sap/tnt/NavigationListItem" { * * Specifies the icon for the item. * + * **Note:** By design, icons on second-level (child) navigation items are not rendered. + * * When called with a value of `null` or `undefined`, the default value of the property will be restored. * * Default value is `empty string`. @@ -1958,6 +1962,8 @@ declare module "sap/tnt/NavigationListItem" { extends $NavigationListItemBaseSettings { /** * Specifies the icon for the item. + * + * **Note:** By design, icons on second-level (child) navigation items are not rendered. */ icon?: URI | PropertyBindingInfo | `{${string}}`; @@ -2007,8 +2013,8 @@ declare module "sap/tnt/NavigationListItem" { target?: string | PropertyBindingInfo; /** - * Specifies if the item has a special design. NOTE: If `design` is not `NavigationListItemDesign.Default` - * sub-items can't be added. + * Specifies if the item has a special design. **Note:** If the `design` property is not set to `NavigationListItemDesign.Default`, + * sub-items cannot be added. * * @since 1.133.0 * @experimental Behavior might change. @@ -3427,8 +3433,9 @@ declare module "sap/tnt/ToolPage" { * Gets current value of property {@link #getSideExpanded sideExpanded}. * * Indicates if the side menu is expanded. Overrides the `expanded` property of the `sideContent` aggregation. - * *Note:** By default, on small screens, the side content is collapsed to provide more space for the main - * content. On larger screens, it is expanded. This behavior can be overridden by setting this property. + * *Note:** By default, on mobile phone devices and small screens, the side content is collapsed to provide + * more space for the main content. On larger screens, excluding mobile phone devices, it is expanded. This + * behavior can be overridden by setting this property. * * Default value is `true`. * @@ -3580,8 +3587,9 @@ declare module "sap/tnt/ToolPage" { export interface $ToolPageSettings extends $ControlSettings { /** * Indicates if the side menu is expanded. Overrides the `expanded` property of the `sideContent` aggregation. - * **Note:** By default, on small screens, the side content is collapsed to provide more space for the main - * content. On larger screens, it is expanded. This behavior can be overridden by setting this property. + * **Note:** By default, on mobile phone devices and small screens, the side content is collapsed to provide + * more space for the main content. On larger screens, excluding mobile phone devices, it is expanded. This + * behavior can be overridden by setting this property. */ sideExpanded?: boolean | PropertyBindingInfo | `{${string}}`; diff --git a/types/openui5/sap.ui.codeeditor.d.ts b/types/openui5/sap.ui.codeeditor.d.ts index 86a3c47451b6ef..23b2effe4cbbef 100644 --- a/types/openui5/sap.ui.codeeditor.d.ts +++ b/types/openui5/sap.ui.codeeditor.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/ui/codeeditor/library" {} diff --git a/types/openui5/sap.ui.commons.d.ts b/types/openui5/sap.ui.commons.d.ts index 54489be849c5fd..9f0ccf15d43e09 100644 --- a/types/openui5/sap.ui.commons.d.ts +++ b/types/openui5/sap.ui.commons.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/ui/commons/library" { import { ColorPickerMode as ColorPickerMode1 } from "sap/ui/unified/library"; diff --git a/types/openui5/sap.ui.core.d.ts b/types/openui5/sap.ui.core.d.ts index 4c9684c89c6694..db2441f8ca0a55 100644 --- a/types/openui5/sap.ui.core.d.ts +++ b/types/openui5/sap.ui.core.d.ts @@ -279,7 +279,7 @@ declare namespace sap { "sap/ui/thirdparty/qunit-2": undefined; } } -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/base/assert" { /** @@ -6787,7 +6787,7 @@ declare module "sap/ui/model/odata/v2/ODataModel" { */ adjustDeepPath?: Function; /** - * ID of the `ChangeSet` that this request belongs to + * ID of the change set that this request belongs to */ changeSetId?: string; /** @@ -6810,7 +6810,7 @@ declare module "sap/ui/model/odata/v2/ODataModel" { * - the HTTP method used for the function import is "POST", * - the function import returns a single entity, * - the back-end service must support the "Content-ID" header, - * - the back end must allow GET requests relative to this content ID outside the changeset within the + * - the back end must allow GET requests relative to this content ID outside the change set within the * `$batch` request. The success and error callback functions are called only once, even if there * are two requests in the `$batch` related to a single call of {@link #callFunction}. * - If both requests succeed, the success callback is called with the merged data of the POST and the @@ -6929,7 +6929,7 @@ declare module "sap/ui/model/odata/v2/ODataModel" { */ groupId?: string; /** - * ID of the `ChangeSet` that this request should belong to + * ID of the change set that this request should belong to */ changeSetId?: string; /** @@ -7021,7 +7021,7 @@ declare module "sap/ui/model/odata/v2/ODataModel" { * The parameter `expand` is supported since 1.78.0. If this parameter is set, the given navigation properties * are expanded automatically with the same $batch request in which the POST request for the creation is * contained. Ensure that the batch mode is used and the back-end service supports GET requests relative - * to a content ID outside the changeset. The success and error callback functions are called only once, + * to a content ID outside the change set. The success and error callback functions are called only once, * even if there are two requests in the `$batch` related to a single call of {@link #createEntry}: * * - a POST request for creating an entity, @@ -7067,7 +7067,7 @@ declare module "sap/ui/model/odata/v2/ODataModel" { */ batchGroupId?: string; /** - * The ID of the `ChangeSet` that this request should belong to + * The ID of the change set that this request should belong to */ changeSetId?: string; /** @@ -7090,7 +7090,7 @@ declare module "sap/ui/model/odata/v2/ODataModel" { * GET request. **Note:** The following prerequisites must be fulfilled: * - batch mode must be enabled; see constructor parameter `useBatch`, * - the back-end service must support the "Content-ID" header, - * - the back end must allow GET requests relative to this content ID outside the changeset within the + * - the back end must allow GET requests relative to this content ID outside the change set within the * `$batch` request. */ expand?: string; @@ -8053,7 +8053,7 @@ declare module "sap/ui/model/odata/v2/ODataModel" { */ groupId?: string; /** - * ID of the `ChangeSet` that this request should belong to + * ID of the change set that this request should belong to */ changeSetId?: string; /** @@ -8416,7 +8416,7 @@ declare module "sap/ui/model/odata/v2/ODataModel" { */ groupId?: string; /** - * ID of the `ChangeSet` that this request should belong to + * ID of the change set that this request should belong to */ changeSetId?: string; /** @@ -10234,14 +10234,15 @@ declare module "sap/ui/test/starter/config" { */ export type CoverageConfiguration = { /** - * List of modules or packages that should be instrumented. If not given, all modules are instrumented. - * Default is null + * A single module or package name, or a list of such names, that should be instrumented. If not given, + * all modules are instrumented. Default is null */ - only?: string[]; + only?: string | string[]; /** - * List of modules or packages that never should be instrumented. Default is null + * A single module or package name, or a list of such names, that never should be instrumented. Default + * is null */ - never?: string[]; + never?: string | string[]; branchTracking?: boolean; /** @@ -20616,7 +20617,7 @@ declare module "sap/ui/core/ComponentMetadata" { * * The configuration above can be accessed via `sample.Component.getMetadata().getCustomEntry("my.custom.config")`. * - * @deprecated As of version 1.27.1. Please use the sap.ui.core.ComponentMetadata#getManifestEntry + * @deprecated As of version 1.27.1. without replacement. * * @returns custom Component configuration with the specified key. */ @@ -27772,7 +27773,7 @@ declare module "sap/ui/core/Element" { /** * The dependent to add; if empty, nothing is inserted */ - oDependent: UI5Element + oDependent: ManagedObject ): this; /** * Adds some dragDropConfig to the aggregation {@link #getDragDropConfig dragDropConfig}. @@ -28156,11 +28157,11 @@ declare module "sap/ui/core/Element" { * Gets content of aggregation {@link #getDependents dependents}. * * Dependents are not rendered, but their databinding context and lifecycle are bound to the aggregating - * Element. + * ManagedObject. * * @since 1.19 */ - getDependents(): UI5Element[]; + getDependents(): ManagedObject[]; /** * Returns the best suitable DOM Element that represents this UI5 Element. By default the DOM Element with * the same ID as this Element is returned. Subclasses should override this method if the lookup via id @@ -28333,8 +28334,8 @@ declare module "sap/ui/core/Element" { oCustomData: CustomData ): int; /** - * Checks for the provided `sap.ui.core.Element` in the aggregation {@link #getDependents dependents}. and - * returns its index if found or -1 otherwise. + * Checks for the provided `sap.ui.base.ManagedObject` in the aggregation {@link #getDependents dependents}. + * and returns its index if found or -1 otherwise. * * @since 1.19 * @@ -28344,7 +28345,7 @@ declare module "sap/ui/core/Element" { /** * The dependent whose index is looked for */ - oDependent: UI5Element + oDependent: ManagedObject ): int; /** * Checks for the provided `sap.ui.core.dnd.DragDropBase` in the aggregation {@link #getDragDropConfig dragDropConfig}. @@ -28408,7 +28409,7 @@ declare module "sap/ui/core/Element" { /** * The dependent to insert; if empty, nothing is inserted */ - oDependent: UI5Element, + oDependent: ManagedObject, /** * The `0`-based index the dependent should be inserted at; for a negative value of `iIndex`, the dependent * is inserted at position 0; for a value greater than the current size of the aggregation, the dependent @@ -28547,7 +28548,7 @@ declare module "sap/ui/core/Element" { * * @returns An array of the removed elements (might be empty) */ - removeAllDependents(): UI5Element[]; + removeAllDependents(): ManagedObject[]; /** * Removes all the controls from the aggregation {@link #getDragDropConfig dragDropConfig}. * @@ -28581,8 +28582,8 @@ declare module "sap/ui/core/Element" { /** * The dependent to remove or its index or id */ - vDependent: int | string | UI5Element - ): UI5Element | null; + vDependent: int | string | ManagedObject + ): ManagedObject | null; /** * Removes a dragDropConfig from the aggregation {@link #getDragDropConfig dragDropConfig}. * @@ -28885,13 +28886,13 @@ declare module "sap/ui/core/Element" { /** * Dependents are not rendered, but their databinding context and lifecycle are bound to the aggregating - * Element. + * ManagedObject. * * @since 1.19 */ dependents?: - | UI5Element[] - | UI5Element + | ManagedObject[] + | ManagedObject | AggregationBindingInfo | `{${string}}`; @@ -38701,15 +38702,15 @@ declare module "sap/ui/core/mvc/View" { */ sViewType: string, /** - * declares if the vPreprocessor ensures safe sync processing. This means the preprocessor will be executed - * also for sync views. Please be aware that any kind of async processing (like Promises, XHR, etc) may - * break the view initialization and lead to unexpected results. + * Deprecated as of version 1.145, because this parameter is only applicable to sync views and is no longer + * used. Declares if the vPreprocessor ensures safe sync processing. This means the preprocessor will be + * executed also for sync views. Please be aware that any kind of async processing (like Promises, XHR, + * etc) may break the view initialization and lead to unexpected results. */ bSyncSupport: boolean, /** * on-demand preprocessor which enables developers to quickly activate the preprocessor for a view, by setting - * `preprocessors : { xml }`, for example. This should be false except for very special cases. There can - * only be one on-demand preprocessor per content type. + * `preprocessors : { xml }`, for example. There can only be one on-demand preprocessor per content type. */ bOnDemand?: boolean, /** @@ -39962,9 +39963,10 @@ declare module "sap/ui/core/mvc/XMLView" { */ sViewType: string, /** - * declares if the vPreprocessor ensures safe sync processing. This means the preprocessor will be executed - * also for sync views. Please be aware that any kind of async processing (like Promises, XHR, etc) may - * break the view initialization and lead to unexpected results. + * Deprecated as of version 1.145, because this parameter is only applicable to sync views and is no longer + * used. Declares if the vPreprocessor ensures safe sync processing. This means the preprocessor will be + * executed also for sync views. Please be aware that any kind of async processing (like Promises, XHR, + * etc) may break the view initialization and lead to unexpected results. */ bSyncSupport: boolean, /** @@ -40007,9 +40009,10 @@ declare module "sap/ui/core/mvc/XMLView" { | string | ((p1: Object, p2: Preprocessor.ViewInfo, p3: object) => void), /** - * declares if the vPreprocessor ensures safe sync processing. This means the preprocessor will be executed - * also for sync views. Please be aware that any kind of async processing (like Promises, XHR, etc) may - * break the view initialization and lead to unexpected results. + * Deprecated as of version 1.145, because this parameter is only applicable to sync views and is no longer + * used. Declares if the vPreprocessor ensures safe sync processing. This means the preprocessor will be + * executed also for sync views. Please be aware that any kind of async processing (like Promises, XHR, + * etc) may break the view initialization and lead to unexpected results. */ bSyncSupport: boolean, /** @@ -46924,8 +46927,6 @@ declare module "sap/ui/core/support/RuleEngineOpaExtension" { } declare module "sap/ui/core/theming/Parameters" { - import UI5Element from "sap/ui/core/Element"; - /** * A helper used for (read-only) access to CSS parameters at runtime. */ @@ -46962,7 +46963,7 @@ declare module "sap/ui/core/theming/Parameters" { get( /** * the (array with) CSS parameter name(s) or an object containing the (array with) CSS parameter name(s), - * the scopeElement and a callback for async retrieval of parameters. + * and a callback for async retrieval of parameters. */ vName: | string @@ -46972,22 +46973,12 @@ declare module "sap/ui/core/theming/Parameters" { * the (array with) CSS parameter name(s) */ name: string | string[]; - /** - * Element / control instance to take into account when looking for a parameter value. This can make a difference - * when a parameter value is overridden in a theme scope set via a CSS class. - */ - scopeElement?: UI5Element; /** * If given, the callback is only executed in case there are still parameters pending and one or more of * the requested parameters is missing. */ callback?: (p1: Value) => void; - }, - /** - * Element / control instance to take into account when looking for a parameter value. This can make a difference - * when a parameter value is overridden in a theme scope set via a CSS class. - */ - oElement?: UI5Element + } ): Value; /** * Resets the CSS parameters which finally will reload the parameters the next time they are queried via @@ -60398,6 +60389,44 @@ declare module "sap/ui/model/json/JSONModel" { * @returns Metadata object describing this class */ static getMetadata(): Metadata; + /** + * Returns the value of the property for the given `sPath` and `oContext`. + * + * @deprecated As of version 1.145.0. use {@link #getProperty} instead + * + * @returns The value for the given `sPath` and `oContext`. If the property path derived from the given + * `sPath` and `oContext` is absolute (starts with a "/") but does not lead to a property in the data structure, + * `undefined` is returned. If the property `sPath` is not absolute, `null` is returned. + */ + static getObject( + /** + * The path to the object you want to read + */ + sPath: string, + /** + * The context that resolves the path + */ + oContext?: Context + ): any | null | undefined; + /** + * Returns the original value for the property with the given `sPath` and `oContext`. + * + * @deprecated As of version 1.145.0. use {@link #getProperty} instead + * + * @returns The value of the property for the given `sPath` and `oContext`. If the property path derived + * from the given `sPath` and `oContext` is absolute (starts with a "/") but does not lead to a property + * in the data structure, `undefined` is returned. If the property `sPath` is not absolute, `null` is returned. + */ + static getOriginalProperty( + /** + * The path/name of the property + */ + sPath: string, + /** + * Context for accessing the property value + */ + oContext?: Context + ): any | null | undefined; /** * Returns a Promise of the current data-loading state. Every currently running {@link sap.ui.model.json.JSONModel#loadData } * call is respected by the returned Promise. This also includes a potential loadData call from the JSONModel's @@ -60417,7 +60446,7 @@ declare module "sap/ui/model/json/JSONModel" { */ getJSON(): string; /** - * Returns the value for the property with the given path and context. + * Returns the value for the given `sPath` and `oContext`. * * * @returns The value of the property. If the property is not found, `null` or `undefined` is returned. @@ -62224,16 +62253,19 @@ declare module "sap/ui/model/Model" { */ getMetaModel(): MetaModel | undefined; /** + * Returns the value of the property for the given `sPath` and `oContext`. + * * - * @returns The value for the given path/context or `undefined` if data could not be found + * @returns The the value of the property for the given path/context or `undefined` if data could not be + * found */ getObject( /** - * Path to where to read the object + * The path to the object you want to read */ sPath: string, /** - * Context with which the path should be resolved + * The context that resolves the path */ oContext?: Context, /** @@ -62247,29 +62279,31 @@ declare module "sap/ui/model/Model" { * The original value is the value that was last responded by a server if using a server model implementation. * * - * @returns vValue The value of the property + * @returns The value of the property */ getOriginalProperty( /** - * Path/name of the property + * The path/name of the property */ sPath: string, /** - * Context if available to access the property value + * Context for accessing the property value */ oContext?: Context ): any; /** + * Returns the value of the property for the given `sPath` and `oContext`. + * * - * @returns Value of the addressed property + * @returns The value of the addressed property */ getProperty( /** - * The path to where to read the attribute value + * The path to the attribute value you want to read */ sPath: string, /** - * The context with which the path should be resolved + * The context that resolves the path */ oContext?: Context ): any; @@ -65580,7 +65614,7 @@ declare module "sap/ui/model/odata/ODataModel" { /** * Appends the change batch operations to the end of the batch stack. Only `PUTPOST` or `DELETE` * batch operations should be included in the specified array. The operations in the array will be included - * in a single changeset. To embed change operations in different change sets call this method with the + * in a single change set. To embed change operations in different change sets call this method with the * corresponding change operations again. If an illegal batch operation is added to the change set nothing * will be performed and false will be returned. * @@ -70500,8 +70534,8 @@ declare module "sap/ui/model/odata/v2/Context" { */ groupId?: string; /** - * ID of the `ChangeSet` that this request should belong to. If not provided, the `changeSetId` defined - * for the type of the entity to be deleted is used. + * ID of the change set that this request should belong to. If not provided, the `changeSetId` defined for + * the type of the entity to be deleted is used. */ changeSetId?: string; /** @@ -71578,7 +71612,7 @@ declare module "sap/ui/model/odata/v2/ODataListBinding" { */ mParameters?: { /** - * The ID of the `ChangeSet` that this request should belong to + * The ID of the change set that this request should belong to */ changeSetId?: string; /** @@ -72861,12 +72895,15 @@ declare module "sap/ui/model/odata/v4/Context" { bDoNotRequestCount?: boolean ): Promise; /** + * Note: You may want to call {@link #delete} instead in order to delete the OData entity on the server + * side. + * * Destroys this context, that is, it removes this context from all dependent bindings and drops references * to {@link #getBinding binding} and {@link #getModel model}, so that the context cannot be used anymore; * it keeps path and index for debugging purposes. A destroyed context can be recognized by calling {@link #getBinding}, * which returns `undefined`. * - * **BEWARE:** Do not call this function! The lifetime of an OData V4 context is completely controlled by + * **BEWARE: Do not call this function!** The lifetime of an OData V4 context is completely controlled by * its binding. * See: * sap.ui.base.Object#destroy @@ -73200,6 +73237,10 @@ declare module "sap/ui/model/odata/v4/Context" { * Refreshes the single entity represented by this context. Use {@link #requestRefresh} if you want to wait * for the refresh. * + * When using data aggregation without `groupLevels` and without `"grandTotal like 1.84"` (see {@link sap.ui.model.odata.v4.ODataListBinding#setAggregation}), + * single entities (see {@link #isAggregated}) can be refreshed and the grand total is updated accordingly + * (@experimental as of version 1.145.0). + * * @since 1.53.0 */ refresh( @@ -73333,7 +73374,7 @@ declare module "sap/ui/model/odata/v4/Context" { */ sGroupId?: string, /** - * Allows to remove the context + * Allows to remove the context, see {@link #refresh} for details */ bAllowRemoval?: boolean ): Promise; @@ -73399,7 +73440,8 @@ declare module "sap/ui/model/odata/v4/Context" { * Since 1.82.0, absolute paths are supported. Absolute paths must start with the entity container (example * "/com.sap.gateway.default.iwbep.tea_busi.v0001.Container/TEAMS") of the service. All (navigation) properties * in the complete model matching such an absolute path are updated. Since 1.85.0, "14.3.11 Expression edm:String" - * is accepted as well. + * is accepted as well. Since 1.145.0, you can use `null` values (and `{$Null : null}`) as synonyms for + * empty navigation property paths. * * Since 1.108.8, a property path matching the "com.sap.vocabularies.Common.v1.Messages" annotation of a * list binding's entity type is treated specially for a row context of a list binding: It is loaded even @@ -73448,9 +73490,10 @@ declare module "sap/ui/model/odata/v4/Context" { * Note: This can be used for single entities in a data aggregation scenario (@experimental as of version * 1.144.0), see {@link #isAggregated}. Such a kept-alive context * can be used as a binding context, can be used for updating data (see {@link #setProperty}), - * is refreshed when its list binding's {@link sap.ui.model.odata.v4.ODataListBinding#refresh}) is called, - * and is refreshed when {@link #requestSideEffects}) is called on its list binding's header context. - * Other APIs are not supported. + * can be refreshed (see {@link #refresh} and {@link #requestRefresh}), is refreshed when its list + * binding's {@link sap.ui.model.odata.v4.ODataListBinding#refresh}) is called, and is refreshed when + * {@link #requestSideEffects}) is called on its list binding's header context. Other APIs are not + * supported. * See: * #isKeepAlive * @@ -73997,6 +74040,7 @@ declare module "sap/ui/model/odata/v4/ODataContextBinding" { * Method not supported * * @since 1.37.0 + * @deprecated As of version 1.37.0. calling this method is not supported */ isInitial(): boolean; /** @@ -74869,8 +74913,9 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" { * sap.ui.model.ListBinding#getDistinctValues * * @since 1.37.0 + * @deprecated As of version 1.37.0. calling this method is not supported */ - getDistinctValues(_sPath?: string): any[]; + getDistinctValues(): any[]; /** * Returns a URL by which the complete content of the list can be downloaded in JSON format. The request * delivers all entities considering the binding's query options (such as filters or sorters). Returns `null` @@ -75053,6 +75098,7 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" { * Method not supported * * @since 1.37.0 + * @deprecated As of version 1.37.0. calling this method is not supported */ isInitial(): boolean; /** @@ -75857,18 +75903,9 @@ declare module "sap/ui/model/odata/v4/ODataMetaModel" { * sap.ui.model.Model#bindTree * * @since 1.37.0 + * @deprecated As of version 1.37.0. calling this method is not supported */ - bindTree( - _sPath: string, - - _oContext?: Context, - - _aFilters?: Filter[], - - _mParameters?: object, - - _aSorters?: Sorter[] - ): TreeBinding; + bindTree(): TreeBinding; /** * Returns a snapshot of each $metadata or annotation file loaded so far, combined into a single "JSON" * object according to the streamlined OData V4 Metadata JSON Format. @@ -75968,6 +76005,7 @@ declare module "sap/ui/model/odata/v4/ODataMetaModel" { * Method not supported * * @since 1.37.0 + * @deprecated As of version 1.37.0. calling this method is not supported */ getOriginalProperty(): void; /** @@ -76035,6 +76073,7 @@ declare module "sap/ui/model/odata/v4/ODataMetaModel" { * sap.ui.model.Model#refresh * * @since 1.37.0 + * @deprecated As of version 1.37.0. calling this method is not supported */ refresh(): void; /** @@ -76079,7 +76118,7 @@ declare module "sap/ui/model/odata/v4/ODataMetaModel" { Text: string; - UnitSpecificScale: string; + UnitSpecificScale: number; } > | null>; /** @@ -76383,7 +76422,7 @@ declare module "sap/ui/model/odata/v4/ODataMetaModel" { Text: string; - UnitSpecificScale: string; + UnitSpecificScale: number; } > | null>; /** @@ -76459,6 +76498,7 @@ declare module "sap/ui/model/odata/v4/ODataMetaModel" { * Method not supported * * @since 1.37.0 + * @deprecated As of version 1.37.0. calling this method is not supported */ setLegacySyntax(): void; /** @@ -77083,18 +77123,9 @@ declare module "sap/ui/model/odata/v4/ODataModel" { * sap.ui.model.Model#bindTree * * @since 1.37.0 + * @deprecated As of version 1.37.0. calling this method is not supported */ - bindTree( - _sPath: string, - - _oContext?: Context1, - - _aFilters?: Filter[], - - _mParameters?: object, - - _aSorters?: Sorter[] - ): TreeBinding; + bindTree(): TreeBinding; /** * Changes the HTTP headers used for data and metadata requests sent by this model. * @@ -77211,6 +77242,7 @@ declare module "sap/ui/model/odata/v4/ODataModel" { * Method not supported * * @since 1.37.0 + * @deprecated As of version 1.37.0. calling this method is not supported */ destroyBindingContext(): void; /** @@ -77400,6 +77432,7 @@ declare module "sap/ui/model/odata/v4/ODataModel" { * Method not supported * * @since 1.37.0 + * @deprecated As of version 1.37.0. calling this method is not supported */ getObject(): void; /** @@ -77414,6 +77447,7 @@ declare module "sap/ui/model/odata/v4/ODataModel" { * Method not supported * * @since 1.37.0 + * @deprecated As of version 1.37.0. calling this method is not supported */ getOriginalProperty(): void; /** @@ -77422,6 +77456,7 @@ declare module "sap/ui/model/odata/v4/ODataModel" { * sap.ui.model.Model#getProperty * * @since 1.37.0 + * @deprecated As of version 1.37.0. calling this method is not supported */ getProperty(): void; /** @@ -77575,6 +77610,7 @@ declare module "sap/ui/model/odata/v4/ODataModel" { * Method not supported * * @since 1.37.0 + * @deprecated As of version 1.37.0. calling this method is not supported */ setLegacySyntax(): void; /** @@ -77594,7 +77630,7 @@ declare module "sap/ui/model/odata/v4/ODataModel" { /** * A "Retry-After" handler */ - fnRetryAfter: (p1: Error) => Promise + fnRetryAfter: (p1: Error) => Promise ): void; /** * Submits the requests associated with the given group ID in one batch request. Requests from subsequent @@ -77950,6 +77986,7 @@ declare module "sap/ui/model/odata/v4/ODataPropertyBinding" { * Method not supported * * @since 1.37.0 + * @deprecated As of version 1.37.0. calling this method is not supported */ isInitial(): boolean; /** @@ -78052,6 +78089,7 @@ declare module "sap/ui/model/odata/v4/ODataPropertyBinding" { * sap.ui.model.Binding#resume * * @since 1.37.0 + * @deprecated As of version 1.37.0. calling this method is not supported */ resume(): void; /** @@ -78116,6 +78154,7 @@ declare module "sap/ui/model/odata/v4/ODataPropertyBinding" { * sap.ui.model.Binding#suspend * * @since 1.37.0 + * @deprecated As of version 1.37.0. calling this method is not supported */ suspend(): void; /** @@ -89857,6 +89896,8 @@ declare namespace sap { "sap/ui/dom/denormalizeScrollLeftRTL": undefined; + "sap/ui/dom/detectTextSelection": undefined; + "sap/ui/dom/getOwnerWindow": undefined; "sap/ui/dom/getScrollbarSize": undefined; diff --git a/types/openui5/sap.ui.dt.d.ts b/types/openui5/sap.ui.dt.d.ts index 91774af0075288..3dbdb3e7f2669a 100644 --- a/types/openui5/sap.ui.dt.d.ts +++ b/types/openui5/sap.ui.dt.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/ui/dt/library" { export namespace designtime { diff --git a/types/openui5/sap.ui.fl.d.ts b/types/openui5/sap.ui.fl.d.ts index c7c9c6614e60ea..c26743319c32bb 100644 --- a/types/openui5/sap.ui.fl.d.ts +++ b/types/openui5/sap.ui.fl.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/ui/fl/library" {} @@ -1669,6 +1669,8 @@ declare namespace sap { "sap/ui/fl/initial/_internal/Storage": undefined; + "sap/ui/fl/initial/_internal/StorageFeaturesMerger": undefined; + "sap/ui/fl/initial/_internal/StorageUtils": undefined; "sap/ui/fl/initial/api/InitialFlexAPI": undefined; @@ -1691,6 +1693,8 @@ declare namespace sap { "sap/ui/fl/transport/TransportDialog": undefined; + "sap/ui/fl/util/CancelError": undefined; + "sap/ui/fl/Utils": undefined; "sap/ui/fl/variants/context/Component": undefined; diff --git a/types/openui5/sap.ui.integration.d.ts b/types/openui5/sap.ui.integration.d.ts index d3a8c22136633a..7bd9b48d8abd8f 100644 --- a/types/openui5/sap.ui.integration.d.ts +++ b/types/openui5/sap.ui.integration.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/ui/integration/library" { import { URI } from "sap/ui/core/library"; diff --git a/types/openui5/sap.ui.layout.d.ts b/types/openui5/sap.ui.layout.d.ts index 05824625a1cef3..803ea56bcde3b5 100644 --- a/types/openui5/sap.ui.layout.d.ts +++ b/types/openui5/sap.ui.layout.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/ui/layout/library" { import Control from "sap/ui/core/Control"; diff --git a/types/openui5/sap.ui.mdc.d.ts b/types/openui5/sap.ui.mdc.d.ts index 0b8884f42ab424..9f759cc560f2dd 100644 --- a/types/openui5/sap.ui.mdc.d.ts +++ b/types/openui5/sap.ui.mdc.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/ui/mdc/AggregationBaseDelegate" { import BaseDelegate from "sap/ui/mdc/BaseDelegate"; @@ -173,7 +173,6 @@ declare module "sap/ui/mdc/ChartDelegate" { * the internal behavior. * * @since 1.88 - * @experimental As of version 1.88. */ interface ChartDelegate extends AggregationBaseDelegate { /** @@ -824,8 +823,10 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" { */ interface FieldBaseDelegate extends BaseDelegate { /** - * Enables applications to control condition updates based on `value` / `additionalvalue` property changes. - * + * Enables applications to control condition updates based on {@link sap.ui.mdc.Field#getValue value} / + * {@link sap.ui.mdc.Field#getAdditionalValue additionalValue} property changes of a {@link sap.ui.mdc.Field Field } + * or {@link sap.ui.mdc.field.MultiValueFieldItem#getKey key} / {@link sap.ui.mdc.field.MultiValueFieldItem#getDescription description } + * property changes of a {@link sap.ui.mdc.MultiValueField MultiValueField}. * By default, this method returns a condition with an `EQ` operator. * * **Note:** Custom implementations of this method may lead to intransparency as a field's condition may @@ -855,8 +856,10 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" { oCurrentCondition: undefined | ConditionObject ): undefined | ConditionObject; /** - * Enables applications to control condition updates based on `value` / `additionalvalue` property changes. - * + * Enables applications to control condition updates based on {@link sap.ui.mdc.Field#getValue value} / + * {@link sap.ui.mdc.Field#getAdditionalValue additionalValue} property changes of a {@link sap.ui.mdc.Field Field } + * or {@link sap.ui.mdc.field.MultiValueFieldItem#getKey key} / {@link sap.ui.mdc.field.MultiValueFieldItem#getDescription description } + * property changes of a {@link sap.ui.mdc.MultiValueField MultiValueField}. * By default, this method returns a condition with an `EQ` operator. * * **Note:** Custom implementations of this method may lead to intransparency as a field's condition may @@ -1441,11 +1444,10 @@ declare module "sap/ui/mdc/field/MultiValueFieldDelegate" { /** * Implements the model-specific logic to update items after conditions have been updated. * - * Items can be removed, updated, or added. Use the binding information of the `MultiValueField` control - * to update the data in the related model. + * Items can be removed, updated, or added. Use the binding information of the {@link sap.ui.mdc.MultiValueField MultiValueField } + * control to update the data in the related model. * * @deprecated As of version 1.142. replaced by {@link module:sap/ui/mdc/field/MultiValueFieldDelegate.updateItemsFromConditions updateItemsFromConditions}. - * @experimental */ updateItems( /** @@ -1453,32 +1455,31 @@ declare module "sap/ui/mdc/field/MultiValueFieldDelegate" { */ oPayload: object, /** - * Current conditions of the `MultiValueField` control + * Current conditions of the {@link sap.ui.mdc.MultiValueField MultiValueField} control */ aConditions: ConditionObject[], /** - * Current `MultiValueField` control to determine binding information to update the values of the related - * model + * Current {@link sap.ui.mdc.MultiValueField MultiValueField} control to determine binding information to + * update the values of the related model */ oMultiValueField: MultiValueField ): void; /** * Implements the model-specific logic to update items after conditions have been updated. * - * Items can be removed, updated, or added. Use the binding information of the `MultiValueField` control - * to update the data in the related model. + * Items can be removed, updated, or added. Use the binding information of the {@link sap.ui.mdc.MultiValueField MultiValueField } + * control to update the data in the related model. * * @since 1.142 - * @experimental */ updateItemsFromConditions( /** - * Current `MultiValueField` control to determine binding information to update the values of the related - * model + * Current {@link sap.ui.mdc.MultiValueField MultiValueField} control to determine binding information to + * update the values of the related model */ oMultiValueField: MultiValueField, /** - * Current conditions of the `MultiValueField` control + * Current conditions of the {@link sap.ui.mdc.MultiValueField MultiValueField} control */ aConditions: ConditionObject[] ): void; @@ -1566,6 +1567,8 @@ declare module "sap/ui/mdc/FilterBarDelegate" { /** * A validator to evaluate the `FilterBar` state. * + * **Note:** Conditions of filters with error will be removed if shown on P13n dialog. + * * * @returns The inner `FilterBar` state */ @@ -4561,7 +4564,6 @@ declare module "sap/ui/mdc/Chart" { * via an implementation of a `ChartDelegate` module. * * @since 1.88 - * @experimental As of version 1.88. */ export default class Chart extends Control implements IFilterSource, IxState { __implements__sap_ui_mdc_IFilterSource: boolean; @@ -4634,6 +4636,19 @@ declare module "sap/ui/mdc/Chart" { * @returns Metadata object describing this class */ static getMetadata(): ElementMetadata; + /** + * Adds some chartAction to the aggregation {@link #getChartActions chartActions}. + * + * @since 1.145 + * + * @returns Reference to `this` in order to allow method chaining + */ + addChartAction( + /** + * The chartAction to add; if empty, nothing is inserted + */ + oChartAction: Control1 + ): this; /** * Attaches event handler `fnFunction` to the {@link #event:selectionDetailsActionPressed selectionDetailsActionPressed } * event of this `sap.ui.mdc.Chart`. @@ -4683,6 +4698,14 @@ declare module "sap/ui/mdc/Chart" { */ oListener?: object ): this; + /** + * Destroys all the chartActions in the aggregation {@link #getChartActions chartActions}. + * + * @since 1.145 + * + * @returns Reference to `this` in order to allow method chaining + */ + destroyChartActions(): this; /** * Destroys the noData in the aggregation {@link #getNoData noData}. * @@ -4760,6 +4783,20 @@ declare module "sap/ui/mdc/Chart" { * @returns Value of property `autoBindOnInit` */ getAutoBindOnInit(): boolean; + /** + * Gets content of aggregation {@link #getChartActions chartActions}. + * + * Additional chart-related actions that are positioned together with other chart-generated actions, based + * on the {@link sap.ui.mdc.chart.ActionLayoutData ActionLayoutData} provided. + * + * **Note:** All actions should use layout data of the {@link sap.ui.mdc.chart.ActionLayoutData ActionLayoutData } + * type to ensure correct ordering. Actions that do not use this layout data will be placed after the chart-generated + * actions. + * **Note:** As with other chart-generated actions, these actions are excluded from the UI adaptation. + * + * @since 1.145 + */ + getChartActions(): Control1[]; /** * Gets current value of property {@link #getChartType chartType}. * @@ -4797,7 +4834,6 @@ declare module "sap/ui/mdc/Chart" { * * Default value is `...see text or source`. * - * @experimental * * @returns Value of property `delegate` */ @@ -5015,6 +5051,20 @@ declare module "sap/ui/mdc/Chart" { */ oAction: Control1 ): int; + /** + * Checks for the provided `sap.ui.core.Control` in the aggregation {@link #getChartActions chartActions}. + * and returns its index if found or -1 otherwise. + * + * @since 1.145 + * + * @returns The index of the provided control in the aggregation if found, or -1 otherwise + */ + indexOfChartAction( + /** + * The chartAction whose index is looked for + */ + oChartAction: Control1 + ): int; /** * Checks for the provided `sap.ui.mdc.chart.Item` in the aggregation {@link #getItems items}. and returns * its index if found or -1 otherwise. @@ -5028,6 +5078,25 @@ declare module "sap/ui/mdc/Chart" { */ oItem: Item ): int; + /** + * Inserts a chartAction into the aggregation {@link #getChartActions chartActions}. + * + * @since 1.145 + * + * @returns Reference to `this` in order to allow method chaining + */ + insertChartAction( + /** + * The chartAction to insert; if empty, nothing is inserted + */ + oChartAction: Control1, + /** + * The `0`-based index the chartAction should be inserted at; for a negative value of `iIndex`, the chartAction + * is inserted at position 0; for a value greater than the current size of the aggregation, the chartAction + * is inserted at the last position + */ + iIndex: int + ): this; /** * Executes a rebind considering the provided external and inbuilt filtering. * @@ -5037,6 +5106,29 @@ declare module "sap/ui/mdc/Chart" { * for example because there are invalid filters. */ rebind(): Promise; + /** + * Removes all the controls from the aggregation {@link #getChartActions chartActions}. + * + * Additionally, it unregisters them from the hosting UIArea. + * + * @since 1.145 + * + * @returns An array of the removed elements (might be empty) + */ + removeAllChartActions(): Control1[]; + /** + * Removes a chartAction from the aggregation {@link #getChartActions chartActions}. + * + * @since 1.145 + * + * @returns The removed chartAction or `null` + */ + removeChartAction( + /** + * The chartAction to remove or its index or id + */ + vChartAction: int | string | Control1 + ): Control1 | null; /** * Sets a new value for property {@link #getAutoBindOnInit autoBindOnInit}. * @@ -5077,7 +5169,6 @@ declare module "sap/ui/mdc/Chart" { * * Default value is `...see text or source`. * - * @experimental * * @returns Reference to `this` in order to allow method chaining */ @@ -5395,8 +5486,6 @@ declare module "sap/ui/mdc/Chart" { * - `aggregatable` * - `role` * - `dataType` - * - * @experimental As of version 1.80. */ export type PropertyInfo = PropertyInfo1 & { /** @@ -5415,8 +5504,6 @@ declare module "sap/ui/mdc/Chart" { /** * Describes the settings that can be provided to the Chart constructor. - * - * @experimental As of version 1.88. */ export interface $ChartSettings extends $ControlSettings { /** @@ -5443,8 +5530,6 @@ declare module "sap/ui/mdc/Chart" { * **Note:** Ensure that the related file can be requested (any required library has to be loaded before * that). * Do not bind or modify the module. This property can only be configured during control initialization. - * - * @experimental */ delegate?: object | PropertyBindingInfo | `{${string}}`; @@ -5605,6 +5690,23 @@ declare module "sap/ui/mdc/Chart" { */ actions?: Control1[] | Control1 | AggregationBindingInfo | `{${string}}`; + /** + * Additional chart-related actions that are positioned together with other chart-generated actions, based + * on the {@link sap.ui.mdc.chart.ActionLayoutData ActionLayoutData} provided. + * + * **Note:** All actions should use layout data of the {@link sap.ui.mdc.chart.ActionLayoutData ActionLayoutData } + * type to ensure correct ordering. Actions that do not use this layout data will be placed after the chart-generated + * actions. + * **Note:** As with other chart-generated actions, these actions are excluded from the UI adaptation. + * + * @since 1.145 + */ + chartActions?: + | Control1[] + | Control1 + | AggregationBindingInfo + | `{${string}}`; + /** * Feeds details popover actions for data point selection in the chart. * For more information, see {@link sap.ui.mdc.chart.SelectionDetailsActions SelectionDetailsActions}. @@ -5679,6 +5781,138 @@ declare module "sap/ui/mdc/Chart" { >; } +declare module "sap/ui/mdc/chart/ActionLayoutData" { + import { + default as OverflowToolbarLayoutData, + $OverflowToolbarLayoutDataSettings, + } from "sap/m/OverflowToolbarLayoutData"; + + import { IActionLayoutData } from "sap/ui/mdc/library"; + + import ElementMetadata from "sap/ui/core/ElementMetadata"; + + import ChartActionPosition from "sap/ui/mdc/enums/ChartActionPosition"; + + import { PropertyBindingInfo } from "sap/ui/base/ManagedObject"; + + /** + * Defines the layout data for the {@link sap.ui.mdc.Chart#getActions actions} and {@link sap.ui.mdc.Chart#getChartActions chartActions } + * of the {@link sap.ui.mdc.Chart Chart}. + * + * @since 1.145 + */ + export default class ActionLayoutData + extends OverflowToolbarLayoutData + implements IActionLayoutData + { + __implements__sap_ui_mdc_IActionLayoutData: boolean; + /** + * Constructor for a new `ActionLayoutData`. + * + * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated + * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description + * of the syntax of the settings object. + */ + constructor( + /** + * Initial settings for the new layout data + */ + mSettings?: $ActionLayoutDataSettings + ); + /** + * Constructor for a new `ActionLayoutData`. + * + * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated + * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description + * of the syntax of the settings object. + */ + constructor( + /** + * ID for the new layout data, generated automatically if no ID is given + */ + sId?: string, + /** + * Initial settings for the new layout data + */ + mSettings?: $ActionLayoutDataSettings + ); + + /** + * Creates a new subclass of class sap.ui.mdc.chart.ActionLayoutData with name `sClassName` and enriches + * it with the information contained in `oClassInfo`. + * + * `oClassInfo` might contain the same kind of information as described in {@link sap.m.OverflowToolbarLayoutData.extend}. + * + * + * @returns Created class / constructor function + */ + static extend>( + /** + * Name of the class being created + */ + sClassName: string, + /** + * Object literal with information about the class + */ + oClassInfo?: sap.ClassInfo, + /** + * Constructor function for the metadata object; if not given, it defaults to the metadata implementation + * used by this class + */ + FNMetaImpl?: Function + ): Function; + /** + * Returns a metadata object for class sap.ui.mdc.chart.ActionLayoutData. + * + * + * @returns Metadata object describing this class + */ + static getMetadata(): ElementMetadata; + /** + * Gets current value of property {@link #getPosition position}. + * + * Defines the position of the action within the group of chart actions. + * + * Default value is `EndActions`. + * + * + * @returns Value of property `position` + */ + getPosition(): ChartActionPosition; + /** + * Sets a new value for property {@link #getPosition position}. + * + * Defines the position of the action within the group of chart actions. + * + * When called with a value of `null` or `undefined`, the default value of the property will be restored. + * + * Default value is `EndActions`. + * + * + * @returns Reference to `this` in order to allow method chaining + */ + setPosition( + /** + * New value for property `position` + */ + sPosition?: ChartActionPosition | keyof typeof ChartActionPosition + ): this; + } + /** + * Describes the settings that can be provided to the ActionLayoutData constructor. + */ + export interface $ActionLayoutDataSettings + extends $OverflowToolbarLayoutDataSettings { + /** + * Defines the position of the action within the group of chart actions. + */ + position?: + | (ChartActionPosition | keyof typeof ChartActionPosition) + | PropertyBindingInfo + | `{${string}}`; + } +} + declare module "sap/ui/mdc/chart/ChartImplementationContainer" { import { default as Control, $ControlSettings } from "sap/ui/core/Control"; @@ -5693,7 +5927,6 @@ declare module "sap/ui/mdc/chart/ChartImplementationContainer" { * Based on the `showNoDataStruct` the `content` or `noDataContent` will be shown. * * @since 1.105 - * @experimental As of version 1.105. */ export default class ChartImplementationContainer extends Control { /** @@ -5805,8 +6038,6 @@ declare module "sap/ui/mdc/chart/ChartImplementationContainer" { } /** * Describes the settings that can be provided to the ChartImplementationContainer constructor. - * - * @experimental As of version 1.105. */ export interface $ChartImplementationContainerSettings extends $ControlSettings { @@ -5850,7 +6081,6 @@ declare module "sap/ui/mdc/chart/ChartSelectionDetails" { * the configuration specified. * * @since 1.88 - * @experimental As of version 1.88. */ export default class ChartSelectionDetails extends SelectionDetails { /** @@ -5994,8 +6224,6 @@ declare module "sap/ui/mdc/chart/ChartSelectionDetails" { } /** * Describes the settings that can be provided to the ChartSelectionDetails constructor. - * - * @experimental As of version 1.88. */ export interface $ChartSelectionDetailsSettings extends $SelectionDetailsSettings { @@ -6037,7 +6265,6 @@ declare module "sap/ui/mdc/chart/Item" { * The `Item` control for the chart/property metadata used within MDC Chart. * * @since 1.88 - * @experimental As of version 1.88. */ export default class Item extends UI5Element { /** @@ -6242,8 +6469,6 @@ declare module "sap/ui/mdc/chart/Item" { } /** * Describes the settings that can be provided to the Item constructor. - * - * @experimental As of version 1.88. */ export interface $ItemSettings extends $ElementSettings { /** @@ -6294,7 +6519,6 @@ declare module "sap/ui/mdc/chart/SelectionDetailsActions" { * The `SelectionDetailsActions` is used to provide additional functionality to the Details popover. * * @since 1.88 - * @experimental As of version 1.88. */ export default class SelectionDetailsActions extends UI5Element { /** @@ -6593,8 +6817,6 @@ declare module "sap/ui/mdc/chart/SelectionDetailsActions" { } /** * Describes the settings that can be provided to the SelectionDetailsActions constructor. - * - * @experimental As of version 1.88. */ export interface $SelectionDetailsActionsSettings extends $ElementSettings { /** @@ -7848,12 +8070,65 @@ declare module "sap/ui/mdc/enums/BaseType" { export default BaseType; } +declare module "sap/ui/mdc/enums/ChartActionPosition" { + /** + * Defines the supported positions for chart-relevant actions within the chart toolbar, in accordance with + * the {@link https://www.sap.com/design-system/fiori-design-web/ui-elements/chart-toolbar/ SAP Design System}. + * + * @since 1.145 + */ + enum ChartActionPosition { + /** + * Extension point for actions displayed after all chart-relevant actions. + */ + EndActions = "EndActions", + /** + * The position of the drill-down action in the personalization actions group. + */ + PersonalizationActionsDrillDown = "PersonalizationActionsDrillDown", + /** + * The position of the legend action in the personalization actions group. + */ + PersonalizationActionsLegend = "PersonalizationActionsLegend", + /** + * The position of the selection details action in the personalization actions group. + */ + PersonalizationActionsSelectionDetails = "PersonalizationActionsSelectionDetails", + /** + * The position of the settings action in the personalization actions group. + */ + PersonalizationActionsSettings = "PersonalizationActionsSettings", + /** + * The position of the zoom in action in the personalization actions group. + */ + PersonalizationActionsZoomIn = "PersonalizationActionsZoomIn", + /** + * The position of the zoom out action in the personalization actions group. + */ + PersonalizationActionsZoomOut = "PersonalizationActionsZoomOut", + /** + * Extension point for the share actions. These actions allow users to share chart content with another + * application or with the homepage as a tile, such as Send as Email, Save as Tile. + */ + ShareActions = "ShareActions", + /** + * Extension point for the view actions. These actions change the representation of the entire chart, such + * as View Switch, Fullscreen. + */ + ViewActions = "ViewActions", + /** + * The position of the chart type menu in the view actions group. + */ + ViewActionsChartType = "ViewActionsChartType", + } + export default ChartActionPosition; +} + declare module "sap/ui/mdc/enums/ChartP13nMode" { /** * Defines the personalization mode of the chart. * * @since 1.115 - * @experimental As of version 1.115. */ enum ChartP13nMode { /** @@ -7882,7 +8157,6 @@ declare module "sap/ui/mdc/enums/ChartToolbarActionType" { * Can be used to remove some of the default `ToolbarAction`. For more information, see {@link sap.ui.mdc.Chart#ignoreToolbarActions}. * * @since 1.115 - * @experimental As of version 1.115. */ enum ChartToolbarActionType { /** @@ -13916,8 +14190,13 @@ declare module "sap/ui/mdc/filterbar/FilterBarBase" { /** * Specifies the filter metadata. + * The format is the same as the return type of the {@link module:sap/ui/mdc/FilterBarDelegate.fetchProperties fetchProperties } + * delegate function. + * Properties specified here must be consistent with properties returned by the {@link module:sap/ui/mdc/FilterBarDelegate.fetchProperties fetchProperties } + * callback, otherwise validation errors might occur. + * Metadata for initially rendered {@link sap.ui.mdc.FilterField FilterFields} (those in the `filterItems` + * aggregation) should be specified here, rather than in the `FilterField` configuration. * **Note**: This property must not be bound. - * **Note**: This property is used exclusively for SAPUI5 flexibility/ Fiori Elements. Do not use it otherwise. * **Node**: Please check {@link sap.ui.mdc.filterbar.PropertyInfo} for more information about the supported * inner elements. **Note**: Existing properties (set via `sap.ui.mdc.filterbar.FilterBarBase#setPropertyInfo`) * must not be removed and their attributes must not be changed during the {@link module:sap/ui/mdc/FilterBarDelegate.fetchProperties fetchProperties } @@ -14981,7 +15260,7 @@ declare module "sap/ui/mdc/Geomap" { * * Default value is `...see text or source`. * - * @experimental + * @experimental As of version 1.142. * * @returns Value of property `delegate` */ @@ -15184,7 +15463,7 @@ declare module "sap/ui/mdc/Geomap" { * * Default value is `...see text or source`. * - * @experimental + * @experimental As of version 1.142. * * @returns Reference to `this` in order to allow method chaining */ @@ -15477,7 +15756,7 @@ declare module "sap/ui/mdc/Geomap" { * that). * Do not bind or modify the module. This property can only be configured during control initialization. * - * @experimental + * @experimental As of version 1.142. */ delegate?: object | PropertyBindingInfo | `{${string}}`; @@ -16652,7 +16931,6 @@ declare module "sap/ui/mdc/MultiValueField" { * * Default value is `...see text or source`. * - * @experimental * * @returns Value of property `delegate` */ @@ -16821,7 +17099,6 @@ declare module "sap/ui/mdc/MultiValueField" { * * Default value is `...see text or source`. * - * @experimental * * @returns Reference to `this` in order to allow method chaining */ @@ -16895,8 +17172,6 @@ declare module "sap/ui/mdc/MultiValueField" { * **Note:** Ensure that the related file can be requested (any required library has to be loaded before * that). * Do not bind or modify the module. This property can only be configured during control initialization. - * - * @experimental */ delegate?: object | PropertyBindingInfo | `{${string}}`; @@ -24537,10 +24812,12 @@ declare module "sap/ui/mdc/valuehelp/base/Container" { declare module "sap/ui/mdc/valuehelp/base/Content" { import { default as UI5Element, $ElementSettings } from "sap/ui/core/Element"; - import { ConditionObject } from "sap/ui/mdc/condition/Condition"; + import { ID } from "sap/ui/core/library"; import Control from "sap/ui/core/Control"; + import { ConditionObject } from "sap/ui/mdc/condition/Condition"; + import { ItemForValueConfiguration, ValueHelpItem, @@ -24633,6 +24910,19 @@ declare module "sap/ui/mdc/valuehelp/base/Content" { * @returns Metadata object describing this class */ static getMetadata(): ElementMetadata; + /** + * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}. + * + * @since 1.145.0 + * + * @returns Reference to `this` in order to allow method chaining + */ + addAriaLabelledBy( + /** + * The ariaLabelledBy to add; if empty, nothing is inserted + */ + vAriaLabelledBy: ID | Control + ): this; /** * Provides access to the delegate initialization `Promise` of the value help. * @@ -24663,6 +24953,12 @@ declare module "sap/ui/mdc/valuehelp/base/Content" { */ oPayload?: object ): ConditionObject; + /** + * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy ariaLabelledBy}. + * + * @since 1.145.0 + */ + getAriaLabelledBy(): ID[]; /** * Loads additional dependencies, creates and returns displayed content. * @@ -24908,6 +25204,27 @@ declare module "sap/ui/mdc/valuehelp/base/Content" { * @returns `true` if a scrolling mechanism is needed */ provideScrolling(): boolean; + /** + * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}. + * + * @since 1.145.0 + * + * @returns An array of the removed elements (might be empty) + */ + removeAllAriaLabelledBy(): ID[]; + /** + * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}. + * + * @since 1.145.0 + * + * @returns The removed ariaLabelledBy or `null` + */ + removeAriaLabelledBy( + /** + * The ariaLabelledBy to be removed or its index or ID + */ + vAriaLabelledBy: int | ID | Control + ): ID | null; /** * The focus visualization of the field help needs to be removed as the user starts typing into the source * control. @@ -25016,6 +25333,13 @@ declare module "sap/ui/mdc/valuehelp/base/Content" { * Hide content temporary. */ visible?: boolean | PropertyBindingInfo | `{${string}}`; + + /** + * Association to controls / IDs that label this control (see WAI-ARIA attribute aria-labelledby). + * + * @since 1.145.0 + */ + ariaLabelledBy?: Array; } /** @@ -27596,6 +27920,8 @@ declare namespace sap { "sap/ui/mdc/Chart": undefined; + "sap/ui/mdc/chart/ActionLayoutData": undefined; + "sap/ui/mdc/chart/ChartImplementationContainer": undefined; "sap/ui/mdc/chart/ChartSelectionDetails": undefined; @@ -27664,6 +27990,8 @@ declare namespace sap { "sap/ui/mdc/enums/BaseType": undefined; + "sap/ui/mdc/enums/ChartActionPosition": undefined; + "sap/ui/mdc/enums/ChartP13nMode": undefined; "sap/ui/mdc/enums/ChartToolbarActionType": undefined; diff --git a/types/openui5/sap.ui.rta.d.ts b/types/openui5/sap.ui.rta.d.ts index a0683e8a86906d..ec99b9af5251ab 100644 --- a/types/openui5/sap.ui.rta.d.ts +++ b/types/openui5/sap.ui.rta.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/ui/rta/api/startAdaptation" { import Control from "sap/ui/core/Control"; diff --git a/types/openui5/sap.ui.suite.d.ts b/types/openui5/sap.ui.suite.d.ts index 8dc11cd3d66285..43caac34b4b29a 100644 --- a/types/openui5/sap.ui.suite.d.ts +++ b/types/openui5/sap.ui.suite.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/ui/suite/library" { /** diff --git a/types/openui5/sap.ui.support.d.ts b/types/openui5/sap.ui.support.d.ts index d375d86f24ff56..2613d02bea8308 100644 --- a/types/openui5/sap.ui.support.d.ts +++ b/types/openui5/sap.ui.support.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/ui/support/library" { /** diff --git a/types/openui5/sap.ui.table.d.ts b/types/openui5/sap.ui.table.d.ts index b5253cf5d3075d..a9b22204f0b644 100644 --- a/types/openui5/sap.ui.table.d.ts +++ b/types/openui5/sap.ui.table.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/ui/table/library" { import TreeAutoExpandMode1 from "sap/ui/model/TreeAutoExpandMode"; @@ -608,6 +608,8 @@ declare module "sap/ui/table/AnalyticalTable" { Table$GroupEventParameters, } from "sap/ui/table/Table"; + import AnalyticalColumn from "sap/ui/table/AnalyticalColumn"; + import { ID } from "sap/ui/core/library"; import ElementMetadata from "sap/ui/core/ElementMetadata"; @@ -903,6 +905,10 @@ declare module "sap/ui/table/AnalyticalTable" { * @returns Value of property `collapseRecursive` */ getCollapseRecursive(): boolean; + /** + * Returns the Columns of the AnalyticalTable. + */ + getColumns(): AnalyticalColumn[]; /** * Gets current value of property {@link #getColumnVisibilityMenuSorter columnVisibilityMenuSorter}. * diff --git a/types/openui5/sap.ui.testrecorder.d.ts b/types/openui5/sap.ui.testrecorder.d.ts index aa5ed3d805c66e..7f06327c2eb8d8 100644 --- a/types/openui5/sap.ui.testrecorder.d.ts +++ b/types/openui5/sap.ui.testrecorder.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/ui/testrecorder/library" {} diff --git a/types/openui5/sap.ui.unified.d.ts b/types/openui5/sap.ui.unified.d.ts index 87adfb5d183f84..7eb3fb7180b306 100644 --- a/types/openui5/sap.ui.unified.d.ts +++ b/types/openui5/sap.ui.unified.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/ui/unified/library" { /** @@ -5769,6 +5769,18 @@ declare module "sap/ui/unified/calendar/MonthsRow" { * @returns Value of property `showHeader` */ getShowHeader(): boolean; + /** + * Gets current value of property {@link #getShowWeekNumbers showWeekNumbers}. + * + * Determines if the week numbers are displayed. + * + * Default value is `false`. + * + * @since 1.145.0 + * + * @returns Value of property `showWeekNumbers` + */ + getShowWeekNumbers(): boolean; /** * Gets current value of property {@link #getSingleSelection singleSelection}. * @@ -6005,6 +6017,25 @@ declare module "sap/ui/unified/calendar/MonthsRow" { */ bShowHeader?: boolean ): this; + /** + * Sets a new value for property {@link #getShowWeekNumbers showWeekNumbers}. + * + * Determines if the week numbers are displayed. + * + * When called with a value of `null` or `undefined`, the default value of the property will be restored. + * + * Default value is `false`. + * + * @since 1.145.0 + * + * @returns Reference to `this` in order to allow method chaining + */ + setShowWeekNumbers( + /** + * New value for property `showWeekNumbers` + */ + bShowWeekNumbers?: boolean + ): this; /** * Sets a new value for property {@link #getSingleSelection singleSelection}. * @@ -6078,6 +6109,13 @@ declare module "sap/ui/unified/calendar/MonthsRow" { */ showHeader?: boolean | PropertyBindingInfo | `{${string}}`; + /** + * Determines if the week numbers are displayed. + * + * @since 1.145.0 + */ + showWeekNumbers?: boolean | PropertyBindingInfo | `{${string}}`; + /** * Date ranges for selected dates. If `singleSelection` is set, only the first entry is used. * diff --git a/types/openui5/sap.ui.ux3.d.ts b/types/openui5/sap.ui.ux3.d.ts index bf4aa786fa3a6c..4261560ad4ca6f 100644 --- a/types/openui5/sap.ui.ux3.d.ts +++ b/types/openui5/sap.ui.ux3.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/ui/ux3/library" { /** diff --git a/types/openui5/sap.ui.webc.common.d.ts b/types/openui5/sap.ui.webc.common.d.ts index 7a493363aa99b9..98313c39d26212 100644 --- a/types/openui5/sap.ui.webc.common.d.ts +++ b/types/openui5/sap.ui.webc.common.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/ui/webc/common/library" {} diff --git a/types/openui5/sap.ui.webc.fiori.d.ts b/types/openui5/sap.ui.webc.fiori.d.ts index 762b190a46a715..05081f2fcca6d7 100644 --- a/types/openui5/sap.ui.webc.fiori.d.ts +++ b/types/openui5/sap.ui.webc.fiori.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/ui/webc/fiori/library" { /** diff --git a/types/openui5/sap.ui.webc.main.d.ts b/types/openui5/sap.ui.webc.main.d.ts index 46749c807d5cc6..969a4e199e7daa 100644 --- a/types/openui5/sap.ui.webc.main.d.ts +++ b/types/openui5/sap.ui.webc.main.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/ui/webc/main/library" { /** diff --git a/types/openui5/sap.uxap.d.ts b/types/openui5/sap.uxap.d.ts index 834b309b9e9a17..e21dc0d3bee2b4 100644 --- a/types/openui5/sap.uxap.d.ts +++ b/types/openui5/sap.uxap.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.144.0 +// For Library Version: 1.145.0 declare module "sap/uxap/library" { /** @@ -7145,8 +7145,7 @@ declare module "sap/uxap/ObjectPageSection" { * * The list of Subsections. * - * Note: If multiple subsections are used, it is highly recommended to set a title for the section for accessibility - * reasons. + * **Note:** If you use multiple subsections, set a `title` for each subsection to avoid accessibility violations. */ getSubSections(): ObjectPageSubSection[]; /** @@ -7359,8 +7358,7 @@ declare module "sap/uxap/ObjectPageSection" { /** * The list of Subsections. * - * Note: If multiple subsections are used, it is highly recommended to set a title for the section for accessibility - * reasons. + * **Note:** If you use multiple subsections, set a `title` for each subsection to avoid accessibility violations. */ subSections?: | ObjectPageSubSection[] @@ -7514,9 +7512,13 @@ declare module "sap/uxap/ObjectPageSectionBase" { * Defines the title of the respective section/subsection. * * **Note:** If a subsection is the only one (or the only one visible) within a section, its title is displayed - * instead of the section title. This behavior is true even if the `showTitle` propeprty of {@link sap.uxap.ObjectPageSubSection } + * instead of the section title. This behavior is true even if the `showTitle` property of {@link sap.uxap.ObjectPageSubSection } * is set to `false`. * + * **Note:** To avoid accessibility issues, always set a `title` on {@link sap.uxap.ObjectPageSubSection}, + * especially when a section contains multiple subsections. If no `title` is set on a subsection, the anchor + * bar button popover will appear empty, which will lead to accessibility violations. + * * * @returns Value of property `title` */ @@ -7604,9 +7606,13 @@ declare module "sap/uxap/ObjectPageSectionBase" { * Defines the title of the respective section/subsection. * * **Note:** If a subsection is the only one (or the only one visible) within a section, its title is displayed - * instead of the section title. This behavior is true even if the `showTitle` propeprty of {@link sap.uxap.ObjectPageSubSection } + * instead of the section title. This behavior is true even if the `showTitle` property of {@link sap.uxap.ObjectPageSubSection } * is set to `false`. * + * **Note:** To avoid accessibility issues, always set a `title` on {@link sap.uxap.ObjectPageSubSection}, + * especially when a section contains multiple subsections. If no `title` is set on a subsection, the anchor + * bar button popover will appear empty, which will lead to accessibility violations. + * * When called with a value of `null` or `undefined`, the default value of the property will be restored. * * @@ -7676,8 +7682,12 @@ declare module "sap/uxap/ObjectPageSectionBase" { * Defines the title of the respective section/subsection. * * **Note:** If a subsection is the only one (or the only one visible) within a section, its title is displayed - * instead of the section title. This behavior is true even if the `showTitle` propeprty of {@link sap.uxap.ObjectPageSubSection } + * instead of the section title. This behavior is true even if the `showTitle` property of {@link sap.uxap.ObjectPageSubSection } * is set to `false`. + * + * **Note:** To avoid accessibility issues, always set a `title` on {@link sap.uxap.ObjectPageSubSection}, + * especially when a section contains multiple subsections. If no `title` is set on a subsection, the anchor + * bar button popover will appear empty, which will lead to accessibility violations. */ title?: string | PropertyBindingInfo;