Skip to content

WW-5811 docs: date min/max and temporal required HTML5 constraints - #367

Merged
lukaszlenart merged 2 commits into
mainfrom
WW-5811-temporal-html5-constraints-docs
Oct 25, 2026
Merged

lukaszlenart merged 2 commits into
mainfrom
WW-5811-temporal-html5-constraints-docs

Conversation

@lukaszlenart

Copy link
Copy Markdown
Member

Docs for WW-5811 / apache/struts#2061. Merge after the code PR.

Updates core-developers/client-side-validation.md:

  • Governing rule: range constraints are now also added to type="date" inputs.
  • Mapping table:
    • The date row ("deferred") becomes date/localdate → min/max, on type="date" only.
    • The required row adds temporal controls bound to a date/time property.
  • New paragraph on when plain required is emitted on temporal controls:
    • It depends on the property's declared type, because an empty value converts to null.
    • A String property, an indexed path or an unresolved property gets no required.
  • New paragraph on date ranges:
    • localdate bounds are written as they are.
    • java.util.Date bounds are reduced to their calendar date in the server zone. The page explains why that never makes the browser stricter.
    • Out-of-range years are skipped.
    • Why month/week/time/datetime-local get no min/max.
  • Extension point:
    • The five-argument constraintsFor with its default fallback.
    • The StrutsHtmlConstraintProvider subclass migration note.
    • The convertsBlankToNull override for custom converters.

🤖 Generated with Claude Code

…raints

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@lukaszlenart
lukaszlenart marked this pull request as ready for review October 25, 2026 15:14
…ep rules

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@asf-ci

asf-ci commented Oct 25, 2026

Copy link
Copy Markdown

Staged site is ready at https://struts.staged.apache.org/

@lukaszlenart
lukaszlenart merged commit f892ea9 into main Oct 25, 2026
1 check passed
@lukaszlenart
lukaszlenart deleted the WW-5811-temporal-html5-constraints-docs branch October 25, 2026 20:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants