如何在Tapestry项目中设置tapx-datefield的max/min参数禁用过去日期

问题描述 #

在Tapestry项目中使用tapx-datefield日期选择器组件时，需要实现禁止用户选择过往日期的交互效果。排查组件源码时发现组件内置了max、min配置参数，但不清楚具体的配置调用方式，寻求可落地的实现方案。

具体实现方式 #

组件本身已经内置了日期范围限制的能力，只需要正确给min参数传入符合格式的日期值，即可自动禁用早于下限的所有过往日期，不需要额外编写自定义拦截逻辑。

• 第一步：在对应页面的Java类中定义用于传入组件的最小可选日期属性，注意日期格式要和组件设置的显示格式完全一致
  示例代码：

  import java.time.LocalDate;
  import java.time.format.DateTimeFormatter;
  
  public class OrderForm {
      // 绑定给组件的最小可选日期，即当前日期，作为过往日期的判断下限
      public String getMinDate() {
          return LocalDate.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd"));
      }
  }
  

• 第二步：在页面对应的TML模板中，给tapx-datefield组件传入min参数，绑定上面定义的属性
  示例代码：

  <t:tapx-datefield
      t:id="orderDatePicker"
      t:value="selectedOrderDate"
      t:min="minDate"
      t:format="yyyy-MM-dd"
  />
  

• 补充说明：组件的max参数和min参数作用对称，如果后续需要实现禁用未来日期的效果，只需要将max参数绑定为当前日期的格式化值即可，组件会自动禁用晚于上限的日期。另外仅靠前端组件的限制不足以完全拦截非法提交，可以在页面的表单校验逻辑中增加兜底判断，当用户提交的日期早于当前日期时，直接抛出表单校验错误，避免绕过前端限制的非法数据入库。

内容的提问来源于stack exchange，提问作者GonoGini