JeecgBoot中表单参数componentProps为函数时的注意事项

问题背景

在使用JeecgBoot框架开发时，开发者发现当表单参数的componentProps属性设置为函数返回值时，存在两个主要问题：

1. 定义的valueType属性不生效
2. 使用updateSchema更新表单参数时，必须更新整个componentProps方法返回的所有值，否则未更新的字段会失效

技术分析

valueType属性失效问题

在多选组件并要求以数组格式传值给后端时，如果componentProps以函数形式定义，其中设置的valueType属性不会生效。这是因为框架底层代码在获取componentProps的valueType时，没有处理函数形式的componentProps，而是直接使用componentProps.valueType取值。

当componentProps为函数时，componentProps.valueType实际上是undefined，导致框架无法正确识别开发者期望的数据类型。

updateSchema更新问题

当使用updateSchema方法更新表单参数时，如果componentProps是函数形式，开发者必须完整更新该函数返回的所有属性值。如果只更新部分属性，未更新的属性将会失效。这是因为框架在处理函数形式的componentProps时，会完全替换原有的函数定义，而不是进行属性合并。

解决方案

针对valueType问题

1. 对于需要明确指定valueType为"array"的场景，建议直接在字段定义中设置valueType属性，而不是通过componentProps函数设置。

2. 如果确实需要通过componentProps函数设置valueType，可以考虑在字段定义和componentProps中都设置valueType，确保至少有一处能生效。

针对updateSchema问题

1. 在更新componentProps时，建议先获取当前完整的componentProps定义，然后在此基础上进行修改，最后再整体更新。

2. 可以考虑将componentProps拆分为静态部分和动态部分，静态部分直接定义在字段中，动态部分通过函数处理。

最佳实践

1. 对于简单的数据类型定义，优先在字段定义中直接设置valueType属性。

2. 对于复杂的componentProps逻辑，可以考虑封装成独立的函数，确保每次更新时都能返回完整的属性集合。

3. 在开发过程中，注意检查框架版本，确保使用的是包含相关修复的最新版本。

总结

JeecgBoot框架在处理函数形式的componentProps时存在一些特殊行为，开发者需要特别注意valueType的设置和参数更新的方式。通过遵循上述建议，可以避免因componentProps函数使用不当导致的各种问题，确保表单功能按预期工作。