# vform-pro

**Repository Path**: wangzherlf/vform

## Basic Information

- **Project Name**: vform-pro
- **Description**: vform 3.1.5 pro  由官方3.1.5二次开发分支
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 12
- **Created**: 2024-10-24
- **Last Updated**: 2024-10-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Variant Form 3 For Vue 3.1.5  二次开发版
#### 一款高效的Vue 3低代码表单，可视化设计，一键生成源码，享受更多摸鱼时间。

![image](https://ks3-cn-beijing.ksyuncs.com/vform-static/img/vform_demo.gif)

<br/>

### 立即体验
 [在线Demo](http://120.92.142.115:81/vform3pro/)
 
### 友情链接
[Fantastic-admin](https://hooray.gitee.io/fantastic-admin/) —— 一款开箱即用的 Vue 中后台管理系统框架（支持Vue2/Vue3）

[REBUILD](https://getrebuild.com/) —— 高度可定制化的企业管理系统

### 功能一览
```
> 拖拽式可视化表单设计；
> 支持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```
 
 <br/>
 
 ### 跟Vue 3.x项目集成
 
 <br/>
 
 #### 1. 安装包
   ```bash
   npm i vform3-builds
   ```
 或
   ```bash
   yarn add vform3-builds
   ```
 
 <br/>
 
 #### 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')
 ```
 
 <br/>
 
 #### 3. 在Vue 3.x模板中使用表单设计器组件
 ```bash
 <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>
 ```
 
 <br/>
 
 #### 4. 在Vue 3.x模板中使用表单渲染器组件
 ```html
 <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>
```

 ### 更新日志
 #### 20230427 
  版本号3.1.5修改3.15.1 完全脱离官方更新, 设置界面左右工具栏 增加 分割栏

 #### 20230507
  版本号v3.15.2 
  ###### 增加Tree组件
  ###### tree-select和transfer组件增加设计时设置选项功能

#### 20230510
  版本号v3.15.3 
  ###### 增加hidden组件 解决input组件隐藏后取不到数据问题