计算机系统应用教程网站

网站首页 > 技术文章 正文

表单设计器1.3.0 新版发布,自定义表单支持数据源配置

btikc 2024-12-17 11:35:21 技术文章 24 ℃ 0 评论

介绍

FormMaking是一款基于Vue的表单设计器,拖拽式的表单设计器可以很方便的进行表单设计与表单制作,通常用在OA系统,考试系统,报表系统中,支持表单设计器二次开发,可以自行添加新的自定义组件,让表单开发简单而高效,赋能企业实现低代码开发模式!

FormMaking

FormMaking表单设计器分两个部分,一个是设计器,一个是生成器设计器可以用来设计器表单页面,使用拖拽的方式,可以很方便的创建一个表单,同时设计器还针对每个不同的组件配置有不同的参数可以设置,设计器设计的页面可以用一个完整的JSON格式数据表示。生成器则可以通过完整的JSON格式数据还原表单页面,并渲染出表单数据。

设计器

相信不少前端开发者在初次了解到这个设计器的时候会认为这只是一个表单页面的设计器,经验丰富的开发者根本用不上这样的工具,要做一个页面只需要将之前设计过的页面复制过来,简单修改下就能完成,如果您也有这样的看法,欢迎认真看完。

FormMaking表单设计器的强大之处在于可以动态设计整个表单页面,已有组件直接通过拖拽的方式布局表单页面,右侧会根据不同组件类型提供特定的可配置项。比如下拉框可以配置下拉选项的数据,可以用静态数据也可以从自己服务器获取选项数据,也可以配置全局或是部分的样式设置,还可以配置数据的校验选项以及组件的change事件。

下图是一个比较常见的表单页面示例



下图是表单设计完成后得到的整个表单的JSON 数据。


在设计器组件中我们提供了丰富的API,可以让开发者很方便的对数据操作处理。

API

参数

参数

说明

类型

默认值

版本

preview

预览操作

boolean

false


generate-json

生成json操作

boolean

false


generate-code

生成代码操作

boolean

false


clearable

清空操作

boolean

false


upload

导入json操作

boolean

false


basic-fields

左侧基础字段配置

array

-


advance-fields

左侧高级字段配置

array

-


layout-fields

左侧布局字段配置

array

-


custom-fields

自定字段配置

array

-


global-config

表单初始化全局配置,配置项参考 Global Config Options




方法

通过 this.$refs 可以获取到 MakingForm 实例并调用实例方法

方法名

说明

参数

版本

getJSON

获取设计器配置的json数据

-


getHtml

获取设计器生成的可以直接使用的代码

-


setJSON

设置设计器配置的json数据

(value) 设计器获取的json数据


clear

清空设计器操作

-


handleUndo

撤销

-


handleRedo

重做

-

Events

事件名

说明

回调参数

版本

ready

设计器初始化完成

-

1.2.18


Global Config Options

参数

说明

类型

默认值

版本

ui

表单使用的组件库,

Element: element

Ant Design: antd

string

element

1.3.0

width

表单宽度

string

100%

1.3.0

customClass

自定义样式表类名

string

-

1.3.0

styleSheets

初始化表单样式表

string

-

1.3.0

dataSource

初始化表单数据源

array

-

1.3.0



生成器

生成器和设计器是两个独立的组件,生成器主要负责将设计器生成的JSON数据还原成整个表单页面,并且收集用户填写的表单数据。也可以利用页面的JSON 和表单数据的JSON 渲染出已填写的表单页面和数据。


API

props

参数

说明

类型

默认值

版本

data

表单json配置数据

object

{}


value

表单数据

object

-


remote

表单配置的远端方法

object

{}


edit

表单可编辑状态

boolean

true


remote-option

表单动态选项配置

object

{}



Events

事件名

说明

回调参数

版本

on-change

表单任一条数据变化时触发

(field, value, data)

field: 数据改变的字段标识

value: 数据改变后的值

data: 表单数据


on-${ID}-change

表单ID标识的数据变化时触发

(value)

value: 该标识数据变化后的值



方法

通过 this.$refs 可以获取到 GenerateForm 实例并调用实例方法

方法名

说明

参数

版本

getData

获取表单数据

(isValidate = true)

isValidate: 是否启用表单验证

1.2.18

reset

重置表单数据

-


setData

设置表单数据

(value) 表单数据,例:{ID: value}


hide

隐藏表单字段

(fields)

fields: 字段标识数组,例:['ID']


display

显示表单隐藏的字段

(fields)

fields: 字段标识数组,例:['ID']


disabled

动态设置表单字段是否禁用

(fields, disabled)

fields: 字段标识数组,例:['ID']

disabled: 是否禁用,boolean类型(true/false)


refresh

刷新表单,当表单json改变时,需要调用该方法重新渲染

-

1.2.18

getComponent

通过组件定义的 ref 获取表单中的组件

(refName)

refName: 组件定义的 ref

1.2.18

addClassName

表单项添加样式类

(fields, className)

fields: 字段标识数组,例:['ID']

className: 样式类名

1.2.21

removeClassName

移除表单项样式类

(fields, className)

fields: 字段标识数组,例:['ID']

className: 样式类名

1.2.21

更新功能

数据源

这次更新主要为表单设计器加上了数据源,让表单和后端数据间实现了方便的交互,通过配置数据源可以方便的拿到后端的数据,数据源配置也是采用通用的接口配置模式。

可以通过下方动图来感受下数据源如何配置

下面将介绍数据源功能的具体使用方法

配置数据源

打开数据源设置面板

表单属性 中打开 数据源设置 可以进行数据源的配置。

添加数据源

点击 添加数据源 ,面板右侧会出现数据源设置项。

名称:数据源名称,必须唯一,用于展示和选择数据源。

是否表单初始化发送请求:默认为 true,表单 create() 生命周期进行请求。

请求地址:远端接口地址。

数据处理:数据源默认返回接口响应的数据,如果需要对数据源进行整理细化,可使用编辑器自定义操作。


请求测试

完成数据源配置后,可以点击 请求测试 ,进行数据源接口验证,查看是否填写成功,返回数据是否正确。

保存

完成数据源配置后,需要进行保存操作;保存后即可在设计器配置时进行该数据源的选择。

Tags:

本文暂时没有评论,来添加一个吧(●'◡'●)

欢迎 发表评论:

最近发表
标签列表