diff --git a/types/openui5/openui5-tests.ts b/types/openui5/openui5-tests.ts index e9ed2c1980c046..d0c0e4215c8b8b 100644 --- a/types/openui5/openui5-tests.ts +++ b/types/openui5/openui5-tests.ts @@ -290,3 +290,5 @@ const p13nEngine = new Engine(); // 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 + +// version 1.146.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 c292d24fa5f6d3..e5f2dbea404256 100644 --- a/types/openui5/package.json +++ b/types/openui5/package.json @@ -1,7 +1,7 @@ { "private": true, "name": "@types/openui5", - "version": "1.145.9999", + "version": "1.146.9999", "nonNpm": true, "nonNpmDescription": "openui5", "projects": [ diff --git a/types/openui5/sap.f.d.ts b/types/openui5/sap.f.d.ts index 867536778f7bd7..903a969d1e8508 100644 --- a/types/openui5/sap.f.d.ts +++ b/types/openui5/sap.f.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.145.0 +// For Library Version: 1.146.0 declare module "sap/tnt/library" { export interface IToolHeader { @@ -434,8 +434,7 @@ declare module "sap/f/library" { * * This enum is part of the 'sap/f/library' module export and must be accessed by the property 'cards.SemanticRole'. * - * @since 1.131 - * @experimental + * @experimental As of version 1.131. */ enum SemanticRole { /** @@ -1815,8 +1814,6 @@ declare module "sap/f/cards/BaseHeader" { import { IBar, WrappingType } from "sap/m/library"; - import Text from "sap/m/Text"; - import Event from "sap/ui/base/Event"; import ElementMetadata from "sap/ui/core/ElementMetadata"; @@ -1893,24 +1890,9 @@ declare module "sap/f/cards/BaseHeader" { * @returns Metadata object describing this class */ static getMetadata(): ElementMetadata; - /** - * Adds some bannerLine to the aggregation {@link #getBannerLines bannerLines}. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns Reference to `this` in order to allow method chaining - */ - addBannerLine( - /** - * The bannerLine to add; if empty, nothing is inserted - */ - oBannerLine: Text - ): this; /** * Adds some infoSection to the aggregation {@link #getInfoSection infoSection}. * - * @since 1.136 * @experimental As of version 1.136. * * @returns Reference to `this` in order to allow method chaining @@ -1968,19 +1950,9 @@ declare module "sap/f/cards/BaseHeader" { */ oListener?: object ): this; - /** - * Destroys all the bannerLines in the aggregation {@link #getBannerLines bannerLines}. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns Reference to `this` in order to allow method chaining - */ - destroyBannerLines(): this; /** * Destroys all the infoSection in the aggregation {@link #getInfoSection infoSection}. * - * @since 1.136 * @experimental As of version 1.136. * * @returns Reference to `this` in order to allow method chaining @@ -1989,7 +1961,6 @@ declare module "sap/f/cards/BaseHeader" { /** * Destroys the toolbar in the aggregation {@link #getToolbar toolbar}. * - * @since 1.86 * @experimental As of version 1.86. * * @returns Reference to `this` in order to allow method chaining @@ -2026,15 +1997,6 @@ declare module "sap/f/cards/BaseHeader" { */ mParameters?: object ): this; - /** - * Gets content of aggregation {@link #getBannerLines bannerLines}. - * - * Show as a banner in the header area. Use for example for system info and application shortcut. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - */ - getBannerLines(): Text[]; /** * Gets current value of property {@link #getDataTimestamp dataTimestamp}. * @@ -2047,27 +2009,16 @@ declare module "sap/f/cards/BaseHeader" { * * Default value is `empty string`. * - * @experimental As of version 1.89. this feature is experimental and the API may change. + * @experimental As of version 1.89. * * @returns Value of property `dataTimestamp` */ getDataTimestamp(): string; - /** - * Gets current value of property {@link #getHref href}. - * - * Defines the href which the header should open. If set - the header will act and render as a link. - * - * @experimental As of version 1.122. Do not use this feature outside of sap.ui.integration.widgets.Card. - * - * @returns Value of property `href` - */ - getHref(): string; /** * Gets content of aggregation {@link #getInfoSection infoSection}. * * Info sections to be displayed in the header. * - * @since 1.136 * @experimental As of version 1.136. */ getInfoSection(): Control[]; @@ -2078,27 +2029,16 @@ declare module "sap/f/cards/BaseHeader" { * * Default value is `true`. * - * @experimental As of version 1.116. this feature is experimental and the API may change. + * @experimental As of version 1.116. * * @returns Value of property `statusVisible` */ getStatusVisible(): boolean; - /** - * Gets current value of property {@link #getTarget target}. - * - * Defines the target for the case when `href` is given. - * - * @experimental As of version 1.122. Do not use this feature outside of sap.ui.integration.widgets.Card. - * - * @returns Value of property `target` - */ - getTarget(): string; /** * Gets content of aggregation {@link #getToolbar toolbar}. * * Defines the toolbar. * - * @since 1.86 * @experimental As of version 1.86. */ getToolbar(): Control; @@ -2110,31 +2050,15 @@ declare module "sap/f/cards/BaseHeader" { * * Default value is `Normal`. * - * @experimental As of version 1.122. this feature is experimental and the API may change. + * @experimental As of version 1.122. * * @returns Value of property `wrappingType` */ getWrappingType(): WrappingType; - /** - * Checks for the provided `sap.m.Text` in the aggregation {@link #getBannerLines bannerLines}. and returns - * its index if found or -1 otherwise. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns The index of the provided control in the aggregation if found, or -1 otherwise - */ - indexOfBannerLine( - /** - * The bannerLine whose index is looked for - */ - oBannerLine: Text - ): int; /** * Checks for the provided `sap.ui.core.Control` in the aggregation {@link #getInfoSection infoSection}. * and returns its index if found or -1 otherwise. * - * @since 1.136 * @experimental As of version 1.136. * * @returns The index of the provided control in the aggregation if found, or -1 otherwise @@ -2145,30 +2069,9 @@ declare module "sap/f/cards/BaseHeader" { */ oInfoSection: Control ): int; - /** - * Inserts a bannerLine into the aggregation {@link #getBannerLines bannerLines}. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns Reference to `this` in order to allow method chaining - */ - insertBannerLine( - /** - * The bannerLine to insert; if empty, nothing is inserted - */ - oBannerLine: Text, - /** - * The `0`-based index the bannerLine should be inserted at; for a negative value of `iIndex`, the bannerLine - * is inserted at position 0; for a value greater than the current size of the aggregation, the bannerLine - * is inserted at the last position - */ - iIndex: int - ): this; /** * Inserts a infoSection into the aggregation {@link #getInfoSection infoSection}. * - * @since 1.136 * @experimental As of version 1.136. * * @returns Reference to `this` in order to allow method chaining @@ -2185,46 +2088,19 @@ declare module "sap/f/cards/BaseHeader" { */ iIndex: int ): this; - /** - * Removes all the controls from the aggregation {@link #getBannerLines bannerLines}. - * - * Additionally, it unregisters them from the hosting UIArea. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns An array of the removed elements (might be empty) - */ - removeAllBannerLines(): Text[]; /** * Removes all the controls from the aggregation {@link #getInfoSection infoSection}. * * Additionally, it unregisters them from the hosting UIArea. * - * @since 1.136 * @experimental As of version 1.136. * * @returns An array of the removed elements (might be empty) */ removeAllInfoSection(): Control[]; - /** - * Removes a bannerLine from the aggregation {@link #getBannerLines bannerLines}. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns The removed bannerLine or `null` - */ - removeBannerLine( - /** - * The bannerLine to remove or its index or id - */ - vBannerLine: int | string | Text - ): Text | null; /** * Removes a infoSection from the aggregation {@link #getInfoSection infoSection}. * - * @since 1.136 * @experimental As of version 1.136. * * @returns The removed infoSection or `null` @@ -2249,7 +2125,7 @@ declare module "sap/f/cards/BaseHeader" { * * Default value is `empty string`. * - * @experimental As of version 1.89. this feature is experimental and the API may change. + * @experimental As of version 1.89. * * @returns Reference to `this` in order to allow method chaining */ @@ -2259,23 +2135,6 @@ declare module "sap/f/cards/BaseHeader" { */ sDataTimestamp?: string ): this; - /** - * Sets a new value for property {@link #getHref href}. - * - * Defines the href which the header should open. If set - the header will act and render as a link. - * - * When called with a value of `null` or `undefined`, the default value of the property will be restored. - * - * @experimental As of version 1.122. Do not use this feature outside of sap.ui.integration.widgets.Card. - * - * @returns Reference to `this` in order to allow method chaining - */ - setHref( - /** - * New value for property `href` - */ - sHref: string - ): this; /** * Sets a new value for property {@link #getStatusVisible statusVisible}. * @@ -2285,7 +2144,7 @@ declare module "sap/f/cards/BaseHeader" { * * Default value is `true`. * - * @experimental As of version 1.116. this feature is experimental and the API may change. + * @experimental As of version 1.116. * * @returns Reference to `this` in order to allow method chaining */ @@ -2295,27 +2154,9 @@ declare module "sap/f/cards/BaseHeader" { */ bStatusVisible?: boolean ): this; - /** - * Sets a new value for property {@link #getTarget target}. - * - * Defines the target for the case when `href` is given. - * - * When called with a value of `null` or `undefined`, the default value of the property will be restored. - * - * @experimental As of version 1.122. Do not use this feature outside of sap.ui.integration.widgets.Card. - * - * @returns Reference to `this` in order to allow method chaining - */ - setTarget( - /** - * New value for property `target` - */ - sTarget: string - ): this; /** * Sets the aggregated {@link #getToolbar toolbar}. * - * @since 1.86 * @experimental As of version 1.86. * * @returns Reference to `this` in order to allow method chaining @@ -2336,7 +2177,7 @@ declare module "sap/f/cards/BaseHeader" { * * Default value is `Normal`. * - * @experimental As of version 1.122. this feature is experimental and the API may change. + * @experimental As of version 1.122. * * @returns Reference to `this` in order to allow method chaining */ @@ -2359,14 +2200,14 @@ declare module "sap/f/cards/BaseHeader" { * * Will be shown as a relative time like "5 minutes ago". * - * @experimental As of version 1.89. this feature is experimental and the API may change. + * @experimental As of version 1.89. */ dataTimestamp?: string | PropertyBindingInfo; /** * Defines the status text visibility. * - * @experimental As of version 1.116. this feature is experimental and the API may change. + * @experimental As of version 1.116. */ statusVisible?: boolean | PropertyBindingInfo | `{${string}}`; @@ -2374,31 +2215,16 @@ declare module "sap/f/cards/BaseHeader" { * Defines the type of text wrapping to be used inside the header. This applies to title, subtitle and details * texts of the header. * - * @experimental As of version 1.122. this feature is experimental and the API may change. + * @experimental As of version 1.122. */ wrappingType?: | (WrappingType | keyof typeof WrappingType) | PropertyBindingInfo | `{${string}}`; - /** - * Defines the href which the header should open. If set - the header will act and render as a link. - * - * @experimental As of version 1.122. Do not use this feature outside of sap.ui.integration.widgets.Card. - */ - href?: string | PropertyBindingInfo; - - /** - * Defines the target for the case when `href` is given. - * - * @experimental As of version 1.122. Do not use this feature outside of sap.ui.integration.widgets.Card. - */ - target?: string | PropertyBindingInfo; - /** * Info sections to be displayed in the header. * - * @since 1.136 * @experimental As of version 1.136. */ infoSection?: Control[] | Control | AggregationBindingInfo | `{${string}}`; @@ -2406,19 +2232,10 @@ declare module "sap/f/cards/BaseHeader" { /** * Defines the toolbar. * - * @since 1.86 * @experimental As of version 1.86. */ toolbar?: Control; - /** - * Show as a banner in the header area. Use for example for system info and application shortcut. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - */ - bannerLines?: Text[] | Text | AggregationBindingInfo | `{${string}}`; - /** * Fires when the user presses the control. */ @@ -2853,7 +2670,7 @@ declare module "sap/f/cards/Header" { * * Default value is `empty string`. * - * @experimental As of version 1.81. this feature is experimental and the API may change. + * @experimental As of version 1.81. * * @returns Value of property `iconAlt` */ @@ -2865,7 +2682,7 @@ declare module "sap/f/cards/Header" { * * Default value is `Transparent`. * - * @experimental As of version 1.83. this feature is experimental and the API may change. + * @experimental As of version 1.83. * * @returns Value of property `iconBackgroundColor` */ @@ -2911,7 +2728,7 @@ declare module "sap/f/cards/Header" { * * Default value is `S`. * - * @experimental As of version 1.119. this feature is experimental and the API may change. + * @experimental As of version 1.119. * * @returns Value of property `iconSize` */ @@ -2946,7 +2763,7 @@ declare module "sap/f/cards/Header" { * * Default value is `true`. * - * @experimental As of version 1.83. this feature is experimental and the API may change. + * @experimental As of version 1.83. * * @returns Value of property `iconVisible` */ @@ -3017,7 +2834,7 @@ declare module "sap/f/cards/Header" { * * Default value is `empty string`. * - * @experimental As of version 1.81. this feature is experimental and the API may change. + * @experimental As of version 1.81. * * @returns Reference to `this` in order to allow method chaining */ @@ -3036,7 +2853,7 @@ declare module "sap/f/cards/Header" { * * Default value is `Transparent`. * - * @experimental As of version 1.83. this feature is experimental and the API may change. + * @experimental As of version 1.83. * * @returns Reference to `this` in order to allow method chaining */ @@ -3110,7 +2927,7 @@ declare module "sap/f/cards/Header" { * * Default value is `S`. * - * @experimental As of version 1.119. this feature is experimental and the API may change. + * @experimental As of version 1.119. * * @returns Reference to `this` in order to allow method chaining */ @@ -3166,7 +2983,7 @@ declare module "sap/f/cards/Header" { * * Default value is `true`. * - * @experimental As of version 1.83. this feature is experimental and the API may change. + * @experimental As of version 1.83. * * @returns Reference to `this` in order to allow method chaining */ @@ -3329,14 +3146,14 @@ declare module "sap/f/cards/Header" { /** * Defines an alt text for the avatar or icon. * - * @experimental As of version 1.81. this feature is experimental and the API may change. + * @experimental As of version 1.81. */ iconAlt?: string | PropertyBindingInfo; /** * Defines a background color for the avatar or icon. * - * @experimental As of version 1.83. this feature is experimental and the API may change. + * @experimental As of version 1.83. */ iconBackgroundColor?: | (AvatarColor | keyof typeof AvatarColor) @@ -3346,14 +3163,14 @@ declare module "sap/f/cards/Header" { /** * Defines whether the card icon is visible. * - * @experimental As of version 1.83. this feature is experimental and the API may change. + * @experimental As of version 1.83. */ iconVisible?: boolean | PropertyBindingInfo | `{${string}}`; /** * Defines the size of the icon. * - * @experimental As of version 1.119. this feature is experimental and the API may change. + * @experimental As of version 1.119. */ iconSize?: | (AvatarSize | keyof typeof AvatarSize) @@ -3438,12 +3255,6 @@ declare module "sap/f/cards/NumericHeader" { import Control from "sap/ui/core/Control"; - import { ValueState, URI } from "sap/ui/core/library"; - - import AvatarColor from "sap/m/AvatarColor"; - - import AvatarShape from "sap/m/AvatarShape"; - import AvatarImageFitType from "sap/m/AvatarImageFitType"; import AvatarSize from "sap/m/AvatarSize"; @@ -3606,58 +3417,6 @@ declare module "sap/f/cards/NumericHeader" { * @returns Value of property `detailsMaxLines` */ getDetailsMaxLines(): int; - /** - * Gets current value of property {@link #getDetailsState detailsState}. - * - * The semantic color which represents the state of the details text. - * - * Default value is `None`. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns Value of property `detailsState` - */ - getDetailsState(): ValueState; - /** - * Gets current value of property {@link #getIconAlt iconAlt}. - * - * Defines an alt text for the avatar or icon. - * - * Default value is `empty string`. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns Value of property `iconAlt` - */ - getIconAlt(): string; - /** - * Gets current value of property {@link #getIconBackgroundColor iconBackgroundColor}. - * - * Defines a background color for the avatar or icon. - * - * Default value is `Transparent`. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns Value of property `iconBackgroundColor` - */ - getIconBackgroundColor(): AvatarColor; - /** - * Gets current value of property {@link #getIconDisplayShape iconDisplayShape}. - * - * Defines the shape of the icon. - * - * Default value is `Circle`. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns Value of property `iconDisplayShape` - */ - getIconDisplayShape(): AvatarShape; /** * Gets current value of property {@link #getIconFitType iconFitType}. * @@ -3670,19 +3429,6 @@ declare module "sap/f/cards/NumericHeader" { * @returns Value of property `iconFitType` */ getIconFitType(): AvatarImageFitType; - /** - * Gets current value of property {@link #getIconInitials iconInitials}. - * - * Defines the initials of the icon. - * - * Default value is `empty string`. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns Value of property `iconInitials` - */ - getIconInitials(): string; /** * Gets current value of property {@link #getIconSize iconSize}. * @@ -3690,37 +3436,11 @@ declare module "sap/f/cards/NumericHeader" { * * Default value is `S`. * - * @experimental As of version 1.119. this feature is experimental and the API may change. + * @experimental As of version 1.119. * * @returns Value of property `iconSize` */ getIconSize(): AvatarSize; - /** - * Gets current value of property {@link #getIconSrc iconSrc}. - * - * Defines the icon source. - * - * Default value is `empty string`. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns Value of property `iconSrc` - */ - getIconSrc(): URI; - /** - * Gets current value of property {@link #getIconVisible iconVisible}. - * - * Defines whether the card icon is visible. - * - * Default value is `true`. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns Value of property `iconVisible` - */ - getIconVisible(): boolean; /** * Gets content of aggregation {@link #getMicroChart microChart}. * @@ -3742,7 +3462,7 @@ declare module "sap/f/cards/NumericHeader" { /** * Gets current value of property {@link #getNumberSize numberSize}. * - * The size of the of the main indicator. Possible values are "S" and "L". + * The size of the main indicator. Possible values are "S" and "L". * * Default value is `"L"`. * @@ -3798,8 +3518,7 @@ declare module "sap/f/cards/NumericHeader" { * * Default value is `"Neutral"`. * - * @experimental As of version 1.64. Disclaimer: this property is in a beta state - incompatible API changes - * may be done before its official public release. Use at your own discretion. + * @experimental As of version 1.64. * * @returns Value of property `state` */ @@ -3964,86 +3683,6 @@ declare module "sap/f/cards/NumericHeader" { */ iDetailsMaxLines?: int ): this; - /** - * Sets a new value for property {@link #getDetailsState detailsState}. - * - * The semantic color which represents the state of the details text. - * - * When called with a value of `null` or `undefined`, the default value of the property will be restored. - * - * Default value is `None`. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns Reference to `this` in order to allow method chaining - */ - setDetailsState( - /** - * New value for property `detailsState` - */ - sDetailsState?: ValueState | keyof typeof ValueState - ): this; - /** - * Sets a new value for property {@link #getIconAlt iconAlt}. - * - * Defines an alt text for the avatar or icon. - * - * When called with a value of `null` or `undefined`, the default value of the property will be restored. - * - * Default value is `empty string`. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns Reference to `this` in order to allow method chaining - */ - setIconAlt( - /** - * New value for property `iconAlt` - */ - sIconAlt?: string - ): this; - /** - * Sets a new value for property {@link #getIconBackgroundColor iconBackgroundColor}. - * - * Defines a background color for the avatar or icon. - * - * When called with a value of `null` or `undefined`, the default value of the property will be restored. - * - * Default value is `Transparent`. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns Reference to `this` in order to allow method chaining - */ - setIconBackgroundColor( - /** - * New value for property `iconBackgroundColor` - */ - sIconBackgroundColor?: AvatarColor | keyof typeof AvatarColor - ): this; - /** - * Sets a new value for property {@link #getIconDisplayShape iconDisplayShape}. - * - * Defines the shape of the icon. - * - * When called with a value of `null` or `undefined`, the default value of the property will be restored. - * - * Default value is `Circle`. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns Reference to `this` in order to allow method chaining - */ - setIconDisplayShape( - /** - * New value for property `iconDisplayShape` - */ - sIconDisplayShape?: AvatarShape | keyof typeof AvatarShape - ): this; /** * Sets a new value for property {@link #getIconFitType iconFitType}. * @@ -4063,26 +3702,6 @@ declare module "sap/f/cards/NumericHeader" { */ sIconFitType?: AvatarImageFitType | keyof typeof AvatarImageFitType ): this; - /** - * Sets a new value for property {@link #getIconInitials iconInitials}. - * - * Defines the initials of the icon. - * - * When called with a value of `null` or `undefined`, the default value of the property will be restored. - * - * Default value is `empty string`. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns Reference to `this` in order to allow method chaining - */ - setIconInitials( - /** - * New value for property `iconInitials` - */ - sIconInitials?: string - ): this; /** * Sets a new value for property {@link #getIconSize iconSize}. * @@ -4092,7 +3711,7 @@ declare module "sap/f/cards/NumericHeader" { * * Default value is `S`. * - * @experimental As of version 1.119. this feature is experimental and the API may change. + * @experimental As of version 1.119. * * @returns Reference to `this` in order to allow method chaining */ @@ -4102,46 +3721,6 @@ declare module "sap/f/cards/NumericHeader" { */ sIconSize?: AvatarSize | keyof typeof AvatarSize ): this; - /** - * Sets a new value for property {@link #getIconSrc iconSrc}. - * - * Defines the icon source. - * - * When called with a value of `null` or `undefined`, the default value of the property will be restored. - * - * Default value is `empty string`. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns Reference to `this` in order to allow method chaining - */ - setIconSrc( - /** - * New value for property `iconSrc` - */ - sIconSrc?: URI - ): this; - /** - * Sets a new value for property {@link #getIconVisible iconVisible}. - * - * Defines whether the card icon is visible. - * - * When called with a value of `null` or `undefined`, the default value of the property will be restored. - * - * Default value is `true`. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - * - * @returns Reference to `this` in order to allow method chaining - */ - setIconVisible( - /** - * New value for property `iconVisible` - */ - bIconVisible?: boolean - ): this; /** * Sets the aggregated {@link #getMicroChart microChart}. * @@ -4175,7 +3754,7 @@ declare module "sap/f/cards/NumericHeader" { /** * Sets a new value for property {@link #getNumberSize numberSize}. * - * The size of the of the main indicator. Possible values are "S" and "L". + * The size of the main indicator. Possible values are "S" and "L". * * When called with a value of `null` or `undefined`, the default value of the property will be restored. * @@ -4256,8 +3835,7 @@ declare module "sap/f/cards/NumericHeader" { * * Default value is `"Neutral"`. * - * @experimental As of version 1.64. Disclaimer: this property is in a beta state - incompatible API changes - * may be done before its official public release. Use at your own discretion. + * @experimental As of version 1.64. * * @returns Reference to `this` in order to allow method chaining */ @@ -4429,64 +4007,10 @@ declare module "sap/f/cards/NumericHeader" { */ statusText?: string | PropertyBindingInfo; - /** - * Defines the shape of the icon. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - */ - iconDisplayShape?: - | (AvatarShape | keyof typeof AvatarShape) - | PropertyBindingInfo - | `{${string}}`; - - /** - * Defines the icon source. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - */ - iconSrc?: URI | PropertyBindingInfo | `{${string}}`; - - /** - * Defines the initials of the icon. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - */ - iconInitials?: string | PropertyBindingInfo; - - /** - * Defines an alt text for the avatar or icon. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - */ - iconAlt?: string | PropertyBindingInfo; - - /** - * Defines a background color for the avatar or icon. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - */ - iconBackgroundColor?: - | (AvatarColor | keyof typeof AvatarColor) - | PropertyBindingInfo - | `{${string}}`; - - /** - * Defines whether the card icon is visible. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - */ - iconVisible?: boolean | PropertyBindingInfo | `{${string}}`; - /** * Defines the size of the icon. * - * @experimental As of version 1.119. this feature is experimental and the API may change. + * @experimental As of version 1.119. */ iconSize?: | (AvatarSize | keyof typeof AvatarSize) @@ -4515,7 +4039,7 @@ declare module "sap/f/cards/NumericHeader" { number?: string | PropertyBindingInfo; /** - * The size of the of the main indicator. Possible values are "S" and "L". + * The size of the main indicator. Possible values are "S" and "L". */ numberSize?: string | PropertyBindingInfo; @@ -4544,8 +4068,7 @@ declare module "sap/f/cards/NumericHeader" { /** * The semantic color which represents the state of the main number indicator. * - * @experimental As of version 1.64. Disclaimer: this property is in a beta state - incompatible API changes - * may be done before its official public release. Use at your own discretion. + * @experimental As of version 1.64. */ state?: | (ValueColor | keyof typeof ValueColor) @@ -4557,17 +4080,6 @@ declare module "sap/f/cards/NumericHeader" { */ details?: string | PropertyBindingInfo; - /** - * The semantic color which represents the state of the details text. - * - * @since 1.118 - * @experimental As of version 1.118. For usage only by Work Zone. - */ - detailsState?: - | (ValueState | keyof typeof ValueState) - | PropertyBindingInfo - | `{${string}}`; - /** * Limits the number of lines for the details. * @@ -4698,8 +4210,7 @@ declare module "sap/f/cards/NumericSideIndicator" { * * Default value is `"None"`. * - * @experimental As of version 1.95. Disclaimer: this property is in a beta state - incompatible API changes - * may be done before its official public release. Use at your own discretion. + * @experimental As of version 1.95. * * @returns Value of property `state` */ @@ -4743,8 +4254,7 @@ declare module "sap/f/cards/NumericSideIndicator" { * * Default value is `"None"`. * - * @experimental As of version 1.95. Disclaimer: this property is in a beta state - incompatible API changes - * may be done before its official public release. Use at your own discretion. + * @experimental As of version 1.95. * * @returns Reference to `this` in order to allow method chaining */ @@ -4801,8 +4311,7 @@ declare module "sap/f/cards/NumericSideIndicator" { /** * The semantic color which represents the state of the side indicator. * - * @experimental As of version 1.95. Disclaimer: this property is in a beta state - incompatible API changes - * may be done before its official public release. Use at your own discretion. + * @experimental As of version 1.95. */ state?: | (ValueColor | keyof typeof ValueColor) @@ -23471,6 +22980,8 @@ declare module "sap/f/SidePanelItem" { import ElementMetadata from "sap/ui/core/ElementMetadata"; + import Title from "sap/m/Title"; + import { PropertyBindingInfo, AggregationBindingInfo, @@ -23565,6 +23076,14 @@ declare module "sap/f/SidePanelItem" { * @returns Reference to `this` in order to allow method chaining */ destroyContent(): this; + /** + * Destroys the title in the aggregation {@link #getTitle title}. + * + * @since 1.146 + * + * @returns Reference to `this` in order to allow method chaining + */ + destroyTitle(): this; /** * Gets content of aggregation {@link #getContent content}. * @@ -23582,6 +23101,14 @@ declare module "sap/f/SidePanelItem" { * @returns Value of property `icon` */ getIcon(): URI; + /** + * Gets content of aggregation {@link #getTitle title}. + * + * The title of the action item. If not set, the title of the parent side panel will be used. + * + * @since 1.146 + */ + getTitle(): Title; /** * Checks for the provided `sap.ui.core.Control` in the aggregation {@link #getContent content}. and returns * its index if found or -1 otherwise. @@ -23652,6 +23179,19 @@ declare module "sap/f/SidePanelItem" { */ sIcon?: URI ): this; + /** + * Sets the aggregated {@link #getTitle title}. + * + * @since 1.146 + * + * @returns Reference to `this` in order to allow method chaining + */ + setTitle( + /** + * The title to set + */ + oTitle: Title + ): this; } /** * Describes the settings that can be provided to the SidePanelItem constructor. @@ -23662,6 +23202,13 @@ declare module "sap/f/SidePanelItem" { */ icon?: URI | PropertyBindingInfo | `{${string}}`; + /** + * The title of the action item. If not set, the title of the parent side panel will be used. + * + * @since 1.146 + */ + title?: Title; + /** * The list of controls for side content of the action item. */ diff --git a/types/openui5/sap.m.d.ts b/types/openui5/sap.m.d.ts index 6f7e0c2ac6a61d..e5c3499dc2154f 100644 --- a/types/openui5/sap.m.d.ts +++ b/types/openui5/sap.m.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.145.0 +// For Library Version: 1.146.0 declare module "sap/f/library" { export interface IShellBar { @@ -1658,8 +1658,6 @@ declare module "sap/m/library" { * feature works under the Browser's Cross-Origin Resource Sharing (CORS) policy. This means that a web * application using those APIs can only request resources from the same origin the application was loaded * from unless the response from other origins includes the right CORS headers. - * - * @experimental As of version 1.106. */ InlineSvg = "InlineSvg", } @@ -12154,6 +12152,8 @@ declare module "sap/m/Carousel" { * the navigation arrows. * - On desktop, navigation is done with the navigation arrows. * - The paging indicator (when activated) is visible on each form factor. + * - When using {@link sap.m.CarouselLayout CarouselLayout} with the `responsive` property set to `true`, + * the number of visible pages adjusts automatically based on the available width and the specified `minPageWidth`. */ export default class Carousel extends Control { /** @@ -13383,6 +13383,41 @@ declare module "sap/m/CarouselLayout" { * @returns Metadata object describing this class */ static getMetadata(): ManagedObjectMetadata; + /** + * Gets current value of property {@link #getMinPageWidth minPageWidth}. + * + * Defines the minimum width, in pixels, for each page to be displayed in the `Carousel` control. + * + * This property is used as a constraint when `responsive` mode is enabled, ensuring that pages are never + * rendered smaller than this specified width. The carousel automatically calculates the number of pages + * that can fit within the available viewport while respecting the specified minimum width requirement. + * + * **Note:** This property is only effective when the `responsive` property is set to `true`. + * + * Default value is `148`. + * + * + * @returns Value of property `minPageWidth` + */ + getMinPageWidth(): int; + /** + * Gets current value of property {@link #getResponsive responsive}. + * + * Activates the responsive layout mode, where the number of visible carousel pages automatically adjusts + * based on the available width and the specified page width. + * + * When this option is enabled, the carousel dynamically calculates and displays as many items as can fit + * within the viewport while adhering to the `minPageWidth` constraint. + * + * **Note:** Enabling this option overrides the `visiblePagesCount` property and disables the `loop` functionality + * of the carousel. + * + * Default value is `false`. + * + * + * @returns Value of property `responsive` + */ + getResponsive(): boolean; /** * Gets current value of property {@link #getScrollMode scrollMode}. * @@ -13405,15 +13440,66 @@ declare module "sap/m/CarouselLayout" { * Defines how many pages are displayed in the visible area of the `Carousel` control. Value should be a * positive number. * - * **Note:** When this property is set to something different than the default value, the `loop` property + * **Note:** When this property is set to something different from the default value, the `loop` property * of `Carousel` is ignored. * + * **Note:** This property is ignored when the `responsive` property is set to `true`. + * * Default value is `1`. * * * @returns Value of property `visiblePagesCount` */ getVisiblePagesCount(): int; + /** + * Sets a new value for property {@link #getMinPageWidth minPageWidth}. + * + * Defines the minimum width, in pixels, for each page to be displayed in the `Carousel` control. + * + * This property is used as a constraint when `responsive` mode is enabled, ensuring that pages are never + * rendered smaller than this specified width. The carousel automatically calculates the number of pages + * that can fit within the available viewport while respecting the specified minimum width requirement. + * + * **Note:** This property is only effective when the `responsive` property is set to `true`. + * + * When called with a value of `null` or `undefined`, the default value of the property will be restored. + * + * Default value is `148`. + * + * + * @returns Reference to `this` in order to allow method chaining + */ + setMinPageWidth( + /** + * New value for property `minPageWidth` + */ + iMinPageWidth?: int + ): this; + /** + * Sets a new value for property {@link #getResponsive responsive}. + * + * Activates the responsive layout mode, where the number of visible carousel pages automatically adjusts + * based on the available width and the specified page width. + * + * When this option is enabled, the carousel dynamically calculates and displays as many items as can fit + * within the viewport while adhering to the `minPageWidth` constraint. + * + * **Note:** Enabling this option overrides the `visiblePagesCount` property and disables the `loop` functionality + * of the carousel. + * + * When called with a value of `null` or `undefined`, the default value of the property will be restored. + * + * Default value is `false`. + * + * + * @returns Reference to `this` in order to allow method chaining + */ + setResponsive( + /** + * New value for property `responsive` + */ + bResponsive?: boolean + ): this; /** * Sets a new value for property {@link #getScrollMode scrollMode}. * @@ -13443,9 +13529,11 @@ declare module "sap/m/CarouselLayout" { * Defines how many pages are displayed in the visible area of the `Carousel` control. Value should be a * positive number. * - * **Note:** When this property is set to something different than the default value, the `loop` property + * **Note:** When this property is set to something different from the default value, the `loop` property * of `Carousel` is ignored. * + * **Note:** This property is ignored when the `responsive` property is set to `true`. + * * When called with a value of `null` or `undefined`, the default value of the property will be restored. * * Default value is `1`. @@ -13468,8 +13556,10 @@ declare module "sap/m/CarouselLayout" { * Defines how many pages are displayed in the visible area of the `Carousel` control. Value should be a * positive number. * - * **Note:** When this property is set to something different than the default value, the `loop` property + * **Note:** When this property is set to something different from the default value, the `loop` property * of `Carousel` is ignored. + * + * **Note:** This property is ignored when the `responsive` property is set to `true`. */ visiblePagesCount?: int | PropertyBindingInfo | `{${string}}`; @@ -13486,6 +13576,29 @@ declare module "sap/m/CarouselLayout" { | (CarouselScrollMode | keyof typeof CarouselScrollMode) | PropertyBindingInfo | `{${string}}`; + + /** + * Activates the responsive layout mode, where the number of visible carousel pages automatically adjusts + * based on the available width and the specified page width. + * + * When this option is enabled, the carousel dynamically calculates and displays as many items as can fit + * within the viewport while adhering to the `minPageWidth` constraint. + * + * **Note:** Enabling this option overrides the `visiblePagesCount` property and disables the `loop` functionality + * of the carousel. + */ + responsive?: boolean | PropertyBindingInfo | `{${string}}`; + + /** + * Defines the minimum width, in pixels, for each page to be displayed in the `Carousel` control. + * + * This property is used as a constraint when `responsive` mode is enabled, ensuring that pages are never + * rendered smaller than this specified width. The carousel automatically calculates the number of pages + * that can fit within the available viewport while respecting the specified minimum width requirement. + * + * **Note:** This property is only effective when the `responsive` property is set to `true`. + */ + minPageWidth?: int | PropertyBindingInfo | `{${string}}`; } } @@ -32977,6 +33090,7 @@ declare module "sap/m/FormattedText" { * - `strong` * - `span` * - `u` + * - `s` * - `dl` * - `dt` * - `dd` @@ -33262,6 +33376,7 @@ declare module "sap/m/FormattedText" { * - `strong` * - `span` * - `u` + * - `s` * - `dl` * - `dt` * - `dd` @@ -38295,8 +38410,7 @@ declare module "sap/m/IconTabFilter" { * * Default value is `Auto`. * - * @experimental As of version 1.121. Disclaimer: this property is in a beta state - incompatible API changes - * may be done before its official public release. Use at your own discretion. + * @experimental As of version 1.121. * * @returns Value of property `interactionMode` */ @@ -38599,8 +38713,7 @@ declare module "sap/m/IconTabFilter" { * * Default value is `Auto`. * - * @experimental As of version 1.121. Disclaimer: this property is in a beta state - incompatible API changes - * may be done before its official public release. Use at your own discretion. + * @experimental As of version 1.121. * * @returns Reference to `this` in order to allow method chaining */ @@ -38711,8 +38824,7 @@ declare module "sap/m/IconTabFilter" { /** * Specifies the interaction mode. * - * @experimental As of version 1.121. Disclaimer: this property is in a beta state - incompatible API changes - * may be done before its official public release. Use at your own discretion. + * @experimental As of version 1.121. */ interactionMode?: | ( @@ -55975,6 +56087,55 @@ declare module "sap/m/Menu" { */ oListener?: object ): this; + /** + * Attaches event handler `fnFunction` to the {@link #event:open open} event of this `sap.m.Menu`. + * + * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified, + * otherwise it will be bound to this `sap.m.Menu` itself. + * + * Fired when the menu is opened. + * + * @since 1.146 + * + * @returns Reference to `this` in order to allow method chaining + */ + attachOpen( + /** + * An application-specific payload object that will be passed to the event handler along with the event + * object when firing the event + */ + oData: object, + /** + * The function to be called when the event occurs + */ + fnFunction: (p1: Event) => void, + /** + * Context object to call the event handler with. Defaults to this `sap.m.Menu` itself + */ + oListener?: object + ): this; + /** + * Attaches event handler `fnFunction` to the {@link #event:open open} event of this `sap.m.Menu`. + * + * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified, + * otherwise it will be bound to this `sap.m.Menu` itself. + * + * Fired when the menu is opened. + * + * @since 1.146 + * + * @returns Reference to `this` in order to allow method chaining + */ + attachOpen( + /** + * The function to be called when the event occurs + */ + fnFunction: (p1: Event) => void, + /** + * Context object to call the event handler with. Defaults to this `sap.m.Menu` itself + */ + oListener?: object + ): this; /** * Binds aggregation {@link #getItems items} to model data. * @@ -56064,6 +56225,25 @@ declare module "sap/m/Menu" { */ oListener?: object ): this; + /** + * Detaches event handler `fnFunction` from the {@link #event:open open} event of this `sap.m.Menu`. + * + * The passed function and listener object must match the ones used for event registration. + * + * @since 1.146 + * + * @returns Reference to `this` in order to allow method chaining + */ + detachOpen( + /** + * The function to be called, when the event occurs + */ + fnFunction: (p1: Event) => void, + /** + * Context object on which the given function had to be called + */ + oListener?: object + ): this; /** * Fires event {@link #event:beforeClose beforeClose} to attached listeners. * @@ -56107,6 +56287,20 @@ declare module "sap/m/Menu" { */ mParameters?: Menu$ItemSelectedEventParameters ): this; + /** + * Fires event {@link #event:open open} to attached listeners. + * + * @since 1.146 + * @ui5-protected Do not call from applications (only from related classes in the framework) + * + * @returns Reference to `this` in order to allow method chaining + */ + fireOpen( + /** + * Parameters to pass along with the event + */ + mParameters?: object + ): this; /** * Gets content of aggregation {@link #getItems items}. * @@ -56265,6 +56459,13 @@ declare module "sap/m/Menu" { */ closed?: (oEvent: Event) => void; + /** + * Fired when the menu is opened. + * + * @since 1.146 + */ + open?: (oEvent: Event) => void; + /** * Fired before the menu is closed. This event can be prevented which effectively prevents the menu from * closing. @@ -56319,6 +56520,16 @@ declare module "sap/m/Menu" { Menu$ItemSelectedEventParameters, Menu >; + + /** + * Parameters of the Menu#open event. + */ + export interface Menu$OpenEventParameters {} + + /** + * Event object of the Menu#open event. + */ + export type Menu$OpenEvent = Event; } declare module "sap/m/MenuButton" { @@ -140342,8 +140553,7 @@ declare module "sap/m/Table" { /** * Gets current value of property {@link #getAlternateRowColors alternateRowColors}. * - * Enables alternating table row colors. **Note:** This property can only be used with the Belize and Belize - * Deep themes. Alternate row coloring is not available for the High Contrast Black/White themes. + * Enables alternating table row colors. * * Default value is `false`. * @@ -140566,8 +140776,7 @@ declare module "sap/m/Table" { /** * Sets a new value for property {@link #getAlternateRowColors alternateRowColors}. * - * Enables alternating table row colors. **Note:** This property can only be used with the Belize and Belize - * Deep themes. Alternate row coloring is not available for the High Contrast Black/White themes. + * Enables alternating table row colors. * * When called with a value of `null` or `undefined`, the default value of the property will be restored. * @@ -140843,8 +141052,7 @@ declare module "sap/m/Table" { showOverlay?: boolean | PropertyBindingInfo | `{${string}}`; /** - * Enables alternating table row colors. **Note:** This property can only be used with the Belize and Belize - * Deep themes. Alternate row coloring is not available for the High Contrast Black/White themes. + * Enables alternating table row colors. * * @since 1.52 */ @@ -169784,6 +169992,53 @@ declare module "sap/m/VariantManagement" { */ oListener?: object ): this; + /** + * Attaches event handler `fnFunction` to the {@link #event:manageOpen manageOpen} event of this `sap.m.VariantManagement`. + * + * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified, + * otherwise it will be bound to this `sap.m.VariantManagement` itself. + * + * This event is fired when users opens the Manage Views dialog. + * + * + * @returns Reference to `this` in order to allow method chaining + */ + attachManageOpen( + /** + * An application-specific payload object that will be passed to the event handler along with the event + * object when firing the event + */ + oData: object, + /** + * The function to be called when the event occurs + */ + fnFunction: (p1: Event) => void, + /** + * Context object to call the event handler with. Defaults to this `sap.m.VariantManagement` itself + */ + oListener?: object + ): this; + /** + * Attaches event handler `fnFunction` to the {@link #event:manageOpen manageOpen} event of this `sap.m.VariantManagement`. + * + * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified, + * otherwise it will be bound to this `sap.m.VariantManagement` itself. + * + * This event is fired when users opens the Manage Views dialog. + * + * + * @returns Reference to `this` in order to allow method chaining + */ + attachManageOpen( + /** + * The function to be called when the event occurs + */ + fnFunction: (p1: Event) => void, + /** + * Context object to call the event handler with. Defaults to this `sap.m.VariantManagement` itself + */ + oListener?: object + ): this; /** * Attaches event handler `fnFunction` to the {@link #event:save save} event of this `sap.m.VariantManagement`. * @@ -169939,6 +170194,24 @@ declare module "sap/m/VariantManagement" { */ oListener?: object ): this; + /** + * Detaches event handler `fnFunction` from the {@link #event:manageOpen manageOpen} event of this `sap.m.VariantManagement`. + * + * The passed function and listener object must match the ones used for event registration. + * + * + * @returns Reference to `this` in order to allow method chaining + */ + detachManageOpen( + /** + * The function to be called, when the event occurs + */ + fnFunction: (p1: Event) => void, + /** + * Context object on which the given function had to be called + */ + oListener?: object + ): this; /** * Detaches event handler `fnFunction` from the {@link #event:save save} event of this `sap.m.VariantManagement`. * @@ -170014,6 +170287,19 @@ declare module "sap/m/VariantManagement" { */ mParameters?: object ): this; + /** + * Fires event {@link #event:manageOpen manageOpen} to attached listeners. + * + * @ui5-protected Do not call from applications (only from related classes in the framework) + * + * @returns Reference to `this` in order to allow method chaining + */ + fireManageOpen( + /** + * Parameters to pass along with the event + */ + mParameters?: object + ): this; /** * Fires event {@link #event:save save} to attached listeners. * @@ -170744,6 +171030,11 @@ declare module "sap/m/VariantManagement" { */ manageCancel?: (oEvent: Event) => void; + /** + * This event is fired when users opens the Manage Views dialog. + */ + manageOpen?: (oEvent: Event) => void; + /** * This event is fired when users apply changes variant information in the Manage Views dialog. Some * of the parameters may be ommitted, depending on user selection. @@ -170827,6 +171118,19 @@ declare module "sap/m/VariantManagement" { VariantManagement >; + /** + * Parameters of the VariantManagement#manageOpen event. + */ + export interface VariantManagement$ManageOpenEventParameters {} + + /** + * Event object of the VariantManagement#manageOpen event. + */ + export type VariantManagement$ManageOpenEvent = Event< + VariantManagement$ManageOpenEventParameters, + VariantManagement + >; + /** * Parameters of the VariantManagement#save event. */ diff --git a/types/openui5/sap.tnt.d.ts b/types/openui5/sap.tnt.d.ts index ca9afc2fe318c3..c07ab62090303e 100644 --- a/types/openui5/sap.tnt.d.ts +++ b/types/openui5/sap.tnt.d.ts @@ -1,4 +1,4 @@ -// For Library Version: 1.145.0 +// For Library Version: 1.146.0 declare module "sap/tnt/library" { /** @@ -18,7 +18,6 @@ declare module "sap/tnt/library" { * This enum is part of the 'sap/tnt/library' module export and must be accessed by the property 'NavigationListItemDesign'. * * @since 1.133.0 - * @experimental Behavior might change. */ export enum NavigationListItemDesign { /** @@ -51,7 +50,6 @@ declare module "sap/tnt/library" { * This enum is part of the 'sap/tnt/library' module export and must be accessed by the property 'SideNavigationDesign'. * * @since 1.134.0 - * @experimental Behavior might change. */ export enum SideNavigationDesign { /** @@ -1664,7 +1662,6 @@ declare module "sap/tnt/NavigationListItem" { * Default value is `Default`. * * @since 1.133.0 - * @experimental Behavior might change. * * @returns Value of property `design` */ @@ -1716,8 +1713,6 @@ declare module "sap/tnt/NavigationListItem" { * Default value is `true`. * * @since 1.116 - * @experimental As of version 1.116. Disclaimer: this property is in a beta state - incompatible API changes - * may be done before its official public release. * * @returns Value of property `selectable` */ @@ -1833,7 +1828,6 @@ declare module "sap/tnt/NavigationListItem" { * Default value is `Default`. * * @since 1.133.0 - * @experimental Behavior might change. * * @returns Reference to `this` in order to allow method chaining */ @@ -1900,8 +1894,6 @@ declare module "sap/tnt/NavigationListItem" { * Default value is `true`. * * @since 1.116 - * @experimental As of version 1.116. Disclaimer: this property is in a beta state - incompatible API changes - * may be done before its official public release. * * @returns Reference to `this` in order to allow method chaining */ @@ -1988,8 +1980,6 @@ declare module "sap/tnt/NavigationListItem" { * - Items that trigger actions (with design "Action") should not be selectable. * * @since 1.116 - * @experimental As of version 1.116. Disclaimer: this property is in a beta state - incompatible API changes - * may be done before its official public release. */ selectable?: boolean | PropertyBindingInfo | `{${string}}`; @@ -2017,7 +2007,6 @@ declare module "sap/tnt/NavigationListItem" { * sub-items cannot be added. * * @since 1.133.0 - * @experimental Behavior might change. */ design?: | (NavigationListItemDesign | keyof typeof NavigationListItemDesign) @@ -3080,10 +3069,14 @@ declare module "sap/tnt/ToolHeader" { * - If an app implements side navigation in addition to the tool header menu, the menu icon must be the * first item on the left-hand side of the tool header. * - The app menu and the side navigation must not have any dependencies and must work independently. - * Horizon theme specifics: Only the following controls are supported: sap.m.Button, sap.m.Image, - * sap.m.Title, sap.m.Text, sap.m.SearchField, sap.m.Avatar. Fiori 3 theme specifics: In Fiori 3 Default - * theme the ToolHeader is with dark design unlike most of the other controls. This defines the usage of - * limited controls inside it, which will result in good design combination. + * + * - Not recommended: In accordance with the UX Consistency initiative, it is recommended to use the seamlessly + * integrated UI5 Web Components' ui5-shellbar, as demonstrated in this UXC + * integration sample app with UXC integration + * sample source code. Horizon theme specifics: Only the following controls are supported: sap.m.Button, + * sap.m.Image, sap.m.Title, sap.m.Text, sap.m.SearchField, sap.m.Avatar. Fiori 3 theme specifics: In Fiori + * 3 Default theme the ToolHeader is with dark design unlike most of the other controls. This defines the + * usage of limited controls inside it, which will result in good design combination. * The ToolHeader stylizes the contained controls with the Shell color parameters, to match the dark design * requirement. However, that's not a dark theme. * diff --git a/types/openui5/sap.ui.codeeditor.d.ts b/types/openui5/sap.ui.codeeditor.d.ts index 23b2effe4cbbef..2bdb5696ef73d0 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.145.0 +// For Library Version: 1.146.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 9f0ccf15d43e09..d20c3022e812d6 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.145.0 +// For Library Version: 1.146.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 db2441f8ca0a55..71e04098e6e109 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.145.0 +// For Library Version: 1.146.0 declare module "sap/base/assert" { /** @@ -5531,211 +5531,418 @@ declare module "sap/ui/events/ControlEvents" { declare module "sap/ui/events/KeyCodes" { /** + * KeyCodes enumeration. + * * @since 1.58 */ enum KeyCodes { + /** + * Letter A key + */ A = "65", - + /** + * Alt key + */ ALT = "18", - + /** + * Down arrow key + */ ARROW_DOWN = "40", - + /** + * Left arrow key + */ ARROW_LEFT = "37", - + /** + * Right arrow key + */ ARROW_RIGHT = "39", - + /** + * Up arrow key + */ ARROW_UP = "38", - + /** + * Letter B key + */ B = "66", - + /** + * Backslash (\) key + */ BACKSLASH = "226", - + /** + * Backspace key + */ BACKSPACE = "8", - + /** + * Pause/Break key + */ BREAK = "19", - + /** + * Letter C key + */ C = "67", - + /** + * Caps Lock key + */ CAPS_LOCK = "20", - + /** + * Comma (,) key + */ COMMA = "188", - + /** + * Context menu key + */ CONTEXT_MENU = "93", - + /** + * Control key + */ CONTROL = "17", - + /** + * Letter D key + */ D = "68", - + /** + * Delete key + */ DELETE = "46", - + /** + * Digit 0 key + */ DIGIT_0 = "48", - + /** + * Digit 1 key + */ DIGIT_1 = "49", - + /** + * Digit 2 key + */ DIGIT_2 = "50", - + /** + * Digit 3 key + */ DIGIT_3 = "51", - + /** + * Digit 4 key + */ DIGIT_4 = "52", - + /** + * Digit 5 key + */ DIGIT_5 = "53", - + /** + * Digit 6 key + */ DIGIT_6 = "54", - + /** + * Digit 7 key + */ DIGIT_7 = "55", - + /** + * Digit 8 key + */ DIGIT_8 = "56", - + /** + * Digit 9 key + */ DIGIT_9 = "57", - + /** + * Dot/period (.) key + */ DOT = "190", - + /** + * Letter E key + */ E = "69", - + /** + * End key + */ END = "35", - + /** + * Enter key + */ ENTER = "13", - + /** + * Equals (=) key + */ EQUALS = "221", - + /** + * Escape key + */ ESCAPE = "27", - + /** + * Letter F key + */ F = "70", - + /** + * F1 function key + */ F1 = "112", - + /** + * F10 function key + */ F10 = "121", - + /** + * F11 function key + */ F11 = "122", - + /** + * F12 function key + */ F12 = "123", - + /** + * F2 function key + */ F2 = "113", - + /** + * F3 function key + */ F3 = "114", - + /** + * F4 function key + */ F4 = "115", - + /** + * F5 function key + */ F5 = "116", - + /** + * F6 function key + */ F6 = "117", - + /** + * F7 function key + */ F7 = "118", - + /** + * F8 function key + */ F8 = "119", - + /** + * F9 function key + */ F9 = "120", - + /** + * Letter G key + */ G = "71", - + /** + * Grave accent (`) key + */ GREAT_ACCENT = "220", - + /** + * Letter H key + */ H = "72", - + /** + * Home key + */ HOME = "36", - + /** + * Letter I key + */ I = "73", - + /** + * Insert key + */ INSERT = "45", - + /** + * Letter J key + */ J = "74", - + /** + * Letter K key + */ K = "75", - + /** + * Letter L key + */ L = "76", - + /** + * Letter M key + */ M = "77", - + /** + * Minus (-) key + */ MINUS = "219", - + /** + * Letter N key + */ N = "78", - + /** + * Num Lock key + */ NUM_LOCK = "144", - + /** + * Numpad 0 key + */ NUMPAD_0 = "96", - + /** + * Numpad 1 key + */ NUMPAD_1 = "97", - + /** + * Numpad 2 key + */ NUMPAD_2 = "98", - + /** + * Numpad 3 key + */ NUMPAD_3 = "99", - + /** + * Numpad 4 key + */ NUMPAD_4 = "100", - + /** + * Numpad 5 key + */ NUMPAD_5 = "101", - + /** + * Numpad 6 key + */ NUMPAD_6 = "102", - + /** + * Numpad 7 key + */ NUMPAD_7 = "103", - + /** + * Numpad 8 key + */ NUMPAD_8 = "104", - + /** + * Numpad 9 key + */ NUMPAD_9 = "105", - + /** + * Numpad asterisk (*) key + */ NUMPAD_ASTERISK = "106", - + /** + * Numpad comma/decimal (.) key + */ NUMPAD_COMMA = "110", - + /** + * Numpad minus (-) key + */ NUMPAD_MINUS = "109", - + /** + * Numpad plus (+) key + */ NUMPAD_PLUS = "107", - + /** + * Numpad slash (/) key + */ NUMPAD_SLASH = "111", - + /** + * Letter O key + */ O = "79", - + /** + * Open bracket ([) key + */ OPEN_BRACKET = "186", - + /** + * Letter P key + */ P = "80", - + /** + * Page Down key + */ PAGE_DOWN = "34", - + /** + * Page Up key + */ PAGE_UP = "33", - + /** + * Pipe (|) key + */ PIPE = "191", - + /** + * Plus (+) key + */ PLUS = "187", - + /** + * Print Screen key + */ PRINT = "44", - + /** + * Letter Q key + */ Q = "81", - + /** + * Letter R key + */ R = "82", - + /** + * Letter S key + */ S = "83", - + /** + * Scroll Lock key + */ SCROLL_LOCK = "145", - + /** + * Semicolon (;) key + */ SEMICOLON = "192", - + /** + * Shift key + */ SHIFT = "16", - + /** + * Single quote (') key + */ SINGLE_QUOTE = "222", - + /** + * Slash (/) key + */ SLASH = "189", - + /** + * Sleep key + */ SLEEP = "95", - + /** + * Space bar key + */ SPACE = "32", - + /** + * Letter T key + */ T = "84", - + /** + * Tab key + */ TAB = "9", - + /** + * Turn off key + */ TURN_OFF = "94", - + /** + * Letter U key + */ U = "85", - + /** + * Letter V key + */ V = "86", - + /** + * Letter W key + */ W = "87", - + /** + * Windows key (or Meta key on Mac) + */ WINDOWS = "91", - + /** + * Letter X key + */ X = "88", - + /** + * Letter Y key + */ Y = "89", - + /** + * Letter Z key + */ Z = "90", } export default KeyCodes; @@ -5795,6 +6002,24 @@ declare module "sap/ui/model/FilterProcessor" { * @since 1.71 */ interface FilterProcessor { + /** + * Combines control filters and application filters using AND and returns the resulting filter + * + * @since 1.146.0 + * + * @returns A single filter containing all filters of the arrays combined or `undefined` if no filters are + * given + */ + combineFilters( + /** + * The control filters + */ + aFilters?: Filter[], + /** + * The application filters + */ + aApplicationFilters?: Filter[] + ): Filter | undefined; /** * Groups filters according to their path and combines filters on the same path using "OR" and filters on * different paths using "AND", all multi-filters contained are ANDed. @@ -11310,7 +11535,7 @@ declare module "sap/ui/app/Application" { * Returns the application root component. * * @since 1.13.1 - * @deprecated As of version 1.14. + * @deprecated As of version 1.14. superseded by {@link sap.ui.core.Component}. * * @returns The root component */ @@ -12392,8 +12617,8 @@ declare module "sap/ui/base/ManagedObject" { * ``` * * - * Note that when setting string values, any curly braces in those values need to be escaped, so they are - * not interpreted as binding expressions. Use {@link #escapeSettingsValue} to do so. + * Note that when setting string values, any curly braces and backslashes in those values need to be escaped, + * so they are not interpreted as binding expressions. Use {@link #escapeSettingsValue} to do so. * * **Note:** As of version 1.120, providing aggregation content via an object literal is deprecated, in * case the object's type is given via the property 'Type' as a string, or is derived via the defined type @@ -12514,8 +12739,8 @@ declare module "sap/ui/base/ManagedObject" { * ``` * * - * Note that when setting string values, any curly braces in those values need to be escaped, so they are - * not interpreted as binding expressions. Use {@link #escapeSettingsValue} to do so. + * Note that when setting string values, any curly braces and backslashes in those values need to be escaped, + * so they are not interpreted as binding expressions. Use {@link #escapeSettingsValue} to do so. * * **Note:** As of version 1.120, providing aggregation content via an object literal is deprecated, in * case the object's type is given via the property 'Type' as a string, or is derived via the defined type @@ -12579,17 +12804,46 @@ declare module "sap/ui/base/ManagedObject" { ); /** - * Escapes the given value so it can be used in the constructor's settings object. Should be used when property - * values are initialized with static string values which could contain binding characters (curly braces). + * Escapes the given value so it can be used in the constructor's settings object. + * + * Use this method when passing static string values that might contain binding syntax characters. Without + * escaping, curly braces in strings would be misinterpreted as data binding expressions. + * + * **Characters that are escaped:** + * - `{` (opening curly brace) - binding expression start + * - `}` (closing curly brace) - binding expression end + * - `\` (backslash) - escape character itself + * + * Each of the above characters is prefixed with a backslash, e.g. `{foo}` becomes `\{foo\}`. + * + * **When to use:** + * - Static string values containing curly braces that should be displayed literally + * - Rendering escaped backslashes (e.g. expecting `\\\\` to result in `\\`) + * - User input or external data used as property values in constructors + * - JSON content that should not be parsed as bindings + * + * Example usage: + * ```javascript + * + * new MyControl({ + * // Without escaping: "{info}" would be interpreted as a binding to the path "info" + * // With escaping: displays the literal text "{info}" + * text: ManagedObject.escapeSettingsValue("{info}") + * }); + * ``` + * + * + * **Note:** This is only needed when setting values via the constructor or {@link #applySettings}. Setter + * method calls, e.g. `setText("{info}")` do not interpret binding syntax and thus do not require escaping. * * @since 1.52 * - * @returns The given value, escaped for usage as static property value in the constructor's settings object - * (or unchanged, if not of type string) + * @returns The escaped string value, or the original value if not a string */ static escapeSettingsValue( /** - * Value to escape; only needs to be done for string values, but the call will work for all types + * Value to escape; only strings are escaped, other types (e.g. objects) are returned through unchanged. + * Strings nested in objects must be escaped individually. */ vValue: any ): any; @@ -13264,9 +13518,18 @@ declare module "sap/ui/base/ManagedObject" { * Destroys (all) the managed object(s) in the aggregation named `sAggregationName` and empties the aggregation. * If the aggregation did contain any object, this ManagedObject is marked as changed. * + * **Note:** Destroying an aggregation by calling this method (or indirectly via `destroyXYZ`) does + * not call the named aggregation mutators (`setXYZ` for a 0..1 aggregation, `removeXYZ` for + * a 0..n aggregation) for the aggregated children. Controls that implement side effects in those methods + * therefore must also implement similar side effects in their `destroyXYZ` method. + * + * While this is understood as inconvenient, it was decided (February 2026, after a thorough investigation), + * not to change it. Too many existing controls depend on the current behavior, and, even worse, would have + * severe problems with a changed behavior. + * * **Note:** This method is a low-level API as described in the class documentation. * Applications or frameworks must not use this method to generically destroy all objects in an aggregation. - * Use the concrete method destroyXYZ for aggregation 'XYZ' instead. + * Use the concrete method `destroyXYZ` for aggregation 'XYZ' instead. * * @ui5-protected Do not call from applications (only from related classes in the framework) * @@ -14507,13 +14770,20 @@ declare module "sap/ui/base/ManagedObject" { */ length?: int; /** - * The initial sort order (optional) + * The initial sort order */ sorter?: Sorter | Sorter[]; /** - * The predefined filters for this aggregation (optional) + * The predefined {@link sap.ui.model.FilterType.Application application filters} for this aggregation where + * filter values are constants. */ filters?: Filter | Filter[]; + /** + * The predefined {@link sap.ui.model.FilterType.ApplicationBound bound application filters} for this aggregation. + * Filter values support binding expressions. The aggregation updates its filters whenever a filter value + * changes through data binding. Supported since 1.146.0. + */ + boundFilters?: Filter | Filter[]; /** * Name of the key property or a function getting the context as only parameter to calculate a key for entries. * This can be used to improve update behaviour in models, where a key is not already available. @@ -18507,56 +18777,56 @@ declare module "sap/ui/core/CommandExecution" { import { PropertyBindingInfo } from "sap/ui/base/ManagedObject"; /** + * The CommandExecution registers a shortcut when it is added to the dependent aggregation of a control. + * The shortcut information is retrieved from the owner components manifest (`/sap.ui5/commands/`). + * + * You can use a CommandExecution instead of an event handler in XMLViews by using `cmd:` plus the command + * name. + * + * Example for `sap.m.Button`: + * + * + * ```javascript + * + *