This is an automated email from the ASF dual-hosted git repository. lukaszlenart pushed a commit to branch docs/html5-constraint-validation in repository https://gitbox.apache.org/repos/asf/struts-site.git
commit 2e9203d342c9bf92649dec93292438207134b0f3 Author: Lukasz Lenart <[email protected]> AuthorDate: Tue Aug 25 00:17:20 2026 +0200 docs: stop asserting a specific version for the html5.constraints default flip The shipped javadoc and default.properties deliberately say the struts.ui.html5.constraints default is "expected to flip in a future major release" rather than naming 8.0.0, since the release version is chosen at release time from the accumulated semver impact. The docs page asserted "in Struts 8.0.0" instead, which is a firmer commitment than the code itself makes. Softened to match the code's wording, with WW-5696 linked so the claim stays traceable. Also makes every other "removed in 8.0.0" claim (the JS validator's removal) cite WW-5694/WW-5696 inline rather than floating as a bare assertion. Naming 8.0.0 for that removal is kept as-is: it's a major-version removal, already committed to in Form.java's own @Deprecated(since = "7.4.0", forRemoval = true) javadoc, and WW-5696 is filed against it. Co-Authored-By: Claude Opus 5 <[email protected]> --- source/core-developers/ajax-client-side-validation.md | 3 ++- source/core-developers/client-side-validation.md | 5 +++-- source/tag-developers/css-xhtml-theme.md | 11 +++++++---- source/tag-developers/xhtml-theme.md | 11 +++++++---- 4 files changed, 19 insertions(+), 11 deletions(-) diff --git a/source/core-developers/ajax-client-side-validation.md b/source/core-developers/ajax-client-side-validation.md index 45012487e..2f52ccff5 100644 --- a/source/core-developers/ajax-client-side-validation.md +++ b/source/core-developers/ajax-client-side-validation.md @@ -15,7 +15,8 @@ parent: ## Description AJAX-based client side validation improves upon [Pure JavaScript Client Side Validation](client-side-validation#pure-javascript-client-side-validation-deprecated) -(deprecated since Struts 7.4.0, removed in 8.0.0) by using a combination of JavaScript, DOM manipulation, and remote server communication. Unlike the pure client side +(deprecated since 7.4.0 [WW-5694](https://issues.apache.org/jira/browse/WW-5694), removed in 8.0.0 +[WW-5696](https://issues.apache.org/jira/browse/WW-5696)) by using a combination of JavaScript, DOM manipulation, and remote server communication. Unlike the pure client side implementation, AJAX-based validation communicates with the server. This means all your validation rules that worked when submitting a form will still work within the browser. diff --git a/source/core-developers/client-side-validation.md b/source/core-developers/client-side-validation.md index e281ba7ea..5b4836b45 100644 --- a/source/core-developers/client-side-validation.md +++ b/source/core-developers/client-side-validation.md @@ -39,8 +39,9 @@ theme](../tag-developers/html5-theme#using-the-html5-theme)). There is no per-fo unlike the deprecated JavaScript validator, this feature does not use `<s:form validate="true">`. Once the constant is on and a field's theme is `html5`, its validators are consulted automatically. -> The constant defaults to `false` in 7.4.0 so existing `html5`-theme forms keep rendering unchanged. The -> default is expected to flip to `true` in Struts 8.0.0. +> The constant defaults to `false` so existing `html5`-theme forms keep rendering unchanged. The default is +> expected to flip to `true` in a future major release, tracked by +> [WW-5696](https://issues.apache.org/jira/browse/WW-5696). ### The governing rule: never false-reject diff --git a/source/tag-developers/css-xhtml-theme.md b/source/tag-developers/css-xhtml-theme.md index 44176e72e..0cd207e23 100644 --- a/source/tag-developers/css-xhtml-theme.md +++ b/source/tag-developers/css-xhtml-theme.md @@ -15,8 +15,9 @@ The _css_xhtml theme_ provides all the basics that the [simple theme](simple-the - Labels for each of the HTML [Struts Tags](struts-tags), placed according to the CSS stylesheet - [Validation](../core-developers/validation) and error reporting - [Pure JavaScript Client Side Validation](../core-developers/client-side-validation#pure-javascript-client-side-validation-deprecated) - using 100% JavaScript on the browser — **deprecated since Struts 7.4.0, removed in 8.0.0**; use the - [html5 theme](html5-theme) instead + using 100% JavaScript on the browser — deprecated since 7.4.0 + ([WW-5694](https://issues.apache.org/jira/browse/WW-5694)), removed in 8.0.0 + ([WW-5696](https://issues.apache.org/jira/browse/WW-5696)); use the [html5 theme](html5-theme) instead ## Wrapping the Simple Theme @@ -71,7 +72,8 @@ The head includes a style sheet. The contents of **styles.css** are: The css_xhtml [form](form-tag) template is almost exactly like the _xhtml form template_ , including support for [Pure JavaScript Client Side Validation](../core-developers/client-side-validation#pure-javascript-client-side-validation-deprecated) -(deprecated since Struts 7.4.0, removed in 8.0.0). The difference is that instead of printing out an opening and closing +(deprecated since 7.4.0 [WW-5694](https://issues.apache.org/jira/browse/WW-5694), removed in 8.0.0 +[WW-5696](https://issues.apache.org/jira/browse/WW-5696)). The difference is that instead of printing out an opening and closing `<table>` element, there are no elements. Instead, the CSS rules for the individual HTML tags are assumed to handle all display logic. However, as noted, client-side validation is still supported. @@ -79,6 +81,7 @@ display logic. However, as noted, client-side validation is still supported. The css_xhtml [form](form-tag) template is almost exactly like the _xhtml form template_ , including support for [Pure JavaScript Client Side Validation](../core-developers/client-side-validation#pure-javascript-client-side-validation-deprecated) -(deprecated since Struts 7.4.0, removed in 8.0.0). The only difference is that instead of printing out an opening and +(deprecated since 7.4.0 [WW-5694](https://issues.apache.org/jira/browse/WW-5694), removed in 8.0.0 +[WW-5696](https://issues.apache.org/jira/browse/WW-5696)). The only difference is that instead of printing out an opening and closing `<table>` element, there are no elements. Instead, the CSS rules for the individual HTML tags are assumed to handle all display logic. However, as noted, client side validation is still supported. diff --git a/source/tag-developers/xhtml-theme.md b/source/tag-developers/xhtml-theme.md index abed1e85f..50297eea9 100644 --- a/source/tag-developers/xhtml-theme.md +++ b/source/tag-developers/xhtml-theme.md @@ -20,8 +20,9 @@ The xhtml provides all the basics that the [simple theme](simple-theme) provides the `labelposition` attribute) - [Validation](../core-developers/validation) and error reporting - [Pure JavaScript Client Side Validation](../core-developers/client-side-validation#pure-javascript-client-side-validation-deprecated) - using 100% JavaScript on the browser — **deprecated since Struts 7.4.0, removed in 8.0.0**; use the - [html5 theme](html5-theme) instead + using 100% JavaScript on the browser — deprecated since 7.4.0 + ([WW-5694](https://issues.apache.org/jira/browse/WW-5694)), removed in 8.0.0 + ([WW-5696](https://issues.apache.org/jira/browse/WW-5696)); use the [html5 theme](html5-theme) instead ## Wrapping the Simple Theme @@ -96,7 +97,8 @@ The head template imports a style sheet. The contents of **styles.css** are: The xhtml form template sets up the wrapping table around all the other form elements. In addition to creating this wrapping table, the opening and closing templates also, if the `validate` parameter is set to true, enable [Pure JavaScript Client Side Validation](../core-developers/client-side-validation#pure-javascript-client-side-validation-deprecated) -(deprecated since Struts 7.4.0, removed in 8.0.0). +(deprecated since 7.4.0 [WW-5694](https://issues.apache.org/jira/browse/WW-5694), removed in 8.0.0 +[WW-5696](https://issues.apache.org/jira/browse/WW-5696)). {% highlight freemarker %} {% remote_file_content https://raw.githubusercontent.com/apache/struts/main/core/src/main/resources/template/xhtml/form.ftl %} @@ -113,7 +115,8 @@ The closing template, `form-close.ftl`: The xhtml form template sets up the wrapping table around all the other [xhtml theme](xhtml-theme) form elements. In addition to creating this wrapping table, the opening and closing templates also, if the `validate` parameter is set to `true`, enable [Pure JavaScript Client Side Validation](../core-developers/client-side-validation#pure-javascript-client-side-validation-deprecated) -(deprecated since Struts 7.4.0, removed in 8.0.0). +(deprecated since 7.4.0 [WW-5694](https://issues.apache.org/jira/browse/WW-5694), removed in 8.0.0 +[WW-5696](https://issues.apache.org/jira/browse/WW-5696)). See the **form.ftl** contents:
