@aurodesignsystem-dev/auro-formkit 0.0.0-pr1497.6 → 0.0.0-pr1498.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/components/checkbox/demo/customize.min.js +2 -2
- package/components/checkbox/demo/getting-started.min.js +2 -2
- package/components/checkbox/demo/index.min.js +2 -2
- package/components/checkbox/dist/index.js +2 -2
- package/components/checkbox/dist/registered.js +2 -2
- package/components/combobox/demo/customize.md +7 -3
- package/components/combobox/demo/customize.min.js +1438 -1668
- package/components/combobox/demo/getting-started.min.js +1440 -1670
- package/components/combobox/demo/index.min.js +1440 -1670
- package/components/combobox/dist/auro-combobox.d.ts +5 -0
- package/components/combobox/dist/index.js +485 -140
- package/components/combobox/dist/registered.js +485 -140
- package/components/counter/demo/customize.min.js +20 -3
- package/components/counter/demo/index.min.js +20 -3
- package/components/counter/dist/index.js +5447 -192
- package/components/counter/dist/registered.js +5447 -192
- package/components/datepicker/demo/customize.min.js +149 -58
- package/components/datepicker/demo/index.min.js +149 -58
- package/components/datepicker/dist/index.js +149 -58
- package/components/datepicker/dist/registered.js +149 -58
- package/components/dropdown/demo/customize.min.js +18 -1
- package/components/dropdown/demo/getting-started.min.js +18 -1
- package/components/dropdown/demo/index.min.js +18 -1
- package/components/dropdown/dist/auro-dropdown.d.ts +1 -0
- package/components/dropdown/dist/index.js +18 -1
- package/components/dropdown/dist/registered.js +18 -1
- package/components/form/demo/customize.min.js +7910 -7909
- package/components/form/demo/getting-started.min.js +7910 -7909
- package/components/form/demo/index.min.js +7910 -7909
- package/components/form/demo/registerDemoDeps.min.js +7872 -7871
- package/components/input/demo/customize.min.js +131 -56
- package/components/input/demo/getting-started.min.js +131 -56
- package/components/input/demo/index.min.js +131 -56
- package/components/input/dist/base-input.d.ts +16 -0
- package/components/input/dist/index.js +131 -56
- package/components/input/dist/registered.js +131 -56
- package/components/menu/demo/api.md +41 -45
- package/components/menu/demo/customize.md +0 -28
- package/components/menu/demo/index.min.js +779 -1354
- package/components/menu/dist/auro-menu.d.ts +95 -110
- package/components/menu/dist/auro-menuoption.d.ts +32 -138
- package/components/menu/dist/index.js +753 -1308
- package/components/menu/dist/registered.js +765 -1308
- package/components/radio/demo/customize.min.js +2 -2
- package/components/radio/demo/getting-started.min.js +2 -2
- package/components/radio/demo/index.min.js +2 -2
- package/components/radio/dist/index.js +2 -2
- package/components/radio/dist/registered.js +2 -2
- package/components/select/demo/customize.md +7 -3
- package/components/select/demo/customize.min.js +1088 -1615
- package/components/select/demo/getting-started.min.js +1088 -1615
- package/components/select/demo/index.min.js +1088 -1615
- package/components/select/dist/index.js +63 -15
- package/components/select/dist/registered.js +63 -15
- package/components/select/dist/selectUtils.d.ts +12 -0
- package/custom-elements.json +379 -1025
- package/package.json +1 -1
- package/components/menu/dist/auro-menu.context.d.ts +0 -238
|
@@ -4490,7 +4490,7 @@ class AuroFormValidation {
|
|
|
4490
4490
|
} else if (this.runtimeUtils.elementMatch(elem, 'auro-input') && elem.errorMessage === '') {
|
|
4491
4491
|
const input = elem.renderRoot.querySelector('input');
|
|
4492
4492
|
|
|
4493
|
-
if (input.validationMessage.length > 0) {
|
|
4493
|
+
if (input && input.validationMessage.length > 0) {
|
|
4494
4494
|
elem.errorMessage = input.validationMessage;
|
|
4495
4495
|
}
|
|
4496
4496
|
} else if (this.runtimeUtils.elementMatch(elem, 'auro-combobox') && elem.errorMessage === '') {
|
|
@@ -10327,7 +10327,6 @@ class AuroInputUtilities {
|
|
|
10327
10327
|
const maskOptions = this.getMaskOptions('date', normalizedFormat);
|
|
10328
10328
|
|
|
10329
10329
|
if (!(valueObject instanceof Date) || Number.isNaN(valueObject.getTime()) || !maskOptions || typeof maskOptions.format !== 'function') {
|
|
10330
|
-
console.debug('Invalid date object or mask options for formatting', { valueObject, maskOptions }); // eslint-disable-line no-console
|
|
10331
10330
|
return undefined;
|
|
10332
10331
|
}
|
|
10333
10332
|
|
|
@@ -11030,7 +11029,7 @@ class BaseInput extends AuroElement {
|
|
|
11030
11029
|
* @returns {Date|undefined}
|
|
11031
11030
|
*/
|
|
11032
11031
|
get valueObject() {
|
|
11033
|
-
return this._valueObject;
|
|
11032
|
+
return this._valueObject || this._computeDateObjectFallback(this.value);
|
|
11034
11033
|
}
|
|
11035
11034
|
|
|
11036
11035
|
/**
|
|
@@ -11038,7 +11037,7 @@ class BaseInput extends AuroElement {
|
|
|
11038
11037
|
* @returns {Date|undefined}
|
|
11039
11038
|
*/
|
|
11040
11039
|
get minObject() {
|
|
11041
|
-
return this._minObject;
|
|
11040
|
+
return this._minObject || this._computeDateObjectFallback(this.min);
|
|
11042
11041
|
}
|
|
11043
11042
|
|
|
11044
11043
|
/**
|
|
@@ -11046,7 +11045,31 @@ class BaseInput extends AuroElement {
|
|
|
11046
11045
|
* @returns {Date|undefined}
|
|
11047
11046
|
*/
|
|
11048
11047
|
get maxObject() {
|
|
11049
|
-
return this._maxObject;
|
|
11048
|
+
return this._maxObject || this._computeDateObjectFallback(this.max);
|
|
11049
|
+
}
|
|
11050
|
+
|
|
11051
|
+
/**
|
|
11052
|
+
* Parses a date string into a Date object when the corresponding `_*Object`
|
|
11053
|
+
* field hasn't been synced yet by `updated()`. Returns undefined when the
|
|
11054
|
+
* input type/format isn't a full date or the string is not a valid date.
|
|
11055
|
+
*
|
|
11056
|
+
* Why this exists: a parent (datepicker) can call `inputN.validate()` from
|
|
11057
|
+
* inside its own `updated()` before this input's `updated()` has run
|
|
11058
|
+
* `syncDateValues()` — so `_valueObject`/`_maxObject` are still `undefined`
|
|
11059
|
+
* and range checks would otherwise silently no-op (flipping the result to
|
|
11060
|
+
* `valid` or `patternMismatch`).
|
|
11061
|
+
* @private
|
|
11062
|
+
* @param {string|undefined} dateStr - ISO date string from `value`/`min`/`max`.
|
|
11063
|
+
* @returns {Date|undefined}
|
|
11064
|
+
*/
|
|
11065
|
+
_computeDateObjectFallback(dateStr) {
|
|
11066
|
+
if (!dateStr || !this.util || !this.util.isFullDateFormat(this.type, this.format)) {
|
|
11067
|
+
return undefined;
|
|
11068
|
+
}
|
|
11069
|
+
if (!dateFormatter.isValidDate(dateStr)) {
|
|
11070
|
+
return undefined;
|
|
11071
|
+
}
|
|
11072
|
+
return dateFormatter.stringToDateInstance(dateStr);
|
|
11050
11073
|
}
|
|
11051
11074
|
|
|
11052
11075
|
/**
|
|
@@ -11071,8 +11094,30 @@ class BaseInput extends AuroElement {
|
|
|
11071
11094
|
connectedCallback() {
|
|
11072
11095
|
super.connectedCallback();
|
|
11073
11096
|
|
|
11097
|
+
// Mark for query selectors when registered under a versioned tag (e.g. inside
|
|
11098
|
+
// a datepicker/combobox). Must run before parent components call validate() on
|
|
11099
|
+
// their inner inputs — the validation framework matches via tag-or-attribute,
|
|
11100
|
+
// and parents trigger validation during their own updated() cycle, which can
|
|
11101
|
+
// precede this input's firstUpdated().
|
|
11102
|
+
if (this.tagName.toLowerCase() !== 'auro-input' && !this.hasAttribute('auro-input')) {
|
|
11103
|
+
this.setAttribute('auro-input', '');
|
|
11104
|
+
}
|
|
11105
|
+
|
|
11074
11106
|
this.locale = this.domHandler.getLocale(this);
|
|
11075
11107
|
notifyOnLangChange(this);
|
|
11108
|
+
|
|
11109
|
+
// Pre-compute lengthForType and date-object fields so a parent (e.g. datepicker)
|
|
11110
|
+
// calling our validate() synchronously during its own updated() cycle sees
|
|
11111
|
+
// populated values. Without this, range validation silently no-ops because
|
|
11112
|
+
// `max.length === lengthForType` fails when lengthForType is still undefined.
|
|
11113
|
+
// Rebuild util here (constructor seeded with en-US default) so configureDataForType's
|
|
11114
|
+
// locale-derived format lookup uses the actual locale just resolved above.
|
|
11115
|
+
this.util = new AuroInputUtilities({
|
|
11116
|
+
locale: this.locale,
|
|
11117
|
+
format: this.format
|
|
11118
|
+
});
|
|
11119
|
+
this.configureDataForType();
|
|
11120
|
+
this.syncDateValues();
|
|
11076
11121
|
}
|
|
11077
11122
|
|
|
11078
11123
|
disconnectedCallback() {
|
|
@@ -11093,8 +11138,8 @@ class BaseInput extends AuroElement {
|
|
|
11093
11138
|
}
|
|
11094
11139
|
|
|
11095
11140
|
// add attribute for query selectors when auro-input is registered under a custom name
|
|
11096
|
-
if (this.tagName.toLowerCase() !== 'auro-input') {
|
|
11097
|
-
this.setAttribute('auro-input',
|
|
11141
|
+
if (this.tagName.toLowerCase() !== 'auro-input' && !this.hasAttribute('auro-input')) {
|
|
11142
|
+
this.setAttribute('auro-input', '');
|
|
11098
11143
|
}
|
|
11099
11144
|
this.inputId = this.id ? `${this.id}-input` : window.crypto.randomUUID();
|
|
11100
11145
|
|
|
@@ -11142,6 +11187,12 @@ class BaseInput extends AuroElement {
|
|
|
11142
11187
|
return;
|
|
11143
11188
|
}
|
|
11144
11189
|
|
|
11190
|
+
// While configureAutoFormatting is running, imask's internal updateControl
|
|
11191
|
+
// writes el.value to align display with the masked value. A synthetic input
|
|
11192
|
+
// event from that write would re-enter handleInput → processCreditCard mid-setup
|
|
11193
|
+
// and clobber a Lit value that was just pushed by the parent combobox.
|
|
11194
|
+
if (component._configuringMask) return;
|
|
11195
|
+
|
|
11145
11196
|
// If all guard clauses are passed, dispatch the event
|
|
11146
11197
|
const inputEvent = new InputEvent('input', {
|
|
11147
11198
|
bubbles: true,
|
|
@@ -11260,7 +11311,16 @@ class BaseInput extends AuroElement {
|
|
|
11260
11311
|
|
|
11261
11312
|
if (formattedValue !== this.inputElement.value) {
|
|
11262
11313
|
this.skipNextProgrammaticInputEvent = true;
|
|
11263
|
-
if (
|
|
11314
|
+
if (this.maskInstance && this.type === 'credit-card') {
|
|
11315
|
+
// Route through the mask so its _value and el.value stay in lock-step
|
|
11316
|
+
// (set value calls updateControl which writes el.value = displayValue).
|
|
11317
|
+
// Writing el.value directly leaves the mask thinking displayValue is
|
|
11318
|
+
// stale; _saveSelection on the next focus/click then warns. Scoped to
|
|
11319
|
+
// credit-card so date's own formattedValue (raw ISO when calendar-invalid)
|
|
11320
|
+
// isn't re-masked through the mm/dd/yyyy mask, which would truncate it
|
|
11321
|
+
// and flip validity from patternMismatch to tooShort.
|
|
11322
|
+
this.maskInstance.value = formattedValue || '';
|
|
11323
|
+
} else if (formattedValue) {
|
|
11264
11324
|
this.inputElement.value = formattedValue;
|
|
11265
11325
|
} else {
|
|
11266
11326
|
this.inputElement.value = '';
|
|
@@ -11369,58 +11429,73 @@ class BaseInput extends AuroElement {
|
|
|
11369
11429
|
* @returns {void}
|
|
11370
11430
|
*/
|
|
11371
11431
|
configureAutoFormatting() {
|
|
11372
|
-
|
|
11373
|
-
|
|
11374
|
-
|
|
11375
|
-
|
|
11376
|
-
|
|
11377
|
-
this.
|
|
11378
|
-
|
|
11379
|
-
|
|
11380
|
-
|
|
11381
|
-
if (this.inputElement && maskOptions.mask) {
|
|
11382
|
-
|
|
11383
|
-
// Stash and clear any existing value before IMask init.
|
|
11384
|
-
// IMask's constructor processes the current input value which requires
|
|
11385
|
-
// selection state — clearing first avoids that scenario entirely.
|
|
11386
|
-
// When the format changes (e.g. locale switch) and we have a valid ISO
|
|
11387
|
-
// model value, compute the display string for the NEW format instead of
|
|
11388
|
-
// re-using the old display string, which may be invalid in the new mask.
|
|
11389
|
-
let existingValue = this.inputElement.value;
|
|
11390
|
-
if (
|
|
11391
|
-
this.util.isFullDateFormat(this.type, this.format) &&
|
|
11392
|
-
this.value &&
|
|
11393
|
-
dateFormatter.isValidDate(this.value) &&
|
|
11394
|
-
this.valueObject instanceof Date &&
|
|
11395
|
-
!Number.isNaN(this.valueObject.getTime()) &&
|
|
11396
|
-
typeof maskOptions.format === 'function'
|
|
11397
|
-
) {
|
|
11398
|
-
existingValue = maskOptions.format(this.valueObject);
|
|
11432
|
+
// Re-entrancy guard. The patched-setter's synthetic input event (suppressed
|
|
11433
|
+
// by _configuringMask above) could otherwise trigger handleInput →
|
|
11434
|
+
// processCreditCard → configureAutoFormatting before the outer call's
|
|
11435
|
+
// set value has finished its alignCursor pass.
|
|
11436
|
+
if (this._configuringMask) return;
|
|
11437
|
+
this._configuringMask = true;
|
|
11438
|
+
try {
|
|
11439
|
+
if (this.maskInstance) {
|
|
11440
|
+
this.maskInstance.destroy();
|
|
11399
11441
|
}
|
|
11400
11442
|
|
|
11401
|
-
|
|
11402
|
-
this.
|
|
11403
|
-
|
|
11404
|
-
this.maskInstance = IMask(this.inputElement, maskOptions);
|
|
11443
|
+
// Pass new format to util
|
|
11444
|
+
this.util.updateFormat(this.format);
|
|
11405
11445
|
|
|
11406
|
-
this.
|
|
11407
|
-
|
|
11408
|
-
|
|
11409
|
-
|
|
11446
|
+
const maskOptions = this.util.getMaskOptions(this.type, this.format);
|
|
11447
|
+
|
|
11448
|
+
if (this.inputElement && maskOptions.mask) {
|
|
11449
|
+
|
|
11450
|
+
// Stash and clear any existing value before IMask init.
|
|
11451
|
+
// IMask's constructor processes the current input value which requires
|
|
11452
|
+
// selection state — clearing first avoids that scenario entirely.
|
|
11453
|
+
// When the format changes (e.g. locale switch) and we have a valid ISO
|
|
11454
|
+
// model value, compute the display string for the NEW format instead of
|
|
11455
|
+
// re-using the old display string, which may be invalid in the new mask.
|
|
11456
|
+
let existingValue = this.inputElement.value;
|
|
11457
|
+
if (
|
|
11458
|
+
this.util.isFullDateFormat(this.type, this.format) &&
|
|
11459
|
+
this.value &&
|
|
11460
|
+
dateFormatter.isValidDate(this.value) &&
|
|
11461
|
+
this.valueObject instanceof Date &&
|
|
11462
|
+
!Number.isNaN(this.valueObject.getTime()) &&
|
|
11463
|
+
typeof maskOptions.format === 'function'
|
|
11464
|
+
) {
|
|
11465
|
+
existingValue = maskOptions.format(this.valueObject);
|
|
11410
11466
|
}
|
|
11411
|
-
});
|
|
11412
11467
|
|
|
11413
|
-
|
|
11414
|
-
this.value =
|
|
11415
|
-
|
|
11416
|
-
|
|
11417
|
-
|
|
11418
|
-
|
|
11468
|
+
this.skipNextProgrammaticInputEvent = true;
|
|
11469
|
+
this.inputElement.value = '';
|
|
11470
|
+
|
|
11471
|
+
this.maskInstance = IMask(this.inputElement, maskOptions);
|
|
11472
|
+
|
|
11473
|
+
this.maskInstance.on('accept', () => {
|
|
11474
|
+
// Suppress propagation during configureAutoFormatting's own value-restoration
|
|
11475
|
+
// (line below) — the mask emits 'accept' on every value-set, including ours,
|
|
11476
|
+
// and we don't want to overwrite a value the parent just pushed.
|
|
11477
|
+
if (this._configuringMask) return;
|
|
11478
|
+
this.value = this.util.toModelValue(this.maskInstance.value, this.format);
|
|
11479
|
+
if (this.type === "date") {
|
|
11480
|
+
this._rawMaskValue = this.maskInstance.value;
|
|
11481
|
+
}
|
|
11482
|
+
});
|
|
11419
11483
|
|
|
11420
|
-
|
|
11421
|
-
|
|
11422
|
-
|
|
11484
|
+
this.maskInstance.on('complete', () => {
|
|
11485
|
+
if (this._configuringMask) return;
|
|
11486
|
+
this.value = this.util.toModelValue(this.maskInstance.value, this.format);
|
|
11487
|
+
if (this.type === "date") {
|
|
11488
|
+
this._rawMaskValue = this.maskInstance.value;
|
|
11489
|
+
}
|
|
11490
|
+
});
|
|
11491
|
+
|
|
11492
|
+
// Restore the stashed value through IMask so it's properly masked
|
|
11493
|
+
if (existingValue) {
|
|
11494
|
+
this.maskInstance.value = existingValue;
|
|
11495
|
+
}
|
|
11423
11496
|
}
|
|
11497
|
+
} finally {
|
|
11498
|
+
this._configuringMask = false;
|
|
11424
11499
|
}
|
|
11425
11500
|
}
|
|
11426
11501
|
|
|
@@ -11707,10 +11782,10 @@ class BaseInput extends AuroElement {
|
|
|
11707
11782
|
},
|
|
11708
11783
|
{
|
|
11709
11784
|
name: 'Diners club',
|
|
11710
|
-
regex: /^(?<num>36|38)\d{0}/u,
|
|
11785
|
+
regex: /^(?<num>30[0-5]|36|38)\d{0}/u,
|
|
11711
11786
|
formatLength: 16,
|
|
11712
11787
|
errorMessage: CreditCardValidationMessage,
|
|
11713
|
-
cardIcon: '
|
|
11788
|
+
cardIcon: 'cc-dinersclub',
|
|
11714
11789
|
maskFormat: "0000 000000 0000"
|
|
11715
11790
|
},
|
|
11716
11791
|
{
|
|
@@ -12120,7 +12195,7 @@ class AuroHelpText extends LitElement {
|
|
|
12120
12195
|
}
|
|
12121
12196
|
}
|
|
12122
12197
|
|
|
12123
|
-
var formkitVersion = '
|
|
12198
|
+
var formkitVersion = '202606100232';
|
|
12124
12199
|
|
|
12125
12200
|
// Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
|
|
12126
12201
|
// See LICENSE in the project root for license information.
|
|
@@ -7,32 +7,32 @@ The `auro-menu` element provides users a way to select from a list of options.
|
|
|
7
7
|
|
|
8
8
|
## Properties
|
|
9
9
|
|
|
10
|
-
| Property
|
|
11
|
-
|
|
12
|
-
| `
|
|
13
|
-
| `
|
|
14
|
-
| `
|
|
15
|
-
| `
|
|
16
|
-
| `
|
|
17
|
-
| `
|
|
18
|
-
| `
|
|
19
|
-
| `
|
|
20
|
-
| `
|
|
21
|
-
| `
|
|
22
|
-
| `
|
|
23
|
-
| `
|
|
24
|
-
| `
|
|
25
|
-
| `
|
|
26
|
-
| `
|
|
27
|
-
| `selectedOptions` | | readonly | `HTMLElement[]` | | Gets the currently selected options. |
|
|
28
|
-
| `value` | `value` | | `string` | | The value of the selected option. In multi-select mode, this is a JSON stringified array of selected option values. |
|
|
10
|
+
| Property | Attribute | Modifiers | Type | Default | Description |
|
|
11
|
+
|-------------------------|------------------|-----------|-----------------------|-------------|--------------------------------------------------|
|
|
12
|
+
| `currentLabel` | | readonly | `string` | | |
|
|
13
|
+
| `disabled` | `disabled` | | `boolean` | | When true, the entire menu and all options are disabled. |
|
|
14
|
+
| `hasLoadingPlaceholder` | | readonly | `boolean` | | Getter for loading placeholder state. |
|
|
15
|
+
| `index` | | | `number` | | |
|
|
16
|
+
| `layout` | | | `string` | | |
|
|
17
|
+
| `loading` | `loading` | | `boolean` | false | When true, displays a loading state using the loadingIcon and loadingText slots if provided. |
|
|
18
|
+
| `matchWord` | `matchword` | | `string` | "undefined" | Specifies a string used to highlight matched string parts in options. |
|
|
19
|
+
| `multiSelect` | `multiselect` | | `boolean` | false | When true, the selected option can be multiple options. |
|
|
20
|
+
| `noCheckmark` | `nocheckmark` | | `boolean` | false | When true, selected option will not show the checkmark. |
|
|
21
|
+
| `optionActive` | `optionactive` | | `object` | "undefined" | Specifies the current active menuOption. |
|
|
22
|
+
| `optionSelected` | `optionSelected` | | `object` | "undefined" | An array of currently selected menu options, type `HTMLElement` by default. In multi-select mode, `optionSelected` is an array of HTML elements. |
|
|
23
|
+
| `options` | | readonly | `HTMLElement[]` | | |
|
|
24
|
+
| `selectedOption` | | readonly | `HTMLElement \| null` | | Gets the first selected option, or null if none. |
|
|
25
|
+
| `selectedOptions` | | readonly | `HTMLElement[]` | | Gets the currently selected options as an array. |
|
|
26
|
+
| `value` | `value` | | `string` | "undefined" | The value of the selected option. In multi-select mode, this is a JSON stringified array of selected option values. |
|
|
29
27
|
|
|
30
28
|
## Methods
|
|
31
29
|
|
|
32
|
-
| Method | Type
|
|
33
|
-
|
|
34
|
-
| `
|
|
35
|
-
| `
|
|
30
|
+
| Method | Type | Description |
|
|
31
|
+
|----------------------|--------------------------------------------------|--------------------------------------------------|
|
|
32
|
+
| `navigateOptions` | `(direction: string): void` | Navigates through options using keyboard.<br /><br />**direction**: 'up' or 'down'. |
|
|
33
|
+
| `reset` | `(): void` | Resets the menu to its initial state.<br />This is the only way to return value to undefined. |
|
|
34
|
+
| `selectByValue` | `(value: string \| string[] \| null \| undefined): void` | Selects options by value.<br /><br />**value**: The value(s) to select. |
|
|
35
|
+
| `updateActiveOption` | `(indexOrOption: number \| HTMLElement): void` | Updates the active option state and dispatches events.<br />Accepts either a numeric index or an HTMLElement option.<br /><br />**indexOrOption**: Index of the option or the option element to make active. |
|
|
36
36
|
|
|
37
37
|
## Events
|
|
38
38
|
|
|
@@ -40,9 +40,8 @@ The `auro-menu` element provides users a way to select from a list of options.
|
|
|
40
40
|
|-------------------------------|--------------------------------------------------|--------------------------------------------------|
|
|
41
41
|
| `auroMenu-activatedOption` | `CustomEvent<Element>` | Notifies that a menuoption has been made `active`. |
|
|
42
42
|
| `auroMenu-customEventFired` | `CustomEvent<any>` | Notifies that a custom event has been fired. |
|
|
43
|
-
| `auroMenu-deselectPrevented` | `CustomEvent<{ values: HTMLElement[] }>` | Notifies that deselection was prevented and includes the affected options in `detail.values`. |
|
|
44
43
|
| `auroMenu-loadingChange` | `CustomEvent<{ loading: boolean; hasLoadingPlaceholder: boolean; }>` | Notifies when the loading attribute is changed. |
|
|
45
|
-
| `auroMenu-optionsChange` | `CustomEvent<{ options:
|
|
44
|
+
| `auroMenu-optionsChange` | `CustomEvent<{ options: Element[] \| undefined; }>` | |
|
|
46
45
|
| `auroMenu-selectValueFailure` | `CustomEvent<any>` | Notifies that an attempt to select a menuoption by matching a value has failed. |
|
|
47
46
|
| `auroMenu-selectValueReset` | `CustomEvent<any>` | Notifies that the component value has been reset. |
|
|
48
47
|
| `auroMenu-selectedOption` | `CustomEvent<any>` | Notifies that a new menuoption selection has been made. |
|
|
@@ -61,34 +60,31 @@ The `auro-menuoption` element provides users a way to define a menu option.
|
|
|
61
60
|
|
|
62
61
|
## Properties
|
|
63
62
|
|
|
64
|
-
| Property | Attribute
|
|
65
|
-
|
|
66
|
-
| `disabled` | `disabled`
|
|
67
|
-
| `iconTag` |
|
|
68
|
-
| `isActive` |
|
|
69
|
-
| `
|
|
70
|
-
| `
|
|
71
|
-
| `
|
|
72
|
-
| `
|
|
73
|
-
| `
|
|
74
|
-
| `value` | `value` | | `string` | | Specifies the value to be sent to a server. |
|
|
63
|
+
| Property | Attribute | Modifiers | Type | Default | Description |
|
|
64
|
+
|---------------|---------------|-----------|-----------|---------|--------------------------------------------------|
|
|
65
|
+
| `disabled` | `disabled` | | `boolean` | false | |
|
|
66
|
+
| `iconTag` | | | | | |
|
|
67
|
+
| `isActive` | | readonly | `boolean` | | Returns whether the menu option is currently active and selectable. |
|
|
68
|
+
| `layout` | | | `string` | | |
|
|
69
|
+
| `noCheckmark` | `noCheckmark` | | `boolean` | false | |
|
|
70
|
+
| `noMatch` | `nomatch` | | `boolean` | false | When true, marks this option as the "no matching results" placeholder shown by combobox<br />when the user's input does not match any available options. |
|
|
71
|
+
| `selected` | `selected` | | `boolean` | false | |
|
|
72
|
+
| `value` | `value` | | `string` | | |
|
|
75
73
|
|
|
76
74
|
## Methods
|
|
77
75
|
|
|
78
|
-
| Method
|
|
79
|
-
|
|
80
|
-
| `attachTo`
|
|
81
|
-
| `
|
|
82
|
-
| `
|
|
83
|
-
| `
|
|
84
|
-
| `setSelected` | `(isSelected: boolean): void` | Sets the selected state of the menu option.<br />This function updates whether the option is currently selected.<br /><br />**isSelected**: Whether the option should be marked as selected. |
|
|
85
|
-
| `updateActive` | `(isActive: boolean): void` | Updates the active state and visual highlighting of the menu option.<br />This function toggles the option's active status and applies or removes the active CSS class.<br /><br />**isActive**: Whether the option should be marked as active. |
|
|
76
|
+
| Method | Type |
|
|
77
|
+
|--------------------|-----------------------|
|
|
78
|
+
| `attachTo` | `(): void` |
|
|
79
|
+
| `handleMenuChange` | `(): void` |
|
|
80
|
+
| `setSelected` | `(value: any): void` |
|
|
81
|
+
| `updateActive` | `(active: any): void` |
|
|
86
82
|
|
|
87
83
|
## Events
|
|
88
84
|
|
|
89
85
|
| Event | Type | Description |
|
|
90
86
|
|----------------------------|---------------------|--------------------------------------------------|
|
|
91
|
-
| `auroMenuOption-click` | `CustomEvent<this>` |
|
|
87
|
+
| `auroMenuOption-click` | `CustomEvent<this>` | Notifies that this option has been clicked. |
|
|
92
88
|
| `auroMenuOption-mouseover` | `CustomEvent<this>` | Notifies that this option has been hovered over. |
|
|
93
89
|
|
|
94
90
|
## Slots
|
|
@@ -18,7 +18,6 @@
|
|
|
18
18
|
<auro-anchorlink fluid href="#presetValue" class="level2 body-xs">Preset Value</auro-anchorlink>
|
|
19
19
|
<auro-anchorlink fluid href="#presetValueMultiselect" class="level2 body-xs">Preset Value (Multi)</auro-anchorlink>
|
|
20
20
|
<auro-anchorlink fluid href="#preselect" class="level2 body-xs">Pre-Selected</auro-anchorlink>
|
|
21
|
-
<auro-anchorlink fluid href="#allowDeselect" class="level2 body-xs">Allow Deselect</auro-anchorlink>
|
|
22
21
|
</auro-nav>
|
|
23
22
|
</nav>
|
|
24
23
|
<div class="mainContent">
|
|
@@ -604,33 +603,6 @@
|
|
|
604
603
|
</auro-menu></code></pre>
|
|
605
604
|
<!-- AURO-GENERATED-CONTENT:END -->
|
|
606
605
|
</auro-accordion>
|
|
607
|
-
<auro-header level="3" id="allowDeselect">Allow Deselect</auro-header>
|
|
608
|
-
<p>Use the <code>allowDeselect</code> attribute to allow users to click a selected option again to deselect it in single-select mode. In multi-select mode, deselection is always available regardless of this attribute.</p>
|
|
609
|
-
<div class="exampleWrapper">
|
|
610
|
-
<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/allow-deselect.html) -->
|
|
611
|
-
<!-- The below content is automatically added from ./../apiExamples/allow-deselect.html -->
|
|
612
|
-
<auro-menu allowDeselect>
|
|
613
|
-
<auro-menuoption value="stops">Stops</auro-menuoption>
|
|
614
|
-
<auro-menuoption value="price">Price</auro-menuoption>
|
|
615
|
-
<auro-menuoption value="duration">Duration</auro-menuoption>
|
|
616
|
-
<auro-menuoption value="departure">Departure</auro-menuoption>
|
|
617
|
-
<auro-menuoption value="arrival">Arrival</auro-menuoption>
|
|
618
|
-
</auro-menu>
|
|
619
|
-
<!-- AURO-GENERATED-CONTENT:END -->
|
|
620
|
-
</div>
|
|
621
|
-
<auro-accordion alignRight>
|
|
622
|
-
<span slot="trigger">See code</span>
|
|
623
|
-
<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/allow-deselect.html) -->
|
|
624
|
-
<!-- The below code snippet is automatically added from ./../apiExamples/allow-deselect.html -->
|
|
625
|
-
<pre class="language-html"><code class="language-html"><auro-menu allowDeselect>
|
|
626
|
-
<auro-menuoption value="stops">Stops</auro-menuoption>
|
|
627
|
-
<auro-menuoption value="price">Price</auro-menuoption>
|
|
628
|
-
<auro-menuoption value="duration">Duration</auro-menuoption>
|
|
629
|
-
<auro-menuoption value="departure">Departure</auro-menuoption>
|
|
630
|
-
<auro-menuoption value="arrival">Arrival</auro-menuoption>
|
|
631
|
-
</auro-menu></code></pre>
|
|
632
|
-
<!-- AURO-GENERATED-CONTENT:END -->
|
|
633
|
-
</auro-accordion>
|
|
634
606
|
</section>
|
|
635
607
|
</div>
|
|
636
608
|
</div>
|