@bryntum/taskboard-angular-thin 7.1.1 → 7.1.3

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 (26) hide show
  1. package/README.md +295 -15
  2. package/package.json +1 -1
  3. package/src/lib/bryntum-column-combo.component.ts +1646 -0
  4. package/src/lib/bryntum-column-filter-field.component.ts +1361 -0
  5. package/src/lib/bryntum-column-picker-button.component.ts +1201 -0
  6. package/src/lib/bryntum-column-scroll-button.component.ts +1201 -0
  7. package/src/lib/bryntum-project-combo.component.ts +1649 -0
  8. package/src/lib/bryntum-resources-combo.component.ts +1645 -0
  9. package/src/lib/bryntum-swimlane-combo.component.ts +1645 -0
  10. package/src/lib/bryntum-swimlane-filter-field.component.ts +1378 -0
  11. package/src/lib/bryntum-swimlane-picker-button.component.ts +1201 -0
  12. package/src/lib/bryntum-swimlane-scroll-button.component.ts +1201 -0
  13. package/src/lib/bryntum-tag-combo.component.ts +1652 -0
  14. package/src/lib/bryntum-task-board-base.component.ts +2389 -0
  15. package/src/lib/bryntum-task-board-field-filter-picker-group.component.ts +1317 -0
  16. package/src/lib/bryntum-task-board-field-filter-picker.component.ts +1255 -0
  17. package/src/lib/bryntum-task-board-project-model.component.ts +1027 -0
  18. package/src/lib/bryntum-task-board.component.ts +2393 -0
  19. package/src/lib/bryntum-task-color-combo.component.ts +1335 -0
  20. package/src/lib/bryntum-task-filter-field.component.ts +1378 -0
  21. package/src/lib/bryntum-todo-list-field.component.ts +1319 -0
  22. package/src/lib/bryntum-undo-redo.component.ts +1180 -0
  23. package/src/lib/bryntum-zoom-slider.component.ts +1123 -0
  24. package/src/lib/taskboard.module.ts +79 -0
  25. package/src/lib/wrapper.helper.ts +89 -0
  26. package/src/public-api.ts +26 -0
@@ -0,0 +1,1646 @@
1
+ /* eslint-disable @typescript-eslint/no-unused-vars */
2
+ /**
3
+ * Angular wrapper for Bryntum ColumnCombo
4
+ */
5
+
6
+ import { Component, ElementRef, EventEmitter, Output, Input, SimpleChange, SimpleChanges, OnDestroy, OnInit } from '@angular/core';
7
+
8
+ import WrapperHelper from './wrapper.helper';
9
+
10
+ import { AlignSpec, Base, ChipViewConfig, CollectionCompareOperator, CollectionFilterConfig, Combo, ComboModel, DomConfig, Duration, DurationConfig, Field, FieldContainer, FieldContainerConfig, FieldTriggerConfig, KeyMapConfig, List, ListConfig, MaskConfig, Model, Rectangle, Scroller, TabConfig, TooltipConfig, VueConfig, Widget } from '@bryntum/core-thin';
11
+ import { ColumnCombo, ColumnComboListeners, TaskBoardContainerItemConfig, TaskBoard } from '@bryntum/taskboard-thin';
12
+
13
+ import { StringHelper } from '@bryntum/core-thin';
14
+
15
+ export type BryntumColumnComboProps = {
16
+ // Configs
17
+ /**
18
+ * Element (or element id) to adopt as this Widget's encapsulating element. The widget's
19
+ * content will be placed inside this element.
20
+ * ...
21
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-adopt)
22
+ */
23
+ adopt ? : HTMLElement|string
24
+ /**
25
+ * *Only valid if this Widget is [floating](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#config-floating).*
26
+ * ...
27
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-align)
28
+ */
29
+ align ? : AlignSpec|string
30
+ /**
31
+ * When this widget is a child of a [Container](https://bryntum.com/products/taskboard/docs/api/Core/widget/Container), it will by default be participating in a
32
+ * flexbox layout. This config allows you to set this widget's
33
+ * [align-self](https://developer.mozilla.org/en-US/docs/Web/CSS/align-self) style.
34
+ */
35
+ alignSelf ? : string
36
+ /**
37
+ * *Only valid if this Widget is [floating](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#config-floating) and being shown through [showBy](#Core/widget/Widget#function-showBy).*
38
+ * `true` to show a connector arrow pointing to the align target.
39
+ */
40
+ anchor ? : boolean
41
+ /**
42
+ * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
43
+ * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#property-element).
44
+ */
45
+ appendTo ? : HTMLElement|string
46
+ /**
47
+ * A localizable string (May contain `'L{}'` tokens which resolve in the locale file) to inject
48
+ * into an element which will be linked using the `aria-describedby` attribute.
49
+ * ...
50
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-ariaDescription)
51
+ */
52
+ ariaDescription ? : string
53
+ /**
54
+ * A localizable string (May contain `'L{}'` tokens which resolve in the locale file) to inject as
55
+ * the `aria-label` attribute.
56
+ * ...
57
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-ariaLabel)
58
+ */
59
+ ariaLabel ? : string
60
+ /**
61
+ * Sets the native `autocomplete` property of the underlying input element. For more information, please refer to
62
+ * [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete)
63
+ */
64
+ autoComplete ? : string
65
+ /**
66
+ * Configure as `true` to have the picker expand upon focus enter.
67
+ */
68
+ autoExpand ? : boolean
69
+ /**
70
+ * Specify `true` to auto select field contents on focus
71
+ */
72
+ autoSelect ? : boolean
73
+ /**
74
+ * Initial text to show in badge.
75
+ */
76
+ badge ? : string
77
+ /**
78
+ * An object where property names with a truthy value indicate which events should bubble up the ownership
79
+ * hierarchy when triggered.
80
+ * ...
81
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-bubbleEvents)
82
+ */
83
+ bubbleEvents ? : object
84
+ /**
85
+ * Enable caching of the last retrieved result until the timeout is reached.
86
+ * ...
87
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-cacheLastResult)
88
+ */
89
+ cacheLastResult ? : number|string|Duration|DurationConfig
90
+ /**
91
+ * Set to `false` to not call onXXX method names (e.g. `onShow`, `onClick`), as an easy way to listen for events.
92
+ * ...
93
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-callOnFunctions)
94
+ */
95
+ callOnFunctions ? : boolean
96
+ /**
97
+ * Configure as `true` to force case matching when filtering the dropdown list based upon the typed value.
98
+ */
99
+ caseSensitive ? : boolean
100
+ /**
101
+ * By default, if an event handler throws an exception, the error propagates up the stack and the
102
+ * application state is undefined. Code which follows the event handler will *not* be executed.
103
+ * ...
104
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-catchEventHandlerExceptions)
105
+ */
106
+ catchEventHandlerExceptions ? : boolean
107
+ /**
108
+ * *Only valid if this Widget is [floating](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#config-floating).*
109
+ * Set to `true` to centre the Widget in browser viewport space.
110
+ */
111
+ centered ? : boolean
112
+ /**
113
+ * A config object to configure the [ChipView](https://bryntum.com/products/taskboard/docs/api/Core/widget/ChipView) to display the
114
+ * selected value set when [multiSelect](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#config-multiSelect) is `true`.
115
+ * ...
116
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-chipView)
117
+ */
118
+ chipView ? : ChipViewConfig
119
+ /**
120
+ * Show a trigger to clear field, if this field is not [readOnly](https://bryntum.com/products/taskboard/docs/api/Core/widget/Field#config-readOnly). The trigger is available
121
+ * in the [triggers](https://bryntum.com/products/taskboard/docs/api/Core/widget/Field#property-triggers) object under the name `clear`. May also be an object which
122
+ * configures the `clear` [trigger](https://bryntum.com/products/taskboard/docs/api/Core/widget/Field#property-triggers).
123
+ */
124
+ clearable ? : boolean|FieldTriggerConfig
125
+ /**
126
+ * `true` to clear value typed to a multiselect combo when picker is collapsed
127
+ */
128
+ clearTextOnPickerHide ? : boolean
129
+ /**
130
+ * Specify `false` to not clear value typed to a multiselect combo when an item is selected.
131
+ */
132
+ clearTextOnSelection ? : boolean
133
+ /**
134
+ * Set to `true` to clear this field when user empties the input element
135
+ */
136
+ clearWhenInputEmpty ? : boolean
137
+ /**
138
+ * Custom CSS classes to add to element.
139
+ * May be specified as a space separated string, or as an object in which property names
140
+ * with truthy values are used as the class names:
141
+ * ...
142
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-cls)
143
+ */
144
+ cls ? : string|object
145
+ /**
146
+ * Applies the specified color to the widget, by setting the `--b-primary` CSS variable in the widgets
147
+ * `style` block.
148
+ * ...
149
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-color)
150
+ */
151
+ color ? : string
152
+ /**
153
+ * Programmatic control over which column to start in when used in a grid layout.
154
+ */
155
+ column ? : number
156
+ config ? : object
157
+ /**
158
+ * *Only valid if this Widget is [floating](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#config-floating) or [positioned](#Core/widget/Widget#config-positioned).*
159
+ * Element, Widget or Rectangle to which this Widget is constrained.
160
+ */
161
+ constrainTo ? : HTMLElement|Widget|Rectangle
162
+ /**
163
+ * The configuration for additional items associated to this field. This is typically used to add contextual
164
+ * fields related to a [checkbox](https://bryntum.com/products/taskboard/docs/api/Core/widget/Checkbox) or [radio button](#Core/widget/Radio). See
165
+ * these classes for examples of nested fields.
166
+ * ...
167
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-container)
168
+ */
169
+ container ? : Record<string, TaskBoardContainerItemConfig>|TaskBoardContainerItemConfig[]|FieldContainerConfig|FieldContainer
170
+ /**
171
+ * The config controls how the value of nested items are handled when a parent container gets or sets its
172
+ * [values](https://bryntum.com/products/taskboard/docs/api/Core/widget/Container#property-values).
173
+ * ...
174
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-containValues)
175
+ * @param {Core.widget.Field} field Field instance
176
+ * @returns {boolean}
177
+ */
178
+ containValues ? : boolean|string|((field: Field) => boolean)
179
+ /**
180
+ * Custom CSS classes to add to the [contentElement](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#property-contentElement).
181
+ * May be specified as a space separated string, or as an object in which property names
182
+ * with truthy values are used as the class names:
183
+ * ...
184
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-contentElementCls)
185
+ */
186
+ contentElementCls ? : string|object
187
+ /**
188
+ * If configured as `true`, this means that when an unmatched string is typed into the
189
+ * combo's input field, and `ENTER`, or the [multiValueSeparator](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#config-multiValueSeparator) is typed,
190
+ * a new record will be created using the typed string as the [displayField](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#config-displayField).
191
+ * ...
192
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-createOnUnmatched)
193
+ * @param {string} name Record name
194
+ * @param {Core.widget.Combo} combo Combo instance
195
+ * @returns {Core.data.Model} New record
196
+ */
197
+ createOnUnmatched ? : ((name: string, combo: Combo) => Model)|string|boolean
198
+ /**
199
+ * When this Widget configuration is used in the Grid's RowExpander feature's `widget` config, provide the
200
+ * field on the expanded record to use for populating this widget's store (if applicable)
201
+ */
202
+ dataField ? : string
203
+ /**
204
+ * Object to apply to elements dataset (each key will be used as a data-attribute on the element)
205
+ */
206
+ dataset ? : Record<string, string>
207
+ /**
208
+ * The name of the property to set when a single value is to be applied to this Widget. Such as when used
209
+ * in a grid WidgetColumn, this is the property to which the column's `field` is applied.
210
+ */
211
+ defaultBindProperty ? : string
212
+ /**
213
+ * Check for CSS compatibility issues when upgrading to v7. Performs the following checks:
214
+ * ...
215
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-detectCSSCompatibilityIssues)
216
+ */
217
+ detectCSSCompatibilityIssues ? : boolean
218
+ /**
219
+ * Disable or enable the widget. It is similar to [readOnly](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#config-readOnly) except a disabled widget
220
+ * cannot be focused, uses a different rendition (usually greyish) and does not allow selecting its value.
221
+ * ...
222
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-disabled)
223
+ */
224
+ disabled ? : boolean|'inert'
225
+ /**
226
+ * Field used for item text when populating from store
227
+ */
228
+ displayField ? : string
229
+ /**
230
+ * Template function that can be used to customize the displayed value
231
+ * @param {Core.data.Model} record The record to provide a textual value for
232
+ * @param {Core.widget.Combo} combo A reference to this Combo
233
+ * @returns {string,void}
234
+ */
235
+ displayValueRenderer ? : (record: Model|ComboModel, combo: Combo) => string|void
236
+ /**
237
+ * Controls the placement of this widget when it is added to a [panel's ](https://bryntum.com/products/taskboard/docs/api/Core/widget/Panel)
238
+ * [strips collection](https://bryntum.com/products/taskboard/docs/api/Core/widget/Panel#config-strips). Typical values for this config are `'top'`,
239
+ * `'bottom'`, `'left'`, or `'right'`, which cause the widget to be placed on that side of the panel's
240
+ * body. Such widgets are called "edge strips".
241
+ * ...
242
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-dock)
243
+ */
244
+ dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
245
+ /**
246
+ * *Only valid if this Widget is [floating](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#config-floating).*
247
+ * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
248
+ * property which controls when a drag should start.
249
+ * ...
250
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-draggable)
251
+ */
252
+ draggable ? : boolean|{
253
+ handleSelector?: string
254
+ }
255
+ /**
256
+ * User can edit text in text field (otherwise only pick from attached picker)
257
+ */
258
+ editable ? : boolean
259
+ /**
260
+ * An object specifying attributes to assign to the root element of this widget.
261
+ * Set `null` value to attribute to remove it.
262
+ * ...
263
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-elementAttributes)
264
+ */
265
+ elementAttributes ? : Record<string, string|null>
266
+ /**
267
+ * Text to display in the drop down when there are no items in the underlying store.
268
+ * ...
269
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-emptyText)
270
+ */
271
+ emptyText ? : string
272
+ /**
273
+ * A function which creates an array of values for the [filterParamName](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#config-filterParamName) to pass
274
+ * any filters to the server upon load.
275
+ * ...
276
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-encodeFilterParams)
277
+ * @param {object[]} filters filters
278
+ * @returns {object[]} array of values
279
+ */
280
+ encodeFilterParams ? : (filters: object[]) => object[]
281
+ /**
282
+ * By default, the combo will show a configured "catch-all" column (a column with its id set to `*`). In
283
+ * some cases, e.g. when used in a task editor, you may want to exclude that column from the combo.
284
+ */
285
+ excludeCatchAll ? : boolean
286
+ extraData ? : any
287
+ /**
288
+ * If `false`, filtering will be triggered once you exceed [minChars](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#config-minChars). To filter only when
289
+ * hitting Enter key, set this to `true`;
290
+ */
291
+ filterOnEnter ? : boolean
292
+ /**
293
+ * The name of an operator type as implemented in [operator](https://bryntum.com/products/taskboard/docs/api/Core/util/CollectionFilter#config-operator)
294
+ * to use when filtering the dropdown list based upon the typed value.
295
+ * ...
296
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-filterOperator)
297
+ */
298
+ filterOperator ? : CollectionCompareOperator
299
+ /**
300
+ * If the dropdown is to be populated with a filtered query to a remote server, specify the
301
+ * name of the parameter to pass the typed string here. By default, the string is simply sent
302
+ * as the value of the parameter. For special encoding, configure the combo with [encodeFilterParams](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#config-encodeFilterParams)
303
+ */
304
+ filterParamName ? : string
305
+ /**
306
+ * When [multiSelect](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#config-multiSelect) is `true`, you may configure `filterSelected` as
307
+ * `true` to hide items in the dropdown when they are added to the selection.
308
+ * It will appear as if the requested item has "moved" into the field's
309
+ * [ChipView](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#config-chipView).
310
+ */
311
+ filterSelected ? : boolean
312
+ /**
313
+ * When this widget is a child of a [Container](https://bryntum.com/products/taskboard/docs/api/Core/widget/Container), it will by default be participating in a
314
+ * flexbox layout. This config allows you to set this widget's
315
+ * [flex](https://developer.mozilla.org/en-US/docs/Web/CSS/flex) style.
316
+ * This may be configured as a single number or a `&lt;flex-grow&gt; &lt;flex-shrink&gt; &lt;flex-basis&gt;` format string.
317
+ * numeric-only values are interpreted as the `flex-grow` value.
318
+ */
319
+ flex ? : number|string
320
+ /**
321
+ * Set to `true` to move the widget out of the document flow and position it
322
+ * absolutely in browser viewport space.
323
+ */
324
+ floating ? : boolean
325
+ /**
326
+ * Widget's height, used to set element `style.height`. Either specify a valid height string or a number,
327
+ * which will get 'px' appended. We recommend using CSS as the primary way to control height, but in some
328
+ * cases this config is convenient.
329
+ */
330
+ height ? : string|number
331
+ /**
332
+ * Configure with true to make widget initially hidden.
333
+ */
334
+ hidden ? : boolean
335
+ /**
336
+ * *Only valid if this Widget is [floating](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#config-floating).*
337
+ * ...
338
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-hideAnimation)
339
+ */
340
+ hideAnimation ? : boolean|object
341
+ /**
342
+ * By default, the picker is hidden on selection in single select mode, and
343
+ * remains to allow more selections when [multiSelect](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#config-multiSelect) is `true`.
344
+ * Setting this to a `Boolean` value can override that default.
345
+ */
346
+ hidePickerOnSelect ? : boolean
347
+ /**
348
+ * Configure as `true` to hide the expand trigger. This is automatically set to `true` if
349
+ * remote filtering is enabled by setting the [filterParamName](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#config-filterParamName) config.
350
+ */
351
+ hideTrigger ? : boolean
352
+ /**
353
+ * Specify `true` to highlight field after external value changes
354
+ */
355
+ highlightExternalChange ? : boolean
356
+ /**
357
+ * An optional string to display inside the input field as an overlay. This can be useful for displaying
358
+ * a field's units.
359
+ * ...
360
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-hint)
361
+ * @param {object} data A data object
362
+ * @param {Core.widget.Field} data.source A reference to the field instance
363
+ * @param {any} data.value The current value of the field
364
+ * @returns {string}
365
+ */
366
+ hint ? : string|((data: { source: Field, value: any }) => string)
367
+ /**
368
+ * This config is similar to [hint](https://bryntum.com/products/taskboard/docs/api/Core/widget/Field#config-hint) except that this config is used to display HTML content.
369
+ * Since this can allow malicious content to be executed, be sure not to include user-entered data or to
370
+ * encode such data (see [encodeHtml](https://bryntum.com/products/taskboard/docs/api/Core/helper/StringHelper#function-encodeHtml-static)).
371
+ * ...
372
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-hintHtml)
373
+ * @param {object} data A data object
374
+ * @param {Core.widget.Field} data.source A reference to the field instance
375
+ * @param {any} data.value The current value of the field
376
+ * @returns {string}
377
+ */
378
+ hintHtml ? : string|((data: { source: Field, value: any }) => string)
379
+ /**
380
+ * Widget id, if not specified one will be generated. Also used for lookups through Widget.getById
381
+ */
382
+ id ? : string
383
+ /**
384
+ * Determines if the widgets read-only state should be controlled by its parent.
385
+ * ...
386
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-ignoreParentReadOnly)
387
+ */
388
+ ignoreParentReadOnly ? : boolean
389
+ /**
390
+ * Only applies when using a "catch-all" column (a column with its id set to `*`). By default, the combo will
391
+ * include only the columns defined in the TaskBoard. With this config you can opt to include all column values
392
+ * from the tasks, even those that are not defined in the TaskBoard.
393
+ */
394
+ includeAllColumnValues ? : boolean
395
+ /**
396
+ * Set this config to `true` to always display items horizontally along with this field. This assigns an
397
+ * [hbox](https://bryntum.com/products/taskboard/docs/api/Core/widget/layout/Box) as the [layout](#Core/widget/Container#config-layout) to the
398
+ * [container](https://bryntum.com/products/taskboard/docs/api/Core/widget/Field#config-container).
399
+ * ...
400
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-inline)
401
+ */
402
+ inline ? : boolean
403
+ /**
404
+ * Configure this as `true` to render the dropdown list as a permanently visible list
405
+ * in the document flow immediately below the input area instead of as a popup.
406
+ * ...
407
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-inlinePicker)
408
+ */
409
+ inlinePicker ? : boolean
410
+ /**
411
+ * Text alignment for the input field.
412
+ */
413
+ inputAlign ? : string
414
+ /**
415
+ * Sets custom attributes of the underlying input element. For more information, please refer to
416
+ * [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes)
417
+ */
418
+ inputAttributes ? : Record<string, string>
419
+ /**
420
+ * If you need to use something else than a default `input` element, as the input element, provide the tag
421
+ * name here. Please note that this is used for advanced usage only, for example when using WebComponents
422
+ * (custom elements), and that the configured element must fulfil the same contract as a regular input
423
+ * element.
424
+ */
425
+ inputTag ? : string
426
+ /**
427
+ * Sets the `type` attribute of the underlying input element (password, hidden, date, color, etc.).
428
+ */
429
+ inputType ? : string
430
+ /**
431
+ * The width to apply to the `.b-field-inner` element, which encompasses the `input` element and any
432
+ * triggers. If a number is specified, `px` will be used.
433
+ */
434
+ inputWidth ? : string|number
435
+ /**
436
+ * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
437
+ */
438
+ insertBefore ? : HTMLElement|string
439
+ /**
440
+ * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
441
+ */
442
+ insertFirst ? : HTMLElement|string
443
+ /**
444
+ * An object whose keys are the [key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key) name
445
+ * and optional modifier prefixes: `'Ctrl+'`, `'Alt+'`, `'Meta+'`, and `'Shift+'` (case-insensitive). The values
446
+ * are the name of the instance method to call when the keystroke is received.
447
+ * ...
448
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-keyMap)
449
+ */
450
+ keyMap ? : Record<string, KeyMapConfig>
451
+ /**
452
+ * The delay in milliseconds to wait after the last keystroke before triggering a change event.
453
+ * Set to 0 to not trigger change events from keystrokes (listen for input event instead to have
454
+ * immediate feedback, change will still be triggered on blur).
455
+ * ...
456
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-keyStrokeChangeDelay)
457
+ */
458
+ keyStrokeChangeDelay ? : number
459
+ /**
460
+ * The delay in milliseconds to wait after the last keystroke before filtering the list.
461
+ * ...
462
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-keyStrokeFilterDelay)
463
+ */
464
+ keyStrokeFilterDelay ? : number
465
+ /**
466
+ * Label, prepended to field
467
+ */
468
+ label ? : string
469
+ /**
470
+ * CSS class name or class names to add to any configured [label](https://bryntum.com/products/taskboard/docs/api/Core/widget/mixin/Labelable#config-label)
471
+ */
472
+ labelCls ? : string|object
473
+ /**
474
+ * Label position, either 'before' the field or 'above' the field
475
+ * ...
476
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-labelPosition)
477
+ */
478
+ labelPosition ? : 'before'|'above'|null
479
+ /**
480
+ * The labels to add either before or after the input field.
481
+ * Each label may have the following properties:
482
+ * ...
483
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-labels)
484
+ */
485
+ labels ? : object[]
486
+ /**
487
+ * The width to apply to the `&lt;label&gt;` element. If a number is specified, `px` will be used.
488
+ */
489
+ labelWidth ? : string|number
490
+ /**
491
+ * CSS class to add to picker
492
+ */
493
+ listCls ? : string
494
+ /**
495
+ * The listener set for this object.
496
+ * ...
497
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-listeners)
498
+ */
499
+ listeners ? : ColumnComboListeners
500
+ /**
501
+ * Template string used to render the list items in the dropdown list
502
+ * ...
503
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-listItemTpl)
504
+ * @param {Core.data.Model} record The record representing the item being rendered
505
+ * @returns {string,void}
506
+ */
507
+ listItemTpl ? : (record: Model|ComboModel) => string|void
508
+ /**
509
+ * A class translations of which are used for translating this entity.
510
+ * This is often used when translations of an item are defined on its container class.
511
+ * For example:
512
+ * ...
513
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-localeClass)
514
+ */
515
+ localeClass ? : typeof Base
516
+ /**
517
+ * Set to `false` to disable localization of this object.
518
+ */
519
+ localizable ? : boolean
520
+ /**
521
+ * List of properties which values should be translated automatically upon a locale applying.
522
+ * In case there is a need to localize not typical value (not a String value or a field with re-defined setter/getter),
523
+ * you could use 'localeKey' meta configuration.
524
+ * Example:
525
+ * ...
526
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-localizableProperties)
527
+ */
528
+ localizableProperties ? : string[]
529
+ /**
530
+ * Widget's margin. This may be configured as a single number or a `TRBL` format string.
531
+ * numeric-only values are interpreted as pixels.
532
+ */
533
+ margin ? : number|string
534
+ /**
535
+ * This config object contains the defaults for the [Mask](https://bryntum.com/products/taskboard/docs/api/Core/widget/Mask) created for the
536
+ * [masked](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#config-masked) config. Any properties specified in the `masked` config will override these
537
+ * values.
538
+ */
539
+ maskDefaults ? : MaskConfig
540
+ /**
541
+ * Set to `true` to apply the default mask to the widget. Alternatively, this can be the mask message or a
542
+ * [Mask](https://bryntum.com/products/taskboard/docs/api/Core/widget/Mask) config object.
543
+ */
544
+ masked ? : boolean|string|MaskConfig
545
+ /**
546
+ * The element's maxHeight. Can be either a String or a Number (which will have 'px' appended). Note that
547
+ * like [height](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#config-height), *reading* the value will return the numeric value in pixels.
548
+ */
549
+ maxHeight ? : string|number
550
+ /**
551
+ * *Only valid if this Widget is [floating](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#config-floating).*
552
+ * ...
553
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-maximizeOnMobile)
554
+ */
555
+ maximizeOnMobile ? : number|string
556
+ /**
557
+ * The max number of characters for the input field
558
+ */
559
+ maxLength ? : number
560
+ /**
561
+ * The elements maxWidth. Can be either a String or a Number (which will have 'px' appended). Note that
562
+ * like [width](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#config-width), *reading* the value will return the numeric value in pixels.
563
+ */
564
+ maxWidth ? : string|number
565
+ /**
566
+ * The minimum string length to trigger the filtering, only relevant when [editable](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#config-editable) is `true`.
567
+ * ...
568
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-minChars)
569
+ */
570
+ minChars ? : number
571
+ /**
572
+ * The element's minHeight. Can be either a String or a Number (which will have 'px' appended). Note that
573
+ * like [height](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#config-height), *reading* the value will return the numeric value in pixels.
574
+ */
575
+ minHeight ? : string|number
576
+ /**
577
+ * The min number of characters for the input field
578
+ */
579
+ minLength ? : number
580
+ /**
581
+ * The elements minWidth. Can be either a String or a Number (which will have 'px' appended). Note that
582
+ * like [width](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#config-width), *reading* the value will return the numeric value in pixels.
583
+ */
584
+ minWidth ? : string|number
585
+ /**
586
+ * When this is configured as `true` a [ResizeObserver](https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver)
587
+ * is used to monitor this element for size changes caused by either style manipulation, or by CSS
588
+ * layout.
589
+ * ...
590
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-monitorResize)
591
+ */
592
+ monitorResize ? : boolean|{
593
+ immediate?: boolean
594
+ }
595
+ /**
596
+ * Set to `true` to allow selection of multiple values from the dropdown list.
597
+ * ...
598
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-multiSelect)
599
+ */
600
+ multiSelect ? : boolean
601
+ /**
602
+ * A key value which, when typed in a [multiSelect](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#config-multiSelect) Combo, selects the
603
+ * currently active item in the picker, and clears the input field ready for another
604
+ * match to be typed.
605
+ */
606
+ multiValueSeparator ? : string
607
+ /**
608
+ * Name of the field which is used as a key to get/set values from/to the field.
609
+ * Used prior to [ref](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#config-ref) and [id](#Core/widget/Widget#config-id) in
610
+ * [Container.values](https://bryntum.com/products/taskboard/docs/api/Core/widget/Container#property-values).
611
+ * ...
612
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-name)
613
+ */
614
+ name ? : string
615
+ /**
616
+ * This implies that the picker will display an anchor pointer, but also means that the picker will align closer
617
+ * to the input field so that the pointer pierces the [pickerAlignElement](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#config-pickerAlignElement)
618
+ */
619
+ overlayAnchor ? : boolean
620
+ /**
621
+ * The owning Widget of this Widget. If this Widget is directly contained (that is, it is one of the
622
+ * [items](https://bryntum.com/products/taskboard/docs/api/Core/widget/Container#property-items) of a Container), this config will be ignored. In this case
623
+ * the owner is <strong>always</strong> the encapsulating Container.
624
+ * ...
625
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-owner)
626
+ */
627
+ owner ? : Widget|any
628
+ /**
629
+ * Configuration object for the [picker](https://bryntum.com/products/taskboard/docs/api/Core/widget/List) on initialization. Returns the
630
+ * [picker](https://bryntum.com/products/taskboard/docs/api/Core/widget/List) instance at runtime.
631
+ * ...
632
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-picker)
633
+ */
634
+ picker ? : ListConfig|List
635
+ /**
636
+ * The name of the element property to which the picker should size and align itself.
637
+ */
638
+ pickerAlignElement ? : string
639
+ /**
640
+ * Width of picker, defaults to this combo's [pickerAlignElement](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#config-pickerAlignElement) width
641
+ */
642
+ pickerWidth ? : number|string
643
+ /**
644
+ * Text to display in empty field.
645
+ */
646
+ placeholder ? : string
647
+ /**
648
+ * Set to `true` when a widget is rendered into another widget's [contentElement](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#property-contentElement), but must
649
+ * not participate in the standard layout of that widget, and must be positioned relatively to that
650
+ * widget's [contentElement](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#property-contentElement).
651
+ * ...
652
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-positioned)
653
+ */
654
+ positioned ? : boolean
655
+ /**
656
+ * Prevent tooltip from being displayed on touch devices. Useful for example for buttons that display a
657
+ * menu on click etc, since the tooltip would be displayed at the same time.
658
+ */
659
+ preventTooltipOnTouch ? : boolean
660
+ /**
661
+ * Optionally a [Filter](https://bryntum.com/products/taskboard/docs/api/Core/util/CollectionFilter) config object which the combo should use for
662
+ * filtering using the typed value.
663
+ * This may use a `filterBy` property to test its `value` against any field in the passed record.
664
+ * ...
665
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-primaryFilter)
666
+ */
667
+ primaryFilter ? : CollectionFilterConfig
668
+ /**
669
+ * Makes the field unmodifiable by user action. The input area is not editable, and triggers
670
+ * are unresponsive.
671
+ * ...
672
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-readOnly)
673
+ */
674
+ readOnly ? : boolean
675
+ relayStoreEvents ? : boolean
676
+ /**
677
+ * Predefined style to use for the field. Possible values are:
678
+ * ...
679
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-rendition)
680
+ */
681
+ rendition ? : 'outlined'|'filled'|string
682
+ /**
683
+ * Configure as `true` to indicate that a `null` field value is to be marked as invalid. This will
684
+ * optionally append a * to the field label if [showRequiredIndicator](https://bryntum.com/products/taskboard/docs/api/Core/widget/Field#property-showRequiredIndicator) is set.
685
+ */
686
+ required ? : boolean
687
+ /**
688
+ * If this field is not [readOnly](https://bryntum.com/products/taskboard/docs/api/Core/widget/Field#config-readOnly), then setting this option means that pressing
689
+ * the `ESCAPE` key after editing the field will revert the field to the value it had when
690
+ * the user focused the field. If the field is *not* changed from when focused, the [clearable](https://bryntum.com/products/taskboard/docs/api/Core/widget/Field#config-clearable)
691
+ * behaviour will be activated.
692
+ */
693
+ revertOnEscape ? : boolean
694
+ /**
695
+ * Configure as `true` to have the component display a translucent ripple when its
696
+ * [focusElement](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#property-focusElement), or [element](#Core/widget/Widget#property-element) is tapped <em>if the
697
+ * current theme supports ripples</em>. Out of the box, only the Material theme supports ripples.
698
+ * ...
699
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-ripple)
700
+ */
701
+ ripple ? : boolean|{
702
+ delegate?: string
703
+ color?: string
704
+ radius?: number
705
+ clip?: string
706
+ }
707
+ /**
708
+ * 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`
709
+ */
710
+ rootElement ? : ShadowRoot|HTMLElement
711
+ /**
712
+ * This may be configured as `true` to make the widget's element use the `direction:rtl` style.
713
+ * ...
714
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-rtl)
715
+ */
716
+ rtl ? : boolean
717
+ /**
718
+ * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
719
+ * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
720
+ */
721
+ scrollAction ? : 'hide'|'realign'|null
722
+ /**
723
+ * *Only valid if this Widget is [floating](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#config-floating).*
724
+ * ...
725
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-showAnimation)
726
+ */
727
+ showAnimation ? : boolean|object
728
+ /**
729
+ * `true` to automatically display a * after the label for this field when it is [required](https://bryntum.com/products/taskboard/docs/api/Core/widget/Field#property-required).
730
+ */
731
+ showRequiredIndicator ? : string
732
+ /**
733
+ * Set to `false` to not show the tooltip when this widget is [disabled](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#property-disabled)
734
+ */
735
+ showTooltipWhenDisabled ? : boolean
736
+ /**
737
+ * Set to `true`, completely bypasses validation logic (could be userful if your field is not `editable`
738
+ * to the user).
739
+ */
740
+ skipValidation ? : boolean
741
+ /**
742
+ * Programmatic control over how many columns to span when used in a grid layout.
743
+ */
744
+ span ? : number
745
+ /**
746
+ * Sets the native `spellcheck` property of the underlying input element. For more information, please refer to
747
+ * [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/spellcheck)
748
+ */
749
+ spellCheck ? : boolean
750
+ /**
751
+ * A configuration for the [tab](https://bryntum.com/products/taskboard/docs/api/Core/widget/Tab) created for this widget when it is placed in a
752
+ * [TabPanel](https://bryntum.com/products/taskboard/docs/api/Core/widget/TabPanel). For example, this config can be used to control the icon of the `tab` for
753
+ * this widget:
754
+ * ...
755
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-tab)
756
+ */
757
+ tab ? : boolean|TabConfig
758
+ /**
759
+ * The tab index of the input field or fields, or `null` for natural tab order (recommended). Setting to `0`
760
+ * is equivalent to natural tab order, but is unnecessary for fields since they are naturally tabbable
761
+ * (i.e., accessible via the TAB key). Setting to `-1` disables tabbability but allows for focus to be set
762
+ * to the element programmatically.
763
+ * ...
764
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-tabIndex)
765
+ */
766
+ tabIndex ? : number
767
+ /**
768
+ * Auto detected when used within a TaskBoard. If you add the widget elsewhere, it will try to find an instance
769
+ * of TaskBoard on page. If that fails you have to supply this config to connect it to a TaskBoard manually.
770
+ * ...
771
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-taskBoard)
772
+ */
773
+ taskBoard ? : TaskBoard
774
+ /**
775
+ * Text alignment: 'left', 'center' or 'right'. Also accepts direction neutral 'start' and 'end'.
776
+ * ...
777
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-textAlign)
778
+ */
779
+ textAlign ? : 'left'|'center'|'right'|'start'|'end'
780
+ /**
781
+ * A title to display for the widget. Only in effect when inside a container that uses it (such as TabPanel)
782
+ */
783
+ title ? : string
784
+ /**
785
+ * Tooltip for the widget, either as a string or as a Tooltip config object.
786
+ * ...
787
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-tooltip)
788
+ */
789
+ tooltip ? : string|TooltipConfig|null
790
+ /**
791
+ * How to query the store upon click of the expand trigger. Specify one of these values:
792
+ * ...
793
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-triggerAction)
794
+ */
795
+ triggerAction ? : 'all'|'last'|null
796
+ /**
797
+ * The triggers to add either before or after the input field. Each property name is the reference by which
798
+ * an instantiated Trigger Widget may be retrieved from the live `triggers` property.
799
+ * ...
800
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-triggers)
801
+ */
802
+ triggers ? : Record<string, FieldTriggerConfig>|Record<string, Widget>
803
+ type ? : 'columncombo'
804
+ /**
805
+ * Custom CSS class name suffixes to apply to the elements rendered by this widget. This may be specified
806
+ * as a space separated string, an array of strings, or as an object in which property names with truthy
807
+ * values are used as the class names.
808
+ * ...
809
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-ui)
810
+ */
811
+ ui ? : string|object
812
+ /**
813
+ * `true` to cause the field to be in an invalid state while the typed filter string does not match a record in the store.
814
+ */
815
+ validateFilter ? : boolean
816
+ /**
817
+ * Set to `false` to not highlight a field as invalid while typing, to instead show it on ENTER key press
818
+ * or similar.
819
+ */
820
+ validateOnInput ? : boolean
821
+ /**
822
+ * The initial value of this Combo box. In single select mode (default) it's a simple string value, for
823
+ * [multiSelect](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#config-multiSelect) mode, it should be an array of record ids.
824
+ */
825
+ value ? : string|number|string[]|number[]
826
+ /**
827
+ * Field used for item value when populating from store. Setting this to `null` will
828
+ * yield the selected record as the Combo's [value](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#property-value).
829
+ * ...
830
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-valueField)
831
+ */
832
+ valueField ? : string|null
833
+ /**
834
+ * A widgets weight determines its position among siblings when added to a [Container](https://bryntum.com/products/taskboard/docs/api/Core/widget/Container).
835
+ * Higher weights go further down.
836
+ */
837
+ weight ? : number
838
+ /**
839
+ * Widget's width, used to set element `style.width`. Either specify a valid width string or a number, which
840
+ * will get 'px' appended. We recommend using CSS as the primary way to control width, but in some cases
841
+ * this config is convenient.
842
+ */
843
+ width ? : string|number
844
+ /**
845
+ * The x position for the widget.
846
+ * ...
847
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-x)
848
+ */
849
+ x ? : number
850
+ /**
851
+ * The y position for the widget.
852
+ * ...
853
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#config-y)
854
+ */
855
+ y ? : number
856
+
857
+ }
858
+
859
+ @Component({
860
+ selector : 'bryntum-column-combo',
861
+ template : ''
862
+ })
863
+ export class BryntumColumnComboComponent implements OnInit, OnDestroy {
864
+
865
+ public static instanceClass = ColumnCombo;
866
+
867
+ public static instanceName = 'ColumnCombo';
868
+
869
+ private static bryntumEvents: string[] = [
870
+ 'onAction',
871
+ 'onBeforeDestroy',
872
+ 'onBeforeHide',
873
+ 'onBeforeShow',
874
+ 'onCatchAll',
875
+ 'onChange',
876
+ 'onClear',
877
+ 'onDestroy',
878
+ 'onElementCreated',
879
+ 'onFocusIn',
880
+ 'onFocusOut',
881
+ 'onHide',
882
+ 'onInput',
883
+ 'onPaint',
884
+ 'onReadOnly',
885
+ 'onRecompose',
886
+ 'onResize',
887
+ 'onSelect',
888
+ 'onShow',
889
+ 'onTrigger'
890
+ ];
891
+
892
+ private static bryntumFeatureNames: string[] = [
893
+
894
+ ];
895
+
896
+ private static bryntumConfigs: string[] = BryntumColumnComboComponent.bryntumFeatureNames.concat([
897
+ 'adopt',
898
+ 'align',
899
+ 'alignSelf',
900
+ 'anchor',
901
+ 'appendTo',
902
+ 'ariaDescription',
903
+ 'ariaLabel',
904
+ 'autoComplete',
905
+ 'autoExpand',
906
+ 'autoSelect',
907
+ 'badge',
908
+ 'bubbleEvents',
909
+ 'cacheLastResult',
910
+ 'callOnFunctions',
911
+ 'caseSensitive',
912
+ 'catchEventHandlerExceptions',
913
+ 'centered',
914
+ 'chipView',
915
+ 'clearable',
916
+ 'clearTextOnPickerHide',
917
+ 'clearTextOnSelection',
918
+ 'clearWhenInputEmpty',
919
+ 'cls',
920
+ 'color',
921
+ 'column',
922
+ 'config',
923
+ 'constrainTo',
924
+ 'container',
925
+ 'containValues',
926
+ 'contentElementCls',
927
+ 'createOnUnmatched',
928
+ 'dataField',
929
+ 'dataset',
930
+ 'defaultBindProperty',
931
+ 'detectCSSCompatibilityIssues',
932
+ 'disabled',
933
+ 'displayField',
934
+ 'displayValueRenderer',
935
+ 'dock',
936
+ 'draggable',
937
+ 'editable',
938
+ 'elementAttributes',
939
+ 'emptyText',
940
+ 'encodeFilterParams',
941
+ 'excludeCatchAll',
942
+ 'extraData',
943
+ 'filterOnEnter',
944
+ 'filterOperator',
945
+ 'filterParamName',
946
+ 'filterSelected',
947
+ 'flex',
948
+ 'floating',
949
+ 'height',
950
+ 'hidden',
951
+ 'hideAnimation',
952
+ 'hidePickerOnSelect',
953
+ 'hideTrigger',
954
+ 'highlightExternalChange',
955
+ 'hint',
956
+ 'hintHtml',
957
+ 'id',
958
+ 'ignoreParentReadOnly',
959
+ 'includeAllColumnValues',
960
+ 'inline',
961
+ 'inlinePicker',
962
+ 'inputAlign',
963
+ 'inputAttributes',
964
+ 'inputTag',
965
+ 'inputType',
966
+ 'inputWidth',
967
+ 'insertBefore',
968
+ 'insertFirst',
969
+ 'keyMap',
970
+ 'keyStrokeChangeDelay',
971
+ 'keyStrokeFilterDelay',
972
+ 'label',
973
+ 'labelCls',
974
+ 'labelPosition',
975
+ 'labels',
976
+ 'labelWidth',
977
+ 'listCls',
978
+ 'listeners',
979
+ 'listItemTpl',
980
+ 'localeClass',
981
+ 'localizable',
982
+ 'localizableProperties',
983
+ 'margin',
984
+ 'maskDefaults',
985
+ 'masked',
986
+ 'maxHeight',
987
+ 'maximizeOnMobile',
988
+ 'maxLength',
989
+ 'maxWidth',
990
+ 'minChars',
991
+ 'minHeight',
992
+ 'minLength',
993
+ 'minWidth',
994
+ 'monitorResize',
995
+ 'multiSelect',
996
+ 'multiValueSeparator',
997
+ 'name',
998
+ 'overlayAnchor',
999
+ 'owner',
1000
+ 'picker',
1001
+ 'pickerAlignElement',
1002
+ 'pickerWidth',
1003
+ 'placeholder',
1004
+ 'positioned',
1005
+ 'preventTooltipOnTouch',
1006
+ 'primaryFilter',
1007
+ 'readOnly',
1008
+ 'relayStoreEvents',
1009
+ 'rendition',
1010
+ 'required',
1011
+ 'revertOnEscape',
1012
+ 'ripple',
1013
+ 'rootElement',
1014
+ 'rtl',
1015
+ 'scrollAction',
1016
+ 'showAnimation',
1017
+ 'showRequiredIndicator',
1018
+ 'showTooltipWhenDisabled',
1019
+ 'skipValidation',
1020
+ 'span',
1021
+ 'spellCheck',
1022
+ 'tab',
1023
+ 'tabIndex',
1024
+ 'taskBoard',
1025
+ 'textAlign',
1026
+ 'title',
1027
+ 'tooltip',
1028
+ 'triggerAction',
1029
+ 'triggers',
1030
+ 'type',
1031
+ 'ui',
1032
+ 'validateFilter',
1033
+ 'validateOnInput',
1034
+ 'value',
1035
+ 'valueField',
1036
+ 'weight',
1037
+ 'width',
1038
+ 'x',
1039
+ 'y'
1040
+ ]);
1041
+
1042
+ private static bryntumConfigsOnly: string[] = [
1043
+ 'adopt',
1044
+ 'align',
1045
+ 'anchor',
1046
+ 'ariaDescription',
1047
+ 'ariaLabel',
1048
+ 'autoComplete',
1049
+ 'autoExpand',
1050
+ 'autoSelect',
1051
+ 'bubbleEvents',
1052
+ 'cacheLastResult',
1053
+ 'caseSensitive',
1054
+ 'centered',
1055
+ 'chipView',
1056
+ 'clearable',
1057
+ 'clearTextOnPickerHide',
1058
+ 'clearTextOnSelection',
1059
+ 'clearWhenInputEmpty',
1060
+ 'color',
1061
+ 'config',
1062
+ 'constrainTo',
1063
+ 'container',
1064
+ 'containValues',
1065
+ 'contentElementCls',
1066
+ 'createOnUnmatched',
1067
+ 'dataField',
1068
+ 'defaultBindProperty',
1069
+ 'detectCSSCompatibilityIssues',
1070
+ 'displayField',
1071
+ 'displayValueRenderer',
1072
+ 'dock',
1073
+ 'draggable',
1074
+ 'elementAttributes',
1075
+ 'emptyText',
1076
+ 'encodeFilterParams',
1077
+ 'filterOnEnter',
1078
+ 'filterParamName',
1079
+ 'filterSelected',
1080
+ 'floating',
1081
+ 'hideAnimation',
1082
+ 'hidePickerOnSelect',
1083
+ 'hideTrigger',
1084
+ 'highlightExternalChange',
1085
+ 'hint',
1086
+ 'hintHtml',
1087
+ 'ignoreParentReadOnly',
1088
+ 'inline',
1089
+ 'inlinePicker',
1090
+ 'inputAlign',
1091
+ 'inputAttributes',
1092
+ 'inputTag',
1093
+ 'inputType',
1094
+ 'inputWidth',
1095
+ 'keyStrokeChangeDelay',
1096
+ 'keyStrokeFilterDelay',
1097
+ 'labelCls',
1098
+ 'labelPosition',
1099
+ 'labels',
1100
+ 'labelWidth',
1101
+ 'listCls',
1102
+ 'listeners',
1103
+ 'listItemTpl',
1104
+ 'localeClass',
1105
+ 'localizable',
1106
+ 'localizableProperties',
1107
+ 'maskDefaults',
1108
+ 'masked',
1109
+ 'maxLength',
1110
+ 'minChars',
1111
+ 'minLength',
1112
+ 'monitorResize',
1113
+ 'multiValueSeparator',
1114
+ 'name',
1115
+ 'overlayAnchor',
1116
+ 'owner',
1117
+ 'pickerAlignElement',
1118
+ 'pickerWidth',
1119
+ 'positioned',
1120
+ 'preventTooltipOnTouch',
1121
+ 'primaryFilter',
1122
+ 'relayStoreEvents',
1123
+ 'revertOnEscape',
1124
+ 'ripple',
1125
+ 'rootElement',
1126
+ 'scrollAction',
1127
+ 'showAnimation',
1128
+ 'showTooltipWhenDisabled',
1129
+ 'skipValidation',
1130
+ 'spellCheck',
1131
+ 'tab',
1132
+ 'tabIndex',
1133
+ 'taskBoard',
1134
+ 'textAlign',
1135
+ 'title',
1136
+ 'triggerAction',
1137
+ 'type',
1138
+ 'ui',
1139
+ 'validateFilter',
1140
+ 'validateOnInput',
1141
+ 'valueField',
1142
+ 'weight'
1143
+ ];
1144
+
1145
+ private static bryntumProps: string[] = BryntumColumnComboComponent.bryntumFeatureNames.concat([
1146
+ 'alignSelf',
1147
+ 'anchorSize',
1148
+ 'appendTo',
1149
+ 'badge',
1150
+ 'callOnFunctions',
1151
+ 'catchEventHandlerExceptions',
1152
+ 'cls',
1153
+ 'column',
1154
+ 'content',
1155
+ 'dataset',
1156
+ 'disabled',
1157
+ 'editable',
1158
+ 'excludeCatchAll',
1159
+ 'extraData',
1160
+ 'filterOperator',
1161
+ 'flex',
1162
+ 'focusVisible',
1163
+ 'formula',
1164
+ 'height',
1165
+ 'hidden',
1166
+ 'html',
1167
+ 'id',
1168
+ 'includeAllColumnValues',
1169
+ 'input',
1170
+ 'insertBefore',
1171
+ 'insertFirst',
1172
+ 'keyMap',
1173
+ 'label',
1174
+ 'margin',
1175
+ 'maxHeight',
1176
+ 'maximizeOnMobile',
1177
+ 'maxWidth',
1178
+ 'minHeight',
1179
+ 'minWidth',
1180
+ 'multiSelect',
1181
+ 'parent',
1182
+ 'picker',
1183
+ 'placeholder',
1184
+ 'readOnly',
1185
+ 'rendition',
1186
+ 'required',
1187
+ 'rtl',
1188
+ 'scrollable',
1189
+ 'showRequiredIndicator',
1190
+ 'span',
1191
+ 'tooltip',
1192
+ 'triggers',
1193
+ 'value',
1194
+ 'width',
1195
+ 'x',
1196
+ 'y'
1197
+ ]);
1198
+
1199
+ private elementRef: ElementRef;
1200
+ public instance!: ColumnCombo;
1201
+
1202
+ private bryntumConfig = {
1203
+ adopt : undefined,
1204
+ appendTo : undefined,
1205
+ href : undefined,
1206
+ angularComponent : this,
1207
+ features : {},
1208
+ listeners : {}
1209
+ };
1210
+
1211
+ constructor(element: ElementRef) {
1212
+ this.elementRef = element;
1213
+ }
1214
+
1215
+ // Configs only
1216
+ @Input() adopt ! : HTMLElement|string;
1217
+ @Input() align ! : AlignSpec|string;
1218
+ @Input() anchor ! : boolean;
1219
+ @Input() ariaDescription ! : string;
1220
+ @Input() ariaLabel ! : string;
1221
+ @Input() autoComplete ! : string;
1222
+ @Input() autoExpand ! : boolean;
1223
+ @Input() autoSelect ! : boolean;
1224
+ @Input() bubbleEvents ! : object;
1225
+ @Input() cacheLastResult ! : number|string|Duration|DurationConfig;
1226
+ @Input() caseSensitive ! : boolean;
1227
+ @Input() centered ! : boolean;
1228
+ @Input() chipView ! : ChipViewConfig;
1229
+ @Input() clearable ! : boolean|FieldTriggerConfig;
1230
+ @Input() clearTextOnPickerHide ! : boolean;
1231
+ @Input() clearTextOnSelection ! : boolean;
1232
+ @Input() clearWhenInputEmpty ! : boolean;
1233
+ @Input() color ! : string;
1234
+ @Input() config ! : object;
1235
+ @Input() constrainTo ! : HTMLElement|Widget|Rectangle;
1236
+ @Input() container ! : Record<string, TaskBoardContainerItemConfig>|TaskBoardContainerItemConfig[]|FieldContainerConfig|FieldContainer;
1237
+ @Input() containValues ! : boolean|string|((field: Field) => boolean);
1238
+ @Input() contentElementCls ! : string|object;
1239
+ @Input() createOnUnmatched ! : ((name: string, combo: Combo) => Model)|string|boolean;
1240
+ @Input() dataField ! : string;
1241
+ @Input() defaultBindProperty ! : string;
1242
+ @Input() detectCSSCompatibilityIssues ! : boolean;
1243
+ @Input() displayField ! : string;
1244
+ @Input() displayValueRenderer ! : (record: Model|ComboModel, combo: Combo) => string|void;
1245
+ @Input() dock ! : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object;
1246
+ @Input() draggable ! : boolean|{
1247
+ handleSelector?: string
1248
+ };
1249
+ @Input() elementAttributes ! : Record<string, string|null>;
1250
+ @Input() emptyText ! : string;
1251
+ @Input() encodeFilterParams ! : (filters: object[]) => object[];
1252
+ @Input() filterOnEnter ! : boolean;
1253
+ @Input() filterParamName ! : string;
1254
+ @Input() filterSelected ! : boolean;
1255
+ @Input() floating ! : boolean;
1256
+ @Input() hideAnimation ! : boolean|object;
1257
+ @Input() hidePickerOnSelect ! : boolean;
1258
+ @Input() hideTrigger ! : boolean;
1259
+ @Input() highlightExternalChange ! : boolean;
1260
+ @Input() hint ! : string|((data: { source: Field, value: any }) => string);
1261
+ @Input() hintHtml ! : string|((data: { source: Field, value: any }) => string);
1262
+ @Input() ignoreParentReadOnly ! : boolean;
1263
+ @Input() inline ! : boolean;
1264
+ @Input() inlinePicker ! : boolean;
1265
+ @Input() inputAlign ! : string;
1266
+ @Input() inputAttributes ! : Record<string, string>;
1267
+ @Input() inputTag ! : string;
1268
+ @Input() inputType ! : string;
1269
+ @Input() inputWidth ! : string|number;
1270
+ @Input() keyStrokeChangeDelay ! : number;
1271
+ @Input() keyStrokeFilterDelay ! : number;
1272
+ @Input() labelCls ! : string|object;
1273
+ @Input() labelPosition ! : 'before'|'above'|null;
1274
+ @Input() labels ! : object[];
1275
+ @Input() labelWidth ! : string|number;
1276
+ @Input() listCls ! : string;
1277
+ @Input() listeners ! : ColumnComboListeners;
1278
+ @Input() listItemTpl ! : (record: Model|ComboModel) => string|void;
1279
+ @Input() localeClass ! : typeof Base;
1280
+ @Input() localizable ! : boolean;
1281
+ @Input() localizableProperties ! : string[];
1282
+ @Input() maskDefaults ! : MaskConfig;
1283
+ @Input() masked ! : boolean|string|MaskConfig;
1284
+ @Input() maxLength ! : number;
1285
+ @Input() minChars ! : number;
1286
+ @Input() minLength ! : number;
1287
+ @Input() monitorResize ! : boolean|{
1288
+ immediate?: boolean
1289
+ };
1290
+ @Input() multiValueSeparator ! : string;
1291
+ @Input() name ! : string;
1292
+ @Input() overlayAnchor ! : boolean;
1293
+ @Input() owner ! : Widget|any;
1294
+ @Input() pickerAlignElement ! : string;
1295
+ @Input() pickerWidth ! : number|string;
1296
+ @Input() positioned ! : boolean;
1297
+ @Input() preventTooltipOnTouch ! : boolean;
1298
+ @Input() primaryFilter ! : CollectionFilterConfig;
1299
+ @Input() relayStoreEvents ! : boolean;
1300
+ @Input() revertOnEscape ! : boolean;
1301
+ @Input() ripple ! : boolean|{
1302
+ delegate?: string
1303
+ color?: string
1304
+ radius?: number
1305
+ clip?: string
1306
+ };
1307
+ @Input() rootElement ! : ShadowRoot|HTMLElement;
1308
+ @Input() scrollAction ! : 'hide'|'realign'|null;
1309
+ @Input() showAnimation ! : boolean|object;
1310
+ @Input() showTooltipWhenDisabled ! : boolean;
1311
+ @Input() skipValidation ! : boolean;
1312
+ @Input() spellCheck ! : boolean;
1313
+ @Input() tab ! : boolean|TabConfig;
1314
+ @Input() tabIndex ! : number;
1315
+ @Input() taskBoard ! : TaskBoard;
1316
+ @Input() textAlign ! : 'left'|'center'|'right'|'start'|'end';
1317
+ @Input() title ! : string;
1318
+ @Input() triggerAction ! : 'all'|'last'|null;
1319
+ @Input() type ! : 'columncombo';
1320
+ @Input() ui ! : string|object;
1321
+ @Input() validateFilter ! : boolean;
1322
+ @Input() validateOnInput ! : boolean;
1323
+ @Input() valueField ! : string|null;
1324
+ @Input() weight ! : number;
1325
+
1326
+ // Configs and properties
1327
+ @Input() alignSelf ! : string;
1328
+ @Input() appendTo ! : HTMLElement|string;
1329
+ @Input() badge ! : string;
1330
+ @Input() callOnFunctions ! : boolean;
1331
+ @Input() catchEventHandlerExceptions ! : boolean;
1332
+ @Input() cls ! : string|object;
1333
+ @Input() column ! : number;
1334
+ @Input() dataset ! : object|Record<string, string>;
1335
+ @Input() disabled ! : boolean|'inert';
1336
+ @Input() editable ! : boolean;
1337
+ @Input() excludeCatchAll ! : boolean;
1338
+ @Input() extraData ! : any;
1339
+ @Input() filterOperator ! : CollectionCompareOperator;
1340
+ @Input() flex ! : number|string;
1341
+ @Input() height ! : number|string;
1342
+ @Input() hidden ! : boolean;
1343
+ @Input() id ! : string;
1344
+ @Input() includeAllColumnValues ! : boolean;
1345
+ @Input() insertBefore ! : HTMLElement|string;
1346
+ @Input() insertFirst ! : HTMLElement|string;
1347
+ @Input() keyMap ! : Record<string, KeyMapConfig>;
1348
+ @Input() label ! : string;
1349
+ @Input() margin ! : number|string;
1350
+ @Input() maxHeight ! : string|number;
1351
+ @Input() maximizeOnMobile ! : number|string;
1352
+ @Input() maxWidth ! : string|number;
1353
+ @Input() minHeight ! : string|number;
1354
+ @Input() minWidth ! : string|number;
1355
+ @Input() multiSelect ! : boolean;
1356
+ @Input() picker ! : ListConfig|List;
1357
+ @Input() placeholder ! : string;
1358
+ @Input() readOnly ! : boolean;
1359
+ @Input() rendition ! : 'outlined'|'filled'|string;
1360
+ @Input() required ! : boolean;
1361
+ @Input() rtl ! : boolean;
1362
+ @Input() showRequiredIndicator ! : string;
1363
+ @Input() span ! : number;
1364
+ @Input() tooltip ! : string|TooltipConfig|null;
1365
+ @Input() triggers ! : Record<string, FieldTriggerConfig>|Record<string, Widget>;
1366
+ @Input() value ! : object|number|string|string[]|number[];
1367
+ @Input() width ! : number|string;
1368
+ @Input() x ! : number;
1369
+ @Input() y ! : number;
1370
+
1371
+ // Properties only
1372
+ @Input() anchorSize ! : number[];
1373
+ @Input() content ! : string;
1374
+ @Input() focusVisible ! : boolean;
1375
+ @Input() formula ! : string;
1376
+ @Input() html ! : string|((widget: Widget) => string)|DomConfig|DomConfig[]|VueConfig;
1377
+ @Input() input ! : HTMLElement;
1378
+ @Input() parent ! : Widget;
1379
+ @Input() scrollable ! : Scroller;
1380
+
1381
+ // Events emitters
1382
+ /**
1383
+ * The default action was performed (an item in the list was selected)
1384
+ * @param {object} event Event object
1385
+ * @param {Core.widget.Combo} event.source The combo
1386
+ * @param {any} event.value The [value](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#config-valueField) of the selected record
1387
+ * @param {Core.data.Model} event.record Selected record
1388
+ * @param {Core.data.Model[]} event.records Selected records as an array if [multiSelect](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#config-multiSelect) is `true`
1389
+ * @param {boolean} event.userAction `true` if the value change is due to user interaction
1390
+ */
1391
+ @Output() onAction: any = new EventEmitter<((event: { source: Combo, value: any, record: Model, records: Model[], userAction: boolean }) => void)|string>();
1392
+ /**
1393
+ * Fires before an object is destroyed.
1394
+ * @param {object} event Event object
1395
+ * @param {Core.Base} event.source The Object that is being destroyed.
1396
+ */
1397
+ @Output() onBeforeDestroy: any = new EventEmitter<((event: { source: Base }) => void)|string>();
1398
+ /**
1399
+ * Triggered before a widget is hidden. Return `false` to prevent the action.
1400
+ * @param {object} event Event object
1401
+ * @param {Core.widget.Widget} event.source The widget being hidden.
1402
+ */
1403
+ @Output() onBeforeHide: any = new EventEmitter<((event: { source: Widget }) => Promise<boolean>|boolean|void)|string>();
1404
+ /**
1405
+ * Triggered before a widget is shown. Return `false` to prevent the action.
1406
+ * @param {object} event Event object
1407
+ * @param {Core.widget.Widget,any} event.source The widget being shown
1408
+ */
1409
+ @Output() onBeforeShow: any = new EventEmitter<((event: { source: Widget|any }) => Promise<boolean>|boolean|void)|string>();
1410
+ /**
1411
+ * Fires when any other event is fired from the object.
1412
+ * ...
1413
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#event-catchAll)
1414
+ * @param {object} event Event object
1415
+ * @param {{[key: string]: any, type: string}} event.event The Object that contains event details
1416
+ * @param {string} event.event.type The type of the event which is caught by the listener
1417
+ */
1418
+ @Output() onCatchAll: any = new EventEmitter<((event: {[key: string]: any, type: string}) => void)|string>();
1419
+ /**
1420
+ * Fired when this field's value changes.
1421
+ * @param {object} event Event object
1422
+ * @param {Core.widget.Field,any} event.source This Field
1423
+ * @param {string,number,boolean,any} event.value This field's value
1424
+ * @param {string,number,boolean,any} event.oldValue This field's previous value
1425
+ * @param {boolean} event.valid True if this field is in a valid state
1426
+ * @param {Event} event.event The triggering DOM event if any
1427
+ * @param {boolean} event.userAction Triggered by user taking an action (`true`) or by setting a value (`false`)
1428
+ * @param {boolean} event.checked
1429
+ */
1430
+ @Output() onChange: any = new EventEmitter<((event: { source: Field|any, value: string|number|boolean|any, oldValue: string|number|boolean|any, valid: boolean, event: Event, userAction: boolean, checked: boolean }) => void)|string>();
1431
+ /**
1432
+ * Fired when this field is [cleared](https://bryntum.com/products/taskboard/docs/api/Core/widget/Field#function-clear).
1433
+ * ...
1434
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#event-clear)
1435
+ * @param {object} event Event object
1436
+ * @param {Core.widget.Field,any} event.source This Field
1437
+ */
1438
+ @Output() onClear: any = new EventEmitter<((event: { source: Field|any }) => void)|string>();
1439
+ /**
1440
+ * Fires when an object is destroyed.
1441
+ * @param {object} event Event object
1442
+ * @param {Core.Base} event.source The Object that is being destroyed.
1443
+ */
1444
+ @Output() onDestroy: any = new EventEmitter<((event: { source: Base }) => void)|string>();
1445
+ /**
1446
+ * Triggered when a widget's [element](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#property-element) is available.
1447
+ * @param {object} event Event object
1448
+ * @param {HTMLElement} event.element The Widget's element.
1449
+ */
1450
+ @Output() onElementCreated: any = new EventEmitter<((event: { element: HTMLElement }) => void)|string>();
1451
+ /**
1452
+ * Fired when focus enters this Widget.
1453
+ * @param {object} event Event object
1454
+ * @param {Core.widget.Widget} event.source This Widget
1455
+ * @param {HTMLElement} event.fromElement The element which lost focus.
1456
+ * @param {HTMLElement} event.toElement The element which gained focus.
1457
+ * @param {Core.widget.Widget} event.fromWidget The widget which lost focus.
1458
+ * @param {Core.widget.Widget} event.toWidget The widget which gained focus.
1459
+ * @param {boolean} event.backwards `true` if the `toElement` is before the `fromElement` in document order.
1460
+ */
1461
+ @Output() onFocusIn: any = new EventEmitter<((event: { source: Widget, fromElement: HTMLElement, toElement: HTMLElement, fromWidget: Widget, toWidget: Widget, backwards: boolean }) => void)|string>();
1462
+ /**
1463
+ * Fired when focus exits this Widget's ownership tree. This is different from a `blur` event.
1464
+ * focus moving from within this Widget's ownership tree, even if there are floating widgets
1465
+ * will not trigger this event. This is when focus exits this widget completely.
1466
+ * @param {object} event Event object
1467
+ * @param {Core.widget.Widget} event.source This Widget
1468
+ * @param {HTMLElement} event.fromElement The element which lost focus.
1469
+ * @param {HTMLElement} event.toElement The element which gained focus.
1470
+ * @param {Core.widget.Widget} event.fromWidget The widget which lost focus.
1471
+ * @param {Core.widget.Widget} event.toWidget The widget which gained focus.
1472
+ * @param {boolean} event.backwards `true` if the `toElement` is before the `fromElement` in document order.
1473
+ */
1474
+ @Output() onFocusOut: any = new EventEmitter<((event: { source: Widget, fromElement: HTMLElement, toElement: HTMLElement, fromWidget: Widget, toWidget: Widget, backwards: boolean }) => void)|string>();
1475
+ /**
1476
+ * Triggered after a widget was hidden
1477
+ * @param {object} event Event object
1478
+ * @param {Core.widget.Widget} event.source The widget
1479
+ */
1480
+ @Output() onHide: any = new EventEmitter<((event: { source: Widget }) => void)|string>();
1481
+ /**
1482
+ * User typed into the field. Please note that the value attached to this event is the raw input field value and
1483
+ * not the combos value
1484
+ * @param {object} event Event object
1485
+ * @param {Core.widget.Combo} event.source The combo.
1486
+ * @param {string} event.value Raw input value
1487
+ * @param {Event} event.event The triggering DOM event if any.
1488
+ */
1489
+ @Output() onInput: any = new EventEmitter<((event: { source: Combo, value: string, event: Event }) => void)|string>();
1490
+ /**
1491
+ * Triggered when a widget which had been in a non-visible state for any reason
1492
+ * achieves visibility.
1493
+ * ...
1494
+ * [View online docs...](https://bryntum.com/products/taskboard/docs/api/TaskBoard/widget/ColumnCombo#event-paint)
1495
+ * @param {object} event Event object
1496
+ * @param {Core.widget.Widget} event.source The widget being painted.
1497
+ * @param {boolean} event.firstPaint `true` if this is the first paint.
1498
+ */
1499
+ @Output() onPaint: any = new EventEmitter<((event: { source: Widget, firstPaint: boolean }) => void)|string>();
1500
+ /**
1501
+ * Fired when a Widget's read only state is toggled
1502
+ * @param {object} event Event object
1503
+ * @param {boolean} event.readOnly Read only or not
1504
+ */
1505
+ @Output() onReadOnly: any = new EventEmitter<((event: { readOnly: boolean }) => void)|string>();
1506
+ /**
1507
+ * This event is fired after a widget's elements have been synchronized due to a direct or indirect call
1508
+ * to [recompose](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#function-recompose), if this results in some change to the widget's rendered DOM elements.
1509
+ */
1510
+ @Output() onRecompose: any = new EventEmitter<(() => void)|string>();
1511
+ /**
1512
+ * Fired when the encapsulating element of a Widget resizes *only when [monitorResize](https://bryntum.com/products/taskboard/docs/api/Core/widget/Widget#config-monitorResize) is `true`*.
1513
+ * @param {object} event Event object
1514
+ * @param {Core.widget.Widget} event.source This Widget
1515
+ * @param {number} event.width The new width
1516
+ * @param {number} event.height The new height
1517
+ * @param {number} event.oldWidth The old width
1518
+ * @param {number} event.oldHeight The old height
1519
+ */
1520
+ @Output() onResize: any = new EventEmitter<((event: { source: Widget, width: number, height: number, oldWidth: number, oldHeight: number }) => void)|string>();
1521
+ /**
1522
+ * An item in the list was selected
1523
+ * @param {object} event Event object
1524
+ * @param {Core.widget.Combo} event.source The combo
1525
+ * @param {Core.data.Model} event.record Selected record
1526
+ * @param {Core.data.Model[]} event.records Selected records as an array if [multiSelect](https://bryntum.com/products/taskboard/docs/api/Core/widget/Combo#config-multiSelect) is `true`
1527
+ * @param {boolean} event.userAction `true` if the value change is due to user interaction
1528
+ */
1529
+ @Output() onSelect: any = new EventEmitter<((event: { source: Combo, record: Model, records: Model[], userAction: boolean }) => void)|string>();
1530
+ /**
1531
+ * Triggered after a widget is shown.
1532
+ * @param {object} event Event object
1533
+ * @param {Core.widget.Widget} event.source The widget
1534
+ */
1535
+ @Output() onShow: any = new EventEmitter<((event: { source: Widget }) => void)|string>();
1536
+ /**
1537
+ * User clicked one of this field's [triggers](https://bryntum.com/products/taskboard/docs/api/Core/widget/Field#property-triggers)
1538
+ * @param {object} event Event object
1539
+ * @param {Core.widget.Field,any} event.source This field
1540
+ * @param {Core.widget.Widget} event.trigger The trigger activated by click or touch tap.
1541
+ */
1542
+ @Output() onTrigger: any = new EventEmitter<((event: { source: Field|any, trigger: Widget }) => void)|string>();
1543
+
1544
+ /**
1545
+ * Create and append the underlying widget
1546
+ */
1547
+ ngOnInit(): void {
1548
+ const
1549
+ me = this,
1550
+ {
1551
+ elementRef,
1552
+ bryntumConfig
1553
+ } = me,
1554
+ {
1555
+ instanceClass,
1556
+ instanceName,
1557
+ bryntumConfigs,
1558
+ bryntumEvents
1559
+ } = BryntumColumnComboComponent;
1560
+
1561
+ bryntumConfigs.filter(prop => prop in this).forEach(prop => {
1562
+ // @ts-ignore
1563
+ WrapperHelper.applyPropValue(bryntumConfig, prop, this[prop]);
1564
+ if (['features', 'config'].includes(prop)) {
1565
+ WrapperHelper.devWarningConfigProp(instanceName, prop);
1566
+ }
1567
+ });
1568
+ // @ts-ignore
1569
+ bryntumEvents.filter(event => this[event] && this[event].observers.length > 0).forEach(event => {
1570
+ const
1571
+ uncapitalize = (str: string) => str.charAt(0).toLowerCase() + str.slice(1),
1572
+ eventName = (str: string) => uncapitalize(str.slice(2));
1573
+
1574
+ // @ts-ignore
1575
+ bryntumConfig.listeners[eventName(event)] = e => {
1576
+ // @ts-ignore
1577
+ me[event].emit(e);
1578
+ // EventEmitter does not return values in the normal way, work around it by setting `returnValue` flag
1579
+ // in Angular listeners
1580
+ return e.returnValue;
1581
+ };
1582
+ });
1583
+
1584
+ // If component has no container specified in config then use adopt to Wrapper's element
1585
+ const
1586
+ containerParam = [
1587
+ 'adopt',
1588
+ 'appendTo',
1589
+ 'insertAfter',
1590
+ 'insertBefore'
1591
+ // @ts-ignore
1592
+ ].find(prop => bryntumConfig[prop]);
1593
+ if (!containerParam) {
1594
+ if (instanceName === 'Button' || elementRef.nativeElement.getRootNode() instanceof ShadowRoot) {
1595
+ // Button should always be <a> or <button> inside owner element
1596
+ bryntumConfig.appendTo = elementRef.nativeElement;
1597
+ }
1598
+ else {
1599
+ bryntumConfig.adopt = elementRef.nativeElement;
1600
+ }
1601
+ }
1602
+ else {
1603
+ WrapperHelper.devWarningContainer(instanceName, containerParam);
1604
+ }
1605
+
1606
+ // @ts-ignore
1607
+ me.instance = instanceName === 'Widget' ? Widget.create(bryntumConfig) : new instanceClass(bryntumConfig);
1608
+
1609
+ }
1610
+
1611
+ /**
1612
+ * Watch for changes
1613
+ * @param changes
1614
+ */
1615
+ ngOnChanges(changes: SimpleChanges): void {
1616
+ const
1617
+ { instance } = this,
1618
+ { instanceName } = BryntumColumnComboComponent;
1619
+ if (!instance) {
1620
+ return;
1621
+ }
1622
+ // Iterate over all changes
1623
+ Object.entries(changes).forEach(([prop, change]) => {
1624
+ const
1625
+ newValue = (change as SimpleChange).currentValue,
1626
+ { instance } = this,
1627
+ { bryntumConfigsOnly, bryntumProps } = BryntumColumnComboComponent;
1628
+ if (bryntumProps.includes(prop)) {
1629
+ WrapperHelper.applyPropValue(instance, prop, newValue, false);
1630
+ if (bryntumConfigsOnly.includes(prop)) {
1631
+ WrapperHelper.devWarningUpdateProp(instanceName, prop);
1632
+ }
1633
+ }
1634
+ });
1635
+ }
1636
+
1637
+ /**
1638
+ * Destroy the component
1639
+ */
1640
+ ngOnDestroy(): void {
1641
+ // @ts-ignore
1642
+ if (this.instance && this.instance.destroy) {
1643
+ this.instance.destroy();
1644
+ }
1645
+ }
1646
+ }