动态生成form表单,不用再为表单烦恼

12,825 阅读8分钟

使用iview快速创建form表单

具有数据收集、校验和提交功能的表单生成器,包含复选框、单选框、输入框、下拉选择框等元素以及时间选择,日期选择,颜色选择,文件/图片上传功能。

安装

npm install form-create

OR

git clone https://github.com/xaboy/form-create.git
cd form-create
npm install

引入

<!-- import Vue -->
<script src="node_modules/vue/dist/vue.min.js"></script>

<!-- import iview -->
<link rel="stylesheet" href="node_modules/iview/dist/styles/iview.css">
<script src="node_modules/iview/dist/iview.min.js"></script>

<!-- import formCreate -->
<script src="dist/form-create.min.js"></script>

使用

let rules = [],el = document.body;
new Vue({
  mounted:function(){
    var $f = this.$formCreate(rules,el);
  }
})

$formCreate 参数

rules 表单规则 [inputRule,selectRule,...]

el 插入的Dom节点 默认为 document.body

$f 实例方法

获得表单数据

$f.formData()

修改表单数据

$f.changeField(field,value)

表单验证

$f.validate(successFn,errorFn)

表单验证指定字段

$f.validateField(field,errorFn)

重置表单

$f.resetFields()

移除表单

$f.remove()

获得表单所有字段

$f.fields()

提交表单

$f.submit()

rules 规则:

hidden 隐藏字段

hiddenRule:
{
  type:"hidden",
  field:"id", //字段名称
  value:"14" //input值
}

input 输入框

inputRule :
{
  type:"input",
  title:"商品名称", //label名称
  field:"goods_name" , //字段名称
  value:"iphone 7", //input值,
  props: {
        "type": "text", //输入框类型,可选值为 text、password、textarea、url、email、date
        "clearable":false, //是否显示清空按钮
        "disabled": false, //设置输入框为禁用状态
        "readonly": false, //设置输入框为只读
        "rows": 4, //文本域默认行数,仅在 textarea 类型下有效
        "autosize": false, //自适应内容高度,仅在 textarea 类型下有效,可传入对象,如 { minRows: 2, maxRows: 6 }
        "number": false, //将用户的输入转换为 Number 类型
        "autofocus": false, //自动获取焦点
        "autocomplete": "off", //原生的自动完成功能,可选值为 off 和 on
        "placeholder": "请输入商品名称", //占位文本
        "size": "default", //输入框尺寸,可选值为large、small、default或者不设置,
        "spellcheck": false //原生的 spellcheck 属性
    },
  validate:[
     { required: true, message: 'Mailbox cannot be empty', trigger: 'blur' },
     { type: 'email', message: 'Incorrect email format', trigger: 'blur' }
   ]
}

validate 表单验证规则,具体配置查看 : github.com/yiminghe/as…

radio 单选框

radioRule :
{
  type:"radio",
  title:"是否包邮",
  field:"is_postage",
  value:"0", //input值,
  options:[
    {value:"0",label:"不包邮",disabled:false},
    {value:"1",label:"包邮",disabled:true}
  ],
  props: {
        "type":undefined, //可选值为 button 或不填,为 button 时使用按钮样式
        "size":"default", //单选框的尺寸,可选值为 large、small、default 或者不设置
    	"vertical":false //是否垂直排列,按钮样式下无效
    },
  validate:[]
}

checkbox 复选框

checkboxRule :
{
  type:"checkbox",
  title:"标签",
  field:"label",
  value:[
    "1","2","3"
  ],//input值,
  options:[
    {value:"1",label:"好用",disabled:true},
    {value:"2",label:"方便",disabled:false},
    {value:"3",label:"实用",disabled:false},
    {value:"4",label:"有效",disabled:false}
  ],
  props: {
        "size":"default" //多选框组的尺寸,可选值为 large、small、default 或者不设置
    },
  validate:[]
}

switch 开关

switchRule :
{
  type:"switch",
  title:"是否上架",
  field:"is_show",
  value:"1",//input值,
  props: {
        "size":"default", //开关的尺寸,可选值为large、small、default或者不写。建议开关如果使用了2个汉字的文字,使用 large。
        "disabled":false,//禁用开关
        "trueValue":"1", //选中时的值,当使用类似 1 和 0 来判断是否选中时会很有用
        "falseValue":"0" //没有选中时的值,当使用类似 1 和 0 来判断是否选中时会很有用
    },
  slot: {
    open:"上架", //自定义显示打开时的内容
    close:"下架" //自定义显示关闭时的内容
  }, //slot可以不用配置
  validate:[]
}

select 选择器

selectRule :
{
    type: "select",
    field: "cate_id",
    title: "产品分类",
    value: "104", //input值, multiple为true时 value为数组 [value,value,...]
    props: {
        "multiple": false, //是否支持多选
        "clearable": false, //是否可以清空选项,只在单选时有效
        "filterable": false, //	是否支持搜索
        // 暂不支持远程搜索
        // "remote": false, //是否使用远程搜索
        // "remote-method":()=>{}, //远程搜索的方法
        // "loading": false, //当前是否正在远程搜索
        // "loading-text": "加载中", //远程搜索中的文字提示
        "size":"default", //选择框大小,可选值为large、small、default或者不填
        "placeholder": "请选择", //选择框默认文字
        "not-found-text": "无匹配数据", //当下拉列表为空时显示的内容
        "placement": "bottom", //弹窗的展开方向,可选值为 bottom 和 top
        "disabled": false //是否禁用
    },
    options: [
      {"value": "104", "label": "生态蔬菜", "disabled": false},
      {"value": "105", "label": "新鲜水果", "disabled": false}
    ]
}

DatePicker 日期选择器

DatePickerRule :
{
    type: "DatePicker",
    field: "section_day",
    title: "活动日期",
    value: 1519110955000 || new Date(), //input值, type为daterange,datetimerange value为数组 [start_value,end_value]
    props: {
        "type": "date", //显示类型,可选值为 date、daterange、datetime、datetimerange、year、month
        "format": "yyyy-MM-dd", //展示的日期格式
        "placement": "bottom-start", //	日期选择器出现的位置,可选值为toptop-starttop-endbottombottom-startbottom-endleftleft-startleft-endrightright-startright-end
        "placeholder":"请选择获得时间", //占位文本
        "confirm":false, //是否显示底部控制栏,开启后,选择完日期,选择器不会主动关闭,需用户确认后才可关闭
        "size":"default", //尺寸,可选值为large、small、default或者不设置
        "disabled":false, //是否禁用选择器
        "clearable":true, //是否显示清除按钮
        "readonly":false, //完全只读,开启后不会弹出选择器
        "editable":false //文本框是否可以输入
    },
    validate:[]
}

TimePicker 时间选择器

TimePickerRule :
{
    type: "TimePicker",
    field: "section_time",
    title: "活动时间",
    value: [], //input值, type为timerange value为数组 [start_value,end_value]
    props: {
        "type": "timerange", //显示类型,可选值为 time、timerange
        "format": "HH:mm:ss", //展示的时间格式
        "steps": [], //下拉列表的时间间隔,数组的三项分别对应小时、分钟、秒。例如设置为 [1, 15] 时,分钟会显示:00、15、30、45。
        "placement": "bottom-start", //	时间选择器出现的位置,可选值为toptop-starttop-endbottombottom-startbottom-endleftleft-startleft-endrightright-startright-end
        "placeholder":"请选择获得时间", //占位文本
        "confirm":false, //是否显示底部控制栏,开启后,选择完日期,选择器不会主动关闭,需用户确认后才可关闭
        "size":"default", //尺寸,可选值为large、small、default或者不设置
        "disabled":false, //是否禁用选择器
        "clearable":true, //是否显示清除按钮
        "readonly":false, //完全只读,开启后不会弹出选择器
        "editable":false //文本框是否可以输入
    },
    validate:[]
}

InputNumber 数字输入框

InputNumberRule :
{
    type: "InputNumber",
    field: "sort",
    title: "排序",
    value: 0, //input值
    props: {
        "max": undefined, //最大值
        "min": undefined, //最小值
        "step": 1, //每次改变的步伐,可以是小数
        "size":"default", //输入框尺寸,可选值为large、small、default或者不填
        "disabled":false, //设置禁用状态
        "readonly":false, //是否设置为只读
        "editable":true, //是否可编辑
        "precision":0 //数值精度
    },
    validate:[]
}

ColorPicker 颜色选择器

ColorPickerRule :
{
    type: "ColorPicker",
    field: "coloe",
    title: "颜色",
    value: '#ff7271', //input值
    props: {
        "alpha": false, //是否支持透明度选择
        "hue": true, //是否支持色彩选择
        "recommend": false, //是否显示推荐的颜色预设
        "size":"default", //尺寸,可选值为large、small、default或者不设置
        "colors":[], //自定义颜色预设
        "format":"hex" //颜色的格式,可选值为 hsl、hsv、hex、rgb,开启 alpha 时为 rgb,其它为 hex
    },
    validate:[]
}

Upload 上传

UploadRule :
{
    type: "Upload",
    field: "pic",
    title: "轮播图",
    value: [], //input值
    props: {
        "type":"select", //上传控件的类型,可选值为 select(点击选择),drag(支持拖拽)
        "action": "", //上传的地址,必填
        "headers": {}, //设置上传的请求头部
        "multiple": false, //是否支持多选文件
        "data":{}, //上传时附带的额外参数
        "name":"", //上传的文件字段名
        "with-credentials":false, //支持发送 cookie 凭证信息
        "show-upload-list":true, //是否显示已上传文件列表
        "accept":"", //接受上传的文件类型
        "format":[], //支持的文件类型,与 accept 不同的是,format 是识别文件的后缀名,accept 为 input 标签原生的 accept 属性,会在选择文件时过滤,可以两者结合使用
        "max-size":undefined, //文件大小限制,单位 kb
        "beforeUpload":()=>{}, //上传文件之前的钩子,参数为上传的文件,若返回 false 或者 Promise 则停止上传
        "onProgress":()=>{}, //文件上传时的钩子,返回字段为 event, file, fileList
        "onSuccess":( push, response, file, fileList)=>{
          let filePath = response.data.filePath;
          push(filePath);
          //其他操作
        }, //文件上传成功时的钩子,返回字段为 push, response, file, fileList.  push(filePath) 将上传后的路径添加到value中
        "onError":()=>{}, //文件上传失败时的钩子,返回字段为 error, file, fileList
        "onPreview":()=>{}, //点击已上传的文件链接时的钩子,返回字段为 file, 可以通过 file.response 拿到服务端返回数据
        "onRemove":()=>{}, //文件列表移除文件时的钩子,返回字段为 file, fileList
        "onFormatError":()=>{}, //文件格式验证失败时的钩子,返回字段为 file, fileList
        "onExceededSize":()=>{}, //文件超出指定大小限制时的钩子,返回字段为 file, fileList
        "default-file-list":[
            {
                name: 'img1.jpg',
                url: 'http://www.xxx.com/img1.jpg'
            },
            {
                name: 'img2.jpg',
                url: 'http://www.xxx.com/img2.jpg'
            }
        ] // 默认已上传的文件列表
    },
    validate:[]
}

accept 文件类型: developer.mozilla.org/en-US/docs/…

时间格式

名称 说明 示例
yyyy 年份(四位) 2016
yy 年份(两位) 16
MM 月份(两位) 01
M 月份(一位) 1
MMMM 月份(英文) January
MMM 月份(英文简写) Jan
dd 日期(两位) 01
d 日期(一位) 1
Do 日期(简写) 1st
DD 星期(两位) 00
D 星期(一位) 0
dddd 星期(英文) Monday
ddd 星期(英文简写) Mon
HH 小时(24小时制两位) 01
H 小时(24小时制一位) 1
hh 小时(12小时制两位) 01
h 小时(12小时制一位) 1
mm 分钟(两位) 01
m 分钟(一位) 1
ss 秒钟(两位) 01
s 秒钟(一位) 1
SSS 毫秒(三位) 019
SS 毫秒(两位) 01
S 毫秒(一位) 1
A 上午与下午(大写) AM/PM
a 上午与下午(小写) am/pm
ZZ 时区 +0800

以上是 iView 支持的日期格式,你可以自由组合出你需要的类型,例如:

  • yyyy年M月d日:2016年1月1日
  • MM/dd/yy:12/24/16
  • H点m分s秒:9点41分0秒

联系&打赏

联系邮箱 : xaboy2005@qq.com

打赏扫这里,请留下尊姓大名

https://raw.githubusercontent.com/xaboy/form-builder/master/exceptional.jpg