From a80f1bc960efc94e3f375bc881aa4c495042c10c Mon Sep 17 00:00:00 2001
From: Tevin <tingquanren@163.com>
Date: Fri, 17 Nov 2023 16:52:58 +0800
Subject: [PATCH] 首页导航组件显示微调

---
 forms/form/CForm.vue |  106 +++++++++++++++++++++++++++++++++++++++++++++++++---
 1 files changed, 99 insertions(+), 7 deletions(-)

diff --git a/forms/form/CForm.vue b/forms/form/CForm.vue
index e50dd75..b968cce 100644
--- a/forms/form/CForm.vue
+++ b/forms/form/CForm.vue
@@ -1,26 +1,59 @@
 /**
- * CForm
+ * CForm - 表单套装组件,套件的主体
  * @author Tevin
  */
 
 <template>
-    <form
-        class="c-form"
-        @submit="evt=>handleSubmit()"
+    <view
+        :class="'c-form-outer ' + (autoScrollToError==='on'?'auto-scroll':'')"
+        ref="formOuter"
     >
-        <slot :formRes="formRes" />
-    </form>
+        <form
+            class="c-form"
+            v-if="autoScrollToError==='off'"
+            @submit="evt=>handleSubmit()"
+        >
+            <slot :formRes="formRes" />
+        </form>
+        <scroll-view
+            class="c-form-scroller"
+            v-else-if="autoScrollToError==='on'"
+            :scrollY="true"
+            :scroll-top="scrollTop"
+            :scroll-with-animation="true"
+            @scroll="evt => handleScroll(evt)"
+        >
+            <form
+                class="c-form"
+                @submit="evt=>handleSubmit()"
+            >
+                <slot :formRes="formRes" />
+            </form>
+        </scroll-view>
+    </view>
 </template>
 
 <script>
 import Taro from '@tarojs/taro';
+import { $ } from '@tarojs/extend';
 import './cForm.scss';
 
 export default {
     name: 'CForm',
     props: {
+        // 表单数据主体
         formData: Object,
+        // 是否自动滚动到错误位置,on/off
+        autoScrollToError: {
+            type: String,
+            default: 'off',
+        },
+        // 表单项变化的回调
+        //   回调传参只有单项数据
         onChange: Function,
+        // 表单完成的回调
+        //   提交且通过表单验证后调用,不通过验证不调用
+        //   回调传参包含整个表单数据
         onFinish: Function,
     },
     data() {
@@ -29,9 +62,14 @@
                 formData: this.formData,
             },
             validators: {},
+            scrollTop: 0,
+            offsetTop: 0,
         };
     },
     methods: {
+        handleScroll(evt) {
+            this.scrollTop = evt.target.scrollTop;
+        },
         handleSubmit() {
             const checklist = [];
             // 所有项验证
@@ -45,6 +83,9 @@
                 for (let validation of validations) {
                     // 第一个不通过项提示
                     if (!validation.passed) {
+                        if (this.autoScrollToError === 'on') {
+                            this.scrollTop = validation.offset.top - this.offsetTop;
+                        }
                         Taro.showToast({
                             title: validation.msg,
                             icon: 'none',
@@ -58,7 +99,12 @@
                 this.onFinish && this.onFinish();
             });
         },
-        preCheckValidators(keys, callback) {
+        // 手工提交
+        $submit() {
+            this.handleSubmit();
+        },
+        // 提前验证指定项
+        $preVerify(keys, callback) {
             const checklist = [];
             // 从选定的项中验证
             keys.forEach(key => {
@@ -71,6 +117,9 @@
                 for (let validation of validations) {
                     // 第一个不通过项提示
                     if (!validation.passed) {
+                        if (this.autoScrollToError === 'on') {
+                            this.scrollTop = validation.offset.top - this.offsetTop;
+                        }
                         Taro.showToast({
                             title: validation.msg,
                             icon: 'none',
@@ -85,6 +134,39 @@
                 // 所有检查通过
                 callback && callback(true);
             });
+        },
+        // 直接设定错误
+        $setErrors(errors) {
+            const checklist = [];
+            Object.keys(errors).forEach(errorKey => {
+                if (typeof this.validators[errorKey] !== 'undefined') {
+                    checklist.push(
+                        this.validators[errorKey]('setError', errors[errorKey])
+                    );
+                }
+            });
+            Promise.all(checklist).then(validations => {
+                for (let validation of validations) {
+                    // 第一个不通过项提示
+                    if (!validation.passed) {
+                        if (this.autoScrollToError === 'on') {
+                            this.scrollTop = validation.offset.top - this.offsetTop;
+                        }
+                        Taro.showToast({
+                            title: validation.msg,
+                            icon: 'none',
+                            mask: false,
+                            duration: 2000,
+                        });
+                        return;
+                    }
+                }
+            });
+        },
+        $setScrollTop(top) {
+            if (this.autoScrollToError === 'on') {
+                this.scrollTop = top;
+            }
         },
     },
     mounted() {
@@ -104,6 +186,16 @@
         this.formRes.$regItemValidator = (name, cb) => {
             this.validators[name] = cb;
         };
+        // 表单滚动偏移
+        if (this.autoScrollToError === 'on') {
+            setTimeout(() => {
+                $(this.$refs.formOuter)
+                    .offset()
+                    .then(offset => {
+                        this.offsetTop = offset.top + 10;
+                    });
+            }, 10);
+        }
     },
     beforeDestroy() {
         this.validators = {};

--
Gitblit v1.9.1