@openui5/ts-types 1.97.1 → 1.99.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.
@@ -1,4 +1,4 @@
1
- // For Library Version: 1.97.1
1
+ // For Library Version: 1.99.1
2
2
 
3
3
  declare namespace sap {
4
4
  namespace ui {
@@ -401,7 +401,8 @@ declare namespace sap {
401
401
  | sap.ui.base.ManagedObject.AggregationBindingInfo;
402
402
 
403
403
  /**
404
- * Fires when a `BreadcrumbsItem` is clicked.
404
+ * Fires when a `BreadcrumbsItem` is clicked. **Note:** You can prevent browser location change by calling
405
+ * `event.preventDefault()`.
405
406
  */
406
407
  itemClick?: (oEvent: sap.ui.base.Event) => void;
407
408
  }
@@ -500,6 +501,31 @@ declare namespace sap {
500
501
 
501
502
  interface $ButtonSettings
502
503
  extends sap.ui.webc.common.$WebComponentSettings {
504
+ /**
505
+ * An object of strings that defines several additional accessibility attribute values for customization
506
+ * depending on the use case.
507
+ *
508
+ * It supports the following fields:
509
+ *
510
+ *
511
+ * - `expanded`: Indicates whether the button, or another grouping element it controls, is currently expanded
512
+ * or collapsed. Accepts the following string values:
513
+ * `true`
514
+ * - `false`
515
+ * - `hasPopup`: Indicates the availability and type of interactive popup element, such as menu or dialog,
516
+ * that can be triggered by the button. Accepts the following string values:
517
+ * `Dialog`
518
+ * - `Grid`
519
+ * - `ListBox`
520
+ * - `Menu`
521
+ * - `Tree`
522
+ * - `controls`: Identifies the element (or elements) whose contents or presence are controlled by the
523
+ * button element. Accepts a string value.
524
+ */
525
+ accessibilityAttributes?:
526
+ | object
527
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
528
+
503
529
  /**
504
530
  * Sets the accessible aria name of the component.
505
531
  */
@@ -569,6 +595,11 @@ declare namespace sap {
569
595
  | sap.ui.core.CSSSize
570
596
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
571
597
 
598
+ /**
599
+ * Receives id(or many ids) of the controls that label this control.
600
+ */
601
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
602
+
572
603
  /**
573
604
  * Fired when the component is activated either with a mouse/tap or by using the Enter or Space key.
574
605
  *
@@ -665,19 +696,12 @@ declare namespace sap {
665
696
  extends sap.ui.webc.common.$WebComponentSettings {
666
697
  /**
667
698
  * Defines the accessible name of the component, which is used as the name of the card region and should
668
- * be unique per card. **Note:** `accessibleName` should be always set, unless `accessibleNameRef` is set.
699
+ * be unique per card. **Note:** `accessibleName` should be always set, unless `ariaLabelledBy` is set.
669
700
  */
670
701
  accessibleName?:
671
702
  | string
672
703
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
673
704
 
674
- /**
675
- * Defines the IDs of the elements that label the component.
676
- */
677
- accessibleNameRef?:
678
- | string
679
- | sap.ui.base.ManagedObject.PropertyBindingInfo;
680
-
681
705
  /**
682
706
  * Defines the height of the control
683
707
  */
@@ -709,6 +733,11 @@ declare namespace sap {
709
733
  | sap.ui.core.Control[]
710
734
  | sap.ui.core.Control
711
735
  | sap.ui.base.ManagedObject.AggregationBindingInfo;
736
+
737
+ /**
738
+ * Receives id(or many ids) of the controls that label this control.
739
+ */
740
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
712
741
  }
713
742
 
714
743
  interface $CardHeaderSettings
@@ -835,6 +864,13 @@ declare namespace sap {
835
864
 
836
865
  interface $CheckBoxSettings
837
866
  extends sap.ui.webc.common.$WebComponentSettings {
867
+ /**
868
+ * Sets the accessible aria name of the component.
869
+ */
870
+ accessibleName?:
871
+ | string
872
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
873
+
838
874
  /**
839
875
  * Defines if the component is checked.
840
876
  *
@@ -904,6 +940,13 @@ declare namespace sap {
904
940
  | sap.ui.core.ValueState
905
941
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
906
942
 
943
+ /**
944
+ * Defines the width of the control
945
+ */
946
+ width?:
947
+ | sap.ui.core.CSSSize
948
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
949
+
907
950
  /**
908
951
  * Defines whether the component text wraps when there is not enough space.
909
952
  *
@@ -915,6 +958,11 @@ declare namespace sap {
915
958
  | sap.ui.webc.main.WrappingType
916
959
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
917
960
 
961
+ /**
962
+ * Receives id(or many ids) of the controls that label this control.
963
+ */
964
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
965
+
918
966
  /**
919
967
  * Fired when the component checked state changes.
920
968
  */
@@ -1021,13 +1069,6 @@ declare namespace sap {
1021
1069
  | string
1022
1070
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
1023
1071
 
1024
- /**
1025
- * Receives id(or many ids) of the elements that label the combo box
1026
- */
1027
- accessibleNameRef?:
1028
- | string
1029
- | sap.ui.base.ManagedObject.PropertyBindingInfo;
1030
-
1031
1072
  /**
1032
1073
  * Defines whether the component is in disabled state.
1033
1074
  *
@@ -1113,6 +1154,11 @@ declare namespace sap {
1113
1154
  | sap.ui.webc.main.IComboBoxItem
1114
1155
  | sap.ui.base.ManagedObject.AggregationBindingInfo;
1115
1156
 
1157
+ /**
1158
+ * Receives id(or many ids) of the controls that label this control.
1159
+ */
1160
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
1161
+
1116
1162
  /**
1117
1163
  * Fired when the input operation has finished by pressing Enter, focusout or an item is selected.
1118
1164
  */
@@ -1203,13 +1249,6 @@ declare namespace sap {
1203
1249
  | string
1204
1250
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
1205
1251
 
1206
- /**
1207
- * Receives id(or many ids) of the elements that label the component.
1208
- */
1209
- accessibleNameRef?:
1210
- | string
1211
- | sap.ui.base.ManagedObject.PropertyBindingInfo;
1212
-
1213
1252
  /**
1214
1253
  * Determines whether the component is displayed as disabled.
1215
1254
  */
@@ -1326,6 +1365,11 @@ declare namespace sap {
1326
1365
  | sap.ui.core.CSSSize
1327
1366
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
1328
1367
 
1368
+ /**
1369
+ * Receives id(or many ids) of the controls that label this control.
1370
+ */
1371
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
1372
+
1329
1373
  /**
1330
1374
  * Fired when the input operation has finished by pressing Enter or on focusout.
1331
1375
  */
@@ -1346,13 +1390,6 @@ declare namespace sap {
1346
1390
  | string
1347
1391
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
1348
1392
 
1349
- /**
1350
- * Receives id(or many ids) of the elements that label the component.
1351
- */
1352
- accessibleNameRef?:
1353
- | string
1354
- | sap.ui.base.ManagedObject.PropertyBindingInfo;
1355
-
1356
1393
  /**
1357
1394
  * Determines the symbol which separates the dates. If not supplied, the default time interval delimiter
1358
1395
  * for the current locale will be used.
@@ -1475,6 +1512,11 @@ declare namespace sap {
1475
1512
  | sap.ui.core.CSSSize
1476
1513
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
1477
1514
 
1515
+ /**
1516
+ * Receives id(or many ids) of the controls that label this control.
1517
+ */
1518
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
1519
+
1478
1520
  /**
1479
1521
  * Fired when the input operation has finished by pressing Enter or on focusout.
1480
1522
  */
@@ -1495,13 +1537,6 @@ declare namespace sap {
1495
1537
  | string
1496
1538
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
1497
1539
 
1498
- /**
1499
- * Receives id(or many ids) of the elements that label the component.
1500
- */
1501
- accessibleNameRef?:
1502
- | string
1503
- | sap.ui.base.ManagedObject.PropertyBindingInfo;
1504
-
1505
1540
  /**
1506
1541
  * Determines whether the component is displayed as disabled.
1507
1542
  */
@@ -1618,6 +1653,11 @@ declare namespace sap {
1618
1653
  | sap.ui.core.CSSSize
1619
1654
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
1620
1655
 
1656
+ /**
1657
+ * Receives id(or many ids) of the controls that label this control.
1658
+ */
1659
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
1660
+
1621
1661
  /**
1622
1662
  * Fired when the input operation has finished by pressing Enter or on focusout.
1623
1663
  */
@@ -1632,7 +1672,7 @@ declare namespace sap {
1632
1672
  interface $DialogSettings
1633
1673
  extends sap.ui.webc.common.$WebComponentSettings {
1634
1674
  /**
1635
- * Sets the accessible aria name of the component.
1675
+ * Defines the accessible name of the component.
1636
1676
  */
1637
1677
  accessibleName?:
1638
1678
  | string
@@ -1723,6 +1763,11 @@ declare namespace sap {
1723
1763
  | sap.ui.core.Control
1724
1764
  | sap.ui.base.ManagedObject.AggregationBindingInfo;
1725
1765
 
1766
+ /**
1767
+ * Receives id(or many ids) of the controls that label this control.
1768
+ */
1769
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
1770
+
1726
1771
  /**
1727
1772
  * Fired after the component is closed. **This event does not bubble.**
1728
1773
  */
@@ -1876,6 +1921,13 @@ declare namespace sap {
1876
1921
  | string
1877
1922
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
1878
1923
 
1924
+ /**
1925
+ * Defines the accessibility role of the component.
1926
+ */
1927
+ accessibleRole?:
1928
+ | string
1929
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
1930
+
1879
1931
  /**
1880
1932
  * Defines the background color of the control
1881
1933
  */
@@ -1950,13 +2002,6 @@ declare namespace sap {
1950
2002
  | string
1951
2003
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
1952
2004
 
1953
- /**
1954
- * Receives id(or many ids) of the elements that label the input.
1955
- */
1956
- accessibleNameRef?:
1957
- | string
1958
- | sap.ui.base.ManagedObject.PropertyBindingInfo;
1959
-
1960
2005
  /**
1961
2006
  * Defines whether the component is in disabled state.
1962
2007
  *
@@ -1996,6 +2041,13 @@ declare namespace sap {
1996
2041
  */
1997
2042
  required?: boolean | sap.ui.base.ManagedObject.PropertyBindingInfo;
1998
2043
 
2044
+ /**
2045
+ * Defines whether the clear icon of the input will be shown.
2046
+ */
2047
+ showClearIcon?:
2048
+ | boolean
2049
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
2050
+
1999
2051
  /**
2000
2052
  * Defines whether the component should show suggestions, if such are present.
2001
2053
  *
@@ -2052,6 +2104,13 @@ declare namespace sap {
2052
2104
  | string
2053
2105
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
2054
2106
 
2107
+ /**
2108
+ * Defines the width of the control
2109
+ */
2110
+ width?:
2111
+ | sap.ui.core.CSSSize
2112
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
2113
+
2055
2114
  /**
2056
2115
  * Defines the icon to be displayed in the component.
2057
2116
  */
@@ -2065,6 +2124,11 @@ declare namespace sap {
2065
2124
  | sap.ui.webc.main.IInputSuggestionItem
2066
2125
  | sap.ui.base.ManagedObject.AggregationBindingInfo;
2067
2126
 
2127
+ /**
2128
+ * Receives id(or many ids) of the controls that label this control.
2129
+ */
2130
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
2131
+
2068
2132
  /**
2069
2133
  * Fired when the input operation has finished by pressing Enter or on focusout.
2070
2134
  */
@@ -2090,13 +2154,6 @@ declare namespace sap {
2090
2154
 
2091
2155
  interface $LabelSettings
2092
2156
  extends sap.ui.webc.common.$WebComponentSettings {
2093
- /**
2094
- * Defines the labeled input by providing its ID.
2095
- *
2096
- * **Note:** Can be used with both `sap.ui.webc.main.Input` and native input.
2097
- */
2098
- for?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
2099
-
2100
2157
  /**
2101
2158
  * Defines whether an asterisk character is added to the component text.
2102
2159
  *
@@ -2132,15 +2189,40 @@ declare namespace sap {
2132
2189
  wrappingType?:
2133
2190
  | sap.ui.webc.main.WrappingType
2134
2191
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
2192
+
2193
+ /**
2194
+ * Association to the labelled control.
2195
+ *
2196
+ *
2197
+ * By default, the label sets the for attribute to the ID of the labelled control. This can be changed by
2198
+ * implementing the function getIdForLabel on the labelled control.
2199
+ */
2200
+ labelFor?: sap.ui.core.Control | string;
2135
2201
  }
2136
2202
 
2137
2203
  interface $LinkSettings
2138
2204
  extends sap.ui.webc.common.$WebComponentSettings {
2139
2205
  /**
2140
- * Receives id(or many ids) of the elements that label the input
2206
+ * An object of strings that defines several additional accessibility attribute values for customization
2207
+ * depending on the use case.
2208
+ *
2209
+ * It supports the following fields:
2210
+ *
2211
+ *
2212
+ * - `expanded`: Indicates whether the anchor element, or another grouping element it controls, is currently
2213
+ * expanded or collapsed. Accepts the following string values:
2214
+ * `true`
2215
+ * - `false`
2216
+ * - `hasPopup`: Indicates the availability and type of interactive popup element, such as menu or dialog,
2217
+ * that can be triggered by the anchor element. Accepts the following string values:
2218
+ * `Dialog`
2219
+ * - `Grid`
2220
+ * - `ListBox`
2221
+ * - `Menu`
2222
+ * - `Tree`
2141
2223
  */
2142
- accessibleNameRef?:
2143
- | string
2224
+ accessibilityAttributes?:
2225
+ | object
2144
2226
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
2145
2227
 
2146
2228
  /**
@@ -2197,6 +2279,11 @@ declare namespace sap {
2197
2279
  | sap.ui.webc.main.WrappingType
2198
2280
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
2199
2281
 
2282
+ /**
2283
+ * Receives id(or many ids) of the controls that label this control.
2284
+ */
2285
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
2286
+
2200
2287
  /**
2201
2288
  * Fired when the component is triggered either with a mouse/tap or by using the Enter key.
2202
2289
  */
@@ -2212,13 +2299,6 @@ declare namespace sap {
2212
2299
  | string
2213
2300
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
2214
2301
 
2215
- /**
2216
- * Defines the IDs of the elements that label the input.
2217
- */
2218
- accessibleNameRef?:
2219
- | string
2220
- | sap.ui.base.ManagedObject.PropertyBindingInfo;
2221
-
2222
2302
  /**
2223
2303
  * Defines the accessible role of the component.
2224
2304
  */
@@ -2256,7 +2336,7 @@ declare namespace sap {
2256
2336
  *
2257
2337
  *
2258
2338
  *
2259
- * **Limitations:** `growing="Scroll"` is not supported for Internet Explorer, on IE the component will
2339
+ * **Restrictions:** `growing="Scroll"` is not supported for Internet Explorer, on IE the component will
2260
2340
  * fallback to `growing="Button"`.
2261
2341
  */
2262
2342
  growing?:
@@ -2338,6 +2418,11 @@ declare namespace sap {
2338
2418
  | sap.ui.webc.main.IListItem
2339
2419
  | sap.ui.base.ManagedObject.AggregationBindingInfo;
2340
2420
 
2421
+ /**
2422
+ * Receives id(or many ids) of the controls that label this control.
2423
+ */
2424
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
2425
+
2341
2426
  /**
2342
2427
  * Fired when an item is activated, unless the item's `type` property is set to `Inactive`.
2343
2428
  */
@@ -2511,6 +2596,13 @@ declare namespace sap {
2511
2596
  | string
2512
2597
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
2513
2598
 
2599
+ /**
2600
+ * Defines the width of the control
2601
+ */
2602
+ width?:
2603
+ | sap.ui.core.CSSSize
2604
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
2605
+
2514
2606
  /**
2515
2607
  * Defines the icon to be displayed in the component.
2516
2608
  */
@@ -2574,13 +2666,6 @@ declare namespace sap {
2574
2666
  | string
2575
2667
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
2576
2668
 
2577
- /**
2578
- * Receives id(or many ids) of the elements that label the input.
2579
- */
2580
- accessibleNameRef?:
2581
- | string
2582
- | sap.ui.base.ManagedObject.PropertyBindingInfo;
2583
-
2584
2669
  /**
2585
2670
  * Defines whether the component is in disabled state.
2586
2671
  *
@@ -2620,6 +2705,13 @@ declare namespace sap {
2620
2705
  */
2621
2706
  required?: boolean | sap.ui.base.ManagedObject.PropertyBindingInfo;
2622
2707
 
2708
+ /**
2709
+ * Defines whether the clear icon of the input will be shown.
2710
+ */
2711
+ showClearIcon?:
2712
+ | boolean
2713
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
2714
+
2623
2715
  /**
2624
2716
  * Defines whether the component should show suggestions, if such are present.
2625
2717
  *
@@ -2684,6 +2776,13 @@ declare namespace sap {
2684
2776
  | string
2685
2777
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
2686
2778
 
2779
+ /**
2780
+ * Defines the width of the control
2781
+ */
2782
+ width?:
2783
+ | sap.ui.core.CSSSize
2784
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
2785
+
2687
2786
  /**
2688
2787
  * Defines the icon to be displayed in the component.
2689
2788
  */
@@ -2705,6 +2804,11 @@ declare namespace sap {
2705
2804
  | sap.ui.webc.main.IToken
2706
2805
  | sap.ui.base.ManagedObject.AggregationBindingInfo;
2707
2806
 
2807
+ /**
2808
+ * Receives id(or many ids) of the controls that label this control.
2809
+ */
2810
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
2811
+
2708
2812
  /**
2709
2813
  * Fired when the input operation has finished by pressing Enter or on focusout.
2710
2814
  */
@@ -2864,7 +2968,7 @@ declare namespace sap {
2864
2968
  interface $PopoverSettings
2865
2969
  extends sap.ui.webc.common.$WebComponentSettings {
2866
2970
  /**
2867
- * Sets the accessible aria name of the component.
2971
+ * Defines the accessible name of the component.
2868
2972
  */
2869
2973
  accessibleName?:
2870
2974
  | string
@@ -2991,6 +3095,11 @@ declare namespace sap {
2991
3095
  | sap.ui.core.Control
2992
3096
  | sap.ui.base.ManagedObject.AggregationBindingInfo;
2993
3097
 
3098
+ /**
3099
+ * Receives id(or many ids) of the controls that label this control.
3100
+ */
3101
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
3102
+
2994
3103
  /**
2995
3104
  * Fired after the component is closed. **This event does not bubble.**
2996
3105
  */
@@ -3056,6 +3165,13 @@ declare namespace sap {
3056
3165
  valueState?:
3057
3166
  | sap.ui.core.ValueState
3058
3167
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
3168
+
3169
+ /**
3170
+ * Defines the width of the control
3171
+ */
3172
+ width?:
3173
+ | sap.ui.core.CSSSize
3174
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
3059
3175
  }
3060
3176
 
3061
3177
  interface $RadioButtonSettings
@@ -3120,6 +3236,13 @@ declare namespace sap {
3120
3236
  | sap.ui.core.ValueState
3121
3237
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
3122
3238
 
3239
+ /**
3240
+ * Defines the width of the control
3241
+ */
3242
+ width?:
3243
+ | sap.ui.core.CSSSize
3244
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
3245
+
3123
3246
  /**
3124
3247
  * Defines whether the component text wraps when there is not enough space.
3125
3248
  *
@@ -3131,6 +3254,11 @@ declare namespace sap {
3131
3254
  | sap.ui.webc.main.WrappingType
3132
3255
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
3133
3256
 
3257
+ /**
3258
+ * Receives id(or many ids) of the controls that label this control.
3259
+ */
3260
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
3261
+
3134
3262
  /**
3135
3263
  * Fired when the component checked state changes.
3136
3264
  */
@@ -3263,7 +3391,7 @@ declare namespace sap {
3263
3391
  interface $ResponsivePopoverSettings
3264
3392
  extends sap.ui.webc.common.$WebComponentSettings {
3265
3393
  /**
3266
- * Sets the accessible aria name of the component.
3394
+ * Defines the accessible name of the component.
3267
3395
  */
3268
3396
  accessibleName?:
3269
3397
  | string
@@ -3376,6 +3504,11 @@ declare namespace sap {
3376
3504
  | sap.ui.core.Control
3377
3505
  | sap.ui.base.ManagedObject.AggregationBindingInfo;
3378
3506
 
3507
+ /**
3508
+ * Receives id(or many ids) of the controls that label this control.
3509
+ */
3510
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
3511
+
3379
3512
  /**
3380
3513
  * Fired after the component is closed. **This event does not bubble.**
3381
3514
  */
@@ -3401,6 +3534,13 @@ declare namespace sap {
3401
3534
 
3402
3535
  interface $SegmentedButtonSettings
3403
3536
  extends sap.ui.webc.common.$WebComponentSettings {
3537
+ /**
3538
+ * Sets the accessible aria name of the component.
3539
+ */
3540
+ accessibleName?:
3541
+ | string
3542
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
3543
+
3404
3544
  /**
3405
3545
  * Defines the items of `sap.ui.webc.main.SegmentedButton`.
3406
3546
  *
@@ -3421,6 +3561,31 @@ declare namespace sap {
3421
3561
 
3422
3562
  interface $SegmentedButtonItemSettings
3423
3563
  extends sap.ui.webc.common.$WebComponentSettings {
3564
+ /**
3565
+ * An object of strings that defines several additional accessibility attribute values for customization
3566
+ * depending on the use case.
3567
+ *
3568
+ * It supports the following fields:
3569
+ *
3570
+ *
3571
+ * - `expanded`: Indicates whether the button, or another grouping element it controls, is currently expanded
3572
+ * or collapsed. Accepts the following string values:
3573
+ * `true`
3574
+ * - `false`
3575
+ * - `hasPopup`: Indicates the availability and type of interactive popup element, such as menu or dialog,
3576
+ * that can be triggered by the button. Accepts the following string values:
3577
+ * `Dialog`
3578
+ * - `Grid`
3579
+ * - `ListBox`
3580
+ * - `Menu`
3581
+ * - `Tree`
3582
+ * - `controls`: Identifies the element (or elements) whose contents or presence are controlled by the
3583
+ * button element. Accepts a string value.
3584
+ */
3585
+ accessibilityAttributes?:
3586
+ | object
3587
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
3588
+
3424
3589
  /**
3425
3590
  * Sets the accessible aria name of the component.
3426
3591
  */
@@ -3471,6 +3636,11 @@ declare namespace sap {
3471
3636
  */
3472
3637
  text?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
3473
3638
 
3639
+ /**
3640
+ * Receives id(or many ids) of the controls that label this control.
3641
+ */
3642
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
3643
+
3474
3644
  /**
3475
3645
  * Fired when the component is activated either with a mouse/tap or by using the Enter or Space key.
3476
3646
  *
@@ -3488,13 +3658,6 @@ declare namespace sap {
3488
3658
  | string
3489
3659
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
3490
3660
 
3491
- /**
3492
- * Receives id(or many ids) of the elements that label the select.
3493
- */
3494
- accessibleNameRef?:
3495
- | string
3496
- | sap.ui.base.ManagedObject.PropertyBindingInfo;
3497
-
3498
3661
  /**
3499
3662
  * Defines whether the component is in disabled state.
3500
3663
  *
@@ -3544,6 +3707,13 @@ declare namespace sap {
3544
3707
  | string
3545
3708
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
3546
3709
 
3710
+ /**
3711
+ * Defines the width of the control
3712
+ */
3713
+ width?:
3714
+ | sap.ui.core.CSSSize
3715
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
3716
+
3547
3717
  /**
3548
3718
  * Defines the component options.
3549
3719
  *
@@ -3561,6 +3731,11 @@ declare namespace sap {
3561
3731
  | sap.ui.webc.main.ISelectOption
3562
3732
  | sap.ui.base.ManagedObject.AggregationBindingInfo;
3563
3733
 
3734
+ /**
3735
+ * Receives id(or many ids) of the controls that label this control.
3736
+ */
3737
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
3738
+
3564
3739
  /**
3565
3740
  * Fired when the selected option changes.
3566
3741
  */
@@ -3621,6 +3796,13 @@ declare namespace sap {
3621
3796
  */
3622
3797
  value?: float | sap.ui.base.ManagedObject.PropertyBindingInfo;
3623
3798
 
3799
+ /**
3800
+ * Defines the width of the control
3801
+ */
3802
+ width?:
3803
+ | sap.ui.core.CSSSize
3804
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
3805
+
3624
3806
  /**
3625
3807
  * Fired when the value changes and the user has finished interacting with the slider.
3626
3808
  */
@@ -3632,6 +3814,71 @@ declare namespace sap {
3632
3814
  input?: (oEvent: sap.ui.base.Event) => void;
3633
3815
  }
3634
3816
 
3817
+ interface $SplitButtonSettings
3818
+ extends sap.ui.webc.common.$WebComponentSettings {
3819
+ /**
3820
+ * Sets the accessible aria name of the component.
3821
+ */
3822
+ accessibleName?:
3823
+ | string
3824
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
3825
+
3826
+ /**
3827
+ * Defines the icon to be displayed in active state as graphical element within the component.
3828
+ */
3829
+ activeIcon?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
3830
+
3831
+ /**
3832
+ * Defines the component design.
3833
+ *
3834
+ *
3835
+ *
3836
+ * **The available values are:**
3837
+ *
3838
+ *
3839
+ * - `Default`
3840
+ * - `Emphasized`
3841
+ * - `Positive`
3842
+ * - `Negative`
3843
+ * - `Transparent`
3844
+ * - `Attention`
3845
+ */
3846
+ design?:
3847
+ | sap.ui.webc.main.ButtonDesign
3848
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
3849
+
3850
+ /**
3851
+ * Defines whether the component is disabled. A disabled component can't be pressed or focused, and it is
3852
+ * not in the tab chain.
3853
+ */
3854
+ disabled?: boolean | sap.ui.base.ManagedObject.PropertyBindingInfo;
3855
+
3856
+ /**
3857
+ * Defines the icon to be displayed as graphical element within the component. The SAP-icons font provides
3858
+ * numerous options.
3859
+ *
3860
+ * Example:
3861
+ *
3862
+ * See all the available icons in the Icon Explorer.
3863
+ */
3864
+ icon?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
3865
+
3866
+ /**
3867
+ * Defines the content of the control
3868
+ */
3869
+ text?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
3870
+
3871
+ /**
3872
+ * Fired when the user clicks on the arrow action.
3873
+ */
3874
+ arrowClick?: (oEvent: sap.ui.base.Event) => void;
3875
+
3876
+ /**
3877
+ * Fired when the user clicks on the default action.
3878
+ */
3879
+ click?: (oEvent: sap.ui.base.Event) => void;
3880
+ }
3881
+
3635
3882
  interface $StandardListItemSettings
3636
3883
  extends sap.ui.webc.common.$WebComponentSettings {
3637
3884
  /**
@@ -3720,13 +3967,6 @@ declare namespace sap {
3720
3967
  | string
3721
3968
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
3722
3969
 
3723
- /**
3724
- * Receives id(or many ids) of the elements that label the component.
3725
- */
3726
- accessibleNameRef?:
3727
- | string
3728
- | sap.ui.base.ManagedObject.PropertyBindingInfo;
3729
-
3730
3970
  /**
3731
3971
  * Determines whether the component is displayed as disabled.
3732
3972
  */
@@ -3813,6 +4053,18 @@ declare namespace sap {
3813
4053
  | string
3814
4054
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
3815
4055
 
4056
+ /**
4057
+ * Defines the width of the control
4058
+ */
4059
+ width?:
4060
+ | sap.ui.core.CSSSize
4061
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
4062
+
4063
+ /**
4064
+ * Receives id(or many ids) of the controls that label this control.
4065
+ */
4066
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
4067
+
3816
4068
  /**
3817
4069
  * Fired when the input operation has finished by pressing Enter or on focusout.
3818
4070
  */
@@ -3933,6 +4185,11 @@ declare namespace sap {
3933
4185
  */
3934
4186
  textOn?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
3935
4187
 
4188
+ /**
4189
+ * Receives id(or many ids) of the controls that label this control.
4190
+ */
4191
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
4192
+
3936
4193
  /**
3937
4194
  * Fired when the component checked state changes.
3938
4195
  */
@@ -3942,7 +4199,7 @@ declare namespace sap {
3942
4199
  interface $TabSettings
3943
4200
  extends sap.ui.webc.common.$WebComponentSettings {
3944
4201
  /**
3945
- * Represents the "additionalText" text, which is displayed in the tab filter.
4202
+ * Represents the "additionalText" text, which is displayed in the tab.
3946
4203
  */
3947
4204
  additionalText?:
3948
4205
  | string
@@ -4020,8 +4277,8 @@ declare namespace sap {
4020
4277
  /**
4021
4278
  * Defines whether the overflow select list is displayed.
4022
4279
  *
4023
- * The overflow select list represents a list, where all tab filters are displayed so that it's easier
4024
- * for the user to select a specific tab filter.
4280
+ * The overflow select list represents a list, where all tabs are displayed so that it's easier for the
4281
+ * user to select a specific tab.
4025
4282
  */
4026
4283
  showOverflow?:
4027
4284
  | boolean
@@ -4045,6 +4302,26 @@ declare namespace sap {
4045
4302
  | sap.ui.webc.main.TabLayout
4046
4303
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
4047
4304
 
4305
+ /**
4306
+ * Defines the overflow mode of the tab strip. If you have a large number of tabs, only the tabs that can
4307
+ * fit on screen will be visible. All other tabs that can 't fit on the screen are available in an overflow
4308
+ * tab "More".
4309
+ *
4310
+ *
4311
+ *
4312
+ * **Note:** Only one overflow at the end would be displayed by default, but when set to `StartAndEnd`,
4313
+ * there will be two overflows on both ends, and tab order will not change on tab selection.
4314
+ *
4315
+ *
4316
+ *
4317
+ * Available options are:
4318
+ * - `End`
4319
+ * - `StartAndEnd`
4320
+ */
4321
+ tabsOverflowMode?:
4322
+ | sap.ui.webc.main.TabsOverflowMode
4323
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
4324
+
4048
4325
  /**
4049
4326
  * Defines the width of the control
4050
4327
  */
@@ -4068,6 +4345,12 @@ declare namespace sap {
4068
4345
  */
4069
4346
  overflowButton?: sap.ui.webc.main.IButton;
4070
4347
 
4348
+ /**
4349
+ * Defines the button which will open the start overflow menu if available. If nothing is provided to this
4350
+ * slot, the default button will be used.
4351
+ */
4352
+ startOverflowButton?: sap.ui.webc.main.IButton;
4353
+
4071
4354
  /**
4072
4355
  * Fired when a tab is selected.
4073
4356
  */
@@ -4104,7 +4387,7 @@ declare namespace sap {
4104
4387
  *
4105
4388
  *
4106
4389
  *
4107
- * **Limitations:** `growing="Scroll"` is not supported for Internet Explorer, and the component will fallback
4390
+ * **Restrictions:** `growing="Scroll"` is not supported for Internet Explorer, and the component will fallback
4108
4391
  * to `growing="Button"`.
4109
4392
  */
4110
4393
  growing?:
@@ -4168,7 +4451,7 @@ declare namespace sap {
4168
4451
  * Determines whether the column headers remain fixed at the top of the page during vertical scrolling as
4169
4452
  * long as the Web Component is in the viewport.
4170
4453
  *
4171
- * **Limitations:**
4454
+ * **Restrictions:**
4172
4455
  * - Browsers that do not support this feature:
4173
4456
  * Internet Explorer
4174
4457
  * - Microsoft Edge lower than version 41 (EdgeHTML 16)
@@ -4330,13 +4613,6 @@ declare namespace sap {
4330
4613
  | string
4331
4614
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
4332
4615
 
4333
- /**
4334
- * Receives id(or many ids) of the elements that label the textarea.
4335
- */
4336
- accessibleNameRef?:
4337
- | string
4338
- | sap.ui.base.ManagedObject.PropertyBindingInfo;
4339
-
4340
4616
  /**
4341
4617
  * Indicates whether the user can interact with the component or not.
4342
4618
  *
@@ -4457,6 +4733,11 @@ declare namespace sap {
4457
4733
  | sap.ui.core.CSSSize
4458
4734
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
4459
4735
 
4736
+ /**
4737
+ * Receives id(or many ids) of the controls that label this control.
4738
+ */
4739
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
4740
+
4460
4741
  /**
4461
4742
  * Fired when the text has changed and the focus leaves the component.
4462
4743
  */
@@ -4632,6 +4913,31 @@ declare namespace sap {
4632
4913
 
4633
4914
  interface $ToggleButtonSettings
4634
4915
  extends sap.ui.webc.common.$WebComponentSettings {
4916
+ /**
4917
+ * An object of strings that defines several additional accessibility attribute values for customization
4918
+ * depending on the use case.
4919
+ *
4920
+ * It supports the following fields:
4921
+ *
4922
+ *
4923
+ * - `expanded`: Indicates whether the button, or another grouping element it controls, is currently expanded
4924
+ * or collapsed. Accepts the following string values:
4925
+ * `true`
4926
+ * - `false`
4927
+ * - `hasPopup`: Indicates the availability and type of interactive popup element, such as menu or dialog,
4928
+ * that can be triggered by the button. Accepts the following string values:
4929
+ * `Dialog`
4930
+ * - `Grid`
4931
+ * - `ListBox`
4932
+ * - `Menu`
4933
+ * - `Tree`
4934
+ * - `controls`: Identifies the element (or elements) whose contents or presence are controlled by the
4935
+ * button element. Accepts a string value.
4936
+ */
4937
+ accessibilityAttributes?:
4938
+ | object
4939
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
4940
+
4635
4941
  /**
4636
4942
  * Sets the accessible aria name of the component.
4637
4943
  */
@@ -4698,6 +5004,11 @@ declare namespace sap {
4698
5004
  | sap.ui.core.CSSSize
4699
5005
  | sap.ui.base.ManagedObject.PropertyBindingInfo;
4700
5006
 
5007
+ /**
5008
+ * Receives id(or many ids) of the controls that label this control.
5009
+ */
5010
+ ariaLabelledBy?: Array<sap.ui.core.Control | string>;
5011
+
4701
5012
  /**
4702
5013
  * Fired when the component is activated either with a mouse/tap or by using the Enter or Space key.
4703
5014
  *
@@ -4885,6 +5196,22 @@ declare namespace sap {
4885
5196
  */
4886
5197
  icon?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
4887
5198
 
5199
+ /**
5200
+ * Defines whether the selection of a tree node is displayed as partially selected.
5201
+ *
5202
+ * **Note:** The indeterminate state can be set only programatically and can’t be achieved by user interaction,
5203
+ * meaning that the resulting visual state depends on the values of the `indeterminate` and `selected` properties:
5204
+ *
5205
+ * If a tree node has both `selected` and `indeterminate` set to `true`, it is displayed as partially
5206
+ * selected. If a tree node has `selected` set to `true` and `indeterminate` set to `false`, it is
5207
+ * displayed as selected. If a tree node has `selected` set to `false`, it is displayed as not selected
5208
+ * regardless of the value of the `indeterminate` property.
5209
+ * **Note:** This property takes effect only when the `sap.ui.webc.main.Tree` is in `MultiSelect` mode.
5210
+ */
5211
+ indeterminate?:
5212
+ | boolean
5213
+ | sap.ui.base.ManagedObject.PropertyBindingInfo;
5214
+
4888
5215
  /**
4889
5216
  * Defines whether the tree node is selected by the user. Only has effect if the `sap.ui.webc.main.Tree`
4890
5217
  * is in one of the following modes: in `SingleSelect`, `SingleSelectBegin`, `SingleSelectEnd` and `MultiSelect`.
@@ -5866,7 +6193,8 @@ declare namespace sap {
5866
6193
  * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
5867
6194
  * otherwise it will be bound to this `sap.ui.webc.main.Breadcrumbs` itself.
5868
6195
  *
5869
- * Fires when a `BreadcrumbsItem` is clicked.
6196
+ * Fires when a `BreadcrumbsItem` is clicked. **Note:** You can prevent browser location change by calling
6197
+ * `event.preventDefault()`.
5870
6198
  */
5871
6199
  attachItemClick(
5872
6200
  /**
@@ -5889,7 +6217,8 @@ declare namespace sap {
5889
6217
  * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
5890
6218
  * otherwise it will be bound to this `sap.ui.webc.main.Breadcrumbs` itself.
5891
6219
  *
5892
- * Fires when a `BreadcrumbsItem` is clicked.
6220
+ * Fires when a `BreadcrumbsItem` is clicked. **Note:** You can prevent browser location change by calling
6221
+ * `event.preventDefault()`.
5893
6222
  */
5894
6223
  attachItemClick(
5895
6224
  /**
@@ -5922,6 +6251,9 @@ declare namespace sap {
5922
6251
  ): this;
5923
6252
  /**
5924
6253
  * Fires event {@link #event:itemClick itemClick} to attached listeners.
6254
+ *
6255
+ * Listeners may prevent the default action of this event by calling the `preventDefault` method on the
6256
+ * event object. The return value of this method indicates whether the default action should be executed.
5925
6257
  */
5926
6258
  fireItemClick(
5927
6259
  /**
@@ -5933,7 +6265,7 @@ declare namespace sap {
5933
6265
  */
5934
6266
  item?: HTMLElement;
5935
6267
  }
5936
- ): this;
6268
+ ): boolean;
5937
6269
  /**
5938
6270
  * Gets current value of property {@link #getDesign design}.
5939
6271
  *
@@ -6625,6 +6957,15 @@ declare namespace sap {
6625
6957
  * Returns a metadata object for class sap.ui.webc.main.Button.
6626
6958
  */
6627
6959
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
6960
+ /**
6961
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
6962
+ */
6963
+ addAriaLabelledBy(
6964
+ /**
6965
+ * The ariaLabelledBy to add; if empty, nothing is inserted
6966
+ */
6967
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
6968
+ ): this;
6628
6969
  /**
6629
6970
  * Attaches event handler `fnFunction` to the {@link #event:click click} event of this `sap.ui.webc.main.Button`.
6630
6971
  *
@@ -6694,12 +7035,43 @@ declare namespace sap {
6694
7035
  */
6695
7036
  mParameters?: object
6696
7037
  ): this;
7038
+ /**
7039
+ * Gets current value of property {@link #getAccessibilityAttributes accessibilityAttributes}.
7040
+ *
7041
+ * An object of strings that defines several additional accessibility attribute values for customization
7042
+ * depending on the use case.
7043
+ *
7044
+ * It supports the following fields:
7045
+ *
7046
+ *
7047
+ * - `expanded`: Indicates whether the button, or another grouping element it controls, is currently expanded
7048
+ * or collapsed. Accepts the following string values:
7049
+ * `true`
7050
+ * - `false`
7051
+ * - `hasPopup`: Indicates the availability and type of interactive popup element, such as menu or dialog,
7052
+ * that can be triggered by the button. Accepts the following string values:
7053
+ * `Dialog`
7054
+ * - `Grid`
7055
+ * - `ListBox`
7056
+ * - `Menu`
7057
+ * - `Tree`
7058
+ * - `controls`: Identifies the element (or elements) whose contents or presence are controlled by the
7059
+ * button element. Accepts a string value.
7060
+ *
7061
+ * Default value is `{}`.
7062
+ */
7063
+ getAccessibilityAttributes(): object;
6697
7064
  /**
6698
7065
  * Gets current value of property {@link #getAccessibleName accessibleName}.
6699
7066
  *
6700
7067
  * Sets the accessible aria name of the component.
6701
7068
  */
6702
7069
  getAccessibleName(): string;
7070
+ /**
7071
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
7072
+ * ariaLabelledBy}.
7073
+ */
7074
+ getAriaLabelledBy(): sap.ui.core.ID[];
6703
7075
  /**
6704
7076
  * Gets current value of property {@link #getDesign design}.
6705
7077
  *
@@ -6779,6 +7151,52 @@ declare namespace sap {
6779
7151
  * Defines the width of the control
6780
7152
  */
6781
7153
  getWidth(): sap.ui.core.CSSSize;
7154
+ /**
7155
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
7156
+ */
7157
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
7158
+ /**
7159
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
7160
+ */
7161
+ removeAriaLabelledBy(
7162
+ /**
7163
+ * The ariaLabelledBy to be removed or its index or ID
7164
+ */
7165
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
7166
+ ): sap.ui.core.ID;
7167
+ /**
7168
+ * Sets a new value for property {@link #getAccessibilityAttributes accessibilityAttributes}.
7169
+ *
7170
+ * An object of strings that defines several additional accessibility attribute values for customization
7171
+ * depending on the use case.
7172
+ *
7173
+ * It supports the following fields:
7174
+ *
7175
+ *
7176
+ * - `expanded`: Indicates whether the button, or another grouping element it controls, is currently expanded
7177
+ * or collapsed. Accepts the following string values:
7178
+ * `true`
7179
+ * - `false`
7180
+ * - `hasPopup`: Indicates the availability and type of interactive popup element, such as menu or dialog,
7181
+ * that can be triggered by the button. Accepts the following string values:
7182
+ * `Dialog`
7183
+ * - `Grid`
7184
+ * - `ListBox`
7185
+ * - `Menu`
7186
+ * - `Tree`
7187
+ * - `controls`: Identifies the element (or elements) whose contents or presence are controlled by the
7188
+ * button element. Accepts a string value.
7189
+ *
7190
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
7191
+ *
7192
+ * Default value is `{}`.
7193
+ */
7194
+ setAccessibilityAttributes(
7195
+ /**
7196
+ * New value for property `accessibilityAttributes`
7197
+ */
7198
+ oAccessibilityAttributes?: object
7199
+ ): this;
6782
7200
  /**
6783
7201
  * Sets a new value for property {@link #getAccessibleName accessibleName}.
6784
7202
  *
@@ -7557,6 +7975,15 @@ declare namespace sap {
7557
7975
  * Returns a metadata object for class sap.ui.webc.main.Card.
7558
7976
  */
7559
7977
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
7978
+ /**
7979
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
7980
+ */
7981
+ addAriaLabelledBy(
7982
+ /**
7983
+ * The ariaLabelledBy to add; if empty, nothing is inserted
7984
+ */
7985
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
7986
+ ): this;
7560
7987
  /**
7561
7988
  * Adds some content to the aggregation {@link #getContent content}.
7562
7989
  */
@@ -7587,19 +8014,16 @@ declare namespace sap {
7587
8014
  * Gets current value of property {@link #getAccessibleName accessibleName}.
7588
8015
  *
7589
8016
  * Defines the accessible name of the component, which is used as the name of the card region and should
7590
- * be unique per card. **Note:** `accessibleName` should be always set, unless `accessibleNameRef` is set.
8017
+ * be unique per card. **Note:** `accessibleName` should be always set, unless `ariaLabelledBy` is set.
7591
8018
  *
7592
8019
  * Default value is `empty string`.
7593
8020
  */
7594
8021
  getAccessibleName(): string;
7595
8022
  /**
7596
- * Gets current value of property {@link #getAccessibleNameRef accessibleNameRef}.
7597
- *
7598
- * Defines the IDs of the elements that label the component.
7599
- *
7600
- * Default value is `empty string`.
8023
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
8024
+ * ariaLabelledBy}.
7601
8025
  */
7602
- getAccessibleNameRef(): string;
8026
+ getAriaLabelledBy(): sap.ui.core.ID[];
7603
8027
  /**
7604
8028
  * Gets content of aggregation {@link #getContent content}.
7605
8029
  *
@@ -7676,6 +8100,10 @@ declare namespace sap {
7676
8100
  */
7677
8101
  iIndex: int
7678
8102
  ): this;
8103
+ /**
8104
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
8105
+ */
8106
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
7679
8107
  /**
7680
8108
  * Removes all the controls from the aggregation {@link #getContent content}.
7681
8109
  *
@@ -7688,6 +8116,15 @@ declare namespace sap {
7688
8116
  * Additionally, it unregisters them from the hosting UIArea.
7689
8117
  */
7690
8118
  removeAllHeader(): sap.ui.core.Control[];
8119
+ /**
8120
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
8121
+ */
8122
+ removeAriaLabelledBy(
8123
+ /**
8124
+ * The ariaLabelledBy to be removed or its index or ID
8125
+ */
8126
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
8127
+ ): sap.ui.core.ID;
7691
8128
  /**
7692
8129
  * Removes a content from the aggregation {@link #getContent content}.
7693
8130
  */
@@ -7710,7 +8147,7 @@ declare namespace sap {
7710
8147
  * Sets a new value for property {@link #getAccessibleName accessibleName}.
7711
8148
  *
7712
8149
  * Defines the accessible name of the component, which is used as the name of the card region and should
7713
- * be unique per card. **Note:** `accessibleName` should be always set, unless `accessibleNameRef` is set.
8150
+ * be unique per card. **Note:** `accessibleName` should be always set, unless `ariaLabelledBy` is set.
7714
8151
  *
7715
8152
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
7716
8153
  *
@@ -7722,21 +8159,6 @@ declare namespace sap {
7722
8159
  */
7723
8160
  sAccessibleName?: string
7724
8161
  ): this;
7725
- /**
7726
- * Sets a new value for property {@link #getAccessibleNameRef accessibleNameRef}.
7727
- *
7728
- * Defines the IDs of the elements that label the component.
7729
- *
7730
- * When called with a value of `null` or `undefined`, the default value of the property will be restored.
7731
- *
7732
- * Default value is `empty string`.
7733
- */
7734
- setAccessibleNameRef(
7735
- /**
7736
- * New value for property `accessibleNameRef`
7737
- */
7738
- sAccessibleNameRef?: string
7739
- ): this;
7740
8162
  /**
7741
8163
  * Sets a new value for property {@link #getHeight height}.
7742
8164
  *
@@ -8157,8 +8579,10 @@ declare namespace sap {
8157
8579
  * - The items you want to display need to be visible at the same time.
8158
8580
  * - The items you want to display are uniform and very similar.
8159
8581
  *
8160
- * Keyboard Handling: When the `sap.ui.webc.main.Carousel` is focused the user can navigate between the
8161
- * items with the following keyboard shortcuts:
8582
+ * Keyboard Handling:
8583
+ *
8584
+ * Basic Navigation: When the `sap.ui.webc.main.Carousel` is focused the user can navigate between the items
8585
+ * with the following keyboard shortcuts:
8162
8586
  *
8163
8587
  *
8164
8588
  *
@@ -8580,7 +9004,10 @@ declare namespace sap {
8580
9004
  *
8581
9005
  * - [SPACE, ENTER] - Toggles between different states: checked, not checked.
8582
9006
  */
8583
- class CheckBox extends sap.ui.webc.common.WebComponent {
9007
+ class CheckBox
9008
+ extends sap.ui.webc.common.WebComponent
9009
+ implements sap.ui.core.IFormContent {
9010
+ __implements__sap_ui_core_IFormContent: boolean;
8584
9011
  /**
8585
9012
  * Constructor for a new `CheckBox`.
8586
9013
  *
@@ -8637,6 +9064,15 @@ declare namespace sap {
8637
9064
  * Returns a metadata object for class sap.ui.webc.main.CheckBox.
8638
9065
  */
8639
9066
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
9067
+ /**
9068
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
9069
+ */
9070
+ addAriaLabelledBy(
9071
+ /**
9072
+ * The ariaLabelledBy to add; if empty, nothing is inserted
9073
+ */
9074
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
9075
+ ): this;
8640
9076
  /**
8641
9077
  * Attaches event handler `fnFunction` to the {@link #event:change change} event of this `sap.ui.webc.main.CheckBox`.
8642
9078
  *
@@ -8702,6 +9138,19 @@ declare namespace sap {
8702
9138
  */
8703
9139
  mParameters?: object
8704
9140
  ): this;
9141
+ /**
9142
+ * Gets current value of property {@link #getAccessibleName accessibleName}.
9143
+ *
9144
+ * Sets the accessible aria name of the component.
9145
+ *
9146
+ * Default value is `empty string`.
9147
+ */
9148
+ getAccessibleName(): string;
9149
+ /**
9150
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
9151
+ * ariaLabelledBy}.
9152
+ */
9153
+ getAriaLabelledBy(): sap.ui.core.ID[];
8705
9154
  /**
8706
9155
  * Gets current value of property {@link #getChecked checked}.
8707
9156
  *
@@ -8788,6 +9237,12 @@ declare namespace sap {
8788
9237
  * Default value is `None`.
8789
9238
  */
8790
9239
  getValueState(): sap.ui.core.ValueState;
9240
+ /**
9241
+ * Gets current value of property {@link #getWidth width}.
9242
+ *
9243
+ * Defines the width of the control
9244
+ */
9245
+ getWidth(): sap.ui.core.CSSSize;
8791
9246
  /**
8792
9247
  * Gets current value of property {@link #getWrappingType wrappingType}.
8793
9248
  *
@@ -8800,6 +9255,34 @@ declare namespace sap {
8800
9255
  * Default value is `None`.
8801
9256
  */
8802
9257
  getWrappingType(): sap.ui.webc.main.WrappingType;
9258
+ /**
9259
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
9260
+ */
9261
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
9262
+ /**
9263
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
9264
+ */
9265
+ removeAriaLabelledBy(
9266
+ /**
9267
+ * The ariaLabelledBy to be removed or its index or ID
9268
+ */
9269
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
9270
+ ): sap.ui.core.ID;
9271
+ /**
9272
+ * Sets a new value for property {@link #getAccessibleName accessibleName}.
9273
+ *
9274
+ * Sets the accessible aria name of the component.
9275
+ *
9276
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
9277
+ *
9278
+ * Default value is `empty string`.
9279
+ */
9280
+ setAccessibleName(
9281
+ /**
9282
+ * New value for property `accessibleName`
9283
+ */
9284
+ sAccessibleName?: string
9285
+ ): this;
8803
9286
  /**
8804
9287
  * Sets a new value for property {@link #getChecked checked}.
8805
9288
  *
@@ -8935,6 +9418,19 @@ declare namespace sap {
8935
9418
  */
8936
9419
  sValueState?: sap.ui.core.ValueState
8937
9420
  ): this;
9421
+ /**
9422
+ * Sets a new value for property {@link #getWidth width}.
9423
+ *
9424
+ * Defines the width of the control
9425
+ *
9426
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
9427
+ */
9428
+ setWidth(
9429
+ /**
9430
+ * New value for property `width`
9431
+ */
9432
+ sWidth?: sap.ui.core.CSSSize
9433
+ ): this;
8938
9434
  /**
8939
9435
  * Sets a new value for property {@link #getWrappingType wrappingType}.
8940
9436
  *
@@ -9470,6 +9966,16 @@ declare namespace sap {
9470
9966
  */
9471
9967
  iIndex: int
9472
9968
  ): this;
9969
+ /**
9970
+ * Shows the ColorPalettePopover. **Note:** The method is deprecated and will be removed in future, use
9971
+ * `showAt` instead.
9972
+ */
9973
+ openPopover(
9974
+ /**
9975
+ * the element that the popover is shown at
9976
+ */
9977
+ opener: HTMLElement
9978
+ ): void;
9473
9979
  /**
9474
9980
  * Removes all the controls from the aggregation {@link #getContent content}.
9475
9981
  *
@@ -9545,6 +10051,15 @@ declare namespace sap {
9545
10051
  */
9546
10052
  bShowRecentColors?: boolean
9547
10053
  ): this;
10054
+ /**
10055
+ * Shows the ColorPalettePopover.
10056
+ */
10057
+ showAt(
10058
+ /**
10059
+ * the element that the popover is shown at
10060
+ */
10061
+ opener: HTMLElement
10062
+ ): void;
9548
10063
  }
9549
10064
  /**
9550
10065
  * @SINCE 1.92.0
@@ -9716,16 +10231,30 @@ declare namespace sap {
9716
10231
  * The `sap.ui.webc.main.ComboBox` component represents a drop-down menu with a list of the available options
9717
10232
  * and a text input field to narrow down the options.
9718
10233
  *
9719
- * It is commonly used to enable users to select an option from a predefined list. Structure: The `sap.ui.webc.main.ComboBox`
9720
- * consists of the following elements:
10234
+ * It is commonly used to enable users to select an option from a predefined list.
10235
+ *
10236
+ * Structure: The `sap.ui.webc.main.ComboBox` consists of the following elements:
9721
10237
  * - Input field - displays the selected option or a custom user entry. Users can type to narrow down
9722
10238
  * the list or enter their own value. Drop-down arrow - expands\collapses the option list.
9723
- * - Option list - the list of available options. Keyboard Handling:
10239
+ * - Option list - the list of available options.
10240
+ *
10241
+ * Keyboard Handling:
9724
10242
  *
9725
10243
  * The `sap.ui.webc.main.ComboBox` provides advanced keyboard handling.
9726
10244
  *
9727
- * Picker: If the `sap.ui.webc.main.ComboBox` is focused, you can open or close the drop-down by pressing
9728
- * `F4`, `ALT+UP` or `ALT+DOWN` keys.
10245
+ *
10246
+ *
10247
+ * - [F4], [ALT]+[UP], or [ALT]+[DOWN] - Toggles the picker.
10248
+ * - [ESC] - Closes the picker, if open. If closed, cancels changes and reverts the typed in value.
10249
+ * - [ENTER] or [RETURN] - If picker is open, takes over the currently selected item and closes it.
10250
+ * - [DOWN] - Selects the next matching item in the picker.
10251
+ * - [UP] - Selects the previous matching item in the picker.
10252
+ * - [PAGEDOWN] - Moves selection down by page size (10 items by default).
10253
+ * - [PAGEUP] - Moves selection up by page size (10 items by default).
10254
+ * - [HOME] - If focus is in the ComboBox, moves cursor at the beginning of text. If focus is in the picker,
10255
+ * selects the first item.
10256
+ * - [END] - If focus is in the ComboBox, moves cursor at the end of text. If focus is in the picker,
10257
+ * selects the last item.
9729
10258
  */
9730
10259
  class ComboBox extends sap.ui.webc.common.WebComponent {
9731
10260
  /**
@@ -9784,6 +10313,15 @@ declare namespace sap {
9784
10313
  * Returns a metadata object for class sap.ui.webc.main.ComboBox.
9785
10314
  */
9786
10315
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
10316
+ /**
10317
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
10318
+ */
10319
+ addAriaLabelledBy(
10320
+ /**
10321
+ * The ariaLabelledBy to add; if empty, nothing is inserted
10322
+ */
10323
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
10324
+ ): this;
9787
10325
  /**
9788
10326
  * Adds some item to the aggregation {@link #getItems items}.
9789
10327
  */
@@ -10015,13 +10553,10 @@ declare namespace sap {
10015
10553
  */
10016
10554
  getAccessibleName(): string;
10017
10555
  /**
10018
- * Gets current value of property {@link #getAccessibleNameRef accessibleNameRef}.
10019
- *
10020
- * Receives id(or many ids) of the elements that label the combo box
10021
- *
10022
- * Default value is `empty string`.
10556
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
10557
+ * ariaLabelledBy}.
10023
10558
  */
10024
- getAccessibleNameRef(): string;
10559
+ getAriaLabelledBy(): sap.ui.core.ID[];
10025
10560
  /**
10026
10561
  * Gets current value of property {@link #getDisabled disabled}.
10027
10562
  *
@@ -10153,12 +10688,25 @@ declare namespace sap {
10153
10688
  */
10154
10689
  iIndex: int
10155
10690
  ): this;
10691
+ /**
10692
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
10693
+ */
10694
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
10156
10695
  /**
10157
10696
  * Removes all the controls from the aggregation {@link #getItems items}.
10158
10697
  *
10159
10698
  * Additionally, it unregisters them from the hosting UIArea.
10160
10699
  */
10161
10700
  removeAllItems(): sap.ui.webc.main.IComboBoxItem[];
10701
+ /**
10702
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
10703
+ */
10704
+ removeAriaLabelledBy(
10705
+ /**
10706
+ * The ariaLabelledBy to be removed or its index or ID
10707
+ */
10708
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
10709
+ ): sap.ui.core.ID;
10162
10710
  /**
10163
10711
  * Removes a item from the aggregation {@link #getItems items}.
10164
10712
  */
@@ -10181,21 +10729,6 @@ declare namespace sap {
10181
10729
  */
10182
10730
  sAccessibleName: string
10183
10731
  ): this;
10184
- /**
10185
- * Sets a new value for property {@link #getAccessibleNameRef accessibleNameRef}.
10186
- *
10187
- * Receives id(or many ids) of the elements that label the combo box
10188
- *
10189
- * When called with a value of `null` or `undefined`, the default value of the property will be restored.
10190
- *
10191
- * Default value is `empty string`.
10192
- */
10193
- setAccessibleNameRef(
10194
- /**
10195
- * New value for property `accessibleNameRef`
10196
- */
10197
- sAccessibleNameRef?: string
10198
- ): this;
10199
10732
  /**
10200
10733
  * Sets a new value for property {@link #getDisabled disabled}.
10201
10734
  *
@@ -10884,9 +11417,9 @@ declare namespace sap {
10884
11417
  * for changing month and year.
10885
11418
  *
10886
11419
  *
10887
- * If the `sap.ui.webc.main.DatePicker` is focused and the picker dialog is not opened the user can increment
10888
- * or decrement the corresponding field of the JS date object referenced by `dateValue` propery by using
10889
- * the following shortcuts:
11420
+ * If the `sap.ui.webc.main.DatePicker` input field is focused and its corresponding picker dialog is not
11421
+ * opened, then users can increment or decrement the date referenced by `dateValue` property by using the
11422
+ * following shortcuts:
10890
11423
  *
10891
11424
  *
10892
11425
  *
@@ -10970,6 +11503,15 @@ declare namespace sap {
10970
11503
  * Returns a metadata object for class sap.ui.webc.main.DatePicker.
10971
11504
  */
10972
11505
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
11506
+ /**
11507
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
11508
+ */
11509
+ addAriaLabelledBy(
11510
+ /**
11511
+ * The ariaLabelledBy to add; if empty, nothing is inserted
11512
+ */
11513
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
11514
+ ): this;
10973
11515
  /**
10974
11516
  * Attaches event handler `fnFunction` to the {@link #event:change change} event of this `sap.ui.webc.main.DatePicker`.
10975
11517
  *
@@ -11145,13 +11687,10 @@ declare namespace sap {
11145
11687
  */
11146
11688
  getAccessibleName(): string;
11147
11689
  /**
11148
- * Gets current value of property {@link #getAccessibleNameRef accessibleNameRef}.
11149
- *
11150
- * Receives id(or many ids) of the elements that label the component.
11151
- *
11152
- * Default value is `empty string`.
11690
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
11691
+ * ariaLabelledBy}.
11153
11692
  */
11154
- getAccessibleNameRef(): string;
11693
+ getAriaLabelledBy(): sap.ui.core.ID[];
11155
11694
  /**
11156
11695
  * Returns the currently selected date represented as a Local JavaScript Date instance.
11157
11696
  */
@@ -11325,6 +11864,19 @@ declare namespace sap {
11325
11864
  * Opens the picker.
11326
11865
  */
11327
11866
  openPicker(): void;
11867
+ /**
11868
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
11869
+ */
11870
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
11871
+ /**
11872
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
11873
+ */
11874
+ removeAriaLabelledBy(
11875
+ /**
11876
+ * The ariaLabelledBy to be removed or its index or ID
11877
+ */
11878
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
11879
+ ): sap.ui.core.ID;
11328
11880
  /**
11329
11881
  * Sets a new value for property {@link #getAccessibleName accessibleName}.
11330
11882
  *
@@ -11338,21 +11890,6 @@ declare namespace sap {
11338
11890
  */
11339
11891
  sAccessibleName: string
11340
11892
  ): this;
11341
- /**
11342
- * Sets a new value for property {@link #getAccessibleNameRef accessibleNameRef}.
11343
- *
11344
- * Receives id(or many ids) of the elements that label the component.
11345
- *
11346
- * When called with a value of `null` or `undefined`, the default value of the property will be restored.
11347
- *
11348
- * Default value is `empty string`.
11349
- */
11350
- setAccessibleNameRef(
11351
- /**
11352
- * New value for property `accessibleNameRef`
11353
- */
11354
- sAccessibleNameRef?: string
11355
- ): this;
11356
11893
  /**
11357
11894
  * Sets a new value for property {@link #getDisabled disabled}.
11358
11895
  *
@@ -11682,6 +12219,15 @@ declare namespace sap {
11682
12219
  * Returns a metadata object for class sap.ui.webc.main.DateRangePicker.
11683
12220
  */
11684
12221
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
12222
+ /**
12223
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
12224
+ */
12225
+ addAriaLabelledBy(
12226
+ /**
12227
+ * The ariaLabelledBy to add; if empty, nothing is inserted
12228
+ */
12229
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
12230
+ ): this;
11685
12231
  /**
11686
12232
  * Attaches event handler `fnFunction` to the {@link #event:change change} event of this `sap.ui.webc.main.DateRangePicker`.
11687
12233
  *
@@ -11857,17 +12403,20 @@ declare namespace sap {
11857
12403
  */
11858
12404
  getAccessibleName(): string;
11859
12405
  /**
11860
- * Gets current value of property {@link #getAccessibleNameRef accessibleNameRef}.
11861
- *
11862
- * Receives id(or many ids) of the elements that label the component.
11863
- *
11864
- * Default value is `empty string`.
12406
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
12407
+ * ariaLabelledBy}.
11865
12408
  */
11866
- getAccessibleNameRef(): string;
12409
+ getAriaLabelledBy(): sap.ui.core.ID[];
11867
12410
  /**
11868
- * Returns the currently selected date represented as a Local JavaScript Date instance.
12411
+ * Returns the **Note:** The getter method is inherited and not supported. If called it will return an empty
12412
+ * value.
11869
12413
  */
11870
12414
  getDateValue(): void;
12415
+ /**
12416
+ * Returns the **Note:** The getter method is inherited and not supported. If called it will return an empty
12417
+ * value.
12418
+ */
12419
+ getDateValueUTC(): void;
11871
12420
  /**
11872
12421
  * Gets current value of property {@link #getDelimiter delimiter}.
11873
12422
  *
@@ -12052,6 +12601,19 @@ declare namespace sap {
12052
12601
  * Opens the picker.
12053
12602
  */
12054
12603
  openPicker(): void;
12604
+ /**
12605
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
12606
+ */
12607
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
12608
+ /**
12609
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
12610
+ */
12611
+ removeAriaLabelledBy(
12612
+ /**
12613
+ * The ariaLabelledBy to be removed or its index or ID
12614
+ */
12615
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
12616
+ ): sap.ui.core.ID;
12055
12617
  /**
12056
12618
  * Sets a new value for property {@link #getAccessibleName accessibleName}.
12057
12619
  *
@@ -12065,21 +12627,6 @@ declare namespace sap {
12065
12627
  */
12066
12628
  sAccessibleName: string
12067
12629
  ): this;
12068
- /**
12069
- * Sets a new value for property {@link #getAccessibleNameRef accessibleNameRef}.
12070
- *
12071
- * Receives id(or many ids) of the elements that label the component.
12072
- *
12073
- * When called with a value of `null` or `undefined`, the default value of the property will be restored.
12074
- *
12075
- * Default value is `empty string`.
12076
- */
12077
- setAccessibleNameRef(
12078
- /**
12079
- * New value for property `accessibleNameRef`
12080
- */
12081
- sAccessibleNameRef?: string
12082
- ): this;
12083
12630
  /**
12084
12631
  * Sets a new value for property {@link #getDelimiter delimiter}.
12085
12632
  *
@@ -12457,6 +13004,15 @@ declare namespace sap {
12457
13004
  * Returns a metadata object for class sap.ui.webc.main.DateTimePicker.
12458
13005
  */
12459
13006
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
13007
+ /**
13008
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
13009
+ */
13010
+ addAriaLabelledBy(
13011
+ /**
13012
+ * The ariaLabelledBy to add; if empty, nothing is inserted
13013
+ */
13014
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
13015
+ ): this;
12460
13016
  /**
12461
13017
  * Attaches event handler `fnFunction` to the {@link #event:change change} event of this `sap.ui.webc.main.DateTimePicker`.
12462
13018
  *
@@ -12632,13 +13188,10 @@ declare namespace sap {
12632
13188
  */
12633
13189
  getAccessibleName(): string;
12634
13190
  /**
12635
- * Gets current value of property {@link #getAccessibleNameRef accessibleNameRef}.
12636
- *
12637
- * Receives id(or many ids) of the elements that label the component.
12638
- *
12639
- * Default value is `empty string`.
13191
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
13192
+ * ariaLabelledBy}.
12640
13193
  */
12641
- getAccessibleNameRef(): string;
13194
+ getAriaLabelledBy(): sap.ui.core.ID[];
12642
13195
  /**
12643
13196
  * Returns the currently selected date represented as a Local JavaScript Date instance.
12644
13197
  */
@@ -12812,6 +13365,19 @@ declare namespace sap {
12812
13365
  * Opens the picker.
12813
13366
  */
12814
13367
  openPicker(): void;
13368
+ /**
13369
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
13370
+ */
13371
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
13372
+ /**
13373
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
13374
+ */
13375
+ removeAriaLabelledBy(
13376
+ /**
13377
+ * The ariaLabelledBy to be removed or its index or ID
13378
+ */
13379
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
13380
+ ): sap.ui.core.ID;
12815
13381
  /**
12816
13382
  * Sets a new value for property {@link #getAccessibleName accessibleName}.
12817
13383
  *
@@ -12825,21 +13391,6 @@ declare namespace sap {
12825
13391
  */
12826
13392
  sAccessibleName: string
12827
13393
  ): this;
12828
- /**
12829
- * Sets a new value for property {@link #getAccessibleNameRef accessibleNameRef}.
12830
- *
12831
- * Receives id(or many ids) of the elements that label the component.
12832
- *
12833
- * When called with a value of `null` or `undefined`, the default value of the property will be restored.
12834
- *
12835
- * Default value is `empty string`.
12836
- */
12837
- setAccessibleNameRef(
12838
- /**
12839
- * New value for property `accessibleNameRef`
12840
- */
12841
- sAccessibleNameRef?: string
12842
- ): this;
12843
13394
  /**
12844
13395
  * Sets a new value for property {@link #getDisabled disabled}.
12845
13396
  *
@@ -13174,6 +13725,15 @@ declare namespace sap {
13174
13725
  * Returns a metadata object for class sap.ui.webc.main.Dialog.
13175
13726
  */
13176
13727
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
13728
+ /**
13729
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
13730
+ */
13731
+ addAriaLabelledBy(
13732
+ /**
13733
+ * The ariaLabelledBy to add; if empty, nothing is inserted
13734
+ */
13735
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
13736
+ ): this;
13177
13737
  /**
13178
13738
  * Adds some content to the aggregation {@link #getContent content}.
13179
13739
  */
@@ -13499,11 +14059,16 @@ declare namespace sap {
13499
14059
  /**
13500
14060
  * Gets current value of property {@link #getAccessibleName accessibleName}.
13501
14061
  *
13502
- * Sets the accessible aria name of the component.
14062
+ * Defines the accessible name of the component.
13503
14063
  *
13504
14064
  * Default value is `empty string`.
13505
14065
  */
13506
14066
  getAccessibleName(): string;
14067
+ /**
14068
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
14069
+ * ariaLabelledBy}.
14070
+ */
14071
+ getAriaLabelledBy(): sap.ui.core.ID[];
13507
14072
  /**
13508
14073
  * Gets content of aggregation {@link #getContent content}.
13509
14074
  *
@@ -13676,6 +14241,10 @@ declare namespace sap {
13676
14241
  * Tells if the component is opened
13677
14242
  */
13678
14243
  isOpen(): void;
14244
+ /**
14245
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
14246
+ */
14247
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
13679
14248
  /**
13680
14249
  * Removes all the controls from the aggregation {@link #getContent content}.
13681
14250
  *
@@ -13694,6 +14263,15 @@ declare namespace sap {
13694
14263
  * Additionally, it unregisters them from the hosting UIArea.
13695
14264
  */
13696
14265
  removeAllHeader(): sap.ui.core.Control[];
14266
+ /**
14267
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
14268
+ */
14269
+ removeAriaLabelledBy(
14270
+ /**
14271
+ * The ariaLabelledBy to be removed or its index or ID
14272
+ */
14273
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
14274
+ ): sap.ui.core.ID;
13697
14275
  /**
13698
14276
  * Removes a content from the aggregation {@link #getContent content}.
13699
14277
  */
@@ -13724,7 +14302,7 @@ declare namespace sap {
13724
14302
  /**
13725
14303
  * Sets a new value for property {@link #getAccessibleName accessibleName}.
13726
14304
  *
13727
- * Sets the accessible aria name of the component.
14305
+ * Defines the accessible name of the component.
13728
14306
  *
13729
14307
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
13730
14308
  *
@@ -14519,8 +15097,9 @@ declare namespace sap {
14519
15097
  */
14520
15098
  class Icon
14521
15099
  extends sap.ui.webc.common.WebComponent
14522
- implements sap.ui.webc.main.IIcon {
15100
+ implements sap.ui.webc.main.IIcon, sap.ui.core.IFormContent {
14523
15101
  __implements__sap_ui_webc_main_IIcon: boolean;
15102
+ __implements__sap_ui_core_IFormContent: boolean;
14524
15103
  /**
14525
15104
  * Constructor for a new `Icon`.
14526
15105
  *
@@ -14653,6 +15232,14 @@ declare namespace sap {
14653
15232
  * Default value is `empty string`.
14654
15233
  */
14655
15234
  getAccessibleName(): string;
15235
+ /**
15236
+ * Gets current value of property {@link #getAccessibleRole accessibleRole}.
15237
+ *
15238
+ * Defines the accessibility role of the component.
15239
+ *
15240
+ * Default value is `empty string`.
15241
+ */
15242
+ getAccessibleRole(): string;
14656
15243
  /**
14657
15244
  * Gets current value of property {@link #getBackgroundColor backgroundColor}.
14658
15245
  *
@@ -14735,6 +15322,21 @@ declare namespace sap {
14735
15322
  */
14736
15323
  sAccessibleName?: string
14737
15324
  ): this;
15325
+ /**
15326
+ * Sets a new value for property {@link #getAccessibleRole accessibleRole}.
15327
+ *
15328
+ * Defines the accessibility role of the component.
15329
+ *
15330
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
15331
+ *
15332
+ * Default value is `empty string`.
15333
+ */
15334
+ setAccessibleRole(
15335
+ /**
15336
+ * New value for property `accessibleRole`
15337
+ */
15338
+ sAccessibleRole?: string
15339
+ ): this;
14738
15340
  /**
14739
15341
  * Sets a new value for property {@link #getBackgroundColor backgroundColor}.
14740
15342
  *
@@ -14868,6 +15470,27 @@ declare namespace sap {
14868
15470
  * **Note:** If you are using the `sap.ui.webc.main.Input` as a single npm module, don't forget to import
14869
15471
  * the `InputSuggestions` module from "@ui5/webcomponents/dist/features/InputSuggestions.js" to enable the
14870
15472
  * suggestions functionality.
15473
+ *
15474
+ * Keyboard Handling: The `sap.ui.webc.main.Input` provides the following keyboard shortcuts:
15475
+ *
15476
+ *
15477
+ *
15478
+ * - [F4], [ALT]+[UP], or [ALT]+[DOWN] - Opens value help if available, same as clicking the value help
15479
+ * icon. (Does not open suggestion list.)
15480
+ * - [ESC] - Closes the suggestion list, if open. If closed or not enabled, cancels changes and reverts
15481
+ * to the value which the Input field had when it got the focus.
15482
+ * - [ENTER] or [RETURN] - If suggestion list is open takes over the current matching item and closes
15483
+ * it. If value state or group header is focused, does nothing.
15484
+ * - [DOWN] - Focuses the next matching item in the suggestion list.
15485
+ * - [UP] - Focuses the previous matching item in the suggestion list.
15486
+ * - [HOME] - If focus is in the text input, moves caret before the first character. If focus is in the
15487
+ * list, highlights the first item and updates the input accordingly.
15488
+ * - [END] - If focus is in the text input, moves caret after the last character. If focus is in the list,
15489
+ * highlights the last item and updates the input accordingly.
15490
+ * - [PAGEUP] - If focus is in the list, moves highlight up by page size (10 items by default). If focus
15491
+ * is in the input, does nothing.
15492
+ * - [PAGEDOWN] - If focus is in the list, moves highlight down by page size (10 items by default). If
15493
+ * focus is in the input, does nothing.
14871
15494
  */
14872
15495
  class Input
14873
15496
  extends sap.ui.webc.common.WebComponent
@@ -14929,6 +15552,15 @@ declare namespace sap {
14929
15552
  * Returns a metadata object for class sap.ui.webc.main.Input.
14930
15553
  */
14931
15554
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
15555
+ /**
15556
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
15557
+ */
15558
+ addAriaLabelledBy(
15559
+ /**
15560
+ * The ariaLabelledBy to add; if empty, nothing is inserted
15561
+ */
15562
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
15563
+ ): this;
14932
15564
  /**
14933
15565
  * Adds some icon to the aggregation {@link #getIcon icon}.
14934
15566
  */
@@ -15246,13 +15878,10 @@ declare namespace sap {
15246
15878
  */
15247
15879
  getAccessibleName(): string;
15248
15880
  /**
15249
- * Gets current value of property {@link #getAccessibleNameRef accessibleNameRef}.
15250
- *
15251
- * Receives id(or many ids) of the elements that label the input.
15252
- *
15253
- * Default value is `empty string`.
15881
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
15882
+ * ariaLabelledBy}.
15254
15883
  */
15255
- getAccessibleNameRef(): string;
15884
+ getAriaLabelledBy(): sap.ui.core.ID[];
15256
15885
  /**
15257
15886
  * Gets current value of property {@link #getDisabled disabled}.
15258
15887
  *
@@ -15318,6 +15947,14 @@ declare namespace sap {
15318
15947
  * Default value is `false`.
15319
15948
  */
15320
15949
  getRequired(): boolean;
15950
+ /**
15951
+ * Gets current value of property {@link #getShowClearIcon showClearIcon}.
15952
+ *
15953
+ * Defines whether the clear icon of the input will be shown.
15954
+ *
15955
+ * Default value is `false`.
15956
+ */
15957
+ getShowClearIcon(): boolean;
15321
15958
  /**
15322
15959
  * Gets current value of property {@link #getShowSuggestions showSuggestions}.
15323
15960
  *
@@ -15385,6 +16022,12 @@ declare namespace sap {
15385
16022
  * Default value is `empty string`.
15386
16023
  */
15387
16024
  getValueStateMessage(): string;
16025
+ /**
16026
+ * Gets current value of property {@link #getWidth width}.
16027
+ *
16028
+ * Defines the width of the control
16029
+ */
16030
+ getWidth(): sap.ui.core.CSSSize;
15388
16031
  /**
15389
16032
  * Checks for the provided `sap.ui.webc.main.IIcon` in the aggregation {@link #getIcon icon}. and returns
15390
16033
  * its index if found or -1 otherwise.
@@ -15435,6 +16078,10 @@ declare namespace sap {
15435
16078
  */
15436
16079
  iIndex: int
15437
16080
  ): this;
16081
+ /**
16082
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
16083
+ */
16084
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
15438
16085
  /**
15439
16086
  * Removes all the controls from the aggregation {@link #getIcon icon}.
15440
16087
  *
@@ -15447,6 +16094,15 @@ declare namespace sap {
15447
16094
  * Additionally, it unregisters them from the hosting UIArea.
15448
16095
  */
15449
16096
  removeAllSuggestionItems(): sap.ui.webc.main.IInputSuggestionItem[];
16097
+ /**
16098
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
16099
+ */
16100
+ removeAriaLabelledBy(
16101
+ /**
16102
+ * The ariaLabelledBy to be removed or its index or ID
16103
+ */
16104
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
16105
+ ): sap.ui.core.ID;
15450
16106
  /**
15451
16107
  * Removes a icon from the aggregation {@link #getIcon icon}.
15452
16108
  */
@@ -15481,21 +16137,6 @@ declare namespace sap {
15481
16137
  */
15482
16138
  sAccessibleName: string
15483
16139
  ): this;
15484
- /**
15485
- * Sets a new value for property {@link #getAccessibleNameRef accessibleNameRef}.
15486
- *
15487
- * Receives id(or many ids) of the elements that label the input.
15488
- *
15489
- * When called with a value of `null` or `undefined`, the default value of the property will be restored.
15490
- *
15491
- * Default value is `empty string`.
15492
- */
15493
- setAccessibleNameRef(
15494
- /**
15495
- * New value for property `accessibleNameRef`
15496
- */
15497
- sAccessibleNameRef?: string
15498
- ): this;
15499
16140
  /**
15500
16141
  * Sets a new value for property {@link #getDisabled disabled}.
15501
16142
  *
@@ -15593,6 +16234,21 @@ declare namespace sap {
15593
16234
  */
15594
16235
  bRequired?: boolean
15595
16236
  ): this;
16237
+ /**
16238
+ * Sets a new value for property {@link #getShowClearIcon showClearIcon}.
16239
+ *
16240
+ * Defines whether the clear icon of the input will be shown.
16241
+ *
16242
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
16243
+ *
16244
+ * Default value is `false`.
16245
+ */
16246
+ setShowClearIcon(
16247
+ /**
16248
+ * New value for property `showClearIcon`
16249
+ */
16250
+ bShowClearIcon?: boolean
16251
+ ): this;
15596
16252
  /**
15597
16253
  * Sets a new value for property {@link #getShowSuggestions showSuggestions}.
15598
16254
  *
@@ -15691,6 +16347,19 @@ declare namespace sap {
15691
16347
  */
15692
16348
  sValueStateMessage?: string
15693
16349
  ): this;
16350
+ /**
16351
+ * Sets a new value for property {@link #getWidth width}.
16352
+ *
16353
+ * Defines the width of the control
16354
+ *
16355
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
16356
+ */
16357
+ setWidth(
16358
+ /**
16359
+ * New value for property `width`
16360
+ */
16361
+ sWidth?: sap.ui.core.CSSSize
16362
+ ): this;
15694
16363
  }
15695
16364
  /**
15696
16365
  * @SINCE 1.92.0
@@ -15706,7 +16375,10 @@ declare namespace sap {
15706
16375
  * The appearance of the Label can be configured in a limited way by using the design property. For a broader
15707
16376
  * choice of designs, you can use custom styles.
15708
16377
  */
15709
- class Label extends sap.ui.webc.common.WebComponent {
16378
+ class Label
16379
+ extends sap.ui.webc.common.WebComponent
16380
+ implements sap.ui.core.Label {
16381
+ __implements__sap_ui_core_Label: boolean;
15710
16382
  /**
15711
16383
  * Constructor for a new `Label`.
15712
16384
  *
@@ -15764,15 +16436,9 @@ declare namespace sap {
15764
16436
  */
15765
16437
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
15766
16438
  /**
15767
- * Gets current value of property {@link #getFor for}.
15768
- *
15769
- * Defines the labeled input by providing its ID.
15770
- *
15771
- * **Note:** Can be used with both `sap.ui.webc.main.Input` and native input.
15772
- *
15773
- * Default value is `empty string`.
16439
+ * ID of the element which is the current target of the association {@link #getLabelFor labelFor}, or `null`.
15774
16440
  */
15775
- getFor(): string;
16441
+ getLabelFor(): sap.ui.core.ID;
15776
16442
  /**
15777
16443
  * Gets current value of property {@link #getRequired required}.
15778
16444
  *
@@ -15819,21 +16485,14 @@ declare namespace sap {
15819
16485
  */
15820
16486
  getWrappingType(): sap.ui.webc.main.WrappingType;
15821
16487
  /**
15822
- * Sets a new value for property {@link #getFor for}.
15823
- *
15824
- * Defines the labeled input by providing its ID.
15825
- *
15826
- * **Note:** Can be used with both `sap.ui.webc.main.Input` and native input.
15827
- *
15828
- * When called with a value of `null` or `undefined`, the default value of the property will be restored.
15829
- *
15830
- * Default value is `empty string`.
16488
+ * Sets the associated {@link #getLabelFor labelFor}.
15831
16489
  */
15832
- setFor(
16490
+ setLabelFor(
15833
16491
  /**
15834
- * New value for property `for`
16492
+ * ID of an element which becomes the new target of this labelFor association; alternatively, an element
16493
+ * instance may be given
15835
16494
  */
15836
- sFor?: string
16495
+ oLabelFor: sap.ui.core.ID | sap.ui.core.Control
15837
16496
  ): this;
15838
16497
  /**
15839
16498
  * Sets a new value for property {@link #getRequired required}.
@@ -15998,6 +16657,15 @@ declare namespace sap {
15998
16657
  * Returns a metadata object for class sap.ui.webc.main.Link.
15999
16658
  */
16000
16659
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
16660
+ /**
16661
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
16662
+ */
16663
+ addAriaLabelledBy(
16664
+ /**
16665
+ * The ariaLabelledBy to add; if empty, nothing is inserted
16666
+ */
16667
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
16668
+ ): this;
16001
16669
  /**
16002
16670
  * Attaches event handler `fnFunction` to the {@link #event:click click} event of this `sap.ui.webc.main.Link`.
16003
16671
  *
@@ -16064,13 +16732,34 @@ declare namespace sap {
16064
16732
  mParameters?: object
16065
16733
  ): this;
16066
16734
  /**
16067
- * Gets current value of property {@link #getAccessibleNameRef accessibleNameRef}.
16735
+ * Gets current value of property {@link #getAccessibilityAttributes accessibilityAttributes}.
16068
16736
  *
16069
- * Receives id(or many ids) of the elements that label the input
16737
+ * An object of strings that defines several additional accessibility attribute values for customization
16738
+ * depending on the use case.
16070
16739
  *
16071
- * Default value is `empty string`.
16740
+ * It supports the following fields:
16741
+ *
16742
+ *
16743
+ * - `expanded`: Indicates whether the anchor element, or another grouping element it controls, is currently
16744
+ * expanded or collapsed. Accepts the following string values:
16745
+ * `true`
16746
+ * - `false`
16747
+ * - `hasPopup`: Indicates the availability and type of interactive popup element, such as menu or dialog,
16748
+ * that can be triggered by the anchor element. Accepts the following string values:
16749
+ * `Dialog`
16750
+ * - `Grid`
16751
+ * - `ListBox`
16752
+ * - `Menu`
16753
+ * - `Tree`
16754
+ *
16755
+ * Default value is `{}`.
16072
16756
  */
16073
- getAccessibleNameRef(): string;
16757
+ getAccessibilityAttributes(): object;
16758
+ /**
16759
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
16760
+ * ariaLabelledBy}.
16761
+ */
16762
+ getAriaLabelledBy(): sap.ui.core.ID[];
16074
16763
  /**
16075
16764
  * Gets current value of property {@link #getDesign design}.
16076
16765
  *
@@ -16140,19 +16829,48 @@ declare namespace sap {
16140
16829
  */
16141
16830
  getWrappingType(): sap.ui.webc.main.WrappingType;
16142
16831
  /**
16143
- * Sets a new value for property {@link #getAccessibleNameRef accessibleNameRef}.
16832
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
16833
+ */
16834
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
16835
+ /**
16836
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
16837
+ */
16838
+ removeAriaLabelledBy(
16839
+ /**
16840
+ * The ariaLabelledBy to be removed or its index or ID
16841
+ */
16842
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
16843
+ ): sap.ui.core.ID;
16844
+ /**
16845
+ * Sets a new value for property {@link #getAccessibilityAttributes accessibilityAttributes}.
16144
16846
  *
16145
- * Receives id(or many ids) of the elements that label the input
16847
+ * An object of strings that defines several additional accessibility attribute values for customization
16848
+ * depending on the use case.
16849
+ *
16850
+ * It supports the following fields:
16851
+ *
16852
+ *
16853
+ * - `expanded`: Indicates whether the anchor element, or another grouping element it controls, is currently
16854
+ * expanded or collapsed. Accepts the following string values:
16855
+ * `true`
16856
+ * - `false`
16857
+ * - `hasPopup`: Indicates the availability and type of interactive popup element, such as menu or dialog,
16858
+ * that can be triggered by the anchor element. Accepts the following string values:
16859
+ * `Dialog`
16860
+ * - `Grid`
16861
+ * - `ListBox`
16862
+ * - `Menu`
16863
+ * - `Tree`
16146
16864
  *
16147
16865
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
16148
16866
  *
16149
- * Default value is `empty string`.
16867
+ * Default value is `{}`.
16150
16868
  */
16151
- setAccessibleNameRef(
16869
+ setAccessibilityAttributes(
16152
16870
  /**
16153
- * New value for property `accessibleNameRef`
16871
+ * New value for property `accessibilityAttributes`
16154
16872
  */
16155
- sAccessibleNameRef?: string
16873
+ oAccessibilityAttributes?: object
16156
16874
  ): this;
16157
16875
  /**
16158
16876
  * Sets a new value for property {@link #getDesign design}.
@@ -16274,7 +16992,7 @@ declare namespace sap {
16274
16992
  * The `sap.ui.webc.main.List` component allows displaying a list of items, advanced keyboard handling support
16275
16993
  * for navigating between items, and predefined modes to improve the development efficiency.
16276
16994
  *
16277
- * The `sap.ui.webc.main.List` is а container for the available list items:
16995
+ * The `sap.ui.webc.main.List` is a container for the available list items:
16278
16996
  * - `sap.ui.webc.main.StandardListItem`
16279
16997
  * - `sap.ui.webc.main.CustomListItem`
16280
16998
  * - `sap.ui.webc.main.GroupHeaderListItem`
@@ -16287,7 +17005,9 @@ declare namespace sap {
16287
17005
  *
16288
17006
  *
16289
17007
  *
16290
- * Keyboard Handling: The `sap.ui.webc.main.List` provides advanced keyboard handling. When a list is focused
17008
+ * Keyboard Handling:
17009
+ *
17010
+ * Basic Navigation: The `sap.ui.webc.main.List` provides advanced keyboard handling. When a list is focused
16291
17011
  * the user can use the following keyboard shortcuts in order to perform a navigation:
16292
17012
  *
16293
17013
  *
@@ -16358,6 +17078,15 @@ declare namespace sap {
16358
17078
  * Returns a metadata object for class sap.ui.webc.main.List.
16359
17079
  */
16360
17080
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
17081
+ /**
17082
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
17083
+ */
17084
+ addAriaLabelledBy(
17085
+ /**
17086
+ * The ariaLabelledBy to add; if empty, nothing is inserted
17087
+ */
17088
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
17089
+ ): this;
16361
17090
  /**
16362
17091
  * Adds some header to the aggregation {@link #getHeader header}.
16363
17092
  */
@@ -16745,6 +17474,9 @@ declare namespace sap {
16745
17474
  ): this;
16746
17475
  /**
16747
17476
  * Fires event {@link #event:itemClick itemClick} to attached listeners.
17477
+ *
17478
+ * Listeners may prevent the default action of this event by calling the `preventDefault` method on the
17479
+ * event object. The return value of this method indicates whether the default action should be executed.
16748
17480
  */
16749
17481
  fireItemClick(
16750
17482
  /**
@@ -16756,7 +17488,7 @@ declare namespace sap {
16756
17488
  */
16757
17489
  item?: HTMLElement;
16758
17490
  }
16759
- ): this;
17491
+ ): boolean;
16760
17492
  /**
16761
17493
  * Fires event {@link #event:itemClose itemClose} to attached listeners.
16762
17494
  */
@@ -16834,14 +17566,6 @@ declare namespace sap {
16834
17566
  * Default value is `empty string`.
16835
17567
  */
16836
17568
  getAccessibleName(): string;
16837
- /**
16838
- * Gets current value of property {@link #getAccessibleNameRef accessibleNameRef}.
16839
- *
16840
- * Defines the IDs of the elements that label the input.
16841
- *
16842
- * Default value is `empty string`.
16843
- */
16844
- getAccessibleNameRef(): string;
16845
17569
  /**
16846
17570
  * Gets current value of property {@link #getAccessibleRole accessibleRole}.
16847
17571
  *
@@ -16852,6 +17576,11 @@ declare namespace sap {
16852
17576
  * Default value is `"list"`.
16853
17577
  */
16854
17578
  getAccessibleRole(): string;
17579
+ /**
17580
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
17581
+ * ariaLabelledBy}.
17582
+ */
17583
+ getAriaLabelledBy(): sap.ui.core.ID[];
16855
17584
  /**
16856
17585
  * Gets current value of property {@link #getBusy busy}.
16857
17586
  *
@@ -16893,7 +17622,7 @@ declare namespace sap {
16893
17622
  *
16894
17623
  *
16895
17624
  *
16896
- * **Limitations:** `growing="Scroll"` is not supported for Internet Explorer, on IE the component will
17625
+ * **Restrictions:** `growing="Scroll"` is not supported for Internet Explorer, on IE the component will
16897
17626
  * fallback to `growing="Button"`.
16898
17627
  *
16899
17628
  * Default value is `None`.
@@ -17029,6 +17758,10 @@ declare namespace sap {
17029
17758
  */
17030
17759
  iIndex: int
17031
17760
  ): this;
17761
+ /**
17762
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
17763
+ */
17764
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
17032
17765
  /**
17033
17766
  * Removes all the controls from the aggregation {@link #getHeader header}.
17034
17767
  *
@@ -17041,6 +17774,15 @@ declare namespace sap {
17041
17774
  * Additionally, it unregisters them from the hosting UIArea.
17042
17775
  */
17043
17776
  removeAllItems(): sap.ui.webc.main.IListItem[];
17777
+ /**
17778
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
17779
+ */
17780
+ removeAriaLabelledBy(
17781
+ /**
17782
+ * The ariaLabelledBy to be removed or its index or ID
17783
+ */
17784
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
17785
+ ): sap.ui.core.ID;
17044
17786
  /**
17045
17787
  * Removes a header from the aggregation {@link #getHeader header}.
17046
17788
  */
@@ -17074,21 +17816,6 @@ declare namespace sap {
17074
17816
  */
17075
17817
  sAccessibleName?: string
17076
17818
  ): this;
17077
- /**
17078
- * Sets a new value for property {@link #getAccessibleNameRef accessibleNameRef}.
17079
- *
17080
- * Defines the IDs of the elements that label the input.
17081
- *
17082
- * When called with a value of `null` or `undefined`, the default value of the property will be restored.
17083
- *
17084
- * Default value is `empty string`.
17085
- */
17086
- setAccessibleNameRef(
17087
- /**
17088
- * New value for property `accessibleNameRef`
17089
- */
17090
- sAccessibleNameRef?: string
17091
- ): this;
17092
17819
  /**
17093
17820
  * Sets a new value for property {@link #getAccessibleRole accessibleRole}.
17094
17821
  *
@@ -17168,7 +17895,7 @@ declare namespace sap {
17168
17895
  *
17169
17896
  *
17170
17897
  *
17171
- * **Limitations:** `growing="Scroll"` is not supported for Internet Explorer, on IE the component will
17898
+ * **Restrictions:** `growing="Scroll"` is not supported for Internet Explorer, on IE the component will
17172
17899
  * fallback to `growing="Button"`.
17173
17900
  *
17174
17901
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
@@ -17308,6 +18035,8 @@ declare namespace sap {
17308
18035
  *
17309
18036
  * For the `sap.ui.webc.main.MessageStrip` component, you can define whether it displays an icon in the
17310
18037
  * beginning and a close button. Moreover, its size and background can be controlled with CSS.
18038
+ *
18039
+ * Keyboard Handling:
17311
18040
  */
17312
18041
  class MessageStrip extends sap.ui.webc.common.WebComponent {
17313
18042
  /**
@@ -17627,11 +18356,6 @@ declare namespace sap {
17627
18356
  * - Delete - deletes the token and focuses the previous token.
17628
18357
  * - Backspace - deletes the token and focus the next token.
17629
18358
  *
17630
- * In the context of `sap.ui.webc.main.MultiComboBox`, you can provide a custom stable DOM ref for:
17631
- *
17632
- * - Every `sap.ui.webc.main.MultiComboBoxItem` that you provide. Example: `<ui5-mcb-item stable-dom-ref="item1"></ui5-mcb-item>`
17633
- *
17634
- *
17635
18359
  * CSS Shadow Parts:
17636
18360
  *
17637
18361
  * CSS Shadow Parts
@@ -18087,6 +18811,12 @@ declare namespace sap {
18087
18811
  * Default value is `empty string`.
18088
18812
  */
18089
18813
  getValueStateMessage(): string;
18814
+ /**
18815
+ * Gets current value of property {@link #getWidth width}.
18816
+ *
18817
+ * Defines the width of the control
18818
+ */
18819
+ getWidth(): sap.ui.core.CSSSize;
18090
18820
  /**
18091
18821
  * Checks for the provided `sap.ui.webc.main.IMultiComboBoxItem` in the aggregation {@link #getItems items}.
18092
18822
  * and returns its index if found or -1 otherwise.
@@ -18289,6 +19019,19 @@ declare namespace sap {
18289
19019
  */
18290
19020
  sValueStateMessage?: string
18291
19021
  ): this;
19022
+ /**
19023
+ * Sets a new value for property {@link #getWidth width}.
19024
+ *
19025
+ * Defines the width of the control
19026
+ *
19027
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
19028
+ */
19029
+ setWidth(
19030
+ /**
19031
+ * New value for property `width`
19032
+ */
19033
+ sWidth?: sap.ui.core.CSSSize
19034
+ ): this;
18292
19035
  }
18293
19036
  /**
18294
19037
  * @SINCE 1.92.0
@@ -18495,6 +19238,15 @@ declare namespace sap {
18495
19238
  * Returns a metadata object for class sap.ui.webc.main.MultiInput.
18496
19239
  */
18497
19240
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
19241
+ /**
19242
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
19243
+ */
19244
+ addAriaLabelledBy(
19245
+ /**
19246
+ * The ariaLabelledBy to add; if empty, nothing is inserted
19247
+ */
19248
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
19249
+ ): this;
18498
19250
  /**
18499
19251
  * Adds some icon to the aggregation {@link #getIcon icon}.
18500
19252
  */
@@ -18965,13 +19717,10 @@ declare namespace sap {
18965
19717
  */
18966
19718
  getAccessibleName(): string;
18967
19719
  /**
18968
- * Gets current value of property {@link #getAccessibleNameRef accessibleNameRef}.
18969
- *
18970
- * Receives id(or many ids) of the elements that label the input.
18971
- *
18972
- * Default value is `empty string`.
19720
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
19721
+ * ariaLabelledBy}.
18973
19722
  */
18974
- getAccessibleNameRef(): string;
19723
+ getAriaLabelledBy(): sap.ui.core.ID[];
18975
19724
  /**
18976
19725
  * Gets current value of property {@link #getDisabled disabled}.
18977
19726
  *
@@ -19037,6 +19786,14 @@ declare namespace sap {
19037
19786
  * Default value is `false`.
19038
19787
  */
19039
19788
  getRequired(): boolean;
19789
+ /**
19790
+ * Gets current value of property {@link #getShowClearIcon showClearIcon}.
19791
+ *
19792
+ * Defines whether the clear icon of the input will be shown.
19793
+ *
19794
+ * Default value is `false`.
19795
+ */
19796
+ getShowClearIcon(): boolean;
19040
19797
  /**
19041
19798
  * Gets current value of property {@link #getShowSuggestions showSuggestions}.
19042
19799
  *
@@ -19119,6 +19876,12 @@ declare namespace sap {
19119
19876
  * Default value is `empty string`.
19120
19877
  */
19121
19878
  getValueStateMessage(): string;
19879
+ /**
19880
+ * Gets current value of property {@link #getWidth width}.
19881
+ *
19882
+ * Defines the width of the control
19883
+ */
19884
+ getWidth(): sap.ui.core.CSSSize;
19122
19885
  /**
19123
19886
  * Checks for the provided `sap.ui.webc.main.IIcon` in the aggregation {@link #getIcon icon}. and returns
19124
19887
  * its index if found or -1 otherwise.
@@ -19194,6 +19957,10 @@ declare namespace sap {
19194
19957
  */
19195
19958
  iIndex: int
19196
19959
  ): this;
19960
+ /**
19961
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
19962
+ */
19963
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
19197
19964
  /**
19198
19965
  * Removes all the controls from the aggregation {@link #getIcon icon}.
19199
19966
  *
@@ -19212,6 +19979,15 @@ declare namespace sap {
19212
19979
  * Additionally, it unregisters them from the hosting UIArea.
19213
19980
  */
19214
19981
  removeAllTokens(): sap.ui.webc.main.IToken[];
19982
+ /**
19983
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
19984
+ */
19985
+ removeAriaLabelledBy(
19986
+ /**
19987
+ * The ariaLabelledBy to be removed or its index or ID
19988
+ */
19989
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
19990
+ ): sap.ui.core.ID;
19215
19991
  /**
19216
19992
  * Removes a icon from the aggregation {@link #getIcon icon}.
19217
19993
  */
@@ -19255,21 +20031,6 @@ declare namespace sap {
19255
20031
  */
19256
20032
  sAccessibleName: string
19257
20033
  ): this;
19258
- /**
19259
- * Sets a new value for property {@link #getAccessibleNameRef accessibleNameRef}.
19260
- *
19261
- * Receives id(or many ids) of the elements that label the input.
19262
- *
19263
- * When called with a value of `null` or `undefined`, the default value of the property will be restored.
19264
- *
19265
- * Default value is `empty string`.
19266
- */
19267
- setAccessibleNameRef(
19268
- /**
19269
- * New value for property `accessibleNameRef`
19270
- */
19271
- sAccessibleNameRef?: string
19272
- ): this;
19273
20034
  /**
19274
20035
  * Sets a new value for property {@link #getDisabled disabled}.
19275
20036
  *
@@ -19367,6 +20128,21 @@ declare namespace sap {
19367
20128
  */
19368
20129
  bRequired?: boolean
19369
20130
  ): this;
20131
+ /**
20132
+ * Sets a new value for property {@link #getShowClearIcon showClearIcon}.
20133
+ *
20134
+ * Defines whether the clear icon of the input will be shown.
20135
+ *
20136
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
20137
+ *
20138
+ * Default value is `false`.
20139
+ */
20140
+ setShowClearIcon(
20141
+ /**
20142
+ * New value for property `showClearIcon`
20143
+ */
20144
+ bShowClearIcon?: boolean
20145
+ ): this;
19370
20146
  /**
19371
20147
  * Sets a new value for property {@link #getShowSuggestions showSuggestions}.
19372
20148
  *
@@ -19481,6 +20257,19 @@ declare namespace sap {
19481
20257
  */
19482
20258
  sValueStateMessage?: string
19483
20259
  ): this;
20260
+ /**
20261
+ * Sets a new value for property {@link #getWidth width}.
20262
+ *
20263
+ * Defines the width of the control
20264
+ *
20265
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
20266
+ */
20267
+ setWidth(
20268
+ /**
20269
+ * New value for property `width`
20270
+ */
20271
+ sWidth?: sap.ui.core.CSSSize
20272
+ ): this;
19484
20273
  }
19485
20274
  /**
19486
20275
  * @SINCE 1.92.0
@@ -19709,6 +20498,8 @@ declare namespace sap {
19709
20498
  * allow developers to style elements inside the Shadow DOM.
19710
20499
  * The `sap.ui.webc.main.Panel` exposes the following CSS Shadow Parts:
19711
20500
  * - content - Used to style the wrapper of the content
20501
+ *
20502
+ * Keyboard Handling:
19712
20503
  */
19713
20504
  class Panel extends sap.ui.webc.common.WebComponent {
19714
20505
  /**
@@ -20243,6 +21034,15 @@ declare namespace sap {
20243
21034
  * Returns a metadata object for class sap.ui.webc.main.Popover.
20244
21035
  */
20245
21036
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
21037
+ /**
21038
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
21039
+ */
21040
+ addAriaLabelledBy(
21041
+ /**
21042
+ * The ariaLabelledBy to add; if empty, nothing is inserted
21043
+ */
21044
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
21045
+ ): this;
20246
21046
  /**
20247
21047
  * Adds some content to the aggregation {@link #getContent content}.
20248
21048
  */
@@ -20568,7 +21368,7 @@ declare namespace sap {
20568
21368
  /**
20569
21369
  * Gets current value of property {@link #getAccessibleName accessibleName}.
20570
21370
  *
20571
- * Sets the accessible aria name of the component.
21371
+ * Defines the accessible name of the component.
20572
21372
  *
20573
21373
  * Default value is `empty string`.
20574
21374
  */
@@ -20581,6 +21381,11 @@ declare namespace sap {
20581
21381
  * Default value is `false`.
20582
21382
  */
20583
21383
  getAllowTargetOverlap(): boolean;
21384
+ /**
21385
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
21386
+ * ariaLabelledBy}.
21387
+ */
21388
+ getAriaLabelledBy(): sap.ui.core.ID[];
20584
21389
  /**
20585
21390
  * Gets content of aggregation {@link #getContent content}.
20586
21391
  *
@@ -20783,6 +21588,10 @@ declare namespace sap {
20783
21588
  * Tells if the component is opened
20784
21589
  */
20785
21590
  isOpen(): void;
21591
+ /**
21592
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
21593
+ */
21594
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
20786
21595
  /**
20787
21596
  * Removes all the controls from the aggregation {@link #getContent content}.
20788
21597
  *
@@ -20801,6 +21610,15 @@ declare namespace sap {
20801
21610
  * Additionally, it unregisters them from the hosting UIArea.
20802
21611
  */
20803
21612
  removeAllHeader(): sap.ui.core.Control[];
21613
+ /**
21614
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
21615
+ */
21616
+ removeAriaLabelledBy(
21617
+ /**
21618
+ * The ariaLabelledBy to be removed or its index or ID
21619
+ */
21620
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
21621
+ ): sap.ui.core.ID;
20804
21622
  /**
20805
21623
  * Removes a content from the aggregation {@link #getContent content}.
20806
21624
  */
@@ -20831,7 +21649,7 @@ declare namespace sap {
20831
21649
  /**
20832
21650
  * Sets a new value for property {@link #getAccessibleName accessibleName}.
20833
21651
  *
20834
- * Sets the accessible aria name of the component.
21652
+ * Defines the accessible name of the component.
20835
21653
  *
20836
21654
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
20837
21655
  *
@@ -21173,6 +21991,12 @@ declare namespace sap {
21173
21991
  * Default value is `None`.
21174
21992
  */
21175
21993
  getValueState(): sap.ui.core.ValueState;
21994
+ /**
21995
+ * Gets current value of property {@link #getWidth width}.
21996
+ *
21997
+ * Defines the width of the control
21998
+ */
21999
+ getWidth(): sap.ui.core.CSSSize;
21176
22000
  /**
21177
22001
  * Sets a new value for property {@link #getDisabled disabled}.
21178
22002
  *
@@ -21261,6 +22085,19 @@ declare namespace sap {
21261
22085
  */
21262
22086
  sValueState?: sap.ui.core.ValueState
21263
22087
  ): this;
22088
+ /**
22089
+ * Sets a new value for property {@link #getWidth width}.
22090
+ *
22091
+ * Defines the width of the control
22092
+ *
22093
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
22094
+ */
22095
+ setWidth(
22096
+ /**
22097
+ * New value for property `width`
22098
+ */
22099
+ sWidth?: sap.ui.core.CSSSize
22100
+ ): this;
21264
22101
  }
21265
22102
  /**
21266
22103
  * @SINCE 1.92.0
@@ -21284,7 +22121,10 @@ declare namespace sap {
21284
22121
  * group.
21285
22122
  * **Note:** On entering radio button group, the focus goes to the currently selected radio button.
21286
22123
  */
21287
- class RadioButton extends sap.ui.webc.common.WebComponent {
22124
+ class RadioButton
22125
+ extends sap.ui.webc.common.WebComponent
22126
+ implements sap.ui.core.IFormContent {
22127
+ __implements__sap_ui_core_IFormContent: boolean;
21288
22128
  /**
21289
22129
  * Constructor for a new `RadioButton`.
21290
22130
  *
@@ -21341,6 +22181,15 @@ declare namespace sap {
21341
22181
  * Returns a metadata object for class sap.ui.webc.main.RadioButton.
21342
22182
  */
21343
22183
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
22184
+ /**
22185
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
22186
+ */
22187
+ addAriaLabelledBy(
22188
+ /**
22189
+ * The ariaLabelledBy to add; if empty, nothing is inserted
22190
+ */
22191
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
22192
+ ): this;
21344
22193
  /**
21345
22194
  * Attaches event handler `fnFunction` to the {@link #event:change change} event of this `sap.ui.webc.main.RadioButton`.
21346
22195
  *
@@ -21406,6 +22255,11 @@ declare namespace sap {
21406
22255
  */
21407
22256
  mParameters?: object
21408
22257
  ): this;
22258
+ /**
22259
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
22260
+ * ariaLabelledBy}.
22261
+ */
22262
+ getAriaLabelledBy(): sap.ui.core.ID[];
21409
22263
  /**
21410
22264
  * Gets current value of property {@link #getChecked checked}.
21411
22265
  *
@@ -21486,6 +22340,12 @@ declare namespace sap {
21486
22340
  * Default value is `None`.
21487
22341
  */
21488
22342
  getValueState(): sap.ui.core.ValueState;
22343
+ /**
22344
+ * Gets current value of property {@link #getWidth width}.
22345
+ *
22346
+ * Defines the width of the control
22347
+ */
22348
+ getWidth(): sap.ui.core.CSSSize;
21489
22349
  /**
21490
22350
  * Gets current value of property {@link #getWrappingType wrappingType}.
21491
22351
  *
@@ -21498,6 +22358,19 @@ declare namespace sap {
21498
22358
  * Default value is `None`.
21499
22359
  */
21500
22360
  getWrappingType(): sap.ui.webc.main.WrappingType;
22361
+ /**
22362
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
22363
+ */
22364
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
22365
+ /**
22366
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
22367
+ */
22368
+ removeAriaLabelledBy(
22369
+ /**
22370
+ * The ariaLabelledBy to be removed or its index or ID
22371
+ */
22372
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
22373
+ ): sap.ui.core.ID;
21501
22374
  /**
21502
22375
  * Sets a new value for property {@link #getChecked checked}.
21503
22376
  *
@@ -21627,6 +22500,19 @@ declare namespace sap {
21627
22500
  */
21628
22501
  sValueState?: sap.ui.core.ValueState
21629
22502
  ): this;
22503
+ /**
22504
+ * Sets a new value for property {@link #getWidth width}.
22505
+ *
22506
+ * Defines the width of the control
22507
+ *
22508
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
22509
+ */
22510
+ setWidth(
22511
+ /**
22512
+ * New value for property `width`
22513
+ */
22514
+ sWidth?: sap.ui.core.CSSSize
22515
+ ): this;
21630
22516
  /**
21631
22517
  * Sets a new value for property {@link #getWrappingType wrappingType}.
21632
22518
  *
@@ -22141,6 +23027,22 @@ declare namespace sap {
22141
23027
  * Responsive Behavior: You can change the size of the Rating Indicator by changing its `font-size` CSS
22142
23028
  * property.
22143
23029
  * Example: `<ui5-rating-indicator style="font-size: 3rem;"></ui5-rating-indicator>`
23030
+ *
23031
+ * Keyboard Handling: When the `sap.ui.webc.main.RatingIndicator` is focused, the user can change the rating
23032
+ * with the following keyboard shortcuts:
23033
+ *
23034
+ *
23035
+ *
23036
+ * - [RIGHT/UP] - Increases the value of the rating by one step. If the highest value is reached, does
23037
+ * nothing
23038
+ * - [LEFT/DOWN] - Decreases the value of the rating by one step. If the lowest value is reached, does
23039
+ * nothing.
23040
+ * - [HOME] - Sets the lowest value.
23041
+ * - [END] - Sets the highest value.
23042
+ * - [SPACE/ENTER/RETURN] - Increases the value of the rating by one step. If the highest value is reached,
23043
+ * sets the rating to the lowest value.
23044
+ * - Any number - Changes value to the corresponding number. If typed number is larger than the number
23045
+ * of values, sets the highest value.
22144
23046
  */
22145
23047
  class RatingIndicator extends sap.ui.webc.common.WebComponent {
22146
23048
  /**
@@ -22464,6 +23366,15 @@ declare namespace sap {
22464
23366
  * Returns a metadata object for class sap.ui.webc.main.ResponsivePopover.
22465
23367
  */
22466
23368
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
23369
+ /**
23370
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
23371
+ */
23372
+ addAriaLabelledBy(
23373
+ /**
23374
+ * The ariaLabelledBy to add; if empty, nothing is inserted
23375
+ */
23376
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
23377
+ ): this;
22467
23378
  /**
22468
23379
  * Adds some content to the aggregation {@link #getContent content}.
22469
23380
  */
@@ -22797,7 +23708,7 @@ declare namespace sap {
22797
23708
  /**
22798
23709
  * Gets current value of property {@link #getAccessibleName accessibleName}.
22799
23710
  *
22800
- * Sets the accessible aria name of the component.
23711
+ * Defines the accessible name of the component.
22801
23712
  *
22802
23713
  * Default value is `empty string`.
22803
23714
  */
@@ -22810,6 +23721,11 @@ declare namespace sap {
22810
23721
  * Default value is `false`.
22811
23722
  */
22812
23723
  getAllowTargetOverlap(): boolean;
23724
+ /**
23725
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
23726
+ * ariaLabelledBy}.
23727
+ */
23728
+ getAriaLabelledBy(): sap.ui.core.ID[];
22813
23729
  /**
22814
23730
  * Gets content of aggregation {@link #getContent content}.
22815
23731
  *
@@ -23000,6 +23916,10 @@ declare namespace sap {
23000
23916
  * Tells if the responsive popover is open
23001
23917
  */
23002
23918
  isOpen(): void;
23919
+ /**
23920
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
23921
+ */
23922
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
23003
23923
  /**
23004
23924
  * Removes all the controls from the aggregation {@link #getContent content}.
23005
23925
  *
@@ -23018,6 +23938,15 @@ declare namespace sap {
23018
23938
  * Additionally, it unregisters them from the hosting UIArea.
23019
23939
  */
23020
23940
  removeAllHeader(): sap.ui.core.Control[];
23941
+ /**
23942
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
23943
+ */
23944
+ removeAriaLabelledBy(
23945
+ /**
23946
+ * The ariaLabelledBy to be removed or its index or ID
23947
+ */
23948
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
23949
+ ): sap.ui.core.ID;
23021
23950
  /**
23022
23951
  * Removes a content from the aggregation {@link #getContent content}.
23023
23952
  */
@@ -23048,7 +23977,7 @@ declare namespace sap {
23048
23977
  /**
23049
23978
  * Sets a new value for property {@link #getAccessibleName accessibleName}.
23050
23979
  *
23051
- * Sets the accessible aria name of the component.
23980
+ * Defines the accessible name of the component.
23052
23981
  *
23053
23982
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
23054
23983
  *
@@ -23257,7 +24186,10 @@ declare namespace sap {
23257
24186
  *
23258
24187
  * **Note:** There can be just one selected `item` at a time.
23259
24188
  */
23260
- class SegmentedButton extends sap.ui.webc.common.WebComponent {
24189
+ class SegmentedButton
24190
+ extends sap.ui.webc.common.WebComponent
24191
+ implements sap.ui.core.IFormContent {
24192
+ __implements__sap_ui_core_IFormContent: boolean;
23261
24193
  /**
23262
24194
  * Constructor for a new `SegmentedButton`.
23263
24195
  *
@@ -23400,6 +24332,17 @@ declare namespace sap {
23400
24332
  selectedItem?: HTMLElement;
23401
24333
  }
23402
24334
  ): this;
24335
+ /**
24336
+ * Gets current value of property {@link #getAccessibleName accessibleName}.
24337
+ *
24338
+ * Sets the accessible aria name of the component.
24339
+ */
24340
+ getAccessibleName(): string;
24341
+ /**
24342
+ * `SegmentedButton` must not be stretched in Form because ResizeHandler is used internally in order to
24343
+ * manage the width of the SegmentedButton depending on the container size
24344
+ */
24345
+ getFormDoNotAdjustWidth(): boolean;
23403
24346
  /**
23404
24347
  * Gets content of aggregation {@link #getItems items}.
23405
24348
  *
@@ -23454,6 +24397,19 @@ declare namespace sap {
23454
24397
  */
23455
24398
  vItem: int | string | sap.ui.webc.main.ISegmentedButtonItem
23456
24399
  ): sap.ui.webc.main.ISegmentedButtonItem;
24400
+ /**
24401
+ * Sets a new value for property {@link #getAccessibleName accessibleName}.
24402
+ *
24403
+ * Sets the accessible aria name of the component.
24404
+ *
24405
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
24406
+ */
24407
+ setAccessibleName(
24408
+ /**
24409
+ * New value for property `accessibleName`
24410
+ */
24411
+ sAccessibleName: string
24412
+ ): this;
23457
24413
  }
23458
24414
  /**
23459
24415
  * @SINCE 1.95.0
@@ -23528,6 +24484,15 @@ declare namespace sap {
23528
24484
  * Returns a metadata object for class sap.ui.webc.main.SegmentedButtonItem.
23529
24485
  */
23530
24486
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
24487
+ /**
24488
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
24489
+ */
24490
+ addAriaLabelledBy(
24491
+ /**
24492
+ * The ariaLabelledBy to add; if empty, nothing is inserted
24493
+ */
24494
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
24495
+ ): this;
23531
24496
  /**
23532
24497
  * Attaches event handler `fnFunction` to the {@link #event:click click} event of this `sap.ui.webc.main.SegmentedButtonItem`.
23533
24498
  *
@@ -23599,12 +24564,43 @@ declare namespace sap {
23599
24564
  */
23600
24565
  mParameters?: object
23601
24566
  ): this;
24567
+ /**
24568
+ * Gets current value of property {@link #getAccessibilityAttributes accessibilityAttributes}.
24569
+ *
24570
+ * An object of strings that defines several additional accessibility attribute values for customization
24571
+ * depending on the use case.
24572
+ *
24573
+ * It supports the following fields:
24574
+ *
24575
+ *
24576
+ * - `expanded`: Indicates whether the button, or another grouping element it controls, is currently expanded
24577
+ * or collapsed. Accepts the following string values:
24578
+ * `true`
24579
+ * - `false`
24580
+ * - `hasPopup`: Indicates the availability and type of interactive popup element, such as menu or dialog,
24581
+ * that can be triggered by the button. Accepts the following string values:
24582
+ * `Dialog`
24583
+ * - `Grid`
24584
+ * - `ListBox`
24585
+ * - `Menu`
24586
+ * - `Tree`
24587
+ * - `controls`: Identifies the element (or elements) whose contents or presence are controlled by the
24588
+ * button element. Accepts a string value.
24589
+ *
24590
+ * Default value is `{}`.
24591
+ */
24592
+ getAccessibilityAttributes(): object;
23602
24593
  /**
23603
24594
  * Gets current value of property {@link #getAccessibleName accessibleName}.
23604
24595
  *
23605
24596
  * Sets the accessible aria name of the component.
23606
24597
  */
23607
24598
  getAccessibleName(): string;
24599
+ /**
24600
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
24601
+ * ariaLabelledBy}.
24602
+ */
24603
+ getAriaLabelledBy(): sap.ui.core.ID[];
23608
24604
  /**
23609
24605
  * Gets current value of property {@link #getDesign design}.
23610
24606
  *
@@ -23667,6 +24663,52 @@ declare namespace sap {
23667
24663
  * Default value is `empty string`.
23668
24664
  */
23669
24665
  getText(): string;
24666
+ /**
24667
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
24668
+ */
24669
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
24670
+ /**
24671
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
24672
+ */
24673
+ removeAriaLabelledBy(
24674
+ /**
24675
+ * The ariaLabelledBy to be removed or its index or ID
24676
+ */
24677
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
24678
+ ): sap.ui.core.ID;
24679
+ /**
24680
+ * Sets a new value for property {@link #getAccessibilityAttributes accessibilityAttributes}.
24681
+ *
24682
+ * An object of strings that defines several additional accessibility attribute values for customization
24683
+ * depending on the use case.
24684
+ *
24685
+ * It supports the following fields:
24686
+ *
24687
+ *
24688
+ * - `expanded`: Indicates whether the button, or another grouping element it controls, is currently expanded
24689
+ * or collapsed. Accepts the following string values:
24690
+ * `true`
24691
+ * - `false`
24692
+ * - `hasPopup`: Indicates the availability and type of interactive popup element, such as menu or dialog,
24693
+ * that can be triggered by the button. Accepts the following string values:
24694
+ * `Dialog`
24695
+ * - `Grid`
24696
+ * - `ListBox`
24697
+ * - `Menu`
24698
+ * - `Tree`
24699
+ * - `controls`: Identifies the element (or elements) whose contents or presence are controlled by the
24700
+ * button element. Accepts a string value.
24701
+ *
24702
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
24703
+ *
24704
+ * Default value is `{}`.
24705
+ */
24706
+ setAccessibilityAttributes(
24707
+ /**
24708
+ * New value for property `accessibilityAttributes`
24709
+ */
24710
+ oAccessibilityAttributes?: object
24711
+ ): this;
23670
24712
  /**
23671
24713
  * Sets a new value for property {@link #getAccessibleName accessibleName}.
23672
24714
  *
@@ -23810,13 +24852,6 @@ declare namespace sap {
23810
24852
  * - [ESC] - Closes the drop-down without changing the selection.
23811
24853
  * - [HOME] - Navigates to first option
23812
24854
  * - [END] - Navigates to the last option
23813
- *
23814
- *
23815
- * Stable DOM Refs:
23816
- *
23817
- * In the context of `sap.ui.webc.main.Select`, you can provide a custom stable DOM ref for:
23818
- * - Every `sap.ui.webc.main.Option` that you provide. Example: `
23819
- * `
23820
24855
  */
23821
24856
  class Select extends sap.ui.webc.common.WebComponent {
23822
24857
  /**
@@ -23875,6 +24910,15 @@ declare namespace sap {
23875
24910
  * Returns a metadata object for class sap.ui.webc.main.Select.
23876
24911
  */
23877
24912
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
24913
+ /**
24914
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
24915
+ */
24916
+ addAriaLabelledBy(
24917
+ /**
24918
+ * The ariaLabelledBy to add; if empty, nothing is inserted
24919
+ */
24920
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
24921
+ ): this;
23878
24922
  /**
23879
24923
  * Adds some option to the aggregation {@link #getOptions options}.
23880
24924
  */
@@ -23965,13 +25009,10 @@ declare namespace sap {
23965
25009
  */
23966
25010
  getAccessibleName(): string;
23967
25011
  /**
23968
- * Gets current value of property {@link #getAccessibleNameRef accessibleNameRef}.
23969
- *
23970
- * Receives id(or many ids) of the elements that label the select.
23971
- *
23972
- * Default value is `empty string`.
25012
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
25013
+ * ariaLabelledBy}.
23973
25014
  */
23974
- getAccessibleNameRef(): string;
25015
+ getAriaLabelledBy(): sap.ui.core.ID[];
23975
25016
  /**
23976
25017
  * Gets current value of property {@link #getDisabled disabled}.
23977
25018
  *
@@ -24051,6 +25092,12 @@ declare namespace sap {
24051
25092
  * Default value is `empty string`.
24052
25093
  */
24053
25094
  getValueStateMessage(): string;
25095
+ /**
25096
+ * Gets current value of property {@link #getWidth width}.
25097
+ *
25098
+ * Defines the width of the control
25099
+ */
25100
+ getWidth(): sap.ui.core.CSSSize;
24054
25101
  /**
24055
25102
  * Checks for the provided `sap.ui.webc.main.ISelectOption` in the aggregation {@link #getOptions options}.
24056
25103
  * and returns its index if found or -1 otherwise.
@@ -24076,12 +25123,25 @@ declare namespace sap {
24076
25123
  */
24077
25124
  iIndex: int
24078
25125
  ): this;
25126
+ /**
25127
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
25128
+ */
25129
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
24079
25130
  /**
24080
25131
  * Removes all the controls from the aggregation {@link #getOptions options}.
24081
25132
  *
24082
25133
  * Additionally, it unregisters them from the hosting UIArea.
24083
25134
  */
24084
25135
  removeAllOptions(): sap.ui.webc.main.ISelectOption[];
25136
+ /**
25137
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
25138
+ */
25139
+ removeAriaLabelledBy(
25140
+ /**
25141
+ * The ariaLabelledBy to be removed or its index or ID
25142
+ */
25143
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
25144
+ ): sap.ui.core.ID;
24085
25145
  /**
24086
25146
  * Removes a option from the aggregation {@link #getOptions options}.
24087
25147
  */
@@ -24104,21 +25164,6 @@ declare namespace sap {
24104
25164
  */
24105
25165
  sAccessibleName: string
24106
25166
  ): this;
24107
- /**
24108
- * Sets a new value for property {@link #getAccessibleNameRef accessibleNameRef}.
24109
- *
24110
- * Receives id(or many ids) of the elements that label the select.
24111
- *
24112
- * When called with a value of `null` or `undefined`, the default value of the property will be restored.
24113
- *
24114
- * Default value is `empty string`.
24115
- */
24116
- setAccessibleNameRef(
24117
- /**
24118
- * New value for property `accessibleNameRef`
24119
- */
24120
- sAccessibleNameRef?: string
24121
- ): this;
24122
25167
  /**
24123
25168
  * Sets a new value for property {@link #getDisabled disabled}.
24124
25169
  *
@@ -24214,6 +25259,19 @@ declare namespace sap {
24214
25259
  */
24215
25260
  sValueStateMessage?: string
24216
25261
  ): this;
25262
+ /**
25263
+ * Sets a new value for property {@link #getWidth width}.
25264
+ *
25265
+ * Defines the width of the control
25266
+ *
25267
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
25268
+ */
25269
+ setWidth(
25270
+ /**
25271
+ * New value for property `width`
25272
+ */
25273
+ sWidth?: sap.ui.core.CSSSize
25274
+ ): this;
24217
25275
  }
24218
25276
  /**
24219
25277
  * @SINCE 1.92.0
@@ -24531,6 +25589,12 @@ declare namespace sap {
24531
25589
  * Default value is `0`.
24532
25590
  */
24533
25591
  getValue(): float;
25592
+ /**
25593
+ * Gets current value of property {@link #getWidth width}.
25594
+ *
25595
+ * Defines the width of the control
25596
+ */
25597
+ getWidth(): sap.ui.core.CSSSize;
24534
25598
  /**
24535
25599
  * Sets a new value for property {@link #getDisabled disabled}.
24536
25600
  *
@@ -24661,6 +25725,410 @@ declare namespace sap {
24661
25725
  */
24662
25726
  fValue?: float
24663
25727
  ): this;
25728
+ /**
25729
+ * Sets a new value for property {@link #getWidth width}.
25730
+ *
25731
+ * Defines the width of the control
25732
+ *
25733
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
25734
+ */
25735
+ setWidth(
25736
+ /**
25737
+ * New value for property `width`
25738
+ */
25739
+ sWidth?: sap.ui.core.CSSSize
25740
+ ): this;
25741
+ }
25742
+ /**
25743
+ * @SINCE 1.99.0
25744
+ * @EXPERIMENTAL (since 1.99.0)
25745
+ *
25746
+ * Overview:
25747
+ *
25748
+ * `sap.ui.webc.main.SplitButton` enables users to trigger actions. It is constructed of two separate actions
25749
+ * - default action and arrow action that can be activated by clicking or tapping, or by pressing certain
25750
+ * keyboard keys - `Space` or `Enter` for default action, and `Arrow Down` or `Arrow Up` for arrow action.
25751
+ *
25752
+ * Usage:
25753
+ *
25754
+ * `sap.ui.webc.main.SplitButton` consists two separate buttons:
25755
+ * - for the first one (default action) you can define some `text` or an `icon`, or both. Also, it is
25756
+ * possible to define different icon for active state of this button - `activeIcon`.
25757
+ * - the second one (arrow action) contains only `slim-arrow-down` icon. You can choose a `design`
25758
+ * from a set of predefined types (the same as for ui5-button) that offer different styling to correspond
25759
+ * to the triggered action. Both text and arrow actions have the same design.
25760
+ *
25761
+ * You can set the `sap.ui.webc.main.SplitButton` as enabled or disabled. Both parts of an enabled `sap.ui.webc.main.SplitButton`
25762
+ * can be pressed by clicking or tapping it, or by certain keys, which changes the style to provide visual
25763
+ * feedback to the user that it is pressed or hovered over with the mouse cursor. A disabled `sap.ui.webc.main.SplitButton`
25764
+ * appears inactive and any of the two buttons cannot be pressed.
25765
+ *
25766
+ * Keyboard Handling:
25767
+ * - `Space` or `Enter` - triggers the default action
25768
+ * - `Shift` or `Escape` - if `Space` is pressed, releases the default action button without triggering
25769
+ * the click event.
25770
+ * - `Arrow Down`, `Arrow Up`, `Alt`+`Arrow Down`, `Alt`+`Arrow Up`, or `F4` - triggers the arrow action
25771
+ * There are separate events that are fired on activating of `sap.ui.webc.main.SplitButton` parts:
25772
+ * `click` for the first button (default action)
25773
+ * - `arrow-click` for the second button (arrow action)
25774
+ */
25775
+ class SplitButton extends sap.ui.webc.common.WebComponent {
25776
+ /**
25777
+ * Constructor for a new `SplitButton`.
25778
+ *
25779
+ * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
25780
+ * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
25781
+ * of the syntax of the settings object.
25782
+ */
25783
+ constructor(
25784
+ /**
25785
+ * Initial settings for the new control
25786
+ */
25787
+ mSettings?: sap.ui.webc.main.$SplitButtonSettings
25788
+ );
25789
+ /**
25790
+ * Constructor for a new `SplitButton`.
25791
+ *
25792
+ * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
25793
+ * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
25794
+ * of the syntax of the settings object.
25795
+ */
25796
+ constructor(
25797
+ /**
25798
+ * ID for the new control, generated automatically if no ID is given
25799
+ */
25800
+ sId?: string,
25801
+ /**
25802
+ * Initial settings for the new control
25803
+ */
25804
+ mSettings?: sap.ui.webc.main.$SplitButtonSettings
25805
+ );
25806
+
25807
+ /**
25808
+ * Creates a new subclass of class sap.ui.webc.main.SplitButton with name `sClassName` and enriches it with
25809
+ * the information contained in `oClassInfo`.
25810
+ *
25811
+ * `oClassInfo` might contain the same kind of information as described in {@link sap.ui.webc.common.WebComponent.extend}.
25812
+ */
25813
+ static extend<T extends Record<string, unknown>>(
25814
+ /**
25815
+ * Name of the class being created
25816
+ */
25817
+ sClassName: string,
25818
+ /**
25819
+ * Object literal with information about the class
25820
+ */
25821
+ oClassInfo?: sap.ClassInfo<T, sap.ui.webc.main.SplitButton>,
25822
+ /**
25823
+ * Constructor function for the metadata object; if not given, it defaults to the metadata implementation
25824
+ * used by this class
25825
+ */
25826
+ FNMetaImpl?: Function
25827
+ ): Function;
25828
+ /**
25829
+ * Returns a metadata object for class sap.ui.webc.main.SplitButton.
25830
+ */
25831
+ static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
25832
+ /**
25833
+ * Attaches event handler `fnFunction` to the {@link #event:arrowClick arrowClick} event of this `sap.ui.webc.main.SplitButton`.
25834
+ *
25835
+ * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
25836
+ * otherwise it will be bound to this `sap.ui.webc.main.SplitButton` itself.
25837
+ *
25838
+ * Fired when the user clicks on the arrow action.
25839
+ */
25840
+ attachArrowClick(
25841
+ /**
25842
+ * An application-specific payload object that will be passed to the event handler along with the event
25843
+ * object when firing the event
25844
+ */
25845
+ oData: object,
25846
+ /**
25847
+ * The function to be called when the event occurs
25848
+ */
25849
+ fnFunction: (p1: sap.ui.base.Event) => void,
25850
+ /**
25851
+ * Context object to call the event handler with. Defaults to this `sap.ui.webc.main.SplitButton` itself
25852
+ */
25853
+ oListener?: object
25854
+ ): this;
25855
+ /**
25856
+ * Attaches event handler `fnFunction` to the {@link #event:arrowClick arrowClick} event of this `sap.ui.webc.main.SplitButton`.
25857
+ *
25858
+ * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
25859
+ * otherwise it will be bound to this `sap.ui.webc.main.SplitButton` itself.
25860
+ *
25861
+ * Fired when the user clicks on the arrow action.
25862
+ */
25863
+ attachArrowClick(
25864
+ /**
25865
+ * The function to be called when the event occurs
25866
+ */
25867
+ fnFunction: (p1: sap.ui.base.Event) => void,
25868
+ /**
25869
+ * Context object to call the event handler with. Defaults to this `sap.ui.webc.main.SplitButton` itself
25870
+ */
25871
+ oListener?: object
25872
+ ): this;
25873
+ /**
25874
+ * Attaches event handler `fnFunction` to the {@link #event:click click} event of this `sap.ui.webc.main.SplitButton`.
25875
+ *
25876
+ * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
25877
+ * otherwise it will be bound to this `sap.ui.webc.main.SplitButton` itself.
25878
+ *
25879
+ * Fired when the user clicks on the default action.
25880
+ */
25881
+ attachClick(
25882
+ /**
25883
+ * An application-specific payload object that will be passed to the event handler along with the event
25884
+ * object when firing the event
25885
+ */
25886
+ oData: object,
25887
+ /**
25888
+ * The function to be called when the event occurs
25889
+ */
25890
+ fnFunction: (p1: sap.ui.base.Event) => void,
25891
+ /**
25892
+ * Context object to call the event handler with. Defaults to this `sap.ui.webc.main.SplitButton` itself
25893
+ */
25894
+ oListener?: object
25895
+ ): this;
25896
+ /**
25897
+ * Attaches event handler `fnFunction` to the {@link #event:click click} event of this `sap.ui.webc.main.SplitButton`.
25898
+ *
25899
+ * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
25900
+ * otherwise it will be bound to this `sap.ui.webc.main.SplitButton` itself.
25901
+ *
25902
+ * Fired when the user clicks on the default action.
25903
+ */
25904
+ attachClick(
25905
+ /**
25906
+ * The function to be called when the event occurs
25907
+ */
25908
+ fnFunction: (p1: sap.ui.base.Event) => void,
25909
+ /**
25910
+ * Context object to call the event handler with. Defaults to this `sap.ui.webc.main.SplitButton` itself
25911
+ */
25912
+ oListener?: object
25913
+ ): this;
25914
+ /**
25915
+ * Detaches event handler `fnFunction` from the {@link #event:arrowClick arrowClick} event of this `sap.ui.webc.main.SplitButton`.
25916
+ *
25917
+ * The passed function and listener object must match the ones used for event registration.
25918
+ */
25919
+ detachArrowClick(
25920
+ /**
25921
+ * The function to be called, when the event occurs
25922
+ */
25923
+ fnFunction: (p1: sap.ui.base.Event) => void,
25924
+ /**
25925
+ * Context object on which the given function had to be called
25926
+ */
25927
+ oListener?: object
25928
+ ): this;
25929
+ /**
25930
+ * Detaches event handler `fnFunction` from the {@link #event:click click} event of this `sap.ui.webc.main.SplitButton`.
25931
+ *
25932
+ * The passed function and listener object must match the ones used for event registration.
25933
+ */
25934
+ detachClick(
25935
+ /**
25936
+ * The function to be called, when the event occurs
25937
+ */
25938
+ fnFunction: (p1: sap.ui.base.Event) => void,
25939
+ /**
25940
+ * Context object on which the given function had to be called
25941
+ */
25942
+ oListener?: object
25943
+ ): this;
25944
+ /**
25945
+ * Fires event {@link #event:arrowClick arrowClick} to attached listeners.
25946
+ */
25947
+ fireArrowClick(
25948
+ /**
25949
+ * Parameters to pass along with the event
25950
+ */
25951
+ mParameters?: object
25952
+ ): this;
25953
+ /**
25954
+ * Fires event {@link #event:click click} to attached listeners.
25955
+ */
25956
+ fireClick(
25957
+ /**
25958
+ * Parameters to pass along with the event
25959
+ */
25960
+ mParameters?: object
25961
+ ): this;
25962
+ /**
25963
+ * Gets current value of property {@link #getAccessibleName accessibleName}.
25964
+ *
25965
+ * Sets the accessible aria name of the component.
25966
+ */
25967
+ getAccessibleName(): string;
25968
+ /**
25969
+ * Gets current value of property {@link #getActiveIcon activeIcon}.
25970
+ *
25971
+ * Defines the icon to be displayed in active state as graphical element within the component.
25972
+ *
25973
+ * Default value is `empty string`.
25974
+ */
25975
+ getActiveIcon(): string;
25976
+ /**
25977
+ * Gets current value of property {@link #getDesign design}.
25978
+ *
25979
+ * Defines the component design.
25980
+ *
25981
+ *
25982
+ *
25983
+ * **The available values are:**
25984
+ *
25985
+ *
25986
+ * - `Default`
25987
+ * - `Emphasized`
25988
+ * - `Positive`
25989
+ * - `Negative`
25990
+ * - `Transparent`
25991
+ * - `Attention`
25992
+ *
25993
+ * Default value is `Default`.
25994
+ */
25995
+ getDesign(): sap.ui.webc.main.ButtonDesign;
25996
+ /**
25997
+ * Gets current value of property {@link #getDisabled disabled}.
25998
+ *
25999
+ * Defines whether the component is disabled. A disabled component can't be pressed or focused, and it is
26000
+ * not in the tab chain.
26001
+ *
26002
+ * Default value is `false`.
26003
+ */
26004
+ getDisabled(): boolean;
26005
+ /**
26006
+ * Gets current value of property {@link #getIcon icon}.
26007
+ *
26008
+ * Defines the icon to be displayed as graphical element within the component. The SAP-icons font provides
26009
+ * numerous options.
26010
+ *
26011
+ * Example:
26012
+ *
26013
+ * See all the available icons in the Icon Explorer.
26014
+ *
26015
+ * Default value is `empty string`.
26016
+ */
26017
+ getIcon(): string;
26018
+ /**
26019
+ * Gets current value of property {@link #getText text}.
26020
+ *
26021
+ * Defines the content of the control
26022
+ *
26023
+ * Default value is `empty string`.
26024
+ */
26025
+ getText(): string;
26026
+ /**
26027
+ * Sets a new value for property {@link #getAccessibleName accessibleName}.
26028
+ *
26029
+ * Sets the accessible aria name of the component.
26030
+ *
26031
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
26032
+ */
26033
+ setAccessibleName(
26034
+ /**
26035
+ * New value for property `accessibleName`
26036
+ */
26037
+ sAccessibleName: string
26038
+ ): this;
26039
+ /**
26040
+ * Sets a new value for property {@link #getActiveIcon activeIcon}.
26041
+ *
26042
+ * Defines the icon to be displayed in active state as graphical element within the component.
26043
+ *
26044
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
26045
+ *
26046
+ * Default value is `empty string`.
26047
+ */
26048
+ setActiveIcon(
26049
+ /**
26050
+ * New value for property `activeIcon`
26051
+ */
26052
+ sActiveIcon?: string
26053
+ ): this;
26054
+ /**
26055
+ * Sets a new value for property {@link #getDesign design}.
26056
+ *
26057
+ * Defines the component design.
26058
+ *
26059
+ *
26060
+ *
26061
+ * **The available values are:**
26062
+ *
26063
+ *
26064
+ * - `Default`
26065
+ * - `Emphasized`
26066
+ * - `Positive`
26067
+ * - `Negative`
26068
+ * - `Transparent`
26069
+ * - `Attention`
26070
+ *
26071
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
26072
+ *
26073
+ * Default value is `Default`.
26074
+ */
26075
+ setDesign(
26076
+ /**
26077
+ * New value for property `design`
26078
+ */
26079
+ sDesign?: sap.ui.webc.main.ButtonDesign
26080
+ ): this;
26081
+ /**
26082
+ * Sets a new value for property {@link #getDisabled disabled}.
26083
+ *
26084
+ * Defines whether the component is disabled. A disabled component can't be pressed or focused, and it is
26085
+ * not in the tab chain.
26086
+ *
26087
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
26088
+ *
26089
+ * Default value is `false`.
26090
+ */
26091
+ setDisabled(
26092
+ /**
26093
+ * New value for property `disabled`
26094
+ */
26095
+ bDisabled?: boolean
26096
+ ): this;
26097
+ /**
26098
+ * Sets a new value for property {@link #getIcon icon}.
26099
+ *
26100
+ * Defines the icon to be displayed as graphical element within the component. The SAP-icons font provides
26101
+ * numerous options.
26102
+ *
26103
+ * Example:
26104
+ *
26105
+ * See all the available icons in the Icon Explorer.
26106
+ *
26107
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
26108
+ *
26109
+ * Default value is `empty string`.
26110
+ */
26111
+ setIcon(
26112
+ /**
26113
+ * New value for property `icon`
26114
+ */
26115
+ sIcon?: string
26116
+ ): this;
26117
+ /**
26118
+ * Sets a new value for property {@link #getText text}.
26119
+ *
26120
+ * Defines the content of the control
26121
+ *
26122
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
26123
+ *
26124
+ * Default value is `empty string`.
26125
+ */
26126
+ setText(
26127
+ /**
26128
+ * New value for property `text`
26129
+ */
26130
+ sText?: string
26131
+ ): this;
24664
26132
  }
24665
26133
  /**
24666
26134
  * @SINCE 1.92.0
@@ -25135,6 +26603,15 @@ declare namespace sap {
25135
26603
  * Returns a metadata object for class sap.ui.webc.main.StepInput.
25136
26604
  */
25137
26605
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
26606
+ /**
26607
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
26608
+ */
26609
+ addAriaLabelledBy(
26610
+ /**
26611
+ * The ariaLabelledBy to add; if empty, nothing is inserted
26612
+ */
26613
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
26614
+ ): this;
25138
26615
  /**
25139
26616
  * Attaches event handler `fnFunction` to the {@link #event:change change} event of this `sap.ui.webc.main.StepInput`.
25140
26617
  *
@@ -25207,13 +26684,10 @@ declare namespace sap {
25207
26684
  */
25208
26685
  getAccessibleName(): string;
25209
26686
  /**
25210
- * Gets current value of property {@link #getAccessibleNameRef accessibleNameRef}.
25211
- *
25212
- * Receives id(or many ids) of the elements that label the component.
25213
- *
25214
- * Default value is `empty string`.
26687
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
26688
+ * ariaLabelledBy}.
25215
26689
  */
25216
- getAccessibleNameRef(): string;
26690
+ getAriaLabelledBy(): sap.ui.core.ID[];
25217
26691
  /**
25218
26692
  * Gets current value of property {@link #getDisabled disabled}.
25219
26693
  *
@@ -25329,32 +26803,36 @@ declare namespace sap {
25329
26803
  */
25330
26804
  getValueStateMessage(): string;
25331
26805
  /**
25332
- * Sets a new value for property {@link #getAccessibleName accessibleName}.
25333
- *
25334
- * Sets the accessible aria name of the component.
26806
+ * Gets current value of property {@link #getWidth width}.
25335
26807
  *
25336
- * When called with a value of `null` or `undefined`, the default value of the property will be restored.
26808
+ * Defines the width of the control
25337
26809
  */
25338
- setAccessibleName(
26810
+ getWidth(): sap.ui.core.CSSSize;
26811
+ /**
26812
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
26813
+ */
26814
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
26815
+ /**
26816
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
26817
+ */
26818
+ removeAriaLabelledBy(
25339
26819
  /**
25340
- * New value for property `accessibleName`
26820
+ * The ariaLabelledBy to be removed or its index or ID
25341
26821
  */
25342
- sAccessibleName: string
25343
- ): this;
26822
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
26823
+ ): sap.ui.core.ID;
25344
26824
  /**
25345
- * Sets a new value for property {@link #getAccessibleNameRef accessibleNameRef}.
26825
+ * Sets a new value for property {@link #getAccessibleName accessibleName}.
25346
26826
  *
25347
- * Receives id(or many ids) of the elements that label the component.
26827
+ * Sets the accessible aria name of the component.
25348
26828
  *
25349
26829
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
25350
- *
25351
- * Default value is `empty string`.
25352
26830
  */
25353
- setAccessibleNameRef(
26831
+ setAccessibleName(
25354
26832
  /**
25355
- * New value for property `accessibleNameRef`
26833
+ * New value for property `accessibleName`
25356
26834
  */
25357
- sAccessibleNameRef?: string
26835
+ sAccessibleName: string
25358
26836
  ): this;
25359
26837
  /**
25360
26838
  * Sets a new value for property {@link #getDisabled disabled}.
@@ -25554,6 +27032,19 @@ declare namespace sap {
25554
27032
  */
25555
27033
  sValueStateMessage?: string
25556
27034
  ): this;
27035
+ /**
27036
+ * Sets a new value for property {@link #getWidth width}.
27037
+ *
27038
+ * Defines the width of the control
27039
+ *
27040
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
27041
+ */
27042
+ setWidth(
27043
+ /**
27044
+ * New value for property `width`
27045
+ */
27046
+ sWidth?: sap.ui.core.CSSSize
27047
+ ): this;
25557
27048
  }
25558
27049
  /**
25559
27050
  * @SINCE 1.95.0
@@ -25987,6 +27478,15 @@ declare namespace sap {
25987
27478
  * Returns a metadata object for class sap.ui.webc.main.Switch.
25988
27479
  */
25989
27480
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
27481
+ /**
27482
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
27483
+ */
27484
+ addAriaLabelledBy(
27485
+ /**
27486
+ * The ariaLabelledBy to add; if empty, nothing is inserted
27487
+ */
27488
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
27489
+ ): this;
25990
27490
  /**
25991
27491
  * Attaches event handler `fnFunction` to the {@link #event:change change} event of this `sap.ui.webc.main.Switch`.
25992
27492
  *
@@ -26052,6 +27552,11 @@ declare namespace sap {
26052
27552
  */
26053
27553
  mParameters?: object
26054
27554
  ): this;
27555
+ /**
27556
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
27557
+ * ariaLabelledBy}.
27558
+ */
27559
+ getAriaLabelledBy(): sap.ui.core.ID[];
26055
27560
  /**
26056
27561
  * Gets current value of property {@link #getChecked checked}.
26057
27562
  *
@@ -26107,6 +27612,19 @@ declare namespace sap {
26107
27612
  * Default value is `empty string`.
26108
27613
  */
26109
27614
  getTextOn(): string;
27615
+ /**
27616
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
27617
+ */
27618
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
27619
+ /**
27620
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
27621
+ */
27622
+ removeAriaLabelledBy(
27623
+ /**
27624
+ * The ariaLabelledBy to be removed or its index or ID
27625
+ */
27626
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
27627
+ ): sap.ui.core.ID;
26110
27628
  /**
26111
27629
  * Sets a new value for property {@link #getChecked checked}.
26112
27630
  *
@@ -26282,7 +27800,7 @@ declare namespace sap {
26282
27800
  /**
26283
27801
  * Gets current value of property {@link #getAdditionalText additionalText}.
26284
27802
  *
26285
- * Represents the "additionalText" text, which is displayed in the tab filter.
27803
+ * Represents the "additionalText" text, which is displayed in the tab.
26286
27804
  *
26287
27805
  * Default value is `empty string`.
26288
27806
  */
@@ -26339,6 +27857,11 @@ declare namespace sap {
26339
27857
  * Default value is `false`.
26340
27858
  */
26341
27859
  getSelected(): boolean;
27860
+ /**
27861
+ * Returns the DOM reference of the tab that is placed in the header. **Note:** If you need a DOM ref to
27862
+ * the tab content please use the `getDomRef` method.
27863
+ */
27864
+ getTabInStripDomRef(): void;
26342
27865
  /**
26343
27866
  * Gets current value of property {@link #getText text}.
26344
27867
  *
@@ -26390,7 +27913,7 @@ declare namespace sap {
26390
27913
  /**
26391
27914
  * Sets a new value for property {@link #getAdditionalText additionalText}.
26392
27915
  *
26393
- * Represents the "additionalText" text, which is displayed in the tab filter.
27916
+ * Represents the "additionalText" text, which is displayed in the tab.
26394
27917
  *
26395
27918
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
26396
27919
  *
@@ -26508,11 +28031,7 @@ declare namespace sap {
26508
28031
  * - `sap.ui.webc.main.Tab` - contains all the information on an item (text and icon)
26509
28032
  * - `sap.ui.webc.main.TabSeparator` - used to separate tabs with a vertical line
26510
28033
  *
26511
- * Stable DOM Refs:
26512
- *
26513
- * In the context of `sap.ui.webc.main.TabContainer`, you can provide a custom stable DOM refs for:
26514
- *
26515
- * - Each `sap.ui.webc.main.Tab` Example: ` `
28034
+ * Keyboard Handling:
26516
28035
  */
26517
28036
  class TabContainer extends sap.ui.webc.common.WebComponent {
26518
28037
  /**
@@ -26629,6 +28148,10 @@ declare namespace sap {
26629
28148
  * Destroys the overflowButton in the aggregation {@link #getOverflowButton overflowButton}.
26630
28149
  */
26631
28150
  destroyOverflowButton(): this;
28151
+ /**
28152
+ * Destroys the startOverflowButton in the aggregation {@link #getStartOverflowButton startOverflowButton}.
28153
+ */
28154
+ destroyStartOverflowButton(): this;
26632
28155
  /**
26633
28156
  * Detaches event handler `fnFunction` from the {@link #event:tabSelect tabSelect} event of this `sap.ui.webc.main.TabContainer`.
26634
28157
  *
@@ -26704,12 +28227,19 @@ declare namespace sap {
26704
28227
  *
26705
28228
  * Defines whether the overflow select list is displayed.
26706
28229
  *
26707
- * The overflow select list represents a list, where all tab filters are displayed so that it's easier
26708
- * for the user to select a specific tab filter.
28230
+ * The overflow select list represents a list, where all tabs are displayed so that it's easier for the
28231
+ * user to select a specific tab.
26709
28232
  *
26710
28233
  * Default value is `false`.
26711
28234
  */
26712
28235
  getShowOverflow(): boolean;
28236
+ /**
28237
+ * Gets content of aggregation {@link #getStartOverflowButton startOverflowButton}.
28238
+ *
28239
+ * Defines the button which will open the start overflow menu if available. If nothing is provided to this
28240
+ * slot, the default button will be used.
28241
+ */
28242
+ getStartOverflowButton(): sap.ui.webc.main.IButton;
26713
28243
  /**
26714
28244
  * Gets current value of property {@link #getTabLayout tabLayout}.
26715
28245
  *
@@ -26729,6 +28259,27 @@ declare namespace sap {
26729
28259
  * Default value is `Standard`.
26730
28260
  */
26731
28261
  getTabLayout(): sap.ui.webc.main.TabLayout;
28262
+ /**
28263
+ * Gets current value of property {@link #getTabsOverflowMode tabsOverflowMode}.
28264
+ *
28265
+ * Defines the overflow mode of the tab strip. If you have a large number of tabs, only the tabs that can
28266
+ * fit on screen will be visible. All other tabs that can 't fit on the screen are available in an overflow
28267
+ * tab "More".
28268
+ *
28269
+ *
28270
+ *
28271
+ * **Note:** Only one overflow at the end would be displayed by default, but when set to `StartAndEnd`,
28272
+ * there will be two overflows on both ends, and tab order will not change on tab selection.
28273
+ *
28274
+ *
28275
+ *
28276
+ * Available options are:
28277
+ * - `End`
28278
+ * - `StartAndEnd`
28279
+ *
28280
+ * Default value is `End`.
28281
+ */
28282
+ getTabsOverflowMode(): sap.ui.webc.main.TabsOverflowMode;
26732
28283
  /**
26733
28284
  * Gets current value of property {@link #getWidth width}.
26734
28285
  *
@@ -26832,8 +28383,8 @@ declare namespace sap {
26832
28383
  *
26833
28384
  * Defines whether the overflow select list is displayed.
26834
28385
  *
26835
- * The overflow select list represents a list, where all tab filters are displayed so that it's easier
26836
- * for the user to select a specific tab filter.
28386
+ * The overflow select list represents a list, where all tabs are displayed so that it's easier for the
28387
+ * user to select a specific tab.
26837
28388
  *
26838
28389
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
26839
28390
  *
@@ -26845,6 +28396,15 @@ declare namespace sap {
26845
28396
  */
26846
28397
  bShowOverflow?: boolean
26847
28398
  ): this;
28399
+ /**
28400
+ * Sets the aggregated {@link #getStartOverflowButton startOverflowButton}.
28401
+ */
28402
+ setStartOverflowButton(
28403
+ /**
28404
+ * The startOverflowButton to set
28405
+ */
28406
+ oStartOverflowButton: sap.ui.webc.main.IButton
28407
+ ): this;
26848
28408
  /**
26849
28409
  * Sets a new value for property {@link #getTabLayout tabLayout}.
26850
28410
  *
@@ -26871,6 +28431,34 @@ declare namespace sap {
26871
28431
  */
26872
28432
  sTabLayout?: sap.ui.webc.main.TabLayout
26873
28433
  ): this;
28434
+ /**
28435
+ * Sets a new value for property {@link #getTabsOverflowMode tabsOverflowMode}.
28436
+ *
28437
+ * Defines the overflow mode of the tab strip. If you have a large number of tabs, only the tabs that can
28438
+ * fit on screen will be visible. All other tabs that can 't fit on the screen are available in an overflow
28439
+ * tab "More".
28440
+ *
28441
+ *
28442
+ *
28443
+ * **Note:** Only one overflow at the end would be displayed by default, but when set to `StartAndEnd`,
28444
+ * there will be two overflows on both ends, and tab order will not change on tab selection.
28445
+ *
28446
+ *
28447
+ *
28448
+ * Available options are:
28449
+ * - `End`
28450
+ * - `StartAndEnd`
28451
+ *
28452
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
28453
+ *
28454
+ * Default value is `End`.
28455
+ */
28456
+ setTabsOverflowMode(
28457
+ /**
28458
+ * New value for property `tabsOverflowMode`
28459
+ */
28460
+ sTabsOverflowMode?: sap.ui.webc.main.TabsOverflowMode
28461
+ ): this;
26874
28462
  /**
26875
28463
  * Sets a new value for property {@link #getWidth width}.
26876
28464
  *
@@ -26914,6 +28502,21 @@ declare namespace sap {
26914
28502
  *
26915
28503
  * **Note:** Currently, when a column is shown as a pop-in, the visual indication for selection is not
26916
28504
  * presented over it.
28505
+ *
28506
+ * Keyboard Handling:
28507
+ *
28508
+ *
28509
+ * - [F7] - If focus is on an interactive control inside an item, moves focus to the corresponding item.
28510
+ *
28511
+ * - [CTRL]+[A] - Selects all items, if MultiSelect mode is enabled.
28512
+ * - [HOME]/[END] - Focuses the first/last item.
28513
+ * - [PAGEUP]/[PAGEDOWN] - Moves focus up/down by page size (20 items by default).
28514
+ * - [ALT]+[DOWN]/[UP] - Switches focus between header, last focused item, and More button (if applies)
28515
+ * in either direction.
28516
+ * - [SHIFT]+[DOWN]/[UP] - Selects the next/previous item in a MultiSelect table, if the current item
28517
+ * is selected (Range selection). Otherwise, deselects them (Range deselection).
28518
+ * - [SHIFT]+[HOME]/[END] - Range selection to the first/last item of the List.
28519
+ * - [CTRL]+[HOME]/[END] - Same behavior as HOME & END. *
26917
28520
  */
26918
28521
  class Table extends sap.ui.webc.common.WebComponent {
26919
28522
  /**
@@ -27332,7 +28935,7 @@ declare namespace sap {
27332
28935
  *
27333
28936
  *
27334
28937
  *
27335
- * **Limitations:** `growing="Scroll"` is not supported for Internet Explorer, and the component will fallback
28938
+ * **Restrictions:** `growing="Scroll"` is not supported for Internet Explorer, and the component will fallback
27336
28939
  * to `growing="Button"`.
27337
28940
  *
27338
28941
  * Default value is `None`.
@@ -27413,7 +29016,7 @@ declare namespace sap {
27413
29016
  * Determines whether the column headers remain fixed at the top of the page during vertical scrolling as
27414
29017
  * long as the Web Component is in the viewport.
27415
29018
  *
27416
- * **Limitations:**
29019
+ * **Restrictions:**
27417
29020
  * - Browsers that do not support this feature:
27418
29021
  * Internet Explorer
27419
29022
  * - Microsoft Edge lower than version 41 (EdgeHTML 16)
@@ -27562,7 +29165,7 @@ declare namespace sap {
27562
29165
  *
27563
29166
  *
27564
29167
  *
27565
- * **Limitations:** `growing="Scroll"` is not supported for Internet Explorer, and the component will fallback
29168
+ * **Restrictions:** `growing="Scroll"` is not supported for Internet Explorer, and the component will fallback
27566
29169
  * to `growing="Button"`.
27567
29170
  *
27568
29171
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
@@ -27684,7 +29287,7 @@ declare namespace sap {
27684
29287
  * Determines whether the column headers remain fixed at the top of the page during vertical scrolling as
27685
29288
  * long as the Web Component is in the viewport.
27686
29289
  *
27687
- * **Limitations:**
29290
+ * **Restrictions:**
27688
29291
  * - Browsers that do not support this feature:
27689
29292
  * Internet Explorer
27690
29293
  * - Microsoft Edge lower than version 41 (EdgeHTML 16)
@@ -28518,6 +30121,15 @@ declare namespace sap {
28518
30121
  * Returns a metadata object for class sap.ui.webc.main.TextArea.
28519
30122
  */
28520
30123
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
30124
+ /**
30125
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
30126
+ */
30127
+ addAriaLabelledBy(
30128
+ /**
30129
+ * The ariaLabelledBy to add; if empty, nothing is inserted
30130
+ */
30131
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
30132
+ ): this;
28521
30133
  /**
28522
30134
  * Attaches event handler `fnFunction` to the {@link #event:change change} event of this `sap.ui.webc.main.TextArea`.
28523
30135
  *
@@ -28655,13 +30267,10 @@ declare namespace sap {
28655
30267
  */
28656
30268
  getAccessibleName(): string;
28657
30269
  /**
28658
- * Gets current value of property {@link #getAccessibleNameRef accessibleNameRef}.
28659
- *
28660
- * Receives id(or many ids) of the elements that label the textarea.
28661
- *
28662
- * Default value is `empty string`.
30270
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
30271
+ * ariaLabelledBy}.
28663
30272
  */
28664
- getAccessibleNameRef(): string;
30273
+ getAriaLabelledBy(): sap.ui.core.ID[];
28665
30274
  /**
28666
30275
  * Gets current value of property {@link #getDisabled disabled}.
28667
30276
  *
@@ -28811,6 +30420,19 @@ declare namespace sap {
28811
30420
  * Defines the width of the control
28812
30421
  */
28813
30422
  getWidth(): sap.ui.core.CSSSize;
30423
+ /**
30424
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
30425
+ */
30426
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
30427
+ /**
30428
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
30429
+ */
30430
+ removeAriaLabelledBy(
30431
+ /**
30432
+ * The ariaLabelledBy to be removed or its index or ID
30433
+ */
30434
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
30435
+ ): sap.ui.core.ID;
28814
30436
  /**
28815
30437
  * Sets a new value for property {@link #getAccessibleName accessibleName}.
28816
30438
  *
@@ -28824,21 +30446,6 @@ declare namespace sap {
28824
30446
  */
28825
30447
  sAccessibleName: string
28826
30448
  ): this;
28827
- /**
28828
- * Sets a new value for property {@link #getAccessibleNameRef accessibleNameRef}.
28829
- *
28830
- * Receives id(or many ids) of the elements that label the textarea.
28831
- *
28832
- * When called with a value of `null` or `undefined`, the default value of the property will be restored.
28833
- *
28834
- * Default value is `empty string`.
28835
- */
28836
- setAccessibleNameRef(
28837
- /**
28838
- * New value for property `accessibleNameRef`
28839
- */
28840
- sAccessibleNameRef?: string
28841
- ): this;
28842
30449
  /**
28843
30450
  * Sets a new value for property {@link #getDisabled disabled}.
28844
30451
  *
@@ -30042,6 +31649,15 @@ declare namespace sap {
30042
31649
  * Returns a metadata object for class sap.ui.webc.main.ToggleButton.
30043
31650
  */
30044
31651
  static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
31652
+ /**
31653
+ * Adds some ariaLabelledBy into the association {@link #getAriaLabelledBy ariaLabelledBy}.
31654
+ */
31655
+ addAriaLabelledBy(
31656
+ /**
31657
+ * The ariaLabelledBy to add; if empty, nothing is inserted
31658
+ */
31659
+ vAriaLabelledBy: sap.ui.core.ID | sap.ui.core.Control
31660
+ ): this;
30045
31661
  /**
30046
31662
  * Attaches event handler `fnFunction` to the {@link #event:click click} event of this `sap.ui.webc.main.ToggleButton`.
30047
31663
  *
@@ -30111,12 +31727,43 @@ declare namespace sap {
30111
31727
  */
30112
31728
  mParameters?: object
30113
31729
  ): this;
31730
+ /**
31731
+ * Gets current value of property {@link #getAccessibilityAttributes accessibilityAttributes}.
31732
+ *
31733
+ * An object of strings that defines several additional accessibility attribute values for customization
31734
+ * depending on the use case.
31735
+ *
31736
+ * It supports the following fields:
31737
+ *
31738
+ *
31739
+ * - `expanded`: Indicates whether the button, or another grouping element it controls, is currently expanded
31740
+ * or collapsed. Accepts the following string values:
31741
+ * `true`
31742
+ * - `false`
31743
+ * - `hasPopup`: Indicates the availability and type of interactive popup element, such as menu or dialog,
31744
+ * that can be triggered by the button. Accepts the following string values:
31745
+ * `Dialog`
31746
+ * - `Grid`
31747
+ * - `ListBox`
31748
+ * - `Menu`
31749
+ * - `Tree`
31750
+ * - `controls`: Identifies the element (or elements) whose contents or presence are controlled by the
31751
+ * button element. Accepts a string value.
31752
+ *
31753
+ * Default value is `{}`.
31754
+ */
31755
+ getAccessibilityAttributes(): object;
30114
31756
  /**
30115
31757
  * Gets current value of property {@link #getAccessibleName accessibleName}.
30116
31758
  *
30117
31759
  * Sets the accessible aria name of the component.
30118
31760
  */
30119
31761
  getAccessibleName(): string;
31762
+ /**
31763
+ * Returns array of IDs of the elements which are the current targets of the association {@link #getAriaLabelledBy
31764
+ * ariaLabelledBy}.
31765
+ */
31766
+ getAriaLabelledBy(): sap.ui.core.ID[];
30120
31767
  /**
30121
31768
  * Gets current value of property {@link #getDesign design}.
30122
31769
  *
@@ -30195,6 +31842,52 @@ declare namespace sap {
30195
31842
  * Defines the width of the control
30196
31843
  */
30197
31844
  getWidth(): sap.ui.core.CSSSize;
31845
+ /**
31846
+ * Removes all the controls in the association named {@link #getAriaLabelledBy ariaLabelledBy}.
31847
+ */
31848
+ removeAllAriaLabelledBy(): sap.ui.core.ID[];
31849
+ /**
31850
+ * Removes an ariaLabelledBy from the association named {@link #getAriaLabelledBy ariaLabelledBy}.
31851
+ */
31852
+ removeAriaLabelledBy(
31853
+ /**
31854
+ * The ariaLabelledBy to be removed or its index or ID
31855
+ */
31856
+ vAriaLabelledBy: int | sap.ui.core.ID | sap.ui.core.Control
31857
+ ): sap.ui.core.ID;
31858
+ /**
31859
+ * Sets a new value for property {@link #getAccessibilityAttributes accessibilityAttributes}.
31860
+ *
31861
+ * An object of strings that defines several additional accessibility attribute values for customization
31862
+ * depending on the use case.
31863
+ *
31864
+ * It supports the following fields:
31865
+ *
31866
+ *
31867
+ * - `expanded`: Indicates whether the button, or another grouping element it controls, is currently expanded
31868
+ * or collapsed. Accepts the following string values:
31869
+ * `true`
31870
+ * - `false`
31871
+ * - `hasPopup`: Indicates the availability and type of interactive popup element, such as menu or dialog,
31872
+ * that can be triggered by the button. Accepts the following string values:
31873
+ * `Dialog`
31874
+ * - `Grid`
31875
+ * - `ListBox`
31876
+ * - `Menu`
31877
+ * - `Tree`
31878
+ * - `controls`: Identifies the element (or elements) whose contents or presence are controlled by the
31879
+ * button element. Accepts a string value.
31880
+ *
31881
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
31882
+ *
31883
+ * Default value is `{}`.
31884
+ */
31885
+ setAccessibilityAttributes(
31886
+ /**
31887
+ * New value for property `accessibilityAttributes`
31888
+ */
31889
+ oAccessibilityAttributes?: object
31890
+ ): this;
30198
31891
  /**
30199
31892
  * Sets a new value for property {@link #getAccessibleName accessibleName}.
30200
31893
  *
@@ -31519,6 +33212,23 @@ declare namespace sap {
31519
33212
  * Default value is `empty string`.
31520
33213
  */
31521
33214
  getIcon(): string;
33215
+ /**
33216
+ * Gets current value of property {@link #getIndeterminate indeterminate}.
33217
+ *
33218
+ * Defines whether the selection of a tree node is displayed as partially selected.
33219
+ *
33220
+ * **Note:** The indeterminate state can be set only programatically and can’t be achieved by user interaction,
33221
+ * meaning that the resulting visual state depends on the values of the `indeterminate` and `selected` properties:
33222
+ *
33223
+ * If a tree node has both `selected` and `indeterminate` set to `true`, it is displayed as partially
33224
+ * selected. If a tree node has `selected` set to `true` and `indeterminate` set to `false`, it is
33225
+ * displayed as selected. If a tree node has `selected` set to `false`, it is displayed as not selected
33226
+ * regardless of the value of the `indeterminate` property.
33227
+ * **Note:** This property takes effect only when the `sap.ui.webc.main.Tree` is in `MultiSelect` mode.
33228
+ *
33229
+ * Default value is `false`.
33230
+ */
33231
+ getIndeterminate(): boolean;
31522
33232
  /**
31523
33233
  * Gets content of aggregation {@link #getItems items}.
31524
33234
  *
@@ -31661,6 +33371,30 @@ declare namespace sap {
31661
33371
  */
31662
33372
  sIcon?: string
31663
33373
  ): this;
33374
+ /**
33375
+ * Sets a new value for property {@link #getIndeterminate indeterminate}.
33376
+ *
33377
+ * Defines whether the selection of a tree node is displayed as partially selected.
33378
+ *
33379
+ * **Note:** The indeterminate state can be set only programatically and can’t be achieved by user interaction,
33380
+ * meaning that the resulting visual state depends on the values of the `indeterminate` and `selected` properties:
33381
+ *
33382
+ * If a tree node has both `selected` and `indeterminate` set to `true`, it is displayed as partially
33383
+ * selected. If a tree node has `selected` set to `true` and `indeterminate` set to `false`, it is
33384
+ * displayed as selected. If a tree node has `selected` set to `false`, it is displayed as not selected
33385
+ * regardless of the value of the `indeterminate` property.
33386
+ * **Note:** This property takes effect only when the `sap.ui.webc.main.Tree` is in `MultiSelect` mode.
33387
+ *
33388
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
33389
+ *
33390
+ * Default value is `false`.
33391
+ */
33392
+ setIndeterminate(
33393
+ /**
33394
+ * New value for property `indeterminate`
33395
+ */
33396
+ bIndeterminate?: boolean
33397
+ ): this;
31664
33398
  /**
31665
33399
  * Sets a new value for property {@link #getSelected selected}.
31666
33400
  *
@@ -31944,6 +33678,34 @@ declare namespace sap {
31944
33678
  */
31945
33679
  Scroll = "Scroll",
31946
33680
  }
33681
+ /**
33682
+ * @SINCE 1.99.0
33683
+ * @EXPERIMENTAL (since 1.99.0)
33684
+ *
33685
+ * Different types of HasPopup.
33686
+ */
33687
+ enum HasPopup {
33688
+ /**
33689
+ * Dialog popup type.
33690
+ */
33691
+ Dialog = "Dialog",
33692
+ /**
33693
+ * Grid popup type.
33694
+ */
33695
+ Grid = "Grid",
33696
+ /**
33697
+ * ListBox popup type.
33698
+ */
33699
+ ListBox = "ListBox",
33700
+ /**
33701
+ * Menu popup type.
33702
+ */
33703
+ Menu = "Menu",
33704
+ /**
33705
+ * Tree popup type.
33706
+ */
33707
+ Tree = "Tree",
33708
+ }
31947
33709
  /**
31948
33710
  * @SINCE 1.92.0
31949
33711
  * @EXPERIMENTAL (since 1.92.0)
@@ -32324,6 +34086,22 @@ declare namespace sap {
32324
34086
  */
32325
34087
  Inactive = "Inactive",
32326
34088
  }
34089
+ /**
34090
+ * @SINCE 1.99.0
34091
+ * @EXPERIMENTAL (since 1.99.0)
34092
+ *
34093
+ * Different types of overflow modes.
34094
+ */
34095
+ enum TabsOverflowMode {
34096
+ /**
34097
+ * End type is used if there should be only one overflow with hidden the tabs at the end of the tab container.
34098
+ */
34099
+ End = "End",
34100
+ /**
34101
+ * StartAndEnd type is used if there should be two overflows on both ends of the tab container.
34102
+ */
34103
+ StartAndEnd = "StartAndEnd",
34104
+ }
32327
34105
  /**
32328
34106
  * @SINCE 1.92.0
32329
34107
  * @EXPERIMENTAL (since 1.92.0)
@@ -32519,6 +34297,8 @@ declare namespace sap {
32519
34297
 
32520
34298
  "sap/ui/webc/main/Slider": undefined;
32521
34299
 
34300
+ "sap/ui/webc/main/SplitButton": undefined;
34301
+
32522
34302
  "sap/ui/webc/main/StandardListItem": undefined;
32523
34303
 
32524
34304
  "sap/ui/webc/main/StepInput": undefined;