@bryntum/scheduler-vue-3-thin 7.2.4 → 7.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (80) hide show
  1. package/README.md +8 -8
  2. package/lib/chunks/{B0m0r-NV.js → BTSObfAz.js} +11 -9
  3. package/lib/chunks/BTSObfAz.js.map +1 -0
  4. package/lib/chunks/BXIuEgYD.js +265 -0
  5. package/lib/chunks/BXIuEgYD.js.map +1 -0
  6. package/lib/chunks/{DerP_qo7.js → CCTV8qn0.js} +18 -10
  7. package/lib/chunks/CCTV8qn0.js.map +1 -0
  8. package/lib/chunks/{CsoS615B.js → COFzBhB8.js} +11 -9
  9. package/lib/chunks/COFzBhB8.js.map +1 -0
  10. package/lib/chunks/{BD-Hg3lY.js → DB0UHrA3.js} +17 -24
  11. package/lib/chunks/DB0UHrA3.js.map +1 -0
  12. package/lib/chunks/{C7ZFK2B7.js → DJSlX0qP.js} +18 -10
  13. package/lib/chunks/DJSlX0qP.js.map +1 -0
  14. package/lib/chunks/{DmQj0tBi.js → DP61St-u.js} +14 -6
  15. package/lib/chunks/DP61St-u.js.map +1 -0
  16. package/lib/chunks/{mKqb8_2f.js → LNqNYJck.js} +9 -7
  17. package/lib/chunks/LNqNYJck.js.map +1 -0
  18. package/lib/chunks/{CP1Mm_Ak.js → R69sJLmF.js} +16 -17
  19. package/lib/chunks/R69sJLmF.js.map +1 -0
  20. package/lib/chunks/{BNGLBrCN.js → WykRcMCN.js} +7 -5
  21. package/lib/chunks/WykRcMCN.js.map +1 -0
  22. package/lib/chunks/{C0UqC4Uj.js → eUISgYXE.js} +9 -9
  23. package/lib/chunks/eUISgYXE.js.map +1 -0
  24. package/lib/chunks/{C2PT-Ukt.js → t8aiH3XL.js} +13 -14
  25. package/lib/chunks/t8aiH3XL.js.map +1 -0
  26. package/lib/components/BryntumEventColorField.js +1 -1
  27. package/lib/components/BryntumProjectCombo.js +1 -1
  28. package/lib/components/BryntumResourceCombo.js +1 -1
  29. package/lib/components/BryntumResourceFilter.js +1 -1
  30. package/lib/components/BryntumScheduler.js +1 -1
  31. package/lib/components/BryntumSchedulerBase.js +1 -1
  32. package/lib/components/BryntumSchedulerDatePicker.js +1 -1
  33. package/lib/components/BryntumSchedulerProjectModel.js +1 -1
  34. package/lib/components/BryntumThemeCombo.js +57 -0
  35. package/lib/components/BryntumThemeCombo.js.map +1 -0
  36. package/lib/components/BryntumTimeZoomSlider.js +5 -0
  37. package/lib/components/BryntumTimeZoomSlider.js.map +1 -0
  38. package/lib/components/BryntumTimelineHistogram.js +1 -1
  39. package/lib/components/BryntumUndoRedo.js +1 -1
  40. package/lib/components/BryntumViewPresetCombo.js +1 -1
  41. package/lib/index.js +18 -16
  42. package/lib/index.js.map +1 -1
  43. package/package.json +1 -1
  44. package/src/components/BryntumEventColorField.vue +152 -222
  45. package/src/components/BryntumEventColorFieldProps.ts +77 -108
  46. package/src/components/BryntumProjectCombo.vue +171 -258
  47. package/src/components/BryntumProjectComboProps.ts +95 -141
  48. package/src/components/BryntumResourceCombo.vue +172 -260
  49. package/src/components/BryntumResourceComboProps.ts +96 -143
  50. package/src/components/BryntumResourceFilter.vue +132 -211
  51. package/src/components/BryntumResourceFilterProps.ts +60 -98
  52. package/src/components/BryntumScheduler.vue +1847 -2520
  53. package/src/components/BryntumSchedulerBase.vue +1847 -2520
  54. package/src/components/BryntumSchedulerBaseProps.ts +372 -522
  55. package/src/components/BryntumSchedulerDatePicker.vue +205 -331
  56. package/src/components/BryntumSchedulerDatePickerProps.ts +116 -187
  57. package/src/components/BryntumSchedulerProjectModel.vue +23 -46
  58. package/src/components/BryntumSchedulerProjectModelProps.ts +10 -20
  59. package/src/components/BryntumSchedulerProps.ts +372 -522
  60. package/src/components/BryntumThemeCombo.vue +60 -0
  61. package/src/components/BryntumTimeZoomSlider.vue +829 -0
  62. package/src/components/BryntumTimeZoomSliderProps.ts +482 -0
  63. package/src/components/BryntumTimelineHistogram.vue +1034 -1461
  64. package/src/components/BryntumTimelineHistogramProps.ts +275 -388
  65. package/src/components/BryntumUndoRedo.vue +127 -204
  66. package/src/components/BryntumUndoRedoProps.ts +74 -116
  67. package/src/components/BryntumViewPresetCombo.vue +144 -210
  68. package/src/components/BryntumViewPresetComboProps.ts +72 -99
  69. package/src/index.ts +2 -0
  70. package/lib/chunks/B0m0r-NV.js.map +0 -1
  71. package/lib/chunks/BD-Hg3lY.js.map +0 -1
  72. package/lib/chunks/BNGLBrCN.js.map +0 -1
  73. package/lib/chunks/C0UqC4Uj.js.map +0 -1
  74. package/lib/chunks/C2PT-Ukt.js.map +0 -1
  75. package/lib/chunks/C7ZFK2B7.js.map +0 -1
  76. package/lib/chunks/CP1Mm_Ak.js.map +0 -1
  77. package/lib/chunks/CsoS615B.js.map +0 -1
  78. package/lib/chunks/DerP_qo7.js.map +0 -1
  79. package/lib/chunks/DmQj0tBi.js.map +0 -1
  80. package/lib/chunks/mKqb8_2f.js.map +0 -1
@@ -10,7 +10,7 @@
10
10
 
11
11
  import { getCurrentInstance, onBeforeUnmount, onMounted, provide, ref, watch, toRaw } from 'vue';
12
12
 
13
- import type { AlignSpec, Base, ChipViewConfig, CollectionCompareOperator, CollectionFilterConfig, Color, Combo, ComboModel, Duration, DurationConfig, Field, FieldContainer, FieldContainerConfig, FieldTriggerConfig, KeyMapConfig, List, ListConfig, MaskConfig, Model, Rectangle, Store, StoreConfig, TabConfig, TooltipConfig, Widget } from '@bryntum/core-thin';
13
+ import type { AlignSpec, Base, ChipViewConfig, CollectionCompareOperator, CollectionFilterConfig, Color, Combo, Duration, DurationConfig, Field, FieldContainerConfig, FieldTriggerConfig, KeyMapConfig, ListConfig, MaskConfig, Model, Rectangle, Store, StoreConfig, TabConfig, TooltipConfig, Widget } from '@bryntum/core-thin';
14
14
  import type { SchedulerContainerItemConfig, ResourceComboListeners } from '@bryntum/scheduler-thin';
15
15
  import { ResourceCombo } from '@bryntum/scheduler-thin';
16
16
 
@@ -21,14 +21,12 @@ defineProps<{
21
21
  /**
22
22
  * Element (or element id) to adopt as this Widget's encapsulating element. The widget's
23
23
  * content will be placed inside this element.
24
- * ...
25
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-adopt)
24
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-adopt)
26
25
  */
27
26
  adopt ? : HTMLElement|string
28
27
  /**
29
28
  * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#config-floating).*
30
- * ...
31
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-align)
29
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-align)
32
30
  */
33
31
  align ? : AlignSpec|string
34
32
  /**
@@ -50,15 +48,13 @@ defineProps<{
50
48
  /**
51
49
  * A localizable string (May contain `'L{}'` tokens which resolve in the locale file) to inject
52
50
  * into an element which will be linked using the `aria-describedby` attribute.
53
- * ...
54
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-ariaDescription)
51
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-ariaDescription)
55
52
  */
56
53
  ariaDescription ? : string
57
54
  /**
58
55
  * A localizable string (May contain `'L{}'` tokens which resolve in the locale file) to inject as
59
56
  * the `aria-label` attribute.
60
- * ...
61
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-ariaLabel)
57
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-ariaLabel)
62
58
  */
63
59
  ariaLabel ? : string
64
60
  /**
@@ -81,20 +77,17 @@ defineProps<{
81
77
  /**
82
78
  * An object where property names with a truthy value indicate which events should bubble up the ownership
83
79
  * hierarchy when triggered.
84
- * ...
85
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-bubbleEvents)
80
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-bubbleEvents)
86
81
  */
87
82
  bubbleEvents ? : object
88
83
  /**
89
84
  * Enable caching of the last retrieved result until the timeout is reached.
90
- * ...
91
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-cacheLastResult)
85
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-cacheLastResult)
92
86
  */
93
87
  cacheLastResult ? : number|string|Duration|DurationConfig
94
88
  /**
95
89
  * Set to `false` to not call onXXX method names (e.g. `onShow`, `onClick`), as an easy way to listen for events.
96
- * ...
97
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-callOnFunctions)
90
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-callOnFunctions)
98
91
  */
99
92
  callOnFunctions ? : Boolean
100
93
  /**
@@ -104,8 +97,7 @@ defineProps<{
104
97
  /**
105
98
  * By default, if an event handler throws an exception, the error propagates up the stack and the
106
99
  * application state is undefined. Code which follows the event handler will *not* be executed.
107
- * ...
108
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-catchEventHandlerExceptions)
100
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-catchEventHandlerExceptions)
109
101
  */
110
102
  catchEventHandlerExceptions ? : Boolean
111
103
  /**
@@ -113,11 +105,19 @@ defineProps<{
113
105
  * Set to `true` to centre the Widget in browser viewport space.
114
106
  */
115
107
  centered ? : Boolean
108
+ /**
109
+ * A function (or the name of a function in the ownership hierarchy) called during field validation
110
+ * to perform custom validity checks. The function is called as part of the [isValid](https://bryntum.com/products/scheduler/docs/api/Core/widget/Field#property-isValid)
111
+ * evaluation, after the built-in [required](https://bryntum.com/products/scheduler/docs/api/Core/widget/Field#config-required) check.
112
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-checkValidity)
113
+ * @param {Core.widget.Field} field The field being validated
114
+ * @returns {void}
115
+ */
116
+ checkValidity ? : ((field: Field) => void)|string
116
117
  /**
117
118
  * A config object to configure the [ChipView](https://bryntum.com/products/scheduler/docs/api/Core/widget/ChipView) to display the
118
119
  * selected value set when [multiSelect](https://bryntum.com/products/scheduler/docs/api/Core/widget/Combo#config-multiSelect) is `true`.
119
- * ...
120
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-chipView)
120
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-chipView)
121
121
  */
122
122
  chipView ? : ChipViewConfig
123
123
  /**
@@ -142,15 +142,13 @@ defineProps<{
142
142
  * Custom CSS classes to add to element.
143
143
  * May be specified as a space separated string, or as an object in which property names
144
144
  * with truthy values are used as the class names:
145
- * ...
146
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-cls)
145
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-cls)
147
146
  */
148
147
  cls ? : string|object
149
148
  /**
150
149
  * Applies the specified color to the widget, by setting the `--b-primary` CSS variable in the widgets
151
150
  * `style` block.
152
- * ...
153
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-color)
151
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-color)
154
152
  */
155
153
  color ? : Color
156
154
  /**
@@ -167,15 +165,13 @@ defineProps<{
167
165
  * The configuration for additional items associated to this field. This is typically used to add contextual
168
166
  * fields related to a [checkbox](https://bryntum.com/products/scheduler/docs/api/Core/widget/Checkbox) or [radio button](#Core/widget/Radio). See
169
167
  * these classes for examples of nested fields.
170
- * ...
171
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-container)
168
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-container)
172
169
  */
173
- container ? : Record<string, SchedulerContainerItemConfig>|SchedulerContainerItemConfig[]|FieldContainerConfig|FieldContainer
170
+ container ? : Record<string, SchedulerContainerItemConfig>|SchedulerContainerItemConfig[]|FieldContainerConfig
174
171
  /**
175
172
  * The config controls how the value of nested items are handled when a parent container gets or sets its
176
173
  * [values](https://bryntum.com/products/scheduler/docs/api/Core/widget/Container#property-values).
177
- * ...
178
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-containValues)
174
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-containValues)
179
175
  * @param {Core.widget.Field} field Field instance
180
176
  * @returns {boolean}
181
177
  */
@@ -184,16 +180,14 @@ defineProps<{
184
180
  * Custom CSS classes to add to the [contentElement](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#property-contentElement).
185
181
  * May be specified as a space separated string, or as an object in which property names
186
182
  * with truthy values are used as the class names:
187
- * ...
188
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-contentElementCls)
183
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-contentElementCls)
189
184
  */
190
185
  contentElementCls ? : string|object
191
186
  /**
192
187
  * If configured as `true`, this means that when an unmatched string is typed into the
193
188
  * combo's input field, and <kbd>Enter</kbd>, or the [multiValueSeparator](https://bryntum.com/products/scheduler/docs/api/Core/widget/Combo#config-multiValueSeparator) is typed,
194
189
  * a new record will be created using the typed string as the [displayField](https://bryntum.com/products/scheduler/docs/api/Core/widget/Combo#config-displayField).
195
- * ...
196
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-createOnUnmatched)
190
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-createOnUnmatched)
197
191
  * @param {string} name Record name
198
192
  * @param {Core.widget.Combo} combo Combo instance
199
193
  * @returns {Core.data.Model} New record
@@ -214,16 +208,15 @@ defineProps<{
214
208
  */
215
209
  defaultBindProperty ? : string
216
210
  /**
217
- * Check for CSS compatibility issues when upgrading to v7. Performs the following checks:
218
- * ...
219
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-detectCSSCompatibilityIssues)
211
+ * Check for CSS compatibility and inclusion related issues and try to auto fix them. Performs the following
212
+ * checks:
213
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-detectCSSCompatibilityIssues)
220
214
  */
221
215
  detectCSSCompatibilityIssues ? : Boolean
222
216
  /**
223
217
  * Disable or enable the widget. It is similar to [readOnly](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#config-readOnly) except a disabled widget
224
218
  * cannot be focused, uses a different rendition (usually greyish) and does not allow selecting its value.
225
- * ...
226
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-disabled)
219
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-disabled)
227
220
  */
228
221
  disabled ? : Boolean|'inert'
229
222
  /**
@@ -236,26 +229,23 @@ defineProps<{
236
229
  * @param {Core.widget.Combo} combo A reference to this Combo
237
230
  * @returns {string,void}
238
231
  */
239
- displayValueRenderer ? : (record: Model|ComboModel, combo: Combo) => string|void
232
+ displayValueRenderer ? : (record: Model, combo: Combo) => string|void
240
233
  /**
241
234
  * Controls the placement of this widget when it is added to a [panel's ](https://bryntum.com/products/scheduler/docs/api/Core/widget/Panel)
242
235
  * [strips collection](https://bryntum.com/products/scheduler/docs/api/Core/widget/Panel#config-strips). Typical values for this config are `'top'`,
243
236
  * `'bottom'`, `'left'`, or `'right'`, which cause the widget to be placed on that side of the panel's
244
237
  * body. Such widgets are called "edge strips".
245
- * ...
246
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-dock)
238
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-dock)
247
239
  */
248
240
  dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
249
241
  /**
250
242
  * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#config-floating).*
251
243
  * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
252
244
  * property which controls when a drag should start.
253
- * ...
254
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-draggable)
245
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-draggable)
246
+ * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
255
247
  */
256
- draggable ? : Boolean|{
257
- handleSelector?: string
258
- }
248
+ draggable ? : Boolean|object
259
249
  /**
260
250
  * User can edit text in text field (otherwise only pick from attached picker)
261
251
  */
@@ -263,21 +253,18 @@ defineProps<{
263
253
  /**
264
254
  * An object specifying attributes to assign to the root element of this widget.
265
255
  * Set `null` value to attribute to remove it.
266
- * ...
267
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-elementAttributes)
256
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-elementAttributes)
268
257
  */
269
258
  elementAttributes ? : Record<string, string|null>
270
259
  /**
271
260
  * Text to display in the drop down when there are no items in the underlying store.
272
- * ...
273
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-emptyText)
261
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-emptyText)
274
262
  */
275
263
  emptyText ? : string
276
264
  /**
277
265
  * A function which creates an array of values for the [filterParamName](https://bryntum.com/products/scheduler/docs/api/Core/widget/Combo#config-filterParamName) to pass
278
266
  * any filters to the server upon load.
279
- * ...
280
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-encodeFilterParams)
267
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-encodeFilterParams)
281
268
  * @param {object[]} filters filters
282
269
  * @returns {object[]} array of values
283
270
  */
@@ -291,8 +278,7 @@ defineProps<{
291
278
  /**
292
279
  * The name of an operator type as implemented in [operator](https://bryntum.com/products/scheduler/docs/api/Core/util/CollectionFilter#config-operator)
293
280
  * to use when filtering the dropdown list based upon the typed value.
294
- * ...
295
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-filterOperator)
281
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-filterOperator)
296
282
  */
297
283
  filterOperator ? : CollectionCompareOperator
298
284
  /**
@@ -333,8 +319,7 @@ defineProps<{
333
319
  hidden ? : Boolean
334
320
  /**
335
321
  * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#config-floating).*
336
- * ...
337
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-hideAnimation)
322
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-hideAnimation)
338
323
  */
339
324
  hideAnimation ? : Boolean|object
340
325
  /**
@@ -355,8 +340,7 @@ defineProps<{
355
340
  /**
356
341
  * An optional string to display inside the input field as an overlay. This can be useful for displaying
357
342
  * a field's units.
358
- * ...
359
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-hint)
343
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-hint)
360
344
  * @param {object} data A data object
361
345
  * @param {Core.widget.Field} data.source A reference to the field instance
362
346
  * @param {any} data.value The current value of the field
@@ -367,8 +351,7 @@ defineProps<{
367
351
  * This config is similar to [hint](https://bryntum.com/products/scheduler/docs/api/Core/widget/Field#config-hint) except that this config is used to display HTML content.
368
352
  * Since this can allow malicious content to be executed, be sure not to include user-entered data or to
369
353
  * encode such data (see [encodeHtml](https://bryntum.com/products/scheduler/docs/api/Core/helper/StringHelper#function-encodeHtml-static)).
370
- * ...
371
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-hintHtml)
354
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-hintHtml)
372
355
  * @param {object} data A data object
373
356
  * @param {Core.widget.Field} data.source A reference to the field instance
374
357
  * @param {any} data.value The current value of the field
@@ -381,23 +364,20 @@ defineProps<{
381
364
  id ? : string
382
365
  /**
383
366
  * Determines if the widgets read-only state should be controlled by its parent.
384
- * ...
385
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-ignoreParentReadOnly)
367
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-ignoreParentReadOnly)
386
368
  */
387
369
  ignoreParentReadOnly ? : Boolean
388
370
  /**
389
371
  * Set this config to `true` to always display items horizontally along with this field. This assigns an
390
372
  * [hbox](https://bryntum.com/products/scheduler/docs/api/Core/widget/layout/Box) as the [layout](#Core/widget/Container#config-layout) to the
391
373
  * [container](https://bryntum.com/products/scheduler/docs/api/Core/widget/Field#config-container).
392
- * ...
393
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-inline)
374
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-inline)
394
375
  */
395
376
  inline ? : Boolean
396
377
  /**
397
378
  * Configure this as `true` to render the dropdown list as a permanently visible list
398
379
  * in the document flow immediately below the input area instead of as a popup.
399
- * ...
400
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-inlinePicker)
380
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-inlinePicker)
401
381
  */
402
382
  inlinePicker ? : Boolean
403
383
  /**
@@ -435,30 +415,26 @@ defineProps<{
435
415
  insertFirst ? : HTMLElement|string
436
416
  /**
437
417
  * Rows to display in the dropdown (list items).
438
- * ...
439
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-items)
418
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-items)
440
419
  */
441
420
  items ? : object[]|string[]|object
442
421
  /**
443
422
  * An object whose keys are the [key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key) name
444
423
  * and optional modifier prefixes: `'Ctrl+'`, `'Alt+'`, `'Meta+'`, and `'Shift+'` (case-insensitive). The values
445
424
  * are the name of the instance method to call when the keystroke is received.
446
- * ...
447
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-keyMap)
425
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-keyMap)
448
426
  */
449
427
  keyMap ? : Record<string, KeyMapConfig>
450
428
  /**
451
429
  * The delay in milliseconds to wait after the last keystroke before triggering a change event.
452
430
  * Set to 0 to not trigger change events from keystrokes (listen for input event instead to have
453
431
  * immediate feedback, change will still be triggered on blur).
454
- * ...
455
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-keyStrokeChangeDelay)
432
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-keyStrokeChangeDelay)
456
433
  */
457
434
  keyStrokeChangeDelay ? : number
458
435
  /**
459
436
  * The delay in milliseconds to wait after the last keystroke before filtering the list.
460
- * ...
461
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-keyStrokeFilterDelay)
437
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-keyStrokeFilterDelay)
462
438
  */
463
439
  keyStrokeFilterDelay ? : number
464
440
  /**
@@ -471,15 +447,15 @@ defineProps<{
471
447
  labelCls ? : string|object
472
448
  /**
473
449
  * Label position, either 'before' the field or 'above' the field
474
- * ...
475
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-labelPosition)
450
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-labelPosition)
476
451
  */
477
452
  labelPosition ? : 'before'|'above'|null
478
453
  /**
479
454
  * The labels to add either before or after the input field.
480
455
  * Each label may have the following properties:
481
- * ...
482
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-labels)
456
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-labels)
457
+ * @property {string} html Label text
458
+ * @property {'start','end'} align Which end of the file the label should go
483
459
  */
484
460
  labels ? : object[]
485
461
  /**
@@ -492,24 +468,21 @@ defineProps<{
492
468
  listCls ? : string
493
469
  /**
494
470
  * The listener set for this object.
495
- * ...
496
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-listeners)
471
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-listeners)
497
472
  */
498
473
  listeners ? : ResourceComboListeners
499
474
  /**
500
475
  * Template string used to render the list items in the dropdown list
501
- * ...
502
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-listItemTpl)
476
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-listItemTpl)
503
477
  * @param {Core.data.Model} record The record representing the item being rendered
504
478
  * @returns {string,void}
505
479
  */
506
- listItemTpl ? : (record: Model|ComboModel) => string|void
480
+ listItemTpl ? : (record: Model) => string|void
507
481
  /**
508
482
  * A class translations of which are used for translating this entity.
509
483
  * This is often used when translations of an item are defined on its container class.
510
484
  * For example:
511
- * ...
512
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-localeClass)
485
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-localeClass)
513
486
  */
514
487
  localeClass ? : typeof Base
515
488
  /**
@@ -521,8 +494,7 @@ defineProps<{
521
494
  * In case there is a need to localize not typical value (not a String value or a field with re-defined setter/getter),
522
495
  * you could use 'localeKey' meta configuration.
523
496
  * Example:
524
- * ...
525
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-localizableProperties)
497
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-localizableProperties)
526
498
  */
527
499
  localizableProperties ? : string[]
528
500
  /**
@@ -548,8 +520,7 @@ defineProps<{
548
520
  maxHeight ? : string|number
549
521
  /**
550
522
  * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#config-floating).*
551
- * ...
552
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-maximizeOnMobile)
523
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-maximizeOnMobile)
553
524
  */
554
525
  maximizeOnMobile ? : number|string
555
526
  /**
@@ -563,8 +534,7 @@ defineProps<{
563
534
  maxWidth ? : string|number
564
535
  /**
565
536
  * The minimum string length to trigger the filtering, only relevant when [editable](https://bryntum.com/products/scheduler/docs/api/Core/widget/Combo#config-editable) is `true`.
566
- * ...
567
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-minChars)
537
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-minChars)
568
538
  */
569
539
  minChars ? : number
570
540
  /**
@@ -585,16 +555,13 @@ defineProps<{
585
555
  * When this is configured as `true` a [ResizeObserver](https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver)
586
556
  * is used to monitor this element for size changes caused by either style manipulation, or by CSS
587
557
  * layout.
588
- * ...
589
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-monitorResize)
558
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-monitorResize)
559
+ * @property {boolean} immediate Set to `true` to receive resize notifications immediately.
590
560
  */
591
- monitorResize ? : Boolean|{
592
- immediate?: Boolean
593
- }
561
+ monitorResize ? : Boolean|object
594
562
  /**
595
563
  * Set to `true` to allow selection of multiple values from the dropdown list.
596
- * ...
597
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-multiSelect)
564
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-multiSelect)
598
565
  */
599
566
  multiSelect ? : Boolean
600
567
  /**
@@ -607,8 +574,7 @@ defineProps<{
607
574
  * Name of the field which is used as a key to get/set values from/to the field.
608
575
  * Used prior to [ref](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#config-ref) and [id](#Core/widget/Widget#config-id) in
609
576
  * [Container.values](https://bryntum.com/products/scheduler/docs/api/Core/widget/Container#property-values).
610
- * ...
611
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-name)
577
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-name)
612
578
  */
613
579
  name ? : string
614
580
  /**
@@ -619,10 +585,9 @@ defineProps<{
619
585
  /**
620
586
  * Configuration object for the [picker](https://bryntum.com/products/scheduler/docs/api/Core/widget/List) on initialization. Returns the
621
587
  * [picker](https://bryntum.com/products/scheduler/docs/api/Core/widget/List) instance at runtime.
622
- * ...
623
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-picker)
588
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-picker)
624
589
  */
625
- picker ? : ListConfig|List
590
+ picker ? : ListConfig
626
591
  /**
627
592
  * The name of the element property to which the picker should size and align itself.
628
593
  */
@@ -639,8 +604,7 @@ defineProps<{
639
604
  * Set to `true` when a widget is rendered into another widget's [contentElement](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#property-contentElement), but must
640
605
  * not participate in the standard layout of that widget, and must be positioned relatively to that
641
606
  * widget's [contentElement](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#property-contentElement).
642
- * ...
643
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-positioned)
607
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-positioned)
644
608
  */
645
609
  positioned ? : Boolean
646
610
  /**
@@ -652,22 +616,19 @@ defineProps<{
652
616
  * Optionally a [Filter](https://bryntum.com/products/scheduler/docs/api/Core/util/CollectionFilter) config object which the combo should use for
653
617
  * filtering using the typed value.
654
618
  * This may use a `filterBy` property to test its `value` against any field in the passed record.
655
- * ...
656
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-primaryFilter)
619
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-primaryFilter)
657
620
  */
658
621
  primaryFilter ? : CollectionFilterConfig
659
622
  /**
660
623
  * Makes the field unmodifiable by user action. The input area is not editable, and triggers
661
624
  * are unresponsive.
662
- * ...
663
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-readOnly)
625
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-readOnly)
664
626
  */
665
627
  readOnly ? : Boolean
666
628
  relayStoreEvents ? : Boolean
667
629
  /**
668
630
  * Predefined style to use for the field. Possible values are:
669
- * ...
670
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-rendition)
631
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-rendition)
671
632
  */
672
633
  rendition ? : 'outlined'|'filled'|string
673
634
  /**
@@ -686,23 +647,26 @@ defineProps<{
686
647
  * Configure as `true` to have the component display a translucent ripple when its
687
648
  * [focusElement](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#property-focusElement), or [element](#Core/widget/Widget#property-element) is tapped <em>if the
688
649
  * current theme supports ripples</em>. Out of the box, only the Material theme supports ripples.
689
- * ...
690
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-ripple)
650
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-ripple)
651
+ * @property {string} [delegate] A CSS selector to filter which child elements trigger ripples. By default, the ripple is clipped to the triggering element.
652
+ * @property {string} [color] A CSS color name or specification.
653
+ * @property {number} [radius] The ending radius of the ripple. Note that it will be clipped by the target element by default.
654
+ * @property {string} [clip] A string which describes how to clip the ripple if it is not to be clipped to the default element. Either the property of the widget to use as the clipping element, or a selector to allow clipping to the closest matching ancestor to the target element.
655
+ */
656
+ ripple ? : Boolean|object
657
+ /**
658
+ * The ARIA role to apply to this widget's element. By default, this is set to `'presentation'` to avoid
659
+ * accidentally applying a role which may interfere with screen readers.
660
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-role)
691
661
  */
692
- ripple ? : Boolean|{
693
- delegate?: string
694
- color?: string
695
- radius?: number
696
- clip?: string
697
- }
662
+ role ? : string
698
663
  /**
699
664
  * If you are rendering this widget to a shadow root inside a web component, set this config to the shadowRoot. If not inside a web component, set it to `document.body`
700
665
  */
701
666
  rootElement ? : ShadowRoot|HTMLElement
702
667
  /**
703
668
  * This may be configured as `true` to make the widget's element use the `direction:rtl` style.
704
- * ...
705
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-rtl)
669
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-rtl)
706
670
  */
707
671
  rtl ? : Boolean
708
672
  /**
@@ -712,8 +676,7 @@ defineProps<{
712
676
  scrollAction ? : 'hide'|'realign'|null
713
677
  /**
714
678
  * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#config-floating).*
715
- * ...
716
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-showAnimation)
679
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-showAnimation)
717
680
  */
718
681
  showAnimation ? : Boolean|object
719
682
  /**
@@ -750,8 +713,7 @@ defineProps<{
750
713
  * A configuration for the [tab](https://bryntum.com/products/scheduler/docs/api/Core/widget/Tab) created for this widget when it is placed in a
751
714
  * [TabPanel](https://bryntum.com/products/scheduler/docs/api/Core/widget/TabPanel). For example, this config can be used to control the icon of the `tab` for
752
715
  * this widget:
753
- * ...
754
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-tab)
716
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-tab)
755
717
  */
756
718
  tab ? : Boolean|TabConfig
757
719
  /**
@@ -759,14 +721,12 @@ defineProps<{
759
721
  * is equivalent to natural tab order, but is unnecessary for fields since they are naturally tabbable
760
722
  * (i.e., accessible via the TAB key). Setting to `-1` disables tabbability but allows for focus to be set
761
723
  * to the element programmatically.
762
- * ...
763
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-tabIndex)
724
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-tabIndex)
764
725
  */
765
726
  tabIndex ? : number
766
727
  /**
767
728
  * Text alignment: 'left', 'center' or 'right'. Also accepts direction neutral 'start' and 'end'.
768
- * ...
769
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-textAlign)
729
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-textAlign)
770
730
  */
771
731
  textAlign ? : 'left'|'center'|'right'|'start'|'end'
772
732
  /**
@@ -775,30 +735,26 @@ defineProps<{
775
735
  title ? : string
776
736
  /**
777
737
  * Tooltip for the widget, either as a string or as a Tooltip config object.
778
- * ...
779
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-tooltip)
738
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-tooltip)
780
739
  */
781
740
  tooltip ? : string|TooltipConfig|null
782
741
  /**
783
742
  * How to query the store upon click of the expand trigger. Specify one of these values:
784
- * ...
785
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-triggerAction)
743
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-triggerAction)
786
744
  */
787
745
  triggerAction ? : 'all'|'last'|null
788
746
  /**
789
747
  * The triggers to add either before or after the input field. Each property name is the reference by which
790
748
  * an instantiated Trigger Widget may be retrieved from the live `triggers` property.
791
- * ...
792
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-triggers)
749
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-triggers)
793
750
  */
794
- triggers ? : Record<string, FieldTriggerConfig>|Record<string, Widget>
751
+ triggers ? : Record<string, FieldTriggerConfig>
795
752
  type ? : 'resourcecombo'
796
753
  /**
797
754
  * Custom CSS class name suffixes to apply to the elements rendered by this widget. This may be specified
798
755
  * as a space separated string, an array of strings, or as an object in which property names with truthy
799
756
  * values are used as the class names.
800
- * ...
801
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-ui)
757
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-ui)
802
758
  */
803
759
  ui ? : string|object
804
760
  /**
@@ -818,8 +774,7 @@ defineProps<{
818
774
  /**
819
775
  * Field used for item value when populating from store. Setting this to `null` will
820
776
  * yield the selected record as the Combo's [value](https://bryntum.com/products/scheduler/docs/api/Core/widget/Combo#property-value).
821
- * ...
822
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-valueField)
777
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-valueField)
823
778
  */
824
779
  valueField ? : string|null
825
780
  /**
@@ -835,14 +790,12 @@ defineProps<{
835
790
  width ? : string|number
836
791
  /**
837
792
  * The x position for the widget.
838
- * ...
839
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-x)
793
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-x)
840
794
  */
841
795
  x ? : number
842
796
  /**
843
797
  * The y position for the widget.
844
- * ...
845
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-y)
798
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-y)
846
799
  */
847
800
  y ? : number
848
801
 
@@ -853,120 +806,98 @@ const emit = defineEmits<{
853
806
  * The default action was performed (an item in the list was selected)
854
807
  * @param {string} e Event name
855
808
  * @param {object} params Event parameters
856
- * @param {string} params.e Event name
857
- * @param {object} params.params Event parameters
858
- * @param {object} params.params.event Event object
859
- * @param {Core.widget.Combo} params.params.event.source The combo
860
- * @param {any} params.params.event.value The [value](https://bryntum.com/products/scheduler/docs/api/Core/widget/Combo#config-valueField) of the selected record
861
- * @param {Core.data.Model} params.params.event.record Selected record
862
- * @param {Core.data.Model[]} params.params.event.records Selected records as an array if [multiSelect](https://bryntum.com/products/scheduler/docs/api/Core/widget/Combo#config-multiSelect) is `true`
863
- * @param {boolean} params.params.event.userAction `true` if the value change is due to user interaction
809
+ * @param {object} params.event Event object
810
+ * @param {Core.widget.Combo} params.event.source The combo
811
+ * @param {any} params.event.value The [value](https://bryntum.com/products/scheduler/docs/api/Core/widget/Combo#config-valueField) of the selected record
812
+ * @param {Core.data.Model} params.event.record Selected record
813
+ * @param {Core.data.Model[]} params.event.records Selected records as an array if [multiSelect](https://bryntum.com/products/scheduler/docs/api/Core/widget/Combo#config-multiSelect) is `true`
814
+ * @param {boolean} params.event.userAction `true` if the value change is due to user interaction
864
815
  */
865
816
  (e: 'action', params: ((event: { source: Combo, value: any, record: Model, records: Model[], userAction: boolean }) => void)|string): void
866
817
  /**
867
818
  * Fires before an object is destroyed.
868
819
  * @param {string} e Event name
869
820
  * @param {object} params Event parameters
870
- * @param {string} params.e Event name
871
- * @param {object} params.params Event parameters
872
- * @param {object} params.params.event Event object
873
- * @param {Core.Base} params.params.event.source The Object that is being destroyed.
821
+ * @param {object} params.event Event object
822
+ * @param {Core.Base} params.event.source The Object that is being destroyed.
874
823
  */
875
824
  (e: 'beforeDestroy', params: ((event: { source: Base }) => void)|string): void
876
825
  /**
877
826
  * Triggered before a widget is hidden. Return `false` to prevent the action.
878
827
  * @param {string} e Event name
879
828
  * @param {object} params Event parameters
880
- * @param {string} params.e Event name
881
- * @param {object} params.params Event parameters
882
- * @param {object} params.params.event Event object
883
- * @param {Core.widget.Widget} params.params.event.source The widget being hidden.
829
+ * @param {object} params.event Event object
830
+ * @param {Core.widget.Widget} params.event.source The widget being hidden.
884
831
  */
885
- (e: 'beforeHide', params: ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
832
+ (e: 'beforeHide', params: ((event: { source: Widget }) => boolean|void)|string): boolean|void
886
833
  /**
887
834
  * Triggered before a widget is shown. Return `false` to prevent the action.
888
835
  * @param {string} e Event name
889
836
  * @param {object} params Event parameters
890
- * @param {string} params.e Event name
891
- * @param {object} params.params Event parameters
892
- * @param {object} params.params.event Event object
893
- * @param {Core.widget.Widget,any} params.params.event.source The widget being shown
837
+ * @param {object} params.event Event object
838
+ * @param {Core.widget.Widget,any} params.event.source The widget being shown
894
839
  */
895
840
  (e: 'beforeShow', params: ((event: { source: Widget|any }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
896
841
  /**
897
842
  * Fires when any other event is fired from the object.
898
- * ...
899
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#event-catchAll)
843
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#event-catchAll)
900
844
  * @param {string} e Event name
901
845
  * @param {object} params Event parameters
902
- * @param {string} params.e Event name
903
- * @param {object} params.params Event parameters
904
- * @param {object} params.params.event Event object
905
- * @param {{[key: string]: any, type: string}} params.params.event.event The Object that contains event details
906
- * @param {string} params.params.event.event.type The type of the event which is caught by the listener
846
+ * @param {object} params.event Event object
847
+ * @param {{[key: string]: any, type: string}} params.event.event The Object that contains event details
848
+ * @param {string} params.event.event.type The type of the event which is caught by the listener
907
849
  */
908
850
  (e: 'catchAll', params: ((event: {[key: string]: any, type: string}) => void)|string): void
909
851
  /**
910
852
  * Fired when this field's value changes.
911
853
  * @param {string} e Event name
912
854
  * @param {object} params Event parameters
913
- * @param {string} params.e Event name
914
- * @param {object} params.params Event parameters
915
- * @param {object} params.params.event Event object
916
- * @param {Core.widget.Field,any} params.params.event.source This Field
917
- * @param {string,number,boolean,any} params.params.event.value This field's value
918
- * @param {string,number,boolean,any} params.params.event.oldValue This field's previous value
919
- * @param {boolean} params.params.event.valid True if this field is in a valid state
920
- * @param {Event} params.params.event.event The triggering DOM event if any
921
- * @param {boolean} params.params.event.userAction Triggered by user taking an action (`true`) or by setting a value (`false`)
922
- * @param {boolean} params.params.event.checked
855
+ * @param {object} params.event Event object
856
+ * @param {Core.widget.Field,any} params.event.source This Field
857
+ * @param {string,number,boolean,any} params.event.value This field's value
858
+ * @param {string,number,boolean,any} params.event.oldValue This field's previous value
859
+ * @param {boolean} params.event.valid True if this field is in a valid state
860
+ * @param {Event} params.event.event The triggering DOM event if any
861
+ * @param {boolean} params.event.userAction Triggered by user taking an action (`true`) or by setting a value (`false`)
862
+ * @param {boolean} params.event.checked
923
863
  */
924
864
  (e: 'change', params: ((event: { source: Field|any, value: string|number|boolean|any, oldValue: string|number|boolean|any, valid: boolean, event: Event, userAction: boolean, checked: boolean }) => void)|string): void
925
865
  /**
926
866
  * Fired when this field is [cleared](https://bryntum.com/products/scheduler/docs/api/Core/widget/Field#function-clear).
927
- * ...
928
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#event-clear)
867
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#event-clear)
929
868
  * @param {string} e Event name
930
869
  * @param {object} params Event parameters
931
- * @param {string} params.e Event name
932
- * @param {object} params.params Event parameters
933
- * @param {object} params.params.event Event object
934
- * @param {Core.widget.Field,any} params.params.event.source This Field
870
+ * @param {object} params.event Event object
871
+ * @param {Core.widget.Field,any} params.event.source This Field
935
872
  */
936
873
  (e: 'clear', params: ((event: { source: Field|any }) => void)|string): void
937
874
  /**
938
875
  * Fires when an object is destroyed.
939
876
  * @param {string} e Event name
940
877
  * @param {object} params Event parameters
941
- * @param {string} params.e Event name
942
- * @param {object} params.params Event parameters
943
- * @param {object} params.params.event Event object
944
- * @param {Core.Base} params.params.event.source The Object that is being destroyed.
878
+ * @param {object} params.event Event object
879
+ * @param {Core.Base} params.event.source The Object that is being destroyed.
945
880
  */
946
881
  (e: 'destroy', params: ((event: { source: Base }) => void)|string): void
947
882
  /**
948
883
  * Triggered when a widget's [element](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#property-element) is available.
949
884
  * @param {string} e Event name
950
885
  * @param {object} params Event parameters
951
- * @param {string} params.e Event name
952
- * @param {object} params.params Event parameters
953
- * @param {object} params.params.event Event object
954
- * @param {HTMLElement} params.params.event.element The Widget's element.
886
+ * @param {object} params.event Event object
887
+ * @param {HTMLElement} params.event.element The Widget's element.
955
888
  */
956
889
  (e: 'elementCreated', params: ((event: { element: HTMLElement }) => void)|string): void
957
890
  /**
958
891
  * Fired when focus enters this Widget.
959
892
  * @param {string} e Event name
960
893
  * @param {object} params Event parameters
961
- * @param {string} params.e Event name
962
- * @param {object} params.params Event parameters
963
- * @param {object} params.params.event Event object
964
- * @param {Core.widget.Widget} params.params.event.source This Widget
965
- * @param {HTMLElement} params.params.event.fromElement The element which lost focus.
966
- * @param {HTMLElement} params.params.event.toElement The element which gained focus.
967
- * @param {Core.widget.Widget} params.params.event.fromWidget The widget which lost focus.
968
- * @param {Core.widget.Widget} params.params.event.toWidget The widget which gained focus.
969
- * @param {boolean} params.params.event.backwards `true` if the `toElement` is before the `fromElement` in document order.
894
+ * @param {object} params.event Event object
895
+ * @param {Core.widget.Widget} params.event.source This Widget
896
+ * @param {HTMLElement} params.event.fromElement The element which lost focus.
897
+ * @param {HTMLElement} params.event.toElement The element which gained focus.
898
+ * @param {Core.widget.Widget} params.event.fromWidget The widget which lost focus.
899
+ * @param {Core.widget.Widget} params.event.toWidget The widget which gained focus.
900
+ * @param {boolean} params.event.backwards `true` if the `toElement` is before the `fromElement` in document order.
970
901
  */
971
902
  (e: 'focusIn', params: ((event: { source: Widget, fromElement: HTMLElement, toElement: HTMLElement, fromWidget: Widget, toWidget: Widget, backwards: boolean }) => void)|string): void
972
903
  /**
@@ -975,25 +906,21 @@ const emit = defineEmits<{
975
906
  * will not trigger this event. This is when focus exits this widget completely.
976
907
  * @param {string} e Event name
977
908
  * @param {object} params Event parameters
978
- * @param {string} params.e Event name
979
- * @param {object} params.params Event parameters
980
- * @param {object} params.params.event Event object
981
- * @param {Core.widget.Widget} params.params.event.source This Widget
982
- * @param {HTMLElement} params.params.event.fromElement The element which lost focus.
983
- * @param {HTMLElement} params.params.event.toElement The element which gained focus.
984
- * @param {Core.widget.Widget} params.params.event.fromWidget The widget which lost focus.
985
- * @param {Core.widget.Widget} params.params.event.toWidget The widget which gained focus.
986
- * @param {boolean} params.params.event.backwards `true` if the `toElement` is before the `fromElement` in document order.
909
+ * @param {object} params.event Event object
910
+ * @param {Core.widget.Widget} params.event.source This Widget
911
+ * @param {HTMLElement} params.event.fromElement The element which lost focus.
912
+ * @param {HTMLElement} params.event.toElement The element which gained focus.
913
+ * @param {Core.widget.Widget} params.event.fromWidget The widget which lost focus.
914
+ * @param {Core.widget.Widget} params.event.toWidget The widget which gained focus.
915
+ * @param {boolean} params.event.backwards `true` if the `toElement` is before the `fromElement` in document order.
987
916
  */
988
917
  (e: 'focusOut', params: ((event: { source: Widget, fromElement: HTMLElement, toElement: HTMLElement, fromWidget: Widget, toWidget: Widget, backwards: boolean }) => void)|string): void
989
918
  /**
990
919
  * Triggered after a widget was hidden
991
920
  * @param {string} e Event name
992
921
  * @param {object} params Event parameters
993
- * @param {string} params.e Event name
994
- * @param {object} params.params Event parameters
995
- * @param {object} params.params.event Event object
996
- * @param {Core.widget.Widget} params.params.event.source The widget
922
+ * @param {object} params.event Event object
923
+ * @param {Core.widget.Widget} params.event.source The widget
997
924
  */
998
925
  (e: 'hide', params: ((event: { source: Widget }) => void)|string): void
999
926
  /**
@@ -1001,36 +928,29 @@ const emit = defineEmits<{
1001
928
  * not the combos value
1002
929
  * @param {string} e Event name
1003
930
  * @param {object} params Event parameters
1004
- * @param {string} params.e Event name
1005
- * @param {object} params.params Event parameters
1006
- * @param {object} params.params.event Event object
1007
- * @param {Core.widget.Combo} params.params.event.source The combo.
1008
- * @param {string} params.params.event.value Raw input value
1009
- * @param {Event} params.params.event.event The triggering DOM event if any.
931
+ * @param {object} params.event Event object
932
+ * @param {Core.widget.Combo} params.event.source The combo.
933
+ * @param {string} params.event.value Raw input value
934
+ * @param {Event} params.event.event The triggering DOM event if any.
1010
935
  */
1011
936
  (e: 'input', params: ((event: { source: Combo, value: string, event: Event }) => void)|string): void
1012
937
  /**
1013
938
  * Triggered when a widget which had been in a non-visible state for any reason
1014
939
  * achieves visibility.
1015
- * ...
1016
- * [View online docs...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#event-paint)
940
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#event-paint)
1017
941
  * @param {string} e Event name
1018
942
  * @param {object} params Event parameters
1019
- * @param {string} params.e Event name
1020
- * @param {object} params.params Event parameters
1021
- * @param {object} params.params.event Event object
1022
- * @param {Core.widget.Widget} params.params.event.source The widget being painted.
1023
- * @param {boolean} params.params.event.firstPaint `true` if this is the first paint.
943
+ * @param {object} params.event Event object
944
+ * @param {Core.widget.Widget} params.event.source The widget being painted.
945
+ * @param {boolean} params.event.firstPaint `true` if this is the first paint.
1024
946
  */
1025
947
  (e: 'paint', params: ((event: { source: Widget, firstPaint: boolean }) => void)|string): void
1026
948
  /**
1027
949
  * Fired when a Widget's read only state is toggled
1028
950
  * @param {string} e Event name
1029
951
  * @param {object} params Event parameters
1030
- * @param {string} params.e Event name
1031
- * @param {object} params.params Event parameters
1032
- * @param {object} params.params.event Event object
1033
- * @param {boolean} params.params.event.readOnly Read only or not
952
+ * @param {object} params.event Event object
953
+ * @param {boolean} params.event.readOnly Read only or not
1034
954
  */
1035
955
  (e: 'readOnly', params: ((event: { readOnly: boolean }) => void)|string): void
1036
956
  /**
@@ -1042,48 +962,40 @@ const emit = defineEmits<{
1042
962
  * Fired when the encapsulating element of a Widget resizes *only when [monitorResize](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#config-monitorResize) is `true`*.
1043
963
  * @param {string} e Event name
1044
964
  * @param {object} params Event parameters
1045
- * @param {string} params.e Event name
1046
- * @param {object} params.params Event parameters
1047
- * @param {object} params.params.event Event object
1048
- * @param {Core.widget.Widget} params.params.event.source This Widget
1049
- * @param {number} params.params.event.width The new width
1050
- * @param {number} params.params.event.height The new height
1051
- * @param {number} params.params.event.oldWidth The old width
1052
- * @param {number} params.params.event.oldHeight The old height
965
+ * @param {object} params.event Event object
966
+ * @param {Core.widget.Widget} params.event.source This Widget
967
+ * @param {number} params.event.width The new width
968
+ * @param {number} params.event.height The new height
969
+ * @param {number} params.event.oldWidth The old width
970
+ * @param {number} params.event.oldHeight The old height
1053
971
  */
1054
972
  (e: 'resize', params: ((event: { source: Widget, width: number, height: number, oldWidth: number, oldHeight: number }) => void)|string): void
1055
973
  /**
1056
974
  * An item in the list was selected
1057
975
  * @param {string} e Event name
1058
976
  * @param {object} params Event parameters
1059
- * @param {string} params.e Event name
1060
- * @param {object} params.params Event parameters
1061
- * @param {object} params.params.event Event object
1062
- * @param {Core.widget.Combo} params.params.event.source The combo
1063
- * @param {Core.data.Model} params.params.event.record Selected record
1064
- * @param {Core.data.Model[]} params.params.event.records Selected records as an array if [multiSelect](https://bryntum.com/products/scheduler/docs/api/Core/widget/Combo#config-multiSelect) is `true`
1065
- * @param {boolean} params.params.event.userAction `true` if the value change is due to user interaction
977
+ * @param {object} params.event Event object
978
+ * @param {Core.widget.Combo} params.event.source The combo
979
+ * @param {Core.data.Model} params.event.record Selected record
980
+ * @param {Core.data.Model[]} params.event.records Selected records as an array if [multiSelect](https://bryntum.com/products/scheduler/docs/api/Core/widget/Combo#config-multiSelect) is `true`
981
+ * @param {boolean} params.event.userAction `true` if the value change is due to user interaction
1066
982
  */
1067
983
  (e: 'select', params: ((event: { source: Combo, record: Model, records: Model[], userAction: boolean }) => void)|string): void
1068
984
  /**
1069
985
  * Triggered after a widget is shown.
1070
986
  * @param {string} e Event name
1071
987
  * @param {object} params Event parameters
1072
- * @param {string} params.e Event name
1073
- * @param {object} params.params Event parameters
1074
- * @param {object} params.params.event Event object
1075
- * @param {Core.widget.Widget} params.params.event.source The widget
988
+ * @param {object} params.event Event object
989
+ * @param {Core.widget.Widget} params.event.source The widget
1076
990
  */
1077
991
  (e: 'show', params: ((event: { source: Widget }) => void)|string): void
1078
992
  /**
1079
993
  * User clicked one of this field's [triggers](https://bryntum.com/products/scheduler/docs/api/Core/widget/Field#property-triggers)
1080
994
  * @param {string} e Event name
1081
995
  * @param {object} params Event parameters
1082
- * @param {string} params.e Event name
1083
- * @param {object} params.params Event parameters
1084
- * @param {object} params.params.event Event object
1085
- * @param {Core.widget.Field,any} params.params.event.source This field
1086
- * @param {Core.widget.Widget} params.params.event.trigger The trigger activated by click or touch tap.
996
+ * @param {object} params.event Event object
997
+ * @param {Core.widget.Field,any} params.event.source This field
998
+ * @param {Core.widget.Widget} params.event.trigger The trigger activated by click or touch tap.
1087
999
  */
1088
1000
  (e: 'trigger', params: ((event: { source: Field|any, trigger: Widget }) => void)|string): void
1089
1001
  }>();
@@ -1105,6 +1017,7 @@ const widgetData = {
1105
1017
  'cacheLastResult',
1106
1018
  'caseSensitive',
1107
1019
  'centered',
1020
+ 'checkValidity',
1108
1021
  'chipView',
1109
1022
  'clearable',
1110
1023
  'clearTextOnPickerHide',
@@ -1175,6 +1088,7 @@ const widgetData = {
1175
1088
  'relayStoreEvents',
1176
1089
  'revertOnEscape',
1177
1090
  'ripple',
1091
+ 'role',
1178
1092
  'rootElement',
1179
1093
  'scrollAction',
1180
1094
  'showAnimation',
@@ -1259,9 +1173,7 @@ const widgetData = {
1259
1173
  'y'
1260
1174
  ],
1261
1175
  propertyNames : [
1262
- 'anchorSize',
1263
1176
  'content',
1264
- 'focusVisible',
1265
1177
  'formula',
1266
1178
  'html',
1267
1179
  'input',