@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
@@ -12,9 +12,8 @@ MegaMenu requires a collection of menuitems as its model .
12
12
 
13
13
  ```typescript
14
14
  import { Component, OnInit } from '@angular/core';
15
- import { MegaMenuModule } from '@exhaustive-ui/core/megamenu';
16
15
  import { MegaMenuItem } from '@exhaustive-ui/core/api';
17
- import { Table } from '@exhaustive-ui/core/table';
16
+ import { MegaMenuModule } from '@exhaustive-ui/core/megamenu';
18
17
 
19
18
  @Component({
20
19
  template: `
@@ -138,9 +137,10 @@ The command property of a menuitem defines the callback to run when an item is a
138
137
  Menu items support navigation via routerLink, programmatic routing using commands, or external URLs.
139
138
 
140
139
  ```typescript
141
- import { Component, OnInit } from '@angular/core';
142
- import { MegaMenuModule } from '@exhaustive-ui/core/megamenu';
140
+ import { Component, OnInit, inject } from '@angular/core';
141
+ import { Router } from '@angular/router';
143
142
  import { MegaMenuItem } from '@exhaustive-ui/core/api';
143
+ import { MegaMenuModule } from '@exhaustive-ui/core/megamenu';
144
144
 
145
145
  @Component({
146
146
  template: `
@@ -152,6 +152,8 @@ import { MegaMenuItem } from '@exhaustive-ui/core/api';
152
152
  imports: [MegaMenuModule]
153
153
  })
154
154
  export class MegamenuRouterDemo implements OnInit {
155
+ private router = inject(Router);
156
+
155
157
  items: MegaMenuItem[] | undefined;
156
158
 
157
159
  ngOnInit() {
@@ -203,12 +205,13 @@ export class MegamenuRouterDemo implements OnInit {
203
205
  Custom content can be placed between p-mega-menu tags. Megamenu should be horizontal for custom content.
204
206
 
205
207
  ```typescript
208
+ import { CommonModule } from '@angular/common';
206
209
  import { Component, OnInit } from '@angular/core';
210
+ import { MegaMenuItem } from '@exhaustive-ui/core/api';
207
211
  import { AvatarModule } from '@exhaustive-ui/core/avatar';
208
212
  import { ButtonModule } from '@exhaustive-ui/core/button';
209
213
  import { MegaMenuModule } from '@exhaustive-ui/core/megamenu';
210
214
  import { RippleModule } from '@exhaustive-ui/core/ripple';
211
- import { MegaMenuItem } from '@exhaustive-ui/core/api';
212
215
 
213
216
  @Component({
214
217
  template: `
@@ -266,13 +269,13 @@ import { MegaMenuItem } from '@exhaustive-ui/core/api';
266
269
  </div>
267
270
  </ng-template>
268
271
  <ng-template #end>
269
- <p-avatar image="https://exhaustive-ui.com/demo/avatar/amyelsner.png" shape="circle" />
272
+ <p-avatar image="https://exhaustive-ui.com/demo/avatar/amyelsner.png" ariaLabel="Amy Elsner" shape="circle" />
270
273
  </ng-template>
271
274
  </p-mega-menu>
272
275
  </div>
273
276
  `,
274
277
  standalone: true,
275
- imports: [AvatarModule, ButtonModule, MegaMenuModule, RippleModule]
278
+ imports: [CommonModule, MegaMenuModule, ButtonModule, AvatarModule, RippleModule]
276
279
  })
277
280
  export class MegamenuTemplateDemo implements OnInit {
278
281
  items: MegaMenuItem[] | undefined;
@@ -331,10 +334,8 @@ Layout of the MegaMenu is changed with the orientation property that accepts hor
331
334
 
332
335
  ```typescript
333
336
  import { Component, OnInit } from '@angular/core';
334
- import { MegaMenu, MegaMenuModule } from '@exhaustive-ui/core/megamenu';
335
337
  import { MegaMenuItem } from '@exhaustive-ui/core/api';
336
- import { Table } from '@exhaustive-ui/core/table';
337
- import { MegaMenu } from '@exhaustive-ui/core/megamenu';
338
+ import { MegaMenuModule } from '@exhaustive-ui/core/megamenu';
338
339
 
339
340
  @Component({
340
341
  template: `
@@ -457,19 +458,19 @@ MegaMenu is navigation component that displays submenus together.
457
458
 
458
459
  | Name | Type | Default | Description |
459
460
  |------|------|---------|-------------|
460
- | dt | InputSignal<Object> | undefined | Defines scoped design tokens of the component. |
461
- | unstyled | InputSignal<boolean> | undefined | Indicates whether the component should be rendered without styles. |
462
- | pt | InputSignal<MegaMenuPassThrough> | undefined | Used to pass attributes to DOM elements inside the component. |
463
- | ptOptions | InputSignal<PassThroughOptions> | undefined | Used to configure passthrough(pt) options of the component. |
464
- | model | InputSignal<MegaMenuItem[]> | ... | An array of menuitems. |
465
- | orientation | InputSignal<string> | ... | Defines the orientation. |
466
- | id | InputSignal<string> | ... | Current id state as a string. |
467
- | ariaLabel | InputSignal<string> | ... | Defines a string value that labels an interactive element. |
468
- | ariaLabelledBy | InputSignal<string> | ... | Identifier of the underlying input element. |
469
- | breakpoint | InputSignal<string> | ... | The breakpoint to define the maximum width boundary. |
470
- | scrollHeight | InputSignal<string> | ... | Height of the viewport, a scrollbar is defined if height of list exceeds this value. |
471
- | disabled | InputSignalWithTransform<boolean, unknown> | ... | When present, it specifies that the component should be disabled. |
472
- | tabindex | InputSignalWithTransform<number, unknown> | ... | Index of the element in tabbing order. |
461
+ | dt | Object | undefined | Defines scoped design tokens of the component. |
462
+ | unstyled | boolean | undefined | Indicates whether the component should be rendered without styles. |
463
+ | pt | MegaMenuPassThrough | undefined | Used to pass attributes to DOM elements inside the component. |
464
+ | ptOptions | PassThroughOptions | undefined | Used to configure passthrough(pt) options of the component. |
465
+ | model | MegaMenuItem[] | - | An array of menuitems. |
466
+ | orientation | string | 'horizontal' | Defines the orientation. |
467
+ | id | string | - | Current id state as a string. |
468
+ | ariaLabel | string | - | Defines a string value that labels an interactive element. |
469
+ | ariaLabelledBy | string | - | Identifier of the underlying input element. |
470
+ | breakpoint | string | '960px' | The breakpoint to define the maximum width boundary. |
471
+ | scrollHeight | string | '20rem' | Height of the viewport, a scrollbar is defined if height of list exceeds this value. |
472
+ | disabled | boolean | false | When present, it specifies that the component should be disabled. |
473
+ | tabindex | number | 0 | Index of the element in tabbing order. |
473
474
 
474
475
  ### Templates
475
476
 
@@ -12,8 +12,8 @@ Menu requires a collection of menuitems as its model .
12
12
 
13
13
  ```typescript
14
14
  import { Component, OnInit } from '@angular/core';
15
- import { MenuModule } from '@exhaustive-ui/core/menu';
16
15
  import { MenuItem } from '@exhaustive-ui/core/api';
16
+ import { MenuModule } from '@exhaustive-ui/core/menu';
17
17
 
18
18
  @Component({
19
19
  template: `
@@ -42,9 +42,9 @@ The function to invoke when an item is clicked is defined using the command prop
42
42
 
43
43
  ```typescript
44
44
  import { Component, OnInit, inject } from '@angular/core';
45
+ import { MenuItem, MessageService } from '@exhaustive-ui/core/api';
45
46
  import { MenuModule } from '@exhaustive-ui/core/menu';
46
47
  import { ToastModule } from '@exhaustive-ui/core/toast';
47
- import { MenuItem, MessageService } from '@exhaustive-ui/core/api';
48
48
 
49
49
  @Component({
50
50
  template: `
@@ -59,6 +59,7 @@ import { MenuItem, MessageService } from '@exhaustive-ui/core/api';
59
59
  })
60
60
  export class MenuCommandDemo implements OnInit {
61
61
  private messageService = inject(MessageService);
62
+
62
63
  items: MenuItem[] | undefined;
63
64
 
64
65
  ngOnInit() {
@@ -95,9 +96,9 @@ export class MenuCommandDemo implements OnInit {
95
96
  Menu supports one level of nesting by defining children with items property.
96
97
 
97
98
  ```typescript
98
- import { Component, OnInit, inject } from '@angular/core';
99
- import { MenuModule } from '@exhaustive-ui/core/menu';
99
+ import { Component, OnInit } from '@angular/core';
100
100
  import { MenuItem, MessageService } from '@exhaustive-ui/core/api';
101
+ import { MenuModule } from '@exhaustive-ui/core/menu';
101
102
 
102
103
  @Component({
103
104
  template: `
@@ -110,7 +111,6 @@ import { MenuItem, MessageService } from '@exhaustive-ui/core/api';
110
111
  providers: [MessageService]
111
112
  })
112
113
  export class MenuGroupDemo implements OnInit {
113
- private messageService = inject(MessageService);
114
114
  items: MenuItem[] | undefined;
115
115
 
116
116
  ngOnInit() {
@@ -151,24 +151,23 @@ export class MenuGroupDemo implements OnInit {
151
151
  Popup mode is enabled by setting popup property to true and calling toggle method with an event of the target.
152
152
 
153
153
  ```typescript
154
- import { Component, OnInit, inject } from '@angular/core';
155
- import { ButtonModule } from '@exhaustive-ui/core/button';
156
- import { MenuModule } from '@exhaustive-ui/core/menu';
154
+ import { Component, OnInit } from '@angular/core';
157
155
  import { MenuItem, MessageService } from '@exhaustive-ui/core/api';
156
+ import { MenuModule } from '@exhaustive-ui/core/menu';
157
+ import { ButtonModule } from '@exhaustive-ui/core/button';
158
158
 
159
159
  @Component({
160
160
  template: `
161
161
  <div class="card flex justify-center">
162
162
  <p-menu #menu [model]="items" [popup]="true" />
163
- <p-button (click)="menu.toggle($event)" icon="pi pi-ellipsis-v" />
163
+ <p-button (click)="menu.toggle($event)" icon="pi pi-ellipsis-v" ariaLabel="Show options" />
164
164
  </div>
165
165
  `,
166
166
  standalone: true,
167
- imports: [ButtonModule, MenuModule],
167
+ imports: [MenuModule, ButtonModule],
168
168
  providers: [MessageService]
169
169
  })
170
170
  export class MenuPopupDemo implements OnInit {
171
- private messageService = inject(MessageService);
172
171
  items: MenuItem[] | undefined;
173
172
 
174
173
  ngOnInit() {
@@ -196,9 +195,10 @@ export class MenuPopupDemo implements OnInit {
196
195
  Menu items support navigation via routerLink, programmatic routing using commands, or external URLs.
197
196
 
198
197
  ```typescript
199
- import { Component, OnInit } from '@angular/core';
200
- import { MenuModule } from '@exhaustive-ui/core/menu';
198
+ import { Component, OnInit, inject } from '@angular/core';
199
+ import { Router } from '@angular/router';
201
200
  import { MenuItem } from '@exhaustive-ui/core/api';
201
+ import { MenuModule } from '@exhaustive-ui/core/menu';
202
202
 
203
203
  @Component({
204
204
  template: `
@@ -210,6 +210,8 @@ import { MenuItem } from '@exhaustive-ui/core/api';
210
210
  imports: [MenuModule]
211
211
  })
212
212
  export class MenuRouterDemo implements OnInit {
213
+ private router = inject(Router);
214
+
213
215
  items: MenuItem[] | undefined;
214
216
 
215
217
  ngOnInit() {
@@ -246,12 +248,13 @@ export class MenuRouterDemo implements OnInit {
246
248
  Menu offers item customization with the item template that receives the menuitem instance from the model as a parameter. The submenu header has its own submenuheader template, additional slots named start and end are provided to embed content before or after the menu.
247
249
 
248
250
  ```typescript
251
+ import { CommonModule } from '@angular/common';
249
252
  import { Component, OnInit } from '@angular/core';
253
+ import { MenuItem } from '@exhaustive-ui/core/api';
250
254
  import { AvatarModule } from '@exhaustive-ui/core/avatar';
251
255
  import { BadgeModule } from '@exhaustive-ui/core/badge';
252
- import { Menu, MenuModule } from '@exhaustive-ui/core/menu';
253
- import { RippleModule } from '@exhaustive-ui/core/ripple';
254
- import { MenuItem } from '@exhaustive-ui/core/api';
256
+ import { MenuModule } from '@exhaustive-ui/core/menu';
257
+ import { Ripple } from '@exhaustive-ui/core/ripple';
255
258
 
256
259
  @Component({
257
260
  template: `
@@ -304,7 +307,7 @@ import { MenuItem } from '@exhaustive-ui/core/api';
304
307
  </ng-template>
305
308
  <ng-template #end>
306
309
  <button pRipple class="relative overflow-hidden w-full border-0 bg-transparent flex items-start p-2 pl-4 hover:bg-surface-100 dark:hover:bg-surface-800 rounded-none cursor-pointer transition-colors duration-200">
307
- <p-avatar image="https://exhaustive-ui.com/demo/avatar/amyelsner.png" class="mr-2" shape="circle" />
310
+ <p-avatar image="https://exhaustive-ui.com/demo/avatar/amyelsner.png" ariaLabel="Amy Elsner" class="mr-2" shape="circle" />
308
311
  <span class="inline-flex flex-col items-start">
309
312
  <span class="font-bold">Amy Elsner</span>
310
313
  <span class="text-sm">Admin</span>
@@ -315,7 +318,7 @@ import { MenuItem } from '@exhaustive-ui/core/api';
315
318
  </div>
316
319
  `,
317
320
  standalone: true,
318
- imports: [AvatarModule, BadgeModule, MenuModule, RippleModule]
321
+ imports: [CommonModule, MenuModule, BadgeModule, AvatarModule, Ripple]
319
322
  })
320
323
  export class MenuTemplateDemo implements OnInit {
321
324
  items: MenuItem[] | undefined;
@@ -377,22 +380,22 @@ Menu is a navigation / command component that supports dynamic and static positi
377
380
 
378
381
  | Name | Type | Default | Description |
379
382
  |------|------|---------|-------------|
380
- | dt | InputSignal<Object> | undefined | Defines scoped design tokens of the component. |
381
- | unstyled | InputSignal<boolean> | undefined | Indicates whether the component should be rendered without styles. |
382
- | pt | InputSignal<MenuPassThrough> | undefined | Used to pass attributes to DOM elements inside the component. |
383
- | ptOptions | InputSignal<PassThroughOptions> | undefined | Used to configure passthrough(pt) options of the component. |
384
- | model | InputSignal<MenuItem[]> | ... | An array of menuitems. |
385
- | popup | InputSignalWithTransform<boolean, unknown> | ... | Defines if menu would displayed as a popup. |
386
- | style | InputSignal<{ [klass: string]: any }> | ... | Inline style of the component. |
387
- | styleClass | InputSignal<string> | ... | Style class of the component. |
388
- | autoZIndex | InputSignalWithTransform<boolean, unknown> | ... | Whether to automatically manage layering. |
389
- | baseZIndex | InputSignalWithTransform<number, unknown> | ... | Base zIndex value to use in layering. |
390
- | ariaLabel | InputSignal<string> | ... | Defines a string value that labels an interactive element. |
391
- | ariaLabelledBy | InputSignal<string> | ... | Identifier of the underlying input element. |
392
- | id | InputSignal<string> | ... | Current id state as a string. |
393
- | tabindex | InputSignalWithTransform<number, unknown> | ... | Index of the element in tabbing order. |
394
- | 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). |
395
- | motionOptions | InputSignal<MotionOptions> | ... | The motion options. |
383
+ | dt | Object | undefined | Defines scoped design tokens of the component. |
384
+ | unstyled | boolean | undefined | Indicates whether the component should be rendered without styles. |
385
+ | pt | MenuPassThrough | undefined | Used to pass attributes to DOM elements inside the component. |
386
+ | ptOptions | PassThroughOptions | undefined | Used to configure passthrough(pt) options of the component. |
387
+ | model | MenuItem[] | - | An array of menuitems. |
388
+ | popup | boolean | - | Defines if menu would displayed as a popup. |
389
+ | style | { [klass: string]: any } | - | Inline style of the component. |
390
+ | styleClass | string | - | Style class of the component. |
391
+ | autoZIndex | boolean | true | Whether to automatically manage layering. |
392
+ | baseZIndex | number | 0 | Base zIndex value to use in layering. |
393
+ | ariaLabel | string | - | Defines a string value that labels an interactive element. |
394
+ | ariaLabelledBy | string | - | Identifier of the underlying input element. |
395
+ | id | string | - | Current id state as a string. |
396
+ | tabindex | number | 0 | Index of the element in tabbing order. |
397
+ | 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). |
398
+ | motionOptions | MotionOptions | - | The motion options. |
396
399
 
397
400
  ### Emits
398
401
 
@@ -4,7 +4,7 @@ Menubar is a horizontal menu component.
4
4
 
5
5
  ## Accessibility
6
6
 
7
- Screen Reader Menubar component uses the menubar role and the value to describe the menu can either be provided with aria-labelledby or aria-label props. Each list item has a presentation role whereas anchor elements have a menuitem role with aria-label referring to the label of the item and aria-disabled defined if the item is disabled. A submenu within a MenuBar uses the menu role with an aria-labelledby defined as the id of the submenu root menuitem label. In addition, menuitems that open a submenu have aria-haspopup , aria-expanded and aria-controls to define the relation between the item and the submenu. In mobile viewports, a menu icon appears with a button role along with aria-haspopup , aria-expanded and aria-controls to manage the relation between the overlay menubar and the button. The value to describe the button can be defined aria-label or aria-labelledby specified using buttonProps , by default navigation key of the aria property from the locale API as the aria-label . Keyboard Support Key Function tab Add focus to the first item if focus moves in to the menu. If the focus is already within the menu, focus moves to the next focusable item in the page tab sequence. shift + tab Add focus to the last item if focus moves in to the menu. If the focus is already within the menu, focus moves to the previous focusable item in the page tab sequence. enter If menuitem has a submenu, toggles the visibility of the submenu otherwise activates the menuitem and closes all open overlays. space If menuitem has a submenu, toggles the visibility of the submenu otherwise activates the menuitem and closes all open overlays. escape If focus is inside a popup submenu, closes the submenu and moves focus to the root item of the closed submenu. down arrow If focus is on a root element, open a submenu and moves focus to the first element in the submenu otherwise moves focus to the next menuitem within the submenu. up arrow If focus is on a root element, opens a submenu and moves focus to the last element in the submenu otherwise moves focus to the previous menuitem within the submenu. right arrow If focus is on a root element, moves focus to the next menuitem otherwise opens a submenu if there is one available and moves focus to the first item. left arrow If focus is on a root element, moves focus to the previous menuitem otherwise closes a submenu and moves focus to the root item of the closed submenu. home Moves focus to the first menuitem within the submenu. end Moves focus to the last menuitem within the submenu.
7
+ Screen Reader Menubar component uses the menubar role and the value to describe the menu can either be provided with aria-labelledby or aria-label props. Each list item has a presentation role whereas anchor elements have a menuitem role with aria-label referring to the label of the item and aria-disabled defined if the item is disabled. A submenu within a MenuBar uses the menu role with an aria-labelledby defined as the id of the submenu root menuitem label. In addition, menuitems that open a submenu have aria-haspopup , aria-expanded and aria-controls to define the relation between the item and the submenu. In mobile viewports, a menu icon appears with a button role along with aria-haspopup , aria-expanded and aria-controls to manage the relation between the overlay menubar and the button. The navigation key of the aria property from the locale API is used as the aria-label of the button. Keyboard Support Key Function tab Add focus to the first item if focus moves in to the menu. If the focus is already within the menu, focus moves to the next focusable item in the page tab sequence. shift + tab Add focus to the last item if focus moves in to the menu. If the focus is already within the menu, focus moves to the previous focusable item in the page tab sequence. enter If menuitem has a submenu, toggles the visibility of the submenu otherwise activates the menuitem and closes all open overlays. space If menuitem has a submenu, toggles the visibility of the submenu otherwise activates the menuitem and closes all open overlays. escape If focus is inside a popup submenu, closes the submenu and moves focus to the root item of the closed submenu. down arrow If focus is on a root element, open a submenu and moves focus to the first element in the submenu otherwise moves focus to the next menuitem within the submenu. up arrow If focus is on a root element, opens a submenu and moves focus to the last element in the submenu otherwise moves focus to the previous menuitem within the submenu. right arrow If focus is on a root element, moves focus to the next menuitem otherwise opens a submenu if there is one available and moves focus to the first item. left arrow If focus is on a root element, moves focus to the previous menuitem otherwise closes a submenu and moves focus to the root item of the closed submenu. home Moves focus to the first menuitem within the submenu. end Moves focus to the last menuitem within the submenu.
8
8
 
9
9
  ## Basic
10
10
 
@@ -12,8 +12,8 @@ Menubar requires nested menuitems as its model.
12
12
 
13
13
  ```typescript
14
14
  import { Component, OnInit } from '@angular/core';
15
- import { MenubarModule } from '@exhaustive-ui/core/menubar';
16
15
  import { MenuItem } from '@exhaustive-ui/core/api';
16
+ import { MenubarModule } from '@exhaustive-ui/core/menubar';
17
17
 
18
18
  @Component({
19
19
  template: `
@@ -84,9 +84,9 @@ The command property defines the callback to run when an item is activated by cl
84
84
 
85
85
  ```typescript
86
86
  import { Component, OnInit, inject } from '@angular/core';
87
+ import { MenuItem, MessageService } from '@exhaustive-ui/core/api';
87
88
  import { MenubarModule } from '@exhaustive-ui/core/menubar';
88
89
  import { ToastModule } from '@exhaustive-ui/core/toast';
89
- import { MenuItem, MessageService } from '@exhaustive-ui/core/api';
90
90
 
91
91
  @Component({
92
92
  template: `
@@ -101,6 +101,7 @@ import { MenuItem, MessageService } from '@exhaustive-ui/core/api';
101
101
  })
102
102
  export class MenubarCommandDemo implements OnInit {
103
103
  private messageService = inject(MessageService);
104
+
104
105
  items: MenuItem[] | undefined;
105
106
 
106
107
  ngOnInit() {
@@ -170,9 +171,10 @@ export class MenubarCommandDemo implements OnInit {
170
171
  Menu items support navigation via routerLink, programmatic routing using commands, or external URLs.
171
172
 
172
173
  ```typescript
173
- import { Component, OnInit } from '@angular/core';
174
- import { MenubarModule } from '@exhaustive-ui/core/menubar';
174
+ import { Component, OnInit, inject } from '@angular/core';
175
+ import { Router } from '@angular/router';
175
176
  import { MenuItem } from '@exhaustive-ui/core/api';
177
+ import { MenubarModule } from '@exhaustive-ui/core/menubar';
176
178
 
177
179
  @Component({
178
180
  template: `
@@ -184,6 +186,8 @@ import { MenuItem } from '@exhaustive-ui/core/api';
184
186
  imports: [MenubarModule]
185
187
  })
186
188
  export class MenubarRouterDemo implements OnInit {
189
+ private router = inject(Router);
190
+
187
191
  items: MenuItem[] | undefined;
188
192
 
189
193
  ngOnInit() {
@@ -233,13 +237,14 @@ export class MenubarRouterDemo implements OnInit {
233
237
  Custom content can be placed inside the menubar using the start and end templates.
234
238
 
235
239
  ```typescript
240
+ import { CommonModule } from '@angular/common';
236
241
  import { Component, OnInit } from '@angular/core';
242
+ import { MenuItem } from '@exhaustive-ui/core/api';
237
243
  import { AvatarModule } from '@exhaustive-ui/core/avatar';
238
244
  import { BadgeModule } from '@exhaustive-ui/core/badge';
239
- import { MenubarModule } from '@exhaustive-ui/core/menubar';
240
245
  import { InputTextModule } from '@exhaustive-ui/core/inputtext';
241
- import { RippleModule } from '@exhaustive-ui/core/ripple';
242
- import { MenuItem } from '@exhaustive-ui/core/api';
246
+ import { MenubarModule } from '@exhaustive-ui/core/menubar';
247
+ import { Ripple } from '@exhaustive-ui/core/ripple';
243
248
 
244
249
  @Component({
245
250
  template: `
@@ -287,14 +292,14 @@ import { MenuItem } from '@exhaustive-ui/core/api';
287
292
  <ng-template #end>
288
293
  <div class="flex items-center gap-2">
289
294
  <input type="text" pInputText placeholder="Search" class="w-36" />
290
- <p-avatar image="https://exhaustive-ui.com/demo/avatar/amyelsner.png" shape="circle" />
295
+ <p-avatar image="https://exhaustive-ui.com/demo/avatar/amyelsner.png" ariaLabel="Amy Elsner" shape="circle" />
291
296
  </div>
292
297
  </ng-template>
293
298
  </p-menubar>
294
299
  </div>
295
300
  `,
296
301
  standalone: true,
297
- imports: [AvatarModule, BadgeModule, MenubarModule, InputTextModule, RippleModule]
302
+ imports: [CommonModule, MenubarModule, BadgeModule, AvatarModule, InputTextModule, Ripple]
298
303
  })
299
304
  export class MenubarTemplateDemo implements OnInit {
300
305
  items: MenuItem[] | undefined;
@@ -343,18 +348,18 @@ Menubar is a horizontal menu component.
343
348
 
344
349
  | Name | Type | Default | Description |
345
350
  |------|------|---------|-------------|
346
- | dt | InputSignal<Object> | undefined | Defines scoped design tokens of the component. |
347
- | unstyled | InputSignal<boolean> | undefined | Indicates whether the component should be rendered without styles. |
348
- | pt | InputSignal<MenubarPassThrough> | undefined | Used to pass attributes to DOM elements inside the component. |
349
- | ptOptions | InputSignal<PassThroughOptions> | undefined | Used to configure passthrough(pt) options of the component. |
350
- | model | InputSignal<MenuItem[]> | ... | An array of menuitems. |
351
- | autoDisplay | InputSignalWithTransform<boolean, unknown> | true | Whether to show a root submenu on mouse over. |
352
- | autoHide | InputSignalWithTransform<boolean, unknown> | ... | Whether to hide a root submenu when mouse leaves. |
353
- | breakpoint | InputSignal<string> | ... | The breakpoint to define the maximum width boundary. |
354
- | autoHideDelay | InputSignalWithTransform<number, unknown> | ... | Delay to hide the root submenu in milliseconds when mouse leaves. |
355
- | id | InputSignal<string> | ... | Current id state as a string. |
356
- | ariaLabel | InputSignal<string> | ... | Defines a string value that labels an interactive element. |
357
- | ariaLabelledBy | InputSignal<string> | ... | Identifier of the underlying input element. |
351
+ | dt | Object | undefined | Defines scoped design tokens of the component. |
352
+ | unstyled | boolean | undefined | Indicates whether the component should be rendered without styles. |
353
+ | pt | MenubarPassThrough | undefined | Used to pass attributes to DOM elements inside the component. |
354
+ | ptOptions | PassThroughOptions | undefined | Used to configure passthrough(pt) options of the component. |
355
+ | model | MenuItem[] | - | An array of menuitems. |
356
+ | autoDisplay | boolean | true | Whether to show a root submenu on mouse over. |
357
+ | autoHide | boolean | - | Whether to hide a root submenu when mouse leaves. |
358
+ | breakpoint | string | '960px' | The breakpoint to define the maximum width boundary. |
359
+ | autoHideDelay | number | 100 | Delay to hide the root submenu in milliseconds when mouse leaves. |
360
+ | id | string | - | Current id state as a string. |
361
+ | ariaLabel | string | - | Defines a string value that labels an interactive element. |
362
+ | ariaLabelledBy | string | - | Identifier of the underlying input element. |
358
363
 
359
364
  ### Emits
360
365
 
@@ -23,7 +23,8 @@ import { MessageModule } from '@exhaustive-ui/core/message';
23
23
  standalone: true,
24
24
  imports: [MessageModule]
25
25
  })
26
- export class MessageBasicDemo {}
26
+ export class MessageBasicDemo {
27
+ }
27
28
  ```
28
29
 
29
30
  ## Closable
@@ -43,7 +44,8 @@ import { MessageModule } from '@exhaustive-ui/core/message';
43
44
  standalone: true,
44
45
  imports: [MessageModule]
45
46
  })
46
- export class MessageClosableDemo {}
47
+ export class MessageClosableDemo {
48
+ }
47
49
  ```
48
50
 
49
51
  ## Dynamic
@@ -52,8 +54,9 @@ Multiple messages can be displayed using the standard for block.
52
54
 
53
55
  ```typescript
54
56
  import { Component, signal } from '@angular/core';
55
- import { ButtonModule } from '@exhaustive-ui/core/button';
57
+ import { CommonModule } from '@angular/common';
56
58
  import { MessageModule } from '@exhaustive-ui/core/message';
59
+ import { ButtonModule } from '@exhaustive-ui/core/button';
57
60
 
58
61
  @Component({
59
62
  template: `
@@ -64,13 +67,13 @@ import { MessageModule } from '@exhaustive-ui/core/message';
64
67
  </div>
65
68
  <div class="flex flex-col">
66
69
  @for (message of messages(); track message.severity; let first = $first) {
67
- <p-message [severity]="message.severity" [text]="message.content" [ngClass]="{ 'mt-4': !first }" [closable]="message?.closable" />
70
+ <p-message [severity]="message.severity" [ngClass]="{ 'mt-4': !first }" [closable]="message?.closable">{{ message.content }}</p-message>
68
71
  }
69
72
  </div>
70
73
  </div>
71
74
  `,
72
75
  standalone: true,
73
- imports: [ButtonModule, MessageModule]
76
+ imports: [CommonModule, MessageModule, ButtonModule]
74
77
  })
75
78
  export class MessageDynamicDemo {
76
79
  messages = signal<any[]>([]);
@@ -94,11 +97,12 @@ export class MessageDynamicDemo {
94
97
  Validation errors in a form are displayed with the error severity.
95
98
 
96
99
  ```typescript
100
+ import { CommonModule } from '@angular/common';
97
101
  import { Component } from '@angular/core';
98
102
  import { FormsModule } from '@angular/forms';
99
103
  import { InputMaskModule } from '@exhaustive-ui/core/inputmask';
100
- import { MessageModule } from '@exhaustive-ui/core/message';
101
104
  import { InputTextModule } from '@exhaustive-ui/core/inputtext';
105
+ import { MessageModule } from '@exhaustive-ui/core/message';
102
106
 
103
107
  @Component({
104
108
  template: `
@@ -121,10 +125,11 @@ import { InputTextModule } from '@exhaustive-ui/core/inputtext';
121
125
  </div>
122
126
  `,
123
127
  standalone: true,
124
- imports: [InputMaskModule, MessageModule, InputTextModule, FormsModule]
128
+ imports: [FormsModule, MessageModule, InputTextModule, InputMaskModule, CommonModule]
125
129
  })
126
130
  export class MessageFormDemo {
127
131
  username: string | undefined;
132
+
128
133
  phone: string | undefined;
129
134
  }
130
135
  ```
@@ -134,26 +139,28 @@ export class MessageFormDemo {
134
139
  The icon of a message is specified with the icon property.
135
140
 
136
141
  ```typescript
137
- import { Component } from '@angular/core';
142
+ import { Component, OnInit } from '@angular/core';
138
143
  import { AvatarModule } from '@exhaustive-ui/core/avatar';
139
144
  import { MessageModule } from '@exhaustive-ui/core/message';
140
145
 
141
146
  @Component({
142
147
  template: `
143
148
  <div class="card flex justify-center items-center gap-4">
144
- <p-message severity="info" icon="pi pi-send" text="Info Message" class="h-full" />
149
+ <p-message severity="info" icon="pi pi-send" class="h-full">Info Message</p-message>
145
150
  <p-message severity="success">
146
151
  <ng-template #icon>
147
- <p-avatar image="https://exhaustive-ui.com/demo/avatar/amyelsner.png" shape="circle" />
152
+ <p-avatar image="https://exhaustive-ui.com/demo/avatar/amyelsner.png" ariaLabel="Amy Elsner" shape="circle" />
148
153
  </ng-template>
149
154
  <span class="ms-2">How may I help you?</span>
150
155
  </p-message>
151
156
  </div>
152
157
  `,
153
158
  standalone: true,
154
- imports: [AvatarModule, MessageModule]
159
+ imports: [MessageModule, AvatarModule]
155
160
  })
156
- export class MessageIconDemo {}
161
+ export class MessageIconDemo implements OnInit {
162
+ ngOnInit() {}
163
+ }
157
164
  ```
158
165
 
159
166
  ## Life
@@ -162,8 +169,9 @@ Messages can disappear automatically by defined the life in milliseconds.
162
169
 
163
170
  ```typescript
164
171
  import { Component, signal } from '@angular/core';
165
- import { ButtonModule } from '@exhaustive-ui/core/button';
172
+ import { CommonModule } from '@angular/common';
166
173
  import { MessageModule } from '@exhaustive-ui/core/message';
174
+ import { ButtonModule } from '@exhaustive-ui/core/button';
167
175
 
168
176
  @Component({
169
177
  template: `
@@ -175,14 +183,14 @@ import { MessageModule } from '@exhaustive-ui/core/message';
175
183
  </div>
176
184
  `,
177
185
  standalone: true,
178
- imports: [ButtonModule, MessageModule]
186
+ imports: [MessageModule, ButtonModule, CommonModule]
179
187
  })
180
188
  export class MessageLifeDemo {
181
189
  visible = signal(false);
182
190
 
183
191
  showMessage() {
184
192
  this.visible.set(true);
185
-
193
+
186
194
  setTimeout(() => {
187
195
  this.visible.set(false);
188
196
  }, 3000);
@@ -212,7 +220,8 @@ import { MessageModule } from '@exhaustive-ui/core/message';
212
220
  standalone: true,
213
221
  imports: [MessageModule]
214
222
  })
215
- export class MessageOutlinedDemo {}
223
+ export class MessageOutlinedDemo {
224
+ }
216
225
  ```
217
226
 
218
227
  ## Severity
@@ -237,7 +246,8 @@ import { MessageModule } from '@exhaustive-ui/core/message';
237
246
  standalone: true,
238
247
  imports: [MessageModule]
239
248
  })
240
- export class MessageSeverityDemo {}
249
+ export class MessageSeverityDemo {
250
+ }
241
251
  ```
242
252
 
243
253
  ## Simple
@@ -262,7 +272,8 @@ import { MessageModule } from '@exhaustive-ui/core/message';
262
272
  standalone: true,
263
273
  imports: [MessageModule]
264
274
  })
265
- export class MessageSimpleDemo {}
275
+ export class MessageSimpleDemo {
276
+ }
266
277
  ```
267
278
 
268
279
  ## Sizes
@@ -284,7 +295,8 @@ import { MessageModule } from '@exhaustive-ui/core/message';
284
295
  standalone: true,
285
296
  imports: [MessageModule]
286
297
  })
287
- export class MessageSizesDemo {}
298
+ export class MessageSizesDemo {
299
+ }
288
300
  ```
289
301
 
290
302
  ## Message
@@ -295,19 +307,19 @@ Message groups a collection of contents in tabs.
295
307
 
296
308
  | Name | Type | Default | Description |
297
309
  |------|------|---------|-------------|
298
- | dt | InputSignal<Object> | undefined | Defines scoped design tokens of the component. |
299
- | unstyled | InputSignal<boolean> | undefined | Indicates whether the component should be rendered without styles. |
300
- | pt | InputSignal<MessagePassThrough> | undefined | Used to pass attributes to DOM elements inside the component. |
301
- | ptOptions | InputSignal<PassThroughOptions> | undefined | Used to configure passthrough(pt) options of the component. |
302
- | severity | InputSignal<MessageSeverity> | 'info' | Severity level of the message. |
303
- | text | InputSignal<string> | ... | Text content. **(Deprecated)** |
304
- | escape | InputSignalWithTransform<boolean, unknown> | ... | Whether displaying messages would be escaped or not. **(Deprecated)** |
305
- | closable | InputSignalWithTransform<boolean, unknown> | false | Whether the message can be closed manually using the close icon. |
306
- | icon | InputSignal<string> | undefined | Icon to display in the message. |
307
- | closeIcon | InputSignal<string> | undefined | Icon to display in the message close button. |
308
- | size | InputSignal<"small" \| "large"> | ... | Defines the size of the component. |
309
- | variant | InputSignal<"text" \| "outlined" \| "simple"> | ... | Specifies the input variant of the component. |
310
- | motionOptions | InputSignal<MotionOptions> | ... | The motion options. |
310
+ | dt | Object | undefined | Defines scoped design tokens of the component. |
311
+ | unstyled | boolean | undefined | Indicates whether the component should be rendered without styles. |
312
+ | pt | MessagePassThrough | undefined | Used to pass attributes to DOM elements inside the component. |
313
+ | ptOptions | PassThroughOptions | undefined | Used to configure passthrough(pt) options of the component. |
314
+ | severity | MessageSeverity | 'info' | Severity level of the message. |
315
+ | text | string | - | Text content. **(Deprecated)** |
316
+ | escape | boolean | true | Whether displaying messages would be escaped or not. **(Deprecated)** |
317
+ | closable | boolean | false | Whether the message can be closed manually using the close icon. |
318
+ | icon | string | undefined | Icon to display in the message. |
319
+ | closeIcon | string | undefined | Icon to display in the message close button. |
320
+ | size | "small" \| "large" | - | Defines the size of the component. |
321
+ | variant | "text" \| "outlined" \| "simple" | - | Specifies the input variant of the component. |
322
+ | motionOptions | MotionOptions | - | The motion options. |
311
323
 
312
324
  ### Emits
313
325