Combobox: API Table

class: `LionCombobox`, `lion-combobox`

Fields

Name	Privacy	Type	Default	Description	Inherited From
`activeIndex`	public				ListboxMixin
`allowCustomChoice`	public	`boolean`	`false`		CustomChoiceGroupMixin
`autocomplete`	public	`'none'\|'list'\|'inline'\|'both'`	`'both'`	When "list", will filter listbox suggestions based on textbox value. When "both", an inline completion string will be added to the textbox as well.
`autofocus`	public	`boolean`	`false`		FocusMixin
`checkedIndex`	public	`number \| number[]`			ListboxMixin
`config`	public	`Partial<OverlayConfig>`	`{}`	Configure the many options of the `OverlayController`	OverlayMixin
`customChoices`	public			Custom elements are all missing elements that have no corresponding element, independent if enabled or not.	CustomChoiceGroupMixin
`defaultValidators`	public	`Validator[]`	`[]`	Used by Subclassers to add default Validators to a particular FormControl. A date input for instance, always needs the isDate validator.	ValidateMixin
`dirty`	public	`boolean`	`false`	True when user has changed the value of the field.	InteractionStateMixin
`disabled`	public	`boolean`	`false`		DisabledMixin
`done`	public	`boolean`	`false`		FormRegistrarMixin
`fieldName`	public	`string`		Will be used in validation messages to refer to the current field	FormControlMixin
`filled`	public	`boolean`	`false`	True when the modelValue is non-empty (see _isEmpty in FormControlMixin)	InteractionStateMixin
`focused`	public	`boolean`	`false`	Whether the focusable element within (`._focusableNode`) is focused. Reflects to attribute '[focused]' as a styling hook	FocusMixin
`focusedVisible`	public	`boolean`	`false`	Whether the focusable element within (`._focusableNode`) matches ':focus-visible' Reflects to attribute '[focused-visible]' as a styling hook See: https://developer.mozilla.org/en-US/docs/Web/CSS/:focus-visible	FocusMixin
`formattedValue`	public				ChoiceGroupMixin
`formElements`	public	`FormControlsCollection`	`new FormControlsCollection()`	Closely mimics the natively supported HTMLFormControlsCollection. It can be accessed both like an array and an object (based on control/element names).	FormRegistrarMixin
`hasFeedbackFor`	public	`ValidationType[]`	`[]`	As soon as validation happens (after modelValue/validators/validator param change), this array is updated with the active ValidationTypes ('error'\|'warning'\|'success'\|'info' etc.). Notice the difference with `.showsFeedbackFor`, which filters `.hasFeedbackFor` based on `.feedbackCondition()`. For styling purposes, will be reflected to [has-feedback-for="error warning"]. This can be useful for subtle visual feedback on keyup, like a red/green border around an input.	ValidateMixin
`hasNoDefaultSelected`	public	`boolean`	`false`	When setting this to true, on initial render, no option will be selected. It is advisable to override `_noSelectionTemplate` method in the select-invoker to render some kind of placeholder initially	ListboxMixin
`helpText`	public	`string`	`''`	The helpt text for the input node. When no value is defined, textContent of [slot=help-text] will be used	FormControlMixin
`initComplete`	public	`Promise<any>`	`new Promise((resolve, reject) => { this.__resolveInitComplete = resolve; this.__rejectInitComplete = reject; })`	initComplete resolves after all pending initialization logic (for instance `<form-group .serializedValue=$>`) is executed	FormRegistrarMixin
`isPending`	public	`boolean`	`false`	Flag indicating whether async validation is pending. Creates attribute [is-pending] as a styling hook	ValidateMixin
`label`	public	`string`	`''`	The label text for the input node. When no value is defined, textContent of [slot=label] will be used	FormControlMixin
`labelSrOnly`	public	`boolean`	`false`	The label will only be visible for srceen readers when true	FormControlMixin
`matchMode`	public	`'begin'\|'all'`	`'all'`	When typing in the textbox, will by default be set on 'begin', only matching the beginning part in suggestion list. => 'a' will match 'apple' from ['apple', 'pear', 'citrus']. When set to 'all', will match middle of the word as well => 'a' will match 'apple' and 'pear'
`modelValue`	public	`object`			FormControlMixin
`multipleChoice`	public	`boolean`	`false`	When false (default), modelValue and serializedValue will reflect the currently selected choice (usually a string). When true, modelValue will and serializedValue will be an array of strings.	ChoiceGroupMixin
`opened`	public	`boolean`	`false`	If you add the opened attribute a dialog will be opened on page load. The invoker can be left out in case the user does not need to be able to reopen the dialog.	OverlayMixin
`operationMode`	public	`OperationMode`		Types of input interaction of the FormControl (for instance 'enter'\|'select'\|'upload')	ValidateMixin
`orientation`	public	`string`	`'vertical'`	Informs screen reader and affects keyboard navigation. By default 'vertical'	ListboxMixin
`prefilled`	public	`boolean`	`false`	True when user has left non-empty field or input is prefilled. The name must be seen from the point of view of the input field: once the user enters the input field, the value is non-empty.	InteractionStateMixin
`readOnly`	public	`boolean`	`false`	A Boolean attribute which, if present, indicates that the user should not be able to edit the value of the input. The difference between disabled and readonly is that read-only controls can still function, whereas disabled controls generally do not function as controls until they are enabled. (From: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#attr-readonly)	FormControlMixin
`registrationComplete`	public	`Promise<any> & {done?:boolean}`	`new Promise((resolve, reject) => { this.__resolveRegistrationComplete = resolve; this.__rejectRegistrationComplete = reject; })`	registrationComplete waits for all children formElements to have registered	FormRegistrarMixin
`requireOptionMatch`	public	`boolean`	`true`	If set to false, the value is allowed to not match any of the options. We set the default to true for backwards compatibility
`rotateKeyboardNavigation`	public	`boolean`	`true`	Will give first option active state when navigated to the next option from last option.	ListboxMixin
`selectionFollowsFocus`	public	`boolean`	`true`	When true, will synchronize activedescendant and selected element on arrow key navigation. This behavior can usually be seen on <select> on the Windows platform. Note that this behavior cannot be used when multiple-choice is true. See: https://www.w3.org/TR/wai-aria-practices/#kbd_selection_follows_focus	ListboxMixin
`serializedValue`	public				ChoiceGroupMixin
`showAllOnEmpty`	public	`boolean`	`false`	When true, the listbox is open and textbox goes from a value to empty, all options are shown. By default, the listbox closes on empty, similar to wai-aria example and <datalist>
`showsFeedbackFor`	public	`ValidationType[]`	`[]`	Based on outcome of feedbackCondition, this array decides what ValidationTypes should be shown in validationFeedback, based on meta data like interaction states. For styling purposes, it reflects it `[shows-feedback-for="error warning"]`	ValidateMixin
`submitted`	public				InteractionStateMixin
`touched`	public	`boolean`	`false`	True when user has focused and left(blurred) the field.	InteractionStateMixin
`validationStates`	public	`ValidationStates`	`{}`	The outcome of a validation 'round'. Keyed by ValidationType and Validator name	ValidateMixin
`validators`	public	`Validator[]`	`[]`	Used by Application Developers to add Validators to a FormControl.	ValidateMixin
`value`	public			We define the value getter/setter below as also defined in LionField (via FormatMixin). Since FormatMixin is meant for Formgroups/ChoiceGroup it's not applied on Combobox; Combobox is somewhat of a hybrid between a ChoiceGroup and LionField, therefore we copy over some of the LionField members to align with its interface. The view value. Will be delegated to `._inputNode.value`
`_activeDescendantOwnerNode`	protected	`HTMLElement`			ListboxMixin
`_allValidators`	protected	`Validator[]`		Combination of validators provided by Application Developer and the default validators	ValidateMixin
`_ariaDescribedNodes`	public	`HTMLElement[]`	`[]`	Contains all elements that should end up in aria-describedby of `._inputNode`	FormControlMixin
`_ariaLabelledNodes`	public	`HTMLElement[]`	`[]`	Contains all elements that should end up in aria-labelledby of `._inputNode`	FormControlMixin
`_ariaVersion`	protected	`'1.1'\|'1.0'`		For optimal support, we allow aria v1.1 on newer browsers
`_comboboxNode`	protected	`HTMLElement`		Wrapper with combobox role for the text input that the end user controls the listbox with.
`_customChoices`	protected	`Set<unknown>`	`new Set()`		CustomChoiceGroupMixin
`_feedbackConditionMeta`	protected			Allows Subclassers to add meta info for feedbackCondition	LionListbox
`_feedbackNode`	protected			Element where validation feedback will be rendered to	FormControlMixin
`_focusableNode`	protected	`HTMLElement`		The focusable element: could be an input, textarea, select, button or any other element with tabindex > -1	LionListbox
`_helpTextNode`	protected			Element where help text will be rendered to	FormControlMixin
`_inputId`	protected	`string`		Unique id that can be used in all light dom	FormControlMixin
`_inputNode`	protected			The interactive (form) element. Can be a native element like input/textarea/select or an element with tabindex > -1	FormControlMixin
`_isFormOrFieldset`	protected	`boolean`	`false`	Flag that determines how ".formElements" should behave. For a regular fieldset (see LionFieldset) we expect ".formElements" to be accessible as an object. In case of a radio-group, a checkbox-group or a select/listbox, it should act like an array (see ChoiceGroupMixin). Usually, when false, we deal with a choice-group (radio-group, checkbox-group, (multi)select)	FormRegistrarMixin
`_isRepropagationEndpoint`	public	`boolean`	`false`	By default, a field with _repropagationRole 'choice-group' will act as an 'endpoint'. This means it will be considered as an individual field: for a select, individual options will not be part of the formPath. They will. Similarly, components that (a11y wise) need to be fieldsets, but 'interaction wise' (from Application Developer perspective) need to be more like fields (think of an amount-input with a currency select box next to it), can set this to true to hide private internals in the formPath.	FormControlMixin
`_labelNode`	protected			Element where label will be rendered to	FormControlMixin
`_leaveEvent`	protected	`string`	`'blur'`	The event that triggers the touched state	InteractionStateMixin
`_listboxActiveDescendant`	protected	`number \| null`	`null`		ListboxMixin
`_listboxActiveDescendantNode`	protected	`HTMLElement`			ListboxMixin
`_listboxNode`	protected				ListboxMixin
`_listboxReceivesNoFocus`	protected	`boolean`	`true`	When listbox is coupled to a textbox (in case we are dealing with a combobox), spaces should not select an element (they need to be put in the textbox)	ListboxMixin
`_listboxSlot`	protected	`HTMLElement`			ListboxMixin
`_noTypeAhead`	public	`boolean`	`true`	When false, a user can type on which the focus will jump to the matching option	ListboxMixin
`_oldModelValue`	protected	`string \| string[] \| undefined`	`undefined`		ListboxMixin
`_overlayBackdropNode`	protected				OverlayMixin
`_overlayContentNode`	protected				OverlayMixin
`_overlayContentWrapperNode`	protected				OverlayMixin
`_overlayInvokerNode`	protected				OverlayMixin
`_overlayReferenceNode`	protected				OverlayMixin
`_repropagationRole`	public	`'child'\|'choice-group'\|'fieldset'`	`'choice-group'`	Based on the role, details of handling model-value-changed repropagation differ.	FormControlMixin
`_requestedToBeDisabled`	protected	`boolean`	`false`		DisabledMixin
`_scrollTargetNode`	protected	`HTMLElement`			ListboxMixin
`_selectionDisplayNode`	protected	`SelectionDisplay \| null`
`_typeAheadTimeout`	protected	`number`	`1000`	The pending char sequence that will set active list item	ListboxMixin
`_valueChangedEvent`	protected	`string`	`'model-value-changed'`	The event that triggers the dirty state	InteractionStateMixin
`_visibleMessagesAmount`	protected	`number`	`1`	The amount of feedback messages that will visible in LionValidationFeedback	ValidateMixin

Methods

Name	Privacy	Description	Parameters	Return	Inherited From
`addFormElement`	public		`child: FormControl, indexToInsertAt: number`		FormRegistrarMixin
`addToAriaDescribedBy`	public	Allows to add element references to aria-describedby attribute.	`element: HTMLElement, { idPrefix = '', reorder = true }, customConfig: {idPrefix?:string; reorder?: boolean}`		FormControlMixin
`addToAriaLabelledBy`	public	Allows to add extra element references to aria-labelledby attribute.	`element: HTMLElement, { idPrefix = '', reorder = true }, customConfig: {idPrefix?:string; reorder?: boolean}`		FormControlMixin
`blur`	public	Calls `blur()` on focusable element within			FocusMixin
`clear`	public				ChoiceGroupMixin
`click`	public				DisabledMixin
`close`	public	Hides the overlay			OverlayMixin
`feedbackCondition`	public	Allows the Application Developer to specify when a feedback message should be shown	`type: string, meta: object, currentCondition: ((type: string, meta: object) => boolean)`	`boolean`	ValidateMixin
`focus`	public	Calls `focus()` on focusable element within			FocusMixin
`initInteractionState`	public	Evaluations performed on connectedCallback. This method is public, so it can be called at a later moment (when we need to wait for registering children for instance) as well. Since this method will be called twice in last mentioned scenario, it must stay idempotent.			InteractionStateMixin
`isRegisteredFormElement`	public		`el: ElementWithParentFormGroup`		FormRegistrarMixin
`makeRequestToBeDisabled`	public				DisabledMixin
`matchCondition`	public	When the preconfigurable `match-mode` conditions are not sufficient, one can define a custom matching function.	`option: LionOption, textboxValue: string`
`open`	public	Shows the overlay			OverlayMixin
`parser`	public	Converts viewValue to modelValue	`value: string\|string[]`	`*`	CustomChoiceGroupMixin
`removeFormElement`	public		`child: FormControlHost`		FormRegistrarMixin
`removeFromAriaDescribedBy`	public	Allows to remove element references from aria-describedby attribute.	`element: HTMLElement`		FormControlMixin
`removeFromAriaLabelledBy`	public	Allows to remove element references from aria-labelledby attribute.	`element: HTMLElement`		FormControlMixin
`repositionOverlay`	public	Sometimes it's needed to recompute Popper position of an overlay, for instance when we have an opened combobox and the surrounding context changes (the space consumed by the textbox increases vertically)			OverlayMixin
`reset`	public				ListboxMixin
`resetInteractionState`	public	Resets touched and dirty, and recomputes prefilled			InteractionStateMixin
`retractRequestToBeDisabled`	public				DisabledMixin
`setCheckedIndex`	public	If an array is passed for multiple-choice, it will check the indexes in array, and uncheck the rest If a number is passed, the item with the passed index is checked without unchecking others For single choice, __onChildCheckedChanged we ensure that we uncheck siblings	`index: number\|number[]`		ListboxMixin
`toggle`	public	Toggles the overlay			OverlayMixin
`validate`	public	Triggered by: - modelValue change - change in the 'validators' array - change in the config of an individual Validator Three situations are handled: - a1) the FormControl is empty: further execution is halted. When the Required Validator (being mutually exclusive to the other Validators) is applied, it will end up in the validation result (as the only Validator, since further execution was halted). - a2) there are synchronous Validators: this is the most common flow. When modelValue hasn't changed since last async results were generated, 'sync results' are merged with the 'async results'. - a3) there are asynchronous Validators: for instance when server side evaluation is needed. Executions are scheduled and awaited and the 'async results' are merged with the 'sync results'. - b) there are MetaValidators. After steps a1, a2, or a3 are finished, the holistic MetaValidators (evaluating the total result of the 'regular' (a1, a2 and a3) validators) will be run... Situations a2 and a3 are not mutually exclusive and can be triggered within one `validate()` call. Situation b will occur after every call.	`{ clearCurrentResult = false }, opts: { clearCurrentResult?: boolean }`		ValidateMixin
`_autoSelectCondition`	protected	When this condition is false, an end user will have to manually select a suggested option from the list (by default when autocomplete is 'none' or 'list'). For autocomplete 'both' or 'inline', it will automatically select on a match.
`_checkSingleChoiceElements`	protected		`ev: CustomEvent & {target:FormControl}`		ChoiceGroupMixin
`_completeRegistration`	protected	Resolves the registrationComplete promise. Subclassers can delay if needed			FormRegistrarMixin
`_defineOverlay`	protected		`{ contentNode, invokerNode, referenceNode, backdropNode, contentWrapperNode }, config: DefineOverlayConfig`	`OverlayController`	OverlayMixin
`_defineOverlayConfig`	protected			`OverlayConfig`	OverlayMixin
`_dispatchInitialModelValueChangedEvent`	protected				FormControlMixin
`_enhanceLightDomA11y`	protected				FormControlMixin
`_enhanceLightDomA11yForAdditionalSlots`	protected	Enhances additional slots(prefix, suffix, before, after) defined by developer. When boolean attribute data-label or data-description is found, the slot element will be connected to the input via aria-labelledby or aria-describedby	`additionalSlots: string[]`		FormControlMixin
`_enhanceLightDomClasses`	protected				FormControlMixin
`_feedbackTemplate`	protected			`TemplateResult`	FormControlMixin
`_getAriaDescriptionElements`	protected	This function exposes descripion elements that a FormGroup should expose to its children. See FormGroupMixin.__getAllDescriptionElementsInParentChain()		`Array.<HTMLElement>`	FormControlMixin
`_getCheckedElements`	protected				ChoiceGroupMixin
`_getFromAllFormElements`	protected	Implicit :(	`property: string, filterFn: (el: FormControl, property?: string) => boolean`	`{[name:string]: any}`	ChoiceGroupMixin
`_getFromAllFormElementsFilter`	protected	A filter function which will exclude a form field when returning false By default, exclude form fields which are disabled The type is be passed as well for more fine grained control, e.g. distinguish the filter when fetching modelValue versus serializedValue	`el: FormControl, type: string`	`boolean`	ChoiceGroupMixin
`_getNextEnabledOption`	protected		`currentIndex: number, offset: number`		ListboxMixin
`_getPreviousEnabledOption`	protected		`currentIndex: number, offset: number`		ListboxMixin
`_getTextboxValueFromOption`	protected	Return the value to be used for the input value	`option: LionOption`	`string`
`_groupOneTemplate`	protected			`TemplateResult`	FormControlMixin
`_groupTwoTemplate`	protected			`TemplateResult`	FormControlMixin
`_handleAutocompletion`	protected	Handles autocompletion. This entails: - list: shows a list on keydown character press - filter: filters list of potential matches according to matchmode or provided matchCondition - focus: automatically focuses closest match (makes it the activedescendant) - check: automatically checks/selects closest match when selection-follows-focus is enabled (this is the default configuration) - complete: completes the textbox value inline (the 'missing characters' will be added as selected text)
`_handleTypeAhead`	protected		`ev: KeyboardEvent, { setAsChecked }, options: {setAsChecked:boolean}`		ListboxMixin
`_hasFeedbackVisibleFor`	protected	Used to translate `.hasFeedbackFor` and `.shouldShowFeedbackFor` to `.showsFeedbackFor`	`type: string`		ValidateMixin
`_helpTextTemplate`	protected			`TemplateResult`	FormControlMixin
`_highlightMatchedOption`	protected		`option: Element, matchingString: string`
`_inputGroupAfterTemplate`	protected			`TemplateResult`	FormControlMixin
`_inputGroupBeforeTemplate`	protected			`TemplateResult`	FormControlMixin
`_inputGroupInputTemplate`	protected			`TemplateResult`	FormControlMixin
`_inputGroupPrefixTemplate`	protected			`TemplateResult \| nothing`	FormControlMixin
`_inputGroupSuffixTemplate`	protected			`TemplateResult \| nothing`	FormControlMixin
`_inputGroupTemplate`	protected			`TemplateResult`	FormControlMixin
`_isEmpty`	protected	Used for Required validation and computation of interaction states	`modelValue: any`	`boolean`	FormControlMixin
`_isPermanentlyDisconnected`	protected	When we're moving around in dom, disconnectedCallback gets called. Before we decide to teardown, let's wait to see if we were not just moving nodes around.		`Promise<boolean>`	OverlayMixin
`_iStateOnLeave`	protected	Sets touched value to true and reevaluates prefilled state. When false, on next interaction, user will start with a clean state.			InteractionStateMixin
`_iStateOnValueChange`	protected	Sets dirty value and validates when already touched or invalid			InteractionStateMixin
`_labelTemplate`	protected			`TemplateResult`	FormControlMixin
`_listboxOnClick`	protected		`ev: MouseEvent`		ListboxMixin
`_listboxOnKeyDown`	protected		`ev: KeyboardEvent`		ListboxMixin
`_listboxOnKeyUp`	protected		`ev: KeyboardEvent`		ListboxMixin
`_onBeforeRepropagateChildrenValues`	protected	Hook for Subclassers to add logic before repropagation	`ev: CustomEvent`		FormControlMixin
`_onChildActiveChanged`	protected		`{ target }, ev: Event & { target: LionOption }`		ListboxMixin
`_onDirtyChanged`	protected	Dispatches event on touched state change			InteractionStateMixin
`_onFilterMatch`	protected		`option: LionOption & {__originalInnerHTML?:string}, matchingString: string`
`_onFilterUnmatch`	protected		`option: LionOption & {__originalInnerHTML?:string}, curValue: string, prevValue: string`
`_onKeyUp`	protected		`ev: KeyboardEvent`
`_onLabelClick`	protected				FormControlMixin
`_onListboxContentChanged`	protected	A Subclasser can perform additional logic whenever the elements inside the listbox are updated. For instance, when a combobox does server side autocomplete, we want to match highlighted parts client side.			ListboxMixin
`_onRequestToAddFormElement`	protected	Hook for Subclassers to perform logic before an element is added	`ev: CustomEvent`		FormRegistrarMixin
`_onRequestToChangeFormElementName`	protected		`ev: CustomEvent`		FormRegistrarMixin
`_onRequestToRemoveFormElement`	protected		`ev: CustomEvent`		FormRegistrarMixin
`_onTouchedChanged`	protected	Dispatches event on touched state change			InteractionStateMixin
`_onValidatorUpdated`	protected		`e: Event\|CustomEvent`		ValidateMixin
`_overlayListboxTemplate`	protected
`_prioritizeAndFilterFeedback`	protected	Orders all active validators in this.__validationResult. Can also filter out occurrences (based on interaction states)	`{ validationResult }, opts: { validationResult: Validator[] }`	`Validator[]`	ValidateMixin
`_repropagationCondition`	protected	Based on provided target, this condition determines whether received model-value-changed event should be repropagated	`target: FormControlHost`		FormControlMixin
`_resetListboxOptions`	protected
`_scrollIntoView`	protected		`el: HTMLElement, scrollTargetEl: HTMLElement`		ListboxMixin
`_setCheckedElements`	protected		`value: string \| any[], check: Function`		ChoiceGroupMixin
`_setOpenedWithoutPropertyEffects`	protected	When the opened state is changed by an Application Developer,cthe OverlayController is requested to show/hide. It might happen that this request is not honoured (intercepted in before-hide for instance), so that we need to sync the controller state to this webcomponent again, preventing eternal loops.	`newOpened: boolean`		OverlayMixin
`_setTextboxValue`	protected		`v: string`
`_setupListboxNode`	protected				ListboxMixin
`_setupOpenCloseListeners`	protected				OverlayMixin
`_setupOverlayCtrl`	protected				OverlayMixin
`_showFeedbackConditionFor`	protected	Default feedbackCondition condition, used by Subclassers, that will be used when `feedbackCondition()` is not overridden by Application Developer. Show the validity feedback when returning true, don't show when false	`type: string, meta: InteractionStates`		ValidateMixin
`_showOverlayCondition`	protected		`{ lastKey }, options: { currentValue?: string, lastKey?: string }`	`boolean`
`_syncToTextboxCondition`	protected		`modelValue: string\|string[], oldModelValue: string\|string[], { phase }, config: {phase?:string}`
`_syncToTextboxMultiple`	protected		`modelValue: string[], oldModelValue: string[]`
`_teardownListboxNode`	protected				ListboxMixin
`_teardownOpenCloseListeners`	protected				OverlayMixin
`_teardownOverlayCtrl`	protected				OverlayMixin
`_textboxOnClick`	protected		`ev: FocusEvent`
`_textboxOnInput`	protected		`ev: Event`
`_textboxOnKeydown`	protected		`ev: KeyboardEvent`
`_throwWhenInvalidChildModelValue`	protected		`child: FormControl`		ChoiceGroupMixin
`_triggerInitialModelValueChangedEvent`	protected				FormControlMixin
`_uncheckChildren`	protected		`exclude: LionOption\|LionOption[]`		ListboxMixin
`_unhighlightMatchedOption`	protected		`option: Element`
`_updateFeedbackComponent`	protected	Responsible for retrieving messages from Validators and (delegation of) rendering them. For `._feedbackNode` (extension of LionValidationFeedback): - retrieve messages from highest prio Validators - provide the result to custom feedback node and let the custom node decide on their renderings In both cases: - we compute the 'show' flag (like 'hasErrorVisible') for all types - we set the customValidity message of the highest prio Validator - we set aria-invalid="true" in case hasErrorVisible is true			ValidateMixin
`_updateShouldShowFeedbackFor`	protected				ValidateMixin

Events

Name	Type	Description	Inherited From
`opened-changed`	`CustomEvent`		OverlayMixin
`model-value-changed`	`CustomEvent`		FormControlMixin
`form-element-name-changed`	`CustomEvent`		FormControlMixin
`focus`	`Event`		FocusMixin
`blur`	`Event`		FocusMixin
`focusin`	`Event`		FocusMixin
`focusout`	`Event`		FocusMixin
`touched-changed`	`Event`		InteractionStateMixin
`dirty-changed`	`Event`		InteractionStateMixin
`showsFeedbackForChanged`	`Event`		ValidateMixin
	`Event`		ValidateMixin
`shouldShowFeedbackForChanged`	`Event`		ValidateMixin
`validate-performed`	`Event`	private event that should be listened to by LionFieldSet	ValidateMixin

Attributes

Name	Field	Inherited From
`autocomplete`	autocomplete
`match-mode`	matchMode
`show-all-on-empty`	showAllOnEmpty
`requireOptionMatch`	requireOptionMatch
`allow-custom-choice`	allowCustomChoice	CustomChoiceGroupMixin
`__shouldAutocompleteNextUpdate`	__shouldAutocompleteNextUpdate
`opened`	opened	OverlayMixin
`modelValue`	modelValue	CustomChoiceGroupMixin
`multiple-choice`	multipleChoice	ChoiceGroupMixin
`orientation`	orientation	ListboxMixin
`selection-follows-focus`	selectionFollowsFocus	ListboxMixin
`rotate-keyboard-navigation`	rotateKeyboardNavigation	ListboxMixin
`has-no-default-selected`	hasNoDefaultSelected	ListboxMixin
`_noTypeAhead`	_noTypeAhead	ListboxMixin
`readonly`	readOnly	FormControlMixin
`label`	label	FormControlMixin
`label-sr-only`	labelSrOnly	FormControlMixin
`help-text`	helpText	FormControlMixin
`_isFormOrFieldset`	_isFormOrFieldset	FormRegistrarMixin
`focused`	focused	FocusMixin
`focused-visible`	focusedVisible	FocusMixin
`autofocus`	autofocus	FocusMixin
`touched`	touched	InteractionStateMixin
`dirty`	dirty	InteractionStateMixin
`filled`	filled	InteractionStateMixin
`shows-feedback-for`	showsFeedbackFor	ValidateMixin
`is-pending`	isPending	ValidateMixin
`disabled`	disabled	DisabledMixin

Caught a mistake or want to contribute to the documentation? Edit this page on GitHub!

Combobox: API Table

class: LionCombobox, lion-combobox

Fields

Methods

Events

Attributes

class: `LionCombobox`, `lion-combobox`