Skip to content

Commit daeeda7

Browse files
committed
文档更新
1 parent 1f71f91 commit daeeda7

File tree

4 files changed

+100
-6
lines changed

4 files changed

+100
-6
lines changed

README.md

Lines changed: 48 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -27,11 +27,13 @@
2727
```
2828

2929
## Install
30+
3031
```shell
3132
npm install form-making -S
3233
```
3334

3435
## Quick Start
36+
3537
``` javascript
3638
import FormMaking from 'form-making'
3739
import 'form-making/dist/FormMaking.css'
@@ -51,21 +53,57 @@ Vue.component(GenerateForm.name, GenerateForm)
5153
<fm-generate-form></fm-generate-form>
5254
```
5355

54-
## 功能介绍
56+
## 设计器引用
57+
58+
``` javascript
59+
import {MakingForm} from 'form-making'
60+
Vue.component(MakingForm.name, MakingForm)
61+
```
62+
63+
```html
64+
<fm-making-form preview generate-code generate-json>
65+
<template slot="action">
66+
</template>
67+
</fm-making-form>
68+
```
69+
70+
##### props
71+
| Prop name | Description | Type | Default value |
72+
| ------------ | ------------ | ------------ | ------------ |
73+
| preview | 预览,头部操作按钮 | Boolean | false |
74+
| generate-json | 生成JSON | Boolean | false |
75+
| generate-code | 生成代码 | Boolean | false |
76+
5577

56-
通过 [在线地址](http://tools.xiaoyaoji.cn/form) 或者拉取代码自己打包到项目生成的JSON,用于表单渲染
78+
##### methods
79+
| Function name | Description |
80+
| ------------- | ------------------------------ |
81+
| `getJSON` | 获取设计器生成的JSON数据 |
82+
| `getHtml` | 获取生成可使用的html代码 |
83+
| `setJSON(value)` | 根据value值设置表单设计器 |
84+
85+
##### slots
86+
| Slot name | Description |
87+
| ------------- | ------------------------------ |
88+
| action | 自定义设计器操作按钮,展示在设计头部区域 |
89+
90+
91+
## 表单渲染
92+
93+
通过 [在线地址](http://tools.xiaoyaoji.cn/form) 或者引用设计器生成的JSON,用于表单渲染
5794
![](https://user-gold-cdn.xitu.io/2018/9/27/1661a50b64f77e5f?w=1580&h=1080&f=png&s=162948)
5895

5996
下面就是加载对应的数据用于展示,假设你已经正确加载组件
6097

6198
``` html
62-
<fm-generate-form
63-
:data="jsonData"
64-
:remote="remoteFuncs"
99+
<fm-generate-form
100+
:data="jsonData"
101+
:remote="remoteFuncs"
65102
:value="values"
66103
ref="generateForm">
67104
</fm-generate-form>
68105
```
106+
69107
``` javascript
70108
new Vue({
71109
...
@@ -107,6 +145,11 @@ new Vue({
107145
}
108146
})
109147
```
148+
149+
## 高级字段使用
150+
151+
152+
110153
## 问题交流
111154

112155
QQ群:902048874

doc/blank.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
## 自定义扩展字段
2+
3+
**开发者使用该字段可以通过代码引用的方式添加自己想要的组件**
4+
5+
1. 首先在设计器中配置需要绑定的数据key和数据类型,这里需要设置下你绑定的到表单中的数据类型,防止类型报错
6+
7+
![](https://user-gold-cdn.xitu.io/2018/10/27/166b55ab4883ecbe?w=1127&h=341&f=png&s=27636)
8+
9+
2. 在 fm-generate-form 中引入自定义组件,如:
10+
11+
```html
12+
<generate-form >
13+
<template slot="blank" slot-scope="scope">
14+
宽度:<el-input v-model="scope.model.blank.width" style="width: 100px"></el-input>
15+
高度:<el-input v-model="scope.model.blank.height" style="width: 100px"></el-input>
16+
</template>
17+
</generate-form>
18+
```
19+
20+
3. 预览效果如下:
21+
22+
![](https://user-gold-cdn.xitu.io/2018/10/27/166b5a15b837f3fe?w=867&h=320&f=png&s=18568)

doc/imgupload.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
## 图片上传
2+
3+
**图片上传到七牛,需要配置七牛访问图片域名和七牛上传token**
4+
5+
![](https://user-gold-cdn.xitu.io/2018/10/27/166b5aa13b248ca0?w=318&h=178&f=png&s=11373)
6+
7+
代码实例:
8+
```html
9+
<fm-generate-form :remote="remoteFuncs" ></fm-generate-form>
10+
```
11+
12+
```javascript
13+
new Vue({
14+
data () {
15+
return {
16+
remoteFuncs: {
17+
funcGetToken (resolve) {
18+
// todo: 获取七牛token
19+
resolve(uptoken)
20+
}
21+
}
22+
}
23+
}
24+
})
25+
```

package.json

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "form-making",
33
"description": "基于Vue,ElementUI开发的一款表单设计器,提高表单开发效率的利器,让开发者从枯燥的表单代码编写中解放出来",
4-
"version": "1.0.1",
4+
"version": "1.1.0",
55
"author": "GavinZhulei",
66
"license": "MIT",
77
"keywords": [
@@ -31,6 +31,10 @@
3131
"multiparty": "^4.2.1",
3232
"normalize.css": "^8.0.0",
3333
"qiniu": "^7.2.1",
34+
"qiniu-js": "^2.5.1",
35+
"tinymce": "^4.8.4",
36+
"tui-color-picker": "^2.2.0",
37+
"tui-editor": "^1.2.6",
3438
"viewerjs": "^1.2.0",
3539
"vue": "^2.5.16",
3640
"vue-awesome": "^3.0.0",

0 commit comments

Comments
 (0)