@sapui5/ts-types 1.127.2 → 1.128.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/package.json +1 -1
  2. package/types/sap.apf.d.ts +1 -1
  3. package/types/sap.ca.ui.d.ts +1 -1
  4. package/types/sap.chart.d.ts +1 -1
  5. package/types/sap.collaboration.d.ts +1 -1
  6. package/types/sap.cux.home.d.ts +225 -19
  7. package/types/sap.esh.search.ui.d.ts +1 -1
  8. package/types/sap.f.d.ts +1366 -198
  9. package/types/sap.fe.base.d.ts +1 -1
  10. package/types/sap.fe.core.d.ts +11 -26
  11. package/types/sap.fe.ina.d.ts +1 -1
  12. package/types/sap.fe.macros.d.ts +10 -1
  13. package/types/sap.fe.navigation.d.ts +1 -1
  14. package/types/sap.fe.placeholder.d.ts +1 -1
  15. package/types/sap.fe.plugins.managecache.d.ts +1 -1
  16. package/types/sap.fe.templates.d.ts +14 -3
  17. package/types/sap.fe.test.d.ts +3 -3
  18. package/types/sap.fe.tools.d.ts +1 -1
  19. package/types/sap.feedback.ui.d.ts +1 -1
  20. package/types/sap.gantt.d.ts +123 -64
  21. package/types/sap.insights.d.ts +24 -1
  22. package/types/sap.m.d.ts +329 -23
  23. package/types/sap.makit.d.ts +1 -1
  24. package/types/sap.me.d.ts +1 -1
  25. package/types/sap.ndc.d.ts +1 -1
  26. package/types/sap.ovp.d.ts +1 -1
  27. package/types/sap.rules.ui.d.ts +1 -1
  28. package/types/sap.sac.df.d.ts +96 -23
  29. package/types/sap.suite.ui.commons.d.ts +1 -1
  30. package/types/sap.suite.ui.generic.template.d.ts +1 -1
  31. package/types/sap.suite.ui.microchart.d.ts +1 -1
  32. package/types/sap.tnt.d.ts +1 -1
  33. package/types/sap.ui.codeeditor.d.ts +10 -4
  34. package/types/sap.ui.commons.d.ts +1 -1
  35. package/types/sap.ui.comp.d.ts +1010 -4
  36. package/types/sap.ui.core.d.ts +48 -28
  37. package/types/sap.ui.dt.d.ts +1 -1
  38. package/types/sap.ui.export.d.ts +1 -1
  39. package/types/sap.ui.fl.d.ts +10 -4
  40. package/types/sap.ui.generic.app.d.ts +1 -1
  41. package/types/sap.ui.generic.template.d.ts +1 -1
  42. package/types/sap.ui.integration.d.ts +53 -4
  43. package/types/sap.ui.layout.d.ts +5 -5
  44. package/types/sap.ui.mdc.d.ts +426 -204
  45. package/types/sap.ui.richtexteditor.d.ts +1 -1
  46. package/types/sap.ui.rta.d.ts +1 -1
  47. package/types/sap.ui.suite.d.ts +1 -1
  48. package/types/sap.ui.support.d.ts +1 -1
  49. package/types/sap.ui.table.d.ts +94 -23
  50. package/types/sap.ui.testrecorder.d.ts +1 -1
  51. package/types/sap.ui.unified.d.ts +601 -1
  52. package/types/sap.ui.ux3.d.ts +1 -1
  53. package/types/sap.ui.vbm.d.ts +1 -1
  54. package/types/sap.ui.vk.d.ts +47 -22
  55. package/types/sap.ui.vtm.d.ts +1 -1
  56. package/types/sap.ui.webc.common.d.ts +1 -1
  57. package/types/sap.ui.webc.fiori.d.ts +1 -1
  58. package/types/sap.ui.webc.main.d.ts +1 -1
  59. package/types/sap.uiext.inbox.d.ts +1 -1
  60. package/types/sap.ushell.d.ts +16 -8
  61. package/types/sap.ushell_abap.d.ts +1 -1
  62. package/types/sap.uxap.d.ts +46 -1
  63. package/types/sap.viz.d.ts +1 -1
  64. package/types/sap.webanalytics.core.d.ts +1 -1
  65. package/types/sap.zen.commons.d.ts +1 -1
  66. package/types/sap.zen.crosstab.d.ts +1 -1
  67. package/types/sap.zen.dsh.d.ts +1 -1
@@ -1,4 +1,4 @@
1
- // For Library Version: 1.127.0
1
+ // For Library Version: 1.128.0
2
2
 
3
3
  declare module "sap/ui/mdc/AggregationBaseDelegate" {
4
4
  import BaseDelegate from "sap/ui/mdc/BaseDelegate";
@@ -215,6 +215,11 @@ declare module "sap/ui/mdc/ChartDelegate" {
215
215
  * **Note:** The result of this function must be kept stable throughout the lifecycle of your application.
216
216
  * Any changes of the returned values might result in undesired effects.
217
217
  *
218
+ * **Note**: Existing properties (set via `sap.ui.mdc.Chart#setPropertyInfo`) must not be removed and their
219
+ * attributes must not be changed during the {@link module:sap/ui/mdc/ChartDelegate.fetchProperties fetchProperties }
220
+ * callback. Otherwise validation errors might occur whenever personalization-related control features (such
221
+ * as the opening of any personalization dialog) are activated.
222
+ *
218
223
  *
219
224
  * @returns Array of the property infos that is used within the chart
220
225
  */
@@ -757,7 +762,7 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
757
762
  * @since 1.124.0
758
763
  * @ui5-protected Do not call from applications (only from related classes in the framework)
759
764
  *
760
- * @returns Array containing the created controls
765
+ * @returns Array containing the created controls and the default value help, if needed
761
766
  */
762
767
  createContent(
763
768
  /**
@@ -773,8 +778,12 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
773
778
  /**
774
779
  * ID of the internal control to be created.
775
780
  */
776
- sId: string
777
- ): Promise<sap.ui.core.Control[]>;
781
+ sId: string,
782
+ /**
783
+ * If set, a default value help should be provided.
784
+ */
785
+ bProvideDefaultValueHelp: boolean
786
+ ): Promise<sap.ui.core.Element[]>;
778
787
  /**
779
788
  * Determines the text for the autocomplete functionality.
780
789
  *
@@ -850,7 +859,7 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
850
859
  */
851
860
  oField: sap.ui.mdc.field.FieldBase,
852
861
  /**
853
- * Field help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
862
+ * Value help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
854
863
  * or {@link sap.ui.mdc.MultiValueField MultiValueField} control
855
864
  */
856
865
  oValueHelp: sap.ui.mdc.ValueHelp,
@@ -872,13 +881,13 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
872
881
  */
873
882
  oBindingContext: sap.ui.model.Context,
874
883
  /**
875
- * `ConditionModel`, if bound to one - NO LONGER USED
884
+ * NO LONGER USED
876
885
  */
877
- oConditionModel: undefined,
886
+ oDoNotUse: undefined,
878
887
  /**
879
- * Name of the `ConditionModel`, if bound to one - NO LONGER USED
888
+ * NO LONGER USED
880
889
  */
881
- sConditionModelName: undefined,
890
+ sDoNotUse: undefined,
882
891
  /**
883
892
  * Additional context information for this key
884
893
  */
@@ -893,8 +902,8 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
893
902
  oType: sap.ui.model.Type
894
903
  ):
895
904
  | string
896
- | /* was: sap.ui.mdc.valuehelp.ValueHelpItem */ any
897
- | Promise<string | /* was: sap.ui.mdc.valuehelp.ValueHelpItem */ any>;
905
+ | sap.ui.mdc.valuehelp.base.ValueHelpItem
906
+ | Promise<string | sap.ui.mdc.valuehelp.base.ValueHelpItem>;
898
907
  /**
899
908
  * Determines the description for a given key.
900
909
  * By default, this method calls the {@link sap.ui.mdc.ValueHelp#getItemForValue getItemForValue} function
@@ -921,7 +930,7 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
921
930
  */
922
931
  oField: sap.ui.mdc.field.FieldBase,
923
932
  /**
924
- * Field help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
933
+ * Value help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
925
934
  * or {@link sap.ui.mdc.MultiValueField MultiValueField} control
926
935
  */
927
936
  oValueHelp: sap.ui.mdc.ValueHelp,
@@ -943,9 +952,9 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
943
952
  */
944
953
  oBindingContext: sap.ui.model.Context,
945
954
  /**
946
- * `ConditionModel`, if bound to one - NO LONGER USED
955
+ * NO LONGER USED
947
956
  */
948
- oConditionModel: undefined,
957
+ oDoNotUse: undefined,
949
958
  /**
950
959
  * Additional context information for this key
951
960
  */
@@ -960,8 +969,8 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
960
969
  oType: sap.ui.model.Type
961
970
  ):
962
971
  | string
963
- | /* was: sap.ui.mdc.valuehelp.ValueHelpItem */ any
964
- | Promise<string | /* was: sap.ui.mdc.valuehelp.ValueHelpItem */ any>;
972
+ | sap.ui.mdc.valuehelp.base.ValueHelpItem
973
+ | Promise<string | sap.ui.mdc.valuehelp.base.ValueHelpItem>;
965
974
  /**
966
975
  * Determines the description for a given key.
967
976
  * By default, this method calls the {@link sap.ui.mdc.ValueHelp#getItemForValue getItemForValue} function
@@ -988,7 +997,7 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
988
997
  */
989
998
  oField: sap.ui.mdc.field.FieldBase,
990
999
  /**
991
- * Field help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
1000
+ * Value help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
992
1001
  * or {@link sap.ui.mdc.MultiValueField MultiValueField} control
993
1002
  */
994
1003
  oValueHelp: sap.ui.mdc.ValueHelp,
@@ -1010,9 +1019,9 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
1010
1019
  */
1011
1020
  oBindingContext: sap.ui.model.Context,
1012
1021
  /**
1013
- * Name of the `ConditionModel`, if bound to one - NO LONGER USED
1022
+ * NO LONGER USED
1014
1023
  */
1015
- sConditionModelName: undefined,
1024
+ sDoNotUse: undefined,
1016
1025
  /**
1017
1026
  * Additional context information for this key
1018
1027
  */
@@ -1027,8 +1036,8 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
1027
1036
  oType: sap.ui.model.Type
1028
1037
  ):
1029
1038
  | string
1030
- | /* was: sap.ui.mdc.valuehelp.ValueHelpItem */ any
1031
- | Promise<string | /* was: sap.ui.mdc.valuehelp.ValueHelpItem */ any>;
1039
+ | sap.ui.mdc.valuehelp.base.ValueHelpItem
1040
+ | Promise<string | sap.ui.mdc.valuehelp.base.ValueHelpItem>;
1032
1041
  /**
1033
1042
  * Determines the description for a given key.
1034
1043
  * By default, this method calls the {@link sap.ui.mdc.ValueHelp#getItemForValue getItemForValue} function
@@ -1055,7 +1064,7 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
1055
1064
  */
1056
1065
  oField: sap.ui.mdc.field.FieldBase,
1057
1066
  /**
1058
- * Field help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
1067
+ * Value help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
1059
1068
  * or {@link sap.ui.mdc.MultiValueField MultiValueField} control
1060
1069
  */
1061
1070
  oValueHelp: sap.ui.mdc.ValueHelp,
@@ -1090,8 +1099,8 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
1090
1099
  oType: sap.ui.model.Type
1091
1100
  ):
1092
1101
  | string
1093
- | /* was: sap.ui.mdc.valuehelp.ValueHelpItem */ any
1094
- | Promise<string | /* was: sap.ui.mdc.valuehelp.ValueHelpItem */ any>;
1102
+ | sap.ui.mdc.valuehelp.base.ValueHelpItem
1103
+ | Promise<string | sap.ui.mdc.valuehelp.base.ValueHelpItem>;
1095
1104
  /**
1096
1105
  * Determines the key, description, and payload of a user input.
1097
1106
  * By default, this method calls the {@link sap.ui.mdc.ValueHelp#getItemForValue getItemForValue} function
@@ -1112,7 +1121,7 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
1112
1121
  */
1113
1122
  oField: sap.ui.mdc.field.FieldBase,
1114
1123
  /**
1115
- * Field help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
1124
+ * Value help assigned to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField},
1116
1125
  * or {@link sap.ui.mdc.MultiValueField MultiValueField} control
1117
1126
  */
1118
1127
  oValueHelp: sap.ui.mdc.ValueHelp,
@@ -1120,9 +1129,39 @@ declare module "sap/ui/mdc/field/FieldBaseDelegate" {
1120
1129
  * Configuration
1121
1130
  */
1122
1131
  oConfig?: sap.ui.mdc.valuehelp.base.ItemForValueConfiguration
1123
- ): /* was: sap.ui.mdc.valuehelp.ValueHelpItem */
1124
- | any
1125
- | Promise</* was: sap.ui.mdc.valuehelp.ValueHelpItem */ any>;
1132
+ ):
1133
+ | sap.ui.mdc.valuehelp.base.ValueHelpItem
1134
+ | Promise<sap.ui.mdc.valuehelp.base.ValueHelpItem>;
1135
+ /**
1136
+ * Returns the index of a condition in an array of conditions.
1137
+ *
1138
+ * This function is called when a `Condition` is created by user input or value help selection to determine
1139
+ * if a similar `Condition` already exists. This is done to prevent duplicates.
1140
+ *
1141
+ * By default, if a `ValueHelp` exists, the `ValueHelp` logic is used to compare each condition. (See {@link module:sap/ui/mdc/ValueHelpDelegate.compareConditions ValueHelpDelegate.compareConditions})
1142
+ *
1143
+ * @ui5-protected Do not call from applications (only from related classes in the framework)
1144
+ *
1145
+ * @returns Index of the condition, -1 if not found
1146
+ */
1147
+ indexOfCondition(
1148
+ /**
1149
+ * `Field` control instance
1150
+ */
1151
+ oField: sap.ui.mdc.field.FieldBase,
1152
+ /**
1153
+ * Value help assigned to the `Field` or `FilterField` control
1154
+ */
1155
+ oValueHelp: sap.ui.mdc.ValueHelp,
1156
+ /**
1157
+ * Condition to check
1158
+ */
1159
+ oCondition: sap.ui.mdc.condition.ConditionObject,
1160
+ /**
1161
+ * Array of conditions
1162
+ */
1163
+ aConditions: sap.ui.mdc.condition.ConditionObject[]
1164
+ ): int;
1126
1165
  /**
1127
1166
  * Checks if entered text matches text found from value help
1128
1167
  *
@@ -1342,6 +1381,11 @@ declare module "sap/ui/mdc/FilterBarDelegate" {
1342
1381
  * **Note:** The result of this function must be kept stable throughout the lifecycle of your application.
1343
1382
  * Any changes of the returned values might result in undesired effects.
1344
1383
  *
1384
+ * **Note**: Existing properties (set via `sap.ui.mdc.filterbar.FilterBarBase#setPropertyInfo`) must not
1385
+ * be removed and their attributes must not be changed during the {@link module:sap/ui/mdc/FilterBarDelegate.fetchProperties fetchProperties }
1386
+ * callback. Otherwise validation errors might occur whenever personalization-related control features (such
1387
+ * as the opening of any personalization dialog) are activated.
1388
+ *
1345
1389
  *
1346
1390
  * @returns `Promise` that resolves into an array of property info objects
1347
1391
  */
@@ -1479,11 +1523,7 @@ declare module "sap/ui/mdc/LinkDelegate" {
1479
1523
  /**
1480
1524
  * Binding context of the `Link` control
1481
1525
  */
1482
- oBindingContext: sap.ui.model.Context | null | undefined,
1483
- /**
1484
- * InfoLog of the `Link` control
1485
- */
1486
- oInfoLog: /* was: sap.ui.mdc.link.Log */ any
1526
+ oBindingContext: sap.ui.model.Context | null | undefined
1487
1527
  ): Promise<null | sap.ui.mdc.link.LinkItem[]>;
1488
1528
  /**
1489
1529
  * Calculates and returns the type of link that is displayed.
@@ -1686,9 +1726,9 @@ declare module "sap/ui/mdc/odata/v4/TableDelegate" {
1686
1726
  */
1687
1727
  getInResultPropertyKeys(
1688
1728
  /**
1689
- * of the table
1729
+ * Instance of the table
1690
1730
  */
1691
- Instance: sap.ui.mdc.Table
1731
+ oTable: sap.ui.mdc.Table
1692
1732
  ): string[];
1693
1733
  /**
1694
1734
  * Updates the binding of the table with the binding info object returned from {@link module:sap/ui/mdc/TableDelegate.updateBindingInfo updateBindingInfo}.
@@ -1875,6 +1915,11 @@ declare module "sap/ui/mdc/TableDelegate" {
1875
1915
  * **Note:** The result of this function must be kept stable throughout the lifecycle of your application.
1876
1916
  * Any changes of the returned values might result in undesired effects.
1877
1917
  *
1918
+ * **Note**: Existing properties (set via `sap.ui.mdc.Table#setPropertyInfo`) must not be removed and their
1919
+ * attributes must not be changed during the {@link module:sap/ui/mdc/TableDelegate.fetchProperties fetchProperties }
1920
+ * callback. Otherwise validation errors might occur whenever personalization-related control features (such
1921
+ * as the opening of any personalization dialog) are activated.
1922
+ *
1878
1923
  * @ui5-protected Do not call from applications (only from related classes in the framework)
1879
1924
  *
1880
1925
  * @returns A `Promise` that resolves with the property information
@@ -2442,8 +2487,9 @@ declare module "sap/ui/mdc/ValueHelpDelegate" {
2442
2487
  /**
2443
2488
  * Returns filters that are used when updating the binding of the `ValueHelp`.
2444
2489
  * By default, this method returns a set of {@link sap.ui.model.Filter Filters} originating from an available
2445
- * {@link sap.ui.mdc.FilterBar FilterBar}, the delegate's own {@link #getFilterConditions}, and/or the {@link sap.ui.mdc.valuehelp.base.FilterableListContent#getFilterFields filterFields }
2446
- * configuration of the given {@link sap.ui.mdc.valuehelp.base.FilterableListContent FilterableListContent}.
2490
+ * {@link sap.ui.mdc.FilterBar FilterBar}, the delegate's own {@link module:sap/ui/mdc/ValueHelpDelegate.getFilterConditions getFilterConditions},
2491
+ * and/or the {@link sap.ui.mdc.valuehelp.base.FilterableListContent#getFilterFields filterFields} configuration
2492
+ * of the given {@link sap.ui.mdc.valuehelp.base.FilterableListContent FilterableListContent}.
2447
2493
  *
2448
2494
  * @since 1.121
2449
2495
  * @ui5-protected Do not call from applications (only from related classes in the framework)
@@ -2467,14 +2513,15 @@ declare module "sap/ui/mdc/ValueHelpDelegate" {
2467
2513
  * By default, this method searches and returns an entry from a set of relevant contexts of the given {@link sap.ui.mdc.valuehelp.base.ListContent ListContent}.
2468
2514
  *
2469
2515
  * To determine which columns are relevant for the search, the currently active displayMode {@link sap.ui.mdc.enums.FieldDisplay Display }
2470
- * of the connected control will be used. While a 'Value' configuration will lead to a 'key'-only search,
2471
- * 'DescriptionValue' leads to searching 'description' first and 'key' afterwards. Other modes work accordingly.
2516
+ * of the connected control will be used. While a `Value` configuration will lead to a 'key'-only search,
2517
+ * `DescriptionValue` leads to searching the description first and the key afterwards. Other modes work
2518
+ * the same way.
2472
2519
  *
2473
2520
  * For each relevant column all items are searched for an exact match first and again with a startsWith
2474
2521
  * filter afterwards, if necessary.
2475
2522
  *
2476
- * If the caseSensitive property is disabled, the letter case of the user's input and the corresponding
2477
- * column value are completely ignored. Whichever entry comes first, wins.
2523
+ * If the `caseSensitive` property is disabled, whichever entry comes first, wins, whether the user's input
2524
+ * is in lowercase or uppercase letters.
2478
2525
  *
2479
2526
  * {@link sap.ui.mdc.valuehelp.base.ListContent ListContent}
2480
2527
  *
@@ -2554,9 +2601,9 @@ declare module "sap/ui/mdc/ValueHelpDelegate" {
2554
2601
  ): boolean;
2555
2602
  /**
2556
2603
  * Determines is the filtering used for type-ahead is case sensitive.
2557
- * By default the value of the {@link sap.ui.mdc.base.ListContent#getCaseSensitive CaseSensitive} property
2558
- * of the content instance is returned. If `$search` or other methods are used this might depend on the
2559
- * backend logic.
2604
+ * By default the value of the {@link sap.ui.mdc.valuehelp.base.ListContent#getCaseSensitive CaseSensitive }
2605
+ * property of the content instance is returned. If `$search` or other methods are used this might depend
2606
+ * on the backend logic.
2560
2607
  *
2561
2608
  * @since 1.121.0
2562
2609
  *
@@ -2600,7 +2647,7 @@ declare module "sap/ui/mdc/ValueHelpDelegate" {
2600
2647
  *
2601
2648
  * @since 1.101.0
2602
2649
  *
2603
- * @returns oRestult Selection event configuration object
2650
+ * @returns oResult Selection event configuration object
2604
2651
  */
2605
2652
  modifySelectionBehaviour(
2606
2653
  /**
@@ -2618,11 +2665,13 @@ declare module "sap/ui/mdc/ValueHelpDelegate" {
2618
2665
  /**
2619
2666
  * Type of the selection change (add, remove)
2620
2667
  */
2621
- type: /* was: sap.ui.mdc.enums.ValueHelpSelectionType */ any;
2668
+ type:
2669
+ | sap.ui.mdc.enums.ValueHelpSelectionType
2670
+ | keyof typeof sap.ui.mdc.enums.ValueHelpSelectionType;
2622
2671
  /**
2623
- * Array of changed conditions with structure {@link sap.ui.mdc.condition.ConditionObject ConditionObject}
2672
+ * Array of changed conditions
2624
2673
  */
2625
- conditions: object[];
2674
+ conditions: sap.ui.mdc.condition.ConditionObject[];
2626
2675
  }
2627
2676
  ): object;
2628
2677
  /**
@@ -3832,9 +3881,9 @@ declare namespace sap {
3832
3881
  */
3833
3882
  unitPath?: object;
3834
3883
  /**
3835
- * The timeUnit type for a TimeDimension
3884
+ * The `timeUnitType` type for a `TimeDimension`. If set, a `TimeDimension` is created instead of a `Dimension`
3836
3885
  */
3837
- timeUnitType?: object;
3886
+ timeUnitType?: string;
3838
3887
  };
3839
3888
 
3840
3889
  /**
@@ -3870,15 +3919,13 @@ declare namespace sap {
3870
3919
  };
3871
3920
  }
3872
3921
  /**
3873
- * Modules to handle conditions used in {@link sap.ui.mdc.FilterField FilterField}, {@link sap.ui.mdc.FilterBar FilterBar},
3874
- * or {@link sap.ui.mdc.condition.ConditionModel ConditionModel}.
3922
+ * Modules to handle conditions used in {@link sap.ui.mdc.FilterField FilterField} or {@link sap.ui.mdc.FilterBar FilterBar}.
3875
3923
  *
3876
3924
  * @since 1.61.0
3877
3925
  */
3878
3926
  namespace condition {
3879
3927
  /**
3880
- * Utilities to create conditions to be used in {@link sap.ui.mdc.FilterField FilterField}, {@link sap.ui.mdc.FilterBar FilterBar},
3881
- * or {@link sap.ui.mdc.condition.ConditionModel ConditionModel}.
3928
+ * Utilities to create conditions to be used in {@link sap.ui.mdc.FilterField FilterField} or {@link sap.ui.mdc.FilterBar FilterBar}.
3882
3929
  *
3883
3930
  * @since 1.61.0
3884
3931
  */
@@ -3907,7 +3954,7 @@ declare namespace sap {
3907
3954
  */
3908
3955
  oOutParameters: object,
3909
3956
  /**
3910
- * If set to `ConditionValidated.Validated`, the condition is validated (by the field help) and not shown
3957
+ * If set to `ConditionValidated.Validated`, the condition is validated (by the value help) and not shown
3911
3958
  * in the {@link sap.ui.mdc.valuehelp.content.Conditions Conditions} content
3912
3959
  */
3913
3960
  sValidated: sap.ui.mdc.enums.ConditionValidated,
@@ -3936,7 +3983,7 @@ declare namespace sap {
3936
3983
  */
3937
3984
  oInParameters: object,
3938
3985
  /**
3939
- * If set to `ConditionValidated.Validated`, the condition is validated (by the field help) and not shown
3986
+ * If set to `ConditionValidated.Validated`, the condition is validated (by the value help) and not shown
3940
3987
  * in the {@link sap.ui.mdc.valuehelp.content.Conditions Conditions} content
3941
3988
  */
3942
3989
  sValidated: sap.ui.mdc.enums.ConditionValidated,
@@ -3965,7 +4012,7 @@ declare namespace sap {
3965
4012
  */
3966
4013
  oOutParameters: object,
3967
4014
  /**
3968
- * If set to `ConditionValidated.Validated`, the condition is validated (by the field help) and not shown
4015
+ * If set to `ConditionValidated.Validated`, the condition is validated (by the value help) and not shown
3969
4016
  * in the {@link sap.ui.mdc.valuehelp.content.Conditions Conditions} content
3970
4017
  */
3971
4018
  sValidated: sap.ui.mdc.enums.ConditionValidated,
@@ -3990,7 +4037,7 @@ declare namespace sap {
3990
4037
  */
3991
4038
  aValues: any[],
3992
4039
  /**
3993
- * If set to `ConditionValidated.Validated`, the condition is validated (by the field help) and not shown
4040
+ * If set to `ConditionValidated.Validated`, the condition is validated (by the value help) and not shown
3994
4041
  * in the {@link sap.ui.mdc.valuehelp.content.Conditions Conditions} content
3995
4042
  */
3996
4043
  sValidated: sap.ui.mdc.enums.ConditionValidated,
@@ -4010,9 +4057,9 @@ declare namespace sap {
4010
4057
  */
4011
4058
  createItemCondition(
4012
4059
  /**
4013
- * Operator for the condition
4060
+ * Key value for the condition
4014
4061
  */
4015
- sKey: string,
4062
+ vKey: any,
4016
4063
  /**
4017
4064
  * Description of the operator
4018
4065
  */
@@ -4147,15 +4194,18 @@ declare namespace sap {
4147
4194
  ): void;
4148
4195
  /**
4149
4196
  * Removes all given operators from the list of known operators.
4197
+ *
4198
+ * **Note**: `aOperators` can be the name of an {@link sap.ui.mdc.condition.Operator Operator}, the instance
4199
+ * itself, or multiple operators inside an array.
4150
4200
  */
4151
4201
  removeOperators(
4152
4202
  /**
4153
4203
  * Array of operators
4154
- *
4155
- * **Note**: `aOperators` can be the name of an {@link sap.ui.mdc.condition.Operator Operator}, the instance
4156
- * itself, or multiple operators inside an array.
4157
4204
  */
4158
- aOperators: sap.ui.mdc.condition.Operator[]
4205
+ aOperators:
4206
+ | sap.ui.mdc.condition.Operator[]
4207
+ | sap.ui.mdc.condition.Operator
4208
+ | string[]
4159
4209
  ): void;
4160
4210
  /**
4161
4211
  * Sets the default operator for the list of operators for a type.
@@ -4174,6 +4224,11 @@ declare namespace sap {
4174
4224
  ): void;
4175
4225
  /**
4176
4226
  * Adds operators to the list of valid operators for a type.
4227
+ *
4228
+ * **Note**: `aOperators` can be the name of an {@link sap.ui.mdc.condition.Operator Operator}, the instance
4229
+ * itself, or multiple operators inside an array.
4230
+ *
4231
+ * **Note**: `vDefaultOperator` must exist as a valid operator for the type.
4177
4232
  */
4178
4233
  setOperatorsForType(
4179
4234
  /**
@@ -4183,13 +4238,12 @@ declare namespace sap {
4183
4238
  /**
4184
4239
  * Operators
4185
4240
  */
4186
- aOperators: sap.ui.mdc.condition.Operator[],
4241
+ aOperators:
4242
+ | sap.ui.mdc.condition.Operator[]
4243
+ | sap.ui.mdc.condition.Operator
4244
+ | string[],
4187
4245
  /**
4188
4246
  * The default operator instance or default operator name
4189
- *
4190
- * **Note**: `aOperators` can be the name of an {@link sap.ui.mdc.condition.Operator Operator}, the instance
4191
- * itself, or multiple operators inside an array. **Note**: `vDefaultOperator` must exist as a valid operator
4192
- * for the type.
4193
4247
  */
4194
4248
  vDefaultOperator: sap.ui.mdc.condition.Operator | string
4195
4249
  ): void;
@@ -4214,7 +4268,8 @@ declare namespace sap {
4214
4268
  */
4215
4269
  name: string;
4216
4270
  /**
4217
- * Alias names based on `BaseType`, used to map to `DynamicDateOption` if `DynamicDateRange` is used
4271
+ * Alias names based on {@link sap.ui.mdc.enums.BaseType BaseType}, used to map to {@link sap.m.DynamicDateOption DynamicDateOption }
4272
+ * if {@link sap.m.DynamicDateRange DynamicDateRange} is used to visualize the filter
4218
4273
  */
4219
4274
  alias?: object;
4220
4275
  /**
@@ -4264,16 +4319,26 @@ declare namespace sap {
4264
4319
  paramTypes?: string[];
4265
4320
  /**
4266
4321
  * String representation of the operator as a long text.
4267
- * If longText is not given , it is looked up in the resource bundle of the `sap.ui.mdc` library by the
4268
- * key `operators.{oConfiguration.name}.longText`
4322
+ * This text is shown in the operator dropdown of the value help.
4323
+ * If `longText` is not given , the `tokenText` is used, replacing the placeholders "{0}" and "{1}" with
4324
+ * "X" and "Y".
4269
4325
  */
4270
4326
  longText?: string;
4271
4327
  /**
4272
4328
  * String representation of the operator as a short text.
4273
- * If the token text is not given, it is looked up in the resource bundle of the `sap.ui.mdc` library by
4274
- * the key `operators.{oConfiguration.name}.tokenText`
4329
+ * This text is only needed if there any language dependent text should be shown on the token, like "Next
4330
+ * 5 days". (In this case `#tokenText#` is used in `tokenFormat`, `tokenTest`, or `tokenParse`.) For operators
4331
+ * just showing the value and a operator symbol, no token text is needed.
4332
+ * If the token text is not given, the `longText` is used.
4275
4333
  */
4276
4334
  tokenText?: string;
4335
+ /**
4336
+ * Object holding String representation of the operator as a long text for single basic types.
4337
+ * This text is shown in the operator dropdown of the value help.
4338
+ * This is needed if the text depends on the used data type. For example the "less than" operator should
4339
+ * be named "before" if a date or time type is used.
4340
+ */
4341
+ longTextForTypes?: object;
4277
4342
  /**
4278
4343
  * Pattern how different {@link sap.ui.mdc.enums.FieldDisplay displayFormats} are rendered
4279
4344
  */
@@ -4319,7 +4384,7 @@ declare namespace sap {
4319
4384
  */
4320
4385
  exclude?: boolean;
4321
4386
  /**
4322
- * If set, the user input for this operator needs to be validated using a field help
4387
+ * If set, the user input for this operator needs to be validated using a value help
4323
4388
  */
4324
4389
  validateInput?: boolean;
4325
4390
  /**
@@ -4333,7 +4398,24 @@ declare namespace sap {
4333
4398
  */
4334
4399
  group?: {
4335
4400
  /**
4336
- * Group ID for the operator.
4401
+ * Group ID for the operator. The following groups are available for the {@link sap.m.DynamicDateRange DynamicDateRange }
4402
+ * control:
4403
+ *
4404
+ * - 1 - Single Dates
4405
+ * - 2 - Date Ranges
4406
+ * - 3 - Weeks
4407
+ * - 4 - Months
4408
+ * - 5 - Quarters
4409
+ * - 6 - Years See {@link sap.m.DynamicDateRangeGroups DynamicDateRangeGroups}.
4410
+ * This only works for `FilterFields` with custom operators if `maxConditions=1` and no `valueHelp` is
4411
+ * assigned to the `FilterField`. Example:
4412
+ * group: undefined - if group is not specified; default behavior include/exclude group with id 1 and 2
4413
+ * will be created
4414
+ * group: {id : 1} - adds the operator to existing group 1 'Single Dates'
4415
+ * group: {id : 2, text: "new group"} - inserts a new group with id 2. Existing group 2 will be shifted
4416
+ * to 3, 4....
4417
+ * group: {id : 10, text: "new group at the end"} - adds a new group with id 10 and text "new group as
4418
+ * the end" to the end of all groups
4337
4419
  */
4338
4420
  id: string;
4339
4421
  /**
@@ -4342,24 +4424,7 @@ declare namespace sap {
4342
4424
  text?: string;
4343
4425
  };
4344
4426
  /**
4345
- * Function to determine the text copied into clipboard The following groups are available for the `DynamicDateRange`
4346
- * control:
4347
- *
4348
- * - 1 - Single Dates
4349
- * - 2 - Date Ranges
4350
- * - 3 - Weeks
4351
- * - 4 - Months
4352
- * - 5 - Quarters
4353
- * - 6 - Years See {@link sap.m.DynamicDateRangeGroups DynamicDateRangeGroups}.
4354
- * This only works for `FilterFields` with custom operators if `maxConditions=1` and no `valueHelp` is
4355
- * assigned to the `FilterField`. Example:
4356
- * group: undefined - if group is not specified; default behavior include/exclude group with id 1 and 2
4357
- * will be created
4358
- * group: {id : 1} - adds the operator to existing group 1 'Single Dates'
4359
- * group: {id : 2, text: "new group"} - inserts a new group with id 2. Existing group 2 will be shifted
4360
- * to 3, 4....
4361
- * group: {id : 10, text: "new group at the end"} - adds a new group with id 10 and text "new group as
4362
- * the end" to the end of all groups
4427
+ * Function to determine the text copied into clipboard
4363
4428
  */
4364
4429
  getTextForCopy?: Function;
4365
4430
  }
@@ -4426,21 +4491,21 @@ declare namespace sap {
4426
4491
  class RangeOperator extends sap.ui.mdc.condition.Operator {
4427
4492
  constructor(
4428
4493
  /**
4429
- * Included all parameters of {@link sap.ui.mdc.condition.Operator Operator} and adds some special ones
4494
+ * Includes all parameters of {@link sap.ui.mdc.condition.Operator Operator} and adds some special ones
4430
4495
  */
4431
4496
  oConfiguration: {
4432
4497
  /**
4433
- * additional array of labels for the values of the operator. Will be shown as placeholder text or label
4434
- * on the value fields.
4498
+ * Additional array of labels for the values of the operator. Will be shown as placeholder text or label
4499
+ * of the value fields.
4435
4500
  */
4436
- label?: string;
4501
+ label?: string[];
4437
4502
  /**
4438
- * function to calculate the date range of the operation. The function returns an array of UniversalDates.
4503
+ * Function to calculate the date range of the operation. The function returns an array of `UniversalDates`.
4439
4504
  * In case of a single `filterOperator` the array can return a single value.
4440
4505
  */
4441
4506
  calcRange: Function;
4442
4507
  /**
4443
- * function to format the date range.
4508
+ * Function to format the date range.
4444
4509
  */
4445
4510
  formatRange?: Function;
4446
4511
  /**
@@ -4494,7 +4559,7 @@ declare namespace sap {
4494
4559
  operator: string;
4495
4560
  /**
4496
4561
  * Array of values of the condition. Depending on the `operator`, this contains one or more entries. The
4497
- * entries are sored in internal format regarding the used data type.
4562
+ * entries are stored in an internal format regarding the used data type.
4498
4563
  */
4499
4564
  values: any[];
4500
4565
  /**
@@ -4674,7 +4739,41 @@ declare namespace sap {
4674
4739
  *
4675
4740
  * @since 1.115
4676
4741
  */
4677
- enum ContentMode {}
4742
+ enum ContentMode {
4743
+ /**
4744
+ * Display mode for single value
4745
+ */
4746
+ Display = "Display",
4747
+ /**
4748
+ * Display mode for multiline single value
4749
+ */
4750
+ DisplayMultiLine = "DisplayMultiLine",
4751
+ /**
4752
+ * Display mode for multiple values
4753
+ */
4754
+ DisplayMultiValue = "DisplayMultiValue",
4755
+ /**
4756
+ * Edit mode for single value
4757
+ */
4758
+ Edit = "Edit",
4759
+ /**
4760
+ * Edit mode for single value field if a field help is assigned To support field help, in some cases a different
4761
+ * control needs to be rendered.
4762
+ */
4763
+ EditForHelp = "EditForHelp",
4764
+ /**
4765
+ * Edit mode for multiple lines single value
4766
+ */
4767
+ EditMultiLine = "EditMultiLine",
4768
+ /**
4769
+ * Edit mode for multiple values
4770
+ */
4771
+ EditMultiValue = "EditMultiValue",
4772
+ /**
4773
+ * Edit mode for operator dependent controls This is used for single value and only one operator.
4774
+ */
4775
+ EditOperator = "EditOperator",
4776
+ }
4678
4777
  /**
4679
4778
  * Defines the output of a {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.FilterField FilterField}, or
4680
4779
  * {@link sap.ui.mdc.MultiValueField MultiValueField} control.
@@ -5364,17 +5463,17 @@ declare namespace sap {
5364
5463
  YESTERDAY = "YESTERDAY",
5365
5464
  }
5366
5465
  /**
5367
- * Enumeration of the `OperatorOverwrite` in `Operator`.
5466
+ * Enumeration of the {@link sap.ui.mdc.condition.Operator#OperatorOverwrite OperatorOverwrite} in {@link sap.ui.mdc.condition.Operator Operator}.
5368
5467
  *
5369
5468
  * @since 1.115
5370
5469
  */
5371
5470
  enum OperatorOverwrite {
5372
5471
  /**
5373
- * Overwrite the `getTypeText` function of the operator.
5472
+ * Overwrites the `getLongText` function of the operator.
5374
5473
  */
5375
5474
  getLongText = "getLongText",
5376
5475
  /**
5377
- * Overwrite the `getModelFilter` function of the operator.
5476
+ * Overwrites the `getModelFilter` function of the operator.
5378
5477
  */
5379
5478
  getModelFilter = "getModelFilter",
5380
5479
  }
@@ -5398,6 +5497,29 @@ declare namespace sap {
5398
5497
  */
5399
5498
  Static = "static",
5400
5499
  }
5500
+ /**
5501
+ * Enumeration of the possible reasons for the search event.
5502
+ *
5503
+ * @since 1.115
5504
+ */
5505
+ enum ReasonMode {
5506
+ /**
5507
+ * Enter pressed in filter field.
5508
+ */
5509
+ Enter = "Enter",
5510
+ /**
5511
+ * Go button pressed.
5512
+ */
5513
+ Go = "Go",
5514
+ /**
5515
+ * Used if the mentioned reasons are not applicable.
5516
+ */
5517
+ Unclear = "",
5518
+ /**
5519
+ * The applied variant is marked as Apply Automatically.
5520
+ */
5521
+ Variant = "Variant",
5522
+ }
5401
5523
  /**
5402
5524
  * Growing mode of the table.
5403
5525
  *
@@ -5513,7 +5635,8 @@ declare namespace sap {
5513
5635
  Table = "Table",
5514
5636
  }
5515
5637
  /**
5516
- * Enumeration of the propagation reason in the condition propagation callback of the {@link sap.ui.mdc.ValueHelp ValueHelp}
5638
+ * Enumeration of the propagation reason in the {@link sap.ui.mdc.ValueHelpDelegate#onConditionPropagation condition propagation callback }
5639
+ * of the {@link sap.ui.mdc.ValueHelp ValueHelp}
5517
5640
  *
5518
5641
  * @since 1.115
5519
5642
  */
@@ -5531,6 +5654,25 @@ declare namespace sap {
5531
5654
  */
5532
5655
  Select = "Select",
5533
5656
  }
5657
+ /**
5658
+ * Enumeration of the possible selection types in {@link sap.ui.mdc.ValueHelp ValueHelp}
5659
+ *
5660
+ * @since 1.115
5661
+ */
5662
+ enum ValueHelpSelectionType {
5663
+ /**
5664
+ * The given conditions are just added to the existing ones, if they don't already exist.
5665
+ */
5666
+ Add = "Add",
5667
+ /**
5668
+ * The given conditions are removed.
5669
+ */
5670
+ Remove = "Remove",
5671
+ /**
5672
+ * The given conditions are set and replace the existing ones.
5673
+ */
5674
+ Set = "Set",
5675
+ }
5534
5676
  }
5535
5677
  /**
5536
5678
  * Modules for {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.MultiValueField MultiValueField}, and {@link sap.ui.mdc.FilterField FilterField}
@@ -5675,11 +5817,10 @@ declare namespace sap {
5675
5817
  /**
5676
5818
  * Sets the conditions that represent the values of the field.
5677
5819
  *
5678
- * These should be bound to a {@link sap.ui.mdc.condition.ConditionModel ConditionModel} using the corresponding
5679
- * `fieldPath`.
5820
+ * These should be bound to a {@link sap.ui.mdc.FilterBar FilterBar} using the corresponding `propertyPath`.
5680
5821
  *
5681
5822
  * **Note:** For {@link sap.ui.mdc.FilterField FilterField} controls, the `conditions` property must be
5682
- * used to bind {@link sap.ui.mdc.FilterField FilterField} to a {@link sap.ui.mdc.condition.ConditionModel ConditionModel}.
5823
+ * used to bind {@link sap.ui.mdc.FilterField FilterField} to a {@link @link sap.ui.mdc.FilterBar FilterBar}.
5683
5824
  * For example, for a {@link sap.ui.mdc.FilterField FilterField} control inside a {@link sap.ui.mdc.FilterBar FilterBar }
5684
5825
  * control, the binding looks like this:
5685
5826
  * `conditions="{$filters>/conditions/propertyPath}"` with the following data:
@@ -7074,11 +7215,10 @@ declare namespace sap {
7074
7215
  *
7075
7216
  * Sets the conditions that represent the values of the field.
7076
7217
  *
7077
- * These should be bound to a {@link sap.ui.mdc.condition.ConditionModel ConditionModel} using the corresponding
7078
- * `fieldPath`.
7218
+ * These should be bound to a {@link sap.ui.mdc.FilterBar FilterBar} using the corresponding `propertyPath`.
7079
7219
  *
7080
7220
  * **Note:** For {@link sap.ui.mdc.FilterField FilterField} controls, the `conditions` property must be
7081
- * used to bind {@link sap.ui.mdc.FilterField FilterField} to a {@link sap.ui.mdc.condition.ConditionModel ConditionModel}.
7221
+ * used to bind {@link sap.ui.mdc.FilterField FilterField} to a {@link @link sap.ui.mdc.FilterBar FilterBar}.
7082
7222
  * For example, for a {@link sap.ui.mdc.FilterField FilterField} control inside a {@link sap.ui.mdc.FilterBar FilterBar }
7083
7223
  * control, the binding looks like this:
7084
7224
  * `conditions="{$filters>/conditions/propertyPath}"` with the following data:
@@ -7620,11 +7760,10 @@ declare namespace sap {
7620
7760
  *
7621
7761
  * Sets the conditions that represent the values of the field.
7622
7762
  *
7623
- * These should be bound to a {@link sap.ui.mdc.condition.ConditionModel ConditionModel} using the corresponding
7624
- * `fieldPath`.
7763
+ * These should be bound to a {@link sap.ui.mdc.FilterBar FilterBar} using the corresponding `propertyPath`.
7625
7764
  *
7626
7765
  * **Note:** For {@link sap.ui.mdc.FilterField FilterField} controls, the `conditions` property must be
7627
- * used to bind {@link sap.ui.mdc.FilterField FilterField} to a {@link sap.ui.mdc.condition.ConditionModel ConditionModel}.
7766
+ * used to bind {@link sap.ui.mdc.FilterField FilterField} to a {@link @link sap.ui.mdc.FilterBar FilterBar}.
7628
7767
  * For example, for a {@link sap.ui.mdc.FilterField FilterField} control inside a {@link sap.ui.mdc.FilterBar FilterBar }
7629
7768
  * control, the binding looks like this:
7630
7769
  * `conditions="{$filters>/conditions/propertyPath}"` with the following data:
@@ -8722,7 +8861,10 @@ declare namespace sap {
8722
8861
  * **Note**: This property must not be bound.
8723
8862
  * **Note**: This property is used exclusively for SAPUI5 flexibility/ Fiori Elements. Do not use it otherwise.
8724
8863
  * **Node**: Please check {@link sap.ui.mdc.filterbar.PropertyInfo} for more information about the supported
8725
- * inner elements.
8864
+ * inner elements. **Note**: Existing properties (set via `sap.ui.mdc.filterbar.FilterBarBase#setPropertyInfo`)
8865
+ * must not be removed and their attributes must not be changed during the {@link module:sap/ui/mdc/FilterBarDelegate.fetchProperties fetchProperties }
8866
+ * callback. Otherwise validation errors might occur whenever personalization-related control features (such
8867
+ * as the opening of any personalization dialog) are activated.
8726
8868
  *
8727
8869
  * @since 1.97
8728
8870
  */
@@ -8816,7 +8958,7 @@ declare namespace sap {
8816
8958
  * - `{@link sap.ui.mdc.enums.ReasonMode.Go}`: Search is triggered based on pressing the Go button
8817
8959
  * - `{@link sap.ui.mdc.enums.ReasonMode.Unclear}`: Any other reasons for the search
8818
8960
  */
8819
- reason?: /* was: sap.ui.mdc.enums.ReasonMode */ any;
8961
+ reason?: sap.ui.mdc.enums.ReasonMode;
8820
8962
  }
8821
8963
 
8822
8964
  /**
@@ -9291,6 +9433,13 @@ declare namespace sap {
9291
9433
  */
9292
9434
  oDelegate?: object
9293
9435
  ): this;
9436
+ /**
9437
+ * Sets the focus on the first filter in error state.
9438
+ *
9439
+ *
9440
+ * @returns The first filter field in error state
9441
+ */
9442
+ setFocusOnFirstErroneousField(): sap.ui.mdc.FilterField | null;
9294
9443
  /**
9295
9444
  * Sets a new value for property {@link #getLiveMode liveMode}.
9296
9445
  *
@@ -9616,7 +9765,7 @@ declare namespace sap {
9616
9765
  */
9617
9766
  namespace valuehelp {
9618
9767
  /**
9619
- * Base-modules for {@link sap.ui.mdc.ValueHelp ValueHelp}
9768
+ * Base modules for {@link sap.ui.mdc.ValueHelp ValueHelp}
9620
9769
  *
9621
9770
  * These modules must not be used stand-alone.
9622
9771
  *
@@ -9691,7 +9840,7 @@ declare namespace sap {
9691
9840
  *
9692
9841
  * If it is empty, no suggestion is available.
9693
9842
  *
9694
- * @deprecated (since 1.120.2) - please see `{@link module:sap/ui/mdc/ValueHelpDelegate.isSearchSupported isSearchSupported}`
9843
+ * @deprecated (since 1.120.2) - replaced by {@link module:sap/ui/mdc/ValueHelpDelegate.isSearchSupported isSearchSupported}
9695
9844
  */
9696
9845
  filterFields?:
9697
9846
  | string
@@ -9843,7 +9992,7 @@ declare namespace sap {
9843
9992
  /**
9844
9993
  * Type of the selection change (add, remove)
9845
9994
  */
9846
- type?: /* was: sap.ui.mdc.enums.ValueHelpSelectionType */ any;
9995
+ type?: sap.ui.mdc.enums.ValueHelpSelectionType;
9847
9996
 
9848
9997
  /**
9849
9998
  * Changed conditions
@@ -9944,7 +10093,7 @@ declare namespace sap {
9944
10093
  /**
9945
10094
  * Type of the selection change (add, remove)
9946
10095
  */
9947
- type?: /* was: sap.ui.mdc.enums.ValueHelpSelectionType */ any;
10096
+ type?: sap.ui.mdc.enums.ValueHelpSelectionType;
9948
10097
 
9949
10098
  /**
9950
10099
  * Changed conditions
@@ -10929,7 +11078,7 @@ declare namespace sap {
10929
11078
  *
10930
11079
  * Default value is `empty string`.
10931
11080
  *
10932
- * @deprecated (since 1.120.2) - please see `{@link module:sap/ui/mdc/ValueHelpDelegate.isSearchSupported isSearchSupported}`
11081
+ * @deprecated (since 1.120.2) - replaced by {@link module:sap/ui/mdc/ValueHelpDelegate.isSearchSupported isSearchSupported}
10933
11082
  *
10934
11083
  * @returns Value of property `filterFields`
10935
11084
  */
@@ -10947,23 +11096,6 @@ declare namespace sap {
10947
11096
  * @returns Value of property `group`
10948
11097
  */
10949
11098
  getGroup(): string;
10950
- /**
10951
- * Gets an item for a `BindingContext`.
10952
- *
10953
- * @ui5-protected Do not call from applications (only from related classes in the framework)
10954
- *
10955
- * @returns Item object containing `key`, `description`, and `payload`
10956
- */
10957
- getItemFromContext(
10958
- /**
10959
- * BindingContext
10960
- */
10961
- oBindingContext: sap.ui.model.Context,
10962
- /**
10963
- * Options
10964
- */
10965
- oOptions?: object
10966
- ): object;
10967
11099
  /**
10968
11100
  * Gets current value of property {@link #getKeyPath keyPath}.
10969
11101
  *
@@ -11052,7 +11184,7 @@ declare namespace sap {
11052
11184
  *
11053
11185
  * Default value is `empty string`.
11054
11186
  *
11055
- * @deprecated (since 1.120.2) - please see `{@link module:sap/ui/mdc/ValueHelpDelegate.isSearchSupported isSearchSupported}`
11187
+ * @deprecated (since 1.120.2) - replaced by {@link module:sap/ui/mdc/ValueHelpDelegate.isSearchSupported isSearchSupported}
11056
11188
  *
11057
11189
  * @returns Reference to `this` in order to allow method chaining
11058
11190
  */
@@ -11199,6 +11331,23 @@ declare namespace sap {
11199
11331
  * @returns Content description path
11200
11332
  */
11201
11333
  getDescriptionPath(): string;
11334
+ /**
11335
+ * Gets an item for a `BindingContext`.
11336
+ *
11337
+ * @ui5-protected Do not call from applications (only from related classes in the framework)
11338
+ *
11339
+ * @returns Item object containing `key`, `description`, and `payload`
11340
+ */
11341
+ getItemFromContext(
11342
+ /**
11343
+ * BindingContext
11344
+ */
11345
+ oBindingContext: sap.ui.model.Context,
11346
+ /**
11347
+ * Options
11348
+ */
11349
+ oOptions?: object
11350
+ ): object;
11202
11351
  /**
11203
11352
  * Gets current keyPath of the content. **Note:** Every listcontent must implement this method.
11204
11353
  *
@@ -11372,6 +11521,25 @@ declare namespace sap {
11372
11521
  control: sap.ui.core.Control;
11373
11522
  };
11374
11523
 
11524
+ /**
11525
+ * Configuration object type for normalized definition of a `ValueHelpItem`.
11526
+ */
11527
+ type ValueHelpItem = {
11528
+ /**
11529
+ * Key
11530
+ */
11531
+ key: any;
11532
+ /**
11533
+ * Description
11534
+ */
11535
+ description?: any;
11536
+ /**
11537
+ * Payload of the condition. Set by application. Data needs to be stringified. (as stored and loaded in
11538
+ * variants)
11539
+ */
11540
+ payload?: object;
11541
+ };
11542
+
11375
11543
  /**
11376
11544
  * Event object of the Container#cancel event.
11377
11545
  */
@@ -11509,7 +11677,7 @@ declare namespace sap {
11509
11677
  >;
11510
11678
  }
11511
11679
  /**
11512
- * Content-modules that is used in {@link sap.ui.mdc.valueHelp.Popover Popover} or {@link sap.ui.mdc.valueHelp.Dialog Dialog}
11680
+ * Content modules that are used in {@link sap.ui.mdc.valuehelp.Popover Popover} or {@link sap.ui.mdc.valuehelp.Dialog Dialog}
11513
11681
  *
11514
11682
  * These modules must not be used stand-alone.
11515
11683
  *
@@ -11530,10 +11698,14 @@ declare namespace sap {
11530
11698
  * Optional `FieldHelp`.
11531
11699
  *
11532
11700
  * This is an association that allows the usage of one `FieldHelp` instance for the value fields for the
11533
- * `Conditions`. **Note:** The value fields on the conditions UI cannot be accessed from outside. The fields
11534
- * are single-value input, and the display is always set to `FieldDisplay.Value`. Only a `ValueHelp>/code>
11535
- * with a TypeAhead` and a single-selection `MTable` can be used. **Note:** For `Boolean`, `Date`,
11536
- * or `Time` types, no `FieldHelp` should be added, but a default `FieldHelp` used instead.
11701
+ * `Conditions`.
11702
+ *
11703
+ * **Note:** The value fields on the conditions UI cannot be accessed from outside. The fields are single-value
11704
+ * input, and the display is always set to `FieldDisplay.Value`. Only a `ValueHelp` with a `TypeAhead` and
11705
+ * a single-selection `MTable` can be used.
11706
+ *
11707
+ * **Note:** For `Boolean`, `Date`, or `Time` types, no `FieldHelp` should be added, but a default `FieldHelp`
11708
+ * used instead.
11537
11709
  *
11538
11710
  * @deprecated (since 1.114.0) - replaced by {@link #setValueHelp valueHelp} association
11539
11711
  */
@@ -11546,8 +11718,8 @@ declare namespace sap {
11546
11718
  * `Conditions`.
11547
11719
  *
11548
11720
  * **Note:** The value fields on the conditions UI cannot be accessed from outside. The fields are single-value
11549
- * input, and the display is always set to `FieldDisplay.Value`. Only a `ValueHelp>/code> with a TypeAhead`
11550
- * and a single-selection `MTable` can be used.
11721
+ * input, and the display is always set to `FieldDisplay.Value`. Only a `ValueHelp` with a `TypeAhead` and
11722
+ * a single-selection `MTable` can be used.
11551
11723
  *
11552
11724
  * **Note:** For `Boolean`, `Date`, or `Time` types, no `ValueHelp` should be added, but a default `ValueHelp`
11553
11725
  * used instead.
@@ -12554,7 +12726,7 @@ declare namespace sap {
12554
12726
  * Sample delegate object:
12555
12727
  * ```javascript
12556
12728
  * {
12557
- * name: "sap/ui/mdc/BaseDelegate",
12729
+ * name: "sap/ui/valuehelp/FilterBarDelegate",
12558
12730
  * payload: {}
12559
12731
  * }```
12560
12732
  * **Note:** Ensure that the related file can be requested (any required library has to be loaded before
@@ -12836,7 +13008,7 @@ declare namespace sap {
12836
13008
  * Sample delegate object:
12837
13009
  * ```javascript
12838
13010
  * {
12839
- * name: "sap/ui/mdc/BaseDelegate",
13011
+ * name: "sap/ui/valuehelp/FilterBarDelegate",
12840
13012
  * payload: {}
12841
13013
  * }```
12842
13014
  * **Note:** Ensure that the related file can be requested (any required library has to be loaded before
@@ -12883,7 +13055,7 @@ declare namespace sap {
12883
13055
  * Sample delegate object:
12884
13056
  * ```javascript
12885
13057
  * {
12886
- * name: "sap/ui/mdc/BaseDelegate",
13058
+ * name: "sap/ui/valuehelp/FilterBarDelegate",
12887
13059
  * payload: {}
12888
13060
  * }```
12889
13061
  * **Note:** Ensure that the related file can be requested (any required library has to be loaded before
@@ -13312,7 +13484,10 @@ declare namespace sap {
13312
13484
  /**
13313
13485
  * Defines the icon of the item.
13314
13486
  */
13315
- icon?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
13487
+ icon?:
13488
+ | sap.ui.core.URI
13489
+ | sap.ui.base.ManagedObject.PropertyBindingInfo
13490
+ | `{${string}}`;
13316
13491
 
13317
13492
  /**
13318
13493
  * Determines the initial visibility of the `LinkItem`. If set to `true`, the item will appear on the `Popover`
@@ -13421,7 +13596,7 @@ declare namespace sap {
13421
13596
  *
13422
13597
  * @returns Value of property `icon`
13423
13598
  */
13424
- getIcon(): string;
13599
+ getIcon(): sap.ui.core.URI;
13425
13600
  /**
13426
13601
  * Gets current value of property {@link #getInitiallyVisible initiallyVisible}.
13427
13602
  *
@@ -13527,7 +13702,7 @@ declare namespace sap {
13527
13702
  /**
13528
13703
  * New value for property `icon`
13529
13704
  */
13530
- sIcon: string
13705
+ sIcon: sap.ui.core.URI
13531
13706
  ): this;
13532
13707
  /**
13533
13708
  * Sets a new value for property {@link #getInitiallyVisible initiallyVisible}.
@@ -14184,6 +14359,23 @@ declare namespace sap {
14184
14359
  | int
14185
14360
  | sap.ui.base.ManagedObject.PropertyBindingInfo
14186
14361
  | `{${string}}`;
14362
+
14363
+ /**
14364
+ * Number of records to be requested from the model when the user scrolls through the table.
14365
+ *
14366
+ * The property defines how many additional (not yet visible) data records from the back-end system are
14367
+ * pre-fetched during scrolling. If the `scrollThreshold` is lower than the number of visible rows, the
14368
+ * number of visible rows is used as the `scrollThreshold`. If the value is 0, thresholding is disabled.
14369
+ *
14370
+ * **Note:** This property only takes effect if it is set to a positive integer value. Otherwise the `threshold`
14371
+ * property is used.
14372
+ *
14373
+ * @since 1.128
14374
+ */
14375
+ scrollThreshold?:
14376
+ | int
14377
+ | sap.ui.base.ManagedObject.PropertyBindingInfo
14378
+ | `{${string}}`;
14187
14379
  }
14188
14380
 
14189
14381
  /**
@@ -15708,6 +15900,25 @@ declare namespace sap {
15708
15900
  * @returns Value of property `rowCountMode`
15709
15901
  */
15710
15902
  getRowCountMode(): sap.ui.mdc.enums.TableRowCountMode;
15903
+ /**
15904
+ * Gets current value of property {@link #getScrollThreshold scrollThreshold}.
15905
+ *
15906
+ * Number of records to be requested from the model when the user scrolls through the table.
15907
+ *
15908
+ * The property defines how many additional (not yet visible) data records from the back-end system are
15909
+ * pre-fetched during scrolling. If the `scrollThreshold` is lower than the number of visible rows, the
15910
+ * number of visible rows is used as the `scrollThreshold`. If the value is 0, thresholding is disabled.
15911
+ *
15912
+ * **Note:** This property only takes effect if it is set to a positive integer value. Otherwise the `threshold`
15913
+ * property is used.
15914
+ *
15915
+ * Default value is `-1`.
15916
+ *
15917
+ * @since 1.128
15918
+ *
15919
+ * @returns Value of property `scrollThreshold`
15920
+ */
15921
+ getScrollThreshold(): int;
15711
15922
  /**
15712
15923
  * Gets current value of property {@link #getSelectionLimit selectionLimit}.
15713
15924
  *
@@ -15796,6 +16007,32 @@ declare namespace sap {
15796
16007
  */
15797
16008
  sRowCountMode?: sap.ui.mdc.enums.TableRowCountMode
15798
16009
  ): this;
16010
+ /**
16011
+ * Sets a new value for property {@link #getScrollThreshold scrollThreshold}.
16012
+ *
16013
+ * Number of records to be requested from the model when the user scrolls through the table.
16014
+ *
16015
+ * The property defines how many additional (not yet visible) data records from the back-end system are
16016
+ * pre-fetched during scrolling. If the `scrollThreshold` is lower than the number of visible rows, the
16017
+ * number of visible rows is used as the `scrollThreshold`. If the value is 0, thresholding is disabled.
16018
+ *
16019
+ * **Note:** This property only takes effect if it is set to a positive integer value. Otherwise the `threshold`
16020
+ * property is used.
16021
+ *
16022
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
16023
+ *
16024
+ * Default value is `-1`.
16025
+ *
16026
+ * @since 1.128
16027
+ *
16028
+ * @returns Reference to `this` in order to allow method chaining
16029
+ */
16030
+ setScrollThreshold(
16031
+ /**
16032
+ * New value for property `scrollThreshold`
16033
+ */
16034
+ iScrollThreshold?: int
16035
+ ): this;
15799
16036
  /**
15800
16037
  * Sets a new value for property {@link #getSelectionLimit selectionLimit}.
15801
16038
  *
@@ -17173,7 +17410,10 @@ declare namespace sap {
17173
17410
  * Specifies the chart metadata.
17174
17411
  * **Note:** This property must not be bound.
17175
17412
  * **Note:** This property is exclusively used for handling SAPUI5 flexibility changes. Do not use it otherwise.
17176
- *
17413
+ * **Note**: Existing properties (set via `sap.ui.mdc.Chart#setPropertyInfo`) must not be removed and their
17414
+ * attributes must not be changed during the {@link module:sap/ui/mdc/ChartDelegate.fetchProperties fetchProperties }
17415
+ * callback. Otherwise validation errors might occur whenever personalization-related control features (such
17416
+ * as the opening of any personalization dialog) are activated.
17177
17417
  *
17178
17418
  * **Note**: For more information about the supported inner elements, see {@link sap.ui.mdc.chart.PropertyInfo PropertyInfo}.
17179
17419
  *
@@ -17458,7 +17698,7 @@ declare namespace sap {
17458
17698
  | `{${string}}`;
17459
17699
 
17460
17700
  /**
17461
- * This event is fired when the `value` property of the field is changed.
17701
+ * This event is fired when the `conditions` property of the `FilterField` is changed by a user interaction.
17462
17702
  *
17463
17703
  * **Note** This event is only triggered if the used content control has a change event.
17464
17704
  */
@@ -17478,14 +17718,15 @@ declare namespace sap {
17478
17718
  | `{${string}}`;
17479
17719
 
17480
17720
  /**
17481
- * Object related to the `Delegate` module that provides the required APIs to execute model-specific logic.
17721
+ * Object related to the `LinkDelegate` module that provides the required APIs to execute model-specific
17722
+ * logic.
17482
17723
  * The object has the following properties:
17483
- * - `name` defines the path to the `Delegate` module
17724
+ * - `name` defines the path to the `LinkDelegate` module
17484
17725
  * - `payload` (optional) defines application-specific information that can be used in the given delegate
17485
17726
  * Sample delegate object:
17486
17727
  * ```javascript
17487
17728
  * {
17488
- * name: "sap/ui/mdc/BaseDelegate",
17729
+ * name: "sap/ui/mdc/LinkDelegate",
17489
17730
  * payload: {}
17490
17731
  * }```
17491
17732
  * **Note:** Ensure that the related file can be requested (any required library has to be loaded before
@@ -17866,7 +18107,10 @@ declare namespace sap {
17866
18107
  * no effect.
17867
18108
  *
17868
18109
  * **Note**: This property must not be bound. **Note**: This property is used exclusively for SAPUI5 flexibility
17869
- * / Fiori Elements. Do not use it otherwise.
18110
+ * / Fiori Elements. Do not use it otherwise. **Note**: Existing properties (set via `sap.ui.mdc.Table#setPropertyInfo`)
18111
+ * must not be removed and their attributes must not be changed during the {@link module:sap/ui/mdc/TableDelegate.fetchProperties fetchProperties }
18112
+ * callback. Otherwise validation errors might occur whenever personalization-related control features (such
18113
+ * as the opening of any personalization dialog) are activated.
17870
18114
  *
17871
18115
  * @since 1.111
17872
18116
  */
@@ -18084,6 +18328,9 @@ declare namespace sap {
18084
18328
  * If this property is not set, the user input is still checked against the value help. But if no entry
18085
18329
  * is found, the user input is set to the field if the used data type allows this. (A type parsing error
18086
18330
  * is shown if the user input adheres to the requirements of the used data type.)
18331
+ *
18332
+ * **Note:** The input is validated and compared against the content assigned to the `typeahead` aggregation.
18333
+ * If no content is assigned to the `typeahead` aggregation, the input is not validated.
18087
18334
  */
18088
18335
  validateInput?:
18089
18336
  | boolean
@@ -18427,7 +18674,7 @@ declare namespace sap {
18427
18674
 
18428
18675
  /**
18429
18676
  * The `Chart` control creates a chart based on metadata and the configuration specified.
18430
- * **Note:** The inner chart needs to be assigned `ChartDelegate`.
18677
+ * **Note:** The inner chart needs to be created inside the `ChartDelegate`.
18431
18678
  *
18432
18679
  * @since 1.88
18433
18680
  * @experimental (since 1.88)
@@ -20183,13 +20430,6 @@ declare namespace sap {
20183
20430
  * @returns Value of property `showClearButton`
20184
20431
  */
20185
20432
  getShowClearButton(): boolean;
20186
- /**
20187
- * Sets the focus on the first filter in error state.
20188
- *
20189
- *
20190
- * @returns The first filter field in error state
20191
- */
20192
- setFocusOnFirstErroneousField(): sap.ui.mdc.FilterField | null;
20193
20433
  /**
20194
20434
  * Sets a new value for property {@link #getP13nMode p13nMode}.
20195
20435
  *
@@ -20248,9 +20488,9 @@ declare namespace sap {
20248
20488
  }
20249
20489
  /**
20250
20490
  * The `FilterField` control is used to filter data based on the conditions. The conditions are managed
20251
- * in the corresponding {@link sap.ui.mdc.condition.ConditionModel ConditionModel}. That is why the `conditions`
20252
- * property must be bound to the related conditions in the {@link sap.ui.mdc.condition.ConditionModel ConditionModel}.
20253
- * The type of this data must be defined in the `dataType` property.
20491
+ * in the corresponding {@link sap.ui.mdc.FilterBar FilterBar}. That is why the `conditions` property must
20492
+ * be bound to the related conditions in the {@link sap.ui.mdc.FilterBar FilterBar}. The type of this data
20493
+ * must be defined in the `dataType` property.
20254
20494
  *
20255
20495
  * Based on the data type settings, a default control is rendered by the `FilterField` as follows:
20256
20496
  *
@@ -20383,7 +20623,7 @@ declare namespace sap {
20383
20623
  * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
20384
20624
  * otherwise it will be bound to this `sap.ui.mdc.FilterField` itself.
20385
20625
  *
20386
- * This event is fired when the `value` property of the field is changed.
20626
+ * This event is fired when the `conditions` property of the `FilterField` is changed by a user interaction.
20387
20627
  *
20388
20628
  * **Note** This event is only triggered if the used content control has a change event.
20389
20629
  *
@@ -20411,7 +20651,7 @@ declare namespace sap {
20411
20651
  * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
20412
20652
  * otherwise it will be bound to this `sap.ui.mdc.FilterField` itself.
20413
20653
  *
20414
- * This event is fired when the `value` property of the field is changed.
20654
+ * This event is fired when the `conditions` property of the `FilterField` is changed by a user interaction.
20415
20655
  *
20416
20656
  * **Note** This event is only triggered if the used content control has a change event.
20417
20657
  *
@@ -20705,43 +20945,18 @@ declare namespace sap {
20705
20945
  * @returns Metadata object describing this class
20706
20946
  */
20707
20947
  static getMetadata(): sap.ui.core.ElementMetadata;
20708
- /**
20709
- * Retrieves the relevant metadata for the panel and returns a property info array.
20710
- *
20711
- * @ui5-protected Do not call from applications (only from related classes in the framework)
20712
- *
20713
- * @returns Array of copied property info
20714
- */
20715
- static retrieveAllMetadata(
20716
- /**
20717
- * Instance of a `Panel` control
20718
- */
20719
- oPanel: /* was: sap.ui.mdc.link.Panel */ any
20720
- ): object[];
20721
- /**
20722
- * Retrieves the items that are initially part of the baseline which is used when a reset is done.
20723
- *
20724
- * @ui5-protected Do not call from applications (only from related classes in the framework)
20725
- *
20726
- * @returns Array containing the `ID` and `visible` property of every {@link sap.ui.mdc.link.LinkItem}
20727
- */
20728
- static retrieveBaseline(
20729
- /**
20730
- * Instance of a `Panel` control
20731
- */
20732
- oPanel: /* was: sap.ui.mdc.link.Panel */ any
20733
- ): sap.ui.mdc.link.BaseLineObject[];
20734
20948
  /**
20735
20949
  * Gets current value of property {@link #getDelegate delegate}.
20736
20950
  *
20737
- * Object related to the `Delegate` module that provides the required APIs to execute model-specific logic.
20951
+ * Object related to the `LinkDelegate` module that provides the required APIs to execute model-specific
20952
+ * logic.
20738
20953
  * The object has the following properties:
20739
- * - `name` defines the path to the `Delegate` module
20954
+ * - `name` defines the path to the `LinkDelegate` module
20740
20955
  * - `payload` (optional) defines application-specific information that can be used in the given delegate
20741
20956
  * Sample delegate object:
20742
20957
  * ```javascript
20743
20958
  * {
20744
- * name: "sap/ui/mdc/BaseDelegate",
20959
+ * name: "sap/ui/mdc/LinkDelegate",
20745
20960
  * payload: {}
20746
20961
  * }```
20747
20962
  * **Note:** Ensure that the related file can be requested (any required library has to be loaded before
@@ -20795,14 +21010,15 @@ declare namespace sap {
20795
21010
  /**
20796
21011
  * Sets a new value for property {@link #getDelegate delegate}.
20797
21012
  *
20798
- * Object related to the `Delegate` module that provides the required APIs to execute model-specific logic.
21013
+ * Object related to the `LinkDelegate` module that provides the required APIs to execute model-specific
21014
+ * logic.
20799
21015
  * The object has the following properties:
20800
- * - `name` defines the path to the `Delegate` module
21016
+ * - `name` defines the path to the `LinkDelegate` module
20801
21017
  * - `payload` (optional) defines application-specific information that can be used in the given delegate
20802
21018
  * Sample delegate object:
20803
21019
  * ```javascript
20804
21020
  * {
20805
- * name: "sap/ui/mdc/BaseDelegate",
21021
+ * name: "sap/ui/mdc/LinkDelegate",
20806
21022
  * payload: {}
20807
21023
  * }```
20808
21024
  * **Note:** Ensure that the related file can be requested (any required library has to be loaded before
@@ -23381,6 +23597,9 @@ declare namespace sap {
23381
23597
  * is found, the user input is set to the field if the used data type allows this. (A type parsing error
23382
23598
  * is shown if the user input adheres to the requirements of the used data type.)
23383
23599
  *
23600
+ * **Note:** The input is validated and compared against the content assigned to the `typeahead` aggregation.
23601
+ * If no content is assigned to the `typeahead` aggregation, the input is not validated.
23602
+ *
23384
23603
  * Default value is `true`.
23385
23604
  *
23386
23605
  *
@@ -23452,6 +23671,9 @@ declare namespace sap {
23452
23671
  * is found, the user input is set to the field if the used data type allows this. (A type parsing error
23453
23672
  * is shown if the user input adheres to the requirements of the used data type.)
23454
23673
  *
23674
+ * **Note:** The input is validated and compared against the content assigned to the `typeahead` aggregation.
23675
+ * If no content is assigned to the `typeahead` aggregation, the input is not validated.
23676
+ *
23455
23677
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
23456
23678
  *
23457
23679
  * Default value is `true`.