@syncfusion/ej2-multicolumn-combobox 31.1.17 → 31.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,572 +0,0 @@
1
- import { Component, EventHandler, INotifyPropertyChanged, Property, NotifyPropertyChanges, closest, attributes, append, compile, detach, KeyboardEvents, getValue } from '@syncfusion/ej2-base';import { ChildProperty, prepend, Collection, getUniqueID, Complex, isNullOrUndefined as isNOU, select, L10n, Browser } from '@syncfusion/ej2-base';import { formatUnit, addClass, removeClass, NumberFormatOptions, DateFormatOptions, Event, EmitType, AnimationModel, Animation, KeyboardEventArgs } from '@syncfusion/ej2-base';import { Input, InputObject } from '@syncfusion/ej2-inputs';import { DataManager, Query, Group, DataOptions } from '@syncfusion/ej2-data';import { Popup, createSpinner, showSpinner, hideSpinner } from '@syncfusion/ej2-popups';import { Grid, Resize, FailureEventArgs, VirtualScroll, Group as GridGroup, Edit, Sort, GridColumnModel } from '@syncfusion/ej2-grids';
2
- import {TextAlign,GridLine,WrapMode,ResizeArgs,DataResult,FilterType,FloatLabelType,SortOrder,SortType,PopupEventArgs,FilteringEventArgs,SelectEventArgs,ChangeEventArgs} from "./multi-column-combo-box";
3
- import {ComponentModel} from '@syncfusion/ej2-base';
4
-
5
- /**
6
- * Interface for a class MultiColumnGrid
7
- */
8
- export interface MultiColumnGridModel {
9
-
10
- }
11
-
12
- /**
13
- * Interface for a class FieldSettings
14
- */
15
- export interface FieldSettingsModel {
16
-
17
- /**
18
- * Specifies the display text of each list item.
19
- *
20
- * @default null
21
- */
22
- text?: string;
23
-
24
- /**
25
- * Specifies the hidden data value mapped to each list item that should contain a unique value.
26
- *
27
- * @default null
28
- */
29
- value?: string;
30
-
31
- /**
32
- * Specifies the category under which the list item has to be grouped.
33
- *
34
- * @default null
35
- */
36
- groupBy?: string;
37
-
38
- }
39
-
40
- /**
41
- * Interface for a class Column
42
- */
43
- export interface ColumnModel {
44
-
45
- /**
46
- * Defines the name of the field whose data will be displayed in the column.
47
- *
48
- * @default ''
49
- */
50
- field?: string;
51
-
52
- /**
53
- * Defines the header text of column which is used to display in column header.
54
- * If headerText is not defined, then field name value will be assigned to header text.
55
- *
56
- * @default ''
57
- */
58
- header?: string;
59
-
60
- /**
61
- * Defines the width of the column in pixels or percentage.
62
- *
63
- * @default ''
64
- */
65
- width?: string | number;
66
-
67
- /**
68
- * Defines the alignment of the column in both header and content cells.
69
- *
70
- * @default Left
71
- */
72
- textAlign?: TextAlign;
73
-
74
- /**
75
- * It is used to change display value with the given format and does not affect the original data.
76
- * Gets the format from the user which can be standard or custom `number` and `date` formats.
77
- *
78
- * @default null
79
- * @aspType string
80
- */
81
- format?: string | NumberFormatOptions | DateFormatOptions;
82
-
83
- /**
84
- * If `displayAsCheckBox` is set to true, it displays the column value as a check box instead of Boolean value.
85
- *
86
- * @default false
87
- */
88
- displayAsCheckBox?: boolean;
89
-
90
- /**
91
- * Defines the column template that renders customized element in each cell of the column.
92
- * It accepts either template or HTML element ID.
93
- *
94
- * @default null
95
- * @angularType string | object
96
- * @reactType string | function | JSX.Element
97
- * @vueType string | function
98
- * @aspType string
99
- */
100
- template?: string | Function;
101
-
102
- /**
103
- * Defines the column template as string or HTML element ID which is used to add customized element in the column header.
104
- *
105
- * @default null
106
- * @angularType string | object
107
- * @reactType string | function | JSX.Element
108
- * @vueType string | function
109
- * @aspType string
110
- */
111
- headerTemplate?: string | Function;
112
-
113
- /**
114
- * The CSS styles and attributes of the content cells of a particular column can be customized.
115
- *
116
- * @default null
117
- */
118
- customAttributes?: { [x: string]: Object };
119
-
120
- }
121
-
122
- /**
123
- * Interface for a class GridSettings
124
- */
125
- export interface GridSettingsModel {
126
-
127
- /**
128
- * If `enableAltRow` is set to true, the grid will render with `e-altrow` CSS class to the alternative row elements.
129
- *
130
- * @default false
131
- */
132
- enableAltRow?: boolean;
133
-
134
- /**
135
- * Defines the height of rows in the popup content.
136
- *
137
- * @default null
138
- */
139
- rowHeight?: number;
140
-
141
- /**
142
- * Defines the mode of grid lines. The available modes are,
143
- * * `Both`: Displays both horizontal and vertical grid lines.
144
- * * `None`: No grid lines are displayed.
145
- * * `Horizontal`: Displays the horizontal grid lines only.
146
- * * `Vertical`: Displays the vertical grid lines only.
147
- * * `Default`: Displays grid lines based on the theme.
148
- *
149
- * @default Default
150
- */
151
- gridLines?: GridLine;
152
-
153
- /**
154
- * Specifies whether to allow text wrapping of the popup grid content.
155
- *
156
- * @default false
157
- */
158
- allowTextWrap?: boolean;
159
-
160
- /**
161
- * Specifies the mode for text wrapping in the popup grid content. Options include 'Both', 'Content', and 'Header'.
162
- *
163
- * @isenumeration true
164
- *
165
- * @default WrapMode.Both
166
- * @asptype WrapMode
167
- */
168
- textWrapMode?: WrapMode | string;
169
-
170
- /**
171
- * Specifies whether resizing of columns is enabled in the popup grid content.
172
- *
173
- * @default false
174
- */
175
- allowResizing?: boolean;
176
-
177
- /**
178
- * Triggers during the column resizing.
179
- *
180
- * @event resizing
181
- */
182
- resizing?: EmitType<ResizeArgs>;
183
-
184
- /**
185
- * Triggers when the column resizing begins.
186
- *
187
- * @event resizeStart
188
- */
189
- resizeStart?: EmitType<ResizeArgs>;
190
-
191
- /**
192
- * Triggers when the column resizing ends.
193
- *
194
- * @event resizeStop
195
- */
196
- resizeStop?: EmitType<ResizeArgs>;
197
-
198
- }
199
-
200
- /**
201
- * Interface for a class MultiColumnComboBox
202
- */
203
- export interface MultiColumnComboBoxModel extends ComponentModel{
204
-
205
- /**
206
- * Accepts the list items either through local or remote service and binds it to the component.
207
- * It can be an array of JSON Objects or an instance of `DataManager`.
208
- *
209
- * {% codeBlock src='multicolumn-combobox/value/index.md' %}{% endcodeBlock %}
210
- *
211
- * @default []
212
- * @isGenericType true
213
- */
214
- dataSource?: Object | DataManager | DataResult;
215
-
216
- /**
217
- * Gets or sets the display text of the selected item.
218
- *
219
- * @default null
220
- */
221
- text?: string;
222
-
223
- /**
224
- * Gets or sets the value of the selected item.
225
- *
226
- * {% codeBlock src='multicolumn-combobox/value/index.md' %}{% endcodeBlock %}
227
- *
228
- * @default null
229
- */
230
- value?: string;
231
-
232
- /**
233
- * Gets or sets the index of the selected item in the component.
234
- *
235
- * @default null
236
- */
237
- index?: number | null;
238
-
239
- /**
240
- * Specifies the width of the component. By default, the component width sets based on the width of its parent container.
241
- *
242
- * @default '100%'
243
- * @aspType string
244
- */
245
- width?: string | number;
246
-
247
- /**
248
- * Specifies the height of the popup list.
249
- *
250
- * @default '300px'
251
- * @aspType string
252
- */
253
- popupHeight?: string | number;
254
-
255
- /**
256
- * Specifies the width of the popup list. By default, the popup width sets based on the width of the component.
257
- *
258
- * @default '100%'
259
- * @aspType string
260
- */
261
- popupWidth?: string | number;
262
-
263
- /**
264
- * Specifies a short hint that describes the expected value of the multicolumn combobox component.
265
- *
266
- * @default null
267
- */
268
- placeholder?: string;
269
-
270
- /**
271
- * Specifies the filter action retrieves matched items through the filtering event based on the characters typed in the search TextBox.
272
- * If no match is found, the value of the noRecordsTemplate property will be displayed.
273
- *
274
- * {% codeBlock src='multicolumn-combobox/allowFiltering/index.md' %}{% endcodeBlock %}
275
- *
276
- * @default true
277
- */
278
- allowFiltering?: boolean;
279
-
280
- /**
281
- * Specifies whether sorting is allowed for the columns in the dropdown list.
282
- *
283
- * @default true
284
- */
285
- allowSorting?: boolean;
286
-
287
- /**
288
- * Specifies whether to show or hide the clear icon in textbox.
289
- * When the clear button is clicked, `value`, `text` properties will be reset to null.
290
- *
291
- * @default false
292
- */
293
- showClearButton?: boolean;
294
-
295
- /**
296
- * Sets CSS classes to the root element of the component that allows customization of appearance.
297
- *
298
- * @default ''
299
- */
300
- cssClass?: string;
301
-
302
- /**
303
- * The `fields` property maps the columns of the data table and binds the data to the component.
304
- * * text - Maps the text column from data table for each list item.
305
- * * value - Maps the value column from data table for each list item.
306
- * * groupBy - Group the list items with it's related items by mapping groupBy field.
307
- *
308
- * {% codeBlock src='multicolumn-combobox/fields/index.md' %}{% endcodeBlock %}
309
- *
310
- * @default {text: null, value: null, groupBy: null}
311
- */
312
- fields?: FieldSettingsModel;
313
-
314
- /**
315
- * Specifies the number of columns and its respective fields to be displayed in the dropdown popup.
316
- *
317
- * {% codeBlock src='multicolumn-combobox/fields/index.md' %}{% endcodeBlock %}
318
- *
319
- * @default []
320
- */
321
- columns?: ColumnModel[];
322
-
323
- /**
324
- * Specifies the configuration of the columns in the popup content.
325
- *
326
- * {% codeBlock src='multicolumn-combobox/gridSettings/index.md' %}{% endcodeBlock %}
327
- *
328
- * @default {rowHeight: null, gridLines: Default, enableAltRow: false}
329
- */
330
- gridSettings?: GridSettingsModel;
331
-
332
- /**
333
- * Determines on which filter type, the component needs to be considered on search action.
334
- * The `FilterType` and its supported data types are
335
- *
336
- * <table>
337
- * <tr>
338
- * <td colSpan=1 rowSpan=1>
339
- * FilterType<br/></td><td colSpan=1 rowSpan=1>
340
- * Description<br/></td><td colSpan=1 rowSpan=1>
341
- * Supported Types<br/></td></tr>
342
- * <tr>
343
- * <td colSpan=1 rowSpan=1>
344
- * StartsWith<br/></td><td colSpan=1 rowSpan=1>
345
- * Checks whether a value begins with the specified value.<br/></td><td colSpan=1 rowSpan=1>
346
- * String<br/></td></tr>
347
- * <tr>
348
- * <td colSpan=1 rowSpan=1>
349
- * EndsWith<br/></td><td colSpan=1 rowSpan=1>
350
- * Checks whether a value ends with specified value.<br/><br/></td><td colSpan=1 rowSpan=1>
351
- * <br/>String<br/></td></tr>
352
- * <tr>
353
- * <td colSpan=1 rowSpan=1>
354
- * Contains<br/></td><td colSpan=1 rowSpan=1>
355
- * Checks whether a value contains with specified value.<br/><br/></td><td colSpan=1 rowSpan=1>
356
- * <br/>String<br/></td></tr>
357
- * </table>
358
- *
359
- * The default value set to `StartsWith`, all the suggestion items which contain typed characters to listed in the suggestion popup.
360
- *
361
- * {% codeBlock src='multicolumn-combobox/allowFiltering/index.md' %}{% endcodeBlock %}
362
- *
363
- * @isenumeration true
364
- * @default FilterType.StartsWith
365
- * @asptype FilterType
366
- */
367
- filterType?: FilterType | string;
368
-
369
- /**
370
- * Specifies whether to display the floating label above the input element.
371
- * Possible values are:
372
- * * Never - The label will never float in the input when the placeholder is available.
373
- * * Always - The floating label will always float above the input.
374
- * * Auto - The floating label will float above the input after focusing or entering a value in the input.
375
- *
376
- * {% codeBlock src='multicolumn-combobox/floatLabelType/index.md' %}{% endcodeBlock %}
377
- *
378
- * @default Never
379
- */
380
- floatLabelType?: FloatLabelType;
381
-
382
- /**
383
- * Specifies the sortOrder to sort the data source.
384
- * The available type of sort orders are,
385
- * * `None` - The datasource is not sorting. Default value is None.
386
- * * `Ascending` - The datasource is sorting with ascending order.
387
- * * `Descending` - The data source is sorting with descending order.
388
- *
389
- * @isenumeration true
390
- * @default SortOrder.None
391
- * @asptype SortOrder
392
- */
393
- sortOrder?: SortOrder | string;
394
-
395
- /**
396
- * Specifies the type of sorting to be applied for the columns.
397
- * * `OneColumn` - Allow sorting only one column.
398
- * * `MultipleColumns` - Allow sorting multiple columns.
399
- *
400
- * @isenumeration true
401
- * @default SortType.OneColumn
402
- * @asptype SortType
403
- */
404
- sortType?: SortType | string;
405
-
406
- /**
407
- * Defines whether to enable virtual scrolling in the component.
408
- *
409
- * @default false
410
- */
411
- enableVirtualization?: boolean;
412
-
413
- /**
414
- * Specifies a value that indicates whether the component is disabled or not.
415
- *
416
- * @default false
417
- */
418
- disabled?: boolean;
419
-
420
- /**
421
- * Specifies the user interactions on the component are disabled.
422
- *
423
- * @default false
424
- */
425
- readonly?: boolean;
426
-
427
- /**
428
- * Specifies the component’s state between page reloads. If enabled, the list of states for the value will be persisted.
429
- *
430
- * @default false
431
- */
432
- enablePersistence?: boolean;
433
-
434
- /**
435
- * Accepts the external Query that execute along with data processing.
436
- *
437
- * {% codeBlock src='multicolumn-combobox/query/index.md' %}{% endcodeBlock %}
438
- *
439
- * @default null
440
- */
441
- query?: Query;
442
-
443
- /**
444
- * Accepts the template design and assigns it to each items present in the popup.
445
- *
446
- * {% codeBlock src='multicolumn-combobox/itemTemplate/index.md' %}{% endcodeBlock %}
447
- *
448
- * @default null
449
- * @angularType string | object
450
- * @reactType string | function | JSX.Element
451
- * @vueType string | function
452
- * @aspType string
453
- */
454
- itemTemplate?: string | Function;
455
-
456
- /**
457
- * Accepts the template design and assigns it to the footer container of the popup.
458
- *
459
- * @default null
460
- * @angularType string | object
461
- * @reactType string | function | JSX.Element
462
- * @vueType string | function
463
- * @aspType string
464
- */
465
- footerTemplate?: string | Function;
466
-
467
- /**
468
- * Accepts the template design and assigns it to the group headers present in the popup list.
469
- *
470
- * @default null
471
- * @angularType string | object
472
- * @reactType string | function | JSX.Element
473
- * @vueType string | function
474
- * @aspType string
475
- */
476
- groupTemplate?: string | Function;
477
-
478
- /**
479
- * Accepts the template and assigns it to the popup content when the data fetch request from the remote server fails.
480
- *
481
- * @default 'Request Failed'
482
- * @angularType string | object
483
- * @reactType string | function | JSX.Element
484
- * @vueType string | function
485
- * @aspType string
486
- */
487
- actionFailureTemplate?: string | Function;
488
-
489
- /**
490
- * Accepts the template design and assigns it to popup list of component when no data is available on the component.
491
- *
492
- * @default 'No records found'
493
- * @angularType string | object
494
- * @reactType string | function | JSX.Element
495
- * @vueType string | function
496
- * @aspType string
497
- */
498
- noRecordsTemplate?: string | Function;
499
-
500
- /**
501
- * Allows additional HTML attributes such as title, name, etc., and accepts n number of attributes in a key-value pair format.
502
- *
503
- * {% codeBlock src='multicolumn-combobox/htmlAttributes/index.md' %}{% endcodeBlock %}
504
- *
505
- * @default {}
506
- */
507
- htmlAttributes?: { [key: string]: string; };
508
-
509
- /**
510
- * Event callback that is raised after rendering the control.
511
- *
512
- * @event created
513
- */
514
- created?: EmitType<Event>;
515
-
516
- /**
517
- * Triggers when the popup opens.
518
- *
519
- * @event open
520
- */
521
- open?: EmitType<PopupEventArgs>;
522
-
523
- /**
524
- * Triggers when the popup is closed.
525
- *
526
- * @event close
527
- */
528
- close?: EmitType<PopupEventArgs>;
529
-
530
- /**
531
- * Triggers when the data fetch request from the remote server fails.
532
- *
533
- * @event actionFailure
534
- */
535
- actionFailure?: EmitType<Object>;
536
-
537
- /**
538
- * Triggers before fetching data from the remote server.
539
- *
540
- * @event actionBegin
541
- */
542
- actionBegin?: EmitType<Object>;
543
-
544
- /**
545
- * Triggers after data is fetched successfully from the remote server.
546
- *
547
- * @event actionComplete
548
- */
549
- actionComplete?: EmitType<Object>;
550
-
551
- /**
552
- * Triggers on typing a character in the component.
553
- *
554
- * @event filtering
555
- */
556
- filtering?: EmitType<FilteringEventArgs>;
557
-
558
- /**
559
- * Triggers when an item in the popup is selected by the user either with mouse/tap or with keyboard navigation.
560
- *
561
- * @event select
562
- */
563
- select?: EmitType<SelectEventArgs>;
564
-
565
- /**
566
- * Triggers when an item in a popup is selected or when the model value is changed by the user.
567
- *
568
- * @event change
569
- */
570
- change?: EmitType<ChangeEventArgs>;
571
-
572
- }