mirror of https://github.com/vform666/variant-form3-vite.git synced 2024-09-19 20:34:47 +08:00

Go to file

vform666 5849f15766 Merge pull request #30 from a847244052/master Master		2024-03-28 15:05:04 +08:00
lib/vuedraggable	解决Vue.Draggable在Vue新版3.2.32上运行报错“Cannot set properties of null (setting '__draggable_context')”的问题。	2022-05-13 14:59:19 +08:00
public	Vue 3版本初次提交，继续测试中。	2021-12-25 19:36:55 +08:00
src	fix: width abnormal when collapse all closed	2024-03-25 08:38:36 +00:00
.gitignore	版本号升级到3.0.8，给组件库svg图标加上主题色。	2022-05-25 18:33:23 +08:00
index.html	配置build生产打包参数，未全部解决。	2022-01-30 16:07:28 +08:00
install-render.js	SvgIcon组件取消全局注册，改为局部注册。	2022-10-21 13:45:46 +08:00
install.js	SvgIcon组件取消全局注册，改为局部注册。	2022-10-21 13:45:46 +08:00
jsconfig.json	Vue 3版本初次提交，继续测试中。	2021-12-25 19:36:55 +08:00
license.txt	替换许可协议。	2022-01-11 14:33:53 +08:00
package.json	升级到3.0.10版本：	2023-02-15 13:30:27 +08:00
README.md	更新友链。	2023-12-21 13:36:45 +08:00
vite-lib-render.config.js	修复两个小bug：	2022-11-24 14:40:19 +08:00
vite-lib.config.js	修复两个小bug：	2022-11-24 14:40:19 +08:00
vite.config.js	版本升级到3.0.4：	2022-03-08 17:59:10 +08:00

README.md

Variant Form 3 For Vue 3.x

一款高效的Vue 3低代码表单，可视化设计，一键生成源码，享受更多摸鱼时间。

立即体验VForm 3

在线Demo

🎉🎉基于VForm3的全栈低代码平台已发布🎉🎉

美乐低代码——立即进入（私有部署、开箱即用️，已开源✌✌）️

友情链接

Fantastic-admin —— 一款开箱即用的 Vue 中后台管理系统框架（支持Vue2/Vue3）

功能一览

> 拖拽式可视化表单设计；
> 支持PC、Pad、H5三种布局；
> 支持运行时动态加载表单；
> 支持表单复杂交互控制；
> 支持自定义CSS样式；
> 支持自定义校验逻辑；
> 支持国际化多语言；
> 可导出Vue组件、HTML源码；
> 可导出Vue的SFC单文件组件；
> 支持开发自定义组件；
> 支持响应式自适应布局；
> 支持VS Code插件；
> 更多功能等你探究...；

安装依赖

npm install --registry=https://registry.npm.taobao.org

开发调试

npm run serve

生产打包

npm run build

表单设计器 + 表单渲染器打包

npm run lib

表单渲染器打包

npm run lib-render

浏览器兼容性

Chrome（及同内核的浏览器如QQ浏览器、360浏览器等等），Firefox，Safari

跟Vue 3.x项目集成

1. 安装包

npm i vform3-builds

或

yarn add vform3-builds

2. 引入并全局注册VForm 3组件

import { createApp } from 'vue'
import App from './App.vue'

import ElementPlus from 'element-plus'  //引入element-plus库
import 'element-plus/dist/index.css'  //引入element-plus样式

import VForm3 from 'vform3-builds'  //引入VForm 3库
import 'vform3-builds/dist/designer.style.css'  //引入VForm3样式

const app = createApp(App)
app.use(ElementPlus)  //全局注册element-plus
app.use(VForm3)  //全局注册VForm 3(同时注册了v-form-designer和v-form-render组件)

app.mount('#app')

3. 在Vue 3.x模板中使用表单设计器组件

<template>
<v-form-designer ref="vfdRef"></v-form-designer>
</template>

<script setup>
const vfdRef = ref(null)
</script>

<style lang="scss">
body {
margin: 0;  /* 如果页面出现垂直滚动条，则加入此行CSS以消除之 */
}
</style>

4. 在Vue 3.x模板中使用表单渲染器组件

<template>
<div>
 <v-form-render :form-json="formJson" :form-data="formData" :option-data="optionData" ref="vFormRef">
 </v-form-render>
 <el-button type="primary" @click="submitForm">Submit</el-button>
</div>
</template>
<script setup>
import { ref, reactive } from 'vue'
import { ElMessage } from 'element-plus'

const formJson = reactive({"widgetList":[],"formConfig":{"modelName":"formData","refName":"vForm","rulesName":"rules","labelWidth":80,"labelPosition":"left","size":"","labelAlign":"label-left-align","cssCode":"","customClass":"","functions":"","layoutType":"PC","jsonVersion":3,"onFormCreated":"","onFormMounted":"","onFormDataChange":""}})
const formData = reactive({})
const optionData = reactive({})
const vFormRef = ref(null)

const submitForm = () => {
 vFormRef.value.getFormData().then(formData => {
   // Form Validation OK
   alert( JSON.stringify(formData) )
 }).catch(error => {
   // Form Validation failed
   ElMessage.error(error)
 })
}
</script>