@openui5/types 1.126.1 → 1.128.0

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.126.1
+// For Library Version: 1.128.0
 
 declare module "sap/ui/rta/api/startAdaptation" {
   import Control from "sap/ui/core/Control";
@@ -8,7 +8,9 @@ declare module "sap/ui/rta/api/startAdaptation" {
   /**
    * Starts UI adaptation, initiated for an application at the passed root control instance. With this API
    * you are also able to modify the UI adaptation plugins list and or add some event handler functions to
-   * be called on start, failed and stop events.
+   * be called on start, failed and stop events. CAUTION: In the key user layer (CUSTOMER) the adaptation
+   * mode starts automatically after a reload triggered by the adaptation mode (e.g. due to personalization
+   * changes or versioning). In this case the RuntimeAuthoring class will be started with default parameters.
    *
    * @since 1.83
    *

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

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

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.126.1
+// For Library Version: 1.128.0
 
 declare module "sap/ui/support/library" {
   /**

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.126.1
+// For Library Version: 1.128.0
 
 declare module "sap/ui/table/library" {
   import TreeAutoExpandMode1 from "sap/ui/model/TreeAutoExpandMode";
@@ -2009,17 +2009,22 @@ declare module "sap/ui/table/Column" {
     /**
      * Gets content of aggregation {@link #getTemplate template}.
      *
-     * Template (cell renderer) of this column. A template is decoupled from the column. Each time the template's
-     * properties or aggregations have been changed, the template has to be applied again via `setTemplate`
-     * for the changes to take effect. If a string is defined, a default text control will be created with its
-     * text property bound to the value of the string. The default template depends on the libraries loaded.
-     * If there is no template, the column will not be rendered in the table. The set of supported controls
-     * is limited. See section "{@link https://ui5.sap.com/#/topic/148892ff9aea4a18b912829791e38f3e Tables: Which One Should I Choose?}"
+     * Template (cell renderer) of this column.
+     *
+     * A template is decoupled from the column. Each time the template's properties or aggregations have been
+     * changed, the template has to be applied again via `setTemplate` for the changes to take effect.
+     *
+     * If there is no template, the column will not be rendered in the table.
+     *
+     * The set of supported controls is limited. See section "{@link https://ui5.sap.com/#/topic/148892ff9aea4a18b912829791e38f3e Tables: Which One Should I Choose?}"
      * in the documentation for more details. While it is technically possible to also use other controls, doing
      * so might lead to issues with regards to scrolling, alignment, condensed mode, screen reader support,
      * and keyboard support.
      *
-     * **Note:** The `altType` string is deprecated as of version 1.118. Use a `Control` instead.
+     * If a string is defined, this string is interpreted as the binding path. Internally, a default text control
+     * will be created with its `text` property bound to the value of the string. The default template depends
+     * on the libraries loaded. **Note:** The `altType` string is deprecated as of version 1.118. Use a `Control`
+     * instead.
      */
     getTemplate(): Control | string;
     /**
@@ -2834,17 +2839,22 @@ declare module "sap/ui/table/Column" {
     multiLabels?: Control[] | Control | AggregationBindingInfo | `{${string}}`;
 
     /**
-     * Template (cell renderer) of this column. A template is decoupled from the column. Each time the template's
-     * properties or aggregations have been changed, the template has to be applied again via `setTemplate`
-     * for the changes to take effect. If a string is defined, a default text control will be created with its
-     * text property bound to the value of the string. The default template depends on the libraries loaded.
-     * If there is no template, the column will not be rendered in the table. The set of supported controls
-     * is limited. See section "{@link https://ui5.sap.com/#/topic/148892ff9aea4a18b912829791e38f3e Tables: Which One Should I Choose?}"
+     * Template (cell renderer) of this column.
+     *
+     * A template is decoupled from the column. Each time the template's properties or aggregations have been
+     * changed, the template has to be applied again via `setTemplate` for the changes to take effect.
+     *
+     * If there is no template, the column will not be rendered in the table.
+     *
+     * The set of supported controls is limited. See section "{@link https://ui5.sap.com/#/topic/148892ff9aea4a18b912829791e38f3e Tables: Which One Should I Choose?}"
      * in the documentation for more details. While it is technically possible to also use other controls, doing
      * so might lead to issues with regards to scrolling, alignment, condensed mode, screen reader support,
      * and keyboard support.
      *
-     * **Note:** The `altType` string is deprecated as of version 1.118. Use a `Control` instead.
+     * If a string is defined, this string is interpreted as the binding path. Internally, a default text control
+     * will be created with its `text` property bound to the value of the string. The default template depends
+     * on the libraries loaded. **Note:** The `altType` string is deprecated as of version 1.118. Use a `Control`
+     * instead.
      */
     template?: string | Control | PropertyBindingInfo;
 
@@ -5327,15 +5337,15 @@ declare module "sap/ui/table/rowmodes/Type" {
    */
   enum Type {
     /**
-     * Equivalent to the default configuration of {@link module:sap/ui/table/rowmodes/Auto}
+     * Equivalent to the default configuration of {@link sap.ui.table.rowmodes.Auto}
      */
     Auto = "Auto",
     /**
-     * Equivalent to the default configuration of {@link module:sap/ui/table/rowmodes/Fixed}
+     * Equivalent to the default configuration of {@link sap.ui.table.rowmodes.Fixed}
      */
     Fixed = "Fixed",
     /**
-     * Equivalent to the default configuration of {@link module:sap/ui/table/rowmodes/Interactive}
+     * Equivalent to the default configuration of {@link sap.ui.table.rowmodes.Interactive}
      */
     Interactive = "Interactive",
   }
@@ -5641,8 +5651,10 @@ declare module "sap/ui/table/Table" {
    * This allows the Table control to handle huge amounts of data. Nevertheless, restrictions apply regarding
    * the number of displayed columns. Keep the number as low as possible to improve performance. Due to the
    * nature of tables, the used control for column templates also has a big influence on the performance.
-   *   The Table control relies completely on data binding, and its supported feature set is tightly
-   * coupled to the data model and binding being used.
+   * Because of the described reuse of the controls during scrolling, all data-related changes must be based
+   * on bindings. Static changes, such as calling mutator functions or defining a one-time binding, must be
+   * avoided.   The Table control relies completely on data binding, and its supported feature set
+   * is tightly coupled to the data model and binding being used.
    */
   export default class Table extends Control {
     /**
@@ -7648,6 +7660,10 @@ declare module "sap/ui/table/Table" {
      *
      * Flag to enable or disable column reordering
      *
+     * **Note**: Column reordering is possible via drag&drop and keyboard shortcuts. Single-pointer alternative
+     * is not provided out-of-the-box and should be implemented on application side. For example the {@link sap.m.p13n.Engine }
+     * can be used, see the following sample: {@link https://ui5.sap.com/#/entity/sap.ui.table.Table/sample/sap.m.sample.p13n.EngineGridTable Personalization for grid table}.
+     *
      * Default value is `true`.
      *
      *
@@ -7913,6 +7929,29 @@ declare module "sap/ui/table/Table" {
      * changes to take effect.
      */
     getRowSettingsTemplate(): RowSettings;
+    /**
+     * Gets current value of property {@link #getScrollThreshold scrollThreshold}.
+     *
+     * Defines how many additional data records are requested from the back-end system when the user scrolls
+     * vertically in the table. The `scrollThreshold` is always added to the number of rows. If the number of
+     * rows is 10 and the `scrollThreshold` is 100, 110 records will be fetched during scrolling. The threshold
+     * that is applied to requests that are not initiated by scrolling can be configured with the `threshold`
+     * property. If the `scrollThreshold` is lower than the number of rows in the scrollable area (number of
+     * rows minus number of fixed rows), this number is used as the `scrollThreshold`. If the value is 0, no
+     * threshold is applied during scrolling. The value -1 applies the same value as the `threshold` property.
+     *
+     * **Note:** This property only takes effect if it is set to a positive integer value.
+     *
+     * For `AnalyticalTable` and `TreeTable`, the `scrollThreshold` property must be higher than the `threshold`
+     * property to take effect.
+     *
+     * Default value is `-1`.
+     *
+     * @since 1.128
+     *
+     * @returns Value of property `scrollThreshold`
+     */
+    getScrollThreshold(): int;
     /**
      * Retrieves the lead selection index.
      *
@@ -8017,10 +8056,12 @@ declare module "sap/ui/table/Table" {
      * Gets current value of property {@link #getThreshold threshold}.
      *
      * Defines how many additional (not yet visible) data records from the back-end system are pre-fetched to
-     * enable smooth scrolling. The threshold is always added to the `visibleRowCount`. If the `visibleRowCount`
-     * is 10 and the `threshold` is 100, there will be 110 records fetched with the initial load. If the `threshold`
-     * is lower than the number of rows in the scrollable area (`visibleRowCount` minus number of fixed rows),
-     * this number is used as the `threshold`. If the value is 0, thresholding is disabled.
+     * enable smooth scrolling. The threshold is always added to the number of rows. If the number of rows is
+     * 10 and the `threshold` is 100, 110 records will be fetched with the initial load. This property affects
+     * requests triggered by changes in the binding, for example, initial loading, sorting, filtering, etc.
+     * The threshold that is applied during scrolling can be configured with the `scrollThreshold` property.
+     * If the `threshold` is lower than the number of rows in the scrollable area (`visibleRowCount` minus number
+     * of fixed rows), this number is used as the `threshold`. If the value is 0, thresholding is disabled.
      *
      * Default value is `100`.
      *
@@ -8540,6 +8581,10 @@ declare module "sap/ui/table/Table" {
      *
      * Flag to enable or disable column reordering
      *
+     * **Note**: Column reordering is possible via drag&drop and keyboard shortcuts. Single-pointer alternative
+     * is not provided out-of-the-box and should be implemented on application side. For example the {@link sap.m.p13n.Engine }
+     * can be used, see the following sample: {@link https://ui5.sap.com/#/entity/sap.ui.table.Table/sample/sap.m.sample.p13n.EngineGridTable Personalization for grid table}.
+     *
      * When called with a value of `null` or `undefined`, the default value of the property will be restored.
      *
      * Default value is `true`.
@@ -8874,6 +8919,19 @@ declare module "sap/ui/table/Table" {
        */
       oRowSettingsTemplate: RowSettings
     ): this;
+    /**
+     * Sets the threshold value, which will be added to all data requests initiated by scrolling if the `Table`
+     * is bound against an OData service.
+     *
+     *
+     * @returns Reference to `this` in order to allow method chaining
+     */
+    setScrollThreshold(
+      /**
+       * The threshold for scrolling
+       */
+      iThreshold: int
+    ): this;
     /**
      * Sets the selected index. The previous selection is removed.
      *
@@ -9285,15 +9343,39 @@ declare module "sap/ui/table/Table" {
 
     /**
      * Defines how many additional (not yet visible) data records from the back-end system are pre-fetched to
-     * enable smooth scrolling. The threshold is always added to the `visibleRowCount`. If the `visibleRowCount`
-     * is 10 and the `threshold` is 100, there will be 110 records fetched with the initial load. If the `threshold`
-     * is lower than the number of rows in the scrollable area (`visibleRowCount` minus number of fixed rows),
-     * this number is used as the `threshold`. If the value is 0, thresholding is disabled.
+     * enable smooth scrolling. The threshold is always added to the number of rows. If the number of rows is
+     * 10 and the `threshold` is 100, 110 records will be fetched with the initial load. This property affects
+     * requests triggered by changes in the binding, for example, initial loading, sorting, filtering, etc.
+     * The threshold that is applied during scrolling can be configured with the `scrollThreshold` property.
+     * If the `threshold` is lower than the number of rows in the scrollable area (`visibleRowCount` minus number
+     * of fixed rows), this number is used as the `threshold`. If the value is 0, thresholding is disabled.
      */
     threshold?: int | PropertyBindingInfo | `{${string}}`;
 
+    /**
+     * Defines how many additional data records are requested from the back-end system when the user scrolls
+     * vertically in the table. The `scrollThreshold` is always added to the number of rows. If the number of
+     * rows is 10 and the `scrollThreshold` is 100, 110 records will be fetched during scrolling. The threshold
+     * that is applied to requests that are not initiated by scrolling can be configured with the `threshold`
+     * property. If the `scrollThreshold` is lower than the number of rows in the scrollable area (number of
+     * rows minus number of fixed rows), this number is used as the `scrollThreshold`. If the value is 0, no
+     * threshold is applied during scrolling. The value -1 applies the same value as the `threshold` property.
+     *
+     * **Note:** This property only takes effect if it is set to a positive integer value.
+     *
+     * For `AnalyticalTable` and `TreeTable`, the `scrollThreshold` property must be higher than the `threshold`
+     * property to take effect.
+     *
+     * @since 1.128
+     */
+    scrollThreshold?: int | PropertyBindingInfo | `{${string}}`;
+
     /**
      * Flag to enable or disable column reordering
+     *
+     * **Note**: Column reordering is possible via drag&drop and keyboard shortcuts. Single-pointer alternative
+     * is not provided out-of-the-box and should be implemented on application side. For example the {@link sap.m.p13n.Engine }
+     * can be used, see the following sample: {@link https://ui5.sap.com/#/entity/sap.ui.table.Table/sample/sap.m.sample.p13n.EngineGridTable Personalization for grid table}.
      */
     enableColumnReordering?: boolean | PropertyBindingInfo | `{${string}}`;
 

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

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