Skip to content

Kirby 3.5.7.1

Tags Field

<k-tags-field>

<k-tags-field
    v-model="tags"
    :options="[
        { value: 'a', text: 'Design' },
        { value: 'b', text: 'Architecture' }
    ]"
    name="tags"
  label="Tags"
/>

Props

autofocus

Boolean (default: false)

If true, the field will be instantly focused when the form is created

disabled

Boolean (default: false)

If true, the field is disabled and cannot be filled in or edited

help

String (default: null)

Sets the help text below the field

icon

String (default: null)

Sets the icon, that is shown on the right next to the input.

label

String (default: null)

Sets the label text for the field.

layout

String (default: null)

You can set the layout to list to extend the width of each tag to 100% and show them in a list. This is handy in narrow columns or when a list is a more appropriate design choice for the input in general.

max

Number (default: null)

The maximum number of accepted tags

min

Number (default: null)

The minimum number of required tags

name

String (default: null)

The name of the field must be defined to get fields in fieldsets up and running.

options

Array (default: null)

Defines all options that are available. Options must be defined as an array of objects:

[
  { value: 'a', text: 'Option A' },
  { value: 'b', text: 'Option B' },
  { value: 'c', text: 'Option C' }
]

Options will be shown in the autocomplete dropdown as soon as you start typing.

required

Boolean (default: false)

If true, the field must not be empty

value / v-model

Array (default: null)

Methods

focus()

Set the focus on the field.

Events

@input

The input event is triggered when the value changes.

CSS class

.k-tags-field