Form 表单的 resetFields() 失效原因

假设我们有如下代码： 

<template>
  <ElForm ref="formRef" :model="formModel" :rules="rules">
  <!-- 表单内容 -->
  </ElForm>
</template>

<script setup>
  import { ref } from 'vue';
  const formRef = ref(null);
  const formModel = ref({
    name: '',
    age: '',
    // 其他表单字段
  });

  const resetForm = () => {
    if (formRef.value) {
      formRef.value.resetFields();
    }
  };
</script>

当我们使用 formRef.value.resetFields() 不起作用时，可以从以下几个方面考虑：

1、formRef 为空或未正确绑定

确保 formRef 已正确绑定到 ElForm 组件，并在调用 resetFields() 方法时，formRef 的值是有效的。

2、表单字段未绑定 model

如果表单项没有正确绑定到 model，即没有使用 v-model 或 :model 指定绑定的对象，resetFields() 将无法重置这些字段！！

例如 🌰，每个表单项应该绑定到 formModel 中的对应字段：

<ElForm ref="formRef" :model="formModel">
  <ElFormItem label="姓名" prop="name">
    <ElInput v-model="formModel.name" />
  </ElFormItem>
  <ElFormItem label="年龄" prop="age">
    <ElInput v-model="formModel.age" />
  </ElFormItem>
</ElForm>

3、resetFields() 的时机问题

有时，resetFields() 在组件或 DOM 尚未完全渲染时调用，可能会不起作用。确保在表单已经被挂载之后调用。

例如 🌰，确保在 mounted 生命周期或在按钮点击后调用：

<ElButton @click="resetForm">重置</ElButton>

<script setup>
  const resetForm = () => {
    // 确保 formRef 不为 null
    if (formRef.value) {
      formRef.value.resetFields();
    }
  };
</script>

4、确保 rules 配置正确

如果使用了表单校验规则 (rules)，需要确保校验规则配置无误。某些情况下，错误的校验规则会导致表单无法正确重置。

5、Vue 版本兼容性问题

如果使用的是 Vue 3 和 Element Plus，请确保 Element Plus 的版本和 Vue 的版本兼容。某些旧版本可能在与 Vue 3 结合使用时存在兼容性问题，更新到最新的 Element Plus 版本可能会解决问题。

大家可以从这些方面逐步排查问题，特别是 formRef 的引用是否正确、表单是否正确绑定等。