1.1.7 • Published 1 year ago
ghsoft-form-making v1.1.7
分支管理
develop-common:适用于地价的公共代码分支(未包含移动端,一般公共功能往这里加,完成后再合到其他分支) develop:包含移动端的可用于公共项目分支(不适用于地价项目,表单太大会卡住) dev-landprice(合并移动端前):地价项目分支(有部分地价项目的功能只在这个分支上特有)
form-making
基于Vue2x,ElementUI,小幺鸡二次开发的一款表单设计器,提高表单开发效率的利器,让开发者从枯燥的表单代码编写中解放出来
特性
- 可视化配置页面
- 提供栅格布局,并采用flex实现对齐
- 一键预览配置的效果
- 一键生成配置json数据
- 一键生成代码,立即可运行
- 提供自定义组件满足用户自定义需求
- 提供远端数据接口,方便用户需要异步获取数据加载
- 提供功能强大的高级组件
- 支持表单验证
- 快速获取表单数据
CDN
<!-- 引入样式 -->
<link rel="stylesheet" href="https://unpkg.com/form-making/dist/FormMaking.css">
<!-- 引入组件库 -->
<script src="https://unpkg.com/form-making/dist/FormMaking.umd.js"></script>
<!-- 需要在设计器中预览代码需要引入ace.js库 -->
<script src="https://unpkg.com/form-making/public/lib/ace/src-min/ace.js"></script>
Install
npm install form-making -S
Quick Start
import FormMaking from 'form-making'
import 'form-making/dist/FormMaking.css'
Vue.use(FormMaking)
// or
import {
GenerateForm
} from 'form-making'
import 'form-making/dist/FormMaking.css'
Vue.component(GenerateForm.name, GenerateForm)
Template
<fm-generate-form></fm-generate-form>
设计器引用
import {MakingForm} from 'form-making'
Vue.component(MakingForm.name, MakingForm)
<fm-making-form preview generate-code generate-json>
<template slot="action">
</template>
</fm-making-form>
<!-- 需要在设计器中预览代码需要引入ace.js库 -->
<script src="https://unpkg.com/form-making/public/lib/ace/src-min/ace.js"></script>
props
Prop name | Description | Type | Default value |
---|---|---|---|
preview | 预览,头部操作按钮 | Boolean | false |
generate-json | 生成JSON | Boolean | false |
generate-code | 生成代码 | Boolean | false |
methods
Function name | Description |
---|---|
getJSON | 获取设计器生成的JSON数据 |
getHtml | 获取生成可使用的html代码 |
setJSON(value) | 根据value值设置表单设计器 |
slots
Slot name | Description |
---|---|
action | 自定义设计器操作按钮,展示在设计头部区域 |
表单渲染
下面就是加载对应的数据用于展示,假设你已经正确加载组件
<fm-generate-form
:data="jsonData"
:remote="remoteFuncs"
:value="values"
ref="generateForm">
</fm-generate-form>
new Vue({
...
data () {
return {
jsonData: {}, // 表单配置中生成的json数据
values: {}, // 表单需要显示的表单数据
remoteFuncs: {
// 组件配置时配置的远端方法,保持和配置时输入的名称一致
func_test (resolve) {
// 模拟接口请求
setTimeout(() => {
const options = [
{id: '1', name: '1111'},
{id: '2', name: '2222'},
{id: '3', name: '3333'}
]
// 获取到的值和标签可以通过配置页远端配置
// 值:id 标签:name
resolve(options) // 将后端获取的数据放入回调函数中
}, 2000)
},
func_test2....
}
}
},
methods: {
...{
// 调用此方法验证表单数据和获取表单数据
this.$refs.generateForm.getData().then(data => {
// 数据校验成功
// data 为获取的表单数据
}).catch(e => {
// 数据校验失败
})
}
}
})