203 lines
4.9 KiB
Markdown
203 lines
4.9 KiB
Markdown
# Variant Form
|
||
#### 一款高效的Vue低代码表单,可视化设计,一键生成源码,享受更多摸鱼时间。
|
||
|
||
![image](https://ks3-cn-beijing.ksyuncs.com/vform-static/img/vform_demo.gif)
|
||
|
||
<br/>
|
||
|
||
### 立即体验
|
||
[在线Demo](http://120.92.142.115/)
|
||
|
||
|
||
### 🎉🎉<mark>基于VForm的全栈低代码平台已发布</mark>🎉🎉
|
||
![meta_low_code](https://vform666.com/mele.png)
|
||
<br/>
|
||
[美乐低代码——立即进入](https://melecode.com/) (私有部署、开箱即用️,已开源✌✌)️
|
||
|
||
|
||
### 立即体验VForm Pro高级版(提供商业支持)
|
||
[Pro Demo](https://www.vform666.com/pro/)
|
||
|
||
### 视频教程集合:
|
||
[B站观看](https://space.bilibili.com/626932375)
|
||
|
||
### Vue 3正式版已发布
|
||
[立即进入](https://gitee.com/vdpadmin/variant-form3-vite)
|
||
|
||
### 🎉🎉基于Vant组件库的Mobile版本已发布🎉🎉
|
||
[立即进入](https://vform666.com/vform-mobile.html)
|
||
|
||
|
||
### 友情链接
|
||
|
||
[Fantastic-admin](https://hooray.gitee.io/fantastic-admin/) —— 一款开箱即用的 Vue 中后台管理系统框架(支持Vue2/Vue3)
|
||
|
||
|
||
<br/>
|
||
|
||
### 功能一览
|
||
```
|
||
> 拖拽式可视化表单设计;
|
||
> 支持PC、Pad、H5三种布局;
|
||
> 支持运行时动态加载表单;
|
||
> 支持表单复杂交互控制;
|
||
> 支持自定义CSS样式;
|
||
> 支持自定义校验逻辑;
|
||
> 支持国际化多语言;
|
||
> 兼容IE 11浏览器;
|
||
> 可导出Vue组件、HTML源码;
|
||
> 可导出Vue的SFC单文件组件;
|
||
> 支持开发自定义组件;
|
||
> 支持响应式自适应布局;
|
||
> 支持VS Code插件;
|
||
> 更多功能等你探究...;
|
||
```
|
||
|
||
### 安装依赖
|
||
```
|
||
npm install --registry=https://registry.npmmirror.com
|
||
```
|
||
|
||
### 开发调试
|
||
```
|
||
npm run serve
|
||
```
|
||
|
||
### 生产打包
|
||
```
|
||
npm run build
|
||
```
|
||
|
||
### 表单设计器 + 表单渲染器打包
|
||
```
|
||
npm run lib
|
||
```
|
||
|
||
### 表单渲染器打包
|
||
```
|
||
npm run lib-render
|
||
```
|
||
|
||
### 浏览器兼容性
|
||
```Chrome(及同内核的浏览器如QQ浏览器、360浏览器等等),Edge, Firefox,Safari,IE 11```
|
||
|
||
<br/>
|
||
|
||
### 跟Vue项目集成
|
||
|
||
<br/>
|
||
|
||
#### 1. 安装包
|
||
```bash
|
||
npm i vform-builds
|
||
```
|
||
或
|
||
```bash
|
||
yarn add vform-builds
|
||
```
|
||
|
||
<br/>
|
||
|
||
#### 2. 引入并全局注册VForm组件
|
||
```javascript
|
||
import Vue from 'vue'
|
||
import App from './App.vue'
|
||
|
||
import ElementUI from 'element-ui' //引入element-ui库
|
||
import VForm from 'vform-builds' //引入VForm库
|
||
|
||
import 'element-ui/lib/theme-chalk/index.css' //引入element-ui样式
|
||
import 'vform-builds/dist/VFormDesigner.css' //引入VForm样式
|
||
|
||
Vue.config.productionTip = false
|
||
|
||
Vue.use(ElementUI) //全局注册element-ui
|
||
Vue.use(VForm) //全局注册VForm(同时注册了v-form-designer和v-form-render组件)
|
||
|
||
new Vue({
|
||
render: h => h(App),
|
||
}).$mount('#app')
|
||
```
|
||
|
||
<br/>
|
||
|
||
#### 3. 在Vue模板中使用表单设计器组件
|
||
```html
|
||
<template>
|
||
<v-form-designer></v-form-designer>
|
||
</template>
|
||
|
||
<script>
|
||
export default {
|
||
data() {
|
||
return {
|
||
}
|
||
}
|
||
}
|
||
</script>
|
||
|
||
<style lang="scss">
|
||
body {
|
||
margin: 0; /* 如果页面出现垂直滚动条,则加入此行CSS以消除之 */
|
||
}
|
||
</style>
|
||
```
|
||
|
||
<br/>
|
||
|
||
#### 4. 在Vue模板中使用表单渲染器组件
|
||
```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>
|
||
export default {
|
||
data() {
|
||
return {
|
||
formJson: {"widgetList":[],"formConfig":{"labelWidth":80,"labelPosition":"left","size":"","labelAlign":"label-left-align","cssCode":"","customClass":"","functions":"","layoutType":"PC","onFormCreated":"","onFormMounted":"","onFormDataChange":""}},
|
||
formData: {},
|
||
optionData: {}
|
||
}
|
||
},
|
||
methods: {
|
||
submitForm() {
|
||
this.$refs.vFormRef.getFormData().then(formData => {
|
||
// Form Validation OK
|
||
alert( JSON.stringify(formData) )
|
||
}).catch(error => {
|
||
// Form Validation failed
|
||
this.$message.error(error)
|
||
})
|
||
}
|
||
}
|
||
}
|
||
</script>
|
||
```
|
||
|
||
<br/>
|
||
|
||
### 资源链接
|
||
<hr>
|
||
|
||
文档官网:<a href="https://www.vform666.com/" target="_blank">https://www.vform666.com/</a>
|
||
|
||
在线演示:<a href="http://120.92.142.115/" target="_blank">http://120.92.142.115/</a>
|
||
|
||
Gitee仓库:<a href="https://gitee.com/vdpadmin/variant-form" target="_blank">https://gitee.com/vdpadmin/variant-form</a>
|
||
|
||
Github仓库:<a href="https://github.com/vform666/variant-form" target="_blank">https://github.com/vform666/variant-form</a>
|
||
|
||
VS Code插件:<a href="https://www.vform666.com/plugin/" target="_blank">https://www.vform666.com/plugin/</a>
|
||
|
||
更新日志:<a href="https://www.vform666.com/changelog.html" target="_blank">https://www.vform666.com/changelog.html</a>
|
||
|
||
订阅Pro版:<a href="https://www.vform666.com/pro/" target="_blank">https://www.vform666.com/pro/</a>
|
||
|
||
技术交流群:扫如下二维码加群
|
||
|
||
![image](https://vform2022.ks3-cn-beijing.ksyuncs.com/vchat_qrcode.png)
|