@sapui5/ts-types 1.110.1 → 1.111.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/package.json +1 -1
  2. package/types/sap.apf.d.ts +1 -1
  3. package/types/sap.ca.ui.d.ts +1 -1
  4. package/types/sap.chart.d.ts +1 -1
  5. package/types/sap.collaboration.d.ts +1 -1
  6. package/types/sap.esh.search.ui.d.ts +38 -1
  7. package/types/sap.f.d.ts +8 -11
  8. package/types/sap.fe.core.d.ts +23 -27
  9. package/types/sap.fe.macros.d.ts +170 -61
  10. package/types/sap.fe.navigation.d.ts +19 -52
  11. package/types/sap.fe.templates.d.ts +16 -16
  12. package/types/sap.fe.test.d.ts +61 -1
  13. package/types/sap.feedback.ui.d.ts +1 -1
  14. package/types/sap.gantt.d.ts +42 -1
  15. package/types/sap.insights.d.ts +1 -1
  16. package/types/sap.landvisz.d.ts +1 -1
  17. package/types/sap.m.d.ts +923 -375
  18. package/types/sap.makit.d.ts +1 -1
  19. package/types/sap.me.d.ts +1 -1
  20. package/types/sap.ndc.d.ts +1 -1
  21. package/types/sap.ovp.d.ts +3 -16
  22. package/types/sap.rules.ui.d.ts +1 -1
  23. package/types/sap.sac.df.d.ts +34 -1
  24. package/types/sap.sac.grid.d.ts +1 -1
  25. package/types/sap.suite.ui.commons.d.ts +64 -2
  26. package/types/sap.suite.ui.generic.template.d.ts +1 -1
  27. package/types/sap.suite.ui.microchart.d.ts +1 -1
  28. package/types/sap.tnt.d.ts +1 -1
  29. package/types/sap.ui.codeeditor.d.ts +1 -1
  30. package/types/sap.ui.commons.d.ts +1 -1
  31. package/types/sap.ui.comp.d.ts +13 -15
  32. package/types/sap.ui.core.d.ts +1370 -99
  33. package/types/sap.ui.dt.d.ts +1 -1
  34. package/types/sap.ui.export.d.ts +5 -1
  35. package/types/sap.ui.fl.d.ts +1 -1
  36. package/types/sap.ui.generic.app.d.ts +9 -7
  37. package/types/sap.ui.generic.template.d.ts +1 -1
  38. package/types/sap.ui.integration.d.ts +9 -8
  39. package/types/sap.ui.layout.d.ts +2 -2
  40. package/types/sap.ui.mdc.d.ts +10 -34
  41. package/types/sap.ui.richtexteditor.d.ts +8 -8
  42. package/types/sap.ui.rta.d.ts +1 -1
  43. package/types/sap.ui.suite.d.ts +1 -1
  44. package/types/sap.ui.support.d.ts +1 -1
  45. package/types/sap.ui.table.d.ts +4 -4
  46. package/types/sap.ui.testrecorder.d.ts +1 -1
  47. package/types/sap.ui.unified.d.ts +57 -2
  48. package/types/sap.ui.ux3.d.ts +1 -1
  49. package/types/sap.ui.vbm.d.ts +1 -1
  50. package/types/sap.ui.vk.d.ts +52 -1
  51. package/types/sap.ui.vtm.d.ts +1 -1
  52. package/types/sap.ui.webc.common.d.ts +1 -1
  53. package/types/sap.ui.webc.fiori.d.ts +1 -1
  54. package/types/sap.ui.webc.main.d.ts +1 -1
  55. package/types/sap.uiext.inbox.d.ts +1 -1
  56. package/types/sap.ushell.d.ts +2 -2
  57. package/types/sap.ushell_abap.d.ts +1 -1
  58. package/types/sap.uxap.d.ts +1 -1
  59. package/types/sap.viz.d.ts +1 -1
  60. package/types/sap.webanalytics.core.d.ts +1 -1
  61. package/types/sap.zen.commons.d.ts +1 -1
  62. package/types/sap.zen.crosstab.d.ts +1 -1
  63. package/types/sap.zen.dsh.d.ts +1 -1
package/types/sap.m.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- // For Library Version: 1.110.0
1
+ // For Library Version: 1.111.1
2
2
 
3
3
  declare namespace sap {
4
4
  /**
@@ -122,158 +122,6 @@ declare namespace sap {
122
122
  */
123
123
  value: any
124
124
  ): boolean;
125
- /**
126
- * @SINCE 1.12
127
- *
128
- * Helper for rendering themable background.
129
- */
130
- namespace BackgroundHelper {
131
- /**
132
- * Adds CSS classes and styles to the given RenderManager, depending on the given configuration for background
133
- * color and background image. To be called by control renderers supporting the global themable background
134
- * image within their root tag, before they call openEnd, voidEnd, writeClasses() and writeStyles().
135
- */
136
- function addBackgroundColorStyles(
137
- /**
138
- * The RenderManager
139
- */
140
- rm: sap.ui.core.RenderManager,
141
- /**
142
- * A configured custom background color for the control, if any
143
- */
144
- sBgColor?: sap.ui.core.CSSColor,
145
- /**
146
- * The configured custom background image for the control, if any
147
- */
148
- sBgImgUrl?: sap.ui.core.URI
149
- ): void;
150
- /**
151
- * Renders an HTML tag into the given RenderManager which carries the background image which is either configured
152
- * and given or coming from the current theme. Should be called right after the opening root tag has been
153
- * completed, so this is the first child element inside the control.
154
- */
155
- function renderBackgroundImageTag(
156
- /**
157
- * The RenderManager
158
- */
159
- rm: sap.ui.core.RenderManager,
160
- /**
161
- * Control within which the tag will be rendered; its ID will be used to generate the element ID
162
- */
163
- oControl: sap.ui.core.Control,
164
- /**
165
- * A CSS class or an array of CSS classes to add to the element
166
- */
167
- vCssClass: string | string[],
168
- /**
169
- * The image of a configured background image; if this is not given, the theme background will be used and
170
- * also the other settings are ignored.
171
- */
172
- sBgImgUrl?: sap.ui.core.URI,
173
- /**
174
- * Whether the background image should be repeated/tiled (or stretched)
175
- */
176
- bRepeat?: boolean,
177
- /**
178
- * The background image opacity, if any
179
- */
180
- fOpacity?: float
181
- ): void;
182
- }
183
- /**
184
- * @SINCE 1.12
185
- *
186
- * Helper for Images.
187
- */
188
- namespace ImageHelper {
189
- /**
190
- * Creates or updates an image control.
191
- *
192
- * @returns The new or updated image control or icon
193
- */
194
- function getImageControl(
195
- /**
196
- * UD of the image to be dealt with.
197
- */
198
- sImgId: string,
199
- /**
200
- * The image to update. If undefined, a new image will be created.
201
- */
202
- oImage: sap.m.Image,
203
- /**
204
- * oImageControl's parentControl.
205
- */
206
- oParent: sap.ui.core.Control,
207
- /**
208
- * Settings for the image control; the `src` property MUST be contained; the keys of the object must be
209
- * valid names of image settings
210
- */
211
- mProperties: object,
212
- /**
213
- * Array of CSS classes which will be added if the image needs to be created.
214
- */
215
- aCssClassesToAdd: string[],
216
- /**
217
- * All CSS classes that oImageControl has and which are contained in this array are removed before adding
218
- * the CSS classes listed in aCssClassesToAdd.
219
- */
220
- aCssClassesToRemove: string[]
221
- ): sap.m.Image | sap.ui.core.Icon;
222
- }
223
- /**
224
- * @SINCE 1.21.2
225
- *
226
- * Suggestion helper for `sap.m.Input` fields when used with an OData model.
227
- *
228
- * Creates a multi-column suggest list for an `sap.m.Input` field based on a `ValueList` annotation. The
229
- * `ValueList` annotation will be resolved via the binding information of the input field.
230
- *
231
- * If the annotation describes multiple input parameters, the suggest provider will resolve all of these
232
- * relative to the context of the input field and use them for the suggest query. The suggest provider will
233
- * write all values that are described as output parameters back to the model (relative to the context of
234
- * the input field). This can only be done if the model runs in "TwoWay" binding mode. Both features can
235
- * be switched off via the `bResolveInput/bResolveOutput` parameter of the suggest function.
236
- */
237
- namespace InputODataSuggestProvider {
238
- function suggest(
239
- oEvent: sap.ui.base.Event,
240
- /**
241
- * SuggestProvider resolves all input parameters for the data query
242
- */
243
- bResolveInput: boolean,
244
- /**
245
- * SuggestProvider writes back all output parameters.
246
- */
247
- bResolveOutput: boolean,
248
- /**
249
- * If iLength is provided only these number of entries will be requested.
250
- */
251
- iLength: int
252
- ): void;
253
- }
254
- /**
255
- * @SINCE 1.16.7
256
- *
257
- * Helper for Popups.
258
- */
259
- namespace PopupHelper {
260
- /**
261
- * Converts the given percentage value to an absolute number based on the given base size.
262
- *
263
- * @returns The calculated size string with "px" as unit or `null` when the format of given parameter is
264
- * wrong.
265
- */
266
- function calcPercentageSize(
267
- /**
268
- * A percentage value in string format, for example "25%"
269
- */
270
- sPercentage: string,
271
- /**
272
- * A float number which the calculation is based on.
273
- */
274
- fBaseSize: float
275
- ): string | null;
276
- }
277
125
  /**
278
126
  * Touch helper.
279
127
  */
@@ -708,7 +556,16 @@ declare namespace sap {
708
556
  /**
709
557
  * Parameters to pass along with the event
710
558
  */
711
- mParameters?: object
559
+ mParameters?: {
560
+ /**
561
+ * The reason why the panel state has changed, for example, items have been added, removed, or moved.
562
+ */
563
+ reason?: string;
564
+ /**
565
+ * An object containing information about the specific item that has been changed.
566
+ */
567
+ item?: sap.m.p13n.Item;
568
+ }
712
569
  ): this;
713
570
  /**
714
571
  * Gets current value of property {@link #getEnableReorder enableReorder}.
@@ -871,8 +728,8 @@ declare namespace sap {
871
728
  /**
872
729
  * The state object
873
730
  */
874
- oState: object
875
- ): Promise<any>;
731
+ oState: sap.m.p13n.State
732
+ ): Promise<sap.m.p13n.State>;
876
733
  /**
877
734
  * Attaches an event handler to the `StateHandlerRegistry` class. The event handler is fired every time
878
735
  * a user triggers a personalization change for a control instance during runtime.
@@ -883,7 +740,7 @@ declare namespace sap {
883
740
  /**
884
741
  * The handler function to call when the event occurs
885
742
  */
886
- fnStateEventHandler: Function
743
+ fnStateEventHandler: (p1: sap.ui.base.Event) => void
887
744
  ): this;
888
745
  /**
889
746
  * Unregisters a registered control. By unregistering a control the control is removed from the `Engine`
@@ -905,7 +762,7 @@ declare namespace sap {
905
762
  /**
906
763
  * The handler function to detach from the event
907
764
  */
908
- fnStateEventHandler: Function
765
+ fnStateEventHandler: (p1: sap.ui.base.Event) => void
909
766
  ): this;
910
767
 
911
768
  register(
@@ -916,7 +773,7 @@ declare namespace sap {
916
773
  /**
917
774
  * The Engine registration configuration
918
775
  */
919
- oConfig: /* was: sap.m.p13n.EngineRegistrationConfig */ any
776
+ oConfig: sap.m.p13n.EngineRegistrationConfig
920
777
  ): void;
921
778
  /**
922
779
  * This method can be used to trigger a reset to the provided control instance.
@@ -932,7 +789,7 @@ declare namespace sap {
932
789
  * The key for the affected configuration
933
790
  */
934
791
  aKeys: string
935
- ): Promise<any>;
792
+ ): Promise<null>;
936
793
  /**
937
794
  * @EXPERIMENTAL (since 1.104) - Please note that the API of this control is not yet finalized!
938
795
  *
@@ -946,8 +803,8 @@ declare namespace sap {
946
803
  /**
947
804
  * The control instance implementing IxState to retrieve the externalized state
948
805
  */
949
- oControl: object
950
- ): Promise<any>;
806
+ oControl: sap.ui.core.Control
807
+ ): Promise<sap.m.p13n.State>;
951
808
  /**
952
809
  * Opens the personalization dialog.
953
810
  *
@@ -988,7 +845,7 @@ declare namespace sap {
988
845
  */
989
846
  contentWidth?: object;
990
847
  }
991
- ): Promise<any>;
848
+ ): Promise<sap.m.p13n.Popup>;
992
849
  }
993
850
  /**
994
851
  * @SINCE 1.104
@@ -1361,7 +1218,12 @@ declare namespace sap {
1361
1218
  /**
1362
1219
  * Parameters to pass along with the event
1363
1220
  */
1364
- mParameters?: object
1221
+ mParameters?: {
1222
+ /**
1223
+ * The corresponding reason for closing the dialog (Ok & Cancel).
1224
+ */
1225
+ reason?: string;
1226
+ }
1365
1227
  ): this;
1366
1228
  /**
1367
1229
  * Gets content of aggregation {@link #getAdditionalButtons additionalButtons}.
@@ -2038,6 +1900,24 @@ declare namespace sap {
2038
1900
  ): this;
2039
1901
  }
2040
1902
 
1903
+ /**
1904
+ * The central registration for personalization functionality. The registration is a precondition for using
1905
+ * `Engine` functionality for a control instance. Once the control instance has been registered, it can
1906
+ * be passed to the related `Engine` methods that always expect a control instance as parameter. Only registered
1907
+ * control instances can be used for personalization through the `Engine`.
1908
+ */
1909
+ type EngineRegistrationConfig = {
1910
+ /**
1911
+ * The `{@link sap.m.p13n.modification.MetadataHelper MetadataHelper}` to provide metadata-specific information.
1912
+ */
1913
+ helper: sap.m.p13n.MetadataHelper;
1914
+ /**
1915
+ * A map of arbitrary keys that contain a controller instance as value. The key must be unique and needs
1916
+ * to be provided for later access when using `Engine` functionality specific for one controller type.
1917
+ */
1918
+ controller: Record<string, sap.m.p13n.SelectionController>;
1919
+ };
1920
+
2041
1921
  /**
2042
1922
  * P13n `GroupItem` object type.
2043
1923
  */
@@ -2095,6 +1975,14 @@ declare namespace sap {
2095
1975
  */
2096
1976
  descending: boolean;
2097
1977
  };
1978
+
1979
+ type State = {
1980
+ /**
1981
+ * A map of arbitrary keys that contain a controller instance as value. The key must be unique and needs
1982
+ * to be provided for later access when using `Engine` functionality specific for one controller type.
1983
+ */
1984
+ controller: Record<string, Object[]>;
1985
+ };
2098
1986
  }
2099
1987
 
2100
1988
  namespace PlanningCalendar {
@@ -2110,6 +1998,26 @@ declare namespace sap {
2110
1998
  }
2111
1999
 
2112
2000
  namespace plugins {
2001
+ namespace CopyProvider {
2002
+ /**
2003
+ * Callback function to exclude certain contexts from being copied to the clipboard.
2004
+ */
2005
+ type excludeContextHandler = (
2006
+ oContextOrRow: sap.ui.model.Context | sap.m.ColumnListItem
2007
+ ) => boolean;
2008
+
2009
+ /**
2010
+ * Callback function to extract the cell data that is copied to the clipboard.
2011
+ */
2012
+ type extractDataHandler = (
2013
+ oContextOrRow: sap.ui.model.Context | sap.m.ColumnListItem,
2014
+ oColumn:
2015
+ | sap.m.Column
2016
+ | /* was: sap.ui.table.Column */ any
2017
+ | /* was: sap.ui.mdc.table.Column */ any
2018
+ ) => any | any[] | undefined | null;
2019
+ }
2020
+
2113
2021
  interface $ColumnResizerSettings extends sap.ui.core.$ElementSettings {
2114
2022
  /**
2115
2023
  * This event is fired when the column is resized.
@@ -2119,7 +2027,7 @@ declare namespace sap {
2119
2027
 
2120
2028
  interface $CopyProviderSettings extends sap.ui.core.$ElementSettings {
2121
2029
  /**
2122
- * Defines a {@link sap.m.plugins.CopyProvider~extractDataHandler callback function} that gets called for
2030
+ * Defines a {@link sap.m.plugins.CopyProvider.extractDataHandler callback function} that gets called for
2123
2031
  * each selected cell to extract the cell data that is copied to the clipboard.
2124
2032
  *
2125
2033
  * The callback function gets called with the binding context of the selected row and the column instance
@@ -2155,7 +2063,7 @@ declare namespace sap {
2155
2063
  | `{${string}}`;
2156
2064
 
2157
2065
  /**
2158
- * Defines a {@link sap.m.plugins.CopyProvider~excludeContextHandler callback function} which gets called
2066
+ * Defines a {@link sap.m.plugins.CopyProvider.excludeContextHandler callback function} which gets called
2159
2067
  * to exclude certain contexts from being copied to the clipboard.
2160
2068
  *
2161
2069
  * This callback function gets called with the binding context or the row instance if there is no binding.
@@ -2609,7 +2517,7 @@ declare namespace sap {
2609
2517
  /**
2610
2518
  * Gets current value of property {@link #getExcludeContext excludeContext}.
2611
2519
  *
2612
- * Defines a {@link sap.m.plugins.CopyProvider~excludeContextHandler callback function} which gets called
2520
+ * Defines a {@link sap.m.plugins.CopyProvider.excludeContextHandler callback function} which gets called
2613
2521
  * to exclude certain contexts from being copied to the clipboard.
2614
2522
  *
2615
2523
  * This callback function gets called with the binding context or the row instance if there is no binding.
@@ -2621,7 +2529,7 @@ declare namespace sap {
2621
2529
  /**
2622
2530
  * Gets current value of property {@link #getExtractData extractData}.
2623
2531
  *
2624
- * Defines a {@link sap.m.plugins.CopyProvider~extractDataHandler callback function} that gets called for
2532
+ * Defines a {@link sap.m.plugins.CopyProvider.extractDataHandler callback function} that gets called for
2625
2533
  * each selected cell to extract the cell data that is copied to the clipboard.
2626
2534
  *
2627
2535
  * The callback function gets called with the binding context of the selected row and the column instance
@@ -2674,7 +2582,7 @@ declare namespace sap {
2674
2582
  /**
2675
2583
  * Sets a new value for property {@link #getExcludeContext excludeContext}.
2676
2584
  *
2677
- * Defines a {@link sap.m.plugins.CopyProvider~excludeContextHandler callback function} which gets called
2585
+ * Defines a {@link sap.m.plugins.CopyProvider.excludeContextHandler callback function} which gets called
2678
2586
  * to exclude certain contexts from being copied to the clipboard.
2679
2587
  *
2680
2588
  * This callback function gets called with the binding context or the row instance if there is no binding.
@@ -2693,7 +2601,7 @@ declare namespace sap {
2693
2601
  /**
2694
2602
  * Sets a new value for property {@link #getExtractData extractData}.
2695
2603
  *
2696
- * Defines a {@link sap.m.plugins.CopyProvider~extractDataHandler callback function} that gets called for
2604
+ * Defines a {@link sap.m.plugins.CopyProvider.extractDataHandler callback function} that gets called for
2697
2605
  * each selected cell to extract the cell data that is copied to the clipboard.
2698
2606
  *
2699
2607
  * The callback function gets called with the binding context of the selected row and the column instance
@@ -9963,7 +9871,8 @@ declare namespace sap {
9963
9871
  | `{${string}}`;
9964
9872
 
9965
9873
  /**
9966
- * This event is fired when the action item is pressed.
9874
+ * This event is fired when the action item is pressed. The default behavior can be prevented by the application,
9875
+ * in which case the menu will not close.
9967
9876
  */
9968
9877
  press?: (oEvent: sap.ui.base.Event) => void;
9969
9878
  }
@@ -10283,7 +10192,8 @@ declare namespace sap {
10283
10192
  * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
10284
10193
  * otherwise it will be bound to this `sap.m.table.columnmenu.ActionItem` itself.
10285
10194
  *
10286
- * This event is fired when the action item is pressed.
10195
+ * This event is fired when the action item is pressed. The default behavior can be prevented by the application,
10196
+ * in which case the menu will not close.
10287
10197
  *
10288
10198
  * @returns Reference to `this` in order to allow method chaining
10289
10199
  */
@@ -10308,7 +10218,8 @@ declare namespace sap {
10308
10218
  * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
10309
10219
  * otherwise it will be bound to this `sap.m.table.columnmenu.ActionItem` itself.
10310
10220
  *
10311
- * This event is fired when the action item is pressed.
10221
+ * This event is fired when the action item is pressed. The default behavior can be prevented by the application,
10222
+ * in which case the menu will not close.
10312
10223
  *
10313
10224
  * @returns Reference to `this` in order to allow method chaining
10314
10225
  */
@@ -10342,14 +10253,17 @@ declare namespace sap {
10342
10253
  /**
10343
10254
  * Fires event {@link #event:press press} to attached listeners.
10344
10255
  *
10345
- * @returns Reference to `this` in order to allow method chaining
10256
+ * Listeners may prevent the default action of this event by calling the `preventDefault` method on the
10257
+ * event object. The return value of this method indicates whether the default action should be executed.
10258
+ *
10259
+ * @returns Whether or not to prevent the default action
10346
10260
  */
10347
10261
  firePress(
10348
10262
  /**
10349
10263
  * Parameters to pass along with the event
10350
10264
  */
10351
10265
  mParameters?: object
10352
- ): this;
10266
+ ): boolean;
10353
10267
  /**
10354
10268
  * Gets current value of property {@link #getIcon icon}.
10355
10269
  *
@@ -11227,7 +11141,10 @@ declare namespace sap {
11227
11141
  /**
11228
11142
  * Fires event {@link #event:beforeOpen beforeOpen} to attached listeners.
11229
11143
  *
11230
- * @returns Reference to `this` in order to allow method chaining
11144
+ * Listeners may prevent the default action of this event by calling the `preventDefault` method on the
11145
+ * event object. The return value of this method indicates whether the default action should be executed.
11146
+ *
11147
+ * @returns Whether or not to prevent the default action
11231
11148
  */
11232
11149
  fireBeforeOpen(
11233
11150
  /**
@@ -11240,7 +11157,7 @@ declare namespace sap {
11240
11157
  */
11241
11158
  openBy?: sap.ui.core.Element;
11242
11159
  }
11243
- ): this;
11160
+ ): boolean;
11244
11161
  /**
11245
11162
  * @SINCE 1.98.0
11246
11163
  *
@@ -11326,7 +11243,11 @@ declare namespace sap {
11326
11243
  /**
11327
11244
  * This is the control or HTMLElement where the popover is placed.
11328
11245
  */
11329
- oAnchor: sap.ui.core.Control | HTMLElement
11246
+ oAnchor: sap.ui.core.Control | HTMLElement,
11247
+ /**
11248
+ * Whether to suppress the beforeOpen event.
11249
+ */
11250
+ bSuppressEvent?: boolean
11330
11251
  ): void;
11331
11252
  /**
11332
11253
  * Removes all the controls from the aggregation {@link #getItems items}.
@@ -11369,7 +11290,6 @@ declare namespace sap {
11369
11290
  }
11370
11291
  /**
11371
11292
  * @SINCE 1.110
11372
- * @EXPERIMENTAL
11373
11293
  *
11374
11294
  * The `QuickAction` class is used for quick actions for the `sap.m.table.columnmenu.Menu`. It can be used
11375
11295
  * to specify control- and application-specific quick actions.
@@ -12416,8 +12336,8 @@ declare namespace sap {
12416
12336
  /**
12417
12337
  * @SINCE 1.110
12418
12338
  *
12419
- * The `QuickTotal` class is used for quick totalling for the `sap.m.table.columnmenu.Menu`. It can be used
12420
- * to specify control- and application-specific quick actions for totalling.
12339
+ * The `QuickTotal` class is used for quick totaling for the `sap.m.table.columnmenu.Menu`. It can be used
12340
+ * to specify control- and application-specific quick actions for totaling.
12421
12341
  */
12422
12342
  class QuickTotal extends sap.m.table.columnmenu.QuickActionBase {
12423
12343
  /**
@@ -12638,7 +12558,7 @@ declare namespace sap {
12638
12558
  * @SINCE 1.110
12639
12559
  *
12640
12560
  * The `QuickTotalItem` class is used for items for the `sap.m.table.columnmenu.QuickTotal`. It can be used
12641
- * to specify control- and application-specific items for totalling.
12561
+ * to specify control- and application-specific items for totaling.
12642
12562
  */
12643
12563
  class QuickTotalItem extends sap.m.table.columnmenu.QuickActionItem {
12644
12564
  /**
@@ -17574,12 +17494,7 @@ declare namespace sap {
17574
17494
  *
17575
17495
  * @returns The number of tickmarks
17576
17496
  */
17577
- getTickmarksBetweenLabels(
17578
- /**
17579
- * The option array
17580
- */
17581
- mOptions: object
17582
- ): int;
17497
+ getTickmarksBetweenLabels(): int;
17583
17498
  /**
17584
17499
  * Called, when the slider is getting resized.
17585
17500
  *
@@ -18627,8 +18542,9 @@ declare namespace sap {
18627
18542
  | `{${string}}`;
18628
18543
 
18629
18544
  /**
18630
- * Disables the Checkbox. Disabled controls are not interactive and are rendered differently according to
18631
- * the theme.
18545
+ * Whether the `CheckBox` is enabled.
18546
+ *
18547
+ * **Note:** Disabled `CheckBox` is not interactive and is rendered differently according to the theme.
18632
18548
  */
18633
18549
  enabled?:
18634
18550
  | boolean
@@ -20275,6 +20191,17 @@ declare namespace sap {
20275
20191
  | sap.ui.base.ManagedObject.PropertyBindingInfo
20276
20192
  | `{${string}}`;
20277
20193
 
20194
+ /**
20195
+ * @SINCE 1.111.0
20196
+ *
20197
+ * If set, the calendar week numbering is used for display. If not set, the calendar week numbering of the
20198
+ * global configuration is used.
20199
+ */
20200
+ calendarWeekNumbering?:
20201
+ | sap.ui.core.date.CalendarWeekNumbering
20202
+ | sap.ui.base.ManagedObject.PropertyBindingInfo
20203
+ | `{${string}}`;
20204
+
20278
20205
  /**
20279
20206
  * @SINCE 1.92
20280
20207
  *
@@ -22407,12 +22334,24 @@ declare namespace sap {
22407
22334
  *
22408
22335
  * Defines the description displayed below the title.
22409
22336
  *
22410
- * If there is no initial input from the app developer and the default illustration set is being used, a
22411
- * default description for the current illustration type is going to be displayed. The default description
22412
- * is stored in the `sap.m` resource bundle.
22337
+ * If there is no initial input from the app developer, `enableDefaultTitleAndDescription` is `true` and
22338
+ * the default illustration set is being used, a default description for the current illustration type is
22339
+ * going to be displayed. The default description is stored in the `sap.m` resource bundle.
22413
22340
  */
22414
22341
  description?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
22415
22342
 
22343
+ /**
22344
+ * @SINCE 1.111
22345
+ *
22346
+ * Defines whether the default title and description should be used when the input for their respective
22347
+ * part is empty and the default illustration set is being used. Title and description are stored in the
22348
+ * `sap.m` resource bundle.
22349
+ */
22350
+ enableDefaultTitleAndDescription?:
22351
+ | boolean
22352
+ | sap.ui.base.ManagedObject.PropertyBindingInfo
22353
+ | `{${string}}`;
22354
+
22416
22355
  /**
22417
22356
  * @SINCE 1.98
22418
22357
  *
@@ -22469,8 +22408,9 @@ declare namespace sap {
22469
22408
  *
22470
22409
  * Defines the title that is displayed below the illustration.
22471
22410
  *
22472
- * If there is no initial input from the app developer and the default illustration set is being used, a
22473
- * default title is displayed corresponding to the current `illustrationType`.
22411
+ * If there is no initial input from the app developer, `enableDefaultTitleAndDescription` is `true` and
22412
+ * the default illustration set is being used, a default title is displayed corresponding to the current
22413
+ * `illustrationType`. The default title is stored in the `sap.m` resource bundle.
22474
22414
  */
22475
22415
  title?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
22476
22416
 
@@ -24640,8 +24580,7 @@ declare namespace sap {
24640
24580
  * A list with message items.
24641
24581
  */
24642
24582
  items?:
24643
- | Array<sap.m.MessagePopoverItem | sap.m.MessageItem>
24644
- | sap.m.MessagePopoverItem
24583
+ | sap.m.MessageItem[]
24645
24584
  | sap.m.MessageItem
24646
24585
  | sap.ui.base.ManagedObject.AggregationBindingInfo
24647
24586
  | `{${string}}`;
@@ -25039,9 +24978,19 @@ declare namespace sap {
25039
24978
  *
25040
24979
  * The event is fired when navigation between two pages has completed (once all events to the child controls
25041
24980
  * have been fired). In case of animated transitions this event is fired with some delay after the "navigate"
25042
- * event.
24981
+ * event. This event is only fired if the DOM ref of the `NavContainer` is available. If the DOM ref is
24982
+ * not available, the `navigationFinished` event should be used instead.
25043
24983
  */
25044
24984
  afterNavigate?: (oEvent: sap.ui.base.Event) => void;
24985
+
24986
+ /**
24987
+ * @SINCE 1.111.0
24988
+ *
24989
+ * The event is fired when navigation between two pages has completed regardless of whether the DOM is ready
24990
+ * or not. This event is useful when performing navigation without/before rendering of the `NavContainer`.
24991
+ * Keep in mind that the DOM is not guaranteed to be ready when this event is fired.
24992
+ */
24993
+ navigationFinished?: (oEvent: sap.ui.base.Event) => void;
25045
24994
  }
25046
24995
 
25047
24996
  interface $NewsContentSettings extends sap.ui.core.$ControlSettings {
@@ -28749,9 +28698,7 @@ declare namespace sap {
28749
28698
  | `{${string}}`;
28750
28699
 
28751
28700
  /**
28752
- * @deprecated (since 1.15.0) - This property is deprecated. Please use properties verticalScrolling and
28753
- * horizontalScrolling instead. If you still use this property it will be mapped on the new properties verticalScrolling
28754
- * and horizontalScrolling.
28701
+ * @deprecated (since 1.15.0)
28755
28702
  *
28756
28703
  * This property is deprecated. Please use properties verticalScrolling and horizontalScrolling instead.
28757
28704
  * If you still use this property it will be mapped on the new properties verticalScrolling and horizontalScrolling.
@@ -29253,6 +29200,8 @@ declare namespace sap {
29253
29200
  titleUrl?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
29254
29201
 
29255
29202
  /**
29203
+ * @deprecated (since 1.111) - Attach avatar `press` event instead.
29204
+ *
29256
29205
  * Specifies the application which provides target and param configuration for cross-application navigation
29257
29206
  * from the 'page header'.
29258
29207
  */
@@ -31830,7 +31779,18 @@ declare namespace sap {
31830
31779
  }
31831
31780
 
31832
31781
  interface $StandardDynamicDateOptionSettings
31833
- extends sap.m.$DynamicDateOptionSettings {}
31782
+ extends sap.m.$DynamicDateOptionSettings {
31783
+ /**
31784
+ * @SINCE 1.111.0
31785
+ *
31786
+ * If set, the calendar week numbering is used for display. If not set, the calendar week numbering of the
31787
+ * global configuration is used.
31788
+ */
31789
+ calendarWeekNumbering?:
31790
+ | sap.ui.core.date.CalendarWeekNumbering
31791
+ | sap.ui.base.ManagedObject.PropertyBindingInfo
31792
+ | `{${string}}`;
31793
+ }
31834
31794
 
31835
31795
  interface $StandardListItemSettings extends sap.m.$ListItemBaseSettings {
31836
31796
  /**
@@ -35022,6 +34982,66 @@ declare namespace sap {
35022
34982
  activate?: (oEvent: sap.ui.base.Event) => void;
35023
34983
  }
35024
34984
 
34985
+ /**
34986
+ * @SINCE 1.12
34987
+ *
34988
+ * Helper for rendering themable background.
34989
+ */
34990
+ interface BackgroundHelper {
34991
+ /**
34992
+ * Adds CSS classes and styles to the given RenderManager, depending on the given configuration for background
34993
+ * color and background image. To be called by control renderers supporting the global themable background
34994
+ * image within their root tag, before they call openEnd, voidEnd, writeClasses() and writeStyles().
34995
+ */
34996
+ addBackgroundColorStyles(
34997
+ /**
34998
+ * The RenderManager
34999
+ */
35000
+ rm: sap.ui.core.RenderManager,
35001
+ /**
35002
+ * A configured custom background color for the control, if any
35003
+ */
35004
+ sBgColor?: sap.ui.core.CSSColor,
35005
+ /**
35006
+ * The configured custom background image for the control, if any
35007
+ */
35008
+ sBgImgUrl?: sap.ui.core.URI
35009
+ ): void;
35010
+ /**
35011
+ * Renders an HTML tag into the given RenderManager which carries the background image which is either configured
35012
+ * and given or coming from the current theme. Should be called right after the opening root tag has been
35013
+ * completed, so this is the first child element inside the control.
35014
+ */
35015
+ renderBackgroundImageTag(
35016
+ /**
35017
+ * The RenderManager
35018
+ */
35019
+ rm: sap.ui.core.RenderManager,
35020
+ /**
35021
+ * Control within which the tag will be rendered; its ID will be used to generate the element ID
35022
+ */
35023
+ oControl: sap.ui.core.Control,
35024
+ /**
35025
+ * A CSS class or an array of CSS classes to add to the element
35026
+ */
35027
+ vCssClass: string | string[],
35028
+ /**
35029
+ * The image of a configured background image; if this is not given, the theme background will be used and
35030
+ * also the other settings are ignored.
35031
+ */
35032
+ sBgImgUrl?: sap.ui.core.URI,
35033
+ /**
35034
+ * Whether the background image should be repeated/tiled (or stretched)
35035
+ */
35036
+ bRepeat?: boolean,
35037
+ /**
35038
+ * The background image opacity, if any
35039
+ */
35040
+ fOpacity?: float
35041
+ ): void;
35042
+ }
35043
+ const BackgroundHelper: BackgroundHelper;
35044
+
35025
35045
  /**
35026
35046
  * @EXPERIMENTAL (since 1.92) - This class is experimental and provides only limited functionality. Also
35027
35047
  * the API might be changed in future.
@@ -35062,9 +35082,9 @@ declare namespace sap {
35062
35082
  */
35063
35083
  getStandardKeys(): string[];
35064
35084
  /**
35065
- * Parses a string to an array of objects in the DynamicDateRange's value format. Uses the provided formatter.
35085
+ * Parses a string to an array of objects of type `sap.m.DynamicDateRangeValue`. Uses the provided formatter.
35066
35086
  *
35067
- * @returns An array of value objects in the DynamicDateRange's value format
35087
+ * @returns An array of `sap.m.DynamicDateRangeValue` objects
35068
35088
  */
35069
35089
  parse(
35070
35090
  /**
@@ -35078,8 +35098,8 @@ declare namespace sap {
35078
35098
  /**
35079
35099
  * array of option names
35080
35100
  */
35081
- aOptionKeys: any[]
35082
- ): object[];
35101
+ aOptionKeys: string[]
35102
+ ): sap.m.DynamicDateRangeValue[];
35083
35103
  /**
35084
35104
  * Returns a date in machine timezone setting, removing the offset added by the application configuration.
35085
35105
  *
@@ -35100,7 +35120,11 @@ declare namespace sap {
35100
35120
  /**
35101
35121
  * The provided value
35102
35122
  */
35103
- oValue: string
35123
+ oValue: string,
35124
+ /**
35125
+ * The type of calendar week numbering
35126
+ */
35127
+ sCalendarWeekNumbering: string
35104
35128
  ): /* was: sap.ui.core.date.UniversalDate */ any[];
35105
35129
  }
35106
35130
  const DynamicDateUtil: DynamicDateUtil;
@@ -35172,6 +35196,48 @@ declare namespace sap {
35172
35196
  }
35173
35197
  const IllustrationPool: IllustrationPool;
35174
35198
 
35199
+ /**
35200
+ * @SINCE 1.12
35201
+ *
35202
+ * Helper for Images.
35203
+ */
35204
+ interface ImageHelper {
35205
+ /**
35206
+ * Creates or updates an image control.
35207
+ *
35208
+ * @returns The new or updated image control or icon
35209
+ */
35210
+ getImageControl(
35211
+ /**
35212
+ * UD of the image to be dealt with.
35213
+ */
35214
+ sImgId: string,
35215
+ /**
35216
+ * The image to update. If undefined, a new image will be created.
35217
+ */
35218
+ oImage: sap.m.Image,
35219
+ /**
35220
+ * oImageControl's parentControl.
35221
+ */
35222
+ oParent: sap.ui.core.Control,
35223
+ /**
35224
+ * Settings for the image control; the `src` property MUST be contained; the keys of the object must be
35225
+ * valid names of image settings
35226
+ */
35227
+ mProperties: object,
35228
+ /**
35229
+ * Array of CSS classes which will be added if the image needs to be created.
35230
+ */
35231
+ aCssClassesToAdd: string[],
35232
+ /**
35233
+ * All CSS classes that oImageControl has and which are contained in this array are removed before adding
35234
+ * the CSS classes listed in aCssClassesToAdd.
35235
+ */
35236
+ aCssClassesToRemove: string[]
35237
+ ): sap.m.Image | sap.ui.core.Icon;
35238
+ }
35239
+ const ImageHelper: ImageHelper;
35240
+
35175
35241
  /**
35176
35242
  * InputBase renderer.
35177
35243
  */
@@ -35353,13 +35419,15 @@ declare namespace sap {
35353
35419
  ): void;
35354
35420
  /**
35355
35421
  * Returns the accessibility state of the control. Hook for the subclasses.
35422
+ *
35423
+ * @returns Accessibility state object
35356
35424
  */
35357
35425
  getAccessibilityState(
35358
35426
  /**
35359
35427
  * an object representation of the control.
35360
35428
  */
35361
35429
  oControl: sap.m.InputBase
35362
- ): Object;
35430
+ ): sap.m.InputBaseAccessibilityState;
35363
35431
  /**
35364
35432
  * Returns the inner aria describedby ids for the accessibility. Hook for the subclasses.
35365
35433
  */
@@ -35570,6 +35638,39 @@ declare namespace sap {
35570
35638
  }
35571
35639
  const InputBaseRenderer: InputBaseRenderer;
35572
35640
 
35641
+ /**
35642
+ * @SINCE 1.21.2
35643
+ *
35644
+ * Suggestion helper for `sap.m.Input` fields when used with an OData model.
35645
+ *
35646
+ * Creates a multi-column suggest list for an `sap.m.Input` field based on a `ValueList` annotation. The
35647
+ * `ValueList` annotation will be resolved via the binding information of the input field.
35648
+ *
35649
+ * If the annotation describes multiple input parameters, the suggest provider will resolve all of these
35650
+ * relative to the context of the input field and use them for the suggest query. The suggest provider will
35651
+ * write all values that are described as output parameters back to the model (relative to the context of
35652
+ * the input field). This can only be done if the model runs in "TwoWay" binding mode. Both features can
35653
+ * be switched off via the `bResolveInput/bResolveOutput` parameter of the suggest function.
35654
+ */
35655
+ interface InputODataSuggestProvider {
35656
+ suggest(
35657
+ oEvent: sap.ui.base.Event,
35658
+ /**
35659
+ * SuggestProvider resolves all input parameters for the data query
35660
+ */
35661
+ bResolveInput: boolean,
35662
+ /**
35663
+ * SuggestProvider writes back all output parameters.
35664
+ */
35665
+ bResolveOutput: boolean,
35666
+ /**
35667
+ * If iLength is provided only these number of entries will be requested.
35668
+ */
35669
+ iLength: int
35670
+ ): void;
35671
+ }
35672
+ const InputODataSuggestProvider: InputODataSuggestProvider;
35673
+
35573
35674
  /**
35574
35675
  * Input renderer.
35575
35676
  *
@@ -35932,8 +36033,7 @@ declare namespace sap {
35932
36033
  * Provides easier methods to create sap.m.Dialog with type sap.m.DialogType.Message, such as standard alerts,
35933
36034
  * confirmation dialogs, or arbitrary message dialogs.
35934
36035
  *
35935
- * Because the `MessageBox` is a static class, a `sap.ui.require("sap/m/MessageBox");` statement must be
35936
- * explicitly executed prior using the class. MessageBox provides several functions:
36036
+ * MessageBox provides several functions:
35937
36037
  * - `show()` - This is the generic way to open a message dialog. You can customize its contents through
35938
36038
  * the `mOptions` parameter described below.
35939
36039
  * - `alert()`, `confirm()`, `error()`, `information()`, `success()` and `warning()` - predefined templates
@@ -35941,10 +36041,10 @@ declare namespace sap {
35941
36041
  * to its semantic. Although the full set of `mOptions` (applicable to `show()`) are available to them,
35942
36042
  * it is recommended to only use the documented options.
35943
36043
  *
35944
- * **NOTE:** All options of show() are available for the other template functions as well, but it is recommended
35945
- * to use show() only in more specific scenarios. **NOTE:** Due to the static nature of the `MessageBox`
36044
+ * **Note:** All options of show() are available for the other template functions as well, but it is recommended
36045
+ * to use show() only in more specific scenarios. **Note:** Due to the static nature of the `MessageBox`
35946
36046
  * class, you cannot expect data binding support from its helper functions. If this is required you can
35947
- * use the `sap.m.Dialog` instead. **NOTE:** When using the `MessageBox.Error` method, there is no
36047
+ * use the `sap.m.Dialog` instead. **Note:** When using the `MessageBox.Error` method, there is no
35948
36048
  * emphasized action by design.
35949
36049
  *
35950
36050
  * Example:
@@ -36070,13 +36170,16 @@ declare namespace sap {
36070
36170
  */
36071
36171
  horizontalScrolling?: boolean;
36072
36172
  /**
36073
- * Added since version 1.28.0. If 'details' is set, a link to view details is added. When the user clicks
36074
- * the link, the text area containing 'details' information is displayed. The initial visibility is not
36075
- * configurable and the details are hidden by default.
36076
- * If object is given, it will be serialized using `JSON.stringify`.
36077
- * Since version 1.103, a callback function can be used. It should return a promise, that resolves with
36078
- * a `string` value or a JSON object, which will be stringified, or rejects - in this case a default error
36079
- * message will be displayed.
36173
+ * Added since version 1.28.0. If set, a link to view details is added. When the user clicks the link, the
36174
+ * text area containing 'details' information is displayed. The initial visibility is not configurable and
36175
+ * the details are hidden by default.
36176
+ * The following details can be used:
36177
+ * - `string` - text in HTML format. For full list of supported HTML tags see {@link sap.m.FormattedText}
36178
+ *
36179
+ * - `object` - JSON object that will be serialized using `JSON.stringify`
36180
+ * - `function` - since version 1.103, a callback function that fetches the details asynchronously. It
36181
+ * should return a promise that resolves with a `string` value or an `object`, or rejects - in this case
36182
+ * a default error message will be displayed
36080
36183
  */
36081
36184
  details?: string | object | (() => Promise<string | object>);
36082
36185
  /**
@@ -36188,13 +36291,16 @@ declare namespace sap {
36188
36291
  */
36189
36292
  horizontalScrolling?: boolean;
36190
36293
  /**
36191
- * Added since version 1.28.0. If 'details' is set, a link to view details is added. When the user clicks
36192
- * the link, the text area containing 'details' information is displayed. The initial visibility is not
36193
- * configurable and the details are hidden by default.
36194
- * If object is given, it will be serialized using `JSON.stringify`.
36195
- * Since version 1.103, a callback function can be used. It should return a promise, that resolves with
36196
- * a `string` value or a JSON object, which will be stringified, or rejects - in this case a default error
36197
- * message will be displayed.
36294
+ * Added since version 1.28.0. If set, a link to view details is added. When the user clicks the link, the
36295
+ * text area containing 'details' information is displayed. The initial visibility is not configurable and
36296
+ * the details are hidden by default.
36297
+ * The following details can be used:
36298
+ * - `string` - text in HTML format. For full list of supported HTML tags see {@link sap.m.FormattedText}
36299
+ *
36300
+ * - `object` - JSON object that will be serialized using `JSON.stringify`
36301
+ * - `function` - since version 1.103, a callback function that fetches the details asynchronously. It
36302
+ * should return a promise that resolves with a `string` value or an `object`, or rejects - in this case
36303
+ * a default error message will be displayed
36198
36304
  */
36199
36305
  details?: string | object | (() => Promise<string | object>);
36200
36306
  /**
@@ -36301,13 +36407,16 @@ declare namespace sap {
36301
36407
  */
36302
36408
  horizontalScrolling?: boolean;
36303
36409
  /**
36304
- * Added since version 1.28.0. If 'details' is set, a link to view details is added. When the user clicks
36305
- * the link, the text area containing 'details' information is displayed. The initial visibility is not
36306
- * configurable and the details are hidden by default.
36307
- * If object is given, it will be serialized using `JSON.stringify`.
36308
- * Since version 1.103, a callback function can be used. It should return a promise, that resolves with
36309
- * a `string` value or a JSON object, which will be stringified, or rejects - in this case a default error
36310
- * message will be displayed.
36410
+ * Added since version 1.28.0. If set, a link to view details is added. When the user clicks the link, the
36411
+ * text area containing 'details' information is displayed. The initial visibility is not configurable and
36412
+ * the details are hidden by default.
36413
+ * The following details can be used:
36414
+ * - `string` - text in HTML format. For full list of supported HTML tags see {@link sap.m.FormattedText}
36415
+ *
36416
+ * - `object` - JSON object that will be serialized using `JSON.stringify`
36417
+ * - `function` - since version 1.103, a callback function that fetches the details asynchronously. It
36418
+ * should return a promise that resolves with a `string` value or an `object`, or rejects - in this case
36419
+ * a default error message will be displayed
36311
36420
  */
36312
36421
  details?: string | object | (() => Promise<string | object>);
36313
36422
  /**
@@ -36412,13 +36521,16 @@ declare namespace sap {
36412
36521
  */
36413
36522
  horizontalScrolling?: boolean;
36414
36523
  /**
36415
- * Added since version 1.28.0. If 'details' is set, a link to view details is added. When the user clicks
36416
- * the link, the text area containing 'details' information is displayed. The initial visibility is not
36417
- * configurable and the details are hidden by default.
36418
- * If object is given, it will be serialized using `JSON.stringify`.
36419
- * Since version 1.103, a callback function can be used. It should return a promise, that resolves with
36420
- * a `string` value or a JSON object, which will be stringified, or rejects - in this case a default error
36421
- * message will be displayed.
36524
+ * Added since version 1.28.0. If set, a link to view details is added. When the user clicks the link, the
36525
+ * text area containing 'details' information is displayed. The initial visibility is not configurable and
36526
+ * the details are hidden by default.
36527
+ * The following details can be used:
36528
+ * - `string` - text in HTML format. For full list of supported HTML tags see {@link sap.m.FormattedText}
36529
+ *
36530
+ * - `object` - JSON object that will be serialized using `JSON.stringify`
36531
+ * - `function` - since version 1.103, a callback function that fetches the details asynchronously. It
36532
+ * should return a promise that resolves with a `string` value or an `object`, or rejects - in this case
36533
+ * a default error message will be displayed
36422
36534
  */
36423
36535
  details?: string | object | (() => Promise<string | object>);
36424
36536
  /**
@@ -36433,8 +36545,7 @@ declare namespace sap {
36433
36545
  * and optionally other parts. After the user has tapped a button, the `onClose` function is invoked when
36434
36546
  * given.
36435
36547
  *
36436
- * The only mandatory parameter is `vMessage`. Either a string with the corresponding text or even a layout
36437
- * control could be provided.
36548
+ * The only mandatory parameter is `vMessage`.
36438
36549
  *
36439
36550
  *
36440
36551
  * ```javascript
@@ -36533,13 +36644,16 @@ declare namespace sap {
36533
36644
  */
36534
36645
  horizontalScrolling?: boolean;
36535
36646
  /**
36536
- * Added since version 1.28.0. If 'details' is set, a link to view details is added. When the user clicks
36537
- * the link, the text area containing 'details' information is displayed. The initial visibility is not
36538
- * configurable and the details are hidden by default.
36539
- * If object is given, it will be serialized using `JSON.stringify`.
36540
- * Since version 1.103, a callback function can be used. It should return a promise, that resolves with
36541
- * a `string` value or a JSON object, which will be stringified, or rejects - in this case a default error
36542
- * message will be displayed.
36647
+ * Added since version 1.28.0. If set, a link to view details is added. When the user clicks the link, the
36648
+ * text area containing 'details' information is displayed. The initial visibility is not configurable and
36649
+ * the details are hidden by default.
36650
+ * The following details can be used:
36651
+ * - `string` - text in HTML format. For full list of supported HTML tags see {@link sap.m.FormattedText}
36652
+ *
36653
+ * - `object` - JSON object that will be serialized using `JSON.stringify`
36654
+ * - `function` - since version 1.103, a callback function that fetches the details asynchronously. It
36655
+ * should return a promise that resolves with a `string` value or an `object`, or rejects - in this case
36656
+ * a default error message will be displayed
36543
36657
  */
36544
36658
  details?: string | object | (() => Promise<string | object>);
36545
36659
  /**
@@ -36648,13 +36762,16 @@ declare namespace sap {
36648
36762
  */
36649
36763
  horizontalScrolling?: boolean;
36650
36764
  /**
36651
- * Added since version 1.28.0. If 'details' is set, a link to view details is added. When the user clicks
36652
- * the link, the text area containing 'details' information is displayed. The initial visibility is not
36653
- * configurable and the details are hidden by default.
36654
- * If object is given, it will be serialized using `JSON.stringify`.
36655
- * Since version 1.103, a callback function can be used. It should return a promise, that resolves with
36656
- * a `string` value or a JSON object, which will be stringified, or rejects - in this case a default error
36657
- * message will be displayed.
36765
+ * Added since version 1.28.0. If set, a link to view details is added. When the user clicks the link, the
36766
+ * text area containing 'details' information is displayed. The initial visibility is not configurable and
36767
+ * the details are hidden by default.
36768
+ * The following details can be used:
36769
+ * - `string` - text in HTML format. For full list of supported HTML tags see {@link sap.m.FormattedText}
36770
+ *
36771
+ * - `object` - JSON object that will be serialized using `JSON.stringify`
36772
+ * - `function` - since version 1.103, a callback function that fetches the details asynchronously. It
36773
+ * should return a promise that resolves with a `string` value or an `object`, or rejects - in this case
36774
+ * a default error message will be displayed
36658
36775
  */
36659
36776
  details?: string | object | (() => Promise<string | object>);
36660
36777
  /**
@@ -36759,13 +36876,16 @@ declare namespace sap {
36759
36876
  */
36760
36877
  horizontalScrolling?: boolean;
36761
36878
  /**
36762
- * Added since version 1.28.0. If 'details' is set, a link to view details is added. When the user clicks
36763
- * the link, the text area containing 'details' information is displayed. The initial visibility is not
36764
- * configurable and the details are hidden by default.
36765
- * If object is given, it will be serialized using `JSON.stringify`.
36766
- * Since version 1.103, a callback function can be used. It should return a promise, that resolves with
36767
- * a `string` value or a JSON object, which will be stringified, or rejects - in this case a default error
36768
- * message will be displayed.
36879
+ * Added since version 1.28.0. If set, a link to view details is added. When the user clicks the link, the
36880
+ * text area containing 'details' information is displayed. The initial visibility is not configurable and
36881
+ * the details are hidden by default.
36882
+ * The following details can be used:
36883
+ * - `string` - text in HTML format. For full list of supported HTML tags see {@link sap.m.FormattedText}
36884
+ *
36885
+ * - `object` - JSON object that will be serialized using `JSON.stringify`
36886
+ * - `function` - since version 1.103, a callback function that fetches the details asynchronously. It
36887
+ * should return a promise that resolves with a `string` value or an `object`, or rejects - in this case
36888
+ * a default error message will be displayed
36769
36889
  */
36770
36890
  details?: string | object | (() => Promise<string | object>);
36771
36891
  /**
@@ -36897,6 +37017,31 @@ declare namespace sap {
36897
37017
  }
36898
37018
  const MessageToast: MessageToast;
36899
37019
 
37020
+ /**
37021
+ * @SINCE 1.16.7
37022
+ *
37023
+ * Helper for Popups.
37024
+ */
37025
+ interface PopupHelper {
37026
+ /**
37027
+ * Converts the given percentage value to an absolute number based on the given base size.
37028
+ *
37029
+ * @returns The calculated size string with "px" as unit or `null` when the format of given parameter is
37030
+ * wrong.
37031
+ */
37032
+ calcPercentageSize(
37033
+ /**
37034
+ * A percentage value in string format, for example "25%"
37035
+ */
37036
+ sPercentage: string,
37037
+ /**
37038
+ * A float number which the calculation is based on.
37039
+ */
37040
+ fBaseSize: float
37041
+ ): string | null;
37042
+ }
37043
+ const PopupHelper: PopupHelper;
37044
+
36900
37045
  /**
36901
37046
  * @SINCE 1.10
36902
37047
  *
@@ -37191,6 +37336,7 @@ declare namespace sap {
37191
37336
  }
37192
37337
  /**
37193
37338
  * @SINCE 1.16
37339
+ * @deprecated (since 1.111)
37194
37340
  *
37195
37341
  * The ActionSelect control provides a list of predefined items that allows end users to choose options
37196
37342
  * and additionally trigger some actions.
@@ -37971,7 +38117,7 @@ declare namespace sap {
37971
38117
  /**
37972
38118
  * The control to which the ActionSheet is opened
37973
38119
  */
37974
- oControl: object
38120
+ oControl: sap.ui.core.Control | HTMLElement
37975
38121
  ): void;
37976
38122
  /**
37977
38123
  * Removes all the controls from the aggregation {@link #getButtons buttons}.
@@ -42964,8 +43110,9 @@ declare namespace sap {
42964
43110
  /**
42965
43111
  * Gets current value of property {@link #getEnabled enabled}.
42966
43112
  *
42967
- * Disables the Checkbox. Disabled controls are not interactive and are rendered differently according to
42968
- * the theme.
43113
+ * Whether the `CheckBox` is enabled.
43114
+ *
43115
+ * **Note:** Disabled `CheckBox` is not interactive and is rendered differently according to the theme.
42969
43116
  *
42970
43117
  * Default value is `true`.
42971
43118
  *
@@ -43204,8 +43351,9 @@ declare namespace sap {
43204
43351
  /**
43205
43352
  * Sets a new value for property {@link #getEnabled enabled}.
43206
43353
  *
43207
- * Disables the Checkbox. Disabled controls are not interactive and are rendered differently according to
43208
- * the theme.
43354
+ * Whether the `CheckBox` is enabled.
43355
+ *
43356
+ * **Note:** Disabled `CheckBox` is not interactive and is rendered differently according to the theme.
43209
43357
  *
43210
43358
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
43211
43359
  *
@@ -46234,7 +46382,11 @@ declare namespace sap {
46234
46382
  /**
46235
46383
  * A callback function called when typing in a ComboBoxBase control or ancestor.
46236
46384
  */
46237
- fnFilter: Function
46385
+ fnFilter: (
46386
+ p1: string,
46387
+ p2: sap.ui.core.Item,
46388
+ p3: boolean
46389
+ ) => boolean | undefined | Function
46238
46390
  ): this;
46239
46391
  /**
46240
46392
  * @deprecated (since 1.110)
@@ -46356,7 +46508,7 @@ declare namespace sap {
46356
46508
  /**
46357
46509
  * Function to filter the items shown in the SuggestionsPopover
46358
46510
  */
46359
- fnFilter: Function
46511
+ fnFilter: Function | undefined
46360
46512
  ): void;
46361
46513
  /**
46362
46514
  * Creates picker if doesn't exist yet and sync with Control items To be overwritten by subclasses.
@@ -48349,15 +48501,15 @@ declare namespace sap {
48349
48501
  */
48350
48502
  getFrom(): object;
48351
48503
  /**
48352
- * Gets current value of property {@link #getSecondDateValue secondDateValue}.
48504
+ * Getter for property `secondDateValue`.
48353
48505
  *
48354
48506
  * The end date of the range as JavaScript Date object. This is independent from any formatter.
48355
48507
  *
48356
48508
  * **Note:** If this property is used, the `value` property should not be changed from the caller.
48357
48509
  *
48358
- * @returns Value of property `secondDateValue`
48510
+ * @returns the value of property `secondDateValue`
48359
48511
  */
48360
- getSecondDateValue(): object;
48512
+ getSecondDateValue(): Date;
48361
48513
  /**
48362
48514
  * @deprecated (since 1.22.0) - replaced by `secondDateValue` property
48363
48515
  *
@@ -48421,6 +48573,17 @@ declare namespace sap {
48421
48573
  */
48422
48574
  sDelimiter?: string
48423
48575
  ): this;
48576
+ /**
48577
+ * Sets the displayFormat of the DatePicker.
48578
+ *
48579
+ * @returns Reference to `this` for method chaining
48580
+ */
48581
+ setDisplayFormat(
48582
+ /**
48583
+ * new value for `displayFormat`
48584
+ */
48585
+ sDisplayFormat: string
48586
+ ): this;
48424
48587
  /**
48425
48588
  * @deprecated (since 1.22.0) - replaced by `dateValue` property of the {@link sap.m.DateTimeField}
48426
48589
  *
@@ -51557,8 +51720,16 @@ declare namespace sap {
51557
51720
  /**
51558
51721
  * The value to be formatted
51559
51722
  */
51560
- oValue: object
51561
- ): object;
51723
+ oValue: {
51724
+ operator: string;
51725
+
51726
+ values: Array<number | string>;
51727
+ }
51728
+ ): {
51729
+ operator: string;
51730
+
51731
+ values: Array<Date | number | string>;
51732
+ };
51562
51733
  /**
51563
51734
  * Parses the given object value to a similar object. The whole value is in the following format { operator:
51564
51735
  * "KEY", values: [...array with JS dates or numbers to be parsed]}. Only parses the 'values' part of the
@@ -51571,8 +51742,16 @@ declare namespace sap {
51571
51742
  /**
51572
51743
  * The value to be parsed
51573
51744
  */
51574
- oValue: object
51575
- ): object;
51745
+ oValue: {
51746
+ operator: string;
51747
+
51748
+ values: Array<Date | number | string>;
51749
+ }
51750
+ ): {
51751
+ operator: string;
51752
+
51753
+ values: Array<number | string | null>;
51754
+ };
51576
51755
  }
51577
51756
  /**
51578
51757
  * @EXPERIMENTAL (since 1.92) - This class is experimental and provides only limited functionality. Also
@@ -51593,7 +51772,18 @@ declare namespace sap {
51593
51772
  /**
51594
51773
  * Object which defines the format options
51595
51774
  */
51596
- oFormatOptions?: object,
51775
+ oFormatOptions?: sap.m.DynamicDateFormatOptions,
51776
+ /**
51777
+ * Locale to get the formatter for
51778
+ */
51779
+ oLocale?: sap.ui.core.Locale
51780
+ ): sap.m.DynamicDateFormat;
51781
+ /**
51782
+ * Get an instance of the DynamicDateFormat which can be used for formatting.
51783
+ *
51784
+ * @returns Instance of the DynamicDateFormat
51785
+ */
51786
+ static getInstance(
51597
51787
  /**
51598
51788
  * Locale to get the formatter for
51599
51789
  */
@@ -51608,7 +51798,7 @@ declare namespace sap {
51608
51798
  /**
51609
51799
  * The value to format
51610
51800
  */
51611
- oObj: object,
51801
+ oObj: sap.m.DynamicDateRangeValue,
51612
51802
  /**
51613
51803
  * If set to `true` the formatter does not format to the equivalent user-friendly string. Instead, the formatter
51614
51804
  * uses the specified option key and parameters.
@@ -51629,7 +51819,7 @@ declare namespace sap {
51629
51819
  * String value of the key we will parse for
51630
51820
  */
51631
51821
  sKey: string
51632
- ): object;
51822
+ ): sap.m.DynamicDateRangeValue[];
51633
51823
  }
51634
51824
  /**
51635
51825
  * @SINCE 1.92
@@ -51713,7 +51903,7 @@ declare namespace sap {
51713
51903
  /**
51714
51904
  * A callback invoked when any of the created controls updates its value
51715
51905
  */
51716
- fnControlsUpdated: Function
51906
+ fnControlsUpdated: (p1: sap.ui.base.Event) => void
51717
51907
  ): sap.ui.core.Control[];
51718
51908
  /**
51719
51909
  * Controls whether the formatted date range should be concatenated to the formatted value when displayed.
@@ -51728,9 +51918,9 @@ declare namespace sap {
51728
51918
  */
51729
51919
  format(
51730
51920
  /**
51731
- * A DynamicDateRange value
51921
+ * A `sap.m.DynamicDateRangeValue`
51732
51922
  */
51733
- oValue: object
51923
+ oValue: sap.m.DynamicDateRangeValue
51734
51924
  ): string;
51735
51925
  /**
51736
51926
  * Provides the order index of the option's group. Used for grouping within the options list inside a DynamicDateRange's
@@ -51766,16 +51956,16 @@ declare namespace sap {
51766
51956
  oControl: sap.m.DynamicDateRange
51767
51957
  ): string;
51768
51958
  /**
51769
- * Gets the value help controls' output values and converts them to a DynamicDateRange value.
51959
+ * Gets the value help controls' output values and converts them to a `sap.m.DynamicDateRangeValue`.
51770
51960
  *
51771
- * @returns A DynamicDateRange value
51961
+ * @returns A `sap.m.DynamicDateRangeValue`
51772
51962
  */
51773
51963
  getValueHelpOutput(
51774
51964
  /**
51775
51965
  * The control instance
51776
51966
  */
51777
51967
  oControl: sap.m.DynamicDateRange
51778
- ): object;
51968
+ ): sap.m.DynamicDateRangeValue;
51779
51969
  /**
51780
51970
  * Defines the UI types of the option. They are used to create predefined UI for the DynamicDateRange's
51781
51971
  * value help dialog corresponding to this option. The types are DynamicDateValueHelpUIType instances. Their
@@ -51800,16 +51990,16 @@ declare namespace sap {
51800
51990
  */
51801
51991
  getValueTypes(): string[];
51802
51992
  /**
51803
- * Parses a string to a DynamicDateRange value.
51993
+ * Parses a string to a `sap.m.DynamicDateRangeValue`.
51804
51994
  *
51805
- * @returns This option's DynamicDateRange value
51995
+ * @returns This parsed value
51806
51996
  */
51807
51997
  parse(
51808
51998
  /**
51809
51999
  * An input string
51810
52000
  */
51811
52001
  sValue: string
51812
- ): object;
52002
+ ): sap.m.DynamicDateRangeValue;
51813
52003
  /**
51814
52004
  * Sets a new value for property {@link #getKey key}.
51815
52005
  *
@@ -51849,9 +52039,9 @@ declare namespace sap {
51849
52039
  */
51850
52040
  toDates(
51851
52041
  /**
51852
- * A DynamicDateRange value
52042
+ * A `sap.m.DynamicDateRangeValue`
51853
52043
  */
51854
- oValue: object
52044
+ oValue: sap.m.DynamicDateRangeValue
51855
52045
  ): /* was: sap.ui.core.date.UniversalDate */ any[];
51856
52046
  /**
51857
52047
  * Validates all input controls in the value help UI related to the current option. If one of the input
@@ -51959,6 +52149,21 @@ declare namespace sap {
51959
52149
  * @returns Metadata object describing this class
51960
52150
  */
51961
52151
  static getMetadata(): sap.ui.core.ElementMetadata;
52152
+ /**
52153
+ * Returns a date range from a provided object in the format of the DynamicDateRange's value.
52154
+ *
52155
+ * @returns An array of two date objects - start and end date
52156
+ */
52157
+ static toDates(
52158
+ /**
52159
+ * A `sap.m.DynamicDateRangeValue`
52160
+ */
52161
+ oValue: sap.m.DynamicDateRangeValue,
52162
+ /**
52163
+ * The type of calendar week numbering
52164
+ */
52165
+ sCalendarWeekNumbering: string
52166
+ ): Date[];
51962
52167
  /**
51963
52168
  * @SINCE 1.92
51964
52169
  *
@@ -52094,6 +52299,17 @@ declare namespace sap {
52094
52299
  * ariaLabelledBy}.
52095
52300
  */
52096
52301
  getAriaLabelledBy(): sap.ui.core.ID[];
52302
+ /**
52303
+ * @SINCE 1.111.0
52304
+ *
52305
+ * Gets current value of property {@link #getCalendarWeekNumbering calendarWeekNumbering}.
52306
+ *
52307
+ * If set, the calendar week numbering is used for display. If not set, the calendar week numbering of the
52308
+ * global configuration is used.
52309
+ *
52310
+ * @returns Value of property `calendarWeekNumbering`
52311
+ */
52312
+ getCalendarWeekNumbering(): sap.ui.core.date.CalendarWeekNumbering;
52097
52313
  /**
52098
52314
  * @SINCE 1.92
52099
52315
  *
@@ -52190,11 +52406,11 @@ declare namespace sap {
52190
52406
  *
52191
52407
  * Default value is `["DATE", "TODAY", "YESTERDAY", "TOMORROW", "FIRSTDAYWEEK", "LASTDAYWEEK", "FIRSTDAYMONTH",
52192
52408
  * "LASTDAYMONTH", "FIRSTDAYQUARTER", "LASTDAYQUARTER", "FIRSTDAYYEAR", "LASTDAYYEAR", "DATERANGE", "DATETIMERANGE",
52193
- * "FROM", "TO", "FROMDATETIME", "TODATETIME", "YEARTODATE", "DATETOYEAR", "LASTDAYS", "LASTWEEKS", "LASTMONTHS",
52194
- * "LASTQUARTERS", "LASTYEARS", "NEXTDAYS", "NEXTWEEKS", "NEXTMONTHS", "NEXTQUARTERS", "NEXTYEARS", "TODAYFROMTO",
52195
- * "THISWEEK", "LASTWEEK", "NEXTWEEK", "SPECIFICMONTH", "SPECIFICMONTHINYEAR", "THISMONTH", "LASTMONTH",
52196
- * "NEXTMONTH", "THISQUARTER", "LASTQUARTER", "NEXTQUARTER", "QUARTER1", "QUARTER2", "QUARTER3", "QUARTER4",
52197
- * "THISYEAR", "LASTYEAR", "NEXTYEAR", "DATETIME"]`.
52409
+ * "FROM", "TO", "FROMDATETIME", "TODATETIME", "YEARTODATE", "DATETOYEAR", "LASTMINUTES", "LASTHOURS", "LASTDAYS",
52410
+ * "LASTWEEKS", "LASTMONTHS", "LASTQUARTERS", "LASTYEARS", "NEXTMINUTES", "NEXTHOURS", "NEXTDAYS", "NEXTWEEKS",
52411
+ * "NEXTMONTHS", "NEXTQUARTERS", "NEXTYEARS", "TODAYFROMTO", "THISWEEK", "LASTWEEK", "NEXTWEEK", "SPECIFICMONTH",
52412
+ * "SPECIFICMONTHINYEAR", "THISMONTH", "LASTMONTH", "NEXTMONTH", "THISQUARTER", "LASTQUARTER", "NEXTQUARTER",
52413
+ * "QUARTER1", "QUARTER2", "QUARTER3", "QUARTER4", "THISYEAR", "LASTYEAR", "NEXTYEAR", "DATETIME"]`.
52198
52414
  *
52199
52415
  * @returns Value of property `options`
52200
52416
  */
@@ -52343,6 +52559,24 @@ declare namespace sap {
52343
52559
  */
52344
52560
  vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
52345
52561
  ): sap.ui.core.ID | null;
52562
+ /**
52563
+ * @SINCE 1.111.0
52564
+ *
52565
+ * Sets a new value for property {@link #getCalendarWeekNumbering calendarWeekNumbering}.
52566
+ *
52567
+ * If set, the calendar week numbering is used for display. If not set, the calendar week numbering of the
52568
+ * global configuration is used.
52569
+ *
52570
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
52571
+ *
52572
+ * @returns Reference to `this` in order to allow method chaining
52573
+ */
52574
+ setCalendarWeekNumbering(
52575
+ /**
52576
+ * New value for property `calendarWeekNumbering`
52577
+ */
52578
+ sCalendarWeekNumbering?: sap.ui.core.date.CalendarWeekNumbering
52579
+ ): this;
52346
52580
  /**
52347
52581
  * @SINCE 1.92
52348
52582
  *
@@ -52475,11 +52709,11 @@ declare namespace sap {
52475
52709
  *
52476
52710
  * Default value is `["DATE", "TODAY", "YESTERDAY", "TOMORROW", "FIRSTDAYWEEK", "LASTDAYWEEK", "FIRSTDAYMONTH",
52477
52711
  * "LASTDAYMONTH", "FIRSTDAYQUARTER", "LASTDAYQUARTER", "FIRSTDAYYEAR", "LASTDAYYEAR", "DATERANGE", "DATETIMERANGE",
52478
- * "FROM", "TO", "FROMDATETIME", "TODATETIME", "YEARTODATE", "DATETOYEAR", "LASTDAYS", "LASTWEEKS", "LASTMONTHS",
52479
- * "LASTQUARTERS", "LASTYEARS", "NEXTDAYS", "NEXTWEEKS", "NEXTMONTHS", "NEXTQUARTERS", "NEXTYEARS", "TODAYFROMTO",
52480
- * "THISWEEK", "LASTWEEK", "NEXTWEEK", "SPECIFICMONTH", "SPECIFICMONTHINYEAR", "THISMONTH", "LASTMONTH",
52481
- * "NEXTMONTH", "THISQUARTER", "LASTQUARTER", "NEXTQUARTER", "QUARTER1", "QUARTER2", "QUARTER3", "QUARTER4",
52482
- * "THISYEAR", "LASTYEAR", "NEXTYEAR", "DATETIME"]`.
52712
+ * "FROM", "TO", "FROMDATETIME", "TODATETIME", "YEARTODATE", "DATETOYEAR", "LASTMINUTES", "LASTHOURS", "LASTDAYS",
52713
+ * "LASTWEEKS", "LASTMONTHS", "LASTQUARTERS", "LASTYEARS", "NEXTMINUTES", "NEXTHOURS", "NEXTDAYS", "NEXTWEEKS",
52714
+ * "NEXTMONTHS", "NEXTQUARTERS", "NEXTYEARS", "TODAYFROMTO", "THISWEEK", "LASTWEEK", "NEXTWEEK", "SPECIFICMONTH",
52715
+ * "SPECIFICMONTHINYEAR", "THISMONTH", "LASTMONTH", "NEXTMONTH", "THISQUARTER", "LASTQUARTER", "NEXTQUARTER",
52716
+ * "QUARTER1", "QUARTER2", "QUARTER3", "QUARTER4", "THISYEAR", "LASTYEAR", "NEXTYEAR", "DATETIME"]`.
52483
52717
  *
52484
52718
  * @returns Reference to `this` in order to allow method chaining
52485
52719
  */
@@ -52527,25 +52761,6 @@ declare namespace sap {
52527
52761
  */
52528
52762
  bRequired?: boolean
52529
52763
  ): this;
52530
- /**
52531
- * @SINCE 1.92
52532
- *
52533
- * Sets a new value for property {@link #getValue value}.
52534
- *
52535
- * Defines the control value. The object has two properties 'operator' - a string, the key of a DynamicDateOption
52536
- * and 'values' - an array of parameters for the same option. The control uses a special wrong-value object,
52537
- * when the input receives an unrecognized string - { operator: "PARSEERROR", values: [...]}
52538
- *
52539
- * When called with a value of `null` or `undefined`, the default value of the property will be restored.
52540
- *
52541
- * @returns Reference to `this` in order to allow method chaining
52542
- */
52543
- setValue(
52544
- /**
52545
- * New value for property `value`
52546
- */
52547
- oValue: object
52548
- ): this;
52549
52764
  /**
52550
52765
  * @SINCE 1.92
52551
52766
  *
@@ -62530,8 +62745,8 @@ declare namespace sap {
62530
62745
  *
62531
62746
  * An `IllustratedMessage` is a recommended combination of a solution-oriented message, an engaging illustration,
62532
62747
  * and conversational tone to better communicate an empty or a success state than just show a message alone.
62533
- * Empty states are moments in the user experience where theres no data to display. Success states are
62534
- * occasions to celebrate and reward a users special accomplishment or the completion of an important task.
62748
+ * Empty states are moments in the user experience where there's no data to display. Success states are
62749
+ * occasions to celebrate and reward a user's special accomplishment or the completion of an important task.
62535
62750
  *
62536
62751
  * The `IllustratedMessage` control is meant to be used inside container controls, for example a `Card`,
62537
62752
  * a `Dialog`, or a `Page`.
@@ -62683,15 +62898,29 @@ declare namespace sap {
62683
62898
  *
62684
62899
  * Defines the description displayed below the title.
62685
62900
  *
62686
- * If there is no initial input from the app developer and the default illustration set is being used, a
62687
- * default description for the current illustration type is going to be displayed. The default description
62688
- * is stored in the `sap.m` resource bundle.
62901
+ * If there is no initial input from the app developer, `enableDefaultTitleAndDescription` is `true` and
62902
+ * the default illustration set is being used, a default description for the current illustration type is
62903
+ * going to be displayed. The default description is stored in the `sap.m` resource bundle.
62689
62904
  *
62690
62905
  * Default value is `empty string`.
62691
62906
  *
62692
62907
  * @returns Value of property `description`
62693
62908
  */
62694
62909
  getDescription(): string;
62910
+ /**
62911
+ * @SINCE 1.111
62912
+ *
62913
+ * Gets current value of property {@link #getEnableDefaultTitleAndDescription enableDefaultTitleAndDescription}.
62914
+ *
62915
+ * Defines whether the default title and description should be used when the input for their respective
62916
+ * part is empty and the default illustration set is being used. Title and description are stored in the
62917
+ * `sap.m` resource bundle.
62918
+ *
62919
+ * Default value is `true`.
62920
+ *
62921
+ * @returns Value of property `enableDefaultTitleAndDescription`
62922
+ */
62923
+ getEnableDefaultTitleAndDescription(): boolean;
62695
62924
  /**
62696
62925
  * @SINCE 1.98
62697
62926
  *
@@ -62768,8 +62997,9 @@ declare namespace sap {
62768
62997
  *
62769
62998
  * Defines the title that is displayed below the illustration.
62770
62999
  *
62771
- * If there is no initial input from the app developer and the default illustration set is being used, a
62772
- * default title is displayed corresponding to the current `illustrationType`.
63000
+ * If there is no initial input from the app developer, `enableDefaultTitleAndDescription` is `true` and
63001
+ * the default illustration set is being used, a default title is displayed corresponding to the current
63002
+ * `illustrationType`. The default title is stored in the `sap.m` resource bundle.
62773
63003
  *
62774
63004
  * Default value is `empty string`.
62775
63005
  *
@@ -62861,9 +63091,9 @@ declare namespace sap {
62861
63091
  *
62862
63092
  * Defines the description displayed below the title.
62863
63093
  *
62864
- * If there is no initial input from the app developer and the default illustration set is being used, a
62865
- * default description for the current illustration type is going to be displayed. The default description
62866
- * is stored in the `sap.m` resource bundle.
63094
+ * If there is no initial input from the app developer, `enableDefaultTitleAndDescription` is `true` and
63095
+ * the default illustration set is being used, a default description for the current illustration type is
63096
+ * going to be displayed. The default description is stored in the `sap.m` resource bundle.
62867
63097
  *
62868
63098
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
62869
63099
  *
@@ -62877,6 +63107,27 @@ declare namespace sap {
62877
63107
  */
62878
63108
  sDescription?: string
62879
63109
  ): this;
63110
+ /**
63111
+ * @SINCE 1.111
63112
+ *
63113
+ * Sets a new value for property {@link #getEnableDefaultTitleAndDescription enableDefaultTitleAndDescription}.
63114
+ *
63115
+ * Defines whether the default title and description should be used when the input for their respective
63116
+ * part is empty and the default illustration set is being used. Title and description are stored in the
63117
+ * `sap.m` resource bundle.
63118
+ *
63119
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
63120
+ *
63121
+ * Default value is `true`.
63122
+ *
63123
+ * @returns Reference to `this` in order to allow method chaining
63124
+ */
63125
+ setEnableDefaultTitleAndDescription(
63126
+ /**
63127
+ * New value for property `enableDefaultTitleAndDescription`
63128
+ */
63129
+ bEnableDefaultTitleAndDescription?: boolean
63130
+ ): this;
62880
63131
  /**
62881
63132
  * @SINCE 1.98
62882
63133
  *
@@ -62947,8 +63198,9 @@ declare namespace sap {
62947
63198
  *
62948
63199
  * Defines the title that is displayed below the illustration.
62949
63200
  *
62950
- * If there is no initial input from the app developer and the default illustration set is being used, a
62951
- * default title is displayed corresponding to the current `illustrationType`.
63201
+ * If there is no initial input from the app developer, `enableDefaultTitleAndDescription` is `true` and
63202
+ * the default illustration set is being used, a default title is displayed corresponding to the current
63203
+ * `illustrationType`. The default title is stored in the `sap.m` resource bundle.
62952
63204
  *
62953
63205
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
62954
63206
  *
@@ -65129,7 +65381,7 @@ declare namespace sap {
65129
65381
  *
65130
65382
  * @returns Accessibility information.
65131
65383
  */
65132
- getAccessibilityInfo(): object;
65384
+ getAccessibilityInfo(): sap.ui.core.AccessibilityInfo;
65133
65385
  /**
65134
65386
  * @SINCE 1.61
65135
65387
  *
@@ -65945,7 +66197,11 @@ declare namespace sap {
65945
66197
  * one is the string that is currently typed in the input field and the second one is the item that is being
65946
66198
  * filtered. Returning true will add this item to the popup, returning false will not display it.
65947
66199
  */
65948
- fnFilter: Function
66200
+ fnFilter: (
66201
+ p1: string,
66202
+ p2: sap.ui.core.Item,
66203
+ p3: boolean
66204
+ ) => boolean | undefined | Function
65949
66205
  ): this;
65950
66206
  /**
65951
66207
  * Sets a new value for property {@link #getFilterSuggests filterSuggests}.
@@ -66018,7 +66274,11 @@ declare namespace sap {
66018
66274
  * The result function is called with one parameter: the sap.m.ColumnListItem that is selected. The function
66019
66275
  * must return a result string that will be displayed as the input field's value.
66020
66276
  */
66021
- fnFilter: Function
66277
+ fnFilter: (
66278
+ p1: string,
66279
+ p2: sap.ui.core.Item,
66280
+ p3: boolean
66281
+ ) => boolean | undefined | Function
66022
66282
  ): this;
66023
66283
  /**
66024
66284
  * @SINCE 1.44
@@ -66369,7 +66629,7 @@ declare namespace sap {
66369
66629
  /**
66370
66630
  * Function to filter the items shown in the SuggestionsPopover
66371
66631
  */
66372
- fnFilter: Function
66632
+ fnFilter: Function | undefined
66373
66633
  ): void;
66374
66634
  /**
66375
66635
  * @SINCE 1.21.1
@@ -66537,7 +66797,12 @@ declare namespace sap {
66537
66797
  *
66538
66798
  * @returns Returns `this` to allow method chaining
66539
66799
  */
66540
- applyFocusInfo(oFocusInfo: object): this;
66800
+ applyFocusInfo(
66801
+ /**
66802
+ * An object representing the serialized focus information.
66803
+ */
66804
+ oFocusInfo: sap.ui.core.FocusInfo
66805
+ ): this;
66541
66806
  /**
66542
66807
  * Attaches event handler `fnFunction` to the {@link #event:change change} event of this `sap.m.InputBase`.
66543
66808
  *
@@ -66669,7 +66934,7 @@ declare namespace sap {
66669
66934
  *
66670
66935
  * @returns The accessibility information for this `InputBase`
66671
66936
  */
66672
- getAccessibilityInfo(): object;
66937
+ getAccessibilityInfo(): sap.ui.core.AccessibilityInfo;
66673
66938
  /**
66674
66939
  * @SINCE 1.90
66675
66940
  *
@@ -66721,7 +66986,7 @@ declare namespace sap {
66721
66986
  *
66722
66987
  * @returns An object representing the serialized focus information.
66723
66988
  */
66724
- getFocusInfo(): object;
66989
+ getFocusInfo(): sap.ui.core.FocusInfo;
66725
66990
  /**
66726
66991
  * @SINCE 1.78
66727
66992
  * @EXPERIMENTAL (since 1.78) - This aggregation is experimental and provides only limited functionality.
@@ -66881,7 +67146,10 @@ declare namespace sap {
66881
67146
  * @returns true when change event is fired
66882
67147
  */
66883
67148
  onChange(
66884
- oEvent: object,
67149
+ /**
67150
+ * The event
67151
+ */
67152
+ oEvent: jQuery.Event,
66885
67153
  /**
66886
67154
  * Additional event parameters to be passed in to the change event handler if the value has changed
66887
67155
  */
@@ -66897,7 +67165,10 @@ declare namespace sap {
66897
67165
  * @returns true when change event is fired
66898
67166
  */
66899
67167
  onChange(
66900
- oEvent: object,
67168
+ /**
67169
+ * The event
67170
+ */
67171
+ oEvent: jQuery.Event,
66901
67172
  /**
66902
67173
  * Passed value on change
66903
67174
  */
@@ -70783,6 +71054,8 @@ declare namespace sap {
70783
71054
  iItems?: int
70784
71055
  ): void;
70785
71056
  /**
71057
+ * @SINCE 1.76
71058
+ *
70786
71059
  * Scrolls the list so that the item with the given index is in the viewport. If the index is -1, it scrolls
70787
71060
  * to the bottom of the list. If the growing feature is enabled, the list is scrolled to the last available
70788
71061
  * item.
@@ -70790,7 +71063,8 @@ declare namespace sap {
70790
71063
  * Growing in combination with `growingScrollToLoad=true` can result in loading of new items when scrolling
70791
71064
  * to the bottom of the list.
70792
71065
  *
70793
- * @returns A `Promise` that resolves after the table scrolls to the row with the given index
71066
+ * @returns A `Promise` that resolves after the table scrolls to the row with the given index.
71067
+ * **Note:** This method can only be used if the control is inside a scrollable scroll container (e.g `sap.m.Page`).
70794
71068
  */
70795
71069
  scrollToIndex(
70796
71070
  /**
@@ -72854,7 +73128,7 @@ declare namespace sap {
72854
73128
  /**
72855
73129
  * The control that defines the position for the menu
72856
73130
  */
72857
- oControl: object,
73131
+ oControl: sap.ui.core.Control,
72858
73132
  /**
72859
73133
  * Whether the menu is opened with a shortcut or not
72860
73134
  */
@@ -75182,7 +75456,7 @@ declare namespace sap {
75182
75456
  /**
75183
75457
  * The item to add; if empty, nothing is inserted
75184
75458
  */
75185
- vItem: sap.m.MessageItem | sap.m.MessagePopoverItem
75459
+ oItem: sap.m.MessageItem
75186
75460
  ): this;
75187
75461
  /**
75188
75462
  * @SINCE 1.58
@@ -75867,7 +76141,7 @@ declare namespace sap {
75867
76141
  /**
75868
76142
  * Refers to the `MessagePopover` item that is being presented.
75869
76143
  */
75870
- item?: sap.m.MessagePopoverItem;
76144
+ item?: sap.m.MessageItem;
75871
76145
  /**
75872
76146
  * Refers to the type of messages being shown.
75873
76147
  */
@@ -75965,7 +76239,7 @@ declare namespace sap {
75965
76239
  *
75966
76240
  * A list with message items.
75967
76241
  */
75968
- getItems(): Array<sap.m.MessageItem | sap.m.MessagePopoverItem>;
76242
+ getItems(): sap.m.MessageItem[];
75969
76243
  /**
75970
76244
  * Gets current value of property {@link #getPlacement placement}.
75971
76245
  *
@@ -75988,7 +76262,7 @@ declare namespace sap {
75988
76262
  /**
75989
76263
  * The item whose index is looked for
75990
76264
  */
75991
- vItem: sap.m.MessageItem | sap.m.MessagePopoverItem
76265
+ oItem: sap.m.MessageItem
75992
76266
  ): int;
75993
76267
  /**
75994
76268
  * Inserts a item into the aggregation {@link #getItems items}.
@@ -75999,7 +76273,7 @@ declare namespace sap {
75999
76273
  /**
76000
76274
  * The item to insert; if empty, nothing is inserted
76001
76275
  */
76002
- vItem: sap.m.MessageItem | sap.m.MessagePopoverItem,
76276
+ oItem: sap.m.MessageItem,
76003
76277
  /**
76004
76278
  * The `0`-based index the item should be inserted at; for a negative value of `iIndex`, the item is inserted
76005
76279
  * at position 0; for a value greater than the current size of the aggregation, the item is inserted at
@@ -76036,7 +76310,7 @@ declare namespace sap {
76036
76310
  *
76037
76311
  * @returns An array of the removed elements (might be empty)
76038
76312
  */
76039
- removeAllItems(): Array<sap.m.MessageItem | sap.m.MessagePopoverItem>;
76313
+ removeAllItems(): sap.m.MessageItem[];
76040
76314
  /**
76041
76315
  * Removes a item from the aggregation {@link #getItems items}.
76042
76316
  *
@@ -76046,8 +76320,8 @@ declare namespace sap {
76046
76320
  /**
76047
76321
  * The item to remove or its index or id
76048
76322
  */
76049
- vItem: int | string | sap.m.MessageItem | sap.m.MessagePopoverItem
76050
- ): sap.m.MessageItem | sap.m.MessagePopoverItem | null;
76323
+ vItem: int | string | sap.m.MessageItem
76324
+ ): sap.m.MessageItem | null;
76051
76325
  /**
76052
76326
  * Sets a new value for property {@link #getAsyncDescriptionHandler asyncDescriptionHandler}.
76053
76327
  *
@@ -77745,7 +78019,7 @@ declare namespace sap {
77745
78019
  *
77746
78020
  * @returns The accessibility info
77747
78021
  */
77748
- getAccessibilityInfo(): object;
78022
+ getAccessibilityInfo(): sap.ui.core.AccessibilityInfo;
77749
78023
  /**
77750
78024
  * Retrieves the selected item objects from the association named `selectedItems`.
77751
78025
  *
@@ -78271,7 +78545,7 @@ declare namespace sap {
78271
78545
  *
78272
78546
  * @returns The accessibility object
78273
78547
  */
78274
- getAccessibilityInfo(): object;
78548
+ getAccessibilityInfo(): sap.ui.core.AccessibilityInfo;
78275
78549
  /**
78276
78550
  * Gets the picker header title.
78277
78551
  *
@@ -78378,7 +78652,7 @@ declare namespace sap {
78378
78652
  /**
78379
78653
  * Event object
78380
78654
  */
78381
- oEvent: object,
78655
+ oEvent: jQuery.Event,
78382
78656
  /**
78383
78657
  * Additional event parameters to be passed in to the change event handler if * the value has changed
78384
78658
  */
@@ -78398,7 +78672,7 @@ declare namespace sap {
78398
78672
  /**
78399
78673
  * Event object
78400
78674
  */
78401
- oEvent: object,
78675
+ oEvent: jQuery.Event,
78402
78676
  /**
78403
78677
  * Passed value on change
78404
78678
  */
@@ -78683,7 +78957,8 @@ declare namespace sap {
78683
78957
  *
78684
78958
  * The event is fired when navigation between two pages has completed (once all events to the child controls
78685
78959
  * have been fired). In case of animated transitions this event is fired with some delay after the "navigate"
78686
- * event.
78960
+ * event. This event is only fired if the DOM ref of the `NavContainer` is available. If the DOM ref is
78961
+ * not available, the `navigationFinished` event should be used instead.
78687
78962
  *
78688
78963
  * @returns Reference to `this` in order to allow method chaining
78689
78964
  */
@@ -78712,7 +78987,8 @@ declare namespace sap {
78712
78987
  *
78713
78988
  * The event is fired when navigation between two pages has completed (once all events to the child controls
78714
78989
  * have been fired). In case of animated transitions this event is fired with some delay after the "navigate"
78715
- * event.
78990
+ * event. This event is only fired if the DOM ref of the `NavContainer` is available. If the DOM ref is
78991
+ * not available, the `navigationFinished` event should be used instead.
78716
78992
  *
78717
78993
  * @returns Reference to `this` in order to allow method chaining
78718
78994
  */
@@ -78779,6 +79055,61 @@ declare namespace sap {
78779
79055
  */
78780
79056
  oListener?: object
78781
79057
  ): this;
79058
+ /**
79059
+ * @SINCE 1.111.0
79060
+ *
79061
+ * Attaches event handler `fnFunction` to the {@link #event:navigationFinished navigationFinished} event
79062
+ * of this `sap.m.NavContainer`.
79063
+ *
79064
+ * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
79065
+ * otherwise it will be bound to this `sap.m.NavContainer` itself.
79066
+ *
79067
+ * The event is fired when navigation between two pages has completed regardless of whether the DOM is ready
79068
+ * or not. This event is useful when performing navigation without/before rendering of the `NavContainer`.
79069
+ * Keep in mind that the DOM is not guaranteed to be ready when this event is fired.
79070
+ *
79071
+ * @returns Reference to `this` in order to allow method chaining
79072
+ */
79073
+ attachNavigationFinished(
79074
+ /**
79075
+ * An application-specific payload object that will be passed to the event handler along with the event
79076
+ * object when firing the event
79077
+ */
79078
+ oData: object,
79079
+ /**
79080
+ * The function to be called when the event occurs
79081
+ */
79082
+ fnFunction: (p1: sap.ui.base.Event) => void,
79083
+ /**
79084
+ * Context object to call the event handler with. Defaults to this `sap.m.NavContainer` itself
79085
+ */
79086
+ oListener?: object
79087
+ ): this;
79088
+ /**
79089
+ * @SINCE 1.111.0
79090
+ *
79091
+ * Attaches event handler `fnFunction` to the {@link #event:navigationFinished navigationFinished} event
79092
+ * of this `sap.m.NavContainer`.
79093
+ *
79094
+ * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
79095
+ * otherwise it will be bound to this `sap.m.NavContainer` itself.
79096
+ *
79097
+ * The event is fired when navigation between two pages has completed regardless of whether the DOM is ready
79098
+ * or not. This event is useful when performing navigation without/before rendering of the `NavContainer`.
79099
+ * Keep in mind that the DOM is not guaranteed to be ready when this event is fired.
79100
+ *
79101
+ * @returns Reference to `this` in order to allow method chaining
79102
+ */
79103
+ attachNavigationFinished(
79104
+ /**
79105
+ * The function to be called when the event occurs
79106
+ */
79107
+ fnFunction: (p1: sap.ui.base.Event) => void,
79108
+ /**
79109
+ * Context object to call the event handler with. Defaults to this `sap.m.NavContainer` itself
79110
+ */
79111
+ oListener?: object
79112
+ ): this;
78782
79113
  /**
78783
79114
  * Navigates back one level. If already on the initial page and there is no place to go back, nothing happens.
78784
79115
  *
@@ -78954,6 +79285,26 @@ declare namespace sap {
78954
79285
  */
78955
79286
  oListener?: object
78956
79287
  ): this;
79288
+ /**
79289
+ * @SINCE 1.111.0
79290
+ *
79291
+ * Detaches event handler `fnFunction` from the {@link #event:navigationFinished navigationFinished} event
79292
+ * of this `sap.m.NavContainer`.
79293
+ *
79294
+ * The passed function and listener object must match the ones used for event registration.
79295
+ *
79296
+ * @returns Reference to `this` in order to allow method chaining
79297
+ */
79298
+ detachNavigationFinished(
79299
+ /**
79300
+ * The function to be called, when the event occurs
79301
+ */
79302
+ fnFunction: (p1: sap.ui.base.Event) => void,
79303
+ /**
79304
+ * Context object on which the given function had to be called
79305
+ */
79306
+ oListener?: object
79307
+ ): this;
78957
79308
  /**
78958
79309
  * @SINCE 1.7.1
78959
79310
  *
@@ -79067,6 +79418,61 @@ declare namespace sap {
79067
79418
  direction?: string;
79068
79419
  }
79069
79420
  ): boolean;
79421
+ /**
79422
+ * @SINCE 1.111.0
79423
+ *
79424
+ * Fires event {@link #event:navigationFinished navigationFinished} to attached listeners.
79425
+ *
79426
+ * @returns Reference to `this` in order to allow method chaining
79427
+ */
79428
+ fireNavigationFinished(
79429
+ /**
79430
+ * Parameters to pass along with the event
79431
+ */
79432
+ mParameters?: {
79433
+ /**
79434
+ * The page which had been shown before navigation.
79435
+ */
79436
+ from?: sap.ui.core.Control;
79437
+ /**
79438
+ * The ID of the page which had been shown before navigation.
79439
+ */
79440
+ fromId?: string;
79441
+ /**
79442
+ * The page which is now shown after navigation.
79443
+ */
79444
+ to?: sap.ui.core.Control;
79445
+ /**
79446
+ * The ID of the page which is now shown after navigation.
79447
+ */
79448
+ toId?: string;
79449
+ /**
79450
+ * Whether the "to" page (more precisely: a control with the ID of the page which has been navigated to)
79451
+ * had not been shown/navigated to before.
79452
+ */
79453
+ firstTime?: boolean;
79454
+ /**
79455
+ * Whether was a forward navigation, triggered by "to()".
79456
+ */
79457
+ isTo?: boolean;
79458
+ /**
79459
+ * Whether this was a back navigation, triggered by "back()".
79460
+ */
79461
+ isBack?: boolean;
79462
+ /**
79463
+ * Whether this was a navigation to the root page, triggered by "backToTop()".
79464
+ */
79465
+ isBackToTop?: boolean;
79466
+ /**
79467
+ * Whether this was a navigation to a specific page, triggered by "backToPage()".
79468
+ */
79469
+ isBackToPage?: boolean;
79470
+ /**
79471
+ * How the navigation was triggered, possible values are "to", "back", "backToPage", and "backToTop".
79472
+ */
79473
+ direction?: string;
79474
+ }
79475
+ ): this;
79070
79476
  /**
79071
79477
  * @SINCE 1.30
79072
79478
  *
@@ -86044,6 +86450,20 @@ declare namespace sap {
86044
86450
  * with "closeOverflowOnInteraction=false".
86045
86451
  */
86046
86452
  closeOverflow(): void;
86453
+ /**
86454
+ * This method is a hook for the RenderManager that gets called during the rendering of child Controls.
86455
+ * It allows to add, remove and update existing accessibility attributes (ARIA) of those controls.
86456
+ */
86457
+ enhanceAccessibilityState(
86458
+ /**
86459
+ * The Control that gets rendered by the RenderManager
86460
+ */
86461
+ oElement: sap.ui.core.Control,
86462
+ /**
86463
+ * The mapping of "aria-" prefixed attributes
86464
+ */
86465
+ mAriaProps: object
86466
+ ): void;
86047
86467
  /**
86048
86468
  * @SINCE 1.67
86049
86469
  *
@@ -98775,7 +99195,7 @@ declare namespace sap {
98775
99195
  *
98776
99196
  * @returns The created header
98777
99197
  */
98778
- _getAnyHeader(): object;
99198
+ _getAnyHeader(): sap.ui.core.Control | sap.m.Bar;
98779
99199
  /**
98780
99200
  * Adds some ariaDescribedBy into the association {@link #getAriaDescribedBy ariaDescribedBy}.
98781
99201
  *
@@ -99244,9 +99664,7 @@ declare namespace sap {
99244
99664
  */
99245
99665
  getCustomHeader(): sap.ui.core.Control;
99246
99666
  /**
99247
- * @deprecated (since 1.15.0) - This property is deprecated. Please use properties verticalScrolling and
99248
- * horizontalScrolling instead. If you still use this property it will be mapped on the new properties verticalScrolling
99249
- * and horizontalScrolling.
99667
+ * @deprecated (since 1.15.0)
99250
99668
  *
99251
99669
  * Gets current value of property {@link #getEnableScrolling enableScrolling}.
99252
99670
  *
@@ -99495,7 +99913,7 @@ declare namespace sap {
99495
99913
  * This is the control to which the Popover will be placed. It can be not only a UI5 control, but also an
99496
99914
  * existing DOM reference. The side of the placement depends on the placement property set in the Popover.
99497
99915
  */
99498
- oControl: object,
99916
+ oControl: sap.ui.core.Control | HTMLElement,
99499
99917
  /**
99500
99918
  * Indicates whether popover should be managed by InstanceManager or not
99501
99919
  */
@@ -99655,9 +100073,7 @@ declare namespace sap {
99655
100073
  oCustomHeader: sap.ui.core.Control
99656
100074
  ): this;
99657
100075
  /**
99658
- * @deprecated (since 1.15.0) - This property is deprecated. Please use properties verticalScrolling and
99659
- * horizontalScrolling instead. If you still use this property it will be mapped on the new properties verticalScrolling
99660
- * and horizontalScrolling.
100076
+ * @deprecated (since 1.15.0)
99661
100077
  *
99662
100078
  * Sets a new value for property {@link #getEnableScrolling enableScrolling}.
99663
100079
  *
@@ -102311,6 +102727,8 @@ declare namespace sap {
102311
102727
  */
102312
102728
  getAvatar(): sap.m.Avatar;
102313
102729
  /**
102730
+ * @deprecated (since 1.111)
102731
+ *
102314
102732
  * Gets current value of property {@link #getCrossAppNavCallback crossAppNavCallback}.
102315
102733
  *
102316
102734
  * Specifies the application which provides target and param configuration for cross-application navigation
@@ -102467,6 +102885,8 @@ declare namespace sap {
102467
102885
  oAvatar: sap.m.Avatar
102468
102886
  ): this;
102469
102887
  /**
102888
+ * @deprecated (since 1.111)
102889
+ *
102470
102890
  * Sets a new value for property {@link #setCrossAppNavCallback crossAppNavCallback}.
102471
102891
  *
102472
102892
  * Specifies the application which provides target and param configuration for cross-application navigation
@@ -104198,7 +104618,19 @@ declare namespace sap {
104198
104618
  *
104199
104619
  * @returns Current accessibility state of the control
104200
104620
  */
104201
- getAccessibilityInfo(): object;
104621
+ getAccessibilityInfo(): {
104622
+ role: string;
104623
+
104624
+ type: string;
104625
+
104626
+ description: string;
104627
+
104628
+ focusable: boolean;
104629
+
104630
+ enabled: boolean;
104631
+
104632
+ editable: boolean;
104633
+ };
104202
104634
  /**
104203
104635
  * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaDescribedBy
104204
104636
  * ariaDescribedBy}.
@@ -107354,7 +107786,7 @@ declare namespace sap {
107354
107786
  * Icon to be displayed as graphical element within the Button. Density related image will be loaded if
107355
107787
  * image with density awareness name in format [imageName]@[densityValue].[extension] is provided.
107356
107788
  */
107357
- sURI: sap.ui.core.URI,
107789
+ sURI?: sap.ui.core.URI,
107358
107790
  /**
107359
107791
  * Enables the control. Buttons that are disabled have other colors than enabled ones, depending on custom
107360
107792
  * settings.
@@ -116297,7 +116729,11 @@ declare namespace sap {
116297
116729
  /**
116298
116730
  * The options object
116299
116731
  */
116300
- mOptions: object
116732
+ mOptions:
116733
+ | {
116734
+ snapValue: boolean;
116735
+ }
116736
+ | object
116301
116737
  ): this;
116302
116738
  /**
116303
116739
  * Sets a new value for property {@link #getWidth width}.
@@ -118997,9 +119433,6 @@ declare namespace sap {
118997
119433
  * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
118998
119434
  * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
118999
119435
  * of the syntax of the settings object.
119000
- *
119001
- * This class does not have its own settings, but all settings applicable to the base type {@link sap.m.DynamicDateOption#constructor
119002
- * sap.m.DynamicDateOption} can be used.
119003
119436
  */
119004
119437
  constructor(
119005
119438
  /**
@@ -119013,9 +119446,6 @@ declare namespace sap {
119013
119446
  * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
119014
119447
  * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
119015
119448
  * of the syntax of the settings object.
119016
- *
119017
- * This class does not have its own settings, but all settings applicable to the base type {@link sap.m.DynamicDateOption#constructor
119018
- * sap.m.DynamicDateOption} can be used.
119019
119449
  */
119020
119450
  constructor(
119021
119451
  /**
@@ -119057,6 +119487,35 @@ declare namespace sap {
119057
119487
  * @returns Metadata object describing this class
119058
119488
  */
119059
119489
  static getMetadata(): sap.ui.core.ElementMetadata;
119490
+ /**
119491
+ * @SINCE 1.111.0
119492
+ *
119493
+ * Gets current value of property {@link #getCalendarWeekNumbering calendarWeekNumbering}.
119494
+ *
119495
+ * If set, the calendar week numbering is used for display. If not set, the calendar week numbering of the
119496
+ * global configuration is used.
119497
+ *
119498
+ * @returns Value of property `calendarWeekNumbering`
119499
+ */
119500
+ getCalendarWeekNumbering(): sap.ui.core.date.CalendarWeekNumbering;
119501
+ /**
119502
+ * @SINCE 1.111.0
119503
+ *
119504
+ * Sets a new value for property {@link #getCalendarWeekNumbering calendarWeekNumbering}.
119505
+ *
119506
+ * If set, the calendar week numbering is used for display. If not set, the calendar week numbering of the
119507
+ * global configuration is used.
119508
+ *
119509
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
119510
+ *
119511
+ * @returns Reference to `this` in order to allow method chaining
119512
+ */
119513
+ setCalendarWeekNumbering(
119514
+ /**
119515
+ * New value for property `calendarWeekNumbering`
119516
+ */
119517
+ sCalendarWeekNumbering?: sap.ui.core.date.CalendarWeekNumbering
119518
+ ): this;
119060
119519
  /**
119061
119520
  * Validates all input controls in the value help UI related to the current option. If one of the input
119062
119521
  * controls contains invalid value, then validation will return `false`. If all input controls contain valid
@@ -142028,6 +142487,14 @@ declare namespace sap {
142028
142487
  * The date will be the last day of the current year.
142029
142488
  */
142030
142489
  LASTDAYYEAR = "LASTDAYYEAR",
142490
+ /**
142491
+ * The range will contain the last X hours. The count of the hours is selected from a StepInput.
142492
+ */
142493
+ LASTHOURS = "LASTHOURS",
142494
+ /**
142495
+ * The range will contain the last X minutes. The count of the minutes is selected from a StepInput.
142496
+ */
142497
+ LASTMINUTES = "LASTMINUTES",
142031
142498
  /**
142032
142499
  * The range will contain the days in the last month.
142033
142500
  */
@@ -142064,6 +142531,14 @@ declare namespace sap {
142064
142531
  * The range will contain the next X days. The count of the days is selected from a StepInput.
142065
142532
  */
142066
142533
  NEXTDAYS = "NEXTDAYS",
142534
+ /**
142535
+ * The range will contain the next X hours. The count of the hours is selected from a StepInput.
142536
+ */
142537
+ NEXTHOURS = "NEXTHOURS",
142538
+ /**
142539
+ * The range will contain the next X minutes. The count of the minutes is selected from a StepInput.
142540
+ */
142541
+ NEXTMINUTES = "NEXTMINUTES",
142067
142542
  /**
142068
142543
  * The range will contain the days in the next month.
142069
142544
  */
@@ -142582,6 +143057,75 @@ declare namespace sap {
142582
143057
  subheader?: sap.m.BarContext;
142583
143058
  };
142584
143059
 
143060
+ /**
143061
+ * @SINCE 1.111
143062
+ *
143063
+ * Object which defines the format options
143064
+ */
143065
+ type DynamicDateFormatOptions = () => object;
143066
+
143067
+ /**
143068
+ * @SINCE 1.111
143069
+ *
143070
+ * Defines the `value` property of the DynamicDateRange control. The object has two properties: 'operator'
143071
+ * - a string, the key of a DynamicDateOption 'values' - an array of parameters for the same option see
143072
+ * {@link sap.m.DynamicDateRange}
143073
+ */
143074
+ type DynamicDateRangeValue = {
143075
+ /**
143076
+ * The key of a DynamicDateOption.
143077
+ */
143078
+ operator: string;
143079
+ /**
143080
+ * An array of parameters for the same option.
143081
+ */
143082
+ values: Array<Date | int | string | any>;
143083
+ };
143084
+
143085
+ /**
143086
+ * @SINCE 1.111
143087
+ *
143088
+ * The object contains accessibility state for a control.
143089
+ */
143090
+ type InputBaseAccessibilityState = {
143091
+ /**
143092
+ * The WAI-ARIA role which is implemented by the control.
143093
+ */
143094
+ role?: string;
143095
+ /**
143096
+ * Whether the control is invalid.
143097
+ */
143098
+ invalid?: boolean;
143099
+ /**
143100
+ * The errormessage property.
143101
+ */
143102
+ errormessage?: string;
143103
+ /**
143104
+ * The labelledby property.
143105
+ */
143106
+ labelledby?: {
143107
+ value: string;
143108
+
143109
+ append: boolean;
143110
+ };
143111
+ /**
143112
+ * The describedby property.
143113
+ */
143114
+ describedby?: {
143115
+ value: string;
143116
+
143117
+ append: boolean;
143118
+ };
143119
+ /**
143120
+ * Whether the control is disabled. If not relevant, it shouldn`t be set or set as `null`.
143121
+ */
143122
+ disabled?: boolean | null;
143123
+ /**
143124
+ * Whether the control is readonly. If not relevant, it shouldn`t be set or set as `null`.
143125
+ */
143126
+ readonly?: boolean | null;
143127
+ };
143128
+
142585
143129
  /**
142586
143130
  * @SINCE 1.110
142587
143131
  *
@@ -142935,6 +143479,10 @@ declare namespace sap {
142935
143479
 
142936
143480
  "sap/m/p13n/Engine": undefined;
142937
143481
 
143482
+ "sap/m/p13n/enum/PersistenceMode": undefined;
143483
+
143484
+ "sap/m/p13n/enum/ProcessingStrategy": undefined;
143485
+
142938
143486
  "sap/m/p13n/GroupController": undefined;
142939
143487
 
142940
143488
  "sap/m/p13n/GroupPanel": undefined;