Element UI为了遵守W3C规范特意设置的,就是当Form中只有一个Input的时候,Form把这个事件当成了是提交表单的操作,所以页面会刷新。
解决方法:
凡是<el-form>里面只有一个Input,就在<el-form>上附加一个事件:@submit.native.prevent
,这样可以阻止默认提交,可以解决这个问题。
可以使用这几种约束方法:
一些场景下,比如编辑人员录入一篇文章,早就规定了标题不允许使用叹号,编辑也明白这个规定,他只是从别的地方复制标题,恰好标题带叹号,那么,正则替换可以帮助编辑直接把叹号去掉。比如:
@input="form.title = form.title.replace(/[!!]/g,'')"
这就要比提示“标题禁止出现叹号”要好。
同样的,约束一个输入框只允许输入数字和小数点,也可以用这种方法。
记住:
不要用这种方法去执行超出常识的约束和有负面作用的约束,因为不见得使用者会注意到程序的自动替换,或许会造成使用者困扰甚至造成事故。
maxlength
、minlength
这2个属性可以用来约束字符长度,可用于type="text"
和type="textarea"
,但是对于别的type它一般无能为力,比如改成type="number"
就不起作用。
注意,minlength
在Element UI中其实是无效的,至少经过我测试,minlength
+ rules设为必填 + this.$refs["form"].validate()
是无效的,无法报错。minlength
其实在原生Form中才会有效。
长度控制可以设置比如某个网络游戏昵称(最多6位)……等。
事实上,我maxlength
并不建议用于控制手机号输入,尽管国内手机号一定是11位,但是用rules控制会更好一些,因为总有人无意输入了12个数字,你粗暴的阻止最后一位的输入也可能会造成困扰。
真的想控制长度,最佳实践是使用rules,因为控制数值长度是不常见的约束,无论是用正则替换还是用阻止输入,都可能让使用者困扰或者不留意,最终形成事故。
记住:
同样的,不要用这种方法去执行超出常识的约束和有负面作用的约束,因为不见得使用者会注意到输入被截断,比如你设置maxlength="10"
,一个使用者飞速地敲了11位字符,他根本没注意最后一个字符是没有成功输入的,也会造成使用者困扰甚至造成事故。
max
、min
一般跟step
联合使用,但是它不具有约束性,只要你愿意,你可以敲出高于max的数值,所以尽量别用max
、min
。
官方文档:https://element.eleme.cn/#/zh-CN/component/form
基于async-validator:https://github.com/yiminghe/async-validator
比如,手机号必须11位,写法是:
formRules: {
ownerPhone: [
{ required: true, message: "手机号不能为空", trigger: "blur" },
{ len: 11, message: "手机号应为11位", trigger: "blur" }
],
}
很简单,让<el-form-item>里面继续嵌套<el-form-item>即可,外层<el-form-item>只负责写label,不写prop,内层的<el-form-item>不写label,写prop。
验证提示会显示在每个内层<el-form-item>的下方。
比如有2个输入框,前者如果是后者的2倍则通过。
现在我前面填写了10,后面填写6,验证出错,这时候后者报红字错误。我发现是前者写错了,改成了12,这样符合了要求,但是后者的红字错误不会消失,怎么办?
只能手动清除某个输入框的报错,做法是:
给<el-form-item>
设ref
,值可以是字段名。
在validator末尾写上this.$refs.xxx.clearValidate()
即可。
首先,给v-model
加上.number
。
然后,服务器返回的字段,必须转换为数字再复制给form。
当一个表单快写完了,就该写rules
,但是这玩意写起来很烦,内容大部分一样,但是键名都各有区别,比如:
rules: {
isOwner: [
{ required: true, message: "是否户主不能为空", trigger: "blur" }
],
phoneNumber: [
{ required: true, message: "联系电话不能为空", trigger: "blur" },
{ len: 11, message: "手机号应为11位", trigger: "blur" }
],
},
大部分都是xxx不能为空
这类话。有没有快捷生成办法?
我本来打算写一个工具来专门生成,后来觉得没必要,因为没办法特别的智能,所以简单生成一下,然后再做加工就好了。
方案:
@/utils/genCode.js
,写入:module.exports = {
rules: function (form) {
let rules = {};
for (let key in form) {
if (Array.isArray(form[key])) {
rules[key] = [{ required: true, message: "不能为空", trigger: "blur", type: 'array' }];
} else {
rules[key] = [{ required: true, message: "不能为空", trigger: "blur" }];
}
}
console.log(JSON.stringify(rules, null, 2).replace(/"(.+?)":/g, '$1:').replace(/"/g, "'"));
},
};
if (process.env.NODE_ENV === 'development') {
Object.defineProperty(Vue.prototype, '$genCode', { value: require('@/utils/genCode') });
}
使用:
this.$genCode.rules(this.form);
return;
在浏览器里把必填的字段都填上随意字符,不必填的字段如果你不想设rule,可以不填。
点击提交按钮,会打印出来一片代码,将代码贴到编辑器,然后进一步修改即可。
用完删掉this.$genCode.rules(this.form);return;
这2行就完事。
首先问自己懒不懒,如果懒,可以直接给data.form
赋值为{}
,只要Form中没有Checkbox-Group就行,因为Checkbox-Group初始化的时候就要读取data.form
中的属性,而且必须是数组,所以{}
这种空对象会报错。Element UI剩下的所有组件都没问题,哪怕是级联选择器这种value一定是数组的组件,也不会报错。
如果你比较勤快,希望代码正规一点,可以模仿上一道题的方法。
第一步,看Form里有没有Checkbox-Group,有的话将它的属性先写好,比如现在是:
form: {
xxcheckboxList: [],
}
第二步,创建@/utils/genCode.js,写入:
module.exports = {
form: function (form) {
let data = {};
for (let key in form) {
if (Array.isArray(form[key])) {
data[key] = [];
} else if (typeof form[key] === 'string') {
data[key] = '';
} else if (typeof form[key] === 'boolean') {
data[key] = form[key];
}
}
console.log(JSON.stringify(data, null, 2).replace(/"(.+?)":/g, '$1:').replace(/"/g, "'"));
},
};
第三步,在main.js写入代码,跟上题内容一样。
第四步,在提交按钮事件最顶部加上这2行代码:
this.$genCode.rules(this.form);
return;
第五步,必填不必填的字段一律填,然后点击提交按钮,剩下的不说了。用完别忘记注释掉。
Form的resetFields方法的用法是this.$refs[refName].resetFields();
,这个方法做的事就是将表单的某些数据(为什么说是“某些”请继续看)重置为初始值(即data
加载的时候form
的值),重置过程大致是:
先找Form身上设置的model
,也就是表单数据对象
,比如叫form
。
再找Form里的各个<el-form-item>
,看它身上的prop
,比如payName
:
<el-form-item label="XX设置" prop="payName">
<el-input
v-model="form.payName"
/>
</el-form-item>
然后将payName
对应的form.payName
设为data里的form
初始化的时候的值,初始化的时候没有这个属性的话,则重置为undefined
或者[null]
。依次处理每个<el-form-item>
。如果某个<el-form-item>
没有prop
,那么也不会有属性被重置。
看到了吗?
没有被prop
的属性,resetFields
就管不到,不会对其做任何操作。
v-model="form.payName"
跟resetFields
完全没关系!
可以重置为空对象:this.form = {}
;或者重置为this.form = {xx: []}
这种带属性的对象。
两种方案的对比如下:
resetFields方案 | 手动重赋值方案 | |
---|---|---|
依赖$ref | 依赖 | 不依赖 |
方案执行时机 | Form元素必须渲染才能执行,也就是说$refs必须能取到值 | 可以在Dialog任何周期钩子里执行重赋值,也可以在触发弹出Dialog的函数里执行(通常用这种方案) |
必须有prop="属性名" | 必须 | 不必 |
this.form 初始值 | 只在data 的form 里设置 | 在form 和重赋值语句中都要设置 |
可见:resetFields方案的顾虑多,重赋值方案的顾虑少(但不是没有顾虑),只需要关注重赋值初始值即可,但假如初始值有属性,却无脑重赋值成了{}
也会出事故。
假设有个搜索查询表单,初始值是:
queryParams: {
pageNum: 1,
pageSize: 10,
},
有一个选填的Select,我选择了一个值,也就是form.a
设为1
,然后Select的change事件函数根据这个值计算出了另一个值form.b
,比如是乘以100的关系,于是form.b
得到100
,然后,我点击了提交,服务器要的是form.b
而不是form.a
,100
被成功提交,到目前没啥问题。
接着,我点击“重置”按钮,此时用resetFields
来重置表单,其结果是:
form.a
被重置为undefined
,因为Select设置了prop="a"
。
form.b
没任何变化,因为没有哪个prop
设置为b
,所以form.b
此时还是100
现在,表面上看,表单都被重置,Select的值也是空,但是,form.b
的值依然没有变,是100
。紧接着,重置按钮进行下一步操作,也就是根据queryParams
重新请求数据,此时queryParams
是这样:
queryParams: {
pageNum: 1,
pageSize: 10,
b: 100,
},
到此,问题出现:我本意是重置所有搜索条件,但是b
并没有被重置,查询结果也一定是错的。
解决方案:
其实这事解决起来很容易,我列出3种方案,你可以选择一种你认为最无脑、最不容易出错的方案。
方案1:queryParams
初始值加入b: null
。
方案2:取消change
事件监听,改为submit的时候才计算所有的b
,但是要注意,不要给queryParams.b
赋值,不然又成了无法resetFields,应该单设变量b
,参数传(...queryParams, b)
。
方案3:直接不用resetFields,改为手动重赋值为初始值。
我个人推荐方案1或方案3,理由是:
方案1是只要哪个属性没在prop
就一律写到初始值,比较无脑,但可能会忘了写。
方案2将计算放到提交事件里,注意事项比较多,也要用到解构赋值,也不利于封装统一的提交函数。
方案3手动赋值,好处是初始值不用考虑b
,重赋值也不用考虑b
,重赋值无脑保持跟初始值一样即可。如果初始值是空对象,那就更好了,无脑重赋值为空对象就行了。
我们用:value=""
给Option指定输出的value值,但如果想一次性给form的多个属性赋值,该怎么办呢?比如又要传递userId,又要传递nickName,怎么办呢?(这里我假设你已经知道nickName有可能不会被重置的风险以及解决办法。)可以这样写@change
:
<el-form-item label="人员" prop="userId">
<el-select v-model="form.userId" placeholder="请选择人员"
clearable
:style="{width: '100%'}"
@change="form.nickName = personList.find(v=>$event===v.userId).nickName"
>
<el-option v-for="(item, index) in personList" :key="index"
:label="item.nickName"
:value="item.userId"
></el-option>
</el-select>
</el-form-item>
其中$event
指向Select的值,也就是form.userId
。
当然,如果后端除了userId
和nickName
,还要其他值,那么我建议写一个事件函数比较清晰。
这要比上个问题好解决,值是数组的话,可以在@change
里直接解构赋值,这样就拆成了form的2个属性。(这里我假设你已经知道startTime、endTime有可能不会被重置的风险以及解决办法。)
<el-time-picker
is-range
v-model="form.range"
range-separator="至"
start-placeholder="开始时间"
end-placeholder="结束时间"
placeholder="选择时间范围"
@change="[form.startTime, form.endTime] = $event"
>
</el-time-picker>
那么,上一个问题(《Select要给form的多个属性赋值,如何写代码?》),为啥我们不把Select的值直接设为item
,然后把item
解构呢?
因为下面这种写法,在编辑器里是报错的,原因是form.nickName
不能是这种表达式,必须只能是变量名。
@change="{nickName: form.nickName} = $event" // 非法写法
还有人会问,写成@change="form.nickName = $event.nickName"
不就行了么?
确实,写法是没错,但是用法有悖论。
一、value是item
对象,意味着服务器可以收到这个对象,为什么还要拆分呢?
二、如果说,后端不喜欢处理对象,就喜欢拆分传送,那么,你不仅要写form.nickName = $event.nickName
,你还要写form.userId = $event.userId
,等于要写2行语句,这种情况下就应该专门定义方法了,并不省事,对不对?
三、当你不是新建表单,而是编辑表单的时候,你就要给Select的Option的value传递对象,以便Select能在UI上正确显示当前值。这时候,你就要找后端给你返这个现成的对象,或者自己拼出这个对象,不然,Select是不会显示当前值的。并不省事,对不对?
最后提醒一句,绑定对象类型的话,官方说:
如果 Select 的绑定值为对象类型,请务必指定 value-key 作为它的唯一性标识。
所谓“动态表单”,有2种解释,一种是根据data动态生成输入框,一种是在模板写死代码,用v-show
来控制输入框。今天说后一种。
v-show
来控制输入框的前提下,提交的时候应当判断到底提交哪些字段,有些字段就应该不提交。比如:
let params;
if (['0','1','2'].includes(this.form.deptType)) { // 部门类型为0/1/2时
const { lng, lat, ...rest } = this.form; // 忽略经纬度
params = rest;
} else if (this.form.deptType === '3') { // 部门类型为3时
params = this.form; // 全要
} else if (this.form.deptType === '4') { // 部门类型为4时
const { deptAddress, deptDesc, lng, lat, ...rest } = this.form; // 忽略地址、描述、经纬度
params = rest;
}
// 接下来提交params即可。
比如,某些前提下a字段不必填,另一些前提下a字段必填,怎么办?
rules要把字段写全,即使有些字段的required
为false
。总之按照默认状态设置true
或false
,但字段一定要写进去。
在触发动态变化的事件里修改rules
@change="onChangeDeptType"
onChangeDeptType(value) {
if (['0','1','2'].includes(this.form.deptType)) {
this.rules.lat[0].required = false;
this.rules.lng[0].required = false;
this.rules.deptAddress[0].required = true;
this.rules.deptDesc[0].required = true;
} else if (this.form.deptType === '3') {
this.rules.lat[0].required = true;
this.rules.lng[0].required = true;
this.rules.deptAddress[0].required = true;
this.rules.deptDesc[0].required = true;
} else if (this.form.deptType === '4') {
this.rules.lat[0].required = false;
this.rules.lng[0].required = false;
this.rules.deptAddress[0].required = false;
this.rules.deptDesc[0].required = false;
}
}
我们在别的UI框架中可能见过这样的问号注释,鼠标悬停能弹出气泡内容:
image.png
但官方手册并没有介绍这种用法,只是说,可以在Input里插入图标。今天我就来变相实现输入框的问号注释。
<el-input v-model="form.nickName" placeholder="请输入昵称">
<el-popover
slot="suffix"
placement="top"
title="标题"
width="200"
trigger="hover"
content="这是一段内容,这是一段内容,这是一段内容,这是一段内容。">
<i slot="reference" class="el-icon-question color-000"></i>
</el-popover>
</el-input>
官方手册是插入了一个问号Icon,但是今天我们不但是要插入Icon,还要鼠标悬停能弹出气泡,所以我插入了一个Popover。
Popover里面又插入了一个Icon,是问号图标。这样就OK了。
如果觉得图标颜色不明显,可以设个色值,比如color-000
是我自定义的color: #000;
,你可以随意改。
最后是这样子:
image.png
另外,你可能在有些网站看到的图标是叹号,我认为叹号和问号的区别在于:
当用户很大概率不知道怎么填内容的时候,用问号。
当用户确定知道怎么填,只是想看更多的注释的时候,甚至是起警告作用的时候,用叹号。
比如Input组件的值是form.a
,由它计算出一个form.b
是服务器需要的值,但是服务器不需要form.a
,你的一个做法是把a和b都传上去,但是可能后端程序员会不高兴,因为无用字段多了他会烦,对前端程序员也不太好,因为参数当然是越少越好。
你可以使用剩余操作符来赋值:
const {a, ...restParams} = this.form;
postXXX(restParams).then(response => {
// ...
})
这样的话,form.a
就被排除了,也不会被上传了,并且不会影响form
的数据。
但是,这并不是最佳实践!最佳实践是将临时属性加一个私有标记,比如_a
,也就是前置下划线,发送的时候用axios的拦截器统一拦截,过滤掉它。
所以上例Input组件的值改为form._a
,而form.b
不动。
怎么过滤form._a
,只上传form.b
?
在axios的请求拦截器里过滤,凡是属性以_
为首字符的,就不要发送。
service.interceptors.request.use(
config => {
if (config.params && Object.keys(config.params).some(v => v[0] === '_')) {
let newParams = {};
for (let key in config.params) {
if (key[0] !== '_') {
newParams[key] = config.params[key];
}
}
config.params = newParams;
}
if (config.data && Object.keys(config.data).some(v => v[0] === '_')) {
let newData = {};
for (let key in config.data) {
if (key[0] !== '_') {
newData[key] = config.data[key];
}
}
config.data = newData;
}
return config
},
error => {
Promise.reject(error)
}
)