@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,57 +8,57 @@ The `auro-select` element is a wrapper for auro-dropdown and auro-menu to create
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
- | [autocomplete](#autocomplete) | `autocomplete` | `string` | | If declared, sets the autocomplete attribute for the select element. |
15
- | [disabled](#disabled) | `disabled` | `boolean` | | When attribute is present, element shows disabled state. |
16
- | [error](#error) | `error` | `string` | | When defined, sets persistent validity to `customError` and sets `setCustomValidity` = attribute value. |
17
- | [flexMenuWidth](#flexMenuWidth) | `flexMenuWidth` | `boolean` | | If declared, make the width of the bib match the width of the content, rather than the trigger. |
18
- | [fluid](#fluid) | `fluid` | `boolean` | | When attribute is present, element will be 100% width of container element. |
19
- | [forceDisplayValue](#forceDisplayValue) | `forceDisplayValue` | `boolean` | false | If declared, the label and value will be visually hidden and the displayValue will render 100% of the time. |
20
- | [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. |
21
- | [largeFullscreenHeadline](#largeFullscreenHeadline) | `largeFullscreenHeadline` | `boolean` | | If declared, make bib.fullscreen.headline in HeadingDisplay.<br />Otherwise, Heading 600. |
22
- | [layout](#layout) | `layout` | `'classic' \| 'emphasized' \| 'snowflake'` | "'classic'" | Determines the overall layout of the select component. |
23
- | [matchWidth](#matchWidth) | `matchWidth` | `boolean` | false | If declared, the popover and trigger will be set to the same width. |
24
- | [multiSelect](#multiSelect) | `multiselect` | `boolean` | | Sets multi-select mode, allowing multiple options to be selected at once. |
25
- | [name](#name) | `name` | `string` | | The name for the select element. |
26
- | [noCheckmark](#noCheckmark) | `noCheckmark` | `boolean` | | When true, checkmark on selected option will no longer be present. |
27
- | [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`. |
28
- | [noValidate](#noValidate) | `noValidate` | `boolean` | | If set, disables auto-validation on blur. |
29
- | [offset](#offset) | `offset` | `number` | "0" | Gap between the trigger element and bib. |
30
- | [onDark](#onDark) | `onDark` | `boolean` | | DEPRECATED - use `appearance="inverse"` instead. |
31
- | [optionSelected](#optionSelected) | `optionSelected` | `HTMLElement\|Array<HTMLElement>` | | Specifies the current selected menuOption. Default type is `HTMLElement`, changing to `Array<HTMLElement>` when `multiSelect` is true. |
32
- | [placeholder](#placeholder) | `placeholder` | `string` | | Define custom placeholder text. |
33
- | [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. |
34
- | [required](#required) | `required` | `boolean` | | Populates the `required` attribute on the element. Used for client-side validation. |
35
- | [setCustomValidity](#setCustomValidity) | `setCustomValidity` | `string` | | Sets a custom help text message to display for all validityStates. |
36
- | [setCustomValidityCustomError](#setCustomValidityCustomError) | `setCustomValidityCustomError` | `string` | | Custom help text message to display when validity = `customError`. |
37
- | [setCustomValidityValueMissing](#setCustomValidityValueMissing) | `setCustomValidityValueMissing` | `string` | | Custom help text message to display when validity = `valueMissing`. |
38
- | [shape](#shape) | `shape` | `'classic' \| 'pill' \| 'pill-left' \| 'pill-right' \| 'snowflake'` | | Determines the shape of the dropdown bib. |
39
- | [shift](#shift) | `shift` | `boolean` | false | If set, the dropdown will shift its position to avoid being cut off by the viewport. |
40
- | [size](#size) | `size` | `'lg' \| 'xl'` | | Determines the size of the dropdown bib. Only the `emphasized` layout supports size=`xl`, while all other layouts support size=`lg`. |
41
- | [validity](#validity) | `validity` | `string` | | Specifies the `validityState` this element is in. |
42
- | [value](#value) | `value` | `string` | | Value selected for the component. |
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
+ | `autocomplete` | `autocomplete` | `string` | | If declared, sets the autocomplete attribute for the select element. |
15
+ | `disabled` | `disabled` | `boolean` | | When attribute is present, element shows disabled state. |
16
+ | `error` | `error` | `string` | | When defined, sets persistent validity to `customError` and sets `setCustomValidity` = attribute value. |
17
+ | `flexMenuWidth` | `flexMenuWidth` | `boolean` | | If declared, make the width of the bib match the width of the content, rather than the trigger. |
18
+ | `fluid` | `fluid` | `boolean` | | When attribute is present, element will be 100% width of container element. |
19
+ | `forceDisplayValue` | `forceDisplayValue` | `boolean` | false | If declared, the label and value will be visually hidden and the displayValue will render 100% of the time. |
20
+ | `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. |
21
+ | `largeFullscreenHeadline` | `largeFullscreenHeadline` | `boolean` | | If declared, make bib.fullscreen.headline in HeadingDisplay.<br />Otherwise, Heading 600. |
22
+ | `layout` | `layout` | `'classic' \| 'emphasized' \| 'snowflake'` | "'classic'" | Determines the overall layout of the select component. |
23
+ | `matchWidth` | `matchWidth` | `boolean` | false | If declared, the popover and trigger will be set to the same width. |
24
+ | `multiSelect` | `multiselect` | `boolean` | | Sets multi-select mode, allowing multiple options to be selected at once. |
25
+ | `name` | `name` | `string` | | The name for the select element. |
26
+ | `noCheckmark` | `noCheckmark` | `boolean` | | When true, checkmark on selected option will no longer be present. |
27
+ | `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`. |
28
+ | `noValidate` | `noValidate` | `boolean` | | If set, disables auto-validation on blur. |
29
+ | `offset` | `offset` | `number` | "0" | Gap between the trigger element and bib. |
30
+ | `onDark` | `onDark` | `boolean` | | DEPRECATED - use `appearance="inverse"` instead. |
31
+ | `optionSelected` | `optionSelected` | `HTMLElement\|Array<HTMLElement>` | | Specifies the current selected menuOption. Default type is `HTMLElement`, changing to `Array<HTMLElement>` when `multiSelect` is true. |
32
+ | `placeholder` | `placeholder` | `string` | | Define custom placeholder text. |
33
+ | `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. |
34
+ | `required` | `required` | `boolean` | | Populates the `required` attribute on the element. Used for client-side validation. |
35
+ | `setCustomValidity` | `setCustomValidity` | `string` | | Sets a custom help text message to display for all validityStates. |
36
+ | `setCustomValidityCustomError` | `setCustomValidityCustomError` | `string` | | Custom help text message to display when validity = `customError`. |
37
+ | `setCustomValidityValueMissing` | `setCustomValidityValueMissing` | `string` | | Custom help text message to display when validity = `valueMissing`. |
38
+ | `shape` | `shape` | `'classic' \| 'pill' \| 'pill-left' \| 'pill-right' \| 'snowflake'` | | Determines the shape of the dropdown bib. |
39
+ | `shift` | `shift` | `boolean` | false | If set, the dropdown will shift its position to avoid being cut off by the viewport. |
40
+ | `size` | `size` | `'lg' \| 'xl'` | | Determines the size of the dropdown bib. Only the `emphasized` layout supports size=`xl`, while all other layouts support size=`lg`. |
41
+ | `validity` | `validity` | `string` | | Specifies the `validityState` this element is in. |
42
+ | `value` | `value` | `string` | | Value selected for the component. |
43
43
 
44
44
  ## Methods
45
45
 
46
46
  | Method | Type | Description |
47
- |----------------------|----------------------------------------|--------------------------------------------------|
48
- | [hideBib](#hideBib) | `(): void` | Hides the dropdown bib if its open. |
49
- | [reset](#reset) | `(): void` | Resets component to initial state. |
50
- | [setMenuValue](#setMenuValue) | `(value: any): void` | |
51
- | [showBib](#showBib) | `(): void` | Shows the dropdown bib if there are options to show. |
52
- | [updateActiveOption](#updateActiveOption) | `(index: number): void` | Updates the active option in the menu.<br /><br />**index**: Index of the option to make active. |
53
- | [validate](#validate) | `(force?: boolean \| undefined): void` | Validates value.<br /><br />**force**: Whether to force validation. |
47
+ |----------------------|----------------------------------------|--------------------------------------------------|
48
+ | `hideBib` | `(): void` | Hides the dropdown bib if its open. |
49
+ | `reset` | `(): void` | Resets component to initial state. |
50
+ | `setMenuValue` | `(value: any): void` | |
51
+ | `showBib` | `(): void` | Shows the dropdown bib if there are options to show. |
52
+ | `updateActiveOption` | `(index: number): void` | Updates the active option in the menu.<br /><br />**index**: Index of the option to make active. |
53
+ | `validate` | `(force?: boolean \| undefined): void` | Validates value.<br /><br />**force**: Whether to force validation. |
54
54
 
55
55
  ## Events
56
56
 
57
57
  | Event | Type | Description |
58
58
  |-----------------------------|--------------------------------------------------|--------------------------------------------------|
59
59
  | `auroFormElement-validated` | | Notifies that the `validity` and `errorMessage` values have changed. |
60
- | `auroSelect-valueSet` | `CustomEvent<any>` | Notifies that the component has a new value set. |
61
- | [input](#input) | `CustomEvent<{ optionSelected: any; value: any; }>` | Notifies every time the value prop of the element is changed. The updated `value` and `optionSelected` will be delivered in `detail` object. |
60
+ | `auroSelect-valueSet` | `CustomEvent<any>` | Notifies that the component has a new value set. |
61
+ | `input` | `CustomEvent<{ optionSelected: any; value: any; }>` | Notifies every time the value prop of the element is changed. The updated `value` and `optionSelected` will be delivered in `detail` object. |
62
62
 
63
63
  ## Slots
64
64
 
@@ -66,2309 +66,19 @@ The `auro-select` element is a wrapper for auro-dropdown and auro-menu to create
66
66
  |---------------------------|--------------------------------------------------|
67
67
  | | Default slot for the menu content. |
68
68
  | `ariaLabel.bib.close` | Sets aria-label on close button in fullscreen bib |
69
- | `bib.fullscreen.headline` | Defines the headline to display above menu-options |
70
- | [displayValue](#displayValue) | Allows custom HTML content to display the selected value when select is not focused. |
71
- | [helpText](#helpText) | Defines the content of the helpText. |
72
- | [label](#label) | Defines the content of the label. |
73
- | [optionalLabel](#optionalLabel) | Allows overriding the optional display text "(optional)", which appears next to the label. |
74
- | [valueText](#valueText) | Dropdown value text display. |
69
+ | `bib.fullscreen.headline` | Defines the headline to display above menu-options |
70
+ | `displayValue` | Allows custom HTML content to display the selected value when select is not focused. |
71
+ | `helpText` | Defines the content of the helpText. |
72
+ | `label` | Defines the content of the label. |
73
+ | `optionalLabel` | Allows overriding the optional display text "(optional)", which appears next to the label. |
74
+ | `valueText` | Dropdown value text display. |
75
75
 
76
76
  ## CSS Shadow Parts
77
77
 
78
78
  | Part | Description |
79
- |-------------------|--------------------------------------------------|
80
- | [dropdownChevron](#dropdownChevron) | Apply CSS to the collapsed/expanded state icon container. |
81
- | [dropdownSize](#dropdownSize) | Apply size styles to the dropdown bib (height, width, maxHeight, maxWidth only). |
82
- | [dropdownTrigger](#dropdownTrigger) | Apply CSS to the trigger content container. |
83
- | [helpText](#helpText) | Apply CSS to the help text. |
84
- <!-- AURO-GENERATED-CONTENT:END -->
85
-
86
- ## Basic
87
-
88
- <div class="exampleWrapper">
89
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/basic.html) -->
90
- <!-- The below content is automatically added from ./../apiExamples/basic.html -->
91
- <auro-select>
92
- <span slot="ariaLabel.bib.close">Close Popup</span>
93
- <span slot="bib.fullscreen.headline">Bib Headline</span>
94
- <span slot="label">Select Example</span>
95
- <auro-menu>
96
- <auro-menuoption value="stops">Stops</auro-menuoption>
97
- <auro-menuoption value="price">Price</auro-menuoption>
98
- <auro-menuoption value="duration">Duration</auro-menuoption>
99
- <auro-menuoption value="departure">Departure</auro-menuoption>
100
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
101
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
102
- </auro-menu>
103
- </auro-select>
104
- <!-- AURO-GENERATED-CONTENT:END -->
105
- </div>
106
- <auro-accordion alignRight>
107
- <span slot="trigger">See code</span>
108
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/basic.html) -->
109
- <!-- The below code snippet is automatically added from ./../apiExamples/basic.html -->
110
-
111
- <pre class="language-html"><code class="language-html">&lt;auro-select&gt;
112
- &lt;span slot="ariaLabel.bib.close"&gt;Close Popup&lt;/span&gt;
113
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
114
- &lt;span slot="label"&gt;Select Example&lt;/span&gt;
115
- &lt;auro-menu&gt;
116
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
117
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
118
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
119
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
120
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
121
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
122
- &lt;/auro-menu&gt;
123
- &lt;/auro-select&gt;</code></pre>
124
- <!-- AURO-GENERATED-CONTENT:END -->
125
- </auro-accordion>
126
-
127
- ## Property & Attribute Examples
128
-
129
- ### Appearance on Dark Backgrounds
130
-
131
- Use the `appearance="inverse"` attribute to render the component for use on dark backgrounds.
132
-
133
- <div class="exampleWrapper--ondark">
134
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/appearance-inverse.html) -->
135
- <!-- The below content is automatically added from ./../apiExamples/appearance-inverse.html -->
136
- <auro-select appearance="inverse">
137
- <span slot="bib.fullscreen.headline">Bib Headline</span>
138
- <span slot="label">Select Example</span>
139
- <auro-menu>
140
- <auro-menuoption value="stops">Stops</auro-menuoption>
141
- <auro-menuoption value="price">Price</auro-menuoption>
142
- <auro-menuoption value="duration">Duration</auro-menuoption>
143
- <auro-menuoption value="departure">Departure</auro-menuoption>
144
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
145
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
146
- </auro-menu>
147
- </auro-select>
148
- <!-- AURO-GENERATED-CONTENT:END -->
149
- </div>
150
- <auro-accordion alignRight>
151
- <span slot="trigger">See code</span>
152
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/appearance-inverse.html) -->
153
- <!-- The below code snippet is automatically added from ./../apiExamples/appearance-inverse.html -->
154
-
155
- <pre class="language-html"><code class="language-html">&lt;auro-select appearance="inverse"&gt;
156
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
157
- &lt;span slot="label"&gt;Select Example&lt;/span&gt;
158
- &lt;auro-menu&gt;
159
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
160
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
161
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
162
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
163
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
164
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
165
- &lt;/auro-menu&gt;
166
- &lt;/auro-select&gt;</code></pre>
167
- <!-- AURO-GENERATED-CONTENT:END -->
168
- </auro-accordion>
169
-
170
- ### Autocomplete
171
-
172
- Use the `autocomplete` attribute to let browser's know what information to use to fill out the form.
173
-
174
- <div class="exampleWrapper">
175
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/autocomplete.html) -->
176
- <!-- The below content is automatically added from ./../apiExamples/autocomplete.html -->
177
- <div class="autofill-example-form">
178
- <div class="input-row">
179
- <auro-input autocomplete="given-name">
180
- <span slot="label">First Name</span>
181
- <span slot="bib.fullscreen.headline">First Name</span>
182
- </auro-input>
183
- <auro-input autocomplete="family-name">
184
- <span slot="label">Last Name</span>
185
- <span slot="bib.fullscreen.headline">Last Name</span>
186
- </auro-input>
187
- </div>
188
- <div class="input-row">
189
- <auro-input autocomplete="address-line1">
190
- <span slot="label">Street Address</span>
191
- <span slot="bib.fullscreen.headline">Street Address</span>
192
- </auro-input>
193
- <auro-input autocomplete="address-level2">
194
- <span slot="label">City</span>
195
- <span slot="bib.fullscreen.headline">City</span>
196
- </auro-input>
197
- <auro-select autocomplete="address-level1">
198
- <span slot="bib.fullscreen.headline">Select Your State</span>
199
- <span slot="label">Select Your State</span>
200
- <auro-menu>
201
- <auro-menuoption value="AL">Alabama</auro-menuoption>
202
- <auro-menuoption value="AK">Alaska</auro-menuoption>
203
- <auro-menuoption value="AZ">Arizona</auro-menuoption>
204
- <auro-menuoption value="AR">Arkansas</auro-menuoption>
205
- <auro-menuoption value="CA">California</auro-menuoption>
206
- <auro-menuoption value="CO">Colorado</auro-menuoption>
207
- <auro-menuoption value="CT">Connecticut</auro-menuoption>
208
- <auro-menuoption value="DE">Delaware</auro-menuoption>
209
- <auro-menuoption value="DC">District of Columbia</auro-menuoption>
210
- <auro-menuoption value="FL">Florida</auro-menuoption>
211
- <auro-menuoption value="GA">Georgia</auro-menuoption>
212
- <auro-menuoption value="HI">Hawaii</auro-menuoption>
213
- <auro-menuoption value="ID">Idaho</auro-menuoption>
214
- <auro-menuoption value="IL">Illinois</auro-menuoption>
215
- <auro-menuoption value="IN">Indiana</auro-menuoption>
216
- <auro-menuoption value="IA">Iowa</auro-menuoption>
217
- <auro-menuoption value="KS">Kansas</auro-menuoption>
218
- <auro-menuoption value="KY">Kentucky</auro-menuoption>
219
- <auro-menuoption value="LA">Louisiana</auro-menuoption>
220
- <auro-menuoption value="ME">Maine</auro-menuoption>
221
- <auro-menuoption value="MD">Maryland</auro-menuoption>
222
- <auro-menuoption value="MA">Massachusetts</auro-menuoption>
223
- <auro-menuoption value="MI">Michigan</auro-menuoption>
224
- <auro-menuoption value="MN">Minnesota</auro-menuoption>
225
- <auro-menuoption value="MS">Mississippi</auro-menuoption>
226
- <auro-menuoption value="MO">Missouri</auro-menuoption>
227
- <auro-menuoption value="MT">Montana</auro-menuoption>
228
- <auro-menuoption value="NE">Nebraska</auro-menuoption>
229
- <auro-menuoption value="NV">Nevada</auro-menuoption>
230
- <auro-menuoption value="NH">New Hampshire</auro-menuoption>
231
- <auro-menuoption value="NJ">New Jersey</auro-menuoption>
232
- <auro-menuoption value="NM">New Mexico</auro-menuoption>
233
- <auro-menuoption value="NY">New York</auro-menuoption>
234
- <auro-menuoption value="NC">North Carolina</auro-menuoption>
235
- <auro-menuoption value="ND">North Dakota</auro-menuoption>
236
- <auro-menuoption value="OH">Ohio</auro-menuoption>
237
- <auro-menuoption value="OK">Oklahoma</auro-menuoption>
238
- <auro-menuoption value="OR">Oregon</auro-menuoption>
239
- <auro-menuoption value="PA">Pennsylvania</auro-menuoption>
240
- <auro-menuoption value="RI">Rhode Island</auro-menuoption>
241
- <auro-menuoption value="SC">South Carolina</auro-menuoption>
242
- <auro-menuoption value="SD">South Dakota</auro-menuoption>
243
- <auro-menuoption value="TN">Tennessee</auro-menuoption>
244
- <auro-menuoption value="TX">Texas</auro-menuoption>
245
- <auro-menuoption value="UT">Utah</auro-menuoption>
246
- <auro-menuoption value="VT">Vermont</auro-menuoption>
247
- <auro-menuoption value="VA">Virginia</auro-menuoption>
248
- <auro-menuoption value="WA">Washington</auro-menuoption>
249
- <auro-menuoption value="WV">West Virginia</auro-menuoption>
250
- <auro-menuoption value="WI">Wisconsin</auro-menuoption>
251
- <auro-menuoption value="WY">Wyoming</auro-menuoption>
252
- </auro-menu>
253
- </auro-select>
254
- </div>
255
- </div>
256
- <!-- AURO-GENERATED-CONTENT:END -->
257
- </div>
258
- <auro-accordion alignRight>
259
- <span slot="trigger">See code</span>
260
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/autocomplete.html) -->
261
- <!-- The below code snippet is automatically added from ./../apiExamples/autocomplete.html -->
262
-
263
- <pre class="language-html"><code class="language-html">&lt;div class="autofill-example-form"&gt;
264
- &lt;div class="input-row"&gt;
265
- &lt;auro-input autocomplete="given-name"&gt;
266
- &lt;span slot="label"&gt;First Name&lt;/span&gt;
267
- &lt;span slot="bib.fullscreen.headline"&gt;First Name&lt;/span&gt;
268
- &lt;/auro-input&gt;
269
- &lt;auro-input autocomplete="family-name"&gt;
270
- &lt;span slot="label"&gt;Last Name&lt;/span&gt;
271
- &lt;span slot="bib.fullscreen.headline"&gt;Last Name&lt;/span&gt;
272
- &lt;/auro-input&gt;
273
- &lt;/div&gt;
274
- &lt;div class="input-row"&gt;
275
- &lt;auro-input autocomplete="address-line1"&gt;
276
- &lt;span slot="label"&gt;Street Address&lt;/span&gt;
277
- &lt;span slot="bib.fullscreen.headline"&gt;Street Address&lt;/span&gt;
278
- &lt;/auro-input&gt;
279
- &lt;auro-input autocomplete="address-level2"&gt;
280
- &lt;span slot="label"&gt;City&lt;/span&gt;
281
- &lt;span slot="bib.fullscreen.headline"&gt;City&lt;/span&gt;
282
- &lt;/auro-input&gt;
283
- &lt;auro-select autocomplete="address-level1"&gt;
284
- &lt;span slot="bib.fullscreen.headline"&gt;Select Your State&lt;/span&gt;
285
- &lt;span slot="label"&gt;Select Your State&lt;/span&gt;
286
- &lt;auro-menu&gt;
287
- &lt;auro-menuoption value="AL"&gt;Alabama&lt;/auro-menuoption&gt;
288
- &lt;auro-menuoption value="AK"&gt;Alaska&lt;/auro-menuoption&gt;
289
- &lt;auro-menuoption value="AZ"&gt;Arizona&lt;/auro-menuoption&gt;
290
- &lt;auro-menuoption value="AR"&gt;Arkansas&lt;/auro-menuoption&gt;
291
- &lt;auro-menuoption value="CA"&gt;California&lt;/auro-menuoption&gt;
292
- &lt;auro-menuoption value="CO"&gt;Colorado&lt;/auro-menuoption&gt;
293
- &lt;auro-menuoption value="CT"&gt;Connecticut&lt;/auro-menuoption&gt;
294
- &lt;auro-menuoption value="DE"&gt;Delaware&lt;/auro-menuoption&gt;
295
- &lt;auro-menuoption value="DC"&gt;District of Columbia&lt;/auro-menuoption&gt;
296
- &lt;auro-menuoption value="FL"&gt;Florida&lt;/auro-menuoption&gt;
297
- &lt;auro-menuoption value="GA"&gt;Georgia&lt;/auro-menuoption&gt;
298
- &lt;auro-menuoption value="HI"&gt;Hawaii&lt;/auro-menuoption&gt;
299
- &lt;auro-menuoption value="ID"&gt;Idaho&lt;/auro-menuoption&gt;
300
- &lt;auro-menuoption value="IL"&gt;Illinois&lt;/auro-menuoption&gt;
301
- &lt;auro-menuoption value="IN"&gt;Indiana&lt;/auro-menuoption&gt;
302
- &lt;auro-menuoption value="IA"&gt;Iowa&lt;/auro-menuoption&gt;
303
- &lt;auro-menuoption value="KS"&gt;Kansas&lt;/auro-menuoption&gt;
304
- &lt;auro-menuoption value="KY"&gt;Kentucky&lt;/auro-menuoption&gt;
305
- &lt;auro-menuoption value="LA"&gt;Louisiana&lt;/auro-menuoption&gt;
306
- &lt;auro-menuoption value="ME"&gt;Maine&lt;/auro-menuoption&gt;
307
- &lt;auro-menuoption value="MD"&gt;Maryland&lt;/auro-menuoption&gt;
308
- &lt;auro-menuoption value="MA"&gt;Massachusetts&lt;/auro-menuoption&gt;
309
- &lt;auro-menuoption value="MI"&gt;Michigan&lt;/auro-menuoption&gt;
310
- &lt;auro-menuoption value="MN"&gt;Minnesota&lt;/auro-menuoption&gt;
311
- &lt;auro-menuoption value="MS"&gt;Mississippi&lt;/auro-menuoption&gt;
312
- &lt;auro-menuoption value="MO"&gt;Missouri&lt;/auro-menuoption&gt;
313
- &lt;auro-menuoption value="MT"&gt;Montana&lt;/auro-menuoption&gt;
314
- &lt;auro-menuoption value="NE"&gt;Nebraska&lt;/auro-menuoption&gt;
315
- &lt;auro-menuoption value="NV"&gt;Nevada&lt;/auro-menuoption&gt;
316
- &lt;auro-menuoption value="NH"&gt;New Hampshire&lt;/auro-menuoption&gt;
317
- &lt;auro-menuoption value="NJ"&gt;New Jersey&lt;/auro-menuoption&gt;
318
- &lt;auro-menuoption value="NM"&gt;New Mexico&lt;/auro-menuoption&gt;
319
- &lt;auro-menuoption value="NY"&gt;New York&lt;/auro-menuoption&gt;
320
- &lt;auro-menuoption value="NC"&gt;North Carolina&lt;/auro-menuoption&gt;
321
- &lt;auro-menuoption value="ND"&gt;North Dakota&lt;/auro-menuoption&gt;
322
- &lt;auro-menuoption value="OH"&gt;Ohio&lt;/auro-menuoption&gt;
323
- &lt;auro-menuoption value="OK"&gt;Oklahoma&lt;/auro-menuoption&gt;
324
- &lt;auro-menuoption value="OR"&gt;Oregon&lt;/auro-menuoption&gt;
325
- &lt;auro-menuoption value="PA"&gt;Pennsylvania&lt;/auro-menuoption&gt;
326
- &lt;auro-menuoption value="RI"&gt;Rhode Island&lt;/auro-menuoption&gt;
327
- &lt;auro-menuoption value="SC"&gt;South Carolina&lt;/auro-menuoption&gt;
328
- &lt;auro-menuoption value="SD"&gt;South Dakota&lt;/auro-menuoption&gt;
329
- &lt;auro-menuoption value="TN"&gt;Tennessee&lt;/auro-menuoption&gt;
330
- &lt;auro-menuoption value="TX"&gt;Texas&lt;/auro-menuoption&gt;
331
- &lt;auro-menuoption value="UT"&gt;Utah&lt;/auro-menuoption&gt;
332
- &lt;auro-menuoption value="VT"&gt;Vermont&lt;/auro-menuoption&gt;
333
- &lt;auro-menuoption value="VA"&gt;Virginia&lt;/auro-menuoption&gt;
334
- &lt;auro-menuoption value="WA"&gt;Washington&lt;/auro-menuoption&gt;
335
- &lt;auro-menuoption value="WV"&gt;West Virginia&lt;/auro-menuoption&gt;
336
- &lt;auro-menuoption value="WI"&gt;Wisconsin&lt;/auro-menuoption&gt;
337
- &lt;auro-menuoption value="WY"&gt;Wyoming&lt;/auro-menuoption&gt;
338
- &lt;/auro-menu&gt;
339
- &lt;/auro-select&gt;
340
- &lt;/div&gt;
341
- &lt;/div&gt;</code></pre>
342
- <!-- AURO-GENERATED-CONTENT:END -->
343
- </auro-accordion>
344
-
345
- ### Disabled
346
-
347
- Use the `disabled` attribute to toggle the disabled UI.
348
-
349
- <div class="exampleWrapper">
350
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/disabled.html) -->
351
- <!-- The below content is automatically added from ./../apiExamples/disabled.html -->
352
- <auro-select disabled placeholder="Placeholder Text">
353
- <span slot="bib.fullscreen.headline">Bib Headline</span>
354
- <span slot="label">Label</span>
355
- <auro-menu>
356
- <auro-menuoption value="stops">Stops</auro-menuoption>
357
- <auro-menuoption value="price">Price</auro-menuoption>
358
- <auro-menuoption value="duration">Duration</auro-menuoption>
359
- <auro-menuoption value="departure">Departure</auro-menuoption>
360
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
361
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
362
- </auro-menu>
363
- </auro-select>
364
- <!-- AURO-GENERATED-CONTENT:END -->
365
- </div>
366
- <auro-accordion alignRight>
367
- <span slot="trigger">See code</span>
368
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/disabled.html) -->
369
- <!-- The below code snippet is automatically added from ./../apiExamples/disabled.html -->
370
-
371
- <pre class="language-html"><code class="language-html">&lt;auro-select disabled placeholder="Placeholder Text"&gt;
372
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
373
- &lt;span slot="label"&gt;Label&lt;/span&gt;
374
- &lt;auro-menu&gt;
375
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
376
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
377
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
378
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
379
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
380
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
381
- &lt;/auro-menu&gt;
382
- &lt;/auro-select&gt;</code></pre>
383
- <!-- AURO-GENERATED-CONTENT:END -->
384
- </auro-accordion>
385
- <div class="exampleWrapper--ondark">
386
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/appearance-inverse-disabled.html) -->
387
- <!-- The below content is automatically added from ./../apiExamples/appearance-inverse-disabled.html -->
388
- <auro-select appearance="inverse" disabled placeholder="Placeholder Text">
389
- <span slot="bib.fullscreen.headline">Bib Headline</span>
390
- <span slot="label">Label</span>
391
- <auro-menu>
392
- <auro-menuoption value="stops">Stops</auro-menuoption>
393
- <auro-menuoption value="price">Price</auro-menuoption>
394
- <auro-menuoption value="duration">Duration</auro-menuoption>
395
- <auro-menuoption value="departure">Departure</auro-menuoption>
396
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
397
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
398
- </auro-menu>
399
- </auro-select>
400
- <!-- AURO-GENERATED-CONTENT:END -->
401
- </div>
402
- <auro-accordion alignRight>
403
- <span slot="trigger">See code</span>
404
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/appearance-inverse-disabled.html) -->
405
- <!-- The below content is automatically added from ./../apiExamples/appearance-inverse-disabled.html -->
406
- <auro-select appearance="inverse" disabled placeholder="Placeholder Text">
407
- <span slot="bib.fullscreen.headline">Bib Headline</span>
408
- <span slot="label">Label</span>
409
- <auro-menu>
410
- <auro-menuoption value="stops">Stops</auro-menuoption>
411
- <auro-menuoption value="price">Price</auro-menuoption>
412
- <auro-menuoption value="duration">Duration</auro-menuoption>
413
- <auro-menuoption value="departure">Departure</auro-menuoption>
414
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
415
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
416
- </auro-menu>
417
- </auro-select>
418
- <!-- AURO-GENERATED-CONTENT:END -->
419
- </auro-accordion>
420
-
421
- ### Error
422
-
423
- Use the `error` attribute to toggle the error UI.
424
-
425
- <div class="exampleWrapper">
426
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/error.html) -->
427
- <!-- The below content is automatically added from ./../apiExamples/error.html -->
428
- <auro-select error="Custom error message" placeholder="Placeholder Text">
429
- <span slot="bib.fullscreen.headline">Bib Headline</span>
430
- <span slot="label">Label</span>
431
- <auro-menu>
432
- <auro-menuoption value="stops">Stops</auro-menuoption>
433
- <auro-menuoption value="price">Price</auro-menuoption>
434
- <auro-menuoption value="duration">Duration</auro-menuoption>
435
- <auro-menuoption value="departure">Departure</auro-menuoption>
436
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
437
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
438
- </auro-menu>
439
- </auro-select>
440
- <!-- AURO-GENERATED-CONTENT:END -->
441
- </div>
442
- <auro-accordion alignRight>
443
- <span slot="trigger">See code</span>
444
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/error.html) -->
445
- <!-- The below code snippet is automatically added from ./../apiExamples/error.html -->
446
-
447
- <pre class="language-html"><code class="language-html">&lt;auro-select error="Custom error message" placeholder="Placeholder Text"&gt;
448
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
449
- &lt;span slot="label"&gt;Label&lt;/span&gt;
450
- &lt;auro-menu&gt;
451
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
452
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
453
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
454
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
455
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
456
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
457
- &lt;/auro-menu&gt;
458
- &lt;/auro-select&gt;</code></pre>
459
- <!-- AURO-GENERATED-CONTENT:END -->
460
- </auro-accordion>
461
- <div class="exampleWrapper--ondark" aria-hidden>
462
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/appearance-inverse-error.html) -->
463
- <!-- The below content is automatically added from ./../apiExamples/appearance-inverse-error.html -->
464
- <auro-select appearance="inverse" error="Custom error message" placeholder="Placeholder Text">
465
- <span slot="bib.fullscreen.headline">Bib Headline</span>
466
- <span slot="label">Label</span>
467
- <auro-menu>
468
- <auro-menuoption value="stops">Stops</auro-menuoption>
469
- <auro-menuoption value="price">Price</auro-menuoption>
470
- <auro-menuoption value="duration">Duration</auro-menuoption>
471
- <auro-menuoption value="departure">Departure</auro-menuoption>
472
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
473
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
474
- </auro-menu>
475
- </auro-select>
476
- <!-- AURO-GENERATED-CONTENT:END -->
477
- </div>
478
- <auro-accordion alignRight>
479
- <span slot="trigger">See code</span>
480
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/appearance-inverse-error.html) -->
481
- <!-- The below content is automatically added from ./../apiExamples/appearance-inverse-error.html -->
482
- <auro-select appearance="inverse" error="Custom error message" placeholder="Placeholder Text">
483
- <span slot="bib.fullscreen.headline">Bib Headline</span>
484
- <span slot="label">Label</span>
485
- <auro-menu>
486
- <auro-menuoption value="stops">Stops</auro-menuoption>
487
- <auro-menuoption value="price">Price</auro-menuoption>
488
- <auro-menuoption value="duration">Duration</auro-menuoption>
489
- <auro-menuoption value="departure">Departure</auro-menuoption>
490
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
491
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
492
- </auro-menu>
493
- </auro-select>
494
- <!-- AURO-GENERATED-CONTENT:END -->
495
- </auro-accordion>
496
-
497
- ### Flex Menu Width
498
-
499
- Use the `flexMenuWidth` boolean attribute to toggle the width of the `<auro-select>` element to match the width of the bib content, rather than the width of the trigger.
500
-
501
- <div class="exampleWrapper">
502
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/flex-menu-width.html) -->
503
- <!-- The below content is automatically added from ../apiExamples/flex-menu-width.html -->
504
- <auro-select flexMenuWidth id="flexMenuWidthExample" placeholder="Placeholder Text">
505
- <span slot="bib.fullscreen.headline">Bib Headline</span>
506
- <span slot="label">Label</span>
507
- <auro-menu>
508
- <auro-menuoption value="united states">United States has a country code of (+1)</auro-menuoption>
509
- <auro-menuoption value="costa rica">Costa Rica has a country code of (+506)</auro-menuoption>
510
- <auro-menuoption value="mexico">Mexico has a country code of (+52)</auro-menuoption>
511
- <auro-menuoption value="afghanistan">Afghanistan has a country code of (+93)</auro-menuoption>
512
- <auro-menuoption value="albania">Albania has a country code of (+355)</auro-menuoption>
513
- </auro-menu>
514
- </auro-select>
515
- <style>
516
- #flexMenuWidthExample::part(dropdownTrigger) {
517
- width: 25%;
518
- }
519
- </style>
520
- <!-- AURO-GENERATED-CONTENT:END -->
521
- </div>
522
- <auro-accordion alignRight>
523
- <span slot="trigger">See code</span>
524
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=../apiExamples/flex-menu-width.html) -->
525
- <!-- The below code snippet is automatically added from ../apiExamples/flex-menu-width.html -->
526
-
527
- <pre class="language-html"><code class="language-html">&lt;auro-select flexMenuWidth id="flexMenuWidthExample" placeholder="Placeholder Text"&gt;
528
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
529
- &lt;span slot="label"&gt;Label&lt;/span&gt;
530
- &lt;auro-menu&gt;
531
- &lt;auro-menuoption value="united states"&gt;United States has a country code of (+1)&lt;/auro-menuoption&gt;
532
- &lt;auro-menuoption value="costa rica"&gt;Costa Rica has a country code of (+506)&lt;/auro-menuoption&gt;
533
- &lt;auro-menuoption value="mexico"&gt;Mexico has a country code of (+52)&lt;/auro-menuoption&gt;
534
- &lt;auro-menuoption value="afghanistan"&gt;Afghanistan has a country code of (+93)&lt;/auro-menuoption&gt;
535
- &lt;auro-menuoption value="albania"&gt;Albania has a country code of (+355)&lt;/auro-menuoption&gt;
536
- &lt;/auro-menu&gt;
537
- &lt;/auro-select&gt;
538
- &lt;style&gt;
539
- #flexMenuWidthExample::part(dropdownTrigger) {
540
- width: 25%;
541
- }
542
- &lt;/style&gt;</code></pre>
543
- <!-- AURO-GENERATED-CONTENT:END -->
544
- </auro-accordion>
545
-
546
- ### Dropdown with Fullscreen Bib
547
-
548
- You can make the dropdown open in fullscreen at a specific breakpoint by setting `fullscreenBreakpoint`.
549
-
550
- The default value of `fullscreenBreakpoint` is `sm`.
551
-
552
- Breakpoint token can be found [here](https://auro.alaskaair.com/getting-started/developers/design-tokens)
553
-
554
- To support fullcreen bib, setting `bib.fullscreen.headline` is **STRONGLY RECOMMENDED**.
555
-
556
- <div class="exampleWrapper">
557
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/fullscreen-breakpoint.html) -->
558
- <!-- The below content is automatically added from ./../apiExamples/fullscreen-breakpoint.html -->
559
- <auro-select fullscreenBreakpoint="lg">
560
- <span slot="label">Select Example</span>
561
- <span slot="bib.fullscreen.headline">Bib Headline</span>
562
- <auro-menu>
563
- <auro-menuoption value="stops">Stops</auro-menuoption>
564
- <auro-menuoption value="price">Price</auro-menuoption>
565
- <auro-menuoption value="duration">Duration</auro-menuoption>
566
- <auro-menuoption value="departure">Departure</auro-menuoption>
567
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
568
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
569
- </auro-menu>
570
- </auro-select>
571
- <!-- AURO-GENERATED-CONTENT:END -->
572
- </div>
573
- <auro-accordion alignRight>
574
- <span slot="trigger">See code</span>
575
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/fullscreen-breakpoint.html) -->
576
- <!-- The below code snippet is automatically added from ./../apiExamples/fullscreen-breakpoint.html -->
577
-
578
- <pre class="language-html"><code class="language-html">&lt;auro-select fullscreenBreakpoint="lg"&gt;
579
- &lt;span slot="label"&gt;Select Example&lt;/span&gt;
580
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
581
- &lt;auro-menu&gt;
582
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
583
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
584
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
585
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
586
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
587
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
588
- &lt;/auro-menu&gt;
589
- &lt;/auro-select&gt;</code></pre>
590
- <!-- AURO-GENERATED-CONTENT:END -->
591
- </auro-accordion>
592
-
593
- #### Disabled Fullscreen Bib
594
-
595
- This example overrides the default dropdown behavior to force a non-fullscreen view on any screen size. `disabled`
596
- ensures that the dropdown will never be fullscreen.
597
- Please use `xl` if you want the opposite behavior, where a dropdown is always fullscreen.
598
-
599
- <div class="exampleWrapper">
600
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/fullscreen-disabled.html) -->
601
- <!-- The below content is automatically added from ./../apiExamples/fullscreen-disabled.html -->
602
- <auro-select fullscreenBreakpoint="disabled">
603
- <span slot="bib.fullscreen.headline">Bib Headline</span>
604
- <span slot="label">Select Example</span>
605
- <auro-menu>
606
- <auro-menuoption value="stops">Stops</auro-menuoption>
607
- <auro-menuoption value="price">Price</auro-menuoption>
608
- <auro-menuoption value="duration">Duration</auro-menuoption>
609
- <auro-menuoption value="departure">Departure</auro-menuoption>
610
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
611
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
612
- </auro-menu>
613
- </auro-select>
614
- <!-- AURO-GENERATED-CONTENT:END -->
615
- </div>
616
- <auro-accordion alignRight>
617
- <span slot="trigger">See code</span>
618
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/fullscreen-disabled.html) -->
619
- <!-- The below code snippet is automatically added from ./../apiExamples/fullscreen-disabled.html -->
620
-
621
- <pre class="language-html"><code class="language-html">&lt;auro-select fullscreenBreakpoint="disabled"&gt;
622
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
623
- &lt;span slot="label"&gt;Select Example&lt;/span&gt;
624
- &lt;auro-menu&gt;
625
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
626
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
627
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
628
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
629
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
630
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
631
- &lt;/auro-menu&gt;
632
- &lt;/auro-select&gt;</code></pre>
633
- <!-- AURO-GENERATED-CONTENT:END -->
634
- </auro-accordion>
635
-
636
- ### Shape | Size | Layout Support
637
-
638
- The `auro-select` component supports the `shape`, `size` and `layout` feature set. The component defaults to the `layout="classic"`, `shape="classic"` and `size="lg"`.
639
-
640
- #### Classic Layout (Legacy)
641
-
642
- The `classic` layout is default for `auro-select`. No customization is needed to achieve this look.
643
-
644
- <div class="exampleWrapper">
645
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/basic.html) -->
646
- <!-- The below content is automatically added from ./../apiExamples/basic.html -->
647
- <auro-select>
648
- <span slot="ariaLabel.bib.close">Close Popup</span>
649
- <span slot="bib.fullscreen.headline">Bib Headline</span>
650
- <span slot="label">Select Example</span>
651
- <auro-menu>
652
- <auro-menuoption value="stops">Stops</auro-menuoption>
653
- <auro-menuoption value="price">Price</auro-menuoption>
654
- <auro-menuoption value="duration">Duration</auro-menuoption>
655
- <auro-menuoption value="departure">Departure</auro-menuoption>
656
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
657
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
658
- </auro-menu>
659
- </auro-select>
660
- <!-- AURO-GENERATED-CONTENT:END -->
661
- </div>
662
- <auro-accordion alignRight>
663
- <span slot="trigger">See code</span>
664
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/basic.html) -->
665
- <!-- The below code snippet is automatically added from ./../apiExamples/basic.html -->
666
-
667
- <pre class="language-html"><code class="language-html">&lt;auro-select&gt;
668
- &lt;span slot="ariaLabel.bib.close"&gt;Close Popup&lt;/span&gt;
669
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
670
- &lt;span slot="label"&gt;Select Example&lt;/span&gt;
671
- &lt;auro-menu&gt;
672
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
673
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
674
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
675
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
676
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
677
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
678
- &lt;/auro-menu&gt;
679
- &lt;/auro-select&gt;</code></pre>
680
- <!-- AURO-GENERATED-CONTENT:END -->
681
- </auro-accordion>
682
-
683
- #### Emphasized Layout
684
-
685
- The `emphasized` layout is only supported on light backgrounds.
686
-
687
- The `emphasized` layout supports the following shapes:
688
- - `pill`
689
- - `pill-left`
690
- - `pill-right`
691
-
692
- The `emphasized` layout supports the following sizes:
693
- - `xl`
694
-
695
- <div class="exampleWrapper">
696
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/emphasized/basic.html) -->
697
- <!-- The below content is automatically added from ./../apiExamples/emphasized/basic.html -->
698
- <div style="display: flex; flex-direction: row; gap: 10px;">
699
- <auro-select layout="emphasized" shape="pill" size="xl" value="flights" forceDisplayValue style="display:inline-block;">
700
- <span slot="ariaLabel.bib.close">Close Popup</span>
701
- <span slot="label">Select Example</span>
702
- <auro-menu nocheckmark>
703
- <auro-menuoption value="flights">
704
- <auro-icon category="terminal" name="plane-diag-stroke" customcolor></auro-icon> Flights
705
- <auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="terminal" name="plane-diag-fill" customcolor></auro-icon>
706
- </auro-menuoption>
707
- <auro-menuoption value="cars">
708
- <auro-icon category="destination" name="car-rental-stroke" customcolor></auro-icon> Cars
709
- <auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="destination" name="car-rental-stroke" customcolor></auro-icon>
710
- </auro-menuoption>
711
- <auro-menuoption value="hotels">
712
- <auro-icon category="destination" name="hotel-stroke" customcolor></auro-icon> Hotels
713
- <auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="destination" name="hotel-filled" customcolor></auro-icon>
714
- </auro-menuoption>
715
- <auro-menuoption value="packages">
716
- <auro-icon category="shop" name="gift-stroke" customcolor></auro-icon> Packages
717
- <auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="shop" name="gift-filled" customcolor></auro-icon>
718
- </auro-menuoption>
719
- <auro-menuoption value="cruises">
720
- <auro-icon category="in-flight" name="boarding" customcolor></auro-icon> Cruises
721
- <auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="in-flight" name="boarding" customcolor></auro-icon>
722
- </auro-menuoption>
723
- </auro-menu>
724
- </auro-select>
725
- <auro-select layout="emphasized" shape="pill" size="xl" value="flights" style="display:inline-block;">
726
- <span slot="label">Select Example</span>
727
- <auro-menu nocheckmark>
728
- <auro-menuoption value="flights">
729
- <auro-icon category="terminal" name="plane-diag-stroke" customcolor></auro-icon> Flights
730
- <auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="terminal" name="plane-diag-fill" customcolor></auro-icon>
731
- </auro-menuoption>
732
- <auro-menuoption value="cars">
733
- <auro-icon category="destination" name="car-rental-stroke" customcolor></auro-icon> Cars
734
- <auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="destination" name="car-rental-stroke" customcolor></auro-icon>
735
- </auro-menuoption>
736
- <auro-menuoption value="hotels">
737
- <auro-icon category="destination" name="hotel-stroke" customcolor></auro-icon> Hotels
738
- <auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="destination" name="hotel-filled" customcolor></auro-icon>
739
- </auro-menuoption>
740
- <auro-menuoption value="packages">
741
- <auro-icon category="shop" name="gift-stroke" customcolor></auro-icon> Packages
742
- <auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="shop" name="gift-filled" customcolor></auro-icon>
743
- </auro-menuoption>
744
- <auro-menuoption value="cruises">
745
- <auro-icon category="in-flight" name="boarding" customcolor></auro-icon> Cruises
746
- <auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="in-flight" name="boarding" customcolor></auro-icon>
747
- </auro-menuoption>
748
- </auro-menu>
749
- </auro-select>
750
- <auro-select layout="emphasized" shape="pill" size="xl" value="flights" required style="display:inline-block;">
751
- <span slot="label">Select Example</span>
752
- <span slot="helpText">no displayValue in menuoptions</span>
753
- <auro-menu nocheckmark>
754
- <auro-menuoption value="flights">
755
- <auro-icon category="terminal" name="plane-diag-stroke" customcolor></auro-icon> Flights
756
- </auro-menuoption>
757
- <auro-menuoption value="cars">
758
- <auro-icon category="destination" name="car-rental-stroke" customcolor></auro-icon> Cars
759
- </auro-menuoption>
760
- <auro-menuoption value="hotels">
761
- <auro-icon category="destination" name="hotel-stroke" customcolor></auro-icon> Hotels
762
- </auro-menuoption>
763
- <auro-menuoption value="packages">
764
- <auro-icon category="shop" name="gift-stroke" customcolor></auro-icon> Packages
765
- </auro-menuoption>
766
- <auro-menuoption value="cruises">
767
- <auro-icon category="in-flight" name="boarding" customcolor></auro-icon> Cruises
768
- </auro-menuoption>
769
- </auro-menu>
770
- </auro-select>
771
- </div>
772
- <!-- AURO-GENERATED-CONTENT:END -->
773
- </div>
774
- <auro-accordion alignRight>
775
- <span slot="trigger">See code</span>
776
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/emphasized/basic.html) -->
777
- <!-- The below code snippet is automatically added from ./../apiExamples/emphasized/basic.html -->
778
-
779
- <pre class="language-html"><code class="language-html">&lt;div style="display: flex; flex-direction: row; gap: 10px;"&gt;
780
- &lt;auro-select layout="emphasized" shape="pill" size="xl" value="flights" forceDisplayValue style="display:inline-block;"&gt;
781
- &lt;span slot="ariaLabel.bib.close"&gt;Close Popup&lt;/span&gt;
782
- &lt;span slot="label"&gt;Select Example&lt;/span&gt;
783
- &lt;auro-menu nocheckmark&gt;
784
- &lt;auro-menuoption value="flights"&gt;
785
- &lt;auro-icon category="terminal" name="plane-diag-stroke" customcolor&gt;&lt;/auro-icon&gt; Flights
786
- &lt;auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="terminal" name="plane-diag-fill" customcolor&gt;&lt;/auro-icon&gt;
787
- &lt;/auro-menuoption&gt;
788
- &lt;auro-menuoption value="cars"&gt;
789
- &lt;auro-icon category="destination" name="car-rental-stroke" customcolor&gt;&lt;/auro-icon&gt; Cars
790
- &lt;auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="destination" name="car-rental-stroke" customcolor&gt;&lt;/auro-icon&gt;
791
- &lt;/auro-menuoption&gt;
792
- &lt;auro-menuoption value="hotels"&gt;
793
- &lt;auro-icon category="destination" name="hotel-stroke" customcolor&gt;&lt;/auro-icon&gt; Hotels
794
- &lt;auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="destination" name="hotel-filled" customcolor&gt;&lt;/auro-icon&gt;
795
- &lt;/auro-menuoption&gt;
796
- &lt;auro-menuoption value="packages"&gt;
797
- &lt;auro-icon category="shop" name="gift-stroke" customcolor&gt;&lt;/auro-icon&gt; Packages
798
- &lt;auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="shop" name="gift-filled" customcolor&gt;&lt;/auro-icon&gt;
799
- &lt;/auro-menuoption&gt;
800
- &lt;auro-menuoption value="cruises"&gt;
801
- &lt;auro-icon category="in-flight" name="boarding" customcolor&gt;&lt;/auro-icon&gt; Cruises
802
- &lt;auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="in-flight" name="boarding" customcolor&gt;&lt;/auro-icon&gt;
803
- &lt;/auro-menuoption&gt;
804
- &lt;/auro-menu&gt;
805
- &lt;/auro-select&gt;
806
- &lt;auro-select layout="emphasized" shape="pill" size="xl" value="flights" style="display:inline-block;"&gt;
807
- &lt;span slot="label"&gt;Select Example&lt;/span&gt;
808
- &lt;auro-menu nocheckmark&gt;
809
- &lt;auro-menuoption value="flights"&gt;
810
- &lt;auro-icon category="terminal" name="plane-diag-stroke" customcolor&gt;&lt;/auro-icon&gt; Flights
811
- &lt;auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="terminal" name="plane-diag-fill" customcolor&gt;&lt;/auro-icon&gt;
812
- &lt;/auro-menuoption&gt;
813
- &lt;auro-menuoption value="cars"&gt;
814
- &lt;auro-icon category="destination" name="car-rental-stroke" customcolor&gt;&lt;/auro-icon&gt; Cars
815
- &lt;auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="destination" name="car-rental-stroke" customcolor&gt;&lt;/auro-icon&gt;
816
- &lt;/auro-menuoption&gt;
817
- &lt;auro-menuoption value="hotels"&gt;
818
- &lt;auro-icon category="destination" name="hotel-stroke" customcolor&gt;&lt;/auro-icon&gt; Hotels
819
- &lt;auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="destination" name="hotel-filled" customcolor&gt;&lt;/auro-icon&gt;
820
- &lt;/auro-menuoption&gt;
821
- &lt;auro-menuoption value="packages"&gt;
822
- &lt;auro-icon category="shop" name="gift-stroke" customcolor&gt;&lt;/auro-icon&gt; Packages
823
- &lt;auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="shop" name="gift-filled" customcolor&gt;&lt;/auro-icon&gt;
824
- &lt;/auro-menuoption&gt;
825
- &lt;auro-menuoption value="cruises"&gt;
826
- &lt;auro-icon category="in-flight" name="boarding" customcolor&gt;&lt;/auro-icon&gt; Cruises
827
- &lt;auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="in-flight" name="boarding" customcolor&gt;&lt;/auro-icon&gt;
828
- &lt;/auro-menuoption&gt;
829
- &lt;/auro-menu&gt;
830
- &lt;/auro-select&gt;
831
- &lt;auro-select layout="emphasized" shape="pill" size="xl" value="flights" required style="display:inline-block;"&gt;
832
- &lt;span slot="label"&gt;Select Example&lt;/span&gt;
833
- &lt;span slot="helpText"&gt;no displayValue in menuoptions&lt;/span&gt;
834
- &lt;auro-menu nocheckmark&gt;
835
- &lt;auro-menuoption value="flights"&gt;
836
- &lt;auro-icon category="terminal" name="plane-diag-stroke" customcolor&gt;&lt;/auro-icon&gt; Flights
837
- &lt;/auro-menuoption&gt;
838
- &lt;auro-menuoption value="cars"&gt;
839
- &lt;auro-icon category="destination" name="car-rental-stroke" customcolor&gt;&lt;/auro-icon&gt; Cars
840
- &lt;/auro-menuoption&gt;
841
- &lt;auro-menuoption value="hotels"&gt;
842
- &lt;auro-icon category="destination" name="hotel-stroke" customcolor&gt;&lt;/auro-icon&gt; Hotels
843
- &lt;/auro-menuoption&gt;
844
- &lt;auro-menuoption value="packages"&gt;
845
- &lt;auro-icon category="shop" name="gift-stroke" customcolor&gt;&lt;/auro-icon&gt; Packages
846
- &lt;/auro-menuoption&gt;
847
- &lt;auro-menuoption value="cruises"&gt;
848
- &lt;auro-icon category="in-flight" name="boarding" customcolor&gt;&lt;/auro-icon&gt; Cruises
849
- &lt;/auro-menuoption&gt;
850
- &lt;/auro-menu&gt;
851
- &lt;/auro-select&gt;
852
- &lt;/div&gt;</code></pre>
853
- <!-- AURO-GENERATED-CONTENT:END -->
854
- </auro-accordion>
855
-
856
- #### Snowflake Layout
857
-
858
- The `snowflake` layout is a unique, one off layout that does not follow the normal pattern. There is only one way to use snowflake as shown in the following example.
859
-
860
- The `snowflake` layout is only expected to be used on dark backgrounds, in conjunction with `appearance="inverse"`.
861
-
862
- <div class="exampleWrapper--ondark">
863
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/snowflake/basic.html) -->
864
- <!-- The below content is automatically added from ./../apiExamples/snowflake/basic.html -->
865
- <auro-select layout="snowflake" shape="snowflake" appearance="inverse" required style="width:300px;">
866
- <span slot="ariaLabel.bib.close">Close Popup</span>
867
- <span slot="label">Label</span>
868
- <span slot="helpText">Help Text</span>
869
- <auro-menu nocheckmark>
870
- <auro-menuoption value="flights">
871
- <auro-icon category="terminal" name="plane-diag-stroke" customColor></auro-icon> Flights
872
- </auro-menuoption>
873
- <auro-menuoption value="cars">
874
- <auro-icon category="destination" name="car-rental-stroke" customColor></auro-icon> Cars
875
- </auro-menuoption>
876
- <auro-menuoption value="hotels">
877
- <auro-icon category="destination" name="hotel-stroke" customColor></auro-icon> Hotels
878
- </auro-menuoption>
879
- <auro-menuoption value="packages">
880
- <auro-icon category="shop" name="gift-stroke" customColor></auro-icon> Packages
881
- </auro-menuoption>
882
- <auro-menuoption value="cruises">
883
- <auro-icon category="in-flight" name="boarding" customColor></auro-icon> Cruises
884
- </auro-menuoption>
885
- </auro-menu>
886
- </auro-select>
887
- <!-- AURO-GENERATED-CONTENT:END -->
888
- </div>
889
- <auro-accordion alignRight>
890
- <span slot="trigger">See code</span>
891
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/snowflake/basic.html) -->
892
- <!-- The below code snippet is automatically added from ./../apiExamples/snowflake/basic.html -->
893
-
894
- <pre class="language-html"><code class="language-html">&lt;auro-select layout="snowflake" shape="snowflake" appearance="inverse" required style="width:300px;"&gt;
895
- &lt;span slot="ariaLabel.bib.close"&gt;Close Popup&lt;/span&gt;
896
- &lt;span slot="label"&gt;Label&lt;/span&gt;
897
- &lt;span slot="helpText"&gt;Help Text&lt;/span&gt;
898
- &lt;auro-menu nocheckmark&gt;
899
- &lt;auro-menuoption value="flights"&gt;
900
- &lt;auro-icon category="terminal" name="plane-diag-stroke" customColor&gt;&lt;/auro-icon&gt; Flights
901
- &lt;/auro-menuoption&gt;
902
- &lt;auro-menuoption value="cars"&gt;
903
- &lt;auro-icon category="destination" name="car-rental-stroke" customColor&gt;&lt;/auro-icon&gt; Cars
904
- &lt;/auro-menuoption&gt;
905
- &lt;auro-menuoption value="hotels"&gt;
906
- &lt;auro-icon category="destination" name="hotel-stroke" customColor&gt;&lt;/auro-icon&gt; Hotels
907
- &lt;/auro-menuoption&gt;
908
- &lt;auro-menuoption value="packages"&gt;
909
- &lt;auro-icon category="shop" name="gift-stroke" customColor&gt;&lt;/auro-icon&gt; Packages
910
- &lt;/auro-menuoption&gt;
911
- &lt;auro-menuoption value="cruises"&gt;
912
- &lt;auro-icon category="in-flight" name="boarding" customColor&gt;&lt;/auro-icon&gt; Cruises
913
- &lt;/auro-menuoption&gt;
914
- &lt;/auro-menu&gt;
915
- &lt;/auro-select&gt;</code></pre>
916
- <!-- AURO-GENERATED-CONTENT:END -->
917
- </auro-accordion>
918
-
919
- ### Multi-Select
920
-
921
- Sets multi-select mode, allowing multiple options to be selected at once.
922
-
923
- <div class="exampleWrapper">
924
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/multi-select.html) -->
925
- <!-- The below content is automatically added from ./../apiExamples/multi-select.html -->
926
- <auro-select multiselect>
927
- <span slot="bib.fullscreen.headline">Bib Headline</span>
928
- <label slot="placeholder">Select one or more options</label>
929
- <span slot="label">multiselect select example</span>
930
- <auro-menu>
931
- <auro-menuoption value="1">Option 1</auro-menuoption>
932
- <auro-menuoption value="2">Option 2</auro-menuoption>
933
- <auro-menuoption value="3">Option 3</auro-menuoption>
934
- </auro-menu>
935
- </auro-select>
936
- <!-- AURO-GENERATED-CONTENT:END -->
937
- </div>
938
- <auro-accordion alignRight>
939
- <span slot="trigger">See code</span>
940
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/multi-select.html) -->
941
- <!-- The below code snippet is automatically added from ./../apiExamples/multi-select.html -->
942
-
943
- <pre class="language-html"><code class="language-html">&lt;auro-select multiselect&gt;
944
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
945
- &lt;label slot="placeholder"&gt;Select one or more options&lt;/label&gt;
946
- &lt;span slot="label"&gt;multiselect select example&lt;/span&gt;
947
- &lt;auro-menu&gt;
948
- &lt;auro-menuoption value="1"&gt;Option 1&lt;/auro-menuoption&gt;
949
- &lt;auro-menuoption value="2"&gt;Option 2&lt;/auro-menuoption&gt;
950
- &lt;auro-menuoption value="3"&gt;Option 3&lt;/auro-menuoption&gt;
951
- &lt;/auro-menu&gt;
952
- &lt;/auro-select&gt;</code></pre>
953
- <!-- AURO-GENERATED-CONTENT:END -->
954
- </auro-accordion>
955
-
956
- ### No Checkmark
957
-
958
- Applying the `noCheckmark` attribute will prevent the checkmark icon from being shown on the selected option. The left padding to reserve space for the checkmark will not be shown.
959
-
960
- <div class="exampleWrapper">
961
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/no-checkmark.html) -->
962
- <!-- The below content is automatically added from ./../apiExamples/no-checkmark.html -->
963
- <auro-select nocheckmark placeholder="Placeholder Text">
964
- <span slot="bib.fullscreen.headline">Bib Headline</span>
965
- <span slot="label">Label</span>
966
- <auro-menu>
967
- <auro-menuoption value="stops">Stops</auro-menuoption>
968
- <auro-menuoption value="price">Price</auro-menuoption>
969
- <auro-menuoption value="duration">Duration</auro-menuoption>
970
- <auro-menuoption value="departure">Departure</auro-menuoption>
971
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
972
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
973
- </auro-menu>
974
- </auro-select>
975
- <!-- AURO-GENERATED-CONTENT:END -->
976
- </div>
977
- <auro-accordion alignRight>
978
- <span slot="trigger">See code</span>
979
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/no-checkmark.html) -->
980
- <!-- The below code snippet is automatically added from ./../apiExamples/no-checkmark.html -->
981
-
982
- <pre class="language-html"><code class="language-html">&lt;auro-select nocheckmark placeholder="Placeholder Text"&gt;
983
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
984
- &lt;span slot="label"&gt;Label&lt;/span&gt;
985
- &lt;auro-menu&gt;
986
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
987
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
988
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
989
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
990
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
991
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
992
- &lt;/auro-menu&gt;
993
- &lt;/auro-select&gt;</code></pre>
994
- <!-- AURO-GENERATED-CONTENT:END -->
995
- </auro-accordion>
996
-
997
- ### Customized Bib Position
998
-
999
- The bib position can be customized with `placement`, `offset`, `flip`, `autoPlacement`, and `shift` attributes.
1000
-
1001
- - `placement` specifies the preferred position where the bib should appear relative to the trigger.
1002
- - `offset` sets the distance between the trigger and the bib.
1003
- - 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`.
1004
- - Unless `noFlip` is enabled, if there isn't enough space for the preferred `placement`, the bib will automatically flip to an alternative position.
1005
- - `shift` when enabled, adjusts the bib position when it would overflow the viewport boundaries, ensuring it remains visible.
1006
-
1007
- <div class="exampleWrapper">
1008
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/floater-config.html) -->
1009
- <!-- The below content is automatically added from ./../apiExamples/floater-config.html -->
1010
- <div style="width: 350px">
1011
- <auro-select offset="20" noFlip placement="bottom-end">
1012
- <span slot="bib.fullscreen.headline">Bib Headline</span>
1013
- <span slot="label">Label</span>
1014
- <span slot="helpText">bottom-end bib with 20px offset and noFlip</span>
1015
- <auro-menu>
1016
- <auro-menuoption value="stops">Stops</auro-menuoption>
1017
- <auro-menuoption value="price">Price</auro-menuoption>
1018
- <auro-menuoption value="duration">Duration</auro-menuoption>
1019
- <auro-menuoption value="departure">Departure</auro-menuoption>
1020
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
1021
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
1022
- </auro-menu>
1023
- </auro-select>
1024
- <auro-select offset="20" placement="bottom-end">
1025
- <span slot="bib.fullscreen.headline">Bib Headline</span>
1026
- <span slot="label">Label</span>
1027
- <span slot="helpText">bottom-end bib with 20px offset and flip</span>
1028
- <auro-menu>
1029
- <auro-menuoption value="stops">Stops</auro-menuoption>
1030
- <auro-menuoption value="price">Price</auro-menuoption>
1031
- <auro-menuoption value="duration">Duration</auro-menuoption>
1032
- <auro-menuoption value="departure">Departure</auro-menuoption>
1033
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
1034
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
1035
- </auro-menu>
1036
- </auro-select>
1037
- <auro-select offset="20" noFlip placement="right">
1038
- <span slot="bib.fullscreen.headline">Bib Headline</span>
1039
- <span slot="label">Label</span>
1040
- <span slot="helpText">right bib with 20px offset and noFlip</span>
1041
- <auro-menu>
1042
- <auro-menuoption value="stops">Stops</auro-menuoption>
1043
- <auro-menuoption value="price">Price</auro-menuoption>
1044
- <auro-menuoption value="duration">Duration</auro-menuoption>
1045
- <auro-menuoption value="departure">Departure</auro-menuoption>
1046
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
1047
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
1048
- </auro-menu>
1049
- </auro-select>
1050
- <auro-select width="350px" offset="20" noFlip placement="bottom-start" shift>
1051
- <span slot="bib.fullscreen.headline">Bib Headline</span>
1052
- <span slot="label">Label</span>
1053
- <span slot="helpText">bottom-start bib with 20px offset, noFlip and shift</span>
1054
- <auro-menu>
1055
- <auro-menuoption value="stops">Stops</auro-menuoption>
1056
- <auro-menuoption value="price">Price</auro-menuoption>
1057
- <auro-menuoption value="duration">Duration</auro-menuoption>
1058
- <auro-menuoption value="departure">Departure</auro-menuoption>
1059
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
1060
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
1061
- </auro-menu>
1062
- </auro-select>
1063
- </div>
1064
- <!-- AURO-GENERATED-CONTENT:END -->
1065
- </div>
1066
- <auro-accordion alignRight>
1067
- <span slot="trigger">See code</span>
1068
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/floater-config.html) -->
1069
- <!-- The below code snippet is automatically added from ./../apiExamples/floater-config.html -->
1070
-
1071
- <pre class="language-html"><code class="language-html">&lt;div style="width: 350px"&gt;
1072
- &lt;auro-select offset="20" noFlip placement="bottom-end"&gt;
1073
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
1074
- &lt;span slot="label"&gt;Label&lt;/span&gt;
1075
- &lt;span slot="helpText"&gt;bottom-end bib with 20px offset and noFlip&lt;/span&gt;
1076
- &lt;auro-menu&gt;
1077
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
1078
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
1079
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
1080
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
1081
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
1082
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
1083
- &lt;/auro-menu&gt;
1084
- &lt;/auro-select&gt;
1085
- &lt;auro-select offset="20" placement="bottom-end"&gt;
1086
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
1087
- &lt;span slot="label"&gt;Label&lt;/span&gt;
1088
- &lt;span slot="helpText"&gt;bottom-end bib with 20px offset and flip&lt;/span&gt;
1089
- &lt;auro-menu&gt;
1090
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
1091
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
1092
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
1093
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
1094
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
1095
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
1096
- &lt;/auro-menu&gt;
1097
- &lt;/auro-select&gt;
1098
- &lt;auro-select offset="20" noFlip placement="right"&gt;
1099
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
1100
- &lt;span slot="label"&gt;Label&lt;/span&gt;
1101
- &lt;span slot="helpText"&gt;right bib with 20px offset and noFlip&lt;/span&gt;
1102
- &lt;auro-menu&gt;
1103
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
1104
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
1105
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
1106
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
1107
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
1108
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
1109
- &lt;/auro-menu&gt;
1110
- &lt;/auro-select&gt;
1111
- &lt;auro-select width="350px" offset="20" noFlip placement="bottom-start" shift&gt;
1112
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
1113
- &lt;span slot="label"&gt;Label&lt;/span&gt;
1114
- &lt;span slot="helpText"&gt;bottom-start bib with 20px offset, noFlip and shift&lt;/span&gt;
1115
- &lt;auro-menu&gt;
1116
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
1117
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
1118
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
1119
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
1120
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
1121
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
1122
- &lt;/auro-menu&gt;
1123
- &lt;/auro-select&gt;
1124
- &lt;/div&gt;</code></pre>
1125
- <!-- AURO-GENERATED-CONTENT:END -->
1126
- </auro-accordion>
1127
-
1128
- ### Placeholder
1129
-
1130
- Use the `placeholder` attribute to inject a custom placeholder option with the select element.
1131
-
1132
- <div class="exampleWrapper">
1133
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/placeholder.html) -->
1134
- <!-- The below content is automatically added from ./../apiExamples/placeholder.html -->
1135
- <auro-select placeholder="Please select your preferred option">
1136
- <span slot="bib.fullscreen.headline">Bib Headline</span>
1137
- <span slot="label">Label</span>
1138
- <auro-menu>
1139
- <auro-menuoption value="stops">Stops</auro-menuoption>
1140
- <auro-menuoption value="price">Price</auro-menuoption>
1141
- <auro-menuoption value="duration">Duration</auro-menuoption>
1142
- <auro-menuoption value="departure">Departure</auro-menuoption>
1143
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
1144
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
1145
- </auro-menu>
1146
- </auro-select>
1147
- <!-- AURO-GENERATED-CONTENT:END -->
1148
- </div>
1149
- <auro-accordion alignRight>
1150
- <span slot="trigger">See code</span>
1151
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/placeholder.html) -->
1152
- <!-- The below code snippet is automatically added from ./../apiExamples/placeholder.html -->
1153
-
1154
- <pre class="language-html"><code class="language-html">&lt;auro-select placeholder="Please select your preferred option"&gt;
1155
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
1156
- &lt;span slot="label"&gt;Label&lt;/span&gt;
1157
- &lt;auro-menu&gt;
1158
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
1159
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
1160
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
1161
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
1162
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
1163
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
1164
- &lt;/auro-menu&gt;
1165
- &lt;/auro-select&gt;</code></pre>
1166
- <!-- AURO-GENERATED-CONTENT:END -->
1167
- </auro-accordion>
1168
-
1169
- ### Required
1170
-
1171
- When present, the `required` attribute specifies that a select field must be filled out before submitting the form.
1172
-
1173
- When the validity check fails the validityState, equals `valueMissing`. The error message for the `valueMissing` validityState can be set to a custom string using the `setCustomValidityValueMissing`. There is no default error message defined.
1174
-
1175
- <div class="exampleWrapper">
1176
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/required.html) -->
1177
- <!-- The below content is automatically added from ./../apiExamples/required.html -->
1178
- <auro-select required setCustomValidityValueMissing="Custom required validation error message." placeholder="Placeholder Text">
1179
- <span slot="bib.fullscreen.headline">Bib Headline</span>
1180
- <span slot="label">Label</span>
1181
- <auro-menu>
1182
- <auro-menuoption value="stops">Stops</auro-menuoption>
1183
- <auro-menuoption value="price">Price</auro-menuoption>
1184
- <auro-menuoption value="duration">Duration</auro-menuoption>
1185
- <auro-menuoption value="departure">Departure</auro-menuoption>
1186
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
1187
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
1188
- </auro-menu>
1189
- </auro-select>
1190
- <!-- AURO-GENERATED-CONTENT:END -->
1191
- </div>
1192
- <auro-accordion alignRight>
1193
- <span slot="trigger">See code</span>
1194
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/required.html) -->
1195
- <!-- The below code snippet is automatically added from ./../apiExamples/required.html -->
1196
-
1197
- <pre class="language-html"><code class="language-html">&lt;auro-select required setCustomValidityValueMissing="Custom required validation error message." placeholder="Placeholder Text"&gt;
1198
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
1199
- &lt;span slot="label"&gt;Label&lt;/span&gt;
1200
- &lt;auro-menu&gt;
1201
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
1202
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
1203
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
1204
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
1205
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
1206
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
1207
- &lt;/auro-menu&gt;
1208
- &lt;/auro-select&gt;</code></pre>
1209
- <!-- AURO-GENERATED-CONTENT:END -->
1210
- </auro-accordion>
1211
-
1212
- ### Value
1213
-
1214
- Use the `value` property to define a preset value on the `auro-select` element. The `value` of `auro-select` must match the `value` defined of a single `auro-menuoption`. Upon initially rendering the component, if the `value` does not match an `auro-menuoption`, the `value` of `auro-select` will be set to `undefined`.
1215
-
1216
- To pre-set the value of auro-select on load, use the `value` property. The `selected` attribute on auro-menuoption is designed to illustrate state in the DOM.
1217
-
1218
- <div class="exampleWrapper">
1219
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/value.html) -->
1220
- <!-- The below content is automatically added from ./../apiExamples/value.html -->
1221
- <auro-button id="validValueExampleBtn">Set Value to Valid Option</auro-button>
1222
- <auro-button id="invalidValueExampleBtn">Set Value to Invalid Option</auro-button>
1223
- <br/><br/>
1224
- <auro-select id="valueExample" multiselect value='["price", "duration"]'>
1225
- <span slot="bib.fullscreen.headline">Bib Headline</span>
1226
- <span slot="label">Name</span>
1227
- <auro-menu>
1228
- <auro-menuoption id="option-0" value="stops">Stops</auro-menuoption>
1229
- <auro-menuoption id="option-1" value="price">Price</auro-menuoption>
1230
- <auro-menuoption id="option-2" value="duration">Duration</auro-menuoption>
1231
- <auro-menuoption id="option-3" value="departure">Departure</auro-menuoption>
1232
- <auro-menuoption id="option-4" value="arrival">Arrival</auro-menuoption>
1233
- <auro-menuoption id="option-5" value="prefer alaska">Prefer Alaska</auro-menuoption>
1234
- </auro-menu>
1235
- </auro-select>
1236
- <!-- AURO-GENERATED-CONTENT:END -->
1237
- </div>
1238
- <auro-accordion alignRight>
1239
- <span slot="trigger">See code</span>
1240
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/value.html) -->
1241
- <!-- The below code snippet is automatically added from ./../apiExamples/value.html -->
1242
-
1243
- <pre class="language-html"><code class="language-html">&lt;auro-button id="validValueExampleBtn"&gt;Set Value to Valid Option&lt;/auro-button&gt;
1244
- &lt;auro-button id="invalidValueExampleBtn"&gt;Set Value to Invalid Option&lt;/auro-button&gt;
1245
- &lt;br/&gt;&lt;br/&gt;
1246
- &lt;auro-select id="valueExample" multiselect value='["price", "duration"]'&gt;
1247
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
1248
- &lt;span slot="label"&gt;Name&lt;/span&gt;
1249
- &lt;auro-menu&gt;
1250
- &lt;auro-menuoption id="option-0" value="stops"&gt;Stops&lt;/auro-menuoption&gt;
1251
- &lt;auro-menuoption id="option-1" value="price"&gt;Price&lt;/auro-menuoption&gt;
1252
- &lt;auro-menuoption id="option-2" value="duration"&gt;Duration&lt;/auro-menuoption&gt;
1253
- &lt;auro-menuoption id="option-3" value="departure"&gt;Departure&lt;/auro-menuoption&gt;
1254
- &lt;auro-menuoption id="option-4" value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
1255
- &lt;auro-menuoption id="option-5" value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
1256
- &lt;/auro-menu&gt;
1257
- &lt;/auro-select&gt;</code></pre>
1258
- <!-- AURO-GENERATED-CONTENT:END -->
1259
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/value.js) -->
1260
- <!-- The below code snippet is automatically added from ./../apiExamples/value.js -->
1261
-
1262
- <pre class="language-js"><code class="language-js">export function valueExample() {
1263
- const valueExample = document.querySelector('#valueExample');
1264
-
1265
- document.querySelector('#validValueExampleBtn').addEventListener('click', () =&gt; {
1266
- valueExample.value = '["arrival", "prefer alaska"]';
1267
- });
1268
-
1269
- document.querySelector('#invalidValueExampleBtn').addEventListener('click', () =&gt; {
1270
- valueExample.value = '["flight course"]';
1271
- });
1272
- }</code></pre>
1273
- <!-- AURO-GENERATED-CONTENT:END -->
1274
- </auro-accordion>
1275
-
1276
- ## Method Examples
1277
-
1278
- ### Reset State
1279
-
1280
- Use the `reset()` method to reset the `<auro-select>`'s `value` and `validity` state. Doing so will preserve all other attributes and properties.
1281
-
1282
- <div class="exampleWrapper">
1283
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/reset-state.html) -->
1284
- <!-- The below content is automatically added from ./../apiExamples/reset-state.html -->
1285
- <auro-button id="resetStateBtn">Reset</auro-button>
1286
- <br/><br/>
1287
- <auro-select id="resetStateExample" value="price">
1288
- <span slot="bib.fullscreen.headline">Bib Headline</span>
1289
- <span slot="label">Label</span>
1290
- <auro-menu>
1291
- <auro-menuoption value="stops">Stops</auro-menuoption>
1292
- <auro-menuoption value="price">Price</auro-menuoption>
1293
- <auro-menuoption value="duration">Duration</auro-menuoption>
1294
- <auro-menuoption value="departure">Departure</auro-menuoption>
1295
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
1296
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
1297
- </auro-menu>
1298
- </auro-select>
1299
- <!-- AURO-GENERATED-CONTENT:END -->
1300
- </div>
1301
- <auro-accordion alignRight>
1302
- <span slot="trigger">See code</span>
1303
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/reset-state.html) -->
1304
- <!-- The below code snippet is automatically added from ./../apiExamples/reset-state.html -->
1305
-
1306
- <pre class="language-html"><code class="language-html">&lt;auro-button id="resetStateBtn"&gt;Reset&lt;/auro-button&gt;
1307
- &lt;br/&gt;&lt;br/&gt;
1308
- &lt;auro-select id="resetStateExample" value="price"&gt;
1309
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
1310
- &lt;span slot="label"&gt;Label&lt;/span&gt;
1311
- &lt;auro-menu&gt;
1312
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
1313
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
1314
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
1315
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
1316
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
1317
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
1318
- &lt;/auro-menu&gt;
1319
- &lt;/auro-select&gt;</code></pre>
1320
- <!-- AURO-GENERATED-CONTENT:END -->
1321
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/reset-state.js) -->
1322
- <!-- The below code snippet is automatically added from ./../apiExamples/reset-state.js -->
1323
-
1324
- <pre class="language-js"><code class="language-js">export function resetStateExample() {
1325
- const elem = document.querySelector('#resetStateExample');
1326
-
1327
- document.querySelector('#resetStateBtn').addEventListener('click', () =&gt; {
1328
- elem.reset();
1329
- });
1330
- }</code></pre>
1331
- <!-- AURO-GENERATED-CONTENT:END -->
1332
- </auro-accordion>
1333
-
1334
- ### Update Active Option
1335
-
1336
- Use the `updateActiveOption(index)` method to programmatically set the active option in the menu.
1337
-
1338
- <div class="exampleWrapper">
1339
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/update-active-option.html) -->
1340
- <!-- The below content is automatically added from ./../apiExamples/update-active-option.html -->
1341
- <auro-select id="updateActiveOptionExample">
1342
- <span slot="ariaLabel.bib.close">Close Popup</span>
1343
- <span slot="bib.fullscreen.headline">Bib Headline</span>
1344
- <span slot="label">Select Example</span>
1345
- <auro-menu>
1346
- <auro-menuoption value="stops">Stops</auro-menuoption>
1347
- <auro-menuoption value="price">Price</auro-menuoption>
1348
- <auro-menuoption value="duration">Duration</auro-menuoption>
1349
- <auro-menuoption value="departure">Departure</auro-menuoption>
1350
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
1351
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
1352
- </auro-menu>
1353
- </auro-select>
1354
- <!-- AURO-GENERATED-CONTENT:END -->
1355
- </div>
1356
- <auro-accordion alignRight>
1357
- <span slot="trigger">See code</span>
1358
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/update-active-option.html) -->
1359
- <!-- The below code snippet is automatically added from ./../apiExamples/update-active-option.html -->
1360
-
1361
- <pre class="language-html"><code class="language-html">&lt;auro-select id="updateActiveOptionExample"&gt;
1362
- &lt;span slot="ariaLabel.bib.close"&gt;Close Popup&lt;/span&gt;
1363
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
1364
- &lt;span slot="label"&gt;Select Example&lt;/span&gt;
1365
- &lt;auro-menu&gt;
1366
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
1367
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
1368
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
1369
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
1370
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
1371
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
1372
- &lt;/auro-menu&gt;
1373
- &lt;/auro-select&gt;</code></pre>
1374
- <!-- AURO-GENERATED-CONTENT:END -->
1375
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/update-active-option.js) -->
1376
- <!-- The below code snippet is automatically added from ./../apiExamples/update-active-option.js -->
1377
-
1378
- <pre class="language-js"><code class="language-js">export function updateActiveOptionExample() {
1379
- const select = document.getElementById('updateActiveOptionExample');
1380
- const dropdown = select.dropdown;
1381
-
1382
- dropdown.addEventListener('auroDropdown-toggled', () =&gt; {
1383
- if (dropdown.isPopoverVisible) {
1384
- select.updateActiveOption(2); // Set the active option to the third item (index 2)
1385
- }
1386
- });
1387
- }</code></pre>
1388
- <!-- AURO-GENERATED-CONTENT:END -->
1389
- </auro-accordion>
1390
-
1391
- ## Slot Examples
1392
-
1393
- ### Custom Value Display
1394
-
1395
- The `auro-select` supports the new formkit feature set enabling customized content displayed when a value is selected.
1396
-
1397
- e.g. You may have a menu option that reads "SeaTac International Airport". However, when that option is selected, you would like the value displayed in the auro-select to just be the airport code "SEA".
1398
-
1399
- The custom display value content is inserted using `slot="displayValue"` on each menu option. The `auro-select` component does not style or restrict the slotted content. It is the responsibility of the implementor to insure the content fits within the auro-select container and is styled appropriately.
1400
-
1401
- The following example demonstrates menu options with an icon and text. When selected, the auro-select renders an icon with no text.
1402
-
1403
- <div class="exampleWrapper">
1404
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/emphasized/constant-display-value.html) -->
1405
- <!-- The below content is automatically added from ./../apiExamples/emphasized/constant-display-value.html -->
1406
- <auro-select layout="emphasized" shape="pill" size="xl" value="flights" forceDisplayValue style="display:inline-block;">
1407
- <span slot="label">Select Example</span>
1408
- <auro-menu nocheckmark>
1409
- <auro-menuoption value="flights">
1410
- <auro-icon category="terminal" name="plane-diag-stroke" customcolor></auro-icon> Flights
1411
- <auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="terminal" name="plane-diag-fill" customcolor></auro-icon>
1412
- </auro-menuoption>
1413
- <auro-menuoption value="cars">
1414
- <auro-icon category="destination" name="car-rental-stroke" customcolor></auro-icon> Cars
1415
- <auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="destination" name="car-rental-stroke" customcolor></auro-icon>
1416
- </auro-menuoption>
1417
- <auro-menuoption value="hotels">
1418
- <auro-icon category="destination" name="hotel-stroke" customcolor></auro-icon> Hotels
1419
- <auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="destination" name="hotel-filled" customcolor></auro-icon>
1420
- </auro-menuoption>
1421
- <auro-menuoption value="packages">
1422
- <auro-icon category="shop" name="gift-stroke" customcolor></auro-icon> Packages
1423
- <auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="shop" name="gift-filled" customcolor></auro-icon>
1424
- </auro-menuoption>
1425
- <auro-menuoption value="cruises">
1426
- <auro-icon category="in-flight" name="boarding" customcolor></auro-icon> Cruises
1427
- <auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="in-flight" name="boarding" customcolor></auro-icon>
1428
- </auro-menuoption>
1429
- </auro-menu>
1430
- </auro-select>
1431
- <!-- AURO-GENERATED-CONTENT:END -->
1432
- </div>
1433
- <auro-accordion alignRight>
1434
- <span slot="trigger">See code</span>
1435
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/emphasized/constant-display-value.html) -->
1436
- <!-- The below code snippet is automatically added from ./../apiExamples/emphasized/constant-display-value.html -->
1437
-
1438
- <pre class="language-html"><code class="language-html">&lt;auro-select layout="emphasized" shape="pill" size="xl" value="flights" forceDisplayValue style="display:inline-block;"&gt;
1439
- &lt;span slot="label"&gt;Select Example&lt;/span&gt;
1440
- &lt;auro-menu nocheckmark&gt;
1441
- &lt;auro-menuoption value="flights"&gt;
1442
- &lt;auro-icon category="terminal" name="plane-diag-stroke" customcolor&gt;&lt;/auro-icon&gt; Flights
1443
- &lt;auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="terminal" name="plane-diag-fill" customcolor&gt;&lt;/auro-icon&gt;
1444
- &lt;/auro-menuoption&gt;
1445
- &lt;auro-menuoption value="cars"&gt;
1446
- &lt;auro-icon category="destination" name="car-rental-stroke" customcolor&gt;&lt;/auro-icon&gt; Cars
1447
- &lt;auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="destination" name="car-rental-stroke" customcolor&gt;&lt;/auro-icon&gt;
1448
- &lt;/auro-menuoption&gt;
1449
- &lt;auro-menuoption value="hotels"&gt;
1450
- &lt;auro-icon category="destination" name="hotel-stroke" customcolor&gt;&lt;/auro-icon&gt; Hotels
1451
- &lt;auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="destination" name="hotel-filled" customcolor&gt;&lt;/auro-icon&gt;
1452
- &lt;/auro-menuoption&gt;
1453
- &lt;auro-menuoption value="packages"&gt;
1454
- &lt;auro-icon category="shop" name="gift-stroke" customcolor&gt;&lt;/auro-icon&gt; Packages
1455
- &lt;auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="shop" name="gift-filled" customcolor&gt;&lt;/auro-icon&gt;
1456
- &lt;/auro-menuoption&gt;
1457
- &lt;auro-menuoption value="cruises"&gt;
1458
- &lt;auro-icon category="in-flight" name="boarding" customcolor&gt;&lt;/auro-icon&gt; Cruises
1459
- &lt;auro-icon style="--ds-auro-icon-size: 40px;" slot="displayValue" category="in-flight" name="boarding" customcolor&gt;&lt;/auro-icon&gt;
1460
- &lt;/auro-menuoption&gt;
1461
- &lt;/auro-menu&gt;
1462
- &lt;/auro-select&gt;</code></pre>
1463
- <!-- AURO-GENERATED-CONTENT:END -->
1464
- </auro-accordion>
1465
-
1466
- ### Help Text
1467
-
1468
- Use the `helpText` slot to provide additional information back to your user about their selection option(s).
1469
-
1470
- <div class="exampleWrapper">
1471
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/help-text.html) -->
1472
- <!-- The below content is automatically added from ./../apiExamples/help-text.html -->
1473
- <auro-select placeholder="Placeholder Text">
1474
- <span slot="bib.fullscreen.headline">Bib Headline</span>
1475
- <span slot="label">Label</span>
1476
- <span slot="helpText">Custom help text message.</span>
1477
- <auro-menu>
1478
- <auro-menuoption value="stops">Stops</auro-menuoption>
1479
- <auro-menuoption value="price">Price</auro-menuoption>
1480
- <auro-menuoption value="duration">Duration</auro-menuoption>
1481
- <auro-menuoption value="departure">Departure</auro-menuoption>
1482
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
1483
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
1484
- </auro-menu>
1485
- </auro-select>
1486
- <!-- AURO-GENERATED-CONTENT:END -->
1487
- </div>
1488
- <auro-accordion alignRight>
1489
- <span slot="trigger">See code</span>
1490
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/help-text.html) -->
1491
- <!-- The below code snippet is automatically added from ./../apiExamples/help-text.html -->
1492
-
1493
- <pre class="language-html"><code class="language-html">&lt;auro-select placeholder="Placeholder Text"&gt;
1494
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
1495
- &lt;span slot="label"&gt;Label&lt;/span&gt;
1496
- &lt;span slot="helpText"&gt;Custom help text message.&lt;/span&gt;
1497
- &lt;auro-menu&gt;
1498
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
1499
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
1500
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
1501
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
1502
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
1503
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
1504
- &lt;/auro-menu&gt;
1505
- &lt;/auro-select&gt;</code></pre>
1506
- <!-- AURO-GENERATED-CONTENT:END -->
1507
- </auro-accordion>
1508
-
1509
- ### Label
1510
-
1511
- Use the `label` slot to give your users contextual information about their selection options. This `label` content is also helpful for assistive devices.
1512
-
1513
- <div class="exampleWrapper">
1514
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/label.html) -->
1515
- <!-- The below content is automatically added from ./../apiExamples/label.html -->
1516
- <auro-select>
1517
- <span slot="bib.fullscreen.headline">Bib Headline</span>
1518
- <span slot="label">Please select a preference</span>
1519
- <auro-menu>
1520
- <auro-menuoption value="stops">Stops</auro-menuoption>
1521
- <auro-menuoption value="price">Price</auro-menuoption>
1522
- <auro-menuoption value="duration">Duration</auro-menuoption>
1523
- <auro-menuoption value="departure">Departure</auro-menuoption>
1524
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
1525
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
1526
- </auro-menu>
1527
- </auro-select>
1528
- <!-- AURO-GENERATED-CONTENT:END -->
1529
- </div>
1530
- <auro-accordion alignRight>
1531
- <span slot="trigger">See code</span>
1532
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/label.html) -->
1533
- <!-- The below code snippet is automatically added from ./../apiExamples/label.html -->
1534
-
1535
- <pre class="language-html"><code class="language-html">&lt;auro-select&gt;
1536
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
1537
- &lt;span slot="label"&gt;Please select a preference&lt;/span&gt;
1538
- &lt;auro-menu&gt;
1539
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
1540
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
1541
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
1542
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
1543
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
1544
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
1545
- &lt;/auro-menu&gt;
1546
- &lt;/auro-select&gt;</code></pre>
1547
- <!-- AURO-GENERATED-CONTENT:END -->
1548
- </auro-accordion>
1549
-
1550
- ### Optional Label
1551
-
1552
- The `<auro-select>` supports an `optionalLabel` slot, where users can can override the default `(optional)` notification text.
1553
-
1554
- <div class="exampleWrapper">
1555
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/optional-label.html) -->
1556
- <!-- The below content is automatically added from ./../apiExamples/optional-label.html -->
1557
- <auro-select>
1558
- <span slot="bib.fullscreen.headline">Bib Headline</span>
1559
- <span slot="label">Please select a preference</span>
1560
- <span slot="optionalLabel" style="color: grey; font-size: small"> - optional</span>
1561
- <auro-menu>
1562
- <auro-menuoption value="stops">Stops</auro-menuoption>
1563
- <auro-menuoption value="price">Price</auro-menuoption>
1564
- <auro-menuoption value="duration">Duration</auro-menuoption>
1565
- <auro-menuoption value="departure">Departure</auro-menuoption>
1566
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
1567
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
1568
- </auro-menu>
1569
- </auro-select>
1570
- <!-- AURO-GENERATED-CONTENT:END -->
1571
- </div>
1572
- <auro-accordion alignRight>
1573
- <span slot="trigger">See code</span>
1574
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/optional-label.html) -->
1575
- <!-- The below code snippet is automatically added from ./../apiExamples/optional-label.html -->
1576
-
1577
- <pre class="language-html"><code class="language-html">&lt;auro-select&gt;
1578
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
1579
- &lt;span slot="label"&gt;Please select a preference&lt;/span&gt;
1580
- &lt;span slot="optionalLabel" style="color: grey; font-size: small"&gt; - optional&lt;/span&gt;
1581
- &lt;auro-menu&gt;
1582
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
1583
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
1584
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
1585
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
1586
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
1587
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
1588
- &lt;/auro-menu&gt;
1589
- &lt;/auro-select&gt;</code></pre>
1590
- <!-- AURO-GENERATED-CONTENT:END -->
1591
- </auro-accordion>
1592
-
1593
- ## CSS Shadow Part Examples
1594
-
1595
- ### Custom Bib Height
1596
-
1597
- This example shows how to set a custom height for the bib from `<auro-dropdown>`.
1598
-
1599
- Custom height dimensions are set by using the `dropdownSize` CSS Part and then applying a `max-height` rule and value.
1600
-
1601
- <div class="exampleWrapper">
1602
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/custom-bib-height.html) -->
1603
- <!-- The below content is automatically added from ../apiExamples/custom-bib-height.html -->
1604
- <auro-select id="customBibHeightExample" value="pit">
1605
- <span slot="bib.fullscreen.headline">Bib Headline</span>
1606
- <span slot="label">Label</span>
1607
- <auro-menu>
1608
- <auro-menuoption value="fca" id="airport-fca" suggest="fca montana kalispell">glacier park international</auro-menuoption>
1609
- <auro-menuoption value="sfo" id="airport-sfo" suggest="sfo california san francisco">san francisco international</auro-menuoption>
1610
- <auro-menuoption value="boi" id="airport-boi" suggest="boi idaho boise">gowen field</auro-menuoption>
1611
- <auro-menuoption value="stl" id="airport-stl" suggest="stl missouri st louis">lambert st louis international</auro-menuoption>
1612
- <auro-menuoption value="ylw" id="airport-ylw" suggest="ylw british columbia kelowna">kelowna international</auro-menuoption>
1613
- <auro-menuoption value="ykm" id="airport-ykm" suggest="ykm washington yakima">yakima air terminal</auro-menuoption>
1614
- <auro-menuoption value="puw" id="airport-puw" suggest="puw washington pullman">pullman moscow regional</auro-menuoption>
1615
- <auro-menuoption value="yeg" id="airport-yeg" suggest="yeg alberta edmonton">edmonton international</auro-menuoption>
1616
- <auro-menuoption value="tpa" id="airport-tpa" suggest="tpa florida tampa">tampa international</auro-menuoption>
1617
- <auro-menuoption value="msp" id="airport-msp" suggest="msp minnesota minneapolis">minneapolis st paul international</auro-menuoption>
1618
- <auro-menuoption value="ida" id="airport-ida" suggest="ida idaho idaho falls">idaho falls regional airport</auro-menuoption>
1619
- <auro-menuoption value="mfr" id="airport-mfr" suggest="mfr oregon medford">rogue valley international</auro-menuoption>
1620
- <auro-menuoption value="psp" id="airport-psp" suggest="psp california palm springs">palm springs international</auro-menuoption>
1621
- <auro-menuoption value="lir" id="airport-lir" suggest="lir guanacaste liberia">guanacaste airport</auro-menuoption>
1622
- <auro-menuoption value="oak" id="airport-oak" suggest="oak california oakland">oakland international</auro-menuoption>
1623
- <auro-menuoption value="bos" id="airport-bos" suggest="bos massachusetts boston">logan international</auro-menuoption>
1624
- <auro-menuoption value="bwi" id="airport-bwi" suggest="bwi maryland baltimore">thurgood marshall international</auro-menuoption>
1625
- <auro-menuoption value="dal" id="airport-dal" suggest="dal texas dallas">dallas love field</auro-menuoption>
1626
- <auro-menuoption value="sba" id="airport-sba" suggest="sba california santa barbara">santa barbara municipal</auro-menuoption>
1627
- <auro-menuoption value="mci" id="airport-mci" suggest="mci missouri kansas city">kansas city international</auro-menuoption>
1628
- <auro-menuoption value="koa" id="airport-koa" suggest="koa hawaii kona">kona international</auro-menuoption>
1629
- <auro-menuoption value="pvr" id="airport-pvr" suggest="pvr jalisco puerto vallarta">licenciado gustavo diaz ordaz international</auro-menuoption>
1630
- <auro-menuoption value="wrg" id="airport-wrg" suggest="wrg alaska wrangell">wrangell</auro-menuoption>
1631
- <auro-menuoption value="scc" id="airport-scc" suggest="scc alaska prudhoe bay">deadhorse</auro-menuoption>
1632
- <auro-menuoption value="lto" id="airport-lto" suggest="lto baja california loreto">loreto international</auro-menuoption>
1633
- <auro-menuoption value="ome" id="airport-ome" suggest="ome alaska nome">nome</auro-menuoption>
1634
- <auro-menuoption value="ict" id="airport-ict" suggest="ict kansas wichita">dwight d eisenhower national</auro-menuoption>
1635
- <auro-menuoption value="phl" id="airport-phl" suggest="phl pennsylvania philadelphia">philadelphia international</auro-menuoption>
1636
- <auro-menuoption value="dfw" id="airport-dfw" suggest="dfw texas dallas">dallas fort worth international</auro-menuoption>
1637
- <auro-menuoption value="ind" id="airport-ind" suggest="ind indiana indianapolis">indianapolis international</auro-menuoption>
1638
- <auro-menuoption value="smf" id="airport-smf" suggest="smf california sacramento">sacramento international</auro-menuoption>
1639
- <auro-menuoption value="sit" id="airport-sit" suggest="sit alaska sitka">rocky gutierrez</auro-menuoption>
1640
- <auro-menuoption value="dut" id="airport-dut" suggest="dut alaska dutch harbor">unalaska</auro-menuoption>
1641
- <auro-menuoption value="cdv" id="airport-cdv" suggest="cdv alaska cordova">merle mudhole smith</auro-menuoption>
1642
- <auro-menuoption value="psg" id="airport-psg" suggest="psg alaska petersburg">james a johnson</auro-menuoption>
1643
- <auro-menuoption value="bna" id="airport-bna" suggest="bna tennessee nashville">nashville international</auro-menuoption>
1644
- <auro-menuoption value="geg" id="airport-geg" suggest="geg washington spokane">spokane international</auro-menuoption>
1645
- <auro-menuoption value="ktn" id="airport-ktn" suggest="ktn alaska ketchikan">ketchikan international</auro-menuoption>
1646
- <auro-menuoption value="pit" id="airport-pit" suggest="pit pennsylvania pittsburgh">pittsburgh international</auro-menuoption>
1647
- <auro-menuoption value="sbp" id="airport-sbp" suggest="sbp california san luis obispo">san luis obispo regional</auro-menuoption>
1648
- <auro-menuoption value="bur" id="airport-bur" suggest="bur california burbank">hollywood burbank</auro-menuoption>
1649
- <auro-menuoption value="msy" id="airport-msy" suggest="msy louisiana new orleans">louis armstrong international</auro-menuoption>
1650
- <auro-menuoption value="pae" id="airport-pae" suggest="pae washington everett">paine field</auro-menuoption>
1651
- <auro-menuoption value="cvg" id="airport-cvg" suggest="cvg ohio cincinnati">cincinnati northern kentucky international</auro-menuoption>
1652
- <auro-menuoption value="yak" id="airport-yak" suggest="yak alaska yakutat">yakutat</auro-menuoption>
1653
- <auro-menuoption value="pdx" id="airport-pdx" suggest="pdx oregon portland">portland international</auro-menuoption>
1654
- <auro-menuoption value="anc" id="airport-anc" suggest="anc alaska anchorage">ted stevens</auro-menuoption>
1655
- <auro-menuoption value="sea" id="airport-sea" suggest="sea washington seattle">seattle tacoma international</auro-menuoption>
1656
- <auro-menuoption value="san" id="airport-san" suggest="san california san diego">san diego international</auro-menuoption>
1657
- <auro-menuoption value="sat" id="airport-sat" suggest="sat texas san antonio">san antonio international</auro-menuoption>
1658
- <auro-menuoption value="fat" id="airport-fat" suggest="fat california fresno">fresno yosemite international</auro-menuoption>
1659
- <auro-menuoption value="aus" id="airport-aus" suggest="aus texas austin">austin bergstrom international</auro-menuoption>
1660
- <auro-menuoption value="ord" id="airport-ord" suggest="ord illinois chicago">ohare international</auro-menuoption>
1661
- <auro-menuoption value="gdl" id="airport-gdl" suggest="gdl jalisco guadalajara">guadalajara international</auro-menuoption>
1662
- <auro-menuoption value="sjc" id="airport-sjc" suggest="sjc california san jose">san jose international</auro-menuoption>
1663
- <auro-menuoption value="jnu" id="airport-jnu" suggest="jnu alaska juneau">juneau international</auro-menuoption>
1664
- <auro-menuoption value="rdm" id="airport-rdm" suggest="rdm oregon redmond">roberts field</auro-menuoption>
1665
- <auro-menuoption value="sts" id="airport-sts" suggest="sts california sonoma">charles m schulz</auro-menuoption>
1666
- <auro-menuoption value="fai" id="airport-fai" suggest="fai alaska fairbanks">fairbanks international</auro-menuoption>
1667
- <auro-menuoption value="rdu" id="airport-rdu" suggest="rdu north carolina raleigh">raleigh durham international</auro-menuoption>
1668
- <auro-menuoption value="oma" id="airport-oma" suggest="oma nebraska omaha">eppley airfield</auro-menuoption>
1669
- <auro-menuoption value="bzn" id="airport-bzn" suggest="bzn montana bozeman">bozeman yellowstone international</auro-menuoption>
1670
- <auro-menuoption value="ont" id="airport-ont" suggest="ont california ontario">ontario international</auro-menuoption>
1671
- <auro-menuoption value="ogg" id="airport-ogg" suggest="ogg hawaii maui">kahului international</auro-menuoption>
1672
- <auro-menuoption value="sun" id="airport-sun" suggest="sun idaho sun valley">friedman memorial</auro-menuoption>
1673
- <auro-menuoption value="mzt" id="airport-mzt" suggest="mzt sinaloa mazatlan">general rafael buelna international</auro-menuoption>
1674
- <auro-menuoption value="dlg" id="airport-dlg" suggest="dlg alaska dillingham">dillingham</auro-menuoption>
1675
- <auro-menuoption value="adq" id="airport-adq" suggest="adq alaska kodiak">kodiak</auro-menuoption>
1676
- <auro-menuoption value="den" id="airport-den" suggest="den colorado denver">denver international</auro-menuoption>
1677
- <auro-menuoption value="zlo" id="airport-zlo" suggest="zlo colima manzanillo">manzanillo international</auro-menuoption>
1678
- <auro-menuoption value="sjd" id="airport-sjd" suggest="sjd baja california los cabos">los cabos international</auro-menuoption>
1679
- <auro-menuoption value="elp" id="airport-elp" suggest="elp texas el paso">el paso international airport</auro-menuoption>
1680
- <auro-menuoption value="atl" id="airport-atl" suggest="atl georgia atlanta">hartsfield jackson international</auro-menuoption>
1681
- <auro-menuoption value="lax" id="airport-lax" suggest="lax california los angeles">los angeles international</auro-menuoption>
1682
- <auro-menuoption value="rsw" id="airport-rsw" suggest="rsw florida fort myers">southwest florida international</auro-menuoption>
1683
- <auro-menuoption value="cle" id="airport-cle" suggest="cle ohio cleveland">cleveland hopkins international airport</auro-menuoption>
1684
- <auro-menuoption value="otz" id="airport-otz" suggest="otz alaska kotzebue">ralph wien memorial</auro-menuoption>
1685
- <auro-menuoption value="bze" id="airport-bze" suggest="bze belize belize city">philip sw goldson international airport</auro-menuoption>
1686
- <auro-menuoption value="eat" id="airport-eat" suggest="eat washington wenatchee">pangborn memorial</auro-menuoption>
1687
- <auro-menuoption value="dtw" id="airport-dtw" suggest="dtw michigan detroit">detroit metropolitan</auro-menuoption>
1688
- <auro-menuoption value="bet" id="airport-bet" suggest="bet alaska bethel">bethel</auro-menuoption>
1689
- <auro-menuoption value="dca" id="airport-dca" suggest="dca district of columbia washington">ronald reagan national</auro-menuoption>
1690
- <auro-menuoption value="rno" id="airport-rno" suggest="rno nevada reno">reno tahoe international</auro-menuoption>
1691
- <auro-menuoption value="brw" id="airport-brw" suggest="brw alaska barrow">wiley post will rogers</auro-menuoption>
1692
- <auro-menuoption value="mry" id="airport-mry" suggest="mry california monterey">monterey regional</auro-menuoption>
1693
- <auro-menuoption value="hnl" id="airport-hnl" suggest="hnl hawaii oahu">honolulu international</auro-menuoption>
1694
- <auro-menuoption value="okc" id="airport-okc" suggest="okc oklahoma oklahoma city">will rogers world</auro-menuoption>
1695
- <auro-menuoption value="iad" id="airport-iad" suggest="iad virginia dulles">washington dulles international</auro-menuoption>
1696
- <auro-menuoption value="mia" id="airport-mia" suggest="mia florida miami">miami international</auro-menuoption>
1697
- <auro-menuoption value="bli" id="airport-bli" suggest="bli washington bellingham">bellingham international</auro-menuoption>
1698
- <auro-menuoption value="hln" id="airport-hln" suggest="hln montana helena">helena regional</auro-menuoption>
1699
- <auro-menuoption value="gtf" id="airport-gtf" suggest="gtf montana great falls">great falls international</auro-menuoption>
1700
- <auro-menuoption value="zih" id="airport-zih" suggest="zih guerrero zihuatanejo">ixtapa zihuatanejo international</auro-menuoption>
1701
- <auro-menuoption value="yyc" id="airport-yyc" suggest="yyc alberta calgary">calgary international</auro-menuoption>
1702
- <auro-menuoption value="sna" id="airport-sna" suggest="sna california santa ana">john wayne</auro-menuoption>
1703
- <auro-menuoption value="fll" id="airport-fll" suggest="fll florida fort lauderdale">fort lauderdale hollywood international</auro-menuoption>
1704
- <auro-menuoption value="ewr" id="airport-ewr" suggest="ewr new jersey newark">newark liberty international</auro-menuoption>
1705
- <auro-menuoption value="hdn" id="airport-hdn" suggest="hdn colorado steamboat springs">yampa valley regional</auro-menuoption>
1706
- <auro-menuoption value="psc" id="airport-psc" suggest="psc washington pasco">tri cities</auro-menuoption>
1707
- <auro-menuoption value="tus" id="airport-tus" suggest="tus arizona tucson">tucson international</auro-menuoption>
1708
- <auro-menuoption value="abq" id="airport-abq" suggest="abq new mexico albuquerque">albuquerque international sunport</auro-menuoption>
1709
- <auro-menuoption value="jfk" id="airport-jfk" suggest="jfk new york new york">john f kennedy international</auro-menuoption>
1710
- <auro-menuoption value="yvr" id="airport-yvr" suggest="yvr british columbia vancouver">vancouver international</auro-menuoption>
1711
- <auro-menuoption value="sjo" id="airport-sjo" suggest="sjo san jose alajuela province">juan santamaria international</auro-menuoption>
1712
- <auro-menuoption value="las" id="airport-las" suggest="las nevada las vegas">harry reid international airport</auro-menuoption>
1713
- <auro-menuoption value="lih" id="airport-lih" suggest="lih hawaii kauai">lihue international</auro-menuoption>
1714
- <auro-menuoption value="mso" id="airport-mso" suggest="mso montana missoula">missoula international</auro-menuoption>
1715
- <auro-menuoption value="alw" id="airport-alw" suggest="alw washington walla walla">walla walla regional</auro-menuoption>
1716
- <auro-menuoption value="mke" id="airport-mke" suggest="mke wisconsin milwaukee">milwaukee mitchell international</auro-menuoption>
1717
- <auro-menuoption value="eug" id="airport-eug" suggest="eug oregon eugene">mahlon sweet field</auro-menuoption>
1718
- <auro-menuoption value="akn" id="airport-akn" suggest="akn alaska king salmon">king salmon</auro-menuoption>
1719
- <auro-menuoption value="cun" id="airport-cun" suggest="cun quintana roo cancun">cancun international</auro-menuoption>
1720
- <auro-menuoption value="rdd" id="airport-rdd" suggest="rdd california redding">redding municipal airport</auro-menuoption>
1721
- <auro-menuoption value="mco" id="airport-mco" suggest="mco florida orlando">orlando international</auro-menuoption>
1722
- <auro-menuoption value="slc" id="airport-slc" suggest="slc utah salt lake city">salt lake city international</auro-menuoption>
1723
- <auro-menuoption value="phx" id="airport-phx" suggest="phx arizona phoenix">sky harbor international</auro-menuoption>
1724
- <auro-menuoption value="bil" id="airport-bil" suggest="bil montana billings">billings logan international</auro-menuoption>
1725
- <auro-menuoption value="gst" id="airport-gst" suggest="gst alaska gustavus">gustavus</auro-menuoption>
1726
- <auro-menuoption value="adk" id="airport-adk" suggest="adk alaska adak">adak</auro-menuoption>
1727
- <auro-menuoption value="cvg" id="airport-cvg" suggest="cvg kentucky hebron">cincinnati northern kentucky international</auro-menuoption>
1728
- <auro-menuoption value="jac" id="airport-jac" suggest="jac wyoming jackson">jackson hole airport</auro-menuoption>
1729
- <auro-menuoption value="cmh" id="airport-cmh" suggest="cmh ohio columbus">john glenn columbus international</auro-menuoption>
1730
- <auro-menuoption value="yyj" id="airport-yyj" suggest="yyj british columbia victoria">victoria international</auro-menuoption>
1731
- <auro-menuoption value="chs" id="airport-chs" suggest="chs south carolina charleston">charleston international</auro-menuoption>
1732
- <auro-menuoption value="iah" id="airport-iah" suggest="iah texas houston">george bush intercontinental</auro-menuoption>
1733
- <auro-menuoption static nomatch>Unknown airport... </auro-menuoption>
1734
- </auro-menu>
1735
- </auro-select>
1736
- <style>
1737
- #customBibHeightExample::part(dropdownSize) {
1738
- max-height: 150px;
1739
- }
1740
- </style>
1741
- <!-- AURO-GENERATED-CONTENT:END -->
1742
- </div>
1743
- <auro-accordion alignRight>
1744
- <span slot="trigger">See code</span>
1745
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=../apiExamples/custom-bib-height.html) -->
1746
- <!-- The below code snippet is automatically added from ../apiExamples/custom-bib-height.html -->
1747
-
1748
- <pre class="language-html"><code class="language-html">&lt;auro-select id="customBibHeightExample" value="pit"&gt;
1749
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
1750
- &lt;span slot="label"&gt;Label&lt;/span&gt;
1751
- &lt;auro-menu&gt;
1752
- &lt;auro-menuoption value="fca" id="airport-fca" suggest="fca montana kalispell"&gt;glacier park international&lt;/auro-menuoption&gt;
1753
- &lt;auro-menuoption value="sfo" id="airport-sfo" suggest="sfo california san francisco"&gt;san francisco international&lt;/auro-menuoption&gt;
1754
- &lt;auro-menuoption value="boi" id="airport-boi" suggest="boi idaho boise"&gt;gowen field&lt;/auro-menuoption&gt;
1755
- &lt;auro-menuoption value="stl" id="airport-stl" suggest="stl missouri st louis"&gt;lambert st louis international&lt;/auro-menuoption&gt;
1756
- &lt;auro-menuoption value="ylw" id="airport-ylw" suggest="ylw british columbia kelowna"&gt;kelowna international&lt;/auro-menuoption&gt;
1757
- &lt;auro-menuoption value="ykm" id="airport-ykm" suggest="ykm washington yakima"&gt;yakima air terminal&lt;/auro-menuoption&gt;
1758
- &lt;auro-menuoption value="puw" id="airport-puw" suggest="puw washington pullman"&gt;pullman moscow regional&lt;/auro-menuoption&gt;
1759
- &lt;auro-menuoption value="yeg" id="airport-yeg" suggest="yeg alberta edmonton"&gt;edmonton international&lt;/auro-menuoption&gt;
1760
- &lt;auro-menuoption value="tpa" id="airport-tpa" suggest="tpa florida tampa"&gt;tampa international&lt;/auro-menuoption&gt;
1761
- &lt;auro-menuoption value="msp" id="airport-msp" suggest="msp minnesota minneapolis"&gt;minneapolis st paul international&lt;/auro-menuoption&gt;
1762
- &lt;auro-menuoption value="ida" id="airport-ida" suggest="ida idaho idaho falls"&gt;idaho falls regional airport&lt;/auro-menuoption&gt;
1763
- &lt;auro-menuoption value="mfr" id="airport-mfr" suggest="mfr oregon medford"&gt;rogue valley international&lt;/auro-menuoption&gt;
1764
- &lt;auro-menuoption value="psp" id="airport-psp" suggest="psp california palm springs"&gt;palm springs international&lt;/auro-menuoption&gt;
1765
- &lt;auro-menuoption value="lir" id="airport-lir" suggest="lir guanacaste liberia"&gt;guanacaste airport&lt;/auro-menuoption&gt;
1766
- &lt;auro-menuoption value="oak" id="airport-oak" suggest="oak california oakland"&gt;oakland international&lt;/auro-menuoption&gt;
1767
- &lt;auro-menuoption value="bos" id="airport-bos" suggest="bos massachusetts boston"&gt;logan international&lt;/auro-menuoption&gt;
1768
- &lt;auro-menuoption value="bwi" id="airport-bwi" suggest="bwi maryland baltimore"&gt;thurgood marshall international&lt;/auro-menuoption&gt;
1769
- &lt;auro-menuoption value="dal" id="airport-dal" suggest="dal texas dallas"&gt;dallas love field&lt;/auro-menuoption&gt;
1770
- &lt;auro-menuoption value="sba" id="airport-sba" suggest="sba california santa barbara"&gt;santa barbara municipal&lt;/auro-menuoption&gt;
1771
- &lt;auro-menuoption value="mci" id="airport-mci" suggest="mci missouri kansas city"&gt;kansas city international&lt;/auro-menuoption&gt;
1772
- &lt;auro-menuoption value="koa" id="airport-koa" suggest="koa hawaii kona"&gt;kona international&lt;/auro-menuoption&gt;
1773
- &lt;auro-menuoption value="pvr" id="airport-pvr" suggest="pvr jalisco puerto vallarta"&gt;licenciado gustavo diaz ordaz international&lt;/auro-menuoption&gt;
1774
- &lt;auro-menuoption value="wrg" id="airport-wrg" suggest="wrg alaska wrangell"&gt;wrangell&lt;/auro-menuoption&gt;
1775
- &lt;auro-menuoption value="scc" id="airport-scc" suggest="scc alaska prudhoe bay"&gt;deadhorse&lt;/auro-menuoption&gt;
1776
- &lt;auro-menuoption value="lto" id="airport-lto" suggest="lto baja california loreto"&gt;loreto international&lt;/auro-menuoption&gt;
1777
- &lt;auro-menuoption value="ome" id="airport-ome" suggest="ome alaska nome"&gt;nome&lt;/auro-menuoption&gt;
1778
- &lt;auro-menuoption value="ict" id="airport-ict" suggest="ict kansas wichita"&gt;dwight d eisenhower national&lt;/auro-menuoption&gt;
1779
- &lt;auro-menuoption value="phl" id="airport-phl" suggest="phl pennsylvania philadelphia"&gt;philadelphia international&lt;/auro-menuoption&gt;
1780
- &lt;auro-menuoption value="dfw" id="airport-dfw" suggest="dfw texas dallas"&gt;dallas fort worth international&lt;/auro-menuoption&gt;
1781
- &lt;auro-menuoption value="ind" id="airport-ind" suggest="ind indiana indianapolis"&gt;indianapolis international&lt;/auro-menuoption&gt;
1782
- &lt;auro-menuoption value="smf" id="airport-smf" suggest="smf california sacramento"&gt;sacramento international&lt;/auro-menuoption&gt;
1783
- &lt;auro-menuoption value="sit" id="airport-sit" suggest="sit alaska sitka"&gt;rocky gutierrez&lt;/auro-menuoption&gt;
1784
- &lt;auro-menuoption value="dut" id="airport-dut" suggest="dut alaska dutch harbor"&gt;unalaska&lt;/auro-menuoption&gt;
1785
- &lt;auro-menuoption value="cdv" id="airport-cdv" suggest="cdv alaska cordova"&gt;merle mudhole smith&lt;/auro-menuoption&gt;
1786
- &lt;auro-menuoption value="psg" id="airport-psg" suggest="psg alaska petersburg"&gt;james a johnson&lt;/auro-menuoption&gt;
1787
- &lt;auro-menuoption value="bna" id="airport-bna" suggest="bna tennessee nashville"&gt;nashville international&lt;/auro-menuoption&gt;
1788
- &lt;auro-menuoption value="geg" id="airport-geg" suggest="geg washington spokane"&gt;spokane international&lt;/auro-menuoption&gt;
1789
- &lt;auro-menuoption value="ktn" id="airport-ktn" suggest="ktn alaska ketchikan"&gt;ketchikan international&lt;/auro-menuoption&gt;
1790
- &lt;auro-menuoption value="pit" id="airport-pit" suggest="pit pennsylvania pittsburgh"&gt;pittsburgh international&lt;/auro-menuoption&gt;
1791
- &lt;auro-menuoption value="sbp" id="airport-sbp" suggest="sbp california san luis obispo"&gt;san luis obispo regional&lt;/auro-menuoption&gt;
1792
- &lt;auro-menuoption value="bur" id="airport-bur" suggest="bur california burbank"&gt;hollywood burbank&lt;/auro-menuoption&gt;
1793
- &lt;auro-menuoption value="msy" id="airport-msy" suggest="msy louisiana new orleans"&gt;louis armstrong international&lt;/auro-menuoption&gt;
1794
- &lt;auro-menuoption value="pae" id="airport-pae" suggest="pae washington everett"&gt;paine field&lt;/auro-menuoption&gt;
1795
- &lt;auro-menuoption value="cvg" id="airport-cvg" suggest="cvg ohio cincinnati"&gt;cincinnati northern kentucky international&lt;/auro-menuoption&gt;
1796
- &lt;auro-menuoption value="yak" id="airport-yak" suggest="yak alaska yakutat"&gt;yakutat&lt;/auro-menuoption&gt;
1797
- &lt;auro-menuoption value="pdx" id="airport-pdx" suggest="pdx oregon portland"&gt;portland international&lt;/auro-menuoption&gt;
1798
- &lt;auro-menuoption value="anc" id="airport-anc" suggest="anc alaska anchorage"&gt;ted stevens&lt;/auro-menuoption&gt;
1799
- &lt;auro-menuoption value="sea" id="airport-sea" suggest="sea washington seattle"&gt;seattle tacoma international&lt;/auro-menuoption&gt;
1800
- &lt;auro-menuoption value="san" id="airport-san" suggest="san california san diego"&gt;san diego international&lt;/auro-menuoption&gt;
1801
- &lt;auro-menuoption value="sat" id="airport-sat" suggest="sat texas san antonio"&gt;san antonio international&lt;/auro-menuoption&gt;
1802
- &lt;auro-menuoption value="fat" id="airport-fat" suggest="fat california fresno"&gt;fresno yosemite international&lt;/auro-menuoption&gt;
1803
- &lt;auro-menuoption value="aus" id="airport-aus" suggest="aus texas austin"&gt;austin bergstrom international&lt;/auro-menuoption&gt;
1804
- &lt;auro-menuoption value="ord" id="airport-ord" suggest="ord illinois chicago"&gt;ohare international&lt;/auro-menuoption&gt;
1805
- &lt;auro-menuoption value="gdl" id="airport-gdl" suggest="gdl jalisco guadalajara"&gt;guadalajara international&lt;/auro-menuoption&gt;
1806
- &lt;auro-menuoption value="sjc" id="airport-sjc" suggest="sjc california san jose"&gt;san jose international&lt;/auro-menuoption&gt;
1807
- &lt;auro-menuoption value="jnu" id="airport-jnu" suggest="jnu alaska juneau"&gt;juneau international&lt;/auro-menuoption&gt;
1808
- &lt;auro-menuoption value="rdm" id="airport-rdm" suggest="rdm oregon redmond"&gt;roberts field&lt;/auro-menuoption&gt;
1809
- &lt;auro-menuoption value="sts" id="airport-sts" suggest="sts california sonoma"&gt;charles m schulz&lt;/auro-menuoption&gt;
1810
- &lt;auro-menuoption value="fai" id="airport-fai" suggest="fai alaska fairbanks"&gt;fairbanks international&lt;/auro-menuoption&gt;
1811
- &lt;auro-menuoption value="rdu" id="airport-rdu" suggest="rdu north carolina raleigh"&gt;raleigh durham international&lt;/auro-menuoption&gt;
1812
- &lt;auro-menuoption value="oma" id="airport-oma" suggest="oma nebraska omaha"&gt;eppley airfield&lt;/auro-menuoption&gt;
1813
- &lt;auro-menuoption value="bzn" id="airport-bzn" suggest="bzn montana bozeman"&gt;bozeman yellowstone international&lt;/auro-menuoption&gt;
1814
- &lt;auro-menuoption value="ont" id="airport-ont" suggest="ont california ontario"&gt;ontario international&lt;/auro-menuoption&gt;
1815
- &lt;auro-menuoption value="ogg" id="airport-ogg" suggest="ogg hawaii maui"&gt;kahului international&lt;/auro-menuoption&gt;
1816
- &lt;auro-menuoption value="sun" id="airport-sun" suggest="sun idaho sun valley"&gt;friedman memorial&lt;/auro-menuoption&gt;
1817
- &lt;auro-menuoption value="mzt" id="airport-mzt" suggest="mzt sinaloa mazatlan"&gt;general rafael buelna international&lt;/auro-menuoption&gt;
1818
- &lt;auro-menuoption value="dlg" id="airport-dlg" suggest="dlg alaska dillingham"&gt;dillingham&lt;/auro-menuoption&gt;
1819
- &lt;auro-menuoption value="adq" id="airport-adq" suggest="adq alaska kodiak"&gt;kodiak&lt;/auro-menuoption&gt;
1820
- &lt;auro-menuoption value="den" id="airport-den" suggest="den colorado denver"&gt;denver international&lt;/auro-menuoption&gt;
1821
- &lt;auro-menuoption value="zlo" id="airport-zlo" suggest="zlo colima manzanillo"&gt;manzanillo international&lt;/auro-menuoption&gt;
1822
- &lt;auro-menuoption value="sjd" id="airport-sjd" suggest="sjd baja california los cabos"&gt;los cabos international&lt;/auro-menuoption&gt;
1823
- &lt;auro-menuoption value="elp" id="airport-elp" suggest="elp texas el paso"&gt;el paso international airport&lt;/auro-menuoption&gt;
1824
- &lt;auro-menuoption value="atl" id="airport-atl" suggest="atl georgia atlanta"&gt;hartsfield jackson international&lt;/auro-menuoption&gt;
1825
- &lt;auro-menuoption value="lax" id="airport-lax" suggest="lax california los angeles"&gt;los angeles international&lt;/auro-menuoption&gt;
1826
- &lt;auro-menuoption value="rsw" id="airport-rsw" suggest="rsw florida fort myers"&gt;southwest florida international&lt;/auro-menuoption&gt;
1827
- &lt;auro-menuoption value="cle" id="airport-cle" suggest="cle ohio cleveland"&gt;cleveland hopkins international airport&lt;/auro-menuoption&gt;
1828
- &lt;auro-menuoption value="otz" id="airport-otz" suggest="otz alaska kotzebue"&gt;ralph wien memorial&lt;/auro-menuoption&gt;
1829
- &lt;auro-menuoption value="bze" id="airport-bze" suggest="bze belize belize city"&gt;philip sw goldson international airport&lt;/auro-menuoption&gt;
1830
- &lt;auro-menuoption value="eat" id="airport-eat" suggest="eat washington wenatchee"&gt;pangborn memorial&lt;/auro-menuoption&gt;
1831
- &lt;auro-menuoption value="dtw" id="airport-dtw" suggest="dtw michigan detroit"&gt;detroit metropolitan&lt;/auro-menuoption&gt;
1832
- &lt;auro-menuoption value="bet" id="airport-bet" suggest="bet alaska bethel"&gt;bethel&lt;/auro-menuoption&gt;
1833
- &lt;auro-menuoption value="dca" id="airport-dca" suggest="dca district of columbia washington"&gt;ronald reagan national&lt;/auro-menuoption&gt;
1834
- &lt;auro-menuoption value="rno" id="airport-rno" suggest="rno nevada reno"&gt;reno tahoe international&lt;/auro-menuoption&gt;
1835
- &lt;auro-menuoption value="brw" id="airport-brw" suggest="brw alaska barrow"&gt;wiley post will rogers&lt;/auro-menuoption&gt;
1836
- &lt;auro-menuoption value="mry" id="airport-mry" suggest="mry california monterey"&gt;monterey regional&lt;/auro-menuoption&gt;
1837
- &lt;auro-menuoption value="hnl" id="airport-hnl" suggest="hnl hawaii oahu"&gt;honolulu international&lt;/auro-menuoption&gt;
1838
- &lt;auro-menuoption value="okc" id="airport-okc" suggest="okc oklahoma oklahoma city"&gt;will rogers world&lt;/auro-menuoption&gt;
1839
- &lt;auro-menuoption value="iad" id="airport-iad" suggest="iad virginia dulles"&gt;washington dulles international&lt;/auro-menuoption&gt;
1840
- &lt;auro-menuoption value="mia" id="airport-mia" suggest="mia florida miami"&gt;miami international&lt;/auro-menuoption&gt;
1841
- &lt;auro-menuoption value="bli" id="airport-bli" suggest="bli washington bellingham"&gt;bellingham international&lt;/auro-menuoption&gt;
1842
- &lt;auro-menuoption value="hln" id="airport-hln" suggest="hln montana helena"&gt;helena regional&lt;/auro-menuoption&gt;
1843
- &lt;auro-menuoption value="gtf" id="airport-gtf" suggest="gtf montana great falls"&gt;great falls international&lt;/auro-menuoption&gt;
1844
- &lt;auro-menuoption value="zih" id="airport-zih" suggest="zih guerrero zihuatanejo"&gt;ixtapa zihuatanejo international&lt;/auro-menuoption&gt;
1845
- &lt;auro-menuoption value="yyc" id="airport-yyc" suggest="yyc alberta calgary"&gt;calgary international&lt;/auro-menuoption&gt;
1846
- &lt;auro-menuoption value="sna" id="airport-sna" suggest="sna california santa ana"&gt;john wayne&lt;/auro-menuoption&gt;
1847
- &lt;auro-menuoption value="fll" id="airport-fll" suggest="fll florida fort lauderdale"&gt;fort lauderdale hollywood international&lt;/auro-menuoption&gt;
1848
- &lt;auro-menuoption value="ewr" id="airport-ewr" suggest="ewr new jersey newark"&gt;newark liberty international&lt;/auro-menuoption&gt;
1849
- &lt;auro-menuoption value="hdn" id="airport-hdn" suggest="hdn colorado steamboat springs"&gt;yampa valley regional&lt;/auro-menuoption&gt;
1850
- &lt;auro-menuoption value="psc" id="airport-psc" suggest="psc washington pasco"&gt;tri cities&lt;/auro-menuoption&gt;
1851
- &lt;auro-menuoption value="tus" id="airport-tus" suggest="tus arizona tucson"&gt;tucson international&lt;/auro-menuoption&gt;
1852
- &lt;auro-menuoption value="abq" id="airport-abq" suggest="abq new mexico albuquerque"&gt;albuquerque international sunport&lt;/auro-menuoption&gt;
1853
- &lt;auro-menuoption value="jfk" id="airport-jfk" suggest="jfk new york new york"&gt;john f kennedy international&lt;/auro-menuoption&gt;
1854
- &lt;auro-menuoption value="yvr" id="airport-yvr" suggest="yvr british columbia vancouver"&gt;vancouver international&lt;/auro-menuoption&gt;
1855
- &lt;auro-menuoption value="sjo" id="airport-sjo" suggest="sjo san jose alajuela province"&gt;juan santamaria international&lt;/auro-menuoption&gt;
1856
- &lt;auro-menuoption value="las" id="airport-las" suggest="las nevada las vegas"&gt;harry reid international airport&lt;/auro-menuoption&gt;
1857
- &lt;auro-menuoption value="lih" id="airport-lih" suggest="lih hawaii kauai"&gt;lihue international&lt;/auro-menuoption&gt;
1858
- &lt;auro-menuoption value="mso" id="airport-mso" suggest="mso montana missoula"&gt;missoula international&lt;/auro-menuoption&gt;
1859
- &lt;auro-menuoption value="alw" id="airport-alw" suggest="alw washington walla walla"&gt;walla walla regional&lt;/auro-menuoption&gt;
1860
- &lt;auro-menuoption value="mke" id="airport-mke" suggest="mke wisconsin milwaukee"&gt;milwaukee mitchell international&lt;/auro-menuoption&gt;
1861
- &lt;auro-menuoption value="eug" id="airport-eug" suggest="eug oregon eugene"&gt;mahlon sweet field&lt;/auro-menuoption&gt;
1862
- &lt;auro-menuoption value="akn" id="airport-akn" suggest="akn alaska king salmon"&gt;king salmon&lt;/auro-menuoption&gt;
1863
- &lt;auro-menuoption value="cun" id="airport-cun" suggest="cun quintana roo cancun"&gt;cancun international&lt;/auro-menuoption&gt;
1864
- &lt;auro-menuoption value="rdd" id="airport-rdd" suggest="rdd california redding"&gt;redding municipal airport&lt;/auro-menuoption&gt;
1865
- &lt;auro-menuoption value="mco" id="airport-mco" suggest="mco florida orlando"&gt;orlando international&lt;/auro-menuoption&gt;
1866
- &lt;auro-menuoption value="slc" id="airport-slc" suggest="slc utah salt lake city"&gt;salt lake city international&lt;/auro-menuoption&gt;
1867
- &lt;auro-menuoption value="phx" id="airport-phx" suggest="phx arizona phoenix"&gt;sky harbor international&lt;/auro-menuoption&gt;
1868
- &lt;auro-menuoption value="bil" id="airport-bil" suggest="bil montana billings"&gt;billings logan international&lt;/auro-menuoption&gt;
1869
- &lt;auro-menuoption value="gst" id="airport-gst" suggest="gst alaska gustavus"&gt;gustavus&lt;/auro-menuoption&gt;
1870
- &lt;auro-menuoption value="adk" id="airport-adk" suggest="adk alaska adak"&gt;adak&lt;/auro-menuoption&gt;
1871
- &lt;auro-menuoption value="cvg" id="airport-cvg" suggest="cvg kentucky hebron"&gt;cincinnati northern kentucky international&lt;/auro-menuoption&gt;
1872
- &lt;auro-menuoption value="jac" id="airport-jac" suggest="jac wyoming jackson"&gt;jackson hole airport&lt;/auro-menuoption&gt;
1873
- &lt;auro-menuoption value="cmh" id="airport-cmh" suggest="cmh ohio columbus"&gt;john glenn columbus international&lt;/auro-menuoption&gt;
1874
- &lt;auro-menuoption value="yyj" id="airport-yyj" suggest="yyj british columbia victoria"&gt;victoria international&lt;/auro-menuoption&gt;
1875
- &lt;auro-menuoption value="chs" id="airport-chs" suggest="chs south carolina charleston"&gt;charleston international&lt;/auro-menuoption&gt;
1876
- &lt;auro-menuoption value="iah" id="airport-iah" suggest="iah texas houston"&gt;george bush intercontinental&lt;/auro-menuoption&gt;
1877
- &lt;auro-menuoption static nomatch&gt;Unknown airport... &lt;/auro-menuoption&gt;
1878
- &lt;/auro-menu&gt;
1879
- &lt;/auro-select&gt;
1880
- &lt;style&gt;
1881
- #customBibHeightExample::part(dropdownSize) {
1882
- max-height: 150px;
1883
- }
1884
- &lt;/style&gt;</code></pre>
1885
- <!-- AURO-GENERATED-CONTENT:END -->
1886
- </auro-accordion>
1887
-
1888
- ## Common Usage Patterns & Functional Examples
1889
-
1890
- ### Icons in Options
1891
-
1892
- Displays an `<auro-select>` element with `<auro-icon>` elements in each option.
1893
-
1894
- <div class="exampleWrapper">
1895
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/with-icons.html) -->
1896
- <!-- The below content is automatically added from ./../apiExamples/with-icons.html -->
1897
- <auro-select placeholder="Placeholder Text">
1898
- <span slot="bib.fullscreen.headline">Bib Headline</span>
1899
- <span slot="label">Label</span>
1900
- <auro-menu>
1901
- <auro-menuoption value="air">
1902
- <auro-icon label customColor category="health" name="air">Air</auro-icon>
1903
- </auro-menuoption>
1904
- <auro-menuoption value="covidtest">
1905
- <auro-icon label customColor category="health" name="covid-test">Covid Test</auro-icon>
1906
- </auro-menuoption>
1907
- <auro-menuoption value="health">
1908
- <auro-icon label customColor category="health" name="health">Health</auro-icon>
1909
- </auro-menuoption>
1910
- <auro-menuoption value="mask">
1911
- <auro-icon label customColor category="health" name="mask">Mask</auro-icon>
1912
- </auro-menuoption>
1913
- <auro-menuoption value="spraybottle">
1914
- <auro-icon label customColor category="health" name="spraybottle">Spray Bottle</auro-icon>
1915
- </auro-menuoption>
1916
- </auro-menu>
1917
- </auro-select>
1918
- <!-- AURO-GENERATED-CONTENT:END -->
1919
- </div>
1920
- <auro-accordion alignRight>
1921
- <span slot="trigger">See code</span>
1922
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/with-icons.html) -->
1923
- <!-- The below code snippet is automatically added from ./../apiExamples/with-icons.html -->
1924
-
1925
- <pre class="language-html"><code class="language-html">&lt;auro-select placeholder="Placeholder Text"&gt;
1926
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
1927
- &lt;span slot="label"&gt;Label&lt;/span&gt;
1928
- &lt;auro-menu&gt;
1929
- &lt;auro-menuoption value="air"&gt;
1930
- &lt;auro-icon label customColor category="health" name="air"&gt;Air&lt;/auro-icon&gt;
1931
- &lt;/auro-menuoption&gt;
1932
- &lt;auro-menuoption value="covidtest"&gt;
1933
- &lt;auro-icon label customColor category="health" name="covid-test"&gt;Covid Test&lt;/auro-icon&gt;
1934
- &lt;/auro-menuoption&gt;
1935
- &lt;auro-menuoption value="health"&gt;
1936
- &lt;auro-icon label customColor category="health" name="health"&gt;Health&lt;/auro-icon&gt;
1937
- &lt;/auro-menuoption&gt;
1938
- &lt;auro-menuoption value="mask"&gt;
1939
- &lt;auro-icon label customColor category="health" name="mask"&gt;Mask&lt;/auro-icon&gt;
1940
- &lt;/auro-menuoption&gt;
1941
- &lt;auro-menuoption value="spraybottle"&gt;
1942
- &lt;auro-icon label customColor category="health" name="spraybottle"&gt;Spray Bottle&lt;/auro-icon&gt;
1943
- &lt;/auro-menuoption&gt;
1944
- &lt;/auro-menu&gt;
1945
- &lt;/auro-select&gt;</code></pre>
1946
- <!-- AURO-GENERATED-CONTENT:END -->
1947
- </auro-accordion>
1948
-
1949
- ### Nested Submenus
1950
-
1951
- This example shows nesting `<auro-menu>` elements to create submenus.
1952
-
1953
- <div class="exampleWrapper">
1954
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/with-submenus.html) -->
1955
- <!-- The below content is automatically added from ./../apiExamples/with-submenus.html -->
1956
- <auro-select placeholder="Placeholder Text">
1957
- <span slot="bib.fullscreen.headline">Bib Headline</span>
1958
- <span slot="label">Label</span>
1959
- <auro-menu>
1960
- <auro-menuoption value="stops">Stops</auro-menuoption>
1961
- <auro-menuoption value="price">Price</auro-menuoption>
1962
- <auro-menuoption value="duration">Duration</auro-menuoption>
1963
- <hr>
1964
- <auro-menu>
1965
- <auro-menuoption value="apples">Apples</auro-menuoption>
1966
- <auro-menuoption value="oranges">Oranges</auro-menuoption>
1967
- <auro-menuoption value="pears">Pears</auro-menuoption>
1968
- <auro-menuoption value="grapes">Grapes</auro-menuoption>
1969
- <auro-menuoption value="kiwi">Kiwi</auro-menuoption>
1970
- <hr>
1971
- <auro-menu>
1972
- <auro-menuoption value="person">Person</auro-menuoption>
1973
- <auro-menuoption value="woman">Woman</auro-menuoption>
1974
- <auro-menuoption value="man">Man</auro-menuoption>
1975
- <auro-menuoption value="camera">Camera</auro-menuoption>
1976
- <auro-menuoption value="tv">TV</auro-menuoption>
1977
- </auro-menu>
1978
- </auro-menu>
1979
- <hr>
1980
- <auro-menuoption value="departure">Departure</auro-menuoption>
1981
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
1982
- <hr>
1983
- <auro-menu>
1984
- <auro-menuoption value="cars">Cars</auro-menuoption>
1985
- <auro-menuoption value="trucks">Trucks</auro-menuoption>
1986
- <auro-menuoption value="boats">Boats</auro-menuoption>
1987
- <auro-menuoption value="planes">Planes</auro-menuoption>
1988
- <auro-menuoption value="motorcycles">Motorcycles</auro-menuoption>
1989
- </auro-menu>
1990
- </auro-select>
1991
- <!-- AURO-GENERATED-CONTENT:END -->
1992
- </div>
1993
- <auro-accordion alignRight>
1994
- <span slot="trigger">See code</span>
1995
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/with-submenus.html) -->
1996
- <!-- The below code snippet is automatically added from ./../apiExamples/with-submenus.html -->
1997
-
1998
- <pre class="language-html"><code class="language-html">&lt;auro-select placeholder="Placeholder Text"&gt;
1999
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
2000
- &lt;span slot="label"&gt;Label&lt;/span&gt;
2001
- &lt;auro-menu&gt;
2002
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
2003
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
2004
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
2005
- &lt;hr&gt;
2006
- &lt;auro-menu&gt;
2007
- &lt;auro-menuoption value="apples"&gt;Apples&lt;/auro-menuoption&gt;
2008
- &lt;auro-menuoption value="oranges"&gt;Oranges&lt;/auro-menuoption&gt;
2009
- &lt;auro-menuoption value="pears"&gt;Pears&lt;/auro-menuoption&gt;
2010
- &lt;auro-menuoption value="grapes"&gt;Grapes&lt;/auro-menuoption&gt;
2011
- &lt;auro-menuoption value="kiwi"&gt;Kiwi&lt;/auro-menuoption&gt;
2012
- &lt;hr&gt;
2013
- &lt;auro-menu&gt;
2014
- &lt;auro-menuoption value="person"&gt;Person&lt;/auro-menuoption&gt;
2015
- &lt;auro-menuoption value="woman"&gt;Woman&lt;/auro-menuoption&gt;
2016
- &lt;auro-menuoption value="man"&gt;Man&lt;/auro-menuoption&gt;
2017
- &lt;auro-menuoption value="camera"&gt;Camera&lt;/auro-menuoption&gt;
2018
- &lt;auro-menuoption value="tv"&gt;TV&lt;/auro-menuoption&gt;
2019
- &lt;/auro-menu&gt;
2020
- &lt;/auro-menu&gt;
2021
- &lt;hr&gt;
2022
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
2023
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
2024
- &lt;hr&gt;
2025
- &lt;auro-menu&gt;
2026
- &lt;auro-menuoption value="cars"&gt;Cars&lt;/auro-menuoption&gt;
2027
- &lt;auro-menuoption value="trucks"&gt;Trucks&lt;/auro-menuoption&gt;
2028
- &lt;auro-menuoption value="boats"&gt;Boats&lt;/auro-menuoption&gt;
2029
- &lt;auro-menuoption value="planes"&gt;Planes&lt;/auro-menuoption&gt;
2030
- &lt;auro-menuoption value="motorcycles"&gt;Motorcycles&lt;/auro-menuoption&gt;
2031
- &lt;/auro-menu&gt;
2032
- &lt;/auro-select&gt;</code></pre>
2033
- <!-- AURO-GENERATED-CONTENT:END -->
2034
- </auro-accordion>
2035
-
2036
- ### Extract value
2037
-
2038
- The following example illustrates how a user may query the `element.value` or `element.optionSelected` for the current value or complete option object that is selected.
2039
-
2040
- <div class="exampleWrapper">
2041
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/value-extraction.html) -->
2042
- <!-- The below content is automatically added from ./../apiExamples/value-extraction.html -->
2043
- <auro-select id="valueExtraction" placeholder="Placeholder Text">
2044
- <span slot="bib.fullscreen.headline">Bib Headline</span>
2045
- <span slot="label">Label</span>
2046
- <auro-menu>
2047
- <auro-menuoption value="stops">Stops</auro-menuoption>
2048
- <auro-menuoption value="price">Price</auro-menuoption>
2049
- <auro-menuoption value="duration">Duration</auro-menuoption>
2050
- <auro-menuoption value="departure">Departure</auro-menuoption>
2051
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
2052
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
2053
- </auro-menu>
2054
- </auro-select>
2055
- <auro-button id="valueExtractionBtn">Get current value</auro-button>
2056
- <!-- AURO-GENERATED-CONTENT:END -->
2057
- </div>
2058
- <auro-accordion alignRight>
2059
- <span slot="trigger">See code</span>
2060
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/value-extraction.html) -->
2061
- <!-- The below code snippet is automatically added from ./../apiExamples/value-extraction.html -->
2062
-
2063
- <pre class="language-html"><code class="language-html">&lt;auro-select id="valueExtraction" placeholder="Placeholder Text"&gt;
2064
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
2065
- &lt;span slot="label"&gt;Label&lt;/span&gt;
2066
- &lt;auro-menu&gt;
2067
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
2068
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
2069
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
2070
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
2071
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
2072
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
2073
- &lt;/auro-menu&gt;
2074
- &lt;/auro-select&gt;
2075
- &lt;auro-button id="valueExtractionBtn"&gt;Get current value&lt;/auro-button&gt;</code></pre>
2076
- <!-- AURO-GENERATED-CONTENT:END -->
2077
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/value-extraction.js) -->
2078
- <!-- The below code snippet is automatically added from ./../apiExamples/value-extraction.js -->
2079
-
2080
- <pre class="language-js"><code class="language-js">export function valueExtractionExample() {
2081
- const valueExtractionExample = document.querySelector('#valueExtraction');
2082
- const valueExtractionBtn = document.querySelector('#valueExtractionBtn');
2083
-
2084
- valueExtractionBtn.addEventListener('click', () =&gt; {
2085
- console.warn('Value selected:', valueExtractionExample.value);
2086
- console.warn('Option selected:', valueExtractionExample.optionSelected);
2087
-
2088
- alert(`Value selected: ${valueExtractionExample.value}`);
2089
- })
2090
- }</code></pre>
2091
- <!-- AURO-GENERATED-CONTENT:END -->
2092
- </auro-accordion>
2093
-
2094
- ### Custom Validity with Error State
2095
-
2096
- This example programmatically adds the `error` state when a user selects an option that is greater than `2`.
2097
-
2098
- <div class="exampleWrapper">
2099
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/custom-error-validity.html) -->
2100
- <!-- The below content is automatically added from ./../apiExamples/custom-error-validity.html -->
2101
- <auro-select id="primaryError" placeholder="Placeholder Text">
2102
- <span slot="bib.fullscreen.headline">Bib Headline</span>
2103
- <span slot="label">Label</span>
2104
- <auro-menu>
2105
- <auro-menuoption value="1">1</auro-menuoption>
2106
- <auro-menuoption value="2">2</auro-menuoption>
2107
- <auro-menuoption value="3">3</auro-menuoption>
2108
- <auro-menuoption value="4">4</auro-menuoption>
2109
- <auro-menuoption value="5">5</auro-menuoption>
2110
- <auro-menuoption value="6">6</auro-menuoption>
2111
- </auro-menu>
2112
- </auro-select>
2113
- <!-- AURO-GENERATED-CONTENT:END -->
2114
- </div>
2115
- <auro-accordion alignRight>
2116
- <span slot="trigger">See code</span>
2117
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/custom-error-validity.html) -->
2118
- <!-- The below code snippet is automatically added from ./../apiExamples/custom-error-validity.html -->
2119
-
2120
- <pre class="language-html"><code class="language-html">&lt;auro-select id="primaryError" placeholder="Placeholder Text"&gt;
2121
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
2122
- &lt;span slot="label"&gt;Label&lt;/span&gt;
2123
- &lt;auro-menu&gt;
2124
- &lt;auro-menuoption value="1"&gt;1&lt;/auro-menuoption&gt;
2125
- &lt;auro-menuoption value="2"&gt;2&lt;/auro-menuoption&gt;
2126
- &lt;auro-menuoption value="3"&gt;3&lt;/auro-menuoption&gt;
2127
- &lt;auro-menuoption value="4"&gt;4&lt;/auro-menuoption&gt;
2128
- &lt;auro-menuoption value="5"&gt;5&lt;/auro-menuoption&gt;
2129
- &lt;auro-menuoption value="6"&gt;6&lt;/auro-menuoption&gt;
2130
- &lt;/auro-menu&gt;
2131
- &lt;/auro-select&gt;</code></pre>
2132
- <!-- AURO-GENERATED-CONTENT:END -->
2133
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/custom-error-validity.js) -->
2134
- <!-- The below code snippet is automatically added from ./../apiExamples/custom-error-validity.js -->
2135
-
2136
- <pre class="language-js"><code class="language-js">export function customErrorValidityExample(elem) {
2137
- const customErrorValidityExample = document.querySelector('#primaryError');
2138
-
2139
- customErrorValidityExample.addEventListener('auroSelect-valueSet', () =&gt; {
2140
- if (+customErrorValidityExample.value &gt; 2) {
2141
- customErrorValidityExample.setAttribute('error', 'Quantity Exceeded');
2142
- } else if (customErrorValidityExample.hasAttribute('error')) {
2143
- customErrorValidityExample.removeAttribute('error');
2144
- }
2145
- })
2146
- };</code></pre>
2147
- <!-- AURO-GENERATED-CONTENT:END -->
2148
- </auro-accordion>
2149
-
2150
- ### Select in Dialog
2151
-
2152
- The component can be in a dialog.
2153
-
2154
- <div class="exampleWrapper">
2155
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/in-dialog.html) -->
2156
- <!-- The below content is automatically added from ./../apiExamples/in-dialog.html -->
2157
- <div>
2158
- <auro-button id="select-dialog-opener">Select in Dialog</auro-button>
2159
- <auro-dialog id="select-dialog">
2160
- <span slot="header">Select in Dialog</span>
2161
- <div slot="content">
2162
- <auro-select id="valueExample" value="price">
2163
- <span slot="bib.fullscreen.headline">Bib Headline</span>
2164
- <span slot="label">Name</span>
2165
- <auro-menu>
2166
- <auro-menuoption id="option-0" value="stops">Stops</auro-menuoption>
2167
- <auro-menuoption id="option-1" value="price">Price</auro-menuoption>
2168
- <auro-menuoption id="option-2" value="duration">Duration</auro-menuoption>
2169
- <auro-menuoption id="option-3" value="departure">Departure</auro-menuoption>
2170
- <auro-menuoption id="option-4" value="arrival">Arrival</auro-menuoption>
2171
- <auro-menuoption id="option-5" value="prefer alaska">Prefer Alaska</auro-menuoption>
2172
- </auro-menu>
2173
- </auro-select>
2174
- </div>
2175
- </auro-dialog>
2176
- </div>
2177
- <!-- AURO-GENERATED-CONTENT:END -->
2178
- </div>
2179
- <auro-accordion alignRight>
2180
- <span slot="trigger">See code</span>
2181
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/in-dialog.html) -->
2182
- <!-- The below code snippet is automatically added from ./../apiExamples/in-dialog.html -->
2183
-
2184
- <pre class="language-html"><code class="language-html">&lt;div&gt;
2185
- &lt;auro-button id="select-dialog-opener"&gt;Select in Dialog&lt;/auro-button&gt;
2186
- &lt;auro-dialog id="select-dialog"&gt;
2187
- &lt;span slot="header"&gt;Select in Dialog&lt;/span&gt;
2188
- &lt;div slot="content"&gt;
2189
- &lt;auro-select id="valueExample" value="price"&gt;
2190
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
2191
- &lt;span slot="label"&gt;Name&lt;/span&gt;
2192
- &lt;auro-menu&gt;
2193
- &lt;auro-menuoption id="option-0" value="stops"&gt;Stops&lt;/auro-menuoption&gt;
2194
- &lt;auro-menuoption id="option-1" value="price"&gt;Price&lt;/auro-menuoption&gt;
2195
- &lt;auro-menuoption id="option-2" value="duration"&gt;Duration&lt;/auro-menuoption&gt;
2196
- &lt;auro-menuoption id="option-3" value="departure"&gt;Departure&lt;/auro-menuoption&gt;
2197
- &lt;auro-menuoption id="option-4" value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
2198
- &lt;auro-menuoption id="option-5" value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
2199
- &lt;/auro-menu&gt;
2200
- &lt;/auro-select&gt;
2201
- &lt;/div&gt;
2202
- &lt;/auro-dialog&gt;
2203
- &lt;/div&gt;</code></pre>
2204
- <!-- AURO-GENERATED-CONTENT:END -->
2205
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/in-dialog.js) -->
2206
- <!-- The below code snippet is automatically added from ./../apiExamples/in-dialog.js -->
2207
-
2208
- <pre class="language-js"><code class="language-js">export function inDialogExample() {
2209
- document.querySelector("#select-dialog-opener").addEventListener("click", () =&gt; {
2210
- const dialog = document.querySelector("#select-dialog");
2211
- dialog.open = true;
2212
- });
2213
- };</code></pre>
2214
- <!-- AURO-GENERATED-CONTENT:END -->
2215
- </auro-accordion>
2216
-
2217
- ### Select in Drawer
2218
-
2219
- The component can be in a drawer.
2220
-
2221
- <div class="exampleWrapper">
2222
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/in-drawer.html) -->
2223
- <!-- The below content is automatically added from ./../apiExamples/in-drawer.html -->
2224
- <div>
2225
- <auro-button id="select-drawer-opener">Select in drawer</auro-button>
2226
- <auro-drawer id="select-drawer">
2227
- <span slot="header">Select in drawer</span>
2228
- <div slot="content">
2229
- <auro-select id="valueExample" value="price">
2230
- <span slot="bib.fullscreen.headline">Bib Headline</span>
2231
- <span slot="label">Name</span>
2232
- <auro-menu>
2233
- <auro-menuoption id="option-0" value="stops">Stops</auro-menuoption>
2234
- <auro-menuoption id="option-1" value="price">Price</auro-menuoption>
2235
- <auro-menuoption id="option-2" value="duration">Duration</auro-menuoption>
2236
- <auro-menuoption id="option-3" value="departure">Departure</auro-menuoption>
2237
- <auro-menuoption id="option-4" value="arrival">Arrival</auro-menuoption>
2238
- <auro-menuoption id="option-5" value="prefer alaska">Prefer Alaska</auro-menuoption>
2239
- </auro-menu>
2240
- </auro-select>
2241
- </div>
2242
- </auro-drawer>
2243
- </div>
2244
- <!-- AURO-GENERATED-CONTENT:END -->
2245
- </div>
2246
- <auro-accordion alignRight>
2247
- <span slot="trigger">See code</span>
2248
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/in-drawer.html) -->
2249
- <!-- The below code snippet is automatically added from ./../apiExamples/in-drawer.html -->
2250
-
2251
- <pre class="language-html"><code class="language-html">&lt;div&gt;
2252
- &lt;auro-button id="select-drawer-opener"&gt;Select in drawer&lt;/auro-button&gt;
2253
- &lt;auro-drawer id="select-drawer"&gt;
2254
- &lt;span slot="header"&gt;Select in drawer&lt;/span&gt;
2255
- &lt;div slot="content"&gt;
2256
- &lt;auro-select id="valueExample" value="price"&gt;
2257
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
2258
- &lt;span slot="label"&gt;Name&lt;/span&gt;
2259
- &lt;auro-menu&gt;
2260
- &lt;auro-menuoption id="option-0" value="stops"&gt;Stops&lt;/auro-menuoption&gt;
2261
- &lt;auro-menuoption id="option-1" value="price"&gt;Price&lt;/auro-menuoption&gt;
2262
- &lt;auro-menuoption id="option-2" value="duration"&gt;Duration&lt;/auro-menuoption&gt;
2263
- &lt;auro-menuoption id="option-3" value="departure"&gt;Departure&lt;/auro-menuoption&gt;
2264
- &lt;auro-menuoption id="option-4" value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
2265
- &lt;auro-menuoption id="option-5" value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
2266
- &lt;/auro-menu&gt;
2267
- &lt;/auro-select&gt;
2268
- &lt;/div&gt;
2269
- &lt;/auro-drawer&gt;
2270
- &lt;/div&gt;</code></pre>
2271
- <!-- AURO-GENERATED-CONTENT:END -->
2272
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/in-drawer.js) -->
2273
- <!-- The below code snippet is automatically added from ./../apiExamples/in-drawer.js -->
2274
-
2275
- <pre class="language-js"><code class="language-js">export function inDrawerExample() {
2276
- document.querySelector("#select-drawer-opener").addEventListener("click", () =&gt; {
2277
- const drawer = document.querySelector("#select-drawer");
2278
-
2279
- if (drawer.hasAttribute('open')) {
2280
- drawer.removeAttribute('open');
2281
- } else {
2282
- drawer.setAttribute('open', true);
2283
- }
2284
- });
2285
- };</code></pre>
2286
- <!-- AURO-GENERATED-CONTENT:END -->
2287
- </auro-accordion>
2288
-
2289
- ### Watch for Value Changes
2290
-
2291
- The following example listens for the `auroMenu-selectedOption` event. Once triggered, element.value or element.optionSelected may be queried for the new value or complete option object.
2292
-
2293
- <div class="exampleWrapper">
2294
- <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/value-alert.html) -->
2295
- <!-- The below content is automatically added from ./../apiExamples/value-alert.html -->
2296
- <auro-select id="valueAlert" placeholder="Placeholder Text">
2297
- <span slot="bib.fullscreen.headline">Bib Headline</span>
2298
- <span slot="label">Label</span>
2299
- <auro-menu id="valueAlertMenu">
2300
- <auro-menuoption value="stops">Stops</auro-menuoption>
2301
- <auro-menuoption value="price">Price</auro-menuoption>
2302
- <auro-menuoption value="duration">Duration</auro-menuoption>
2303
- <auro-menuoption value="departure">Departure</auro-menuoption>
2304
- <auro-menuoption value="arrival">Arrival</auro-menuoption>
2305
- <auro-menuoption value="prefer alaska">Prefer Alaska</auro-menuoption>
2306
- </auro-menu>
2307
- </auro-select>
2308
- <!-- AURO-GENERATED-CONTENT:END -->
2309
- </div>
2310
- <auro-accordion alignRight>
2311
- <span slot="trigger">See code</span>
2312
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/value-alert.html) -->
2313
- <!-- The below code snippet is automatically added from ./../apiExamples/value-alert.html -->
2314
-
2315
- <pre class="language-html"><code class="language-html">&lt;auro-select id="valueAlert" placeholder="Placeholder Text"&gt;
2316
- &lt;span slot="bib.fullscreen.headline"&gt;Bib Headline&lt;/span&gt;
2317
- &lt;span slot="label"&gt;Label&lt;/span&gt;
2318
- &lt;auro-menu id="valueAlertMenu"&gt;
2319
- &lt;auro-menuoption value="stops"&gt;Stops&lt;/auro-menuoption&gt;
2320
- &lt;auro-menuoption value="price"&gt;Price&lt;/auro-menuoption&gt;
2321
- &lt;auro-menuoption value="duration"&gt;Duration&lt;/auro-menuoption&gt;
2322
- &lt;auro-menuoption value="departure"&gt;Departure&lt;/auro-menuoption&gt;
2323
- &lt;auro-menuoption value="arrival"&gt;Arrival&lt;/auro-menuoption&gt;
2324
- &lt;auro-menuoption value="prefer alaska"&gt;Prefer Alaska&lt;/auro-menuoption&gt;
2325
- &lt;/auro-menu&gt;
2326
- &lt;/auro-select&gt;</code></pre>
2327
- <!-- AURO-GENERATED-CONTENT:END -->
2328
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/value-alert.js) -->
2329
- <!-- The below code snippet is automatically added from ./../apiExamples/value-alert.js -->
2330
-
2331
- <pre class="language-js"><code class="language-js">export function valueAlertExample() {
2332
- const select = document.querySelector('#valueAlert');
2333
- const menu = document.querySelector('#valueAlertMenu');
2334
-
2335
- menu.addEventListener('auroMenu-selectedOption', () =&gt; {
2336
- console.warn('Select value changed to:', select.value);
2337
- console.warn('Select optionSelected changed to:', select.optionSelected);
2338
- });
2339
- }</code></pre>
2340
- <!-- AURO-GENERATED-CONTENT:END -->
2341
- </auro-accordion>
2342
-
2343
- ## Restyle Component with CSS Variables
2344
-
2345
- The component may be restyled by changing the values of the following token(s).
2346
-
2347
- <!-- Remove section if component does not have any component specific tokens -->
2348
- <!-- AURO-GENERATED-CONTENT:START (CODE:src=./../src/styles/tokens.scss) -->
2349
- <!-- The below code snippet is automatically added from ./../src/styles/tokens.scss -->
2350
-
2351
- <pre class="language-scss"><code class="language-scss">@use "@aurodesignsystem/design-tokens/dist/themes/alaska/SCSSVariables--alaska" as v;
2352
-
2353
- :host(:not([ondark])),
2354
- :host(:not([appearance='inverse'])) {
2355
- --ds-auro-select-border-color: var(--ds-basic-color-border-bold, #{v.$ds-basic-color-border-bold});
2356
- --ds-auro-select-background-color: var(--ds-basic-color-surface-default, #{v.$ds-basic-color-surface-default});
2357
- --ds-auro-select-label-text-color: var(--ds-basic-color-texticon-muted, #{v.$ds-basic-color-texticon-muted});
2358
- --ds-auro-select-placeholder-text-color: var(--ds-basic-color-texticon-default, #{v.$ds-basic-color-texticon-default});
2359
- --ds-auro-select-text-color: var(--ds-basic-color-texticon-default, #{v.$ds-basic-color-texticon-default});
2360
- --ds-auro-select-error-icon-color: var(--ds-basic-color-status-error, #{v.$ds-basic-color-status-error});
2361
- --ds-auro-select-outline-color: transparent;
2362
- }
2363
-
2364
- :host([ondark]),
2365
- :host([appearance='inverse']) {
2366
- --ds-auro-select-border-color: var(--ds-basic-color-border-inverse, #{v.$ds-basic-color-border-inverse});
2367
- --ds-auro-select-background-color: var(--ds-advanced-color-shared-background-inverse, #{v.$ds-advanced-color-shared-background-inverse});
2368
- --ds-auro-select-label-text-color: var(--ds-basic-color-texticon-inverse-muted, #{v.$ds-basic-color-texticon-inverse-muted});
2369
- --ds-auro-select-placeholder-text-color: var(--ds-basic-color-texticon-inverse, #{v.$ds-basic-color-texticon-inverse});
2370
- --ds-auro-select-text-color: var(--ds-basic-color-texticon-inverse, #{v.$ds-basic-color-texticon-inverse});
2371
- --ds-auro-select-error-icon-color: var(--ds-advanced-color-state-error-inverse, #{v.$ds-advanced-color-state-error-inverse});
2372
- --ds-auro-select-outline-color: transparent;
2373
- }</code></pre>
79
+ |-------------------|--------------------------------------------------|
80
+ | `dropdownChevron` | Apply CSS to the collapsed/expanded state icon container. |
81
+ | `dropdownSize` | Apply size styles to the dropdown bib (height, width, maxHeight, maxWidth only). |
82
+ | `dropdownTrigger` | Apply CSS to the trigger content container. |
83
+ | `helpText` | Apply CSS to the help text. |
2374
84
  <!-- AURO-GENERATED-CONTENT:END -->