React-Admin 中 sanitizeEmptyValues 对嵌套字段的支持问题解析

在 React-Admin 项目中，表单数据处理是一个核心功能。其中 sanitizeEmptyValues 是一个用于清理表单中空值的实用函数，但在处理嵌套字段时存在一些需要注意的问题。

问题背景

sanitizeEmptyValues 函数主要用于处理表单提交前的空值清理工作，例如将空字符串转换为 null 或 undefined。然而，当表单中包含类似 <TextInput source="foo.bar" /> 这样的嵌套字段时，该函数无法正确处理这些嵌套路径。

技术细节

React-Admin 的表单系统支持通过点号表示法来定义嵌套字段路径，这在处理复杂数据结构时非常有用。但当前的 sanitizeEmptyValues 实现仅支持扁平化的字段结构，没有考虑嵌套字段的情况。

设计决策

React-Admin 团队决定不默认处理嵌套字段的空值清理，这主要是出于以下考虑：

1. 空对象处理的不确定性：对于路径如 deep.field，如果 field 为空，deep 对象应该保留为空对象、设置为 null 还是 undefined？不同场景可能有不同需求。

2. 灵活性考虑：开发者可能对嵌套结构的空值处理有特殊需求，统一处理可能无法满足所有用例。

解决方案

对于需要处理嵌套字段空值的场景，React-Admin 推荐使用 transform 属性来自定义数据处理逻辑。transform 函数在表单提交前执行，开发者可以在这里实现自己的嵌套字段处理逻辑。

const transform = data => {
    // 自定义处理嵌套字段的空值
    if (data.foo && data.foo.bar === '') {
        return { ...data, foo: { ...data.foo, bar: null } };
    }
    return data;
};

<Edit transform={transform}>
    {/* 表单内容 */}
</Edit>

最佳实践

1. 对于简单表单，直接使用 sanitizeEmptyValues 即可满足需求。

2. 对于包含嵌套字段的复杂表单：

   • 使用 transform 属性实现自定义空值处理
   • 考虑将空值处理逻辑封装为可复用的工具函数
   • 在团队内部统一空值处理规范（如统一使用 null 或 undefined）

3. 在表单验证阶段就处理空值问题，而不是等到提交时才处理。

总结

React-Admin 的设计哲学强调灵活性和可扩展性，sanitizeEmptyValues 对嵌套字段的限制正是这一哲学的体现。开发者可以通过 transform 属性获得完全的控制权，根据项目需求实现最适合的空值处理逻辑。理解这一设计决策有助于开发者更好地利用 React-Admin 构建健壮的表单系统。