vue自定义表单生成器form-create使用详解

介绍

form-create 是一个可以通过 JSON 生成具有动态渲染、数据收集、验证和提交功能的表单生成器。并且支持生成任何 Vue 组件。结合内置17种常用表单组件和自定义组件，再复杂的表单都可以轻松搞定。

文档 | github

演示项目: 开源的高品质微信商城

功能

自定义组件

可生成任何Vue组件
自带数据验证
轻松转换为表单组件

通过 JSON 生成表单
通过 Maker 生成表单
强大的API，可快速操作表单
双向数据绑定
事件扩展
局部更新
数据验证
栅格布局
内置组件17种常用表单组件

对比 1.x

速度更快
体积更小
更强大的全局配置
自定义组件更容易扩展
更容易支持第三方 UI 库
更少的 bug

示例

通过 JSON 创建表单

通过 API 操作表单

@form-create包说明

名称	说明
@form-create/iview	iview 版表单生成器
@form-create/element-ui	element-ui 版表单生成器
@form-create/core	form-create 核心包
@form-create/utils	form-create 工具包
@form-create/data	省市区多级联动数据

使用

以element-ui版本为例介绍如何在项目中使用 form-create

安装

npm i @form-create/element-ui

挂载

全局注册

import formCreate form \'@form-create/element-ui\';

Vue.use(formCreate);

局部挂载

import formCreate form \'@form-create/element-ui\';

export default {
  components:{
    formCreate:formCreaet.$form()
  }
}

生成表单

<template>
  <form-create v-model=\"$f\" :rule=\"rule\" @on-submit=\"onSubmit\"></form-create>
</template>
export default {
 data () {
  return {
   //表单实例对象
   $f:{},
   //表单生成规则
   rule:[
    {
     type:\'input\',
     field:\'goods_name\',
     title:\'商品名称\'
    },
    {
     type:\'datePicker\',
     field:\'created_at\',
     title:\'创建时间\'
    }
   ]
  };
 },
 methods:{
   onSubmit(formData){
     //TODO 提交表单
   }
 }
};

效果

实例对象 $f

可以通过 $f 快速操作表单，例如：

$f.hidden：隐藏指定组件
$f.validate：验证表单
$f.setValue：修改表单组件的值
$f.append：追加表单组件

自定义组件

生成

通过标签生成

{
  type:\'el-button\',
  name: \'btn\',
  props:{
    type:\'primary\',
    field:\'btn\',
    loading:true
  },
  children:[\'加载中\']
}

通过模板生成

{
  type:\'template\',
  name:\'btn\'
  template:\'<el-button :loading=\"loading\">{{text}}<el-button>\',
  vm: new Vue({
   data:{
    loading:true,
    text:\'加载中\'
   }
  })
}

转换为表单组件

自定义组件转换为表单组件后，可通过$f.formData,$f.getValue,$f.setValue,$f.disabled等方法快速操作组件，达到和内置组件相同的效果

预定义

props

在自定义组件内部通过props接收一下属性

value 表单的值
disabled 组件的禁用状态

例如:

vm = Vue({
 props:{
  value:String,
  disabled:Boolean   
 }
})

input 事件

通过input事件更新组件内部的值

当组件值发生变化后,通过 input 事件更新值.例如:

vm.$emit(\'input\',newValue);

挂载自定义组件

要生成的自定义组件必须通过Vue.component方法挂载到全局,或者通过formCreate.component方法挂载

例如:

formCreate.component(\'TestComponent\',component);

或者

Vue.component(\'TestComponent\',component);

生成

表单组件必须定义field属性

JSON

{
  type:\'TestComponent\',
  value:\'test\',
  field:\'testField\',
  title:\'自定义组件\'
}

Maker

formCreate.maker.create(\'TestComponent\',\'testField\',\'自定义组件\').value(\'test\')

示例

自定义计数器按钮组件,获取按钮点击数.该组件的功能和内置组件相同

formCreate.maker.template(\'<el-button @click=\"onClick\" long :disabled=\"disabled\">计数器-{{num}}</el-button>\', new Vue({
 props:{
  //预定义
  disabled:Boolean,
  value:Number,
 },
 data: function () {
  return {
    num: this.value,
  }
 },
 watch:{
  value(n){
    this.num = n;
  }
 },
 methods: {
  onClick: function () {
    this.num++;
    //更新组件内部的值
    this.$emit(\'input\',this.num);
  },
 },
}), \'tmp\', \'自定义 title\').value(100).props(\'disabled\',false)

完整示例

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。