@openui5/ts-types 1.117.0 → 1.118.0

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.
package/types/sap.m.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- // For Library Version: 1.117.0
1
+ // For Library Version: 1.118.0
2
2
 
3
3
  declare namespace sap {
4
4
  /**
@@ -131,23 +131,28 @@ declare namespace sap {
131
131
  namespace p13n {
132
132
  /**
133
133
  * @since 1.97
134
- * @experimental
135
134
  *
136
135
  * Interface for P13nPopup which are suitable as content for the `sap.m.p13n.Popup`. Implementation of this
137
136
  * interface should include the following methods:
138
137
  * - `getTitle`
138
+ * - `getVerticalScrolling`
139
139
  */
140
140
  interface IContent {
141
141
  __implements__sap_m_p13n_IContent: boolean;
142
142
 
143
143
  /**
144
- * @experimental
145
- *
146
144
  * Returns the title, which should be displayed in the P13nPopup to describe related content.
147
145
  *
148
146
  * @returns The title for the corresponding content to be displayed in the `sap.m.p13n.Popup`.
149
147
  */
150
148
  getTitle(): string;
149
+ /**
150
+ * Optionally returns the enablement of the contents vertical scrolling in case only one panel is used to
151
+ * determine if the content provides its own scrolling capabilites.
152
+ *
153
+ * @returns The enablement of the vertical scrolling enablement for the `sap.m.p13n.Popup`.
154
+ */
155
+ getVerticalScrolling?(): boolean;
151
156
  }
152
157
 
153
158
  interface $BasePanelSettings extends sap.ui.core.$ControlSettings {
@@ -10923,27 +10928,33 @@ declare namespace sap {
10923
10928
  *
10924
10929
  * Fires event {@link #event:cancel cancel} to attached listeners.
10925
10930
  *
10926
- * @returns Reference to `this` in order to allow method chaining
10931
+ * Listeners may prevent the default action of this event by calling the `preventDefault` method on the
10932
+ * event object. The return value of this method indicates whether the default action should be executed.
10933
+ *
10934
+ * @returns Whether or not to prevent the default action
10927
10935
  */
10928
10936
  fireCancel(
10929
10937
  /**
10930
10938
  * Parameters to pass along with the event
10931
10939
  */
10932
10940
  mParameters?: object
10933
- ): this;
10941
+ ): boolean;
10934
10942
  /**
10935
10943
  * @ui5-protected Do not call from applications (only from related classes in the framework)
10936
10944
  *
10937
10945
  * Fires event {@link #event:confirm confirm} to attached listeners.
10938
10946
  *
10939
- * @returns Reference to `this` in order to allow method chaining
10947
+ * Listeners may prevent the default action of this event by calling the `preventDefault` method on the
10948
+ * event object. The return value of this method indicates whether the default action should be executed.
10949
+ *
10950
+ * @returns Whether or not to prevent the default action
10940
10951
  */
10941
10952
  fireConfirm(
10942
10953
  /**
10943
10954
  * Parameters to pass along with the event
10944
10955
  */
10945
10956
  mParameters?: object
10946
- ): this;
10957
+ ): boolean;
10947
10958
  /**
10948
10959
  * @ui5-protected Do not call from applications (only from related classes in the framework)
10949
10960
  *
@@ -22363,6 +22374,18 @@ declare namespace sap {
22363
22374
  */
22364
22375
  tileBadge?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
22365
22376
 
22377
+ /**
22378
+ * @since 1.118
22379
+ * @experimental (since 1.113)
22380
+ *
22381
+ * Sets the offset for the Drop Area associated with a Generic Tile. The offset is applied uniformly to
22382
+ * all the tile edges.
22383
+ */
22384
+ dropAreaOffset?:
22385
+ | int
22386
+ | sap.ui.base.ManagedObject.PropertyBindingInfo
22387
+ | `{${string}}`;
22388
+
22366
22389
  /**
22367
22390
  * The content of the tile.
22368
22391
  */
@@ -28933,6 +28956,14 @@ declare namespace sap {
28933
28956
  | sap.ui.base.ManagedObject.PropertyBindingInfo
28934
28957
  | `{${string}}`;
28935
28958
 
28959
+ /**
28960
+ * Defines the shape of the `Avatar`.
28961
+ */
28962
+ iconShape?:
28963
+ | sap.m.AvatarShape
28964
+ | sap.ui.base.ManagedObject.PropertyBindingInfo
28965
+ | `{${string}}`;
28966
+
28936
28967
  /**
28937
28968
  * Rows of the `PlanningCalendar`.
28938
28969
  */
@@ -39021,6 +39052,20 @@ declare namespace sap {
39021
39052
  * {@link sap.m.IllustrationPool.loadRestOfTheAssets} API.
39022
39053
  */
39023
39054
  interface IllustrationPool {
39055
+ /**
39056
+ * @since 1.116.0
39057
+ *
39058
+ * Returns the metadata of an Illustration Set. The metadata contains the names of the symbols and the theme
39059
+ * mappings. If the Illustration Set is not registered, an error is logged and null is returned.
39060
+ *
39061
+ * @returns The metadata of the Illustration Set
39062
+ */
39063
+ getIllustrationSetMetadata(
39064
+ /**
39065
+ * The name of the illustration set
39066
+ */
39067
+ sSet: string
39068
+ ): object;
39024
39069
  /**
39025
39070
  * Loads an SVG asset depending on the input asset ID.
39026
39071
  */
@@ -39032,7 +39077,13 @@ declare namespace sap {
39032
39077
  /**
39033
39078
  * the ID of the Illustration instance which is requiring the asset
39034
39079
  */
39035
- sInstanceId: string
39080
+ sInstanceId: string,
39081
+ /**
39082
+ * The prefix of the path of the asset being loaded. Used for loading assets from different collections.
39083
+ * Used to store the asset ID in the DOM pool, so it can be distinguished from other assets with the same
39084
+ * ID.
39085
+ */
39086
+ sIdPrefix: string
39036
39087
  ): void;
39037
39088
  /**
39038
39089
  * Loads the rest of the SVG assets for a given illustration set.
@@ -55679,9 +55730,9 @@ declare namespace sap {
55679
55730
  * popup. Standard options are arranged in 6 groups - from 1 to 6. 1 - Single Dates 2 - Date Ranges 3 -
55680
55731
  * Weeks 4 - Months 5 - Quarters 6 - Years
55681
55732
  *
55682
- * @returns A group index
55733
+ * @returns A group key from {@link sap.m.DynamicDateRangeGroups}
55683
55734
  */
55684
- getGroup(): int;
55735
+ getGroup(): int | string;
55685
55736
  /**
55686
55737
  * Provides the option's group header text.
55687
55738
  *
@@ -55953,6 +56004,21 @@ declare namespace sap {
55953
56004
  */
55954
56005
  oCustomOption: sap.m.DynamicDateOption
55955
56006
  ): this;
56007
+ /**
56008
+ * @since 1.118
56009
+ *
56010
+ * Adds a group to the enumeration containing the current groups in `sap.m.DynamicDateRange`
56011
+ */
56012
+ addGroup(
56013
+ /**
56014
+ * the name that the group will be selected by.
56015
+ */
56016
+ sGroupName: string,
56017
+ /**
56018
+ * the group header that will be presented in the list.
56019
+ */
56020
+ sGroupHeader: string
56021
+ ): void;
55956
56022
  /**
55957
56023
  * @since 1.92
55958
56024
  *
@@ -56114,6 +56180,14 @@ declare namespace sap {
56114
56180
  * @returns Value of property `enableGroupHeaders`
56115
56181
  */
56116
56182
  getEnableGroupHeaders(): boolean;
56183
+ /**
56184
+ * @since 1.118
56185
+ *
56186
+ * Provides the option's group header text.
56187
+ *
56188
+ * @returns A group header
56189
+ */
56190
+ getGroupHeader(): string;
56117
56191
  /**
56118
56192
  * @since 1.105
56119
56193
  *
@@ -56363,6 +56437,10 @@ declare namespace sap {
56363
56437
  */
56364
56438
  vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
56365
56439
  ): sap.ui.core.ID | null;
56440
+ /**
56441
+ * Removes all additionally added groups
56442
+ */
56443
+ removeCustomGroups(): void;
56366
56444
  /**
56367
56445
  * Removes a customOption from the aggregation {@link #getCustomOptions customOptions}.
56368
56446
  *
@@ -56451,6 +56529,19 @@ declare namespace sap {
56451
56529
  */
56452
56530
  bEnableGroupHeaders?: boolean
56453
56531
  ): this;
56532
+ /**
56533
+ * Sets a new header to an existing custom group.
56534
+ */
56535
+ setGroupHeader(
56536
+ /**
56537
+ * the name that the group will be selected by.
56538
+ */
56539
+ sGroupName: string,
56540
+ /**
56541
+ * the group header that will be presented in the list.
56542
+ */
56543
+ sGroupHeader: string
56544
+ ): void;
56454
56545
  /**
56455
56546
  * @since 1.105
56456
56547
  *
@@ -57780,23 +57871,6 @@ declare namespace sap {
57780
57871
  * @returns Value of property `text`
57781
57872
  */
57782
57873
  getText(): string;
57783
- /**
57784
- * @deprecated (since 1.18.11) - replaced by `setCounter` method
57785
- *
57786
- * Sets a new value for property {@link #getCount count}.
57787
- *
57788
- * Defines the number of objects that match this item in the target data set.
57789
- *
57790
- * When called with a value of `null` or `undefined`, the default value of the property will be restored.
57791
- *
57792
- * @returns Reference to `this` in order to allow method chaining
57793
- */
57794
- setCount(
57795
- /**
57796
- * New value for property `count`
57797
- */
57798
- iCount?: int
57799
- ): this;
57800
57874
  /**
57801
57875
  * Sets a new value for property {@link #getKey key}.
57802
57876
  *
@@ -58414,27 +58488,6 @@ declare namespace sap {
58414
58488
  */
58415
58489
  mode: sap.m.ListMode
58416
58490
  ): this;
58417
- /**
58418
- * @deprecated (since 1.20.0) - replaced by `setMode` method. `FacetFilterList` overrides the `setMode`
58419
- * method to restrict the possible modes to `MultiSelect` and `SingleSelectMaster`. All other modes are
58420
- * ignored and will not be set.
58421
- *
58422
- * Sets a new value for property {@link #getMultiSelect multiSelect}.
58423
- *
58424
- * Specifies whether multiple or single selection is used.
58425
- *
58426
- * When called with a value of `null` or `undefined`, the default value of the property will be restored.
58427
- *
58428
- * Default value is `true`.
58429
- *
58430
- * @returns Reference to `this` in order to allow method chaining
58431
- */
58432
- setMultiSelect(
58433
- /**
58434
- * New value for property `multiSelect`
58435
- */
58436
- bMultiSelect?: boolean
58437
- ): this;
58438
58491
  /**
58439
58492
  * @since 1.22.1
58440
58493
  *
@@ -62409,6 +62462,20 @@ declare namespace sap {
62409
62462
  * @returns An array containing all of the tile's bounding rectangles
62410
62463
  */
62411
62464
  getBoundingRects(): object[];
62465
+ /**
62466
+ * @since 1.118
62467
+ * @experimental (since 1.113)
62468
+ *
62469
+ * Gets current value of property {@link #getDropAreaOffset dropAreaOffset}.
62470
+ *
62471
+ * Sets the offset for the Drop Area associated with a Generic Tile. The offset is applied uniformly to
62472
+ * all the tile edges.
62473
+ *
62474
+ * Default value is `0`.
62475
+ *
62476
+ * @returns Value of property `dropAreaOffset`
62477
+ */
62478
+ getDropAreaOffset(): int;
62412
62479
  /**
62413
62480
  * @experimental (since 1.96)
62414
62481
  *
@@ -62902,6 +62969,27 @@ declare namespace sap {
62902
62969
  */
62903
62970
  sBackgroundImage?: sap.ui.core.URI
62904
62971
  ): this;
62972
+ /**
62973
+ * @since 1.118
62974
+ * @experimental (since 1.113)
62975
+ *
62976
+ * Sets a new value for property {@link #getDropAreaOffset dropAreaOffset}.
62977
+ *
62978
+ * Sets the offset for the Drop Area associated with a Generic Tile. The offset is applied uniformly to
62979
+ * all the tile edges.
62980
+ *
62981
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
62982
+ *
62983
+ * Default value is `0`.
62984
+ *
62985
+ * @returns Reference to `this` in order to allow method chaining
62986
+ */
62987
+ setDropAreaOffset(
62988
+ /**
62989
+ * New value for property `dropAreaOffset`
62990
+ */
62991
+ iDropAreaOffset?: int
62992
+ ): this;
62905
62993
  /**
62906
62994
  * @experimental (since 1.96)
62907
62995
  *
@@ -74178,22 +74266,6 @@ declare namespace sap {
74178
74266
  */
74179
74267
  oListener?: object
74180
74268
  ): this;
74181
- /**
74182
- * @ui5-protected Do not call from applications (only from related classes in the framework)
74183
- *
74184
- * This method is a hook for the RenderManager that gets called during the rendering of child Controls.
74185
- * It allows to add, remove and update existing accessibility attributes (ARIA) of those controls.
74186
- */
74187
- enhanceAccessibilityState(
74188
- /**
74189
- * The Control that gets rendered by the RenderManager
74190
- */
74191
- oElement: sap.ui.core.Control,
74192
- /**
74193
- * The mapping of "aria-" prefixed attributes
74194
- */
74195
- mAriaProps: object
74196
- ): void;
74197
74269
  /**
74198
74270
  * @since 1.54
74199
74271
  * @ui5-protected Do not call from applications (only from related classes in the framework)
@@ -74555,7 +74627,7 @@ declare namespace sap {
74555
74627
  *
74556
74628
  * Defines keyboard handling behavior of the control.
74557
74629
  *
74558
- * Default value is `Navigation`.
74630
+ * Default value is `"Navigation"`.
74559
74631
  *
74560
74632
  * @returns Value of property `keyboardMode`
74561
74633
  */
@@ -75165,7 +75237,7 @@ declare namespace sap {
75165
75237
  *
75166
75238
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
75167
75239
  *
75168
- * Default value is `Navigation`.
75240
+ * Default value is `"Navigation"`.
75169
75241
  *
75170
75242
  * @returns Reference to `this` in order to allow method chaining
75171
75243
  */
@@ -99908,6 +99980,16 @@ declare namespace sap {
99908
99980
  * @returns Value of property `height`
99909
99981
  */
99910
99982
  getHeight(): sap.ui.core.CSSSize;
99983
+ /**
99984
+ * Gets current value of property {@link #getIconShape iconShape}.
99985
+ *
99986
+ * Defines the shape of the `Avatar`.
99987
+ *
99988
+ * Default value is `Circle`.
99989
+ *
99990
+ * @returns Value of property `iconShape`
99991
+ */
99992
+ getIconShape(): sap.m.AvatarShape;
99911
99993
  /**
99912
99994
  * @since 1.40.0
99913
99995
  *
@@ -100596,6 +100678,23 @@ declare namespace sap {
100596
100678
  */
100597
100679
  sHeight?: sap.ui.core.CSSSize
100598
100680
  ): this;
100681
+ /**
100682
+ * Sets a new value for property {@link #getIconShape iconShape}.
100683
+ *
100684
+ * Defines the shape of the `Avatar`.
100685
+ *
100686
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
100687
+ *
100688
+ * Default value is `Circle`.
100689
+ *
100690
+ * @returns Reference to `this` in order to allow method chaining
100691
+ */
100692
+ setIconShape(
100693
+ /**
100694
+ * New value for property `iconShape`
100695
+ */
100696
+ sIconShape?: sap.m.AvatarShape
100697
+ ): this;
100599
100698
  /**
100600
100699
  * @since 1.40.0
100601
100700
  *
@@ -143703,6 +143802,37 @@ declare namespace sap {
143703
143802
  */
143704
143803
  Saving = "Saving",
143705
143804
  }
143805
+ /**
143806
+ * @since 1.118
143807
+ *
143808
+ * Defines the groups in {@link sap.m.DynamicDateRange}.
143809
+ */
143810
+ enum DynamicDateRangeGroups {
143811
+ /**
143812
+ * Group of options that provide selection of date ranges.
143813
+ */
143814
+ DateRanges = "DateRanges",
143815
+ /**
143816
+ * Group of options that provide selection of month related ranges.
143817
+ */
143818
+ Month = "Month",
143819
+ /**
143820
+ * Group of options that provide selection of quarter related ranges.
143821
+ */
143822
+ Quarters = "Quarters",
143823
+ /**
143824
+ * Group of options that provide selection of single dates.
143825
+ */
143826
+ SingleDates = "SingleDates",
143827
+ /**
143828
+ * Group of options that provide selection of week related ranges.
143829
+ */
143830
+ Weeks = "Weeks",
143831
+ /**
143832
+ * Group of options that provide selection of year related ranges.
143833
+ */
143834
+ Years = "Years",
143835
+ }
143706
143836
  /**
143707
143837
  * @since 1.87
143708
143838
  *
@@ -144736,18 +144866,19 @@ declare namespace sap {
144736
144866
  */
144737
144867
  enum ListKeyboardMode {
144738
144868
  /**
144739
- * This mode is suitable if the number of items is limited and if there are editable fields within the item.
144869
+ * This mode is suitable if there are only editable fields within the item.
144740
144870
  *
144741
- * While the last/first interactive element within an item has the focus, pressing tab/shift+tab moves the
144742
- * focus to the next/previous element in the tab chain after/before the item .
144871
+ * In this mode, the first focus goes to the first interactive element within the first item and this is
144872
+ * the only difference between the `Edit` and `Navigation` mode.
144743
144873
  */
144744
144874
  Edit = "Edit",
144745
144875
  /**
144746
- * This default mode is suitable if the number of items is unlimited or if there is no editable field within
144747
- * the item.
144876
+ * This default mode is suitable if the List or Table contains editable and/or non-editable fields.
144748
144877
  *
144749
- * While the last/first interactive element within an item has the focus, pressing tab/shift+tab moves the
144750
- * focus to the next/previous element in the tab chain after/before the `sap.m.List` or `sap.m.Table`.
144878
+ * In this mode, the first focus goes to the first item. If the focus is on the item, or cell, pressing
144879
+ * tab/shift+tab moves the focus to the next/previous element in the tab chain after/before the `sap.m.List`
144880
+ * or `sap.m.Table` control. If the focus is on the interactive element, pressing tab/shift+tab moves the
144881
+ * focus to the next/previous element in the tab chain after/before the focused interactive element.
144751
144882
  */
144752
144883
  Navigation = "Navigation",
144753
144884
  }
@@ -1,4 +1,4 @@
1
- // For Library Version: 1.117.0
1
+ // For Library Version: 1.118.0
2
2
 
3
3
  declare namespace sap {
4
4
  /**
@@ -1,4 +1,4 @@
1
- // For Library Version: 1.117.0
1
+ // For Library Version: 1.118.0
2
2
 
3
3
  declare namespace sap {
4
4
  namespace ui {
@@ -517,7 +517,10 @@ declare namespace sap {
517
517
  /**
518
518
  * @since 1.54.1
519
519
  *
520
- * Pretty-prints the content of the editor
520
+ * Pretty-prints the content of the editor.
521
+ *
522
+ * **Note:** Works well only for PHP. For other programming languages, the content might not be formatted
523
+ * well. In such cases it is recommended to use your own formatting.
521
524
  */
522
525
  prettyPrint(): void;
523
526
  /**
@@ -1,4 +1,4 @@
1
- // For Library Version: 1.117.0
1
+ // For Library Version: 1.118.0
2
2
 
3
3
  declare namespace sap {
4
4
  namespace ui {