From c1a17bdec32d3e90a119104c775886656bb08503 Mon Sep 17 00:00:00 2001
From: Tevin <tingquanren@163.com>
Date: Sat, 23 Jul 2022 18:47:18 +0800
Subject: [PATCH] Merge branch 'temp'
---
forms/form/CFormItem.vue | 97 +++++++++++++++++++++++++++++-------------------
1 files changed, 58 insertions(+), 39 deletions(-)
diff --git a/forms/form/CFormItem.vue b/forms/form/CFormItem.vue
index ffbf570..f9fe496 100644
--- a/forms/form/CFormItem.vue
+++ b/forms/form/CFormItem.vue
@@ -1,12 +1,12 @@
/**
- * CFormItem
+ * CFormItem - 表单套装组件，单项包囊器
* @author Tevin
* @tutorial rules see https://github.com/yiminghe/async-validator#type
*/
<template>
<view class="c-form-item">
- <slot :itemData="itemData" />
+ <slot :itemRes="itemRes" />
</view>
</template>
@@ -17,11 +17,28 @@
export default {
name: 'CFormItem',
props: {
+ // 表单数据资源（表单组件内部机制专用）
+ formRes: Object,
+ // 表单项字段键名
name: String,
+ // 表单项中文名
label: String,
+ // 表单项验证规则之是否必填
required: Boolean,
+ // 表单项验证规则之复合规则
+ // 例如：[{type:'string', min: 2, max: 100}]
+ // 常用项：
+ // type string 类型，常见有 string、number、boolean、array、object、url、email
+ // len number string 类型时为字符串长度；number 类型时为确定数字； array 类型时为数组长度
+ // max number 必须设置 type：string 类型为字符串最大长度；number 类型时为最大值；array 类型时为数组最大长度
+ // min number 必须设置 type：string 类型为字符串最小长度；number 类型时为最小值；array 类型时为数组最小长度
+ // pattern RegExp 正则表达式匹配
+ // required boolean 是否为必选字段
+ // transform (value) => any 将字段值转换成目标值后进行校验
+ // message string 错误信息，不设置时会通过模板自动生成
rules: Array,
- formData: Object,
+ // 表单是否禁用
+ disabled: Boolean,
},
data() {
return {
@@ -29,14 +46,15 @@
};
},
computed: {
- itemData() {
+ itemRes() {
return {
- formData: this.formData,
+ formData: this.formRes.formData,
name: this.name,
label: this.label,
required: this.isRequired,
+ disabled: this.disabled,
error: this.error,
- onChange: (evt) => this.onChange(evt),
+ onChange: evt => this.onChange(evt),
};
},
isRequired() {
@@ -66,52 +84,51 @@
!hasOwn.call(evt, 'constructor') &&
!hasOwn.call(evt.constructor.prototype, 'isPrototypeOf')
) {
- throw new Error('错误的表单项 onChange 参数类型！（At: ' + this.name + '）');
- return;
+ throw new Error(
+ '错误的表单项 onChange 参数类型！（At: ' + this.name + '）'
+ );
}
}
// 未改变值不触发
- if (this.formData[this.name] === evt) {
+ if (this.formRes.formData[this.name] === evt) {
return;
}
- this.formData.$handleChange({
+ this.formRes.$handleChange({
[this.name]: evt,
});
},
},
mounted() {
this.$nextTick(() => {
- // 未设置验证
- if (!this.required && !this.rules) {
- this.formData.$regItemValidator(this.name, () => {
+ let errTimer = null;
+ // 注册验证
+ this.formRes.$regItemValidator(this.name, validateType => {
+ // 未设置验证
+ if (!this.required && !this.rules) {
this.error = false;
return Promise.resolve({
name: this.name,
passed: true,
});
- });
- } else {
- // 验证规则
- const descriptor = this.rules || [];
- if (this.required) {
- descriptor.unshift({
- required: true,
+ } else {
+ // 验证规则
+ const descriptor = this.rules || [];
+ if (this.required) {
+ descriptor.unshift({
+ required: true,
+ });
+ }
+ const validator = new Schema({
+ [this.name]: descriptor,
});
- }
- const validator = new Schema({
- [this.name]: descriptor,
- });
- // 汉化通用验证消息
- validator.messages(validateMsgs);
- // 注册验证
- let errTimer = null;
- this.formData.$regItemValidator(this.name, () => {
+ // 汉化通用验证消息
+ validator.messages(validateMsgs);
return validator
.validate({
- [this.name]: this.formData[this.name],
+ [this.name]: this.formRes.formData[this.name],
})
.then(
- (res) => {
+ res => {
this.error = false;
return {
name: this.name,
@@ -119,11 +136,13 @@
};
},
({ errors, fields }) => {
- this.error = true;
- clearTimeout(errTimer);
- errTimer = setTimeout(() => {
- this.error = false;
- }, 5000);
+ if (validateType !== 'msgOnly') {
+ this.error = true;
+ clearTimeout(errTimer);
+ errTimer = setTimeout(() => {
+ this.error = false;
+ }, 5000);
+ }
return {
name: this.name,
passed: false,
@@ -134,12 +153,12 @@
};
}
);
- });
- }
+ }
+ });
});
},
beforeDestroy() {
- this.formData.$regItemValidator(this.name, null);
+ this.formRes.$regItemValidator(this.name, null);
},
};
</script>
\ No newline at end of file
--
Gitblit v1.9.1