element-plus-formkitelement-plus-formkit
v1.1.0
  • 中文
  • English
GitHub
v1.1.0
  • 中文
  • English
GitHub
  • Quick Start
  • Formkit API
  • Config API
  • Modules
  • Expose
  • Slot
  • Basic Demo
  • Extension Methods

Formkit Component Props

model-value / v-model

Component binds to data source, type: Object

config

Component configuration item, please refer to Config Api for specific parameters. Type: Array

disabled

Disable the entire form. Type: Boolean

name
<formkit
    :config="[
        {
            type: 'input',
            label: 'name',
            key: 'password',
            props: { placeholder: 'Please input name', clearable: true }
        }
    ]"
    :disabled="true"
    v-model="dataset">
</formkit>

labelPosition

Position of the form item label, when set to left or right, you also need to set the label-width attribute.

Options: 'left' | 'right' | 'top'

Name

Name
<formkit
    :config="[
        {
            type: 'input',
            label: 'Name',
            key: 'password',
            props: { placeholder: 'Please input name', clearable: true }
        }
    ]"
    labelPosition="left"
    v-model="dataset">
</formkit>
<br />
<formkit
    :config="[
        {
            type: 'input',
            label: 'Name',
            key: 'password',
            props: { placeholder: 'Please input name', clearable: true }
        }
    ]"
    labelPosition="right"
    v-model="dataset">
</formkit>

labelWidth

Label length, type: Number

For example, 50. Form-item elements that are direct children of the Form element inherit this value.

columns

Number of form items allowed per row.

type: [Number, String]

Name1
Name2
Name3

columns: 3

Name1
Name2
Name3
<formkit
    :config="[
        {
            type: 'input',
            label: 'Name1',
            key: 'password',
            props: { placeholder: 'Please input name1', clearable: true }
        },
        {
            type: 'input',
            label: 'Name2',
            key: 'password',
            props: { placeholder: 'Please input name2', clearable: true }
        },
        {
            type: 'input',
            label: 'Name3',
            key: 'password',
            props: { placeholder: 'Please input name3', clearable: true }
        }
    ]"
    :columns="2"
    v-model="dataset">
</formkit>
<p>columns: 3</p>
<formkit
    :config="[
        {
            type: 'input',
            label: 'Name1',
            key: 'password',
            props: { placeholder: 'Please input name1', clearable: true }
        },
        {
            type: 'input',
            label: 'Name2',
            key: 'password',
            props: { placeholder: 'Please input name2', clearable: true }
        },
        {
            type: 'input',
            label: 'Name3',
            key: 'password',
            props: { placeholder: 'Please input name3', clearable: true }
        }
    ]"
    :columns="3"
    v-model="dataset">
</formkit>

size

Size of the form item.

Options: '' | 'large' | 'default' | 'small'

Name1
<formkit
    :config="[
        {
            type: 'input',
            label: 'Name1',
            key: 'password',
            props: { placeholder: 'Please input name1', clearable: true }
        }
    ]"
    size="large"
    v-model="dataset">
</formkit>

gap

Form item gap settings, type: Object

gap.row

Horizontal spacing between form items. Type: Number

Default: 12

gap.col

Vertical spacing between form items. Type: Number

Default: 20

Name1
Name2
Name3
<formkit
    :config="[
        {
            type: 'input',
            label: 'Name1',
            key: 'password',
            props: { placeholder: 'Please input name1', clearable: true }
        },
        {
            type: 'input',
            label: 'Name2',
            key: 'password',
            props: { placeholder: 'Please input name2', clearable: true }
        },
        {
            type: 'input',
            label: 'Name3',
            key: 'password',
            props: { placeholder: 'Please input name3', clearable: true }
        }
    ]"
    :columns="2"
    :gap="{
        row: 100,
        col: 50
    }"
    v-model="dataset">
</formkit>
Edit this page
Last Updated:: 4/25/26, 10:42 AM
Contributors: NicolasHome, NicolasDevil
Prev
Quick Start
Next
Config API