@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,22 +4,22 @@ PickList is used to reorder items between different lists.
4
4
 
5
5
  ## Accessibility
6
6
 
7
- Screen Reader Value to describe the source listbox and target listbox can be provided with ariaLabelledBy or ariaLabel props. The list elements has a listbox role with the aria-multiselectable attribute. Each list item has an option role with aria-selected and aria-disabled as their attributes. Controls buttons are button elements with an aria-label that refers to the aria.moveTop , aria.moveUp , aria.moveDown , aria.moveBottom , aria.moveTo , aria.moveAllTo , aria.moveFrom and aria.moveAllFrom properties of the locale API by default, alternatively you may use moveTopButtonProps , moveUpButtonProps , moveDownButtonProps , moveToButtonProps , moveAllToButtonProps , moveFromButtonProps , moveFromButtonProps and moveAllFromButtonProps to customize the buttons like overriding the default aria-label attributes. PickList Keyboard Support Key Function tab Moves focus to the first selected option, if there is none then first option receives the focus. up arrow Moves focus to the previous option. down arrow Moves focus to the next option. enter Toggles the selected state of the focused option. space Toggles the selected state of the focused option. home Moves focus to the first option. end Moves focus to the last option. shift + down arrow Moves focus to the next option and toggles the selection state. shift + up arrow Moves focus to the previous option and toggles the selection state. shift + space Selects the items between the most recently selected option and the focused option. control + shift + home Selects the focused options and all the options up to the first one. control + shift + end Selects the focused options and all the options down to the first one. control + a Selects all options. Buttons Keyboard Support Key Function enter Executes button action. space Executes button action.
7
+ Screen Reader Value to describe the source listbox and target listbox can be provided with sourceAriaLabel and targetAriaLabel props, which default to sourceHeader and targetHeader . The list elements has a listbox role with the aria-multiselectable attribute. Each list item has an option role with aria-selected and aria-disabled as their attributes. Controls buttons are button elements with an aria-label that refers to the aria.moveTop , aria.moveUp , aria.moveDown , aria.moveBottom , aria.moveToTarget , aria.moveAllToTarget , aria.moveToSource and aria.moveAllToSource properties of the locale API by default. They can be overridden with topButtonAriaLabel , upButtonAriaLabel , downButtonAriaLabel , bottomButtonAriaLabel , rightButtonAriaLabel , allRightButtonAriaLabel , leftButtonAriaLabel and allLeftButtonAriaLabel . The buttons can be customized with buttonProps , moveTopButtonProps , moveUpButtonProps , moveDownButtonProps , moveBottomButtonProps , moveToTargetProps , moveAllToTargetProps , moveToSourceProps and moveAllToSourceProps . PickList Keyboard Support Key Function tab Moves focus to the first selected option, if there is none then first option receives the focus. up arrow Moves focus to the previous option. down arrow Moves focus to the next option. enter Toggles the selected state of the focused option. space Toggles the selected state of the focused option. home Moves focus to the first option. end Moves focus to the last option. shift + down arrow Moves focus to the next option and toggles the selection state. shift + up arrow Moves focus to the previous option and toggles the selection state. shift + space Selects the items between the most recently selected option and the focused option. control + shift + home Selects the focused options and all the options up to the first one. control + shift + end Selects the focused options and all the options down to the first one. control + a Selects all options. Buttons Keyboard Support Key Function enter Executes button action. space Executes button action.
8
8
 
9
9
  ## Basic
10
10
 
11
11
  PickList is used as a controlled input with source and target properties. Content of a list item needs to be defined with the item template that receives an object in the list as parameter. Drag & drop functionality depends on @angular/cdk package.
12
12
 
13
13
  ```typescript
14
- import { Component, OnInit, inject, signal } from '@angular/core';
14
+ import { Component, inject, OnInit, signal } from '@angular/core';
15
15
  import { PickListModule } from '@exhaustive-ui/core/picklist';
16
- import { ProductService } from '@/service/productservice';
17
16
  import { Product } from '@/domain/product';
17
+ import { ProductService } from '@/service/productservice';
18
18
 
19
19
  @Component({
20
20
  template: `
21
21
  <div class="card">
22
- <p-pick-list [source]="sourceProducts()" [target]="targetProducts()" [dragdrop]="true" [responsive]="true" breakpoint="1400px">
22
+ <p-pick-list [source]="sourceProducts()" [target]="targetProducts()" [dragdrop]="true" [responsive]="true" breakpoint="1400px" sourceAriaLabel="Available products" targetAriaLabel="Selected products">
23
23
  <ng-template let-item #item>
24
24
  {{ item.name }}
25
25
  </ng-template>
@@ -31,8 +31,10 @@ import { Product } from '@/domain/product';
31
31
  providers: [ProductService]
32
32
  })
33
33
  export class PicklistBasicDemo implements OnInit {
34
- private productService = inject(ProductService);
34
+ private carService = inject(ProductService);
35
+
35
36
  sourceProducts = signal<Product[]>([]);
37
+
36
38
  targetProducts = signal<Product[]>([]);
37
39
 
38
40
  ngOnInit() {
@@ -48,10 +50,11 @@ export class PicklistBasicDemo implements OnInit {
48
50
  Filter value is checked against the property of an object configured with the filterBy property.
49
51
 
50
52
  ```typescript
51
- import { Component, OnInit, inject, signal } from '@angular/core';
53
+ import { CommonModule } from '@angular/common';
54
+ import { Component, inject, OnInit, signal } from '@angular/core';
52
55
  import { PickListModule } from '@exhaustive-ui/core/picklist';
53
- import { ProductService } from '@/service/productservice';
54
56
  import { Product } from '@/domain/product';
57
+ import { ProductService } from '@/service/productservice';
55
58
 
56
59
  @Component({
57
60
  template: `
@@ -66,6 +69,8 @@ import { Product } from '@/domain/product';
66
69
  targetFilterPlaceholder="Search by name"
67
70
  breakpoint="1400px"
68
71
  scrollHeight="20rem"
72
+ sourceAriaLabel="Available products"
73
+ targetAriaLabel="Selected products"
69
74
  >
70
75
  <ng-template let-option let-selected="selected" #item>
71
76
  <div class="flex flex-wrap p-1 items-center gap-4 w-full">
@@ -88,12 +93,14 @@ import { Product } from '@/domain/product';
88
93
  </div>
89
94
  `,
90
95
  standalone: true,
91
- imports: [PickListModule],
96
+ imports: [CommonModule, PickListModule],
92
97
  providers: [ProductService]
93
98
  })
94
99
  export class PicklistFilterDemo implements OnInit {
95
- private productService = inject(ProductService);
100
+ private carService = inject(ProductService);
101
+
96
102
  sourceProducts = signal<Product[]>([]);
103
+
97
104
  targetProducts = signal<Product[]>([]);
98
105
 
99
106
  ngOnInit() {
@@ -109,15 +116,27 @@ export class PicklistFilterDemo implements OnInit {
109
116
  For custom content support define an item template that gets the item instance as a parameter. In addition sourceheader and targetheader templates are provided for further customization.
110
117
 
111
118
  ```typescript
112
- import { Component, OnInit, inject, signal } from '@angular/core';
119
+ import { CommonModule } from '@angular/common';
120
+ import { Component, inject, OnInit, signal } from '@angular/core';
113
121
  import { PickListModule } from '@exhaustive-ui/core/picklist';
114
- import { ProductService } from '@/service/productservice';
115
122
  import { Product } from '@/domain/product';
123
+ import { ProductService } from '@/service/productservice';
116
124
 
117
125
  @Component({
118
126
  template: `
119
127
  <div class="card">
120
- <p-pick-list [source]="sourceProducts()" [target]="targetProducts()" [dragdrop]="true" [responsive]="true" sourceFilterPlaceholder="Search by name" targetFilterPlaceholder="Search by name" breakpoint="1400px" scrollHeight="20rem">
128
+ <p-pick-list
129
+ [source]="sourceProducts()"
130
+ [target]="targetProducts()"
131
+ [dragdrop]="true"
132
+ [responsive]="true"
133
+ sourceFilterPlaceholder="Search by name"
134
+ targetFilterPlaceholder="Search by name"
135
+ breakpoint="1400px"
136
+ scrollHeight="20rem"
137
+ sourceAriaLabel="Available products"
138
+ targetAriaLabel="Selected products"
139
+ >
121
140
  <ng-template let-option let-selected="selected" #item>
122
141
  <div class="flex flex-wrap p-1 items-center gap-4 w-full">
123
142
  <img class="w-12 shrink-0 rounded-sm" src="https://exhaustive-ui.com/demo/product/{{ option.image }}" [alt]="option.name" />
@@ -139,12 +158,14 @@ import { Product } from '@/domain/product';
139
158
  </div>
140
159
  `,
141
160
  standalone: true,
142
- imports: [PickListModule],
161
+ imports: [CommonModule, PickListModule],
143
162
  providers: [ProductService]
144
163
  })
145
164
  export class PicklistTemplateDemo implements OnInit {
146
- private productService = inject(ProductService);
165
+ private carService = inject(ProductService);
166
+
147
167
  sourceProducts = signal<Product[]>([]);
168
+
148
169
  targetProducts = signal<Product[]>([]);
149
170
 
150
171
  ngOnInit() {
@@ -263,7 +284,8 @@ import { Component } from '@angular/core';
263
284
  standalone: true,
264
285
  imports: []
265
286
  })
266
- export class PicklistTemplatesDemo {}
287
+ export class PicklistTemplatesDemo {
288
+ }
267
289
  ```
268
290
 
269
291
  ## Pick List
@@ -274,61 +296,61 @@ PickList is used to reorder items between different lists.
274
296
 
275
297
  | Name | Type | Default | Description |
276
298
  |------|------|---------|-------------|
277
- | dt | InputSignal<Object> | undefined | Defines scoped design tokens of the component. |
278
- | unstyled | InputSignal<boolean> | undefined | Indicates whether the component should be rendered without styles. |
279
- | pt | InputSignal<any> | undefined | Used to pass attributes to DOM elements inside the component. |
280
- | ptOptions | InputSignal<PassThroughOptions> | undefined | Used to configure passthrough(pt) options of the component. |
281
- | source | ModelSignal<any[]> | ... | An array of objects for the source list. |
282
- | target | ModelSignal<any[]> | ... | An array of objects for the target list. |
283
- | dataKey | InputSignal<string> | ... | Name of the field that uniquely identifies the options. |
284
- | sourceHeader | InputSignal<string> | ... | Text for the source list caption |
285
- | tabindex | InputSignalWithTransform<number, unknown> | ... | Index of the element in tabbing order. |
286
- | rightButtonAriaLabel | InputSignal<string> | ... | Defines a string that labels the move to right button for accessibility. |
287
- | leftButtonAriaLabel | InputSignal<string> | ... | Defines a string that labels the move to left button for accessibility. |
288
- | allRightButtonAriaLabel | InputSignal<string> | ... | Defines a string that labels the move to all right button for accessibility. |
289
- | allLeftButtonAriaLabel | InputSignal<string> | ... | Defines a string that labels the move to all left button for accessibility. |
290
- | upButtonAriaLabel | InputSignal<string> | ... | Defines a string that labels the move to up button for accessibility. |
291
- | downButtonAriaLabel | InputSignal<string> | ... | Defines a string that labels the move to down button for accessibility. |
292
- | topButtonAriaLabel | InputSignal<string> | ... | Defines a string that labels the move to top button for accessibility. |
293
- | bottomButtonAriaLabel | InputSignal<string> | ... | Defines a string that labels the move to bottom button for accessibility. |
294
- | sourceAriaLabel | InputSignal<string> | ... | Defines a string that labels the source list. |
295
- | targetAriaLabel | InputSignal<string> | ... | Defines a string that labels the target list. |
296
- | targetHeader | InputSignal<string> | ... | Text for the target list caption |
297
- | responsive | InputSignalWithTransform<boolean, unknown> | ... | When enabled orderlist adjusts its controls based on screen size. |
298
- | filterBy | InputSignal<string> | ... | When specified displays an input field to filter the items on keyup and decides which field to search (Accepts multiple fields with a comma). |
299
- | filterLocale | InputSignal<string> | ... | Locale to use in filtering. The default locale is the host environment's current locale. |
300
- | showSourceFilter | InputSignalWithTransform<boolean, unknown> | ... | Whether to show filter input for source list when filterBy is enabled. |
301
- | showTargetFilter | InputSignalWithTransform<boolean, unknown> | ... | Whether to show filter input for target list when filterBy is enabled. |
302
- | metaKeySelection | InputSignalWithTransform<boolean, unknown> | ... | Defines how multiple items can be selected, when true metaKey needs to be pressed to select or unselect an item and when set to false selection of each item can be toggled individually. On touch enabled devices, metaKeySelection is turned off automatically. |
303
- | dragdrop | InputSignalWithTransform<boolean, unknown> | ... | Whether to enable dragdrop based reordering. |
304
- | style | InputSignal<{ [klass: string]: any }> | ... | Inline style of the component. |
305
- | styleClass | InputSignal<string> | ... | Style class of the component. |
306
- | sourceStyle | InputSignal<any> | ... | Inline style of the source list element. |
307
- | targetStyle | InputSignal<any> | ... | Inline style of the target list element. |
308
- | showSourceControls | InputSignalWithTransform<boolean, unknown> | ... | Whether to show buttons of source list. |
309
- | showTargetControls | InputSignalWithTransform<boolean, unknown> | ... | Whether to show buttons of target list. |
310
- | sourceFilterPlaceholder | InputSignal<string> | ... | Placeholder text on source filter input. |
311
- | targetFilterPlaceholder | InputSignal<string> | ... | Placeholder text on target filter input. |
312
- | disabled | InputSignalWithTransform<boolean, unknown> | ... | When present, it specifies that the component should be disabled. |
313
- | sourceOptionDisabled | InputSignal<string \| ((item: any) => boolean)> | ... | Name of the disabled field of a target option or function to determine disabled state. |
314
- | targetOptionDisabled | InputSignal<string \| ((item: any) => boolean)> | ... | Name of the disabled field of a target option or function to determine disabled state. |
315
- | ariaSourceFilterLabel | InputSignal<string> | ... | Defines a string that labels the filter input of source list. |
316
- | ariaTargetFilterLabel | InputSignal<string> | ... | Defines a string that labels the filter input of target list. |
317
- | filterMatchMode | InputSignal<string> | ... | Defines how the items are filtered. |
318
- | stripedRows | InputSignalWithTransform<boolean, unknown> | ... | Whether to displays rows with alternating colors. |
319
- | keepSelection | InputSignalWithTransform<boolean, unknown> | ... | Keeps selection on the transfer list. |
320
- | scrollHeight | InputSignal<string> | ... | Height of the viewport, a scrollbar is defined if height of list exceeds this value. |
321
- | autoOptionFocus | InputSignalWithTransform<boolean, unknown> | ... | Whether to focus on the first visible or selected element. |
322
- | buttonProps | InputSignal<ButtonProps> | ... | Used to pass all properties of the ButtonProps to the Button component. |
323
- | moveUpButtonProps | InputSignal<ButtonProps> | ... | Used to pass all properties of the ButtonProps to the move up button inside the component. |
324
- | moveTopButtonProps | InputSignal<ButtonProps> | ... | Used to pass all properties of the ButtonProps to the move top button inside the component. |
325
- | moveDownButtonProps | InputSignal<ButtonProps> | ... | Used to pass all properties of the ButtonProps to the move down button inside the component. |
326
- | moveBottomButtonProps | InputSignal<ButtonProps> | ... | Used to pass all properties of the ButtonProps to the move bottom button inside the component. |
327
- | moveToTargetProps | InputSignal<ButtonProps> | ... | Used to pass all properties of the ButtonProps to the move to target button inside the component. |
328
- | moveAllToTargetProps | InputSignal<ButtonProps> | ... | Used to pass all properties of the ButtonProps to the move all to target button inside the component. |
329
- | moveToSourceProps | InputSignal<ButtonProps> | ... | Used to pass all properties of the ButtonProps to the move to source button inside the component. |
330
- | moveAllToSourceProps | InputSignal<ButtonProps> | ... | Used to pass all properties of the ButtonProps to the move all to source button inside the component. |
331
- | breakpoint | InputSignal<string> | ... | Indicates the width of the screen at which the component should change its behavior. |
299
+ | dt | Object | undefined | Defines scoped design tokens of the component. |
300
+ | unstyled | boolean | undefined | Indicates whether the component should be rendered without styles. |
301
+ | pt | any | undefined | Used to pass attributes to DOM elements inside the component. |
302
+ | ptOptions | PassThroughOptions | undefined | Used to configure passthrough(pt) options of the component. |
303
+ | source | any[] | [] | An array of objects for the source list. |
304
+ | target | any[] | [] | An array of objects for the target list. |
305
+ | dataKey | string | - | Name of the field that uniquely identifies the options. |
306
+ | sourceHeader | string | - | Text for the source list caption |
307
+ | tabindex | number | 0 | Index of the element in tabbing order. |
308
+ | rightButtonAriaLabel | string | - | Defines a string that labels the move to right button for accessibility. |
309
+ | leftButtonAriaLabel | string | - | Defines a string that labels the move to left button for accessibility. |
310
+ | allRightButtonAriaLabel | string | - | Defines a string that labels the move to all right button for accessibility. |
311
+ | allLeftButtonAriaLabel | string | - | Defines a string that labels the move to all left button for accessibility. |
312
+ | upButtonAriaLabel | string | - | Defines a string that labels the move to up button for accessibility. |
313
+ | downButtonAriaLabel | string | - | Defines a string that labels the move to down button for accessibility. |
314
+ | topButtonAriaLabel | string | - | Defines a string that labels the move to top button for accessibility. |
315
+ | bottomButtonAriaLabel | string | - | Defines a string that labels the move to bottom button for accessibility. |
316
+ | sourceAriaLabel | string | - | Defines a string that labels the source list. |
317
+ | targetAriaLabel | string | - | Defines a string that labels the target list. |
318
+ | targetHeader | string | - | Text for the target list caption |
319
+ | responsive | boolean | - | When enabled orderlist adjusts its controls based on screen size. |
320
+ | filterBy | string | - | When specified displays an input field to filter the items on keyup and decides which field to search (Accepts multiple fields with a comma). |
321
+ | filterLocale | string | - | Locale to use in filtering. The default locale is the host environment's current locale. |
322
+ | showSourceFilter | boolean | true | Whether to show filter input for source list when filterBy is enabled. |
323
+ | showTargetFilter | boolean | true | Whether to show filter input for target list when filterBy is enabled. |
324
+ | metaKeySelection | boolean | false | Defines how multiple items can be selected, when true metaKey needs to be pressed to select or unselect an item and when set to false selection of each item can be toggled individually. On touch enabled devices, metaKeySelection is turned off automatically. |
325
+ | dragdrop | boolean | false | Whether to enable dragdrop based reordering. |
326
+ | style | { [klass: string]: any } | - | Inline style of the component. |
327
+ | styleClass | string | - | Style class of the component. |
328
+ | sourceStyle | any | - | Inline style of the source list element. |
329
+ | targetStyle | any | - | Inline style of the target list element. |
330
+ | showSourceControls | boolean | true | Whether to show buttons of source list. |
331
+ | showTargetControls | boolean | true | Whether to show buttons of target list. |
332
+ | sourceFilterPlaceholder | string | - | Placeholder text on source filter input. |
333
+ | targetFilterPlaceholder | string | - | Placeholder text on target filter input. |
334
+ | disabled | boolean | - | When present, it specifies that the component should be disabled. |
335
+ | sourceOptionDisabled | string \| ((item: any) => boolean) | - | Name of the disabled field of a target option or function to determine disabled state. |
336
+ | targetOptionDisabled | string \| ((item: any) => boolean) | - | Name of the disabled field of a target option or function to determine disabled state. |
337
+ | ariaSourceFilterLabel | string | - | Defines a string that labels the filter input of source list. |
338
+ | ariaTargetFilterLabel | string | - | Defines a string that labels the filter input of target list. |
339
+ | filterMatchMode | string | 'contains' | Defines how the items are filtered. |
340
+ | stripedRows | boolean | - | Whether to displays rows with alternating colors. |
341
+ | keepSelection | boolean | false | Keeps selection on the transfer list. |
342
+ | scrollHeight | string | '14rem' | Height of the viewport, a scrollbar is defined if height of list exceeds this value. |
343
+ | autoOptionFocus | boolean | true | Whether to focus on the first visible or selected element. |
344
+ | buttonProps | ButtonProps | { severity: 'secondary' } | Used to pass all properties of the ButtonProps to the Button component. |
345
+ | moveUpButtonProps | ButtonProps | - | Used to pass all properties of the ButtonProps to the move up button inside the component. |
346
+ | moveTopButtonProps | ButtonProps | - | Used to pass all properties of the ButtonProps to the move top button inside the component. |
347
+ | moveDownButtonProps | ButtonProps | - | Used to pass all properties of the ButtonProps to the move down button inside the component. |
348
+ | moveBottomButtonProps | ButtonProps | - | Used to pass all properties of the ButtonProps to the move bottom button inside the component. |
349
+ | moveToTargetProps | ButtonProps | - | Used to pass all properties of the ButtonProps to the move to target button inside the component. |
350
+ | moveAllToTargetProps | ButtonProps | - | Used to pass all properties of the ButtonProps to the move all to target button inside the component. |
351
+ | moveToSourceProps | ButtonProps | - | Used to pass all properties of the ButtonProps to the move to source button inside the component. |
352
+ | moveAllToSourceProps | ButtonProps | - | Used to pass all properties of the ButtonProps to the move all to source button inside the component. |
353
+ | breakpoint | string | '960px' | Indicates the width of the screen at which the component should change its behavior. |
332
354
 
333
355
  ### Emits
334
356
 
@@ -12,9 +12,11 @@ Popover is accessed via its reference and visibility is controlled using toggle
12
12
 
13
13
  ```typescript
14
14
  import { Component } from '@angular/core';
15
+ import { CommonModule } from '@angular/common';
16
+ import { PopoverModule } from '@exhaustive-ui/core/popover';
15
17
  import { ButtonModule } from '@exhaustive-ui/core/button';
16
18
  import { InputGroupModule } from '@exhaustive-ui/core/inputgroup';
17
- import { PopoverModule } from '@exhaustive-ui/core/popover';
19
+ import { InputGroupAddonModule } from '@exhaustive-ui/core/inputgroupaddon';
18
20
  import { InputTextModule } from '@exhaustive-ui/core/inputtext';
19
21
 
20
22
  @Component({
@@ -26,7 +28,7 @@ import { InputTextModule } from '@exhaustive-ui/core/inputtext';
26
28
  <div>
27
29
  <span class="font-medium text-surface-900 dark:text-surface-0 block mb-2">Share this document</span>
28
30
  <p-input-group>
29
- <input pInputText value="https://exhaustive-ui.com/s/12323ff26t2g243g423g234gg52hy25XADXAG3" readonly class="w-100" />
31
+ <input pInputText aria-label="Share link" value="https://exhaustive-ui.com/s/12323ff26t2g243g423g234gg52hy25XADXAG3" readonly class="w-100" />
30
32
  <p-input-group-addon>
31
33
  <i class="pi pi-copy"></i>
32
34
  </p-input-group-addon>
@@ -36,8 +38,11 @@ import { InputTextModule } from '@exhaustive-ui/core/inputtext';
36
38
  <span class="font-medium text-surface-900 dark:text-surface-0 block mb-2">Invite Member</span>
37
39
  <div class="flex">
38
40
  <p-input-group>
39
- <input pInputText disabled />
40
- <button pButton label="Invite" icon="pi pi-users"></button>
41
+ <input pInputText aria-label="Member email" disabled />
42
+ <button pButton>
43
+ <i class="pi pi-users" pButtonIcon></i>
44
+ <span pButtonLabel>Invite</span>
45
+ </button>
41
46
  </p-input-group>
42
47
  </div>
43
48
  </div>
@@ -46,7 +51,7 @@ import { InputTextModule } from '@exhaustive-ui/core/inputtext';
46
51
  <ul class="list-none p-0 m-0 flex flex-col gap-4">
47
52
  @for (member of members; track member) {
48
53
  <li class="flex items-center gap-2">
49
- <img [src]="'https://exhaustive-ui.com/demo/avatar/' + member.image" style="width: 32px" />
54
+ <img [src]="'https://exhaustive-ui.com/demo/avatar/' + member.image" [alt]="member.name" style="width: 32px" />
50
55
  <div>
51
56
  <span class="font-medium">{{ member.name }}</span>
52
57
  <div class="text-sm text-muted-color">{{ member.email }}</div>
@@ -64,10 +69,14 @@ import { InputTextModule } from '@exhaustive-ui/core/inputtext';
64
69
  </div>
65
70
  `,
66
71
  standalone: true,
67
- imports: [ButtonModule, InputGroupModule, PopoverModule, InputTextModule]
72
+ imports: [CommonModule, PopoverModule, ButtonModule, InputGroupModule, InputGroupAddonModule, InputTextModule]
68
73
  })
69
74
  export class PopoverBasicDemo {
70
- members: any[];
75
+ members = [
76
+ { name: 'Amy Elsner', image: 'amyelsner.png', email: 'amy@email.com', role: 'Owner' },
77
+ { name: 'Bernardo Dominic', image: 'bernardodominic.png', email: 'bernardo@email.com', role: 'Editor' },
78
+ { name: 'Ioni Bowcher', image: 'ionibowcher.png', email: 'ioni@email.com', role: 'Viewer' }
79
+ ];
71
80
  }
72
81
  ```
73
82
 
@@ -76,14 +85,15 @@ export class PopoverBasicDemo {
76
85
  Place the Popover outside of the data iteration components to avoid rendering it multiple times.
77
86
 
78
87
  ```typescript
79
- import { Component, OnInit, inject, signal } from '@angular/core';
88
+ import { CommonModule } from '@angular/common';
89
+ import { Component, inject, OnInit, signal, ViewChild } from '@angular/core';
90
+ import { MessageService } from '@exhaustive-ui/core/api';
80
91
  import { ButtonModule } from '@exhaustive-ui/core/button';
81
92
  import { Popover, PopoverModule } from '@exhaustive-ui/core/popover';
82
93
  import { TableModule } from '@exhaustive-ui/core/table';
83
94
  import { TagModule } from '@exhaustive-ui/core/tag';
84
- import { ProductService } from '@/service/productservice';
85
- import { MessageService } from '@exhaustive-ui/core/api';
86
95
  import { Product } from '@/domain/product';
96
+ import { ProductService } from '@/service/productservice';
87
97
 
88
98
  @Component({
89
99
  template: `
@@ -109,7 +119,7 @@ import { Product } from '@/domain/product';
109
119
  <img [src]="'https://exhaustive-ui.com/demo/product/' + product.image" [alt]="product.image" class="w-16 shadow-xs" />
110
120
  </td>
111
121
  <td>
112
- <p-button (onClick)="displayProduct($event, product)" icon="pi pi-search" severity="secondary" rounded />
122
+ <p-button (onClick)="displayProduct($event, product)" icon="pi pi-search" [ariaLabel]="'View ' + product.name" severity="secondary" rounded />
113
123
  </td>
114
124
  </tr>
115
125
  </ng-template>
@@ -145,7 +155,7 @@ import { Product } from '@/domain/product';
145
155
  styleClass="w-full whitespace-nowrap"
146
156
  (onClick)="hidePopover()"
147
157
  />
148
- <p-button icon="pi pi-heart" outlined (onClick)="hidePopover()" />
158
+ <p-button icon="pi pi-heart" ariaLabel="Add to favorites" outlined (onClick)="hidePopover()" />
149
159
  </div>
150
160
  </div>
151
161
  </div>
@@ -154,13 +164,16 @@ import { Product } from '@/domain/product';
154
164
  </div>
155
165
  `,
156
166
  standalone: true,
157
- imports: [ButtonModule, PopoverModule, TableModule, TagModule],
158
- providers: [ProductService, MessageService]
167
+ imports: [CommonModule, PopoverModule, TableModule, ButtonModule, TagModule],
168
+ providers: [MessageService, ProductService]
159
169
  })
160
170
  export class PopoverDatatableDemo implements OnInit {
161
171
  private productService = inject(ProductService);
162
- private messageService = inject(MessageService);
172
+
173
+ @ViewChild('op') op!: Popover;
174
+
163
175
  products = signal<Product[]>([]);
176
+
164
177
  selectedProduct = signal<Product | null>(null);
165
178
 
166
179
  ngOnInit() {
@@ -176,7 +189,7 @@ export class PopoverDatatableDemo implements OnInit {
176
189
  } else {
177
190
  this.selectedProduct.set(product);
178
191
  this.op.show(event);
179
-
192
+
180
193
  if (this.op.container) {
181
194
  this.op.align();
182
195
  }
@@ -191,13 +204,13 @@ export class PopoverDatatableDemo implements OnInit {
191
204
  switch (product.inventoryStatus) {
192
205
  case 'INSTOCK':
193
206
  return 'success';
194
-
207
+
195
208
  case 'LOWSTOCK':
196
209
  return 'warn';
197
-
210
+
198
211
  case 'OUTOFSTOCK':
199
212
  return 'danger';
200
-
213
+
201
214
  default:
202
215
  return null;
203
216
  }
@@ -210,9 +223,10 @@ export class PopoverDatatableDemo implements OnInit {
210
223
  In this sample, data is retrieved from the content inside the popover.
211
224
 
212
225
  ```typescript
213
- import { Component } from '@angular/core';
214
- import { ButtonModule } from '@exhaustive-ui/core/button';
226
+ import { Component, ViewChild } from '@angular/core';
227
+ import { CommonModule } from '@angular/common';
215
228
  import { Popover, PopoverModule } from '@exhaustive-ui/core/popover';
229
+ import { ButtonModule } from '@exhaustive-ui/core/button';
216
230
 
217
231
  @Component({
218
232
  template: `
@@ -224,7 +238,7 @@ import { Popover, PopoverModule } from '@exhaustive-ui/core/popover';
224
238
  <span class="font-medium block mb-2">Team Members</span>
225
239
  <ul class="list-none p-0 m-0 flex flex-col">
226
240
  <li *ngFor="let member of members" class="flex items-center gap-2 px-2 py-3 hover:bg-emphasis cursor-pointer rounded-border" (click)="selectMember(member)">
227
- <img [src]="'https://exhaustive-ui.com/demo/avatar/' + member.image" style="width: 32px" />
241
+ <img [src]="'https://exhaustive-ui.com/demo/avatar/' + member.image" [alt]="member.name" style="width: 32px" />
228
242
  <div>
229
243
  <span class="font-medium">{{ member.name }}</span>
230
244
  <div class="text-sm text-surface-500 dark:text-surface-400">{{ member.email }}</div>
@@ -237,11 +251,18 @@ import { Popover, PopoverModule } from '@exhaustive-ui/core/popover';
237
251
  </div>
238
252
  `,
239
253
  standalone: true,
240
- imports: [ButtonModule, PopoverModule]
254
+ imports: [CommonModule, PopoverModule, ButtonModule]
241
255
  })
242
256
  export class PopoverSelectdataDemo {
243
- selectedMember: any = null;
244
- members: any[];
257
+ @ViewChild('op') op!: Popover;
258
+
259
+ selectedMember = null;
260
+
261
+ members = [
262
+ { name: 'Amy Elsner', image: 'amyelsner.png', email: 'amy@email.com', role: 'Owner' },
263
+ { name: 'Bernardo Dominic', image: 'bernardodominic.png', email: 'bernardo@email.com', role: 'Editor' },
264
+ { name: 'Ioni Bowcher', image: 'ionibowcher.png', email: 'ioni@email.com', role: 'Viewer' }
265
+ ];
245
266
 
246
267
  toggle(event) {
247
268
  this.op.toggle(event);
@@ -260,8 +281,8 @@ show method takes two parameters, first one is the event and it is mandatory. By
260
281
 
261
282
  ```typescript
262
283
  import { Component } from '@angular/core';
263
- import { ButtonModule } from '@exhaustive-ui/core/button';
264
284
  import { PopoverModule } from '@exhaustive-ui/core/popover';
285
+ import { ButtonModule } from '@exhaustive-ui/core/button';
265
286
 
266
287
  @Component({
267
288
  template: `
@@ -276,9 +297,10 @@ import { PopoverModule } from '@exhaustive-ui/core/popover';
276
297
  </div>
277
298
  `,
278
299
  standalone: true,
279
- imports: [ButtonModule, PopoverModule]
300
+ imports: [PopoverModule, ButtonModule]
280
301
  })
281
- export class PopoverTargetDemo {}
302
+ export class PopoverTargetDemo {
303
+ }
282
304
  ```
283
305
 
284
306
  ## Template
@@ -287,9 +309,8 @@ Content of the OverlayPanel is defined by content template.
287
309
 
288
310
  ```typescript
289
311
  import { Component } from '@angular/core';
290
- import { ButtonModule } from '@exhaustive-ui/core/button';
291
312
  import { PopoverModule } from '@exhaustive-ui/core/popover';
292
- import { OverlayPanel } from '@exhaustive-ui/core/overlaypanel';
313
+ import { ButtonModule } from '@exhaustive-ui/core/button';
293
314
 
294
315
  @Component({
295
316
  template: `
@@ -303,9 +324,10 @@ import { OverlayPanel } from '@exhaustive-ui/core/overlaypanel';
303
324
  </div>
304
325
  `,
305
326
  standalone: true,
306
- imports: [ButtonModule, PopoverModule]
327
+ imports: [PopoverModule, ButtonModule]
307
328
  })
308
- export class PopoverTemplateDemo {}
329
+ export class PopoverTemplateDemo {
330
+ }
309
331
  ```
310
332
 
311
333
  ## Popover
@@ -316,20 +338,20 @@ Popover is a container component that can overlay other components on page.
316
338
 
317
339
  | Name | Type | Default | Description |
318
340
  |------|------|---------|-------------|
319
- | dt | InputSignal<Object> | undefined | Defines scoped design tokens of the component. |
320
- | unstyled | InputSignal<boolean> | undefined | Indicates whether the component should be rendered without styles. |
321
- | pt | InputSignal<PopoverPassThrough> | undefined | Used to pass attributes to DOM elements inside the component. |
322
- | ptOptions | InputSignal<PassThroughOptions> | undefined | Used to configure passthrough(pt) options of the component. |
323
- | ariaLabel | InputSignal<string> | ... | Defines a string that labels the input for accessibility. |
324
- | ariaLabelledBy | InputSignal<string> | ... | Establishes relationships between the component and label(s) where its value should be one or more element IDs. |
325
- | dismissable | InputSignalWithTransform<boolean, unknown> | ... | Enables to hide the overlay when outside is clicked. |
326
- | style | InputSignal<{ [klass: string]: any }> | ... | Inline style of the component. |
327
- | styleClass | InputSignal<string> | ... | Style class of the component. |
328
- | 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). |
329
- | autoZIndex | InputSignalWithTransform<boolean, unknown> | ... | Whether to automatically manage layering. |
330
- | baseZIndex | InputSignalWithTransform<number, unknown> | ... | Base zIndex value to use in layering. |
331
- | focusOnShow | InputSignalWithTransform<boolean, unknown> | ... | When enabled, first button receives focus on show. |
332
- | motionOptions | InputSignal<MotionOptions> | ... | The motion options. |
341
+ | dt | Object | undefined | Defines scoped design tokens of the component. |
342
+ | unstyled | boolean | undefined | Indicates whether the component should be rendered without styles. |
343
+ | pt | PopoverPassThrough | undefined | Used to pass attributes to DOM elements inside the component. |
344
+ | ptOptions | PassThroughOptions | undefined | Used to configure passthrough(pt) options of the component. |
345
+ | ariaLabel | string | - | Defines a string that labels the input for accessibility. |
346
+ | ariaLabelledBy | string | - | Establishes relationships between the component and label(s) where its value should be one or more element IDs. |
347
+ | dismissable | boolean | true | Enables to hide the overlay when outside is clicked. |
348
+ | style | { [klass: string]: any } | - | Inline style of the component. |
349
+ | styleClass | string | - | Style class of the component. |
350
+ | appendTo | any | 'body' | 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). |
351
+ | autoZIndex | boolean | true | Whether to automatically manage layering. |
352
+ | baseZIndex | number | 0 | Base zIndex value to use in layering. |
353
+ | focusOnShow | boolean | true | When enabled, first button receives focus on show. |
354
+ | motionOptions | MotionOptions | - | The motion options. |
333
355
 
334
356
  ### Emits
335
357