VCombobox

Props

Name	Type	Description
appearance	Enum: fieldset ghost	The appearance attribute.
aria-current	Enum: page step location date time true false	Indicates the element that represents the current item within a container or set of related elements.
autocomplete	Enum: inline list both none	The autocomplete attribute.
disabled	boolean	The disabled state of the listbox.
error-text	string	The error text for the form element.
fixed-dropdown	boolean	Whether the dropdown is using a fixed positioning strategy.
helper-text	string	The helper text for the form element.
icon	Enum: 10-sec-backward-line 10-sec-backward-solid 10-sec-forward-line 10-sec-forward-solid 30-sec-backward-line 30-sec-backward-solid 30-sec-forward-line 30-sec-forward-solid 5-sec-backward-line 5-sec-backward-solid 5-sec-forward-line 5-sec-forward-solid ... 1227 more ...	A decorative icon the custom element should have. See the Vivid Icon Gallery for available icons: https://icons.vivid.vonage.com/
initial-value	string	The initial value of the form. This value sets the value property only when the value property has not been explicitly set.
label	string	The label for the form element.
name	string	The name of the element. This element's value will be surfaced during form submission under the provided name.
open	boolean	The open attribute.
placeholder	string	Sets the placeholder value of the element, generally used to provide a hint to the user.
placement	Enum: top bottom	the placement of the combobox HTML Attribute: string
required	boolean	Require the field to be completed prior to form submission.
scale	Enum: condensed normal	The size the combobox should have.
shape	Enum: rounded pill	The shape attribute.
success-text	string	The success text for the form element.
value	string	The current value of the element. This property serves as a mechanism to set the value property through both property assignment and the .setAttribute() method. This is useful for setting the field's value in UI libraries that bind data through the .setAttribute() API and don't support IDL attribute binding.

Events

Name	Event Type	Description
blur	FocusEvent	Fires when the element loses focus.
change	CustomEvent<undefined>	Fires a custom 'change' event when the value updates
click	MouseEvent	Fires when a pointing device button (such as a mouse's primary mouse button) is both pressed and released while the pointer is located inside the element.
focus	FocusEvent	Fires when the element receives focus.
input	Event	Fires when the value of an element has been changed.
keydown	KeyboardEvent	Fires when a key is pressed.
keyup	KeyboardEvent	Fires when a key is released.

Slots

Name	Description
default	Default slot.
helper-text	Describes how to use the combobox. Alternative to the helper-text attribute.
icon	Slot to add an icon to the combobox control.
meta	Slot to add meta content to the combobox control.

Methods

Name	Type	Description
filterOptions	() => void	Filter available options by text value.
selectFirstOption	() => void	Moves focus to the first selectable option.
setSelectedOptions	() => unknown	Sets an option as selected and gives it focus.
validate	() => void	{@inheritDoc (FormAssociated:interface).validate}