JeecgBoot项目中RangePicker组件setFieldsValue的正确用法

问题背景

在使用JeecgBoot 3.7.0版本开发过程中，很多开发者会遇到一个常见问题：在BasicTable的查询条件中，使用getForm()获取的setFieldsValue方法无法正确为RangePicker类型的字段设置值，而Input类型的字段却能正常赋值。

问题分析

通过分析发现，这实际上是由于对RangePicker组件的数据格式理解不足导致的。RangePicker作为日期范围选择器，与普通Input组件的值格式有本质区别：

1. Input组件接收的是简单的字符串值
2. RangePicker需要接收一个数组格式的值，包含开始和结束两个日期

正确解决方案

1. 数组格式赋值

为RangePicker设置值时，必须使用数组格式：

const { setFieldsValue } = getForm();
setFieldsValue({
  dateRange: ['2024-12-01', '2024-12-31']  // 正确格式
});

2. 配置valueFormat

为了确保日期格式正确解析，建议在查询表单的JSON配置中明确定义valueFormat属性：

{
  "field": "dateRange",
  "label": "日期范围",
  "component": "RangePicker",
  "valueFormat": "YYYY-MM-DD"
}

3. 使用defaultValue设置默认值

也可以在JSON配置中直接设置默认值：

{
  "field": "dateRange",
  "label": "日期范围",
  "component": "RangePicker",
  "defaultValue": ["2024-12-01", "2024-12-31"]
}

实际应用示例

以下是一个完整的查询表单配置示例：

{
  "columns": [
    {
      "field": "name",
      "label": "姓名",
      "component": "Input"
    },
    {
      "field": "dateRange",
      "label": "入职日期范围",
      "component": "RangePicker",
      "valueFormat": "YYYY-MM-DD",
      "defaultValue": ["2024-01-01", "2024-12-31"]
    }
  ]
}

总结

在JeecgBoot项目中使用RangePicker组件时，必须注意以下几点：

1. 值必须是包含两个日期的数组
2. 明确指定日期格式(valueFormat)
3. 可以通过JSON配置或编程方式(setFieldsValue)设置值
4. 默认值也需遵循数组格式

理解这些要点后，就能轻松处理RangePicker组件的值设置问题，提升开发效率。