@openui5/types 1.119.1 → 1.120.0

package/types/sap.ui.rta.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.119.1
+// For Library Version: 1.120.0
 
 declare module "sap/ui/rta/api/startAdaptation" {
   import Control from "sap/ui/core/Control";

package/types/sap.ui.suite.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.119.1
+// For Library Version: 1.120.0
 
 declare module "sap/ui/suite/library" {
   /**

package/types/sap.ui.support.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.119.1
+// For Library Version: 1.120.0
 
 declare module "sap/ui/support/library" {
   /**
@@ -148,6 +148,12 @@ declare module "sap/ui/support/library" {
      * The accessibility preset.
      */
     Accessibility = "undefined",
+    /**
+     * @experimental (since 1.120)
+     *
+     * Preset to find usages of deprecated controls, properties, aggregations and others.
+     */
+    Deprecations = "undefined",
   }
 }
 

package/types/sap.ui.table.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.119.1
+// For Library Version: 1.120.0
 
 declare module "sap/ui/table/library" {
   import TreeAutoExpandMode1 from "sap/ui/model/TreeAutoExpandMode";
@@ -55,6 +55,8 @@ declare module "sap/ui/table/library" {
     Scrollbar = "Scrollbar",
   }
   /**
+   * @deprecated (since 1.115)
+   *
    * Enumeration of the `ResetAllMode` that can be used in a `TablePersoController`.
    */
   export enum ResetAllMode {
@@ -145,6 +147,8 @@ declare module "sap/ui/table/library" {
     VerticalScrollBar = "vsb",
   }
   /**
+   * @deprecated (since 1.120) - replaced with `sap.ui.core.SortOrder`
+   *
    * Sort order of a column
    */
   export enum SortOrder {
@@ -158,6 +162,8 @@ declare module "sap/ui/table/library" {
     Descending = "Descending",
   }
   /**
+   * @deprecated (since 1.120)
+   *
    * Different modes for setting the auto expand mode on tree or analytical bindings.
    *
    * This is an alias for {@link sap.ui.model.TreeAutoExpandMode} and kept for compatibility reasons.
@@ -1383,6 +1389,7 @@ declare module "sap/ui/table/Column" {
   import {
     HorizontalAlign,
     ID,
+    SortOrder,
     CSSSize,
     IColumnHeaderMenu,
   } from "sap/ui/core/library";
@@ -1391,8 +1398,6 @@ declare module "sap/ui/table/Column" {
 
   import ElementMetadata from "sap/ui/core/ElementMetadata";
 
-  import { SortOrder } from "sap/ui/table/library";
-
   import {
     PropertyBindingInfo,
     AggregationBindingInfo,
@@ -1668,6 +1673,10 @@ declare module "sap/ui/table/Column" {
      * a function can be passed that takes over the conversion. This cannot be done in the XMLView, use {@link #setFilterType }
      * instead.
      *
+     * **Note:** The usage of string-based type definitions without explicitly loading these types (`sap.ui.require`)
+     * in the controller has been deprecated and might no longer work in future releases. Please ensure that
+     * the types are requested correctly before setting this property.
+     *
      * @returns Value of property `filterType`
      */
     getFilterType(): any;
@@ -1850,11 +1859,17 @@ declare module "sap/ui/table/Column" {
      */
     getShowSortMenuEntry(): boolean;
     /**
+     * @deprecated (since 1.120) - replaced by {@link sap.ui.core.SortOrder SortOrder.None} for the `sortOrder`
+     * property
+     *
      * Gets current value of property {@link #getSorted sorted}.
      *
      * Indicates if the column is sorted. This property only controls if a sort indicator is displayed in the
      * column header - it does not trigger the sort function. The column can be sorted using {@link sap.ui.table.Table#sort}.
      *
+     * If this property is set to `true` and the `sortOrder` property is `None`, `sortOrder` is automatically
+     * set to `Ascending`. If this property is `true` and `sortOrder` is `None`, the sort indicator is not shown.
+     *
      * Default value is `false`.
      *
      * @returns Value of property `sorted`
@@ -1863,10 +1878,10 @@ declare module "sap/ui/table/Column" {
     /**
      * Gets current value of property {@link #getSortOrder sortOrder}.
      *
-     * This property indicates the sort direction (Ascending or Descending). The corresponding icon will be
-     * rendered if the property `sorted` is `true`
+     * Controls whether a sort indicator is displayed in the column header. **Note:** Setting this property
+     * does not sort the table. The column can be sorted using {@link sap.ui.table.Table#sort}.
      *
-     * Default value is `Ascending`.
+     * Default value is `None`.
      *
      * @returns Value of property `sortOrder`
      */
@@ -2346,11 +2361,17 @@ declare module "sap/ui/table/Column" {
       bShowSortMenuEntry?: boolean
     ): this;
     /**
+     * @deprecated (since 1.120) - replaced by {@link sap.ui.core.SortOrder SortOrder.None} for the `sortOrder`
+     * property
+     *
      * Sets a new value for property {@link #getSorted sorted}.
      *
      * Indicates if the column is sorted. This property only controls if a sort indicator is displayed in the
      * column header - it does not trigger the sort function. The column can be sorted using {@link sap.ui.table.Table#sort}.
      *
+     * If this property is set to `true` and the `sortOrder` property is `None`, `sortOrder` is automatically
+     * set to `Ascending`. If this property is `true` and `sortOrder` is `None`, the sort indicator is not shown.
+     *
      * When called with a value of `null` or `undefined`, the default value of the property will be restored.
      *
      * Default value is `false`.
@@ -2366,12 +2387,12 @@ declare module "sap/ui/table/Column" {
     /**
      * Sets a new value for property {@link #getSortOrder sortOrder}.
      *
-     * This property indicates the sort direction (Ascending or Descending). The corresponding icon will be
-     * rendered if the property `sorted` is `true`
+     * Controls whether a sort indicator is displayed in the column header. **Note:** Setting this property
+     * does not sort the table. The column can be sorted using {@link sap.ui.table.Table#sort}.
      *
      * When called with a value of `null` or `undefined`, the default value of the property will be restored.
      *
-     * Default value is `Ascending`.
+     * Default value is `None`.
      *
      * @returns Reference to `this` in order to allow method chaining
      */
@@ -2524,14 +2545,20 @@ declare module "sap/ui/table/Column" {
       | `{${string}}`;
 
     /**
+     * @deprecated (since 1.120) - replaced by {@link sap.ui.core.SortOrder SortOrder.None} for the `sortOrder`
+     * property
+     *
      * Indicates if the column is sorted. This property only controls if a sort indicator is displayed in the
      * column header - it does not trigger the sort function. The column can be sorted using {@link sap.ui.table.Table#sort}.
+     *
+     * If this property is set to `true` and the `sortOrder` property is `None`, `sortOrder` is automatically
+     * set to `Ascending`. If this property is `true` and `sortOrder` is `None`, the sort indicator is not shown.
      */
     sorted?: boolean | PropertyBindingInfo | `{${string}}`;
 
     /**
-     * This property indicates the sort direction (Ascending or Descending). The corresponding icon will be
-     * rendered if the property `sorted` is `true`
+     * Controls whether a sort indicator is displayed in the column header. **Note:** Setting this property
+     * does not sort the table. The column can be sorted using {@link sap.ui.table.Table#sort}.
      */
     sortOrder?:
       | (SortOrder | keyof typeof SortOrder)
@@ -2606,6 +2633,10 @@ declare module "sap/ui/table/Column" {
      * \{\} \}"`. Here the escaping is mandatory to avoid handling by the binding parser. As an alternative,
      * a function can be passed that takes over the conversion. This cannot be done in the XMLView, use {@link #setFilterType }
      * instead.
+     *
+     * **Note:** The usage of string-based type definitions without explicitly loading these types (`sap.ui.require`)
+     * in the controller has been deprecated and might no longer work in future releases. Please ensure that
+     * the types are requested correctly before setting this property.
      */
     filterType?: any | PropertyBindingInfo | `{${string}}`;
 
@@ -3330,7 +3361,9 @@ declare module "sap/ui/table/plugins/SelectionPlugin" {
      * Constructs an instance of sap.ui.table.plugins.SelectionPlugin
      *
      * The following restrictions apply:
-     * 	 - Do not create subclasses of the SelectionPlugin. The API is subject to change.
+     * 	 - Do not create subclasses of the `SelectionPlugin`. The API is subject to change. **Note:** Subclasses
+     *     provided by the UI5 framework that are not explicitly marked as experimental or restricted in any other
+     *     way can be used on a regular basis.
      *
      * 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
@@ -5240,7 +5273,13 @@ declare module "sap/ui/table/RowSettings" {
 declare module "sap/ui/table/Table" {
   import { default as Control, $ControlSettings } from "sap/ui/core/Control";
 
-  import { ID, IContextMenu, Toolbar, CSSSize } from "sap/ui/core/library";
+  import {
+    ID,
+    IContextMenu,
+    Toolbar,
+    CSSSize,
+    SortOrder,
+  } from "sap/ui/core/library";
 
   import Column from "sap/ui/table/Column";
 
@@ -5270,7 +5309,6 @@ declare module "sap/ui/table/Table" {
     SelectionBehavior,
     SelectionMode,
     VisibleRowCountMode,
-    SortOrder,
   } from "sap/ui/table/library";
 
   import RowAction from "sap/ui/table/RowAction";
@@ -5399,6 +5437,7 @@ declare module "sap/ui/table/Table" {
     ): this;
     /**
      * @since 1.64
+     * @deprecated (since 1.120) - Please add plugins to the `dependents` aggregation instead.
      *
      * Adds some plugin to the aggregation {@link #getPlugins plugins}.
      *
@@ -5781,6 +5820,8 @@ declare module "sap/ui/table/Table" {
       oListener?: object
     ): this;
     /**
+     * @deprecated (since 1.117)
+     *
      * Attaches event handler `fnFunction` to the {@link #event:columnSelect columnSelect} event of this `sap.ui.table.Table`.
      *
      * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
@@ -5806,6 +5847,8 @@ declare module "sap/ui/table/Table" {
       oListener?: object
     ): this;
     /**
+     * @deprecated (since 1.117)
+     *
      * Attaches event handler `fnFunction` to the {@link #event:columnSelect columnSelect} event of this `sap.ui.table.Table`.
      *
      * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
@@ -6138,10 +6181,15 @@ declare module "sap/ui/table/Table" {
      * 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.ui.table.Table` itself.
      *
-     * fired when the row selection of the table has been changed (the event parameters can be used to determine
-     * selection changes - to find out the selected rows you should better use the table selection API)
+     * Fired if the row selection of the table has been changed.
+     *
+     * The event parameters can be used to determine selection changes. To find the selected rows, you should
+     * use {@link sap.ui.table.Table#getSelectedIndices} or the related function of the used selection plugin
+     * if it exists.
      *
-     * **Note:** If a selection plugin is applied to the table, this event won't be fired.
+     * **Note:** The built-in selection API has limited functionality, especially when it is combined with paging
+     * (e.g. OData). Therefore, it is recommended to use a selection plugin instead. **Note:** If a selection
+     * plugin is used with the table, this event won't be fired.
      *
      * @returns Reference to `this` in order to allow method chaining
      */
@@ -6167,10 +6215,15 @@ declare module "sap/ui/table/Table" {
      * 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.ui.table.Table` itself.
      *
-     * fired when the row selection of the table has been changed (the event parameters can be used to determine
-     * selection changes - to find out the selected rows you should better use the table selection API)
+     * Fired if the row selection of the table has been changed.
      *
-     * **Note:** If a selection plugin is applied to the table, this event won't be fired.
+     * The event parameters can be used to determine selection changes. To find the selected rows, you should
+     * use {@link sap.ui.table.Table#getSelectedIndices} or the related function of the used selection plugin
+     * if it exists.
+     *
+     * **Note:** The built-in selection API has limited functionality, especially when it is combined with paging
+     * (e.g. OData). Therefore, it is recommended to use a selection plugin instead. **Note:** If a selection
+     * plugin is used with the table, this event won't be fired.
      *
      * @returns Reference to `this` in order to allow method chaining
      */
@@ -6370,6 +6423,7 @@ declare module "sap/ui/table/Table" {
     destroyNoData(): this;
     /**
      * @since 1.64
+     * @deprecated (since 1.120) - Please add plugins to the `dependents` aggregation instead.
      *
      * Destroys all the plugins in the aggregation {@link #getPlugins plugins}.
      *
@@ -6552,6 +6606,8 @@ declare module "sap/ui/table/Table" {
       oListener?: object
     ): this;
     /**
+     * @deprecated (since 1.117)
+     *
      * Detaches event handler `fnFunction` from the {@link #event:columnSelect columnSelect} event of this `sap.ui.table.Table`.
      *
      * The passed function and listener object must match the ones used for event registration.
@@ -6885,6 +6941,7 @@ declare module "sap/ui/table/Table" {
       mParameters?: Table$ColumnResizeEventParameters
     ): boolean;
     /**
+     * @deprecated (since 1.117)
      * @ui5-protected Do not call from applications (only from related classes in the framework)
      *
      * Fires event {@link #event:columnSelect columnSelect} to attached listeners.
@@ -7397,15 +7454,14 @@ declare module "sap/ui/table/Table" {
     getNoData(): Control | string;
     /**
      * @since 1.64
+     * @deprecated (since 1.120) - Please add plugins to the `dependents` aggregation instead.
      *
      * Gets content of aggregation {@link #getPlugins plugins}.
      *
      * Plugin section of the table. Multiple plugins are possible, but always only **one** of a certain type.
      *
-     * The following restrictions apply:
-     * 	 - If a selection plugin is applied to the table, the table's selection API must not be used. Instead,
-     *     use the API of the plugin.
-     * 	 - Only one MultiSelectionPlugin can be applied. No other plugins can be applied.
+     * If a selection plugin is used, the table's selection API must not be used. Instead, use the API of the
+     * plugin.
      */
     getPlugins(): SelectionPlugin[];
     /**
@@ -7456,7 +7512,8 @@ declare module "sap/ui/table/Table" {
      *
      * Gets content of aggregation {@link #getRowMode rowMode}.
      *
-     * Defines how the table handles the rows.
+     * Defines how the table handles the rows. By default, the table operates in {@link sap.ui.table.rowmodes.Type Fixed }
+     * mode.
      */
     getRowMode(): RowMode | (Type | keyof typeof Type);
     /**
@@ -7525,8 +7582,10 @@ declare module "sap/ui/table/Table" {
      * how the selection can be extended. It may also influence the visual appearance. When the selection mode
      * is changed, the current selection is removed. **Note:** Since the group header visualization relies on
      * the row selectors, the row selectors are always shown if the grouping functionality (depends on table
-     * type) is enabled, even if `sap.ui.table.SelectionMode.None` is set. **Note:** If a selection plugin is
-     * applied to the table, the selection mode is controlled by the plugin.
+     * type) is enabled, even if `sap.ui.table.SelectionMode.None` is set. **Note:** The built-in selection
+     * API has limited functionality, especially when it is combined with paging (e.g. OData). Therefore, it
+     * is recommended to use a selection plugin instead. **Note:** If a selection plugin is used with the table,
+     * the selection mode is controlled by the plugin.
      *
      * Default value is `MultiToggle`.
      *
@@ -7574,7 +7633,7 @@ declare module "sap/ui/table/Table" {
     /**
      * Gets the sorted columns in the order in which sorting was performed through the {@link sap.ui.table.Table#sort }
      * method and menus. Does not reflect sorting at binding level or the columns sort visualization set with
-     * {@link sap.ui.table.Column#setSorted} and {@link sap.ui.table.Column#setSortOrder}.
+     * {@link sap.ui.table.Column#setSortOrder}.
      * See:
      * 	sap.ui.table.Table#sort
      *
@@ -7689,6 +7748,7 @@ declare module "sap/ui/table/Table" {
     ): int;
     /**
      * @since 1.64
+     * @deprecated (since 1.120) - Please add plugins to the `dependents` aggregation instead.
      *
      * Checks for the provided `sap.ui.table.plugins.SelectionPlugin` in the aggregation {@link #getPlugins plugins}.
      * and returns its index if found or -1 otherwise.
@@ -7749,6 +7809,7 @@ declare module "sap/ui/table/Table" {
     ): this;
     /**
      * @since 1.64
+     * @deprecated (since 1.120) - Please add plugins to the `dependents` aggregation instead.
      *
      * Inserts a plugin into the aggregation {@link #getPlugins plugins}.
      *
@@ -7818,6 +7879,7 @@ declare module "sap/ui/table/Table" {
     removeAllExtension(): Control[];
     /**
      * @since 1.64
+     * @deprecated (since 1.120) - Please add plugins to the `dependents` aggregation instead.
      *
      * Removes all the controls from the aggregation {@link #getPlugins plugins}.
      *
@@ -7869,6 +7931,7 @@ declare module "sap/ui/table/Table" {
     ): Control | null;
     /**
      * @since 1.64
+     * @deprecated (since 1.120) - Please add plugins to the `dependents` aggregation instead.
      *
      * Removes a plugin from the aggregation {@link #getPlugins plugins}.
      *
@@ -8645,21 +8708,23 @@ declare module "sap/ui/table/Table" {
       sWidth?: CSSSize
     ): this;
     /**
-     * Sorts the given column ascending or descending.
+     * Changes or removes sorting from the table.
      */
     sort(
       /**
        * Column to be sorted or undefined to clear sorting
        */
-      oColumn: Column | undefined,
+      oColumn?: Column,
       /**
-       * Sort order of the column (if undefined the default will be ascending)
+       * Sort order of the column
        */
-      oSortOrder: SortOrder | keyof typeof SortOrder,
+      sSortOrder?: SortOrder | keyof typeof SortOrder,
       /**
-       * Set to true to add the new sort criterion to the existing sort criteria
+       * Set to `true` to add the new sort criterion to the existing sort criteria, otherwise to replace it. If
+       * the sort order is `sap.ui.core.SortOrder.None`, this parameter has no effect, and only the sort criterion
+       * for this column is removed from the sort criteria.
        */
-      bAdd: boolean
+      bAdd?: boolean
     ): void;
     /**
      * Unbinds aggregation {@link #getColumns columns} from model data.
@@ -8736,8 +8801,10 @@ declare module "sap/ui/table/Table" {
      * how the selection can be extended. It may also influence the visual appearance. When the selection mode
      * is changed, the current selection is removed. **Note:** Since the group header visualization relies on
      * the row selectors, the row selectors are always shown if the grouping functionality (depends on table
-     * type) is enabled, even if `sap.ui.table.SelectionMode.None` is set. **Note:** If a selection plugin is
-     * applied to the table, the selection mode is controlled by the plugin.
+     * type) is enabled, even if `sap.ui.table.SelectionMode.None` is set. **Note:** The built-in selection
+     * API has limited functionality, especially when it is combined with paging (e.g. OData). Therefore, it
+     * is recommended to use a selection plugin instead. **Note:** If a selection plugin is used with the table,
+     * the selection mode is controlled by the plugin.
      */
     selectionMode?:
       | (SelectionMode | keyof typeof SelectionMode)
@@ -9019,7 +9086,8 @@ declare module "sap/ui/table/Table" {
     /**
      * @since 1.119
      *
-     * Defines how the table handles the rows.
+     * Defines how the table handles the rows. By default, the table operates in {@link sap.ui.table.rowmodes.Type Fixed }
+     * mode.
      */
     rowMode?:
       | (Type | keyof typeof Type)
@@ -9064,13 +9132,12 @@ declare module "sap/ui/table/Table" {
 
     /**
      * @since 1.64
+     * @deprecated (since 1.120) - Please add plugins to the `dependents` aggregation instead.
      *
      * Plugin section of the table. Multiple plugins are possible, but always only **one** of a certain type.
      *
-     * The following restrictions apply:
-     * 	 - If a selection plugin is applied to the table, the table's selection API must not be used. Instead,
-     *     use the API of the plugin.
-     * 	 - Only one MultiSelectionPlugin can be applied. No other plugins can be applied.
+     * If a selection plugin is used, the table's selection API must not be used. Instead, use the API of the
+     * plugin.
      */
     plugins?:
       | SelectionPlugin[]
@@ -9094,14 +9161,21 @@ declare module "sap/ui/table/Table" {
     ariaLabelledBy?: Array<Control | string>;
 
     /**
-     * fired when the row selection of the table has been changed (the event parameters can be used to determine
-     * selection changes - to find out the selected rows you should better use the table selection API)
+     * Fired if the row selection of the table has been changed.
+     *
+     * The event parameters can be used to determine selection changes. To find the selected rows, you should
+     * use {@link sap.ui.table.Table#getSelectedIndices} or the related function of the used selection plugin
+     * if it exists.
      *
-     * **Note:** If a selection plugin is applied to the table, this event won't be fired.
+     * **Note:** The built-in selection API has limited functionality, especially when it is combined with paging
+     * (e.g. OData). Therefore, it is recommended to use a selection plugin instead. **Note:** If a selection
+     * plugin is used with the table, this event won't be fired.
      */
     rowSelectionChange?: (oEvent: Table$RowSelectionChangeEvent) => void;
 
     /**
+     * @deprecated (since 1.117)
+     *
      * fired when a column of the table has been selected
      */
     columnSelect?: (oEvent: Table$ColumnSelectEvent) => void;
@@ -9508,17 +9582,17 @@ declare module "sap/ui/table/Table" {
 
   export interface Table$SortEventParameters {
     /**
-     * sorted column.
+     * The column for which the sorting is changed
      */
     column?: Column;
 
     /**
-     * Sort Order
+     * The new sort order
      */
     sortOrder?: SortOrder | keyof typeof SortOrder;
 
     /**
-     * If column was added to sorter this is true. If new sort is started this is set to false
+     * Indicates that the column is added to the list of sorted columns
      */
     columnAdded?: boolean;
   }

package/types/sap.ui.testrecorder.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.119.1
+// For Library Version: 1.120.0
 
 declare module "sap/ui/testrecorder/library" {}
 

package/types/sap.ui.unified.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.119.1
+// For Library Version: 1.120.0
 
 declare module "sap/ui/unified/library" {
   /**

package/types/sap.ui.ux3.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.119.1
+// For Library Version: 1.120.0
 
 declare module "sap/ui/ux3/library" {
   /**

package/types/sap.ui.webc.common.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.119.1
+// For Library Version: 1.120.0
 
 declare module "sap/ui/webc/common/library" {}