动态表单 form-create 2.5 版本来啦，帮你轻松搞定表单

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

文档 | GitHub | 示例

支持 UI

• element-ui
• iview/view-design
• ant-design-vue

新增功能

2.5版本主要更新了一下功能:

• 重构内部核心代码
• 优化内部渲染机制
• 优化内部生命周期事件
• 重构 TypeScript
• 新增 nextTick方法,设置渲染后的回调
• 新增 支持分页加载组件,加速首屏渲染
• 新增 自定义配置项effect
• 新增 支持修改type
• 新增 control支持配置规则插入位置
• 优化 control符合条件的都会生效,之前版本只能生效第一个
• 新增 支持给组件配置前缀后缀 prefix, suffix
• 新增 update配置,value发送变化后触发
• 新增 支持 wrap 配置项,配置FormItem
• 新增 object 组件
• 新增 支持自定义title,info组件
• 新增 富文本组件wangEditor
• 新增 原生事件支持事件注入
• 支持 value.sync 获取双向绑定的 formData
• 优化 默认的表单提交按钮

安装

根据自己使用的 UI 安装对应的版本

element-ui 版本

npm i @form-create/element-ui

iview@2.x|3.x 版本

npm i @form-create/iview

iview/view-design@4.x 版本

npm i @form-create/iview4

ant-design-vue@1.5+ 版本

npm i @form-create/ant-design-vue

快速上手

本文以element-ui为例

1. 在 main.js 中写入以下内容：

import Vue from 'vue'
import ELEMENT from 'element-ui'
import 'element-ui/lib/theme-chalk/index.css'

import formCreate from '@form-create/element-ui'

Vue.use(ELEMENT)
Vue.use(formCreate)

1. 生成表单

在线示例

<template>
  <div id="app1">
      <form-create v-model="fApi" :rule="rule" :option="option" :value.sync="value"></form-create>
  </div>
</template>

export default {
    data() {
        return {
            //实例对象
            fApi: {},
            //表单数据
            value: {},
            //表单生成规则
            rule: [
                {
                    type: 'input',
                    field: 'goods_name',
                    title: '商品名称'
                },
                {
                    type: 'datePicker',
                    field: 'created_at',
                    title: '创建时间'
                }
            ],
            //组件参数配置
            option: {
                //表单提交事件
                onSubmit: function (formData) {
                    alert(JSON.stringify(formData))
                }
            }
        }
    }
}

{
	//type 可以是内置组件名称,也可以是vue组件名称或者 html 标签
	type: 'el-button',
   	//...
	children: ['按钮内容']
}

{
	//type 可以是内置组件名称,也可以是vue组件名称或者 html 标签
	type: 'span',
   	//...
	children: ['span内容']
}

Vue.component(component.name, component);

formCreate.component(component.name, component);

[
	{
        type:'input',
        field:'input1',
        title:'input1',
        col:{span:12}
	},{
        type:'input',
        field:'input2',
        title:'input2',
        col:{span:12}
	},
]

{
	type:'el-row',
   	children: [
    	{
        	type:'el-col',
        	props:{
            	span:8
        	},
        	children: [{type:'input',field:'input1',title:'input1'}]
        },
    	{
        	type:'el-col',
        	props:{
            	span:8
        	},
        	children: [{type:'input',field:'input1',title:'input1'}]
        },
    	{
        	type:'el-col',
        	props:{
            	span:8
        	},
        	children: [{type:'input',field:'input1',title:'input1'}]
        }
    ]
}

{
    type:'input',
    field:'text',
    title:'text',
    prefix:'prefix',
    suffix:'suffix',
}

{
    type:'input',
    field:'text',
    title:'text',
    value:'default',
    prefix:{
        type:'ElButton', children:['prefix']
    },
    suffix:{
        type:'ElButton', children:['suffix']
    },
}

{
    type:'rate',
    field: 'star',
    title:'评分',
    value:5,
    control:[
        {
            handle(val){
                return val < 3
            },
            rule:[
                {
                    type:'input',
                    field:'info',
                    title:'差评原因',
                    value:'default info', 
                } 
            ]   
        }                                              
    ]
}

{
	type:'input',
	//...
	validate:[{required:true, type:'string', message:'请个输入内容'}]
}

type coverValue = (formData:{[field:string]:any}) => void

fApi.coverValue({goods_name:'HuaWei'})

interface setValue {
    (formData:{[field:string]:any}): void
    (field:string, value:any): void
}

fApi.setValue({goods_name:'HuaWei'})

interface hidden {
    //隐藏全部组件
    (status:Boolean):void
    //隐藏指定组件
    (status:Boolean, field:string):void
    //隐藏部分组件
    (status:Boolean, field:string[]):void 
}

fApi.hidden(true, 'goods_name')

type hiddenStatus = (field:string)=>Boolean

const status = fApi.hiddenStatus('goods_name')

interface getRule {
    (field:string):Rule
    (field:string, origin: true): FormRule
}

const rule = fApi.getRule('goods_name')

interface prepend {
    //插入到第一个
    (rule:FormRule):void 
    //插入指定字段前面
    (rule:FormRule, field:string):void
    //插入到指定字段 children 中
    (rule:FormRule, field:string, child:true):void
}

fApi.prepend({
     type:"input",
     title:"商品简介",
     field:"goods_info",
     value:"",
     props: {
         "type": "text",
         "placeholder": "请输入商品简介",
     },
     validate:[
         { required: true, message: '请输入商品简介', trigger: 'blur' },
     ],
}, 'goods-name')

interface append {
    //插入到最后一个
    (rule:FormRule):void 
    //插入指定字段后面
    (rule:FormRule, field:string):void
    //插入到指定字段 children 中
    (rule:FormRule, field:string, child:true):void
}

fApi.append({
     type:"input",
     title:"商品简介",
     field:"goods_info",
     value:"",
     props: {
         "type": "text",
         "placeholder": "请输入商品简介",
     },
     validate:[
         { required: true, message: '请输入商品简介', trigger: 'blur' },
     ],
}, 'goods-name')

type removeRule = (rule:FormRule) => FormRule

const rule = {type:'input', /** ... **/}
fApi.removeRule(rule)

type validate = (callback:(...args:any[]) => void)=> void

fApi.validate((valid, fail) => {
    if(valid){
        //todo 表单验证通过
    }else{
        //todo 表单验证未通过
    }
})

type validateField = (field, callback:(...args:any[]) => void)=> void

fApi.validateField('goods_name', (valid, fail) => {
    if(valid){
        //todo 字段验证通过
    }else{
        //todo 字段验证未通过
    }
})

interface formData {
    //获取全部数据
    (): {[field:string]:any }
    //获取部分字段的数据
    (field:string[]): {[field:string]:any }
}

const formData = fApi.formData()

type submitBtnProps = (props:Object) => void

fApi.submitBtnProps({disabled:true})

type resetBtnProps = ( props:Object) => void

fApi.resetBtnProps({disabled:true})

type hideForm = (hide:Boolean)=>void

fApi.hideForm(true)

type submit = (success: (formData: FormData, $f: fApi) => void, fail: ($f: fApi) => void)=> void

fApi.submit((formData, fapi) => {
    //todo 提交表单
},()=>{
    //todo 表单验证未通过
}