element-plus-formkitelement-plus-formkit
  • 中文
  • English
GitHub
  • 中文
  • English
GitHub
  • 快速开始
  • 组件API
  • Config API
  • 模块
  • Expose
  • 插槽
  • 基础组件演示
  • 拓展方法

插槽

您可以插槽来扩展您的formkit

prepend

在您的formkit配置项前插入

这是prepend插槽的内容
姓名
<formkit
    :config="[
        {
            type: 'input',
            label: '姓名',
            key: 'password',
            props: { placeholder: '请输入姓名', clearable: true }
        }
    ]"
    v-model="dataset">
    <template #prepend>
        <el-col :span="24">
            <b>这是prepend插槽的内容</b>
        </el-col>
    </template>
</formkit>

append

在您的formkit配置项后进行追加

姓名
这是append插槽的内容
<formkit
    :config="[
        {
            type: 'input',
            label: '姓名',
            key: 'password',
            props: { placeholder: '请输入姓名', clearable: true }
        }
    ]"
    v-model="dataset">
    <template #append>
        <el-col :span="24">
            <b>这是append插槽的内容</b>
        </el-col>
    </template>
</formkit>

content

使用此插槽会会在您的整个form表单后进行追加,区别于append, content的样式干扰会大幅减少,必要时使用

姓名
这是content插槽的内容

content插槽传递的参数: { "config": [ { "type": "input", "label": "姓名", "key": "name", "props": { "placeholder": "请输入姓名", "clearable": true } } ] }

<formkit
    :config="[
        {
            type: 'input',
            label: '姓名',
            key: 'name',
            props: { placeholder: '请输入姓名', clearable: true }
        }
    ]"
    v-model="dataset">
    <template #content="scope">
        <b>这是content插槽的内容</b>
        <p>content插槽传递的参数: <code>{{ scope }}</code></p>
    </template>
</formkit>

[key]

变量作用域插槽[key], [key]为您的config item内的key,使用此插槽您可替换当前项的模块

注意

若您使用此插槽是希望替换当前项的模块,请移除当前项type,当然若您不这么做则当前项模块与您的slot共存

昵称
这是nickname插槽的内容

nickname插槽传递的参数: { "row": { "type": "input", "label": "昵称", "key": "nickname", "props": { "placeholder": "请输入昵称", "clearable": true } }, "size": "default" }

当然你也可以不指定type模块而只展示您的插槽内容

昵称
这是nickname插槽的内容

nickname插槽传递的参数: { "row": { "label": "昵称", "key": "nickname", "props": { "placeholder": "请输入昵称", "clearable": true } }, "size": "default" }

<formkit
    :config="[
        {
            type: 'input',
            label: '昵称',
            key: 'nickname',
            props: { placeholder: '请输入昵称', clearable: true }
        }
    ]"
    v-model="dataset">
    <template #nickname="scope">
        <b>这是nickname插槽的内容</b>
        <p>nickname插槽传递的参数: <code>{{ scope }}</code></p>
    </template>
</formkit>

<formkit
    :config="[
        {
            label: '昵称',
            key: 'nickname',
            props: { placeholder: '请输入昵称', clearable: true }
        }
    ]"
    v-model="dataset">
    <template #nickname="scope">
        <b>这是nickname插槽的内容</b>
        <p>nickname插槽传递的参数: <code>{{ scope }}</code></p>
    </template>
</formkit>

原生模块插槽

如需使用EL原生模块ELSelect slots插槽您需要使用特定格式定义您的具名插槽名称使用:

[当前配置项的key]-[原生插槽名称]

性别
prefix内容
请输入昵称
<formkit
    :config="[
        {
            label: '性别',
            type: 'select',
            key: 'sex',
            props: { placeholder: '请输入昵称', clearable: true }
        }
    ]"
    v-model="dataset">
    <template #sex-prefix>
        prefix内容
    </template>
    <template #sex-empty>
        empty内容
    </template>
</formkit>
Edit this page
最近更新:: 2026/1/14 06:42
Contributors: NicolasHome
Prev
Expose
Next
基础组件演示