Files
directus/app/src/components/v-input

Input

<v-input v-model="value" />

Attributes & Events

The HTML <input> element supports a huge amount of attributes and events. In order to support all of these, all props that aren't specially handled (see list below) will be passed on to the <input> element directly. This allows you to change anything you want on the input.

Prefixes / Suffixes

You can add any custom (text) prefix/suffix to the value in the input using the prefix and suffix slots.

Props

Prop Description Default
autofocus Autofocusses the input on render false
disabled Set the disabled state for the input false
full-width Render the input with 100% width false
prefix Prefix the users value with a value --
suffix Show a value at the end of the input --
slug Force the value to be URL safe false
slug-separator What character to use as separator in slugs -
active Force the focus state false
trim Trim the start and end whitespace false

Note: all other attached attributes are bound to the input HTMLELement in the component. This allows you to attach any of the standard HTML attributes like min, length, or pattern.

Slots

Slot Description Data
prepend-outer Before the input `{ disabled: boolean, value: string
prepend In the input, before the value, before the prefix `{ disabled: boolean, value: string
append In the input, after the value, after the suffix `{ disabled: boolean, value: string
append-outer After the input `{ disabled: boolean, value: string

Events

Events Description Value
input Updates v-model any
click:append User clicks on content of inner append slot --
click:prepend User clicks on content of inner prepend slot --
click:append-outer User clicks on content of outer append slot --
click:prepend-outer User clicks on content of outer prepend slot --

Note: all other listeners are bound to the input HTMLElement, allowing you to handle everything from keydown to emptied.

CSS Variables

Variable Default
--v-input-font-family var(--family-sans-serif)
--v-input-placeholder-color var(--foreground-subdued)