From 039cd582e2bb49af7b3ad126c49ef988b7d8853f Mon Sep 17 00:00:00 2001
From: Tevin <tingquanren@163.com>
Date: Wed, 18 Oct 2023 16:27:11 +0800
Subject: [PATCH] 页面结构组件,支持手动滚动

---
 forms/form/CFormItem.vue |   79 +++++++++++++++++++++++++--------------
 1 files changed, 51 insertions(+), 28 deletions(-)

diff --git a/forms/form/CFormItem.vue b/forms/form/CFormItem.vue
index 6a2fbdf..1187f85 100644
--- a/forms/form/CFormItem.vue
+++ b/forms/form/CFormItem.vue
@@ -1,5 +1,5 @@
 /**
- * CFormItem
+ * CFormItem - 表单套装组件,单项包囊器
  * @author Tevin
  * @tutorial rules see https://github.com/yiminghe/async-validator#type
  */
@@ -17,15 +17,33 @@
 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 +53,7 @@
                 name: this.name,
                 label: this.label,
                 required: this.isRequired,
+                disabled: this.disabled,
                 error: this.error,
                 onChange: evt => this.onChange(evt),
             };
@@ -79,34 +98,38 @@
                 [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 => {
+                // 未设置验证
+                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.formRes.$regItemValidator(this.name, validateType => {
+                    // 汉化通用验证消息
+                    validator.messages(validateMsgs);
                     return validator
                         .validate({
                             [this.name]: this.formRes.formData[this.name],
@@ -122,8 +145,8 @@
                             ({ errors, fields }) => {
                                 if (validateType !== 'msgOnly') {
                                     this.error = true;
-                                    clearTimeout(errTimer);
-                                    errTimer = setTimeout(() => {
+                                    clearTimeout(this.errTimer);
+                                    this.errTimer = setTimeout(() => {
                                         this.error = false;
                                     }, 5000);
                                 }
@@ -137,8 +160,8 @@
                                 };
                             }
                         );
-                });
-            }
+                }
+            });
         });
     },
     beforeDestroy() {

--
Gitblit v1.9.1