Ant Design 中 resetFields 导致自定义组件销毁并重新加载问题分析

Form 中使用子组件的过程中发现,每次 resetFields 都会导致子组件销毁重建,而子组件由于要请求接口加载数据,所以会导致重复请求。本文记录相关 Issues 的查找过程和和相关源码分析

文章目录

一、现象说明

如下代码所示,每次子组件 FormChild 都会打 2 次 log,分析发现是 form.resetFields() 导致子组件重新加载了,而 form.setFieldsValue() 则不会导致组件重新加载

import React from "react";
import ReactDOM from "react-dom";
import { Form } from "antd";
import "antd/dist/antd.css";
import "./index.css";

ReactDOM.render(
  <div className="App">
    <FormDemo />
  </div>,
  document.getElementById("root")
);

function FormDemo() {
  const [form] = Form.useForm();

  React.useEffect(() => {
    form.resetFields();
  }, [form]);

  return (
    <Form form={form}>
      <Form.Item name="someitem">
        <FormChild />
      </Form.Item>
    </Form>
  );
}

function FormChild() {
  React.useEffect(() => {
    console.log("FormChild mounted");
  }, []);
  return <div>123</div>;
}

点击下方按钮运行代码:
Ant Design 中 resetFields 导致自定义组件销毁并重新加载问题分析

二、官方解释

2.1 官方文档

为什么 resetFields 会重新 mount 组件?
resetFields 会重置整个 Field,因而其子组件也会重新 mount 从而消除自定义组件可能存在的副作用(例如异步数据、状态等等)。

可以看出官方是知道这个问题的,而且这是经过考虑之后的设计方案,所以平时使用的时候需要注意,有些时候更适合 set 而不是 reset
Ant Design 中 resetFields 导致自定义组件销毁并重新加载问题分析

https://ant.design/components/form-cn/#%E4%B8%BA%E4%BB%80%E4%B9%88-resetFields-%E4%BC%9A%E9%87%8D%E6%96%B0-mount-%E7%BB%84%E4%BB%B6%EF%BC%9F

2.2 GitHub Issue

三、源码分析

antdform 的数据处理用了 rc-field-form,看代码都是 19 年 06 月写的

  • ① 对比 resetFieldssetFields 方法可以看出 notifyObserverstype 是明显不同的地方;
    Ant Design 中 resetFields 导致自定义组件销毁并重新加载问题分析
  • ② 找到观察者响应的代码区域,可以看出两个方法处理的区别,前者 this.refresh() 后者 this.reRender()
    Ant Design 中 resetFields 导致自定义组件销毁并重新加载问题分析
  • refresh 函数有一个明显的标志计数器:resetCount
    Ant Design 中 resetFields 导致自定义组件销毁并重新加载问题分析
  • ④ 找到计数器 resetCount 使用的区域,发现计数器会导致 key 的变化,也就导致了子组件的重新渲染,案情水落石出!
    Ant Design 中 resetFields 导致自定义组件销毁并重新加载问题分析
上一篇:antd vue table组件实现分页效果


下一篇:【前端】Antd-Vue表单校验