From 0dc0b818c2e88ee54dc2c0db0a2aab1436a7b476 Mon Sep 17 00:00:00 2001
From: Tevin <tingquanren@163.com>
Date: Tue, 02 Jul 2024 10:48:10 +0800
Subject: [PATCH] 优化单选式开关在h5页面上的表现
---
forms/form/CFormItem.vue | 160 ++++++++++++++++++++++++++++++++++------------------
1 files changed, 104 insertions(+), 56 deletions(-)
diff --git a/forms/form/CFormItem.vue b/forms/form/CFormItem.vue
index 6a2fbdf..a47639f 100644
--- a/forms/form/CFormItem.vue
+++ b/forms/form/CFormItem.vue
@@ -1,31 +1,53 @@
/**
- * CFormItem
+ * CFormItem - 表单套装组件，单项包囊器
* @author Tevin
* @tutorial rules see https://github.com/yiminghe/async-validator#type
*/
<template>
- <view class="c-form-item">
+ <view
+ class="c-form-item"
+ ref="formItem"
+ >
<slot :itemRes="itemRes" />
</view>
</template>
<script>
+import { $ } from '@tarojs/extend';
import Schema from 'async-validator';
import { validateMsgs } from './validateMsgs.js';
export default {
name: 'CFormItem',
props: {
- name: String,
- label: String,
- required: Boolean,
- rules: Array,
+ // 表单数据资源（表单组件内部机制专用）
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,
+ // 表单是否禁用
+ disabled: Boolean,
},
data() {
return {
error: false,
+ errTimer: -1,
};
},
computed: {
@@ -35,6 +57,7 @@
name: this.name,
label: this.label,
required: this.isRequired,
+ disabled: this.disabled,
error: this.error,
onChange: evt => this.onChange(evt),
};
@@ -79,66 +102,91 @@
[this.name]: evt,
});
},
+ $setError() {
+ this.error = true;
+ clearTimeout(this.errTimer);
+ this.errTimer = setTimeout(() => {
+ this.error = false;
+ }, 5000);
+ },
},
mounted() {
this.$nextTick(() => {
- // 未设置验证
- if (!this.required && !this.rules) {
- this.formRes.$regItemValidator(this.name, validateType => {
+ // 注册验证
+ this.formRes.$regItemValidator(this.name, (validateType, errMsg) => {
+ // 直接设定错误
+ if (validateType === 'setError') {
+ this.$setError();
+ return new Promise((resolve, reject) => {
+ $(this.$refs.formItem)
+ .offset()
+ .then(offset => {
+ resolve({
+ name: this.name,
+ passed: false,
+ msg: errMsg,
+ offset,
+ });
+ });
+ });
+ }
+ // 未设置验证
+ else 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,
+ });
+ // 汉化通用验证消息
+ validator.messages(validateMsgs);
+ return new Promise((resolve, reject) => {
+ validator
+ .validate({
+ [this.name]: this.formRes.formData[this.name],
+ })
+ .then(
+ res => {
+ this.error = false;
+ resolve({
+ name: this.name,
+ passed: true,
+ });
+ },
+ ({ errors, fields }) => {
+ if (validateType !== 'msgOnly') {
+ this.$setError();
+ }
+ $(this.$refs.formItem)
+ .offset()
+ .then(offset => {
+ resolve({
+ name: this.name,
+ passed: false,
+ msg: errors[0].message.replace(
+ this.name,
+ this.label || this.name
+ ),
+ offset,
+ });
+ });
+ }
+ );
});
}
- const validator = new Schema({
- [this.name]: descriptor,
- });
- // 汉化通用验证消息
- validator.messages(validateMsgs);
- // 注册验证
- let errTimer = null;
- this.formRes.$regItemValidator(this.name, validateType => {
- return validator
- .validate({
- [this.name]: this.formRes.formData[this.name],
- })
- .then(
- res => {
- this.error = false;
- return {
- name: this.name,
- passed: true,
- };
- },
- ({ errors, fields }) => {
- if (validateType !== 'msgOnly') {
- this.error = true;
- clearTimeout(errTimer);
- errTimer = setTimeout(() => {
- this.error = false;
- }, 5000);
- }
- return {
- name: this.name,
- passed: false,
- msg: errors[0].message.replace(
- this.name,
- this.label || this.name
- ),
- };
- }
- );
- });
- }
+ });
});
},
beforeDestroy() {
--
Gitblit v1.9.1