Vue3父子組件表單滾動到校驗錯誤的位置實現(xiàn)過程

更新時間：2025年07月30日 09:00:38 作者：滿

文章介紹了如何在包含父表單和多個子表單的場景中,通過滾動方法實現(xiàn)提交時的校驗機制,確保數(shù)據(jù)完整性與用戶操作體驗

Vue3父子組件表單滾動到校驗錯誤的位置

表單包括父表單、多個子表單

<div class="scollContainer">
    <div class="container">
      <ProjectInfo ref="projectInfoRef" v-model="formData" :form-rules="rules"></ProjectInfo>
     
      <div class="content" style="position: relative">
        <group-title>子債信息</group-title>
        <div v-if="!detailFlag" style="position: absolute; top: 8px; right: 10px">
          <el-button type="primary" @click="addChildBond">添加</el-button>
          <el-button v-if="formData.mdmDcmSubStructurizeInfoList.length > 1" @click="delChildBond"
            >刪除</el-button
          >
        </div>
        <div>
          <group-title>子債信息</group-title>
          <childBondInfo
            v-for="(item, index) in formData.mdmDcmSubStructurizeInfoList"
            :ref="setChildRef"
            :key="index"
            v-model="formData.mdmDcmSubStructurizeInfoList[index]"
            :form-rules="rules"
            :index="index"
            :is-involve-clause="formData.isInvolveInvestorProtectionClause"
          ></childBondInfo>
        </div>
      </div>
      
    </div>
  </div>

滾動方法

const scrollToFirstError = (formRef) => {
  // 獲取第一個帶有錯誤信息的表單字段
  const firstErrorField = document.querySelector('.el-form-item.is-error');
  if (firstErrorField) {
    // 平滑滾動到該字段
    firstErrorField.scrollIntoView({
      behavior: 'smooth',
      block: 'center',
    });
  }
};

提交時校驗

// 定義子組件ref
const childFormRefs = ref([]);
const setChildRef = (el) => {
  if (el) {
    childFormRefs.value.push(el);
  }
};

const projectInfoRef = ref();
const vForm = ref();


//提交方法里校驗
//validateProjectForm子組件提供的校驗方法
 let projectValid = projectInfoRef.value
      ? await projectInfoRef.value.validateProjectForm()  
      : { isValid: true };

    // 校驗所有子表單
//validateForm子組件提供的校驗方法
    const childValids = await Promise.all(childFormRefs.value.map((child) => child.validateForm()));

    // // 檢查子表單校驗結果
    const invalidForms = childValids.filter((result) => !result.isValid);
    const formValid = await instance.proxy.$refs.vForm.validate((valid) => {
      return valid;
    });
    console.log(projectValid.isValid, 'kkk');

    if (!projectValid?.isValid) { 
      scrollToFirstError(projectInfoRef.value); //校驗不通過，滾動到第一個表單錯誤位置
    } else if (invalidForms.length > 0) {
      const firstInvalidIndex = childValids.findIndex((result) => !result.isValid);
      scrollToFirstError(childFormRefs.value[firstInvalidIndex]);  //校驗不通過，滾動到多個子表單第一個錯誤位置
    } else if (!formValid) {
      scrollToFirstError(instance.proxy.$refs.vForm);
    }
    if (!projectValid?.isValid || invalidForms.length > 0 || !formValid) {
      return;
    }