The v-combobox
component is a v-autocomplete that allows the user to enter values that do not exist within the provided items. Created items will be returned as strings.
With Combobox, you can allow a user to create new values that may not be present in a provided items list.
As the Combobox allows user input, it always returns the full value provided to it (for example a list of Objects will always return an Object when selected). This is because there's no way to tell if a value is supposed to be user input or an object lookup GitHub Issue
The auto property of menu-props is only supported for the default input style.
Browser autocomplete is set to off by default, may vary by browser and may be ignored. MDN
Wählen Sie unten Ihren gewünschte Komponente aus und sehen Sie die verfügbaren Attribute, Slots, Ereignisse und Funktionen.
Allow the menu to overflow off the screen
Appends an icon to the component, uses the same syntax as v-icon
Appends an icon to the outside the component's input, uses same syntax as v-icon
Gibt an, zu welchem DOM-Element diese Komponente sich trennen soll. String - Kann jeder gültige QuerySelector sein. Objekt - Lann jeder gültige Knoten sein. Dies wird standardmäßig an den Root-v-app
Component anhängt.
When searching, will always highlight the first option
Enables autofocus
Changes the background-color of the input
Keeps a local unique copy of all items that have been passed through the items prop.
Changes display of selections to chips
Applied when using clearable and the input is dirty
Fügt die Funktionalität zum Löschen der Eingabe hinzu, das Standard-Icon ist das Material Icon clear
Wendet eine bestimmte Farbe für die Steuerung an - es kann der Name der Materialfarbe sein (zum Beispiel success
oder purple
) oder css-Farben (#033
oder rgba(255, 0, 0, 0.5)
). Sie finden eine Liste der eingebauten Klassen auf der Farbseite.
Creates counter for input length; if no number is specified, it defaults to 25. Does not apply any validation.
Applies the dark theme variant to the component. This will default the components color to white unless you've configured your application theme to dark or if you are using the color prop on the component. You can find more information on the Material Design documentation for dark themes.
Adds a remove icon to selected chips
Accepts an array of strings that will trigger a new tag when typing. Does not replace the normal Tab and Enter keys.
Reduces the input height
Disables keyboard lookup
Input deaktivieren
Erzwingt den Inhalt der Komponenten unter mount gezeichnet zu werden. Dies ist nützlich, wenn Sie Inhalte haben, die nicht im DOM dargestellt werden, aber für SEO crawlebar sein soll.
Stellt die Eingabe manuel in einen Fehlerzustand
Die Gesamtzahl der Fehler, die auf einmal angezeigt werden sollen
Stellt die Eingabe in einen Fehlerzustand und durchläuft benutzerdefinierte Fehlermeldungen. Wird mit allen Validierungen kombiniert, die vom rules-Prop auftreten. Dieses Feld wird keine Validierung auslösen
Applies the alternate filled input style
The function used for filtering items
Entfernt die Höhe (Schatten), welcher zum Element hinzugefügt wurde, wenn die solo oder solo-invertierten-Props verwendet werden
Designates input type as full-width
Sets the height of the input
Hides hint and validation errors. When set to auto
messages will be rendered only if there's a message (hint, error message, counter value etc) to display
Hides the menu when there are no options to show. Useful for preventing the menu from opening before results are fetched asynchronously. Also has the effect of opening the menu when the items
array changes if not already open.
Do not display in the select menu items that are already selected
Hint text
Setzt den DOM identifier auf der Komponente
Sets color of selected items
Set property of items's disabled value
Set property of items's text value
Set property of items's value - must be primitive. Dot notation is supported. Note: This is currently not supported with v-combobox
GitHub Issue
Can be an array of objects or array of strings. When using objects, will look for a text, value and disabled keys. This can be changed using the item-text, item-value and item-disabled props. Objects that have a header or divider property are considered special cases and generate a list header or divider; these items are not selectable.
{
text: string | number | object
value: string | number | object
disabled: boolean
divider: boolean
header: string
}
Sets input label
Wendet die helle Theme-Variante für die Komponente an.
Legt die Höhe des Laders fest
Zeigt den linearen Fortschrittsbalken an. Kann entweder eine Zeichenfolge sein, die angibt, welche Farbe auf den Fortschrittsbalken angewendet wird (jede Materialfarbe oder Themenfarbe - primary, secondary, success, info, warning, error) oder ein Boolescher Wert, der die Komponenten-color (festgelegt durch das color-prop - sofern dies von der Komponente unterstützt wird) oder die Primärfarbe verwendet
Pass props through to the v-menu
component. Accepts either a string for boolean props menu-props="auto, overflowY"
, or an object :menu-props="{ auto: true, overflowY: true }"
Zeigt eine Liste von Nachrichten oder eine einzelne Nachricht an, wenn eine Zeichenkette (string) verwendet wird
Changes select to multiple. Accepts array for value
Text wird angezeigt, wenn keine Daten vorhanden sind
Do not apply filtering when searching. Useful when data is being filtered server side
When using the clearable prop, once cleared, the select menu will either open or stay open, depending on the current state
Applies the outlined style to the input
Forces hint to always be visible
Sets the input’s placeholder text
Displays prefix text
Prepends an icon to the component, uses the same syntax as v-icon
Prepends an icon inside the component's input, uses the same syntax as v-icon
Setzt die Eingabe in einen schreibgeschützten Zustand
Changes the selection behavior to return the object directly rather than the value specified with item-value
Reverses the input orientation
Adds a border radius to the input
Akzeptiert ein Array von Funktionen, die einen Eingabewert als Argument annehmen und entweder true
/ false
oder einen string
mit einer Fehlermeldung zurückgeben
Search value. Can be used with .sync
modifier.
Round if outlined
and increase border-radius
if filled
. Must be used with either outlined
or filled
Das Label bewegt sich nicht für focus/dirty
Changes display of selections to chips with the small property
Ändert den Stil der Eingabe
Reduziert die Deckkraft des Elements wenn nicht fokussiert
Setzt die Eingabe manuel in einen Erfolgszustand
Stellt die Eingabe in einen Erfolgszustand ein und überträgt benutzerdefinierte Erfolgsmitteilungen.
Displays suffix text
Sets input type
Verzögert die Validierung bis zum 'blur'-Ereignis
The input's value
The comparison algorithm used for values. More info
Adds an item inside the input and after input content
Adds an item after menu content
Adds an item outside the input and after input content
Der Standard-Vue Slot.
Define a custom item appearance
{
parent: VueComponent
item: object
on: object // Only needed when providing your own v-list-item
attrs: object // Only needed when providing your own v-list-item
}
Ersetzt die Standardbezeichnung
Customize the messages slot.
{
key: number, // the messages index
message: string, // the message
}
Wird angezeigt, wenn keine gefilterten Elemente vorhanden sind
Adds an item outside the input and before input content
Adds an item inside the input and before input content
Adds an item before menu content
Slot für den benutzerdefinierten linearen Fortschritt (angezeigt wenn das loading-Props ungleich zu Boolean False ist)
Define a custom selection appearance
{
parent: VueComponent
item: object
index: number
select: function
selected: boolean
disabled: boolean
}
Emitted when the input is blurred
Event
Emitted when the input is changed by user interaction
any
Emitted when input is clicked
MouseEvent
Emitted when appended icon is clicked
Event
Emitted when appended outer icon is clicked
Event
Emitted when clearable icon clicked
Event
Emitted when prepended icon is clicked
Event
Emitted when prepended inner icon is clicked
Event
Emitted when component is focused
Event
Das aktualisierte gebundene Modell
any
Emitted when any key is pressed
KeyboardEvent
Emitted when click is pressed
MouseEvent
Emitted when click is released
MouseEvent
Das error.sync
Ereignis
boolean
Emitted when menu item is selected using keyboard arrows
number
The search-input.sync
event
string
Unten finden Sie eine Sammlung einfacher bis komplexer Beispiele.
Previously known as tags - user is allowed to enter more than 1 value
You can use dense
prop to reduce combobox height and lower max height of list items.
In this example we utilize a custom no-data slot to provide context to the user when searching / creating items.
The v-combobox
improves upon the added functionality from v-select
and v-autocomplete
. This provides you with an expansive interface to create truly customized implementations. This example takes advantage of some more advanced features such as a custom filter algorithm, inline list editing and dynamic input items.
Bereit für mehr? Weiter lesen mit: