@exhaustive-ui/mcp 22.5.0 → 22.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (199) hide show
  1. package/data/cards/accordion.md +5 -2
  2. package/data/cards/animateonscroll.md +8 -5
  3. package/data/cards/autocomplete.md +8 -3
  4. package/data/cards/autofocus.md +4 -2
  5. package/data/cards/avatar.md +4 -2
  6. package/data/cards/badge.md +2 -1
  7. package/data/cards/breadcrumb.md +3 -1
  8. package/data/cards/button.md +8 -2
  9. package/data/cards/card.md +2 -1
  10. package/data/cards/carousel.md +7 -5
  11. package/data/cards/cascadeselect.md +2 -6
  12. package/data/cards/chart.md +9 -7
  13. package/data/cards/checkbox.md +4 -3
  14. package/data/cards/chip.md +2 -1
  15. package/data/cards/classnames.md +21 -3
  16. package/data/cards/colorpicker.md +2 -1
  17. package/data/cards/confirmdialog.md +35 -5
  18. package/data/cards/confirmpopup.md +25 -3
  19. package/data/cards/contextmenu.md +1 -7
  20. package/data/cards/dataview.md +28 -9
  21. package/data/cards/datepicker.md +4 -3
  22. package/data/cards/dialog.md +3 -3
  23. package/data/cards/divider.md +2 -1
  24. package/data/cards/dock.md +24 -3
  25. package/data/cards/dragdrop.md +5 -1
  26. package/data/cards/drawer.md +3 -3
  27. package/data/cards/dynamicdialog.md +41 -14
  28. package/data/cards/editor.md +1 -1
  29. package/data/cards/fieldset.md +2 -1
  30. package/data/cards/fileinput.md +1 -1
  31. package/data/cards/fileupload.md +7 -8
  32. package/data/cards/floatlabel.md +1 -1
  33. package/data/cards/fluid.md +7 -5
  34. package/data/cards/focustrap.md +6 -2
  35. package/data/cards/galleria.md +18 -25
  36. package/data/cards/iconfield.md +3 -2
  37. package/data/cards/iftalabel.md +1 -1
  38. package/data/cards/image.md +4 -2
  39. package/data/cards/imagecompare.md +4 -3
  40. package/data/cards/inplace.md +2 -1
  41. package/data/cards/inputgroup.md +14 -3
  42. package/data/cards/inputmask.md +2 -2
  43. package/data/cards/inputnumber.md +4 -3
  44. package/data/cards/inputotp.md +2 -2
  45. package/data/cards/inputtext.md +2 -2
  46. package/data/cards/keyfilter.md +2 -1
  47. package/data/cards/knob.md +3 -2
  48. package/data/cards/listbox.md +5 -3
  49. package/data/cards/megamenu.md +7 -8
  50. package/data/cards/menu.md +3 -7
  51. package/data/cards/menubar.md +3 -7
  52. package/data/cards/message.md +2 -1
  53. package/data/cards/metergroup.md +3 -7
  54. package/data/cards/multiselect.md +5 -9
  55. package/data/cards/orderlist.md +6 -4
  56. package/data/cards/organizationchart.md +33 -6
  57. package/data/cards/overlay.md +2 -1
  58. package/data/cards/paginator.md +2 -1
  59. package/data/cards/panel.md +2 -1
  60. package/data/cards/panelmenu.md +4 -13
  61. package/data/cards/password.md +6 -3
  62. package/data/cards/picklist.md +9 -5
  63. package/data/cards/popover.md +6 -5
  64. package/data/cards/progressbar.md +4 -3
  65. package/data/cards/progressspinner.md +2 -1
  66. package/data/cards/radiobutton.md +4 -3
  67. package/data/cards/rating.md +1 -1
  68. package/data/cards/ripple.md +2 -1
  69. package/data/cards/scrollpanel.md +2 -1
  70. package/data/cards/scrolltop.md +5 -3
  71. package/data/cards/select.md +2 -1
  72. package/data/cards/selectbutton.md +6 -2
  73. package/data/cards/skeleton.md +2 -1
  74. package/data/cards/slider.md +4 -3
  75. package/data/cards/speeddial.md +7 -4
  76. package/data/cards/splitbutton.md +21 -18
  77. package/data/cards/splitter.md +2 -1
  78. package/data/cards/stepper.md +8 -3
  79. package/data/cards/styleclass.md +4 -2
  80. package/data/cards/table.md +46 -11
  81. package/data/cards/tabs.md +2 -1
  82. package/data/cards/tag.md +2 -1
  83. package/data/cards/terminal.md +31 -22
  84. package/data/cards/textarea.md +3 -2
  85. package/data/cards/tieredmenu.md +1 -6
  86. package/data/cards/timeline.md +5 -5
  87. package/data/cards/toast.md +7 -8
  88. package/data/cards/togglebutton.md +1 -1
  89. package/data/cards/toggleswitch.md +4 -3
  90. package/data/cards/toolbar.md +8 -8
  91. package/data/cards/tooltip.md +2 -1
  92. package/data/cards/tree.md +3 -6
  93. package/data/cards/treeselect.md +6 -7
  94. package/data/cards/treetable.md +52 -31
  95. package/data/components/accordion.md +31 -23
  96. package/data/components/animateonscroll.md +18 -15
  97. package/data/components/autocomplete.md +162 -93
  98. package/data/components/autofocus.md +9 -7
  99. package/data/components/avatar.md +56 -43
  100. package/data/components/badge.md +27 -18
  101. package/data/components/blockui.md +15 -8
  102. package/data/components/breadcrumb.md +20 -14
  103. package/data/components/button.md +121 -94
  104. package/data/components/card.md +12 -10
  105. package/data/components/carousel.md +75 -53
  106. package/data/components/cascadeselect.md +271 -238
  107. package/data/components/chart.md +88 -74
  108. package/data/components/checkbox.md +107 -73
  109. package/data/components/chip.md +20 -16
  110. package/data/components/classnames.md +22 -4
  111. package/data/components/colorpicker.md +54 -36
  112. package/data/components/confirmdialog.md +146 -43
  113. package/data/components/confirmpopup.md +95 -22
  114. package/data/components/contextmenu.md +110 -39
  115. package/data/components/dataview.md +176 -83
  116. package/data/components/datepicker.md +171 -141
  117. package/data/components/dialog.md +80 -68
  118. package/data/components/divider.md +17 -12
  119. package/data/components/dock.md +63 -27
  120. package/data/components/dragdrop.md +26 -12
  121. package/data/components/drawer.md +67 -48
  122. package/data/components/dynamicdialog.md +22 -13
  123. package/data/components/editor.md +42 -33
  124. package/data/components/fieldset.md +20 -17
  125. package/data/components/fileinput.md +92 -35
  126. package/data/components/fileupload.md +101 -61
  127. package/data/components/floatlabel.md +20 -11
  128. package/data/components/fluid.md +11 -9
  129. package/data/components/focustrap.md +11 -7
  130. package/data/components/galleria.md +224 -83
  131. package/data/components/iconfield.md +23 -15
  132. package/data/components/iftalabel.md +15 -9
  133. package/data/components/image.md +31 -26
  134. package/data/components/imagecompare.md +8 -6
  135. package/data/components/inplace.md +27 -22
  136. package/data/components/inputgroup.md +53 -29
  137. package/data/components/inputmask.md +107 -85
  138. package/data/components/inputnumber.md +127 -89
  139. package/data/components/inputotp.md +55 -42
  140. package/data/components/inputtext.md +72 -50
  141. package/data/components/keyfilter.md +6 -3
  142. package/data/components/knob.md +70 -58
  143. package/data/components/listbox.md +171 -141
  144. package/data/components/megamenu.md +24 -23
  145. package/data/components/menu.md +37 -34
  146. package/data/components/menubar.md +27 -22
  147. package/data/components/message.md +44 -32
  148. package/data/components/metergroup.md +48 -17
  149. package/data/components/multiselect.md +232 -168
  150. package/data/components/orderlist.md +55 -48
  151. package/data/components/organizationchart.md +182 -13
  152. package/data/components/overlay.md +31 -26
  153. package/data/components/paginator.md +49 -34
  154. package/data/components/panel.md +23 -19
  155. package/data/components/panelmenu.md +51 -25
  156. package/data/components/password.md +104 -91
  157. package/data/components/picklist.md +92 -70
  158. package/data/components/popover.md +68 -46
  159. package/data/components/progressbar.md +28 -22
  160. package/data/components/progressspinner.md +13 -11
  161. package/data/components/radiobutton.md +69 -35
  162. package/data/components/rating.md +48 -40
  163. package/data/components/ripple.md +8 -6
  164. package/data/components/scroller.md +29 -29
  165. package/data/components/scrollpanel.md +9 -7
  166. package/data/components/scrolltop.md +20 -18
  167. package/data/components/select.md +248 -169
  168. package/data/components/selectbutton.md +118 -56
  169. package/data/components/skeleton.md +22 -18
  170. package/data/components/slider.md +73 -49
  171. package/data/components/speeddial.md +77 -59
  172. package/data/components/splitbutton.md +354 -329
  173. package/data/components/splitter.md +22 -18
  174. package/data/components/stepper.md +38 -21
  175. package/data/components/styleclass.md +12 -6
  176. package/data/components/table.md +523 -314
  177. package/data/components/tabs.md +44 -26
  178. package/data/components/tag.md +18 -14
  179. package/data/components/terminal.md +38 -27
  180. package/data/components/textarea.md +82 -47
  181. package/data/components/tieredmenu.md +34 -29
  182. package/data/components/timeline.md +29 -28
  183. package/data/components/toast.md +115 -57
  184. package/data/components/togglebutton.md +53 -39
  185. package/data/components/toggleswitch.md +41 -28
  186. package/data/components/toolbar.md +19 -18
  187. package/data/components/tooltip.md +43 -32
  188. package/data/components/tree.md +114 -81
  189. package/data/components/treeselect.md +176 -174
  190. package/data/components/treetable.md +1250 -1045
  191. package/data/components.json +4122 -4080
  192. package/data/llms-full.txt +8784 -6249
  193. package/data/manifest.json +154 -15
  194. package/data/pages/tailwind.md +20 -10
  195. package/data/snapshot.json +2 -2
  196. package/dist/index.d.mts +2 -0
  197. package/dist/index.mjs +3 -3
  198. package/dist/index.mjs.map +1 -1
  199. package/package.json +1 -1
@@ -4,7 +4,7 @@ MultiSelect is used to select multiple items from a collection.
4
4
 
5
5
  ## Accessibility
6
6
 
7
- Screen Reader Value to describe the component can either be provided with ariaLabelledBy or ariaLabel props. The multiselect component has a combobox role in addition to aria-haspopup and aria-expanded attributes. The relation between the combobox and the popup is created with aria-controls attribute that refers to the id of the popup listbox. The popup listbox uses listbox as the role with aria-multiselectable enabled. Each list item has an option role along with aria-label , aria-selected and aria-disabled attributes. Checkbox component at the header uses a hidden native checkbox element internally that is only visible to screen readers. Value to read is defined with the selectAll and unselectAll keys of the aria property from the locale API. If filtering is enabled, filterInputProps can be defined to give aria-* props to the input element. Close button uses close key of the aria property from the locale API as the aria-label by default, this can be overriden with the closeButtonProps .
7
+ Screen Reader Value to describe the component can either be provided with ariaLabelledBy or ariaLabel props. The multiselect component has a combobox role in addition to aria-haspopup and aria-expanded attributes. The relation between the combobox and the popup is created with aria-controls attribute that refers to the id of the popup listbox. The popup listbox uses listbox as the role with aria-multiselectable enabled. Each list item has an option role along with aria-label , aria-selected and aria-disabled attributes. Checkbox component at the header uses a hidden native checkbox element internally that is only visible to screen readers. Value to read is defined with the selectAll and unselectAll keys of the aria property from the locale API. If filtering is enabled, ariaFilterLabel can be defined to give an aria-label to the filter input element.
8
8
 
9
9
  ## Basic
10
10
 
@@ -23,14 +23,15 @@ interface City {
23
23
  @Component({
24
24
  template: `
25
25
  <div class="card flex justify-center">
26
- <p-multi-select [options]="cities" [(ngModel)]="selectedCities" optionLabel="name" placeholder="Select Cities" [maxSelectedLabels]="3" class="w-full md:w-80" />
26
+ <p-multi-select [options]="cities" [(ngModel)]="selectedCities" optionLabel="name" placeholder="Select Cities" [maxSelectedLabels]="3" class="w-full md:w-80" ariaLabel="Cities" />
27
27
  </div>
28
28
  `,
29
29
  standalone: true,
30
- imports: [MultiSelectModule, FormsModule]
30
+ imports: [FormsModule, MultiSelectModule]
31
31
  })
32
32
  export class MultiselectBasicDemo implements OnInit {
33
33
  cities!: City[];
34
+
34
35
  selectedCities!: any[];
35
36
 
36
37
  ngOnInit() {
@@ -62,14 +63,15 @@ interface City {
62
63
  @Component({
63
64
  template: `
64
65
  <div class="card flex justify-center">
65
- <p-multi-select [options]="cities" [(ngModel)]="selectedCities" placeholder="Select Cities" optionLabel="name" display="chip" class="w-full md:w-80" />
66
+ <p-multi-select [options]="cities" [(ngModel)]="selectedCities" placeholder="Select Cities" optionLabel="name" display="chip" class="w-full md:w-80" ariaLabel="Cities" />
66
67
  </div>
67
68
  `,
68
69
  standalone: true,
69
- imports: [MultiSelectModule, FormsModule]
70
+ imports: [FormsModule, MultiSelectModule]
70
71
  })
71
72
  export class MultiselectChipsDemo implements OnInit {
72
73
  cities!: City[];
74
+
73
75
  selectedCities!: City[];
74
76
 
75
77
  ngOnInit() {
@@ -101,14 +103,15 @@ interface City {
101
103
  @Component({
102
104
  template: `
103
105
  <div class="card flex justify-center">
104
- <p-multi-select [options]="cities" [(ngModel)]="selectedCities" optionLabel="name" placeholder="Select Cities" [maxSelectedLabels]="3" class="w-full md:w-80" [showClear]="true" />
106
+ <p-multi-select [options]="cities" [(ngModel)]="selectedCities" optionLabel="name" placeholder="Select Cities" [maxSelectedLabels]="3" class="w-full md:w-80" [showClear]="true" ariaLabel="Cities" />
105
107
  </div>
106
108
  `,
107
109
  standalone: true,
108
- imports: [MultiSelectModule, FormsModule]
110
+ imports: [FormsModule, MultiSelectModule]
109
111
  })
110
112
  export class MultiselectCleariconDemo implements OnInit {
111
113
  cities!: City[];
114
+
112
115
  selectedCities!: any[];
113
116
 
114
117
  ngOnInit() {
@@ -140,14 +143,15 @@ interface City {
140
143
  @Component({
141
144
  template: `
142
145
  <div class="card flex justify-center">
143
- <p-multi-select [options]="cities" [(ngModel)]="selectedCities" [disabled]="true" optionLabel="name" placeholder="Select Cities" class="w-full md:w-80" />
146
+ <p-multi-select [options]="cities" [(ngModel)]="selectedCities" [disabled]="true" optionLabel="name" placeholder="Select Cities" class="w-full md:w-80" ariaLabel="Cities" />
144
147
  </div>
145
148
  `,
146
149
  standalone: true,
147
- imports: [MultiSelectModule, FormsModule]
150
+ imports: [FormsModule, MultiSelectModule]
148
151
  })
149
152
  export class MultiselectDisabledDemo implements OnInit {
150
153
  cities!: City[];
154
+
151
155
  selectedCities!: City[];
152
156
 
153
157
  ngOnInit() {
@@ -179,14 +183,15 @@ interface City {
179
183
  @Component({
180
184
  template: `
181
185
  <div class="card flex justify-center">
182
- <p-multi-select [options]="cities" [(ngModel)]="selectedCities" variant="filled" optionLabel="name" placeholder="Select Cities" [maxSelectedLabels]="3" class="w-full md:w-80" />
186
+ <p-multi-select [options]="cities" [(ngModel)]="selectedCities" variant="filled" optionLabel="name" placeholder="Select Cities" [maxSelectedLabels]="3" class="w-full md:w-80" ariaLabel="Cities" />
183
187
  </div>
184
188
  `,
185
189
  standalone: true,
186
- imports: [MultiSelectModule, FormsModule]
190
+ imports: [FormsModule, MultiSelectModule]
187
191
  })
188
192
  export class MultiselectFilledDemo implements OnInit {
189
193
  cities!: City[];
194
+
190
195
  selectedCities!: any[];
191
196
 
192
197
  ngOnInit() {
@@ -218,14 +223,15 @@ interface City {
218
223
  @Component({
219
224
  template: `
220
225
  <div class="card flex justify-center">
221
- <p-multi-select [options]="cities" [(ngModel)]="selectedCities" [filter]="true" optionLabel="name" placeholder="Select Cities" [maxSelectedLabels]="3" class="w-full md:w-80" />
226
+ <p-multi-select [options]="cities" [(ngModel)]="selectedCities" [filter]="true" optionLabel="name" placeholder="Select Cities" [maxSelectedLabels]="3" class="w-full md:w-80" ariaLabel="Cities" />
222
227
  </div>
223
228
  `,
224
229
  standalone: true,
225
- imports: [MultiSelectModule, FormsModule]
230
+ imports: [FormsModule, MultiSelectModule]
226
231
  })
227
232
  export class MultiselectFilterDemo implements OnInit {
228
233
  cities!: City[];
234
+
229
235
  selectedCities!: City[];
230
236
 
231
237
  ngOnInit() {
@@ -247,8 +253,9 @@ A floating label appears on top of the input field when focused. Visit FloatLabe
247
253
  ```typescript
248
254
  import { Component, OnInit } from '@angular/core';
249
255
  import { FormsModule } from '@angular/forms';
250
- import { FloatLabelModule } from '@exhaustive-ui/core/floatlabel';
256
+ import { RouterModule } from '@angular/router';
251
257
  import { MultiSelectModule } from '@exhaustive-ui/core/multiselect';
258
+ import { FloatLabelModule } from '@exhaustive-ui/core/floatlabel';
252
259
 
253
260
  interface City {
254
261
  name: string;
@@ -259,26 +266,29 @@ interface City {
259
266
  template: `
260
267
  <div class="card flex flex-wrap justify-center items-end gap-4">
261
268
  <p-float-label class="w-full md:w-80">
262
- <p-multi-select id="over_label" [(ngModel)]="value1" [options]="cities" optionLabel="name" filter [maxSelectedLabels]="3" class="w-full" />
269
+ <p-multi-select inputId="over_label" [(ngModel)]="value1" [options]="cities" optionLabel="name" filter [maxSelectedLabels]="3" class="w-full" />
263
270
  <label for="over_label">Over Label</label>
264
271
  </p-float-label>
265
272
  <p-float-label class="w-full md:w-80" variant="in">
266
- <p-multi-select id="in_label" [(ngModel)]="value2" [options]="cities" optionLabel="name" filter [maxSelectedLabels]="3" class="w-full" />
273
+ <p-multi-select inputId="in_label" [(ngModel)]="value2" [options]="cities" optionLabel="name" filter [maxSelectedLabels]="3" class="w-full" />
267
274
  <label for="in_label">In Label</label>
268
275
  </p-float-label>
269
276
  <p-float-label class="w-full md:w-80" variant="on">
270
- <p-multi-select id="on_label" [(ngModel)]="value3" [options]="cities" optionLabel="name" filter [maxSelectedLabels]="3" class="w-full" />
277
+ <p-multi-select inputId="on_label" [(ngModel)]="value3" [options]="cities" optionLabel="name" filter [maxSelectedLabels]="3" class="w-full" />
271
278
  <label for="on_label">On Label</label>
272
279
  </p-float-label>
273
280
  </div>
274
281
  `,
275
282
  standalone: true,
276
- imports: [FloatLabelModule, MultiSelectModule, FormsModule]
283
+ imports: [FormsModule, RouterModule, MultiSelectModule, FloatLabelModule]
277
284
  })
278
285
  export class MultiselectFloatlabelDemo implements OnInit {
279
286
  cities!: City[];
287
+
280
288
  value1!: City[];
289
+
281
290
  value2!: City[];
291
+
282
292
  value3!: City[];
283
293
 
284
294
  ngOnInit() {
@@ -310,14 +320,15 @@ interface City {
310
320
  @Component({
311
321
  template: `
312
322
  <div class="card flex justify-center">
313
- <p-multi-select [options]="cities" [(ngModel)]="selectedCities" optionLabel="name" placeholder="Select Cities" [maxSelectedLabels]="3" fluid />
323
+ <p-multi-select [options]="cities" [(ngModel)]="selectedCities" optionLabel="name" placeholder="Select Cities" [maxSelectedLabels]="3" fluid ariaLabel="Cities" />
314
324
  </div>
315
325
  `,
316
326
  standalone: true,
317
- imports: [MultiSelectModule, FormsModule]
327
+ imports: [FormsModule, MultiSelectModule]
318
328
  })
319
329
  export class MultiselectFluidDemo implements OnInit {
320
330
  cities!: City[];
331
+
321
332
  selectedCities!: any[];
322
333
 
323
334
  ngOnInit() {
@@ -339,8 +350,8 @@ Options can be grouped when a nested data structures is provided.
339
350
  ```typescript
340
351
  import { Component } from '@angular/core';
341
352
  import { FormsModule } from '@angular/forms';
342
- import { MultiSelectModule } from '@exhaustive-ui/core/multiselect';
343
353
  import { SelectItemGroup } from '@exhaustive-ui/core/api';
354
+ import { MultiSelectModule } from '@exhaustive-ui/core/multiselect';
344
355
 
345
356
  interface City {
346
357
  name: string;
@@ -350,7 +361,7 @@ interface City {
350
361
  @Component({
351
362
  template: `
352
363
  <div class="card flex justify-center">
353
- <p-multi-select [options]="groupedCities" [group]="true" [(ngModel)]="selectedCities" placeholder="Select Cities" scrollHeight="250px" display="chip" class="w-full md:w-80">
364
+ <p-multi-select [options]="groupedCities" [group]="true" [(ngModel)]="selectedCities" placeholder="Select Cities" scrollHeight="250px" display="chip" class="w-full md:w-80" ariaLabel="Cities">
354
365
  <ng-template let-group #group>
355
366
  <div class="flex items-center">
356
367
  <img src="https://exhaustive-ui.com/demo/flag/flag_placeholder.png" [class]="'mr-2 flag flag-' + group.value" style="width: 20px" />
@@ -361,45 +372,46 @@ interface City {
361
372
  </div>
362
373
  `,
363
374
  standalone: true,
364
- imports: [MultiSelectModule, FormsModule]
375
+ imports: [FormsModule, MultiSelectModule]
365
376
  })
366
377
  export class MultiselectGroupDemo {
367
378
  groupedCities!: SelectItemGroup[];
379
+
368
380
  selectedCities!: City[];
369
381
 
370
382
  constructor() {
371
383
  this.groupedCities = [
372
- {
373
- label: 'Germany',
374
- value: 'de',
375
- items: [
376
- { label: 'Berlin', value: 'Berlin' },
377
- { label: 'Frankfurt', value: 'Frankfurt' },
378
- { label: 'Hamburg', value: 'Hamburg' },
379
- { label: 'Munich', value: 'Munich' }
380
- ]
381
- },
382
- {
383
- label: 'USA',
384
- value: 'us',
385
- items: [
386
- { label: 'Chicago', value: 'Chicago' },
387
- { label: 'Los Angeles', value: 'Los Angeles' },
388
- { label: 'New York', value: 'New York' },
389
- { label: 'San Francisco', value: 'San Francisco' }
390
- ]
391
- },
392
- {
393
- label: 'Japan',
394
- value: 'jp',
395
- items: [
396
- { label: 'Kyoto', value: 'Kyoto' },
397
- { label: 'Osaka', value: 'Osaka' },
398
- { label: 'Tokyo', value: 'Tokyo' },
399
- { label: 'Yokohama', value: 'Yokohama' }
400
- ]
401
- }
402
- ];
384
+ {
385
+ label: 'Germany',
386
+ value: 'de',
387
+ items: [
388
+ { label: 'Berlin', value: 'Berlin' },
389
+ { label: 'Frankfurt', value: 'Frankfurt' },
390
+ { label: 'Hamburg', value: 'Hamburg' },
391
+ { label: 'Munich', value: 'Munich' }
392
+ ]
393
+ },
394
+ {
395
+ label: 'USA',
396
+ value: 'us',
397
+ items: [
398
+ { label: 'Chicago', value: 'Chicago' },
399
+ { label: 'Los Angeles', value: 'Los Angeles' },
400
+ { label: 'New York', value: 'New York' },
401
+ { label: 'San Francisco', value: 'San Francisco' }
402
+ ]
403
+ },
404
+ {
405
+ label: 'Japan',
406
+ value: 'jp',
407
+ items: [
408
+ { label: 'Kyoto', value: 'Kyoto' },
409
+ { label: 'Osaka', value: 'Osaka' },
410
+ { label: 'Tokyo', value: 'Tokyo' },
411
+ { label: 'Yokohama', value: 'Yokohama' }
412
+ ]
413
+ }
414
+ ];
403
415
  }
404
416
  }
405
417
  ```
@@ -411,8 +423,9 @@ IftaLabel is used to create infield top aligned labels. Visit IftaLabel document
411
423
  ```typescript
412
424
  import { Component, OnInit } from '@angular/core';
413
425
  import { FormsModule } from '@angular/forms';
414
- import { IftaLabelModule } from '@exhaustive-ui/core/iftalabel';
426
+ import { RouterModule } from '@angular/router';
415
427
  import { MultiSelectModule } from '@exhaustive-ui/core/multiselect';
428
+ import { IftaLabelModule } from '@exhaustive-ui/core/iftalabel';
416
429
 
417
430
  interface City {
418
431
  name: string;
@@ -429,10 +442,11 @@ interface City {
429
442
  </div>
430
443
  `,
431
444
  standalone: true,
432
- imports: [IftaLabelModule, MultiSelectModule, FormsModule]
445
+ imports: [FormsModule, RouterModule, MultiSelectModule, IftaLabelModule]
433
446
  })
434
447
  export class MultiselectIftalabelDemo implements OnInit {
435
448
  cities!: City[];
449
+
436
450
  selectedCities!: City[];
437
451
 
438
452
  ngOnInit() {
@@ -464,18 +478,28 @@ interface City {
464
478
  @Component({
465
479
  template: `
466
480
  <div class="card flex justify-center gap-4">
467
- <p-multi-select [options]="cities" [(ngModel)]="selectedCities1" [invalid]="value1" optionLabel="name" placeholder="Select Cities" [maxSelectedLabels]="3" class="w-full md:w-80" />
468
- <p-multi-select [options]="cities" [(ngModel)]="selectedCities2" [invalid]="value2" optionLabel="name" placeholder="Select Cities" [maxSelectedLabels]="3" class="w-full md:w-80" variant="filled" />
481
+ <p-multi-select [options]="cities" [(ngModel)]="selectedCities1" [invalid]="value1" optionLabel="name" placeholder="Select Cities" [maxSelectedLabels]="3" class="w-full md:w-80" ariaLabel="Cities" />
482
+ <p-multi-select [options]="cities" [(ngModel)]="selectedCities2" [invalid]="value2" optionLabel="name" placeholder="Select Cities" [maxSelectedLabels]="3" class="w-full md:w-80" variant="filled" ariaLabel="Cities" />
469
483
  </div>
470
484
  `,
471
485
  standalone: true,
472
- imports: [MultiSelectModule, FormsModule]
486
+ imports: [FormsModule, MultiSelectModule]
473
487
  })
474
488
  export class MultiselectInvalidDemo {
475
489
  value1: boolean = true;
490
+
476
491
  value2: boolean = true;
477
- cities: City[];
492
+
493
+ cities: City[] = [
494
+ { name: 'New York', code: 'NY' },
495
+ { name: 'Rome', code: 'RM' },
496
+ { name: 'London', code: 'LDN' },
497
+ { name: 'Istanbul', code: 'IST' },
498
+ { name: 'Paris', code: 'PRS' }
499
+ ];
500
+
478
501
  selectedCities1!: City[];
502
+
479
503
  selectedCities2!: City[];
480
504
  }
481
505
  ```
@@ -497,14 +521,15 @@ interface City {
497
521
  @Component({
498
522
  template: `
499
523
  <div class="card flex justify-center">
500
- <p-multi-select [options]="cities" [(ngModel)]="selectedCities" [loading]="true" optionLabel="name" placeholder="Loading..." class="w-full md:w-80" />
524
+ <p-multi-select [options]="cities" [(ngModel)]="selectedCities" [loading]="true" optionLabel="name" placeholder="Loading..." class="w-full md:w-80" ariaLabel="Cities" />
501
525
  </div>
502
526
  `,
503
527
  standalone: true,
504
- imports: [MultiSelectModule, FormsModule]
528
+ imports: [FormsModule, MultiSelectModule]
505
529
  })
506
530
  export class MultiselectLoadingstateDemo implements OnInit {
507
531
  cities!: City[];
532
+
508
533
  selectedCities!: any[];
509
534
 
510
535
  ngOnInit() {
@@ -525,12 +550,13 @@ MultiSelect can also be used with reactive forms. In this case, the formControlN
525
550
 
526
551
  ```typescript
527
552
  import { Component, inject } from '@angular/core';
528
- import { ReactiveFormsModule } from '@angular/forms';
529
- import { MessageModule } from '@exhaustive-ui/core/message';
553
+ import { FormBuilder, FormGroup, Validators, ReactiveFormsModule } from '@angular/forms';
554
+ import { CommonModule } from '@angular/common';
555
+ import { MessageService } from '@exhaustive-ui/core/api';
530
556
  import { MultiSelectModule } from '@exhaustive-ui/core/multiselect';
531
- import { ToastModule } from '@exhaustive-ui/core/toast';
532
557
  import { ButtonModule } from '@exhaustive-ui/core/button';
533
- import { MessageService } from '@exhaustive-ui/core/api';
558
+ import { ToastModule } from '@exhaustive-ui/core/toast';
559
+ import { MessageModule } from '@exhaustive-ui/core/message';
534
560
 
535
561
  interface City {
536
562
  name: string;
@@ -543,7 +569,7 @@ interface City {
543
569
  <div class="card flex justify-center">
544
570
  <form [formGroup]="exampleForm" (ngSubmit)="onSubmit()" class="flex justify-center flex-col gap-4 w-full md:w-80">
545
571
  <div class="flex flex-col gap-1">
546
- <p-multi-select [options]="cities" formControlName="city" optionLabel="name" placeholder="Select Cities" [maxSelectedLabels]="3" [fluid]="true" [invalid]="isInvalid('city')" />
572
+ <p-multi-select [options]="cities" formControlName="city" optionLabel="name" placeholder="Select Cities" [maxSelectedLabels]="3" [fluid]="true" [invalid]="isInvalid('city')" ariaLabel="Cities" />
547
573
  @if (isInvalid('city')) {
548
574
  <p-message severity="error" size="small" variant="simple">City is required.</p-message>
549
575
  }
@@ -553,20 +579,30 @@ interface City {
553
579
  </div>
554
580
  `,
555
581
  standalone: true,
556
- imports: [MessageModule, MultiSelectModule, ToastModule, ButtonModule, ReactiveFormsModule],
582
+ imports: [ReactiveFormsModule, MultiSelectModule, ButtonModule, ToastModule, MessageModule, CommonModule],
557
583
  providers: [MessageService]
558
584
  })
559
585
  export class MultiselectReactiveformsDemo {
560
- private messageService = inject(MessageService);
586
+ private fb = inject(FormBuilder);
587
+
561
588
  messageService = inject(MessageService);
562
- cities: City[];
589
+
590
+ cities: City[] = [
591
+ { name: 'New York', code: 'NY' },
592
+ { name: 'Rome', code: 'RM' },
593
+ { name: 'London', code: 'LDN' },
594
+ { name: 'Istanbul', code: 'IST' },
595
+ { name: 'Paris', code: 'PRS' }
596
+ ];
597
+
563
598
  exampleForm: FormGroup | undefined;
564
- formSubmitted: boolean = false;
599
+
600
+ formSubmitted = false;
565
601
 
566
602
  constructor() {
567
603
  this.exampleForm = this.fb.group({
568
- city: ['', Validators.required]
569
- });
604
+ city: ['', Validators.required]
605
+ });
570
606
  }
571
607
 
572
608
  onSubmit() {
@@ -592,11 +628,11 @@ MultiSelect can also be used with Angular Signal Forms , the @angular/forms/sign
592
628
  ```typescript
593
629
  import { Component, inject, signal } from '@angular/core';
594
630
  import { form, FormField, minLength, submit } from '@angular/forms/signals';
595
- import { MessageModule } from '@exhaustive-ui/core/message';
631
+ import { MessageService } from '@exhaustive-ui/core/api';
596
632
  import { MultiSelectModule } from '@exhaustive-ui/core/multiselect';
597
- import { ToastModule } from '@exhaustive-ui/core/toast';
598
633
  import { ButtonModule } from '@exhaustive-ui/core/button';
599
- import { MessageService } from '@exhaustive-ui/core/api';
634
+ import { ToastModule } from '@exhaustive-ui/core/toast';
635
+ import { MessageModule } from '@exhaustive-ui/core/message';
600
636
 
601
637
  interface City {
602
638
  name: string;
@@ -609,7 +645,7 @@ interface City {
609
645
  <div class="card flex justify-center">
610
646
  <form novalidate (submit)="onSubmit($event)" class="flex justify-center flex-col gap-4 w-full md:w-80">
611
647
  <div class="flex flex-col gap-1">
612
- <p-multi-select [options]="cities" [formField]="exampleForm.city" optionLabel="name" placeholder="Select Cities" [maxSelectedLabels]="3" [fluid]="true" />
648
+ <p-multi-select [options]="cities" [formField]="exampleForm.city" optionLabel="name" placeholder="Select Cities" [maxSelectedLabels]="3" [fluid]="true" ariaLabel="Cities" />
613
649
  @let city = exampleForm.city();
614
650
  @if (city.invalid() && city.touched()) {
615
651
  <p-message severity="error" size="small" variant="simple">City is required.</p-message>
@@ -620,12 +656,22 @@ interface City {
620
656
  </div>
621
657
  `,
622
658
  standalone: true,
623
- imports: [MessageModule, MultiSelectModule, ToastModule, ButtonModule, FormField]
659
+ imports: [FormField, MultiSelectModule, ButtonModule, ToastModule, MessageModule],
660
+ providers: [MessageService]
624
661
  })
625
662
  export class MultiselectSignalformsDemo {
626
663
  messageService = inject(MessageService);
627
- cities: City[];
664
+
665
+ cities: City[] = [
666
+ { name: 'New York', code: 'NY' },
667
+ { name: 'Rome', code: 'RM' },
668
+ { name: 'London', code: 'LDN' },
669
+ { name: 'Istanbul', code: 'IST' },
670
+ { name: 'Paris', code: 'PRS' }
671
+ ];
672
+
628
673
  model = signal<{ city: City[] }>({ city: [] });
674
+
629
675
  exampleForm = form(this.model, (f) => {
630
676
  // required() accepts an empty array, minLength() asks for one city at least
631
677
  minLength(f.city, 1);
@@ -658,18 +704,21 @@ interface City {
658
704
  @Component({
659
705
  template: `
660
706
  <div class="card flex flex-col items-center gap-4">
661
- <p-multi-select [(ngModel)]="value1" [options]="cities" optionLabel="name" [maxSelectedLabels]="3" class="w-full md:w-80" size="small" placeholder="Small" />
662
- <p-multi-select [(ngModel)]="value2" [options]="cities" optionLabel="name" [maxSelectedLabels]="3" class="w-full md:w-80" placeholder="Normal" />
663
- <p-multi-select [(ngModel)]="value3" [options]="cities" optionLabel="name" [maxSelectedLabels]="3" class="w-full md:w-80" size="large" placeholder="Large" />
707
+ <p-multi-select [(ngModel)]="value1" [options]="cities" optionLabel="name" [maxSelectedLabels]="3" class="w-full md:w-80" size="small" placeholder="Small" ariaLabel="Small" />
708
+ <p-multi-select [(ngModel)]="value2" [options]="cities" optionLabel="name" [maxSelectedLabels]="3" class="w-full md:w-80" placeholder="Normal" ariaLabel="Normal" />
709
+ <p-multi-select [(ngModel)]="value3" [options]="cities" optionLabel="name" [maxSelectedLabels]="3" class="w-full md:w-80" size="large" placeholder="Large" ariaLabel="Large" />
664
710
  </div>
665
711
  `,
666
712
  standalone: true,
667
- imports: [MultiSelectModule, FormsModule]
713
+ imports: [FormsModule, MultiSelectModule]
668
714
  })
669
715
  export class MultiselectSizesDemo implements OnInit {
670
716
  cities!: City[];
717
+
671
718
  value1: any[];
719
+
672
720
  value2: any[];
721
+
673
722
  value3: any[];
674
723
 
675
724
  ngOnInit() {
@@ -691,9 +740,8 @@ Available options and the selected options support customization with item and s
691
740
  ```typescript
692
741
  import { Component, OnInit } from '@angular/core';
693
742
  import { FormsModule } from '@angular/forms';
694
- import { ButtonModule } from '@exhaustive-ui/core/button';
695
743
  import { MultiSelectModule } from '@exhaustive-ui/core/multiselect';
696
- import { Country } from '@/domain/customer';
744
+ import { ButtonModule } from '@exhaustive-ui/core/button';
697
745
 
698
746
  interface Country {
699
747
  name: string;
@@ -703,7 +751,7 @@ interface Country {
703
751
  @Component({
704
752
  template: `
705
753
  <div class="card flex justify-center">
706
- <p-multi-select [options]="countries" [(ngModel)]="selectedCountries" placeholder="Select Countries" optionLabel="name" class="w-full md:w-80" display="chip">
754
+ <p-multi-select [options]="countries" [(ngModel)]="selectedCountries" placeholder="Select Countries" optionLabel="name" class="w-full md:w-80" display="chip" ariaLabel="Countries">
707
755
  <ng-template let-country #item>
708
756
  <div class="flex items-center gap-2">
709
757
  <img src="https://exhaustive-ui.com/demo/flag/flag_placeholder.png" [class]="'flag flag-' + country.code.toLowerCase()" style="width: 18px" />
@@ -729,10 +777,11 @@ interface Country {
729
777
  </div>
730
778
  `,
731
779
  standalone: true,
732
- imports: [ButtonModule, MultiSelectModule, FormsModule]
780
+ imports: [FormsModule, MultiSelectModule, ButtonModule]
733
781
  })
734
782
  export class MultiselectTemplateDemo implements OnInit {
735
783
  countries!: Country[];
784
+
736
785
  selectedCountries!: Country[];
737
786
 
738
787
  ngOnInit() {
@@ -757,11 +806,12 @@ export class MultiselectTemplateDemo implements OnInit {
757
806
  ```typescript
758
807
  import { Component, inject } from '@angular/core';
759
808
  import { FormsModule } from '@angular/forms';
760
- import { MessageModule } from '@exhaustive-ui/core/message';
809
+ import { CommonModule } from '@angular/common';
810
+ import { MessageService } from '@exhaustive-ui/core/api';
761
811
  import { MultiSelectModule } from '@exhaustive-ui/core/multiselect';
762
- import { ToastModule } from '@exhaustive-ui/core/toast';
763
812
  import { ButtonModule } from '@exhaustive-ui/core/button';
764
- import { MessageService } from '@exhaustive-ui/core/api';
813
+ import { ToastModule } from '@exhaustive-ui/core/toast';
814
+ import { MessageModule } from '@exhaustive-ui/core/message';
765
815
 
766
816
  interface City {
767
817
  name: string;
@@ -785,6 +835,7 @@ interface City {
785
835
  [invalid]="city.invalid && (city.touched || exampleForm.submitted)"
786
836
  fluid
787
837
  required
838
+ ariaLabel="Cities"
788
839
  />
789
840
  @if (city.invalid && (city.touched || exampleForm.submitted)) {
790
841
  <p-message severity="error" size="small" variant="simple">City is required.</p-message>
@@ -795,13 +846,20 @@ interface City {
795
846
  </div>
796
847
  `,
797
848
  standalone: true,
798
- imports: [MessageModule, MultiSelectModule, ToastModule, ButtonModule, FormsModule],
849
+ imports: [FormsModule, MultiSelectModule, ButtonModule, ToastModule, MessageModule, CommonModule],
799
850
  providers: [MessageService]
800
851
  })
801
852
  export class MultiselectTemplatedrivenformsDemo {
802
- private messageService = inject(MessageService);
803
853
  messageService = inject(MessageService);
804
- cities: City[];
854
+
855
+ cities: City[] = [
856
+ { name: 'New York', code: 'NY' },
857
+ { name: 'Rome', code: 'RM' },
858
+ { name: 'London', code: 'LDN' },
859
+ { name: 'Istanbul', code: 'IST' },
860
+ { name: 'Paris', code: 'PRS' }
861
+ ];
862
+
805
863
  selectedCity: City | undefined;
806
864
 
807
865
  onSubmit(form: any) {
@@ -818,9 +876,10 @@ export class MultiselectTemplatedrivenformsDemo {
818
876
  VirtualScrolling is an efficient way of rendering the options by displaying a small subset of data in the viewport at any time. When dealing with huge number of options, it is suggested to enable VirtualScrolling to avoid performance issues. Usage is simple as setting virtualScroll property to true and defining virtualScrollItemSize to specify the height of an item.
819
877
 
820
878
  ```typescript
821
- import { Component } from '@angular/core';
879
+ import { Component, ViewChild } from '@angular/core';
880
+ import { CommonModule } from '@angular/common';
822
881
  import { FormsModule } from '@angular/forms';
823
- import { MultiSelectModule } from '@exhaustive-ui/core/multiselect';
882
+ import { MultiSelect, MultiSelectModule } from '@exhaustive-ui/core/multiselect';
824
883
 
825
884
  @Component({
826
885
  template: `
@@ -838,6 +897,7 @@ import { MultiSelectModule } from '@exhaustive-ui/core/multiselect';
838
897
  [maxSelectedLabels]="3"
839
898
  class="w-full md:w-80"
840
899
  #ms
900
+ ariaLabel="Items"
841
901
  >
842
902
  <ng-template #headercheckboxicon let-allSelected="checked" let-partialSelected="partialSelected">
843
903
  <i class="pi pi-check" *ngIf="allSelected"></i>
@@ -847,11 +907,15 @@ import { MultiSelectModule } from '@exhaustive-ui/core/multiselect';
847
907
  </div>
848
908
  `,
849
909
  standalone: true,
850
- imports: [MultiSelectModule, FormsModule]
910
+ imports: [CommonModule, FormsModule, MultiSelectModule]
851
911
  })
852
912
  export class MultiselectVirtualscrollDemo {
853
- items: any = Array.from({ length: 100000 }, (_, i) => ({ label: `Item #${i}`, value: i }));
913
+ @ViewChild('ms') ms: MultiSelect;
914
+
915
+ items = Array.from({ length: 100000 }, (_, i) => ({ label: `Item #${i}`, value: i }));
916
+
854
917
  selectedItems!: any[];
918
+
855
919
  selectAll: boolean = false;
856
920
 
857
921
  onSelectAllChange(event) {
@@ -869,77 +933,77 @@ MultiSelect is used to select multiple items from a collection.
869
933
 
870
934
  | Name | Type | Default | Description |
871
935
  |------|------|---------|-------------|
872
- | dt | InputSignal<Object> | undefined | Defines scoped design tokens of the component. |
873
- | unstyled | InputSignal<boolean> | undefined | Indicates whether the component should be rendered without styles. |
874
- | pt | InputSignal<MultiSelectPassThrough> | undefined | Used to pass attributes to DOM elements inside the component. |
875
- | ptOptions | InputSignal<PassThroughOptions> | undefined | Used to configure passthrough(pt) options of the component. |
876
- | required | InputSignalWithTransform<boolean, unknown> | false | There must be a value (if set). |
877
- | invalid | InputSignalWithTransform<boolean, unknown> | false | When present, it specifies that the component should have invalid state style. |
878
- | disabled | InputSignalWithTransform<boolean, unknown> | false | When present, it specifies that the component should have disabled state style. |
879
- | name | InputSignal<string> | undefined | When present, it specifies that the name of the input. |
880
- | id | InputSignal<string> | ... | Unique identifier of the component |
881
- | ariaLabel | InputSignal<string> | ... | Defines a string that labels the input for accessibility. |
882
- | panelStyle | InputSignal<any> | ... | Inline style of the overlay panel. |
883
- | panelStyleClass | InputSignal<string> | ... | Style class of the overlay panel element. |
884
- | inputId | InputSignal<string> | ... | Identifier of the focus input to match a label defined for the component. |
885
- | readonly | InputSignalWithTransform<boolean, unknown> | ... | When present, it specifies that the component cannot be edited. |
886
- | group | InputSignalWithTransform<boolean, unknown> | ... | Whether to display options as grouped when nested options are provided. |
887
- | filter | InputSignalWithTransform<boolean, unknown> | ... | When specified, displays an input field to filter the items on keyup. |
888
- | filterPlaceholder | InputSignal<string> | ... | Defines placeholder of the filter input. |
889
- | filterLocale | InputSignal<string> | ... | Locale to use in filtering. The default locale is the host environment's current locale. |
890
- | overlayVisible | InputSignalWithTransform<boolean, unknown> | ... | Specifies the visibility of the options panel. |
891
- | tabindex | InputSignalWithTransform<number, unknown> | ... | Index of the element in tabbing order. |
892
- | dataKey | InputSignal<string> | ... | A property to uniquely identify a value in options. |
893
- | ariaLabelledBy | InputSignal<string> | ... | Establishes relationships between the component and label(s) where its value should be one or more element IDs. |
894
- | displaySelectedLabel | InputSignal<boolean> | true | Whether to show labels of selected item labels or use default label. |
895
- | maxSelectedLabels | InputSignal<number> | 3 | Decides how many selected item labels to show at most. |
896
- | selectionLimit | InputSignalWithTransform<number, unknown> | ... | Maximum number of selectable items. |
897
- | selectedItemsLabel | InputSignal<string> | ... | Label to display after exceeding max selected labels e.g. ({0} items selected), defaults "ellipsis" keyword to indicate a text-overflow. |
898
- | showToggleAll | InputSignalWithTransform<boolean, unknown> | ... | Whether to show the checkbox at header to toggle all items at once. |
899
- | emptyFilterMessage | InputSignal<string> | ... | Text to display when filtering does not return any results. |
900
- | emptyMessage | InputSignal<string> | ... | Text to display when there is no data. Defaults to global value in i18n translation configuration. |
901
- | resetFilterOnHide | InputSignalWithTransform<boolean, unknown> | ... | Clears the filter value when hiding the dropdown. |
902
- | dropdownIcon | InputSignal<string> | ... | Icon class of the dropdown icon. |
903
- | chipIcon | InputSignal<string> | ... | Icon class of the chip icon. |
904
- | optionLabel | InputSignal<string> | ... | Name of the label field of an option. |
905
- | optionValue | InputSignal<string> | ... | Name of the value field of an option. |
906
- | optionDisabled | InputSignal<string> | ... | Name of the disabled field of an option. |
907
- | optionGroupLabel | InputSignal<string> | ... | Name of the label field of an option group. |
908
- | optionGroupChildren | InputSignal<string> | ... | Name of the options field of an option group. |
909
- | showHeader | InputSignalWithTransform<boolean, unknown> | ... | Whether to show the header. |
910
- | filterBy | InputSignal<string> | ... | When filtering is enabled, filterBy decides which field or fields (comma separated) to search against. |
911
- | scrollHeight | InputSignal<string> | ... | Height of the viewport in pixels, a scrollbar is defined if height of list exceeds this value. |
912
- | lazy | InputSignalWithTransform<boolean, unknown> | ... | Defines if data is loaded and interacted with in lazy manner. |
913
- | virtualScroll | InputSignalWithTransform<boolean, unknown> | ... | Whether the data should be loaded on demand during scroll. |
914
- | loading | InputSignalWithTransform<boolean, unknown> | ... | Whether the multiselect is in loading state. |
915
- | virtualScrollItemSize | InputSignalWithTransform<number, unknown> | ... | Height of an item in the list for VirtualScrolling. |
916
- | loadingIcon | InputSignal<string> | ... | Icon to display in loading state. |
917
- | virtualScrollOptions | InputSignal<ScrollerOptions> | ... | Whether to use the scroller feature. The properties of scroller component can be used like an object in it. |
918
- | overlayOptions | InputSignal<OverlayOptions> | ... | Whether to use overlay API feature. The properties of overlay API can be used like an object in it. |
919
- | ariaFilterLabel | InputSignal<string> | ... | Defines a string that labels the filter input. |
920
- | filterMatchMode | InputSignal<"gt" \| "lt" \| "in" \| "startsWith" \| "contains" \| "endsWith" \| "equals" \| "notEquals" \| "lte" \| "gte"> | ... | Defines how the items are filtered. |
921
- | tooltip | InputSignal<string> | ... | Advisory information to display in a tooltip on hover. |
922
- | tooltipPosition | InputSignal<"top" \| "bottom" \| "left" \| "right"> | ... | Position of the tooltip. |
923
- | tooltipPositionStyle | InputSignal<string> | ... | Type of CSS position. |
924
- | tooltipStyleClass | InputSignal<string> | ... | Style class of the tooltip. |
925
- | autofocusFilter | InputSignalWithTransform<boolean, unknown> | ... | Applies focus to the filter element when the overlay is shown. |
926
- | display | InputSignal<string> | ... | Defines how the selected items are displayed. |
927
- | autocomplete | InputSignal<string> | ... | Defines the autocomplete is active. |
928
- | showClear | InputSignalWithTransform<boolean, unknown> | ... | When enabled, a clear icon is displayed to clear the value. |
929
- | autofocus | InputSignalWithTransform<boolean, unknown> | ... | When present, it specifies that the component should automatically get focus on load. |
930
- | placeholder | InputSignal<string> | ... | Label to display when there are no selections. |
931
- | options | InputSignal<any[]> | ... | An array of objects to display as the available options. |
932
- | filterValue | InputSignal<string> | ... | When specified, filter displays with this value. |
933
- | selectAll | InputSignal<boolean> | ... | Whether all data is selected. |
934
- | focusOnHover | InputSignalWithTransform<boolean, unknown> | ... | Indicates whether to focus on options when hovering over them, defaults to optionLabel. |
935
- | selectOnFocus | InputSignalWithTransform<boolean, unknown> | ... | Determines if the option will be selected on focus. |
936
- | autoOptionFocus | InputSignalWithTransform<boolean, unknown> | ... | Whether to focus on the first visible or selected element when the overlay panel is shown. |
937
- | highlightOnSelect | InputSignalWithTransform<boolean, unknown> | ... | Whether the selected option will be add highlight class. |
938
- | size | InputSignal<"small" \| "large"> | undefined | Specifies the size of the component. |
939
- | variant | InputSignal<"outlined" \| "filled"> | undefined | Specifies the input variant of the component. |
940
- | fluid | InputSignalWithTransform<boolean, unknown> | undefined | Spans 100% width of the container when enabled. |
941
- | appendTo | InputSignal<any> | 'self' | Target element to attach the overlay, valid values are "body" or a local ng-template variable of another element (note: use binding with brackets for template variables, e.g. [appendTo]="mydiv" for a div element having #mydiv as variable name). |
942
- | motionOptions | InputSignal<MotionOptions> | ... | The motion options. |
936
+ | dt | Object | undefined | Defines scoped design tokens of the component. |
937
+ | unstyled | boolean | undefined | Indicates whether the component should be rendered without styles. |
938
+ | pt | MultiSelectPassThrough | undefined | Used to pass attributes to DOM elements inside the component. |
939
+ | ptOptions | PassThroughOptions | undefined | Used to configure passthrough(pt) options of the component. |
940
+ | required | boolean | false | There must be a value (if set). |
941
+ | invalid | boolean | false | When present, it specifies that the component should have invalid state style. |
942
+ | disabled | boolean | false | When present, it specifies that the component should have disabled state style. |
943
+ | name | string | undefined | When present, it specifies that the name of the input. |
944
+ | id | string | - | Unique identifier of the component |
945
+ | ariaLabel | string | - | Defines a string that labels the input for accessibility. |
946
+ | panelStyle | any | - | Inline style of the overlay panel. |
947
+ | panelStyleClass | string | - | Style class of the overlay panel element. |
948
+ | inputId | string | - | Identifier of the focus input to match a label defined for the component. |
949
+ | readonly | boolean | - | When present, it specifies that the component cannot be edited. |
950
+ | group | boolean | - | Whether to display options as grouped when nested options are provided. |
951
+ | filter | boolean | true | When specified, displays an input field to filter the items on keyup. |
952
+ | filterPlaceholder | string | - | Defines placeholder of the filter input. |
953
+ | filterLocale | string | - | Locale to use in filtering. The default locale is the host environment's current locale. |
954
+ | overlayVisible | boolean | false | Specifies the visibility of the options panel. |
955
+ | tabindex | number | 0 | Index of the element in tabbing order. |
956
+ | dataKey | string | - | A property to uniquely identify a value in options. |
957
+ | ariaLabelledBy | string | - | Establishes relationships between the component and label(s) where its value should be one or more element IDs. |
958
+ | displaySelectedLabel | boolean | true | Whether to show labels of selected item labels or use default label. |
959
+ | maxSelectedLabels | number | 3 | Decides how many selected item labels to show at most. |
960
+ | selectionLimit | number | - | Maximum number of selectable items. |
961
+ | selectedItemsLabel | string | - | Label to display after exceeding max selected labels e.g. ({0} items selected), defaults "ellipsis" keyword to indicate a text-overflow. |
962
+ | showToggleAll | boolean | true | Whether to show the checkbox at header to toggle all items at once. |
963
+ | emptyFilterMessage | string | '' | Text to display when filtering does not return any results. |
964
+ | emptyMessage | string | '' | Text to display when there is no data. Defaults to global value in i18n translation configuration. |
965
+ | resetFilterOnHide | boolean | false | Clears the filter value when hiding the dropdown. |
966
+ | dropdownIcon | string | - | Icon class of the dropdown icon. |
967
+ | chipIcon | string | - | Icon class of the chip icon. |
968
+ | optionLabel | string | - | Name of the label field of an option. |
969
+ | optionValue | string | - | Name of the value field of an option. |
970
+ | optionDisabled | string | - | Name of the disabled field of an option. |
971
+ | optionGroupLabel | string | 'label' | Name of the label field of an option group. |
972
+ | optionGroupChildren | string | 'items' | Name of the options field of an option group. |
973
+ | showHeader | boolean | true | Whether to show the header. |
974
+ | filterBy | string | - | When filtering is enabled, filterBy decides which field or fields (comma separated) to search against. |
975
+ | scrollHeight | string | '200px' | Height of the viewport in pixels, a scrollbar is defined if height of list exceeds this value. |
976
+ | lazy | boolean | false | Defines if data is loaded and interacted with in lazy manner. |
977
+ | virtualScroll | boolean | - | Whether the data should be loaded on demand during scroll. |
978
+ | loading | boolean | false | Whether the multiselect is in loading state. |
979
+ | virtualScrollItemSize | number | - | Height of an item in the list for VirtualScrolling. |
980
+ | loadingIcon | string | - | Icon to display in loading state. |
981
+ | virtualScrollOptions | ScrollerOptions | - | Whether to use the scroller feature. The properties of scroller component can be used like an object in it. |
982
+ | overlayOptions | OverlayOptions | - | Whether to use overlay API feature. The properties of overlay API can be used like an object in it. |
983
+ | ariaFilterLabel | string | - | Defines a string that labels the filter input. |
984
+ | filterMatchMode | "gt" \| "lt" \| "in" \| "startsWith" \| "contains" \| "endsWith" \| "equals" \| "notEquals" \| "lte" \| "gte" | 'contains' | Defines how the items are filtered. |
985
+ | tooltip | string | '' | Advisory information to display in a tooltip on hover. |
986
+ | tooltipPosition | "top" \| "bottom" \| "left" \| "right" | 'right' | Position of the tooltip. |
987
+ | tooltipPositionStyle | string | 'absolute' | Type of CSS position. |
988
+ | tooltipStyleClass | string | - | Style class of the tooltip. |
989
+ | autofocusFilter | boolean | false | Applies focus to the filter element when the overlay is shown. |
990
+ | display | string | 'comma' | Defines how the selected items are displayed. |
991
+ | autocomplete | string | 'off' | Defines the autocomplete is active. |
992
+ | showClear | boolean | false | When enabled, a clear icon is displayed to clear the value. |
993
+ | autofocus | boolean | - | When present, it specifies that the component should automatically get focus on load. |
994
+ | placeholder | string | - | Label to display when there are no selections. |
995
+ | options | any[] | - | An array of objects to display as the available options. |
996
+ | filterValue | string | - | When specified, filter displays with this value. |
997
+ | selectAll | boolean | - | Whether all data is selected. |
998
+ | focusOnHover | boolean | true | Indicates whether to focus on options when hovering over them, defaults to optionLabel. |
999
+ | selectOnFocus | boolean | false | Determines if the option will be selected on focus. |
1000
+ | autoOptionFocus | boolean | false | Whether to focus on the first visible or selected element when the overlay panel is shown. |
1001
+ | highlightOnSelect | boolean | true | Whether the selected option will be add highlight class. |
1002
+ | size | "small" \| "large" | undefined | Specifies the size of the component. |
1003
+ | variant | "outlined" \| "filled" | undefined | Specifies the input variant of the component. |
1004
+ | fluid | boolean | undefined | Spans 100% width of the container when enabled. |
1005
+ | appendTo | any | 'self' | Target element to attach the overlay, valid values are "body" or a local ng-template variable of another element (note: use binding with brackets for template variables, e.g. [appendTo]="mydiv" for a div element having #mydiv as variable name). |
1006
+ | motionOptions | MotionOptions | - | The motion options. |
943
1007
 
944
1008
  ### Emits
945
1009