@aurodesignsystem-dev/auro-formkit 0.0.0-pr1451.2 → 0.0.0-pr1451.21

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 (254) hide show
  1. package/components/checkbox/README.md +11 -27
  2. package/components/checkbox/demo/accessibility.html +49 -0
  3. package/components/checkbox/demo/accessibility.md +44 -0
  4. package/components/checkbox/demo/api.html +17 -25
  5. package/components/checkbox/demo/api.md +40 -416
  6. package/components/checkbox/demo/api.min.js +5 -4
  7. package/components/checkbox/demo/customize.html +52 -0
  8. package/components/checkbox/demo/customize.md +361 -0
  9. package/components/checkbox/demo/demo-support.js +60 -0
  10. package/components/checkbox/demo/design.html +52 -0
  11. package/components/checkbox/demo/design.md +149 -0
  12. package/components/checkbox/demo/getting-started.html +52 -0
  13. package/components/checkbox/demo/getting-started.md +261 -0
  14. package/components/checkbox/demo/index.html +17 -20
  15. package/components/checkbox/demo/index.md +144 -29
  16. package/components/checkbox/demo/index.min.js +5 -4
  17. package/components/checkbox/demo/keyboard-behavior.html +49 -0
  18. package/components/checkbox/demo/keyboard-behavior.md +0 -3
  19. package/components/checkbox/demo/layout.md +30 -0
  20. package/components/checkbox/demo/readme.html +10 -17
  21. package/components/checkbox/demo/readme.md +11 -27
  22. package/components/checkbox/demo/styles.css +974 -0
  23. package/components/checkbox/demo/voiceover.html +49 -0
  24. package/components/checkbox/demo/voiceover.md +37 -0
  25. package/components/checkbox/dist/auro-checkbox.d.ts +1 -0
  26. package/components/checkbox/dist/index.js +5 -4
  27. package/components/checkbox/dist/registered.js +5 -4
  28. package/components/combobox/README.md +8 -29
  29. package/components/combobox/demo/accessibility.html +2 -20
  30. package/components/combobox/demo/accessibility.md +1 -1
  31. package/components/combobox/demo/api.html +5 -52
  32. package/components/combobox/demo/api.md +53 -2261
  33. package/components/combobox/demo/api.min.js +15 -12
  34. package/components/combobox/demo/customize.html +53 -0
  35. package/components/combobox/demo/customize.js +24 -0
  36. package/components/combobox/demo/customize.md +1249 -0
  37. package/components/combobox/demo/customize.min.js +18132 -0
  38. package/components/combobox/demo/demo-support.js +60 -0
  39. package/components/combobox/demo/design.html +2 -43
  40. package/components/combobox/demo/design.md +4 -4
  41. package/components/combobox/demo/getting-started.html +53 -0
  42. package/components/combobox/demo/{install.js → getting-started.js} +2 -5
  43. package/components/combobox/demo/getting-started.md +397 -0
  44. package/components/combobox/demo/{install.min.js → getting-started.min.js} +14 -38
  45. package/components/combobox/demo/index.html +4 -47
  46. package/components/combobox/demo/index.md +3 -569
  47. package/components/combobox/demo/index.min.js +15 -12
  48. package/components/combobox/demo/keyboard-behavior.html +2 -20
  49. package/components/combobox/demo/keyboard-behavior.md +2 -2
  50. package/components/combobox/demo/layout.md +2 -2
  51. package/components/combobox/demo/readme.html +2 -43
  52. package/components/combobox/demo/readme.md +8 -29
  53. package/components/combobox/demo/styles.css +98 -105
  54. package/components/combobox/demo/voiceover.html +2 -20
  55. package/components/combobox/demo/voiceover.md +1 -1
  56. package/components/combobox/dist/index.js +12 -10
  57. package/components/combobox/dist/registered.js +12 -10
  58. package/components/counter/README.md +21 -51
  59. package/components/counter/demo/accessibility.html +49 -0
  60. package/components/counter/demo/accessibility.md +34 -0
  61. package/components/counter/demo/api.html +12 -20
  62. package/components/counter/demo/api.md +49 -1299
  63. package/components/counter/demo/api.min.js +6 -6
  64. package/components/counter/demo/customize.html +53 -0
  65. package/components/counter/demo/customize.md +650 -0
  66. package/components/counter/demo/demo-support.js +60 -0
  67. package/components/counter/demo/design.html +52 -0
  68. package/components/counter/demo/design.md +192 -0
  69. package/components/counter/demo/getting-started.html +54 -0
  70. package/components/counter/demo/getting-started.md +332 -0
  71. package/components/counter/demo/index.html +14 -19
  72. package/components/counter/demo/index.md +113 -47
  73. package/components/counter/demo/index.min.js +6 -6
  74. package/components/counter/demo/keyboard-behavior.html +49 -0
  75. package/components/counter/demo/keyboard-behavior.md +1 -1
  76. package/components/counter/demo/keyboardBehavior.html +7 -39
  77. package/components/counter/demo/layout.md +10 -0
  78. package/components/counter/demo/readme.html +11 -15
  79. package/components/counter/demo/readme.md +21 -51
  80. package/components/counter/demo/styles.css +974 -0
  81. package/components/counter/demo/voiceover.html +51 -0
  82. package/components/counter/demo/voiceover.md +80 -0
  83. package/components/counter/dist/index.js +6 -6
  84. package/components/counter/dist/registered.js +6 -6
  85. package/components/datepicker/README.md +10 -24
  86. package/components/datepicker/demo/accessibility.html +50 -0
  87. package/components/datepicker/demo/accessibility.md +64 -0
  88. package/components/datepicker/demo/api.md +69 -1739
  89. package/components/datepicker/demo/api.min.js +14 -14
  90. package/components/datepicker/demo/customize.html +53 -0
  91. package/components/datepicker/demo/customize.md +723 -0
  92. package/components/datepicker/demo/demo-support.js +60 -0
  93. package/components/{select/demo/layout.html → datepicker/demo/design.html} +7 -47
  94. package/components/datepicker/demo/design.md +158 -0
  95. package/components/datepicker/demo/getting-started.html +53 -0
  96. package/components/datepicker/demo/getting-started.md +237 -0
  97. package/components/datepicker/demo/index.html +14 -34
  98. package/components/datepicker/demo/index.md +160 -103
  99. package/components/datepicker/demo/index.min.js +14 -14
  100. package/components/datepicker/demo/keyboard-behavior.html +12 -33
  101. package/components/datepicker/demo/layout.md +92 -0
  102. package/components/datepicker/demo/readme.md +10 -24
  103. package/components/datepicker/demo/styles.css +974 -0
  104. package/components/{dropdown/demo/keyboardBehavior.html → datepicker/demo/voiceover.html} +14 -36
  105. package/components/datepicker/demo/voiceover.md +98 -0
  106. package/components/datepicker/dist/index.js +14 -14
  107. package/components/datepicker/dist/registered.js +14 -14
  108. package/components/dropdown/README.md +0 -25
  109. package/components/dropdown/demo/accessibility.html +49 -0
  110. package/components/dropdown/demo/accessibility.md +45 -0
  111. package/components/dropdown/demo/api.html +10 -19
  112. package/components/dropdown/demo/api.md +40 -1364
  113. package/components/dropdown/demo/api.min.js +2 -2
  114. package/components/dropdown/demo/customize.html +54 -0
  115. package/components/dropdown/demo/customize.md +780 -0
  116. package/components/dropdown/demo/demo-support.js +60 -0
  117. package/components/dropdown/demo/design.html +52 -0
  118. package/components/dropdown/demo/design.md +186 -0
  119. package/components/dropdown/demo/getting-started.html +54 -0
  120. package/components/dropdown/demo/getting-started.md +317 -0
  121. package/components/dropdown/demo/index.html +12 -20
  122. package/components/dropdown/demo/index.md +70 -225
  123. package/components/dropdown/demo/index.min.js +2 -2
  124. package/components/dropdown/demo/keyboard-behavior.html +49 -0
  125. package/components/dropdown/demo/keyboard-behavior.md +4 -8
  126. package/components/dropdown/demo/layout.md +21 -0
  127. package/components/dropdown/demo/readme.html +7 -20
  128. package/components/dropdown/demo/readme.md +0 -25
  129. package/components/dropdown/demo/styles.css +974 -0
  130. package/components/dropdown/demo/voiceover.html +51 -0
  131. package/components/dropdown/demo/voiceover.md +63 -0
  132. package/components/dropdown/dist/index.js +2 -2
  133. package/components/dropdown/dist/registered.js +2 -2
  134. package/components/form/README.md +9 -13
  135. package/components/form/demo/accessibility.html +51 -0
  136. package/components/form/demo/accessibility.md +23 -0
  137. package/components/form/demo/api.html +11 -14
  138. package/components/form/demo/api.md +14 -290
  139. package/components/form/demo/api.min.js +53 -50
  140. package/components/form/demo/customize.html +54 -0
  141. package/components/form/demo/customize.md +246 -0
  142. package/components/form/demo/demo-support.js +60 -0
  143. package/components/form/demo/getting-started.html +54 -0
  144. package/components/form/demo/getting-started.md +291 -0
  145. package/components/form/demo/index.html +12 -14
  146. package/components/form/demo/index.md +66 -96
  147. package/components/form/demo/index.min.js +53 -50
  148. package/components/form/demo/keyboard-behavior.html +51 -0
  149. package/components/form/demo/readme.html +12 -17
  150. package/components/form/demo/readme.md +9 -13
  151. package/components/form/demo/styles.css +974 -0
  152. package/components/form/demo/voiceover.html +51 -0
  153. package/components/form/demo/voiceover.md +36 -0
  154. package/components/helptext/dist/index.js +1 -1
  155. package/components/helptext/dist/registered.js +1 -1
  156. package/components/input/README.md +17 -28
  157. package/components/input/demo/accessibility.html +38 -0
  158. package/components/input/demo/accessibility.md +69 -0
  159. package/components/input/demo/api.html +17 -22
  160. package/components/input/demo/api.js +4 -23
  161. package/components/input/demo/api.md +67 -1267
  162. package/components/input/demo/api.min.js +6 -98
  163. package/components/input/demo/customize.html +54 -0
  164. package/components/input/demo/customize.js +25 -0
  165. package/components/input/demo/customize.md +1372 -0
  166. package/components/input/demo/customize.min.js +7431 -0
  167. package/components/input/demo/demo-support.js +60 -0
  168. package/components/input/demo/design.html +39 -0
  169. package/components/input/demo/design.md +224 -0
  170. package/components/input/demo/getting-started.html +53 -0
  171. package/components/input/demo/getting-started.js +8 -0
  172. package/components/input/demo/getting-started.md +312 -0
  173. package/components/input/demo/getting-started.min.js +7369 -0
  174. package/components/input/demo/index.html +16 -22
  175. package/components/input/demo/index.js +0 -11
  176. package/components/input/demo/index.md +171 -139
  177. package/components/input/demo/index.min.js +6 -18
  178. package/components/input/demo/keyboard-behavior.html +38 -0
  179. package/components/input/demo/layout.md +77 -0
  180. package/components/input/demo/readme.md +17 -28
  181. package/components/input/demo/styles.css +974 -0
  182. package/components/input/demo/voiceover.html +38 -0
  183. package/components/input/demo/voiceover.md +70 -0
  184. package/components/input/dist/base-input.d.ts +1 -0
  185. package/components/input/dist/index.js +6 -6
  186. package/components/input/dist/registered.js +6 -6
  187. package/components/menu/README.md +1 -5
  188. package/components/menu/demo/api.md +43 -43
  189. package/components/menu/demo/api.min.js +2 -2
  190. package/components/menu/demo/index.md +1 -1
  191. package/components/menu/demo/index.min.js +2 -2
  192. package/components/menu/demo/readme.md +1 -5
  193. package/components/menu/dist/index.js +2 -2
  194. package/components/menu/dist/registered.js +2 -2
  195. package/components/radio/README.md +9 -22
  196. package/components/radio/demo/accessibility.html +51 -0
  197. package/components/radio/demo/accessibility.md +44 -0
  198. package/components/radio/demo/api.html +13 -20
  199. package/components/radio/demo/api.md +44 -589
  200. package/components/radio/demo/api.min.js +3 -3
  201. package/components/radio/demo/customize.html +53 -0
  202. package/components/radio/demo/customize.md +368 -0
  203. package/components/radio/demo/demo-support.js +60 -0
  204. package/components/radio/demo/design.html +52 -0
  205. package/components/radio/demo/design.md +143 -0
  206. package/components/radio/demo/getting-started.html +54 -0
  207. package/components/radio/demo/getting-started.md +296 -0
  208. package/components/radio/demo/index.html +16 -19
  209. package/components/radio/demo/index.md +110 -45
  210. package/components/radio/demo/index.min.js +3 -3
  211. package/components/radio/demo/keyboard-behavior.html +51 -0
  212. package/components/radio/demo/layout.md +30 -0
  213. package/components/radio/demo/readme.html +11 -17
  214. package/components/radio/demo/readme.md +9 -22
  215. package/components/radio/demo/styles.css +974 -0
  216. package/components/radio/demo/voiceover.html +51 -0
  217. package/components/radio/demo/voiceover.md +43 -0
  218. package/components/radio/dist/index.js +3 -3
  219. package/components/radio/dist/registered.js +3 -3
  220. package/components/select/README.md +7 -4
  221. package/components/select/demo/accessibility.html +5 -21
  222. package/components/select/demo/accessibility.md +1 -1
  223. package/components/select/demo/api.html +3 -48
  224. package/components/select/demo/api.md +52 -2342
  225. package/components/select/demo/customize.html +54 -0
  226. package/components/select/demo/customize.js +11 -0
  227. package/components/select/demo/customize.md +1049 -0
  228. package/components/select/demo/{api.min.js → customize.min.js} +12 -113
  229. package/components/select/demo/demo-support.js +60 -0
  230. package/components/select/demo/design.html +3 -44
  231. package/components/select/demo/design.md +2 -2
  232. package/components/select/demo/getting-started.html +5 -76
  233. package/components/select/demo/getting-started.js +20 -3
  234. package/components/select/demo/getting-started.md +97 -705
  235. package/components/select/demo/getting-started.min.js +58 -9
  236. package/components/select/demo/index.html +4 -43
  237. package/components/select/demo/index.js +5 -3
  238. package/components/select/demo/index.md +2 -2
  239. package/components/select/demo/index.min.js +14 -9
  240. package/components/select/demo/keyboard-behavior.html +6 -47
  241. package/components/select/demo/keyboard-behavior.md +5 -6
  242. package/components/select/demo/keyboardBehavior.html +4 -46
  243. package/components/select/demo/readme.html +3 -44
  244. package/components/select/demo/readme.md +7 -4
  245. package/components/select/demo/styles.css +57 -109
  246. package/components/select/demo/voiceover.html +3 -30
  247. package/components/select/dist/index.js +5 -5
  248. package/components/select/dist/registered.js +5 -5
  249. package/custom-elements.json +249 -246
  250. package/package.json +3 -3
  251. package/components/combobox/demo/install.html +0 -94
  252. package/components/combobox/demo/install.md +0 -98
  253. package/components/select/demo/api.js +0 -39
  254. package/components/select/demo/install.md +0 -92
@@ -8,39 +8,39 @@ The `auro-counter-group` element provides a flexible interface for grouping mult
8
8
  ## Properties
9
9
 
10
10
  | Property | Attribute | Type | Default | Description |
11
- |---------------------------|---------------------------|--------------------------------------------------|------------------|--------------------------------------------------|
12
- | [appearance](#appearance) | `appearance` | `'default' \| 'inverse'` | "'default'" | Defines whether the component will be on lighter or darker backgrounds. |
13
- | [autoPlacement](#autoPlacement) | `autoPlacement` | `boolean` | "false" | If declared, bib's position will be automatically calculated where to appear. |
14
- | [error](#error) | `error` | `string` | | The current error message to display when the component is invalid. |
15
- | [fullscreenBreakpoint](#fullscreenBreakpoint) | `fullscreenBreakpoint` | `'xs' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| 'disabled'` | "'sm'" | Defines the screen size breakpoint at which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.<br /><br />When expanded, the dropdown will automatically display in fullscreen mode<br />if the screen size is equal to or smaller than the selected breakpoint. |
16
- | [isDropdown](#isDropdown) | `isDropdown` | `boolean` | false | If true, the counter group is displayed as a dropdown. |
17
- | [largeFullscreenHeadline](#largeFullscreenHeadline) | `largeFullscreenHeadline` | `boolean` | false | If declared, make bib.fullscreen.headline in HeadingDisplay.<br />Otherwise, Heading 600. |
18
- | [layout](#layout) | `layout` | `'classic' \| 'snowflake'` | "'classic'" | Determines the layout style of the counter group when it is a dropdown. |
19
- | [matchWidth](#matchWidth) | `matchWidth` | `boolean` | false | If declared, the dropdown will expand to the width of its parent container.<br />Otherwise, the dropdown width will be determined by its content. |
20
- | [max](#max) | `max` | `number` | "undefined" | The maximum value allowed for the whole group of counters. |
21
- | [min](#min) | `min` | `number` | "undefined" | The minimum value allowed for the whole group of counters. |
22
- | [noFlip](#noFlip) | `noFlip` | `boolean` | false | If declared, the bib will NOT flip to an alternate position<br />when there isn't enough space in the specified `placement`. |
23
- | [offset](#offset) | `offset` | `number` | "0" | Gap between the trigger element and bib. |
24
- | [onDark](#onDark) | `onDark` | `boolean` | false | DEPRECATED - use `appearance` instead. |
25
- | [placement](#placement) | `placement` | `'top' \| 'right' \| 'bottom' \| 'left' \| 'bottom-start' \| 'top-start' \| 'top-end' \| 'right-start' \| 'right-end' \| 'bottom-end' \| 'left-start' \| 'left-end'` | "'bottom-start'" | Position where the bib should appear relative to the trigger. |
26
- | [shift](#shift) | `shift` | `boolean` | false | If declared, the dropdown will shift its position to avoid being cut off by the viewport. |
27
- | [total](#total) | `total` | `number` | "undefined" | The total value of the counters. |
28
- | [validity](#validity) | `validity` | `string` | "undefined" | Reflects the validity state. |
29
- | [value](#value) | `value` | `object` | "undefined" | The current individual values of the nested counters. |
11
+ |---------------------------|---------------------------|--------------------------------------------------|------------------|--------------------------------------------------|
12
+ | `appearance` | `appearance` | `'default' \| 'inverse'` | "'default'" | Defines whether the component will be on lighter or darker backgrounds. |
13
+ | `autoPlacement` | `autoPlacement` | `boolean` | "false" | If declared, bib's position will be automatically calculated where to appear. |
14
+ | `error` | `error` | `string` | | The current error message to display when the component is invalid. |
15
+ | `fullscreenBreakpoint` | `fullscreenBreakpoint` | `'xs' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| 'disabled'` | "'sm'" | Defines the screen size breakpoint at which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.<br /><br />When expanded, the dropdown will automatically display in fullscreen mode<br />if the screen size is equal to or smaller than the selected breakpoint. |
16
+ | `isDropdown` | `isDropdown` | `boolean` | false | If true, the counter group is displayed as a dropdown. |
17
+ | `largeFullscreenHeadline` | `largeFullscreenHeadline` | `boolean` | false | If declared, make bib.fullscreen.headline in HeadingDisplay.<br />Otherwise, Heading 600. |
18
+ | `layout` | `layout` | `'classic' \| 'snowflake'` | "'classic'" | Determines the layout style of the counter group when it is a dropdown. |
19
+ | `matchWidth` | `matchWidth` | `boolean` | false | If declared, the dropdown will expand to the width of its parent container.<br />Otherwise, the dropdown width will be determined by its content. |
20
+ | `max` | `max` | `number` | "undefined" | The maximum value allowed for the whole group of counters. |
21
+ | `min` | `min` | `number` | "undefined" | The minimum value allowed for the whole group of counters. |
22
+ | `noFlip` | `noFlip` | `boolean` | false | If declared, the bib will NOT flip to an alternate position<br />when there isn't enough space in the specified `placement`. |
23
+ | `offset` | `offset` | `number` | "0" | Gap between the trigger element and bib. |
24
+ | `onDark` | `onDark` | `boolean` | false | DEPRECATED - use `appearance` instead. |
25
+ | `placement` | `placement` | `'top' \| 'right' \| 'bottom' \| 'left' \| 'bottom-start' \| 'top-start' \| 'top-end' \| 'right-start' \| 'right-end' \| 'bottom-end' \| 'left-start' \| 'left-end'` | "'bottom-start'" | Position where the bib should appear relative to the trigger. |
26
+ | `shift` | `shift` | `boolean` | false | If declared, the dropdown will shift its position to avoid being cut off by the viewport. |
27
+ | `total` | `total` | `number` | "undefined" | The total value of the counters. |
28
+ | `validity` | `validity` | `string` | "undefined" | Reflects the validity state. |
29
+ | `value` | `value` | `object` | "undefined" | The current individual values of the nested counters. |
30
30
 
31
31
  ## Methods
32
32
 
33
33
  | Method | Type | Description |
34
- |------------|----------------------------------------|--------------------------------------------------|
35
- | [hideBib](#hideBib) | `(): void` | Hides the dropdown bib if its open. |
36
- | [showBib](#showBib) | `(): void` | Shows the dropdown bib if there are options to show. |
37
- | [validate](#validate) | `(force?: boolean \| undefined): void` | Validates value.<br /><br />**force**: Whether to force validation. |
34
+ |------------|----------------------------------------|--------------------------------------------------|
35
+ | `hideBib` | `(): void` | Hides the dropdown bib if its open. |
36
+ | `showBib` | `(): void` | Shows the dropdown bib if there are options to show. |
37
+ | `validate` | `(force?: boolean \| undefined): void` | Validates value.<br /><br />**force**: Whether to force validation. |
38
38
 
39
39
  ## Events
40
40
 
41
41
  | Event | Type |
42
- |---------|--------------------------------------------------|
43
- | [input](#input) | `CustomEvent<{ total: number \| undefined; value: {} \| undefined; }>` |
42
+ |---------|--------------------------------------------------|
43
+ | `input` | `CustomEvent<{ total: number \| undefined; value: {} \| undefined; }>` |
44
44
 
45
45
  ## Slots
46
46
 
@@ -48,11 +48,11 @@ The `auro-counter-group` element provides a flexible interface for grouping mult
48
48
  |---------------------------|--------------------------------------------------|
49
49
  | `ariaLabel.bib.close` | Sets aria-label on close button in fullscreen bib |
50
50
  | `bib.fullscreen.footer` | Defines the footer to display at the bottom of fullscreen bib. Only used when `isDropdown` is true. |
51
- | `bib.fullscreen.headline` | Defines the headline to display above menu-options. Only used when `isDropdown` is true. Required. |
52
- | [default](#default) | Slot for counter elements. |
53
- | [helpText](#helpText) | Dropdown help text content. Only used when `isDropdown` is true. |
54
- | [label](#label) | Dropdown label content. Only used when `isDropdown` is true. |
55
- | [valueText](#valueText) | Dropdown value text display. Only used when `isDropdown` is true. |
51
+ | `bib.fullscreen.headline` | Defines the headline to display above menu-options. Only used when `isDropdown` is true. Required. |
52
+ | `default` | Slot for counter elements. |
53
+ | `helpText` | Dropdown help text content. Only used when `isDropdown` is true. |
54
+ | `label` | Dropdown label content. Only used when `isDropdown` is true. |
55
+ | `valueText` | Dropdown value text display. Only used when `isDropdown` is true. |
56
56
 
57
57
  # auro-counter
58
58
 
@@ -61,1287 +61,37 @@ The `auro-counter` element provides a flexible counter interface with increment
61
61
  ## Properties
62
62
 
63
63
  | Property | Attribute | Type | Default | Description |
64
- |--------------|--------------|--------------------------|-------------|--------------------------------------------------|
65
- | [appearance](#appearance) | `appearance` | `'default' \| 'inverse'` | "'default'" | Defines whether the component will be on lighter or darker backgrounds. |
66
- | [disabled](#disabled) | `disabled` | `boolean` | | Indicates if the counter is disabled. |
67
- | [error](#error) | `error` | `string` | | Error state and message.<br />True if set, value is the error message. |
68
- | [max](#max) | `max` | `number` | | The maximum value for the counter. |
69
- | [min](#min) | `min` | `number` | | The minimum value for the counter. |
70
- | [onDark](#onDark) | `onDark` | `boolean` | | DEPRECATED - use `appearance="inverse"` instead. |
71
- | [validity](#validity) | `validity` | `string` | | The validity state of the counter. |
72
- | [value](#value) | `value` | `number \| undefined` | | Gets the current value of the counter. |
64
+ |--------------|--------------|--------------------------|-------------|--------------------------------------------------|
65
+ | `appearance` | `appearance` | `'default' \| 'inverse'` | "'default'" | Defines whether the component will be on lighter or darker backgrounds. |
66
+ | `disabled` | `disabled` | `boolean` | | Indicates if the counter is disabled. |
67
+ | `error` | `error` | `string` | | Error state and message.<br />True if set, value is the error message. |
68
+ | `max` | `max` | `number` | | The maximum value for the counter. |
69
+ | `min` | `min` | `number` | | The minimum value for the counter. |
70
+ | `onDark` | `onDark` | `boolean` | | DEPRECATED - use `appearance="inverse"` instead. |
71
+ | `validity` | `validity` | `string` | | The validity state of the counter. |
72
+ | `value` | `value` | `number \| undefined` | | Gets the current value of the counter. |
73
73
 
74
74
  ## Methods
75
75
 
76
76
  | Method | Type | Description |
77
- |-------------|----------------------------------------|--------------------------------------------------|
78
- | [decrement](#decrement) | `(value?: number \| undefined): void` | Decrements the value of the counter by 1. If a value is provided, it decrements by that amount.<br /><br />**value**: The amount to decrement by. |
79
- | [increment](#increment) | `(value?: number \| undefined): void` | Increments the counter value by 1. If a value is provided, it increments by that amount.<br /><br />**value**: The amount to increment by. |
80
- | [validate](#validate) | `(force?: boolean \| undefined): void` | Validates value.<br /><br />**force**: Whether to force validation. |
77
+ |-------------|----------------------------------------|--------------------------------------------------|
78
+ | `decrement` | `(value?: number \| undefined): void` | Decrements the value of the counter by 1. If a value is provided, it decrements by that amount.<br /><br />**value**: The amount to decrement by. |
79
+ | `increment` | `(value?: number \| undefined): void` | Increments the counter value by 1. If a value is provided, it increments by that amount.<br /><br />**value**: The amount to increment by. |
80
+ | `validate` | `(force?: boolean \| undefined): void` | Validates value.<br /><br />**force**: Whether to force validation. |
81
81
 
82
82
  ## Events
83
83
 
84
84
  | Event | Type |
85
- |---------|------------------------------------------------|
86
- | [input](#input) | `CustomEvent<{ value: number \| undefined; }>` |
85
+ |---------|------------------------------------------------|
86
+ | `input` | `CustomEvent<{ value: number \| undefined; }>` |
87
87
 
88
88
  ## Slots
89
89
 
90
90
  | Name | Description |
91
91
  |-------------------|--------------------------------------------|
92
92
  | `ariaLabel.minus` | Accessible label for the decrement button. |
93
- | `ariaLabel.plus` | Accessible label for the increment button. |
94
- | [default](#default) | Main label content for the counter. |
95
- | [description](#description) | Descriptive content for the counter. |
96
- | [helpText](#helpText) | Help text content for the counter. |
97
- <!-- AURO-GENERATED-CONTENT:END -->
98
-
99
- ## Basic Counter
100
-
101
- <div class="exampleWrapper">
102
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/basic-standalone.html) -->
103
- <!-- The below content is automatically added from ./../apiExamples/basic-standalone.html -->
104
- <auro-counter>
105
- Adults
106
- </auro-counter>
107
- <!-- AURO-GENERATED-CONTENT:END -->
108
- </div>
109
- <auro-accordion alignRight>
110
- <span slot="trigger">See code</span>
111
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/basic-standalone.html) -->
112
- <!-- The below code snippet is automatically added from ./../apiExamples/basic-standalone.html -->
113
-
114
- <pre class="language-html"><code class="language-html">&lt;auro-counter&gt;
115
- Adults
116
- &lt;/auro-counter&gt;</code></pre>
117
- <!-- AURO-GENERATED-CONTENT:END -->
118
- </auro-accordion>
119
-
120
- ## Basic Counter Group
121
-
122
- <div class="exampleWrapper">
123
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/basic.html) -->
124
- <!-- The below content is automatically added from ./../apiExamples/basic.html -->
125
- <auro-counter-group>
126
- <auro-counter>
127
- Short label
128
- </auro-counter>
129
- <auro-counter>
130
- Another short label
131
- </auro-counter>
132
- <auro-counter>
133
- This is an example of the wrapping behavior for a long label
134
- </auro-counter>
135
- </auro-counter-group>
136
- <!-- AURO-GENERATED-CONTENT:END -->
137
- </div>
138
- <auro-accordion alignRight>
139
- <span slot="trigger">See code</span>
140
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/basic.html) -->
141
- <!-- The below code snippet is automatically added from ./../apiExamples/basic.html -->
142
-
143
- <pre class="language-html"><code class="language-html">&lt;auro-counter-group&gt;
144
- &lt;auro-counter&gt;
145
- Short label
146
- &lt;/auro-counter&gt;
147
- &lt;auro-counter&gt;
148
- Another short label
149
- &lt;/auro-counter&gt;
150
- &lt;auro-counter&gt;
151
- This is an example of the wrapping behavior for a long label
152
- &lt;/auro-counter&gt;
153
- &lt;/auro-counter-group&gt;</code></pre>
154
- <!-- AURO-GENERATED-CONTENT:END -->
155
- </auro-accordion>
156
-
157
- ## Counter Properties & Attribute Examples
158
-
159
- ### Appearance on Dark Backgrounds
160
-
161
- Use `appearance="inverse"` to ensure proper contrast on dark backgrounds.
162
-
163
- <div class="exampleWrapper--ondark" aria-hidden>
164
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/appearance-inverse.html) -->
165
- <!-- The below content is automatically added from ./../apiExamples/appearance-inverse.html -->
166
- <auro-counter appearance="inverse">
167
- Adults
168
- </auro-counter>
169
- <!-- AURO-GENERATED-CONTENT:END -->
170
- </div>
171
- <auro-accordion alignRight>
172
- <span slot="trigger">See code</span>
173
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/appearance-inverse.html) -->
174
- <!-- The below code snippet is automatically added from ./../apiExamples/appearance-inverse.html -->
175
-
176
- <pre class="language-html"><code class="language-html">&lt;auro-counter appearance="inverse"&gt;
177
- Adults
178
- &lt;/auro-counter&gt;</code></pre>
179
- <!-- AURO-GENERATED-CONTENT:END -->
180
- </auro-accordion>
181
-
182
- ### Disabled
183
-
184
- A counter can be disabled by adding the `disabled` attribute.
185
-
186
- <div class="exampleWrapper">
187
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/counter-disabled.html) -->
188
- <!-- The below content is automatically added from ./../apiExamples/counter-disabled.html -->
189
- <auro-counter disabled value="0">
190
- Disabled counter
191
- <span slot="description">This counter cannot be modified</span>
192
- </auro-counter>
193
- <!-- AURO-GENERATED-CONTENT:END -->
194
- </div>
195
- <div class="exampleWrapper--ondark" aria-hidden>
196
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/appearance-inverse-disabled.html) -->
197
- <!-- The below content is automatically added from ./../apiExamples/appearance-inverse-disabled.html -->
198
- <auro-counter appearance="inverse" disabled value="0">
199
- Disabled counter
200
- <span slot="description">This counter cannot be modified</span>
201
- </auro-counter>
202
- <!-- AURO-GENERATED-CONTENT:END -->
203
- </div>
204
- <auro-accordion alignRight>
205
- <span slot="trigger">See code</span>
206
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/counter-disabled.html) -->
207
- <!-- The below code snippet is automatically added from ./../apiExamples/counter-disabled.html -->
208
-
209
- <pre class="language-html"><code class="language-html">&lt;auro-counter disabled value="0"&gt;
210
- Disabled counter
211
- &lt;span slot="description"&gt;This counter cannot be modified&lt;/span&gt;
212
- &lt;/auro-counter&gt;</code></pre>
213
- <!-- AURO-GENERATED-CONTENT:END -->
214
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/appearance-inverse-disabled.html) -->
215
- <!-- The below code snippet is automatically added from ./../apiExamples/appearance-inverse-disabled.html -->
216
-
217
- <pre class="language-html"><code class="language-html">&lt;auro-counter appearance="inverse" disabled value="0"&gt;
218
- Disabled counter
219
- &lt;span slot="description"&gt;This counter cannot be modified&lt;/span&gt;
220
- &lt;/auro-counter&gt;</code></pre>
221
- <!-- AURO-GENERATED-CONTENT:END -->
222
- </auro-accordion>
223
-
224
- ### Error
225
-
226
- A custom error can be set on the counter by adding the `error` attribute the desired message.
227
-
228
- <div class="exampleWrapper">
229
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/counter-error.html) -->
230
- <!-- The below content is automatically added from ./../apiExamples/counter-error.html -->
231
- <auro-counter error="There is an error with the counter">
232
- Adults
233
- </auro-counter>
234
- <!-- AURO-GENERATED-CONTENT:END -->
235
- </div>
236
- <div class="exampleWrapper--ondark" aria-hidden>
237
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/appearance-inverse-error.html) -->
238
- <!-- The below content is automatically added from ./../apiExamples/appearance-inverse-error.html -->
239
- <auro-counter appearance="inverse" error="There is an error with the counter">
240
- Adults
241
- </auro-counter>
242
- <!-- AURO-GENERATED-CONTENT:END -->
243
- </div>
244
- <auro-accordion alignRight>
245
- <span slot="trigger">See code</span>
246
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/counter-error.html) -->
247
- <!-- The below code snippet is automatically added from ./../apiExamples/counter-error.html -->
248
-
249
- <pre class="language-html"><code class="language-html">&lt;auro-counter error="There is an error with the counter"&gt;
250
- Adults
251
- &lt;/auro-counter&gt;</code></pre>
252
- <!-- AURO-GENERATED-CONTENT:END -->
253
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/appearance-inverse-error.html) -->
254
- <!-- The below code snippet is automatically added from ./../apiExamples/appearance-inverse-error.html -->
255
-
256
- <pre class="language-html"><code class="language-html">&lt;auro-counter appearance="inverse" error="There is an error with the counter"&gt;
257
- Adults
258
- &lt;/auro-counter&gt;</code></pre>
259
- <!-- AURO-GENERATED-CONTENT:END -->
260
- </auro-accordion>
261
-
262
- ### Min/Max and Value
263
-
264
- Use the `min`, `max`, and `value` attributes to set the minimum and maximum allowable values for the counter, as well as its initial value.
265
-
266
- <div class="exampleWrapper">
267
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/counter-minmax.html) -->
268
- <!-- The below content is automatically added from ./../apiExamples/counter-minmax.html -->
269
- <auro-counter min="1" max="5" value="2">
270
- Adults
271
- <span slot="description">Min: 1, Max: 5</span>
272
- </auro-counter>
273
- <!-- AURO-GENERATED-CONTENT:END -->
274
- </div>
275
- <auro-accordion alignRight>
276
- <span slot="trigger">See code</span>
277
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/counter-minmax.html) -->
278
- <!-- The below code snippet is automatically added from ./../apiExamples/counter-minmax.html -->
279
-
280
- <pre class="language-html"><code class="language-html">&lt;auro-counter min="1" max="5" value="2"&gt;
281
- Adults
282
- &lt;span slot="description"&gt;Min: 1, Max: 5&lt;/span&gt;
283
- &lt;/auro-counter&gt;</code></pre>
284
- <!-- AURO-GENERATED-CONTENT:END -->
285
- </auro-accordion>
286
-
287
- ## Counter Slot Examples
288
-
289
- ### Description
290
-
291
- A description can be added with the `description` slot. The description appears below the main label and is useful for displaying important information or requirements.
292
-
293
- <div class="exampleWrapper">
294
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/description.html) -->
295
- <!-- The below content is automatically added from ./../apiExamples/description.html -->
296
- <auro-counter>
297
- Adults
298
- <span slot="description">18 years or older</span>
299
- </auro-counter>
300
- <!-- AURO-GENERATED-CONTENT:END -->
301
- </div>
302
- <div class="exampleWrapper--ondark" aria-hidden>
303
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/appearance-inverse-description.html) -->
304
- <!-- The below content is automatically added from ./../apiExamples/appearance-inverse-description.html -->
305
- <auro-counter appearance="inverse">
306
- Adults
307
- <span slot="description">18 years or older</span>
308
- </auro-counter>
309
- <!-- AURO-GENERATED-CONTENT:END -->
310
- </div>
311
- <auro-accordion alignRight>
312
- <span slot="trigger">See code</span>
313
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/description.html) -->
314
- <!-- The below code snippet is automatically added from ./../apiExamples/description.html -->
315
-
316
- <pre class="language-html"><code class="language-html">&lt;auro-counter&gt;
317
- Adults
318
- &lt;span slot="description"&gt;18 years or older&lt;/span&gt;
319
- &lt;/auro-counter&gt;</code></pre>
320
- <!-- AURO-GENERATED-CONTENT:END -->
321
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/appearance-inverse-description.html) -->
322
- <!-- The below code snippet is automatically added from ./../apiExamples/appearance-inverse-description.html -->
323
-
324
- <pre class="language-html"><code class="language-html">&lt;auro-counter appearance="inverse"&gt;
325
- Adults
326
- &lt;span slot="description"&gt;18 years or older&lt;/span&gt;
327
- &lt;/auro-counter&gt;</code></pre>
328
- <!-- AURO-GENERATED-CONTENT:END -->
329
- </auro-accordion>
330
-
331
- ### Help Text
332
-
333
- Help text is supported with counters, and can be added by targetting the `helptext` slot.
334
-
335
- <div class="exampleWrapper">
336
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/counter-helptext.html) -->
337
- <!-- The below content is automatically added from ./../apiExamples/counter-helptext.html -->
338
- <auro-counter>
339
- Adults
340
- <span slot="helpText">This is help text for the counter</span>
341
- </auro-counter>
342
- <!-- AURO-GENERATED-CONTENT:END -->
343
- </div>
344
- <div class="exampleWrapper--ondark" aria-hidden>
345
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/appearance-inverse-helptext.html) -->
346
- <!-- The below content is automatically added from ./../apiExamples/appearance-inverse-helptext.html -->
347
- <auro-counter appearance="inverse">
348
- Adults
349
- <span slot="helpText">This is help text for the counter</span>
350
- </auro-counter>
351
- <!-- AURO-GENERATED-CONTENT:END -->
352
- </div>
353
- <auro-accordion alignRight>
354
- <span slot="trigger">See code</span>
355
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/counter-helptext.html) -->
356
- <!-- The below code snippet is automatically added from ./../apiExamples/counter-helptext.html -->
357
-
358
- <pre class="language-html"><code class="language-html">&lt;auro-counter&gt;
359
- Adults
360
- &lt;span slot="helpText"&gt;This is help text for the counter&lt;/span&gt;
361
- &lt;/auro-counter&gt;</code></pre>
362
- <!-- AURO-GENERATED-CONTENT:END -->
363
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/appearance-inverse-helptext.html) -->
364
- <!-- The below code snippet is automatically added from ./../apiExamples/appearance-inverse-helptext.html -->
365
-
366
- <pre class="language-html"><code class="language-html">&lt;auro-counter appearance="inverse"&gt;
367
- Adults
368
- &lt;span slot="helpText"&gt;This is help text for the counter&lt;/span&gt;
369
- &lt;/auro-counter&gt;</code></pre>
370
- <!-- AURO-GENERATED-CONTENT:END -->
371
- </auro-accordion>
372
-
373
- ## Counter Group Properties & Attribute Examples
374
-
375
- ### Appearance on Dark Backgrounds
376
-
377
- Use `appearance="inverse"` to ensure proper contrast on dark backgrounds.
378
-
379
- <div class="exampleWrapper--ondark" aria-hidden>
380
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/appearance-inverse-group.html) -->
381
- <!-- The below content is automatically added from ./../apiExamples/appearance-inverse-group.html -->
382
- <auro-counter-group appearance="inverse">
383
- <auro-counter>
384
- Short label
385
- </auro-counter>
386
- <auro-counter>
387
- Another short label
388
- </auro-counter>
389
- <auro-counter>
390
- This is an example of the wrapping behavior for a long label
391
- </auro-counter>
392
- </auro-counter-group>
393
- <!-- AURO-GENERATED-CONTENT:END -->
394
- </div>
395
- <auro-accordion alignRight>
396
- <span slot="trigger">See code</span>
397
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/appearance-inverse-group.html) -->
398
- <!-- The below code snippet is automatically added from ./../apiExamples/appearance-inverse-group.html -->
399
-
400
- <pre class="language-html"><code class="language-html">&lt;auro-counter-group appearance="inverse"&gt;
401
- &lt;auro-counter&gt;
402
- Short label
403
- &lt;/auro-counter&gt;
404
- &lt;auro-counter&gt;
405
- Another short label
406
- &lt;/auro-counter&gt;
407
- &lt;auro-counter&gt;
408
- This is an example of the wrapping behavior for a long label
409
- &lt;/auro-counter&gt;
410
- &lt;/auro-counter-group&gt;</code></pre>
411
- <!-- AURO-GENERATED-CONTENT:END -->
412
- </auro-accordion>
413
-
414
- ### Dropdown Counter Group
415
-
416
- Use the `isDropdown` attribute to place a counter group into the dropdown menu. The dropdown mode provides a more compact interface, ideal for forms where space is limited. It collapses the counters into a dropdown that expands when clicked.
417
-
418
- <div class="exampleWrapper">
419
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/dropdown.html) -->
420
- <!-- The below content is automatically added from ./../apiExamples/dropdown.html -->
421
- <auro-counter-group isDropdown>
422
- <span slot="ariaLabel.bib.close">Close Popup</span>
423
- <span slot="bib.fullscreen.headline">Passengers</span>
424
- <div slot="label">Passengers</div>
425
- <auro-counter>
426
- Adults
427
- <span slot="description">18 years or older</span>
428
- </auro-counter>
429
- <auro-counter>
430
- Children
431
- <span slot="description">Under 17 years old. Restrictions apply if traveling without an adult.</span>
432
- </auro-counter>
433
- <auro-counter>
434
- Lap Infants
435
- <span slot="description">Under 2 years</span>
436
- </auro-counter>
437
- </auro-counter-group>
438
- <!-- AURO-GENERATED-CONTENT:END -->
439
- </div>
440
- <div class="exampleWrapper--ondark" aria-hidden>
441
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/appearance-inverse-dropdown.html) -->
442
- <!-- The below content is automatically added from ./../apiExamples/appearance-inverse-dropdown.html -->
443
- <auro-counter-group appearance="inverse" isDropdown>
444
- <div slot="bib.fullscreen.headline">Passengers</div>
445
- <div slot="label">Passengers</div>
446
- <auro-counter>
447
- Adults
448
- <span slot="description">18 years or older</span>
449
- </auro-counter>
450
- <auro-counter>
451
- Children
452
- <span slot="description">2-17 years</span>
453
- </auro-counter>
454
- </auro-counter-group>
455
- <!-- AURO-GENERATED-CONTENT:END -->
456
- </div>
457
- <auro-accordion alignRight>
458
- <span slot="trigger">See code</span>
459
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/dropdown.html) -->
460
- <!-- The below code snippet is automatically added from ./../apiExamples/dropdown.html -->
461
-
462
- <pre class="language-html"><code class="language-html">&lt;auro-counter-group isDropdown&gt;
463
- &lt;span slot="ariaLabel.bib.close"&gt;Close Popup&lt;/span&gt;
464
- &lt;span slot="bib.fullscreen.headline"&gt;Passengers&lt;/span&gt;
465
- &lt;div slot="label"&gt;Passengers&lt;/div&gt;
466
- &lt;auro-counter&gt;
467
- Adults
468
- &lt;span slot="description"&gt;18 years or older&lt;/span&gt;
469
- &lt;/auro-counter&gt;
470
- &lt;auro-counter&gt;
471
- Children
472
- &lt;span slot="description"&gt;Under 17 years old. Restrictions apply if traveling without an adult.&lt;/span&gt;
473
- &lt;/auro-counter&gt;
474
- &lt;auro-counter&gt;
475
- Lap Infants
476
- &lt;span slot="description"&gt;Under 2 years&lt;/span&gt;
477
- &lt;/auro-counter&gt;
478
- &lt;/auro-counter-group&gt;</code></pre>
479
- <!-- AURO-GENERATED-CONTENT:END -->
480
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/appearance-inverse-dropdown.html) -->
481
- <!-- The below code snippet is automatically added from ./../apiExamples/appearance-inverse-dropdown.html -->
482
-
483
- <pre class="language-html"><code class="language-html">&lt;auro-counter-group appearance="inverse" isDropdown&gt;
484
- &lt;div slot="bib.fullscreen.headline"&gt;Passengers&lt;/div&gt;
485
- &lt;div slot="label"&gt;Passengers&lt;/div&gt;
486
- &lt;auro-counter&gt;
487
- Adults
488
- &lt;span slot="description"&gt;18 years or older&lt;/span&gt;
489
- &lt;/auro-counter&gt;
490
- &lt;auro-counter&gt;
491
- Children
492
- &lt;span slot="description"&gt;2-17 years&lt;/span&gt;
493
- &lt;/auro-counter&gt;
494
- &lt;/auro-counter-group&gt;</code></pre>
495
- <!-- AURO-GENERATED-CONTENT:END -->
496
- </auro-accordion>
497
-
498
- ### Snowflake Layout
499
-
500
- Counter dropdowns support an alternate "snowflake" layout, using `layout="snowflake"`.
501
-
502
- <div class="exampleWrapper">
503
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/dropdown-snowflake.html) -->
504
- <!-- The below content is automatically added from ./../apiExamples/dropdown-snowflake.html -->
505
- <!-- Example of counter-group properties -->
506
- <auro-counter-group max="10" min="2" isDropdown layout="snowflake">
507
- <span slot="ariaLabel.bib.close">Close Popup</span>
508
- <div slot="bib.fullscreen.headline">Group fullscreen label</div>
509
- <auro-icon slot="typeIcon" category="interface" name="account-stroke" customColor></auro-icon>
510
- <div slot="label">Snowflake Dropdown Group</div>
511
- <div slot="helpText">Total must be between 2-10</div>
512
- <auro-counter>
513
- Counter 1
514
- </auro-counter>
515
- <auro-counter>
516
- Counter 2
517
- </auro-counter>
518
- </auro-counter-group>
519
- <!-- AURO-GENERATED-CONTENT:END -->
520
- </div>
521
- <div class="exampleWrapper--ondark">
522
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/appearance-inverse-snowflake.html) -->
523
- <!-- The below content is automatically added from ./../apiExamples/appearance-inverse-snowflake.html -->
524
- <!-- Example of counter-group properties -->
525
- <auro-counter-group max="10" min="2" isDropdown layout="snowflake" appearance="inverse">
526
- <span slot="ariaLabel.bib.close">Close Popup</span>
527
- <div slot="bib.fullscreen.headline">Group fullscreen label</div>
528
- <auro-icon slot="typeIcon" category="interface" name="account-stroke" customColor></auro-icon>
529
- <div slot="label">Snowflake Dropdown Group</div>
530
- <div slot="helpText">Total must be between 2-10</div>
531
- <auro-counter>
532
- Counter 1
533
- </auro-counter>
534
- <auro-counter>
535
- Counter 2
536
- </auro-counter>
537
- </auro-counter-group>
538
- <!-- AURO-GENERATED-CONTENT:END -->
539
- </div>
540
- <auro-accordion alignRight>
541
- <span slot="trigger">See code</span>
542
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/dropdown-snowflake.html) -->
543
- <!-- The below code snippet is automatically added from ./../apiExamples/dropdown-snowflake.html -->
544
-
545
- <pre class="language-html"><code class="language-html">&lt;!-- Example of counter-group properties --&gt;
546
- &lt;auro-counter-group max="10" min="2" isDropdown layout="snowflake"&gt;
547
- &lt;span slot="ariaLabel.bib.close"&gt;Close Popup&lt;/span&gt;
548
- &lt;div slot="bib.fullscreen.headline"&gt;Group fullscreen label&lt;/div&gt;
549
- &lt;auro-icon slot="typeIcon" category="interface" name="account-stroke" customColor&gt;&lt;/auro-icon&gt;
550
- &lt;div slot="label"&gt;Snowflake Dropdown Group&lt;/div&gt;
551
- &lt;div slot="helpText"&gt;Total must be between 2-10&lt;/div&gt;
552
- &lt;auro-counter&gt;
553
- Counter 1
554
- &lt;/auro-counter&gt;
555
- &lt;auro-counter&gt;
556
- Counter 2
557
- &lt;/auro-counter&gt;
558
- &lt;/auro-counter-group&gt;</code></pre>
559
- <!-- AURO-GENERATED-CONTENT:END -->
560
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/appearance-inverse-snowflake.html) -->
561
- <!-- The below code snippet is automatically added from ./../apiExamples/appearance-inverse-snowflake.html -->
562
-
563
- <pre class="language-html"><code class="language-html">&lt;!-- Example of counter-group properties --&gt;
564
- &lt;auro-counter-group max="10" min="2" isDropdown layout="snowflake" appearance="inverse"&gt;
565
- &lt;span slot="ariaLabel.bib.close"&gt;Close Popup&lt;/span&gt;
566
- &lt;div slot="bib.fullscreen.headline"&gt;Group fullscreen label&lt;/div&gt;
567
- &lt;auro-icon slot="typeIcon" category="interface" name="account-stroke" customColor&gt;&lt;/auro-icon&gt;
568
- &lt;div slot="label"&gt;Snowflake Dropdown Group&lt;/div&gt;
569
- &lt;div slot="helpText"&gt;Total must be between 2-10&lt;/div&gt;
570
- &lt;auro-counter&gt;
571
- Counter 1
572
- &lt;/auro-counter&gt;
573
- &lt;auro-counter&gt;
574
- Counter 2
575
- &lt;/auro-counter&gt;
576
- &lt;/auro-counter-group&gt;</code></pre>
577
- <!-- AURO-GENERATED-CONTENT:END -->
578
- </auro-accordion>
579
-
580
- ### Counter Dropdown with Errored Counters
581
-
582
- A counter dropdown with individual counters in an errored state will display the errors for each errored counter by default.
583
-
584
- <div class="exampleWrapper">
585
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/dropdown-error.html) -->
586
- <!-- The below content is automatically added from ./../apiExamples/dropdown-error.html -->
587
- <auro-counter-group isDropdown>
588
- <span slot="ariaLabel.bib.close">Close Popup</span>
589
- <div slot="bib.fullscreen.headline">Passengers</div>
590
- <div slot="label">Passengers</div>
591
- <auro-counter error="Custom error on Adults counter">
592
- Adults
593
- <span slot="description">18 years or older</span>
594
- </auro-counter>
595
- <auro-counter error="Custom error on Children counter">
596
- Children
597
- <span slot="description">2-17 years</span>
598
- </auro-counter>
599
- </auro-counter-group>
600
- <!-- AURO-GENERATED-CONTENT:END -->
601
- </div>
602
- <auro-accordion alignRight>
603
- <span slot="trigger">See code</span>
604
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/dropdown-error.html) -->
605
- <!-- The below code snippet is automatically added from ./../apiExamples/dropdown-error.html -->
606
-
607
- <pre class="language-html"><code class="language-html">&lt;auro-counter-group isDropdown&gt;
608
- &lt;span slot="ariaLabel.bib.close"&gt;Close Popup&lt;/span&gt;
609
- &lt;div slot="bib.fullscreen.headline"&gt;Passengers&lt;/div&gt;
610
- &lt;div slot="label"&gt;Passengers&lt;/div&gt;
611
- &lt;auro-counter error="Custom error on Adults counter"&gt;
612
- Adults
613
- &lt;span slot="description"&gt;18 years or older&lt;/span&gt;
614
- &lt;/auro-counter&gt;
615
- &lt;auro-counter error="Custom error on Children counter"&gt;
616
- Children
617
- &lt;span slot="description"&gt;2-17 years&lt;/span&gt;
618
- &lt;/auro-counter&gt;
619
- &lt;/auro-counter-group&gt;</code></pre>
620
- <!-- AURO-GENERATED-CONTENT:END -->
621
- </auro-accordion>
622
-
623
- ### Counter Dropdown with Custom Error
624
-
625
- The `error` attribute can also be used on the counter group to set a custom error message. This will override any individual counter error messages.
626
-
627
- <div class="exampleWrapper">
628
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/dropdown-error-group.html) -->
629
- <!-- The below content is automatically added from ./../apiExamples/dropdown-error-group.html -->
630
- <auro-counter-group error="Custom error on counter group" isDropdown>
631
- <span slot="ariaLabel.bib.close">Close Popup</span>
632
- <div slot="bib.fullscreen.headline">Passengers</div>
633
- <div slot="label">Passengers</div>
634
- <auro-counter error="Custom error on Adults counter">
635
- Adults
636
- <span slot="description">18 years or older</span>
637
- </auro-counter>
638
- <auro-counter error="Custom error on Children counter">
639
- Children
640
- <span slot="description">2-17 years</span>
641
- </auro-counter>
642
- </auro-counter-group>
643
- <!-- AURO-GENERATED-CONTENT:END -->
644
- </div>
645
- <auro-accordion alignRight>
646
- <span slot="trigger">See code</span>
647
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/dropdown-error-group.html) -->
648
- <!-- The below code snippet is automatically added from ./../apiExamples/dropdown-error-group.html -->
649
-
650
- <pre class="language-html"><code class="language-html">&lt;auro-counter-group error="Custom error on counter group" isDropdown&gt;
651
- &lt;span slot="ariaLabel.bib.close"&gt;Close Popup&lt;/span&gt;
652
- &lt;div slot="bib.fullscreen.headline"&gt;Passengers&lt;/div&gt;
653
- &lt;div slot="label"&gt;Passengers&lt;/div&gt;
654
- &lt;auro-counter error="Custom error on Adults counter"&gt;
655
- Adults
656
- &lt;span slot="description"&gt;18 years or older&lt;/span&gt;
657
- &lt;/auro-counter&gt;
658
- &lt;auro-counter error="Custom error on Children counter"&gt;
659
- Children
660
- &lt;span slot="description"&gt;2-17 years&lt;/span&gt;
661
- &lt;/auro-counter&gt;
662
- &lt;/auro-counter-group&gt;</code></pre>
663
- <!-- AURO-GENERATED-CONTENT:END -->
664
- </auro-accordion>
665
-
666
- ### Group Max/Min
667
-
668
- The group counter `max` or `min` property sets the property for all counters in the group. If a counter has a `max` value set, the group `max` attribute will override it. All increment buttons as a result will be disabled to prevent the group of counters from exceeding the group `max`.
669
-
670
- **Example has group max set to 12**
671
-
672
- <div class="exampleWrapper">
673
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/group-max.html) -->
674
- <!-- The below content is automatically added from ./../apiExamples/group-max.html -->
675
- <auro-counter-group max="12" min="0">
676
- <auro-counter>
677
- Short label
678
- </auro-counter>
679
- <auro-counter>
680
- This is an example of the wrapping behavior for a long label
681
- </auro-counter>
682
- </auro-counter-group>
683
- <!-- AURO-GENERATED-CONTENT:END -->
684
- </div>
685
- <auro-accordion alignRight>
686
- <span slot="trigger">See code</span>
687
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/group-max.html) -->
688
- <!-- The below code snippet is automatically added from ./../apiExamples/group-max.html -->
689
-
690
- <pre class="language-html"><code class="language-html">&lt;auro-counter-group max="12" min="0"&gt;
691
- &lt;auro-counter&gt;
692
- Short label
693
- &lt;/auro-counter&gt;
694
- &lt;auro-counter&gt;
695
- This is an example of the wrapping behavior for a long label
696
- &lt;/auro-counter&gt;
697
- &lt;/auro-counter-group&gt;</code></pre>
698
- <!-- AURO-GENERATED-CONTENT:END -->
699
- </auro-accordion>
700
-
701
- ### Counter Max/Min within Group
702
-
703
- You can also individually set the `max` or `min` value for each counter in a group.
704
-
705
- **Example has group max set to 12**
706
-
707
- <div class="exampleWrapper">
708
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/group-counter-max.html) -->
709
- <!-- The below content is automatically added from ./../apiExamples/group-counter-max.html -->
710
- <auro-counter-group max="12" min="0">
711
- <auro-counter max="5">
712
- This counter has a max value of 5
713
- </auro-counter>
714
- <auro-counter max="8">
715
- This counter has a max value of 8
716
- </auro-counter>
717
- </auro-counter-group>
718
- <!-- AURO-GENERATED-CONTENT:END -->
719
- </div>
720
- <auro-accordion alignRight>
721
- <span slot="trigger">See code</span>
722
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/group-counter-max.html) -->
723
- <!-- The below code snippet is automatically added from ./../apiExamples/group-counter-max.html -->
724
-
725
- <pre class="language-html"><code class="language-html">&lt;auro-counter-group max="12" min="0"&gt;
726
- &lt;auro-counter max="5"&gt;
727
- This counter has a max value of 5
728
- &lt;/auro-counter&gt;
729
- &lt;auro-counter max="8"&gt;
730
- This counter has a max value of 8
731
- &lt;/auro-counter&gt;
732
- &lt;/auro-counter-group&gt;</code></pre>
733
- <!-- AURO-GENERATED-CONTENT:END -->
734
- </auro-accordion>
735
-
736
- ### Customized Bib Position
737
-
738
- The bib position can be customized with `placement`, `offset`, `flip`, `autoPlacement`, and `shift` attributes.
739
-
740
- - `placement` specifies the preferred position where the bib should appear relative to the trigger.
741
- - `offset` sets the distance between the trigger and the bib.
742
- - When `autoPlacement` is enabled, smart positioning logic is applied to determine the best placement for the bib. If all sides have sufficient space, the bib will appear in the position specified by `placement`.
743
- - Unless `noFlip` is enabled, if there isn't enough space for the preferred `placement`, the bib will automatically flip to an alternative position.
744
- - `shift` when enabled, adjusts the bib position when it would overflow the viewport boundaries, ensuring it remains visible.
745
-
746
- <div class="exampleWrapper">
747
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/floaterConfig.html) -->
748
- <!-- The below content is automatically added from ./../apiExamples/floaterConfig.html -->
749
- <div style="width: 350px">
750
- <auro-counter-group isDropdown offset="20" placement="bottom-end">
751
- <div slot="bib.fullscreen.headline">Passengers</div>
752
- <span slot="label">Label</span>
753
- <span slot="helpText">bottom-end bib with 20px offset</span>
754
- <auro-counter>
755
- Adults
756
- <span slot="description">18 years or older</span>
757
- </auro-counter>
758
- <auro-counter>
759
- Children
760
- <span slot="description">2-17 years</span>
761
- </auro-counter>
762
- </auro-counter-group>
763
- <auro-counter-group isDropdown offset="20" placement="bottom-end" noFlip>
764
- <div slot="bib.fullscreen.headline">Passengers</div>
765
- <span slot="label">Label</span>
766
- <span slot="helpText">bottom-end bib with 20px offset and noFlip</span>
767
- <auro-counter>
768
- Adults
769
- <span slot="description">18 years or older</span>
770
- </auro-counter>
771
- <auro-counter>
772
- Children
773
- <span slot="description">2-17 years</span>
774
- </auro-counter>
775
- </auro-counter-group>
776
- <auro-counter-group isDropdown offset="20" placement="right" noFlip autoPlacement>
777
- <div slot="bib.fullscreen.headline">Passengers</div>
778
- <span slot="label">Label</span>
779
- <span slot="helpText">right bib with 20px offset, noFlip and autoPlacement</span>
780
- <auro-counter>
781
- Adults
782
- <span slot="description">18 years or older</span>
783
- </auro-counter>
784
- <auro-counter>
785
- Children
786
- <span slot="description">2-17 years</span>
787
- </auro-counter>
788
- </auro-counter-group>
789
- <auro-counter-group width="350px" isDropdown offset="20" placement="bottom-start" shift noFlip>
790
- <div slot="bib.fullscreen.headline">Passengers</div>
791
- <span slot="label">Label</span>
792
- <span slot="helpText">bottom-start with 20px offset, noFlip and shift enabled</span>
793
- <auro-counter>
794
- Adults
795
- <span slot="description">18 years or older</span>
796
- </auro-counter>
797
- <auro-counter>
798
- Children
799
- <span slot="description">2-17 years</span>
800
- </auro-counter>
801
- </auro-counter-group>
802
- </div>
803
- <!-- AURO-GENERATED-CONTENT:END -->
804
- </div>
805
- <auro-accordion alignRight>
806
- <span slot="trigger">See code</span>
807
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/floaterConfig.html) -->
808
- <!-- The below code snippet is automatically added from ./../apiExamples/floaterConfig.html -->
809
-
810
- <pre class="language-html"><code class="language-html">&lt;div style="width: 350px"&gt;
811
- &lt;auro-counter-group isDropdown offset="20" placement="bottom-end"&gt;
812
- &lt;div slot="bib.fullscreen.headline"&gt;Passengers&lt;/div&gt;
813
- &lt;span slot="label"&gt;Label&lt;/span&gt;
814
- &lt;span slot="helpText"&gt;bottom-end bib with 20px offset&lt;/span&gt;
815
- &lt;auro-counter&gt;
816
- Adults
817
- &lt;span slot="description"&gt;18 years or older&lt;/span&gt;
818
- &lt;/auro-counter&gt;
819
- &lt;auro-counter&gt;
820
- Children
821
- &lt;span slot="description"&gt;2-17 years&lt;/span&gt;
822
- &lt;/auro-counter&gt;
823
- &lt;/auro-counter-group&gt;
824
- &lt;auro-counter-group isDropdown offset="20" placement="bottom-end" noFlip&gt;
825
- &lt;div slot="bib.fullscreen.headline"&gt;Passengers&lt;/div&gt;
826
- &lt;span slot="label"&gt;Label&lt;/span&gt;
827
- &lt;span slot="helpText"&gt;bottom-end bib with 20px offset and noFlip&lt;/span&gt;
828
- &lt;auro-counter&gt;
829
- Adults
830
- &lt;span slot="description"&gt;18 years or older&lt;/span&gt;
831
- &lt;/auro-counter&gt;
832
- &lt;auro-counter&gt;
833
- Children
834
- &lt;span slot="description"&gt;2-17 years&lt;/span&gt;
835
- &lt;/auro-counter&gt;
836
- &lt;/auro-counter-group&gt;
837
- &lt;auro-counter-group isDropdown offset="20" placement="right" noFlip autoPlacement&gt;
838
- &lt;div slot="bib.fullscreen.headline"&gt;Passengers&lt;/div&gt;
839
- &lt;span slot="label"&gt;Label&lt;/span&gt;
840
- &lt;span slot="helpText"&gt;right bib with 20px offset, noFlip and autoPlacement&lt;/span&gt;
841
- &lt;auro-counter&gt;
842
- Adults
843
- &lt;span slot="description"&gt;18 years or older&lt;/span&gt;
844
- &lt;/auro-counter&gt;
845
- &lt;auro-counter&gt;
846
- Children
847
- &lt;span slot="description"&gt;2-17 years&lt;/span&gt;
848
- &lt;/auro-counter&gt;
849
- &lt;/auro-counter-group&gt;
850
- &lt;auro-counter-group width="350px" isDropdown offset="20" placement="bottom-start" shift noFlip&gt;
851
- &lt;div slot="bib.fullscreen.headline"&gt;Passengers&lt;/div&gt;
852
- &lt;span slot="label"&gt;Label&lt;/span&gt;
853
- &lt;span slot="helpText"&gt;bottom-start with 20px offset, noFlip and shift enabled&lt;/span&gt;
854
- &lt;auro-counter&gt;
855
- Adults
856
- &lt;span slot="description"&gt;18 years or older&lt;/span&gt;
857
- &lt;/auro-counter&gt;
858
- &lt;auro-counter&gt;
859
- Children
860
- &lt;span slot="description"&gt;2-17 years&lt;/span&gt;
861
- &lt;/auro-counter&gt;
862
- &lt;/auro-counter-group&gt;
863
- &lt;/div&gt;</code></pre>
864
- <!-- AURO-GENERATED-CONTENT:END -->
865
- </auro-accordion>
866
-
867
- ### Dropdown with Fullscreen Bib
868
-
869
- You can make the dropdown open in fullscreen at a specific breakpoint by setting `fullscreenBreakpoint`.
870
-
871
- The default value of `fullscreenBreakpoint` is `sm`.
872
-
873
- Breakpoint token can be found [here](https://auro.alaskaair.com/getting-started/developers/design-tokens).
874
-
875
- To support fullscreen bib, setting the `bib.fullscreen.headline` slot is **REQUIRED**.
876
- You can also set `bib.fullscreen.footer` slot to add any additional options on fullscreen view.
877
-
878
- <div class="exampleWrapper">
879
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/dropdown-mobile-properties.html) -->
880
- <!-- The below content is automatically added from ./../apiExamples/dropdown-mobile-properties.html -->
881
- <div style="max-width: 350px;">
882
- <auro-counter-group id="dropdownCouterExample" isDropdown fullscreenBreakpoint="lg">
883
- <span slot="ariaLabel.bib.close">Close Popup</span>
884
- <span slot="label">Passengers</span>
885
- <span slot="bib.fullscreen.headline">Passengers</span>
886
- <div slot="helpText">This is help text</div>
887
- <auro-counter>
888
- Adults
889
- <span slot="description">18 years or older</span>
890
- </auro-counter>
891
- <auro-counter>
892
- Children
893
- <span slot="description">Under 17 years old. Restrictions apply if traveling without an adult.</span>
894
- </auro-counter>
895
- <auro-counter>
896
- Lap Infants
897
- <span slot="description">Under 2 years</span>
898
- </auro-counter>
899
- <div slot="bib.fullscreen.footer" style="display:flex; justify-content: stretch; gap: 1.5rem">
900
- <auro-button id="dropdownCounterExampleResetbutton" fluid variant="secondary" style="flex: 1 50%">Reset</auro-button>
901
- <auro-button id="dropdownCounterExampleSavebutton" fluid style="flex: 1 50%">Save</auro-button>
902
- </div>
903
- </auro-counter-group>
904
- </div>
905
- <!-- AURO-GENERATED-CONTENT:END -->
906
- </div>
907
- <auro-accordion alignRight>
908
- <span slot="trigger">See code</span>
909
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/dropdown-mobile-properties.html) -->
910
- <!-- The below code snippet is automatically added from ./../apiExamples/dropdown-mobile-properties.html -->
911
-
912
- <pre class="language-html"><code class="language-html">&lt;div style="max-width: 350px;"&gt;
913
- &lt;auro-counter-group id="dropdownCouterExample" isDropdown fullscreenBreakpoint="lg"&gt;
914
- &lt;span slot="ariaLabel.bib.close"&gt;Close Popup&lt;/span&gt;
915
- &lt;span slot="label"&gt;Passengers&lt;/span&gt;
916
- &lt;span slot="bib.fullscreen.headline"&gt;Passengers&lt;/span&gt;
917
- &lt;div slot="helpText"&gt;This is help text&lt;/div&gt;
918
- &lt;auro-counter&gt;
919
- Adults
920
- &lt;span slot="description"&gt;18 years or older&lt;/span&gt;
921
- &lt;/auro-counter&gt;
922
- &lt;auro-counter&gt;
923
- Children
924
- &lt;span slot="description"&gt;Under 17 years old. Restrictions apply if traveling without an adult.&lt;/span&gt;
925
- &lt;/auro-counter&gt;
926
- &lt;auro-counter&gt;
927
- Lap Infants
928
- &lt;span slot="description"&gt;Under 2 years&lt;/span&gt;
929
- &lt;/auro-counter&gt;
930
- &lt;div slot="bib.fullscreen.footer" style="display:flex; justify-content: stretch; gap: 1.5rem"&gt;
931
- &lt;auro-button id="dropdownCounterExampleResetbutton" fluid variant="secondary" style="flex: 1 50%"&gt;Reset&lt;/auro-button&gt;
932
- &lt;auro-button id="dropdownCounterExampleSavebutton" fluid style="flex: 1 50%"&gt;Save&lt;/auro-button&gt;
933
- &lt;/div&gt;
934
- &lt;/auro-counter-group&gt;
935
- &lt;/div&gt;</code></pre>
936
- <!-- AURO-GENERATED-CONTENT:END -->
937
- </auro-accordion>
938
-
939
- ## Counter Group Slot Examples
940
-
941
- ### Display Value
942
-
943
- Use the `valueText` slot to customize the value display in the dropdown trigger.
944
-
945
- <div class="exampleWrapper">
946
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/dropdown-value-text.html) -->
947
- <!-- The below content is automatically added from ./../apiExamples/dropdown-value-text.html -->
948
- <div style="max-width: 350px;">
949
- <auro-counter-group isDropdown>
950
- <span slot="ariaLabel.bib.close">Close Popup</span>
951
- <span slot="bib.fullscreen.headline">Passengers</span>
952
- <div slot="valueText">Custom value text</div>
953
- <div slot="label"></div>
954
- <auro-counter>
955
- Adults
956
- <span slot="description">18 years or older</span>
957
- </auro-counter>
958
- <auro-counter>
959
- Children
960
- <span slot="description">Under 17 years old. Restrictions apply if traveling without an adult.</span>
961
- </auro-counter>
962
- <auro-counter>
963
- Lap Infants
964
- <span slot="description">Under 2 years</span>
965
- </auro-counter>
966
- </auro-counter-group>
967
- </div>
968
- <!-- AURO-GENERATED-CONTENT:END -->
969
- </div>
970
- <auro-accordion alignRight>
971
- <span slot="trigger">See code</span>
972
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/dropdown-value-text.html) -->
973
- <!-- The below code snippet is automatically added from ./../apiExamples/dropdown-value-text.html -->
974
-
975
- <pre class="language-html"><code class="language-html">&lt;div style="max-width: 350px;"&gt;
976
- &lt;auro-counter-group isDropdown&gt;
977
- &lt;span slot="ariaLabel.bib.close"&gt;Close Popup&lt;/span&gt;
978
- &lt;span slot="bib.fullscreen.headline"&gt;Passengers&lt;/span&gt;
979
- &lt;div slot="valueText"&gt;Custom value text&lt;/div&gt;
980
- &lt;div slot="label"&gt;&lt;/div&gt;
981
- &lt;auro-counter&gt;
982
- Adults
983
- &lt;span slot="description"&gt;18 years or older&lt;/span&gt;
984
- &lt;/auro-counter&gt;
985
- &lt;auro-counter&gt;
986
- Children
987
- &lt;span slot="description"&gt;Under 17 years old. Restrictions apply if traveling without an adult.&lt;/span&gt;
988
- &lt;/auro-counter&gt;
989
- &lt;auro-counter&gt;
990
- Lap Infants
991
- &lt;span slot="description"&gt;Under 2 years&lt;/span&gt;
992
- &lt;/auro-counter&gt;
993
- &lt;/auro-counter-group&gt;
994
- &lt;/div&gt;</code></pre>
995
- <!-- AURO-GENERATED-CONTENT:END -->
996
- </auro-accordion>
997
-
998
- ## Event Examples
999
-
1000
- ### Input Event
1001
-
1002
- Listen for `input` events to react to user interactions. Open the browser console to see the event output.
1003
-
1004
- This event fires both on individual counter changes and when the counter group value changes. The event detail contains the current values of all counters in the group.
1005
-
1006
- <div class="exampleWrapper">
1007
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/events.html) -->
1008
- <!-- The below content is automatically added from ./../apiExamples/events.html -->
1009
- <auro-counter-group id="eventExample">
1010
- <auro-counter>
1011
- Adults
1012
- </auro-counter>
1013
- <auro-counter>
1014
- Children
1015
- </auro-counter>
1016
- </auro-counter-group>
1017
- <!-- AURO-GENERATED-CONTENT:END -->
1018
- </div>
1019
- <auro-accordion alignRight>
1020
- <span slot="trigger">See code</span>
1021
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/events.html) -->
1022
- <!-- The below code snippet is automatically added from ./../apiExamples/events.html -->
1023
-
1024
- <pre class="language-html"><code class="language-html">&lt;auro-counter-group id="eventExample"&gt;
1025
- &lt;auro-counter&gt;
1026
- Adults
1027
- &lt;/auro-counter&gt;
1028
- &lt;auro-counter&gt;
1029
- Children
1030
- &lt;/auro-counter&gt;
1031
- &lt;/auro-counter-group&gt;</code></pre>
1032
- <!-- AURO-GENERATED-CONTENT:END -->
1033
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/events.js) -->
1034
- <!-- The below code snippet is automatically added from ./../apiExamples/events.js -->
1035
-
1036
- <pre class="language-js"><code class="language-js">export function eventCounterExample() {
1037
- const counter = document.getElementById('eventExample');
1038
-
1039
- counter.addEventListener('input', (event) =&gt; {
1040
- console.log(`Values updated: ${JSON.stringify(event.detail)}`);
1041
- });
1042
- }</code></pre>
1043
- <!-- AURO-GENERATED-CONTENT:END -->
1044
- </auro-accordion>
1045
-
1046
- ## Common Usage Patterns & Functional Examples
1047
-
1048
- ### All Counter Properties
1049
-
1050
- This example demonstrates the use of all available counter properties.
1051
-
1052
- <div class="exampleWrapper">
1053
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/api-properties.html) -->
1054
- <!-- The below content is automatically added from ./../apiExamples/api-properties.html -->
1055
- <!-- Example of all counter properties -->
1056
- <auro-counter-group>
1057
- <!-- Basic counter with min/max -->
1058
- <auro-counter min="1" max="5" value="2">
1059
- Min 1, Max 5
1060
- </auro-counter>
1061
- <!-- Disabled counter -->
1062
- <auro-counter disabled value="0">
1063
- Disabled counter
1064
- </auro-counter>
1065
- </auro-counter-group>
1066
- <!-- AURO-GENERATED-CONTENT:END -->
1067
- </div>
1068
- <auro-accordion alignRight>
1069
- <span slot="trigger">See code</span>
1070
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/api-properties.html) -->
1071
- <!-- The below code snippet is automatically added from ./../apiExamples/api-properties.html -->
1072
-
1073
- <pre class="language-html"><code class="language-html">&lt;!-- Example of all counter properties --&gt;
1074
- &lt;auro-counter-group&gt;
1075
- &lt;!-- Basic counter with min/max --&gt;
1076
- &lt;auro-counter min="1" max="5" value="2"&gt;
1077
- Min 1, Max 5
1078
- &lt;/auro-counter&gt;
1079
- &lt;!-- Disabled counter --&gt;
1080
- &lt;auro-counter disabled value="0"&gt;
1081
- Disabled counter
1082
- &lt;/auro-counter&gt;
1083
- &lt;/auro-counter-group&gt;</code></pre>
1084
- <!-- AURO-GENERATED-CONTENT:END -->
1085
- </auro-accordion>
1086
-
1087
- ### All Counter Group Properties
1088
-
1089
- This example demonstrates the use of all available counter group properties.
1090
-
1091
- <div class="exampleWrapper">
1092
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/api-group-properties.html) -->
1093
- <!-- The below content is automatically added from ./../apiExamples/api-group-properties.html -->
1094
- <!-- Example of counter-group properties -->
1095
- <auro-counter-group max="10" min="2" isDropdown>
1096
- <div slot="bib.fullscreen.headline">Group fullscreen label</div>
1097
- <div slot="label">Group with all properties</div>
1098
- <div slot="helpText">Total must be between 2-10</div>
1099
- <div slot="valueText">Custom total display</div>
1100
- <auro-counter>
1101
- Counter 1
1102
- </auro-counter>
1103
- <auro-counter>
1104
- Counter 2
1105
- </auro-counter>
1106
- </auro-counter-group>
1107
- <!-- AURO-GENERATED-CONTENT:END -->
1108
- </div>
1109
- <auro-accordion alignRight>
1110
- <span slot="trigger">See code</span>
1111
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/api-group-properties.html) -->
1112
- <!-- The below code snippet is automatically added from ./../apiExamples/api-group-properties.html -->
1113
-
1114
- <pre class="language-html"><code class="language-html">&lt;!-- Example of counter-group properties --&gt;
1115
- &lt;auro-counter-group max="10" min="2" isDropdown&gt;
1116
- &lt;div slot="bib.fullscreen.headline"&gt;Group fullscreen label&lt;/div&gt;
1117
- &lt;div slot="label"&gt;Group with all properties&lt;/div&gt;
1118
- &lt;div slot="helpText"&gt;Total must be between 2-10&lt;/div&gt;
1119
- &lt;div slot="valueText"&gt;Custom total display&lt;/div&gt;
1120
- &lt;auro-counter&gt;
1121
- Counter 1
1122
- &lt;/auro-counter&gt;
1123
- &lt;auro-counter&gt;
1124
- Counter 2
1125
- &lt;/auro-counter&gt;
1126
- &lt;/auro-counter-group&gt;</code></pre>
1127
- <!-- AURO-GENERATED-CONTENT:END -->
1128
- </auro-accordion>
1129
-
1130
- ### All Slots
1131
-
1132
- All available slots for both components.
1133
-
1134
- <div class="exampleWrapper">
1135
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/api-slots.html) -->
1136
- <!-- The below content is automatically added from ./../apiExamples/api-slots.html -->
1137
- <!-- Example of all available slots -->
1138
- <auro-counter-group isDropdown>
1139
- <!-- Group slots -->
1140
- <div slot="label">Group with all slots</div>
1141
- <div slot="bib.fullscreen.headline">Group fullscreen label</div>
1142
- <div slot="helpText">Help text appears below the group</div>
1143
- <div slot="valueText">Custom value display</div>
1144
- <!-- Counter with all slots -->
1145
- <auro-counter>
1146
- Default slot content
1147
- <span slot="ariaLabel.minus">Custom Minus Button Label</span>
1148
- <span slot="ariaLabel.plus">Custom Plus Button Label</span>
1149
- <span slot="description">Description slot content</span>
1150
- </auro-counter>
1151
- </auro-counter-group>
1152
- <!-- AURO-GENERATED-CONTENT:END -->
1153
- </div>
1154
- <auro-accordion alignRight>
1155
- <span slot="trigger">See code</span>
1156
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/api-slots.html) -->
1157
- <!-- The below code snippet is automatically added from ./../apiExamples/api-slots.html -->
1158
-
1159
- <pre class="language-html"><code class="language-html">&lt;!-- Example of all available slots --&gt;
1160
- &lt;auro-counter-group isDropdown&gt;
1161
- &lt;!-- Group slots --&gt;
1162
- &lt;div slot="label"&gt;Group with all slots&lt;/div&gt;
1163
- &lt;div slot="bib.fullscreen.headline"&gt;Group fullscreen label&lt;/div&gt;
1164
- &lt;div slot="helpText"&gt;Help text appears below the group&lt;/div&gt;
1165
- &lt;div slot="valueText"&gt;Custom value display&lt;/div&gt;
1166
- &lt;!-- Counter with all slots --&gt;
1167
- &lt;auro-counter&gt;
1168
- Default slot content
1169
- &lt;span slot="ariaLabel.minus"&gt;Custom Minus Button Label&lt;/span&gt;
1170
- &lt;span slot="ariaLabel.plus"&gt;Custom Plus Button Label&lt;/span&gt;
1171
- &lt;span slot="description"&gt;Description slot content&lt;/span&gt;
1172
- &lt;/auro-counter&gt;
1173
- &lt;/auro-counter-group&gt;</code></pre>
1174
- <!-- AURO-GENERATED-CONTENT:END -->
1175
- </auro-accordion>
1176
-
1177
- ### Counter Group in Dialog
1178
-
1179
- The element used within an `auro-dialog`.
1180
-
1181
- <div class="exampleWrapper">
1182
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/in-dialog.html) -->
1183
- <!-- The below content is automatically added from ./../apiExamples/in-dialog.html -->
1184
- <div>
1185
- <auro-button id="counter-dialog-opener">Counter Group in Dialog</auro-button>
1186
- <auro-dialog id="counter-dialog">
1187
- <span slot="header">Counter Group in Dialog</span>
1188
- <div slot="content">
1189
- <auro-counter-group isDropdown>
1190
- <span slot="ariaLabel.bib.close">Close Popup</span>
1191
- <div slot="bib.fullscreen.headline">Group fullscreen label</div>
1192
- <div slot="label">Counter Group</div>
1193
- <div slot="helpText">Select a value</div>
1194
- <auro-counter>Counter 1</auro-counter>
1195
- <auro-counter>Counter 2</auro-counter>
1196
- </auro-counter-group>
1197
- </div>
1198
- </auro-dialog>
1199
- </div>
1200
- <!-- AURO-GENERATED-CONTENT:END -->
1201
- </div>
1202
- <auro-accordion alignRight>
1203
- <span slot="trigger">See code</span>
1204
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/in-dialog.html) -->
1205
- <!-- The below code snippet is automatically added from ./../apiExamples/in-dialog.html -->
1206
-
1207
- <pre class="language-html"><code class="language-html">&lt;div&gt;
1208
- &lt;auro-button id="counter-dialog-opener"&gt;Counter Group in Dialog&lt;/auro-button&gt;
1209
- &lt;auro-dialog id="counter-dialog"&gt;
1210
- &lt;span slot="header"&gt;Counter Group in Dialog&lt;/span&gt;
1211
- &lt;div slot="content"&gt;
1212
- &lt;auro-counter-group isDropdown&gt;
1213
- &lt;span slot="ariaLabel.bib.close"&gt;Close Popup&lt;/span&gt;
1214
- &lt;div slot="bib.fullscreen.headline"&gt;Group fullscreen label&lt;/div&gt;
1215
- &lt;div slot="label"&gt;Counter Group&lt;/div&gt;
1216
- &lt;div slot="helpText"&gt;Select a value&lt;/div&gt;
1217
- &lt;auro-counter&gt;Counter 1&lt;/auro-counter&gt;
1218
- &lt;auro-counter&gt;Counter 2&lt;/auro-counter&gt;
1219
- &lt;/auro-counter-group&gt;
1220
- &lt;/div&gt;
1221
- &lt;/auro-dialog&gt;
1222
- &lt;/div&gt;</code></pre>
1223
- <!-- AURO-GENERATED-CONTENT:END -->
1224
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/in-dialog.js) -->
1225
- <!-- The below code snippet is automatically added from ./../apiExamples/in-dialog.js -->
1226
-
1227
- <pre class="language-js"><code class="language-js">export function inDialogExample() {
1228
- document.querySelector("#counter-dialog-opener").addEventListener("click", () =&gt; {
1229
- const dialog = document.querySelector("#counter-dialog");
1230
- dialog.open = true;
1231
- });
1232
- };</code></pre>
1233
- <!-- AURO-GENERATED-CONTENT:END -->
1234
- </auro-accordion>
1235
-
1236
- ### Counter Group in Drawer
1237
-
1238
- The element used within an `auro-drawer`.
1239
-
1240
- <div class="exampleWrapper">
1241
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/in-drawer.html) -->
1242
- <!-- The below content is automatically added from ./../apiExamples/in-drawer.html -->
1243
- <div>
1244
- <auro-button id="counter-drawer-opener">Counter Group in Drawer</auro-button>
1245
- <auro-drawer id="counter-drawer">
1246
- <span slot="header">Counter Group in Drawer</span>
1247
- <div slot="content">
1248
- <auro-counter-group isDropdown>
1249
- <span slot="ariaLabel.bib.close">Close Popup</span>
1250
- <div slot="bib.fullscreen.headline">Group fullscreen label</div>
1251
- <div slot="label">Counter Group</div>
1252
- <div slot="helpText">Select a value</div>
1253
- <auro-counter>Counter 1</auro-counter>
1254
- <auro-counter>Counter 2</auro-counter>
1255
- </auro-counter-group>
1256
- </div>
1257
- </auro-drawer>
1258
- </div>
1259
- <!-- AURO-GENERATED-CONTENT:END -->
1260
- </div>
1261
- <auro-accordion alignRight>
1262
- <span slot="trigger">See code</span>
1263
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/in-drawer.html) -->
1264
- <!-- The below code snippet is automatically added from ./../apiExamples/in-drawer.html -->
1265
-
1266
- <pre class="language-html"><code class="language-html">&lt;div&gt;
1267
- &lt;auro-button id="counter-drawer-opener"&gt;Counter Group in Drawer&lt;/auro-button&gt;
1268
- &lt;auro-drawer id="counter-drawer"&gt;
1269
- &lt;span slot="header"&gt;Counter Group in Drawer&lt;/span&gt;
1270
- &lt;div slot="content"&gt;
1271
- &lt;auro-counter-group isDropdown&gt;
1272
- &lt;span slot="ariaLabel.bib.close"&gt;Close Popup&lt;/span&gt;
1273
- &lt;div slot="bib.fullscreen.headline"&gt;Group fullscreen label&lt;/div&gt;
1274
- &lt;div slot="label"&gt;Counter Group&lt;/div&gt;
1275
- &lt;div slot="helpText"&gt;Select a value&lt;/div&gt;
1276
- &lt;auro-counter&gt;Counter 1&lt;/auro-counter&gt;
1277
- &lt;auro-counter&gt;Counter 2&lt;/auro-counter&gt;
1278
- &lt;/auro-counter-group&gt;
1279
- &lt;/div&gt;
1280
- &lt;/auro-drawer&gt;
1281
- &lt;/div&gt;</code></pre>
1282
- <!-- AURO-GENERATED-CONTENT:END -->
1283
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/in-drawer.js) -->
1284
- <!-- The below code snippet is automatically added from ./../apiExamples/in-drawer.js -->
1285
-
1286
- <pre class="language-js"><code class="language-js">export function inDrawerExample() {
1287
- document.querySelector("#counter-drawer-opener").addEventListener("click", () =&gt; {
1288
- const drawer = document.querySelector("#counter-drawer");
1289
- if (drawer.hasAttribute('open')) {
1290
- drawer.removeAttribute('open');
1291
- } else {
1292
- drawer.setAttribute('open', true);
1293
- }
1294
- });
1295
- };</code></pre>
1296
- <!-- AURO-GENERATED-CONTENT:END -->
1297
- </auro-accordion>
1298
-
1299
- ## Restyle Component with CSS Variables
1300
-
1301
- The component may be restyled by changing the values of the following token(s).
1302
-
1303
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../src/styles/tokens.scss) -->
1304
- <!-- The below code snippet is automatically added from ./../src/styles/tokens.scss -->
1305
-
1306
- <pre class="language-scss"><code class="language-scss">@use "@aurodesignsystem/design-tokens/dist/themes/alaska/SCSSVariables--alaska" as v;
1307
-
1308
- :host(:not([ondark])),
1309
- :host(:not([appearance="inverse"])) {
1310
- /* Snowflake Dropdown Tokens */
1311
- --ds-auro-counter-border-color: var(--ds-basic-color-border-bold, #{v.$ds-basic-color-border-bold});
1312
- --ds-auro-counter-background-color: var(--ds-basic-color-surface-default, #{v.$ds-basic-color-surface-default});
1313
- --ds-auro-counter-label-text-color: var(--ds-basic-color-texticon-muted, #{v.$ds-basic-color-texticon-muted});
1314
- --ds-auro-counter-placeholder-text-color: var(--ds-basic-color-texticon-default, #{v.$ds-basic-color-texticon-default});
1315
- --ds-auro-counter-text-color: var(--ds-basic-color-texticon-default, #{v.$ds-basic-color-texticon-default});
1316
- --ds-auro-counter-error-icon-color: var(--ds-basic-color-status-error, #{v.$ds-basic-color-status-error});
1317
- --ds-auro-counter-outline-color: transparent;
1318
-
1319
- /* Classic Tokens */
1320
- --ds-auro-counter-control-background-color: var(--ds-advanced-color-button-tertiary-background, #{v.$ds-advanced-color-button-tertiary-background});
1321
- --ds-auro-counter-control-border-color: var(--ds-advanced-color-state-focused, #{v.$ds-advanced-color-state-focused});
1322
- --ds-auro-counter-description-text-color: var(--ds-basic-color-texticon-muted, #{v.$ds-basic-color-texticon-muted});
1323
- --ds-auro-counter-icon-color: var(--ds-advanced-color-button-tertiary-text, #{v.$ds-advanced-color-button-tertiary-text});
1324
- --ds-auro-counter-quantity-text-color: var(--ds-basic-color-texticon-default, #{v.$ds-basic-color-texticon-default});
1325
- --ds-auro-counter-divider-color: var(--ds-basic-color-border-divider, #{v.$ds-basic-color-border-divider});
1326
- }
1327
-
1328
- :host([ondark]),
1329
- :host([appearance="inverse"]) {
1330
- /* Snowflake Dropdown Tokens */
1331
- --ds-auro-counter-border-color: var(--ds-basic-color-border-inverse, #{v.$ds-basic-color-border-inverse});
1332
- --ds-auro-counter-background-color: var(--ds-advanced-color-shared-background-inverse, #{v.$ds-advanced-color-shared-background-inverse});
1333
- --ds-auro-counter-label-text-color: var(--ds-basic-color-texticon-inverse-muted, #{v.$ds-basic-color-texticon-inverse-muted});
1334
- --ds-auro-counter-placeholder-text-color: var(--ds-basic-color-texticon-inverse, #{v.$ds-basic-color-texticon-inverse});
1335
- --ds-auro-counter-text-color: var(--ds-basic-color-texticon-inverse, #{v.$ds-basic-color-texticon-inverse});
1336
- --ds-auro-counter-error-icon-color: var(--ds-advanced-color-state-error-inverse, #{v.$ds-advanced-color-state-error-inverse});
1337
- --ds-auro-counter-outline-color: transparent;
1338
-
1339
- /* Classic Tokens */
1340
- --ds-auro-counter-control-background-color: var(--ds-advanced-color-button-tertiary-background-inverse, #{v.$ds-advanced-color-button-tertiary-background-inverse});
1341
- --ds-auro-counter-control-border-color: var(--ds-advanced-color-state-focused-inverse, #{v.$ds-advanced-color-state-focused-inverse});
1342
- --ds-auro-counter-description-text-color: var(--ds-basic-color-texticon-muted, #{v.$ds-basic-color-texticon-muted});
1343
- --ds-auro-counter-icon-color: var(--ds-advanced-color-button-tertiary-text-inverse, #{v.$ds-advanced-color-button-tertiary-text-inverse});
1344
- --ds-auro-counter-quantity-text-color: var(--ds-basic-color-texticon-default, #{v.$ds-basic-color-texticon-default});
1345
- --ds-auro-counter-divider-color: var(--ds-basic-color-border-divider-inverse, #{v.$ds-basic-color-border-divider-inverse});
1346
- }</code></pre>
93
+ | `ariaLabel.plus` | Accessible label for the increment button. |
94
+ | `default` | Main label content for the counter. |
95
+ | `description` | Descriptive content for the counter. |
96
+ | `helpText` | Help text content for the counter. |
1347
97
  <!-- AURO-GENERATED-CONTENT:END -->