VUE做出带有数据收集、校验和提交功能表单
这次给大家带来VUE做出带有数据收集、校验和提交功能表单,VUE做出带有数据收集、校验和提交功能表单的注意事项有哪些,下面就是实战案例,一起来看一下。
示例
https://raw.githubusercontent.com/xaboy/form-create/dev/images/sample110.jpg
安装npm install form-createORgit clone https://github.com/xaboy/form-create.gitcd form-createnpm install引入<!-- import Vue --><script alt="VUE做出带有数据收集、校验和提交功能表单" src="node_modules/vue/dist/vue.min.js"></script><!-- import iview --><link rel="stylesheet" href="node_modules/iview/dist/styles/iview.css" rel="external nofollow" ><script alt="VUE做出带有数据收集、校验和提交功能表单" src="node_modules/iview/dist/iview.min.js"></script><!-- 省市区三级联动json数据 --><script alt="VUE做出带有数据收集、校验和提交功能表单" src="/district/province_city_area.js"></script><!-- 模拟数据 --><script alt="VUE做出带有数据收集、校验和提交功能表单" src="mock.js"></script><!-- import formCreate --><script alt="VUE做出带有数据收集、校验和提交功能表单" src="dist/form-create.min.js"></script>注意! iview版本请>=2.9.2,否则可能存在问题
使用let rules = window.mock;new Vue({ mounted:function(){ let $f = this.$formCreate(mock,{onSubmit:function (formData) {console.log(formData);$f.submitStatus({loading:true});}});//动态添加表单元素$f.append($r,'goods_name'); }})$formCreate 参数
rules 表单生成规则 [inputRule,selectRule,...]
options 初始化配置参数 (详细见底部 createOptions)
$f 实例方法
formData() 获取表单的value
getValue(field) 获取指定字段的value
changeField(field,value) 修改指定字段的value
resetFields() 重置表单
destroy() 销毁表单
removeField(field) 删除指定字段
fields() 获得表单所有字段名称
submit() 表单验证通过后提交表单,触发onSubmit事件
validate(successFn,errorFn) 表单验证,如果验证通过执行successFn,未通过则执行errorFn
validateField(field,callback) 表单验证指定字段 $f.validateField(field,(errMsg)=>{if(errMsg){//TODO 验证未通过}else{//TODO 验证通过} });prepend(rule,field = undefined) 在field的字段之前输入指定表单元素,不传入field默认在第一个$f.prepend({type:"input",title:"商品简介",field:"goods_info",value:"",props: {"type": "text","placeholder": "请输入商品简介",},validate:[{ required: true, message: '请输入商品简介', trigger: 'blur' },], });append(rule,field = undefined) 在field的字段之前输入指定表单元素,不传入field默认在最后一个$f.append({type:"input",title:"商品简介",field:"goods_info",value:"",props: {"type": "text","placeholder": "请输入商品简介",},validate:[{ required: true, message: '请输入商品简介', trigger: 'blur' },], });submitStatus(props) 修改表单提交按钮状态$f.submitStatus({//按钮类型,可选值为primary、ghost、dashed、text、info、success、warning、error或者不设置type:"primary",//按钮大小,可选值为large、small、default或者不设置size:"large",//按钮形状,可选值为circle或者不设置shape:undefined,//开启后,按钮的长度为 100%long:true,//设置button原生的type,可选值为button、submit、resethtmlType:"button",//设置按钮为禁用状态disabled:false,//设置按钮的图标类型icon:"ios-upload",//按钮文字提示innerText:"提交",//设置按钮为加载中状态loading:false })btn.loading() 让表单提交按钮进入loading状态
btn.finish() 让表单提交按钮恢复正常状态
rules 表单元素规则
hidden 隐藏字段hiddenRule:{ type:"hidden",//必填! //字段名称 field:"id", //必填! //input值 value:"14" //必填!}input 输入框inputRule :{type:"input",//必填!//label名称title:"商品名称",//必填!//字段名称field:"goods_name",//必填!//input值value:"iphone 7",props: {//输入框类型,可选值为 text、password、textarea、url、email、date"type": "text", //必填!//是否显示清空按钮"clearable":false,//设置输入框为禁用状态"disabled": false,//设置输入框为只读"readonly": false,//文本域默认行数,仅在 textarea 类型下有效"rows": 4,//自适应内容高度,仅在 textarea 类型下有效,可传入对象,如 { minRows: 2, maxRows: 6 }"autosize": false,//将用户的输入转换为 Number 类型"number": false,//自动获取焦点"autofocus": false,//原生的自动完成功能,可选值为 off 和 on"autocomplete": "off",//占位文本"placeholder": "请输入商品名称",//输入框尺寸,可选值为large、small、default或者不设置"size": "default",//原生的 spellcheck 属性"spellcheck": false,},event:{//按下回车键时触发enter:(event)=>{},//设置 icon 属性后,点击图标时触发click:(event)=>{},//数据改变时触发change:(event)=>{},//输入框聚焦时触发focus:(event)=>{},//输入框失去焦点时触发blur:(event)=>{},//原生的 keyup 事件keyup:(event)=>{},//原生的 keydown 事件keydown:(event)=>{},//原生的 keypress 事件keypress:(event)=>{},},validate:[{ required: true, message: '请输入goods_name', trigger: 'blur' },], }validate 表单验证规则,具体配置查看 : https://github.com/yiminghe/async-validator
radio 单选框radioRule :{type:"radio",//必填!//label名称title:"是否包邮",//必填!//字段名称field:"is_postage",//必填!//input值value:"0",//可选参数options:[{value:"0",label:"不包邮",disabled:false},{value:"1",label:"包邮",disabled:true},],//必填!props: {//可选值为 button 或不填,为 button 时使用按钮样式"type":undefined,//单选框的尺寸,可选值为 large、small、default 或者不设置"size":"default",//是否垂直排列,按钮样式下无效"vertical":false,},event:{//在选项状态发生改变时触发,返回当前状态。通过修改外部的数据改变时不会触发change:(...arg)=>{},},validate:[], }checkbox 复选框checkboxRule :{type:"checkbox",//必填!//label名称title:"标签",//必填!//字段名称field:"label",//必填!//input值value:["1","2","3"],//可选参数options:[{value:"1",label:"好用",disabled:true},{value:"2",label:"方便",disabled:false},{value:"3",label:"实用",disabled:false},{value:"4",label:"有效",disabled:false},],//必填!props: {//多选框组的尺寸,可选值为 large、small、default 或者不设置"size":"default",},event:{//只在单独使用时有效。在选项状态发生改变时触发,通过修改外部的数据改变时不会触发change:(...arg)=>{},},validate:[], }select 选择器selectRule :{type: "select",//必填!field: "cate_id",//必填!title: "产品分类",//必填!//input值value: ["104","105"],//可选参数options: [{"value": "104", "label": "生态蔬菜", "disabled": false},{"value": "105", "label": "新鲜水果", "disabled": false},],//必填!props: {//是否支持多选"multiple": true,//是否可以清空选项,只在单选时有效"clearable": false,//是否支持搜索"filterable": true,// 暂不支持远程搜索// "remote": false, //是否使用远程搜索// "remote-method":Function, //远程搜索的方法// "loading": false, //当前是否正在远程搜索// "loading-text": "加载中", //远程搜索中的文字提示//选择框大小,可选值为large、small、default或者不填"size":"default",//选择框默认文字"placeholder": "请选择",//当下拉列表为空时显示的内容"not-found-text": "无匹配数据",//弹窗的展开方向,可选值为 bottom 和 top"placement": "bottom",//是否禁用"disabled": false,},event:{//选中的Option变化时触发,返回 valuechange:(checked)=>{},//搜索词改变时触发'query-change':(keyword)=>{},},validate:[], }switch 开关switchRule :{type:"switch",//必填!//label名称title:"是否上架",//必填!//字段名称field:"is_show",//必填!//input值value:"1",props: {//开关的尺寸,可选值为large、small、default或者不写。建议开关如果使用了2个汉字的文字,使用 large。"size":"default",//禁用开关"disabled":false,//选中时的值,当使用类似 1 和 0 来判断是否选中时会很有用"trueValue":"1",//没有选中时的值,当使用类似 1 和 0 来判断是否选中时会很有用"falseValue":"0",},slot: {//自定义显示打开时的内容open:"上架",//自定义显示关闭时的内容close:"下架",},event:{//开关变化时触发,返回当前的状态 0 | 1change:(bool)=>{},},validate:[], }DatePicker 日期选择器DatePickerRule :{type: "DatePicker",//必填!field: "section_day",//必填!title: "活动日期",//必填!//input值, type为daterange,datetimerange value为数组 [start_value,end_value]value: ['2018-02-20', new Date()],props: {//显示类型,可选值为 date、daterange、datetime、datetimerange、year、month"type": "datetimerange",//必填!//展示的日期格式"format": "yyyy-MM-dd HH:mm:ss",//日期选择器出现的位置,可选值为toptop-starttop-endbottombottom-startbottom-endleftleft-startleft-endrightright-startright-end"placement": "bottom-start",//占位文本"placeholder":"请选择获得时间",//是否显示底部控制栏,开启后,选择完日期,选择器不会主动关闭,需用户确认后才可关闭"confirm":false,//尺寸,可选值为large、small、default或者不设置"size":"default",//是否禁用选择器"disabled":false,//是否显示清除按钮"clearable":true,//完全只读,开启后不会弹出选择器"readonly":false,//文本框是否可以输入"editable":false,},event:{//日期发生变化时触发,已经格式化后的日期,比如 2016-01-01change:(value)=>{},//弹出日历和关闭日历时触发 true | false'open-change':(bool)=>{},//在 confirm 模式或 clearable = true 时有效,在清空日期时触发clear:(...arg)=>{},},validate:[], }TimePicker 时间选择器TimePickerRule :{type: "TimePicker",//必填!field: "section_time",//必填!title: "活动时间",//必填!//input值, type为timerange value为数组 [start_value,end_value]value: [],props: {//显示类型,可选值为 time、timerange"type": "timerange", //必填!//展示的时间格式"format": "HH:mm:ss",//下拉列表的时间间隔,数组的三项分别对应小时、分钟、秒。例如设置为 [1, 15] 时,分钟会显示:00、15、30、45。"steps": [],//时间选择器出现的位置,可选值为toptop-starttop-endbottombottom-startbottom-endleftleft-startleft-endrightright-startright-end"placement": "bottom-start",//占位文本"placeholder":"请选择获得时间",//是否显示底部控制栏,开启后,选择完日期,选择器不会主动关闭,需用户确认后才可关闭"confirm":false,//尺寸,可选值为large、small、default或者不设置"size":"default",//是否禁用选择器"disabled":false,//是否显示清除按钮"clearable":true,//完全只读,开启后不会弹出选择器"readonly":false,//文本框是否可以输入"editable":false,},event:{//时间发生变化时触发 已经格式化后的时间,比如 09:41:00change:(checked)=>{},//弹出浮层和关闭浮层时触发 true | false'open-change':(bool)=>{},//在清空日期时触发clear:(...arg)=>{},},validate:[], }InputNumber 数字输入框InputNumberRule :{type: "InputNumber",//必填!field: "sort",//必填!title: "排序",//必填!//input值value: 1,props: {//最大值"max": undefined,//最小值"min": undefined,//每次改变的步伐,可以是小数"step": 1,//输入框尺寸,可选值为large、small、default或者不填"size":"default",//设置禁用状态"disabled":false,//是否设置为只读"readonly":false,//是否可编辑"editable":true,//数值精度"precision":0,},event:{//数值改变时的回调,返回当前值change:(value)=>{},//聚焦时触发focus:(event)=>{},//失焦时触发blur:(event)=>{},},validate:[], }ColorPicker 颜色选择器ColorPickerRule :{type: "ColorPicker",//必填!field: "color",//必填!title: "颜色",//必填!//input值value: '#ff7271',props: {//是否支持透明度选择"alpha": false,//是否支持色彩选择"hue": true,//是否显示推荐的颜色预设"recommend": false,//尺寸,可选值为large、small、default或者不设置"size":"default",//自定义颜色预设"colors":[],//颜色的格式,可选值为 hsl、hsv、hex、rgb,开启 alpha 时为 rgb,其它为 hex"format":"hex",},event:{//当绑定值变化时触发,返回当前值change:(color)=>{},//聚焦时触发 面板中当前显示的颜色发生改变时触发'active-change':(color)=>{},},validate:[], }Cascader 多级联动CascaderRule:{type:"cascader",//必填!title:"所在区域",//必填!field:"address",//必填!//input值value:['陕西省','西安市','新城区'],props:{//可选项的数据源,格式参照示例说明data:window.province || [],//必填!//选择后展示的函数,用于自定义显示格式renderFormat:label => label.join(' / '),//是否禁用选择器disabled:false,//是否支持清除clearable:true,//输入框占位符placeholder:'请选择',//次级菜单展开方式,可选值为 click 或 hovertrigger:'click',//当此项为 true 时,点选每级菜单选项值都会发生变化,具体见上面的示例changeOnSelect:false,//输入框大小,可选值为large和small或者不填size:undefined,//动态获取数据,数据源需标识 loadingloadData:()=>{},//是否支持搜索filterable:false,//当搜索列表为空时显示的内容notFoundText:'无匹配数据',//是否将弹层放置于 body 内,在 Tabs、带有 fixed 的 Table 列内使用时,建议添加此属性,它将不受父级样式影响,从而达到更好的效果transfer:false,},event:{//选择完成后的回调,返回值 value 即已选值 value,selectedData 为已选项的具体数据change:(value, selectedData)=>{},//展开和关闭弹窗时触发'visible-change':bool=>{}},validate:[], }Upload 上传UploadRule :{type: "Upload",//必填!field: "pic",//必填!title: "轮播图",//必填!//input值,当maxLength等与1时值为字符串,大于1时值为数组value: ['http://img1.touxiang.cn/uploads/20131030/30-075657_191.jpg','http://img1.touxiang.cn/uploads/20131030/30-075657_191.jpg'], //input值props: {//上传控件的类型,可选值为 select(点击选择),drag(支持拖拽)"type":"select", //必填!//上传文件类型,可选值为 image(图片上传),file(文件上传)"uploadType":"image", //必填!//上传的地址"action": "", //必填!//上传的文件字段名"name":"",//上传时附带的额外参数"data":{},//设置上传的请求头部"headers": {},//是否支持多选文件"multiple": true,//支持发送 cookie 凭证信息"withCredentials":false,//不支持// "showUploadList":false, //是否显示已上传文件列表// "defaultFileList":[], // 默认已上传的文件列表//接受上传的文件类型"accept":"",//支持的文件类型,与 accept 不同的是,format 是识别文件的后缀名,accept 为 input 标签原生的 accept 属性,会在选择文件时过滤,可以两者结合使用"format":[],//文件大小限制,单位 kb"maxSize":undefined,//可上传文件数量"maxLength":1,//上传文件之前的钩子,参数为上传的文件,若返回 false 或者 Promise 则停止上传"beforeUpload":()=>{},//文件上传时的钩子,返回字段为 event, file, fileList"onProgress":()=>{},//文件上传成功时的钩子,返回字段为 response, file, fileList,若需有把文件添加到文件列表中,在函数值返回即可"onSuccess":function () {return 'http://img1.touxiang.cn/uploads/20131030/30-075657_191.jpg';}, //必填!//文件上传失败时的钩子,返回字段为 error, file, fileList"onError":(error, file, fileList)=>{},//点击已上传的文件链接时的钩子,返回字段为 file, 可以通过 file.response 拿到服务端返回数据"onPreview":()=>{},//文件列表移除文件时的钩子,返回字段为 file, fileList"onRemove":()=>{},//文件格式验证失败时的钩子,返回字段为 file, fileList"onFormatError":()=>{},//文件超出指定大小限制时的钩子,返回字段为 file, fileList"onExceededSize":()=>{},//辅助操作按钮的图标 ,设置为false将不显示handleIcon:'ionic',//点击辅助操作按钮事件onHandle:(src)=>{},//是否可删除,设置为false是不显示删除按钮allowRemove:true,}, }accept 文件类型: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#attr-accept
全局配置 createOptions{ //插入节点,默认document.body el:null, //form配置 form:{//是否开启行内表单模式inline:false,//表单域标签的位置,可选值为 left、right、toplabelPosition:'right',//表单域标签的宽度,所有的 FormItem 都会继承 Form 组件的 label-width 的值labelWidth:125,//是否显示校验错误信息showMessage:true,//原生的 autocomplete 属性,可选值为 off 或 onautocomplete:'off', }, //文件上传全局配置 upload:{//上传文件之前的钩子,参数为上传的文件,若返回 false 或者 Promise 则停止上传beforeUpload:()=>{},//文件上传时的钩子,返回字段为 event, file, fileListonProgress:(event, file, fileList)=>{},//文件上传成功时的钩子,返回字段为 response, file, fileList,若需有把文件添加到文件列表中,在函数值返回即可onSuccess:(response, file, fileList)=>{// return 'filePath';},//文件上传失败时的钩子,返回字段为 error, file, fileListonError:(error, file, fileList)=>{},//点击已上传的文件链接时的钩子,返回字段为 file, 可以通过 file.response 拿到服务端返回数据onPreview:(file)=>{},//文件列表移除文件时的钩子,返回字段为 file, fileListonRemove:(file, fileList)=>{},//文件格式验证失败时的钩子,返回字段为 file, fileListonFormatError:(file, fileList)=>{},//文件超出指定大小限制时的钩子,返回字段为 file, fileListonExceededSize:(file, fileList)=>{},//辅助操作按钮的图标 ,设置为false将不显示handleIcon:'ios-eye-outline',//点击辅助操作按钮事件onHandle:(src)=>{},//是否可删除,设置为false是不显示删除按钮allowRemove:true, }, //表单提交事件 onSubmit:(formData)=>{}, //提交按钮配置,设置为false时不显示按钮 submitBtn:{//按钮类型,可选值为primary、ghost、dashed、text、info、success、warning、error或者不设置type:"primary",//按钮大小,可选值为large、small、default或者不设置size:"large",//按钮形状,可选值为circle或者不设置shape:undefined,//开启后,按钮的长度为 100%long:true,//设置button原生的type,可选值为button、submit、resethtmlType:"button",//设置按钮为禁用状态disabled:false,//设置按钮的图标类型icon:"ios-upload",//按钮文字提示innerText:"提交",//设置按钮为加载中状态loading:false, }}相信看了本文案例你已经掌握了方法,更多精彩请关注小潘博客其它相关文章!
推荐阅读:
怎样使用Vue操作DIV
利用Node.js进行文件编码格式转换以上就是VUE做出带有数据收集、校验和提交功能表单的详细内容,更多请关注小潘博客其它相关文章!