This is an automated email from the ASF dual-hosted git repository.
asf-gitbox-commits pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/struts-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new cb7d08fc1a Automatic Site Publish by Buildbot
cb7d08fc1a is described below
commit cb7d08fc1abe757a5cad9ccbabf1aa900b23fc4e
Author: buildbot <[email protected]>
AuthorDate: Sat Oct 24 13:33:01 2026 +0000
Automatic Site Publish by Buildbot
---
output/tag-developers/datetextfield-tag.html | 28 +++++++++++++++++++++++++---
output/tag-developers/html5-theme.html | 2 +-
2 files changed, 26 insertions(+), 4 deletions(-)
diff --git a/output/tag-developers/datetextfield-tag.html
b/output/tag-developers/datetextfield-tag.html
index ba0f2a65ea..aa0e2e99d3 100644
--- a/output/tag-developers/datetextfield-tag.html
+++ b/output/tag-developers/datetextfield-tag.html
@@ -158,7 +158,7 @@
<h2 id="description">Description</h2>
-<p>Render an HTML input fields with the date time</p>
+<p>Render an HTML input for a date: a native input type=”date” in the html5
theme, split input fields with the JavaTemplates plugin</p>
<h2 id="attributes">Attributes</h2>
@@ -235,11 +235,11 @@
</tr>
<tr>
<td class="tag-attribute">format</td>
- <td class="tag-attribute"><strong>true</strong></td>
+ <td class="tag-attribute">false</td>
<td class="tag-attribute"></td>
<td class="tag-attribute">false</td>
<td class="tag-attribute">String</td>
- <td class="tag-attribute">Date format attribute</td>
+ <td class="tag-attribute">Date format used to lay out the split input
fields of the JavaTemplates plugin; ignored by the html5 theme, which always
uses yyyy-MM-dd</td>
</tr>
<tr>
<td class="tag-attribute">id</td>
@@ -533,6 +533,28 @@
<h2 id="examples">Examples</h2>
+<p>With the <a href="html5-theme">html5 theme</a> (since 7.5.0) the tag
renders a single native date input. The browser shows the
+date in the user’s locale and always submits it as <code
class="language-plaintext highlighter-rouge">yyyy-MM-dd</code>, so the <code
class="language-plaintext highlighter-rouge">format</code> attribute is
ignored:</p>
+
+<div class="language-jsp highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><s:datetextfield </span><span
class="na">name=</span><span class="s">"birthday"</span><span class="na">
theme=</span><span class="s">"html5"</span><span class="na"> min=</span><span
class="s">"1900-01-01"</span><span class="na"> max=</span><span
class="s">"2026-12-31"</span><span class="nt">/></span>
+</code></pre></div></div>
+
+<div class="language-html highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><input</span> <span
class="na">type=</span><span class="s">"date"</span> <span
class="na">name=</span><span class="s">"birthday"</span> <span
class="na">value=</span><span class="s">"1990-05-17"</span> <span
class="na">id=</span><span class="s">"birthday"</span> <span
class="na">min=</span><span class="s">"1900-01-01"</span> <span
class="na">max=</span><span class="s">"202 [...]
+</code></pre></div></div>
+
+<ul>
+ <li>The property must be a <code class="language-plaintext
highlighter-rouge">java.util.Date</code>; its value is rendered in the server’s
default time zone</li>
+ <li><code class="language-plaintext highlighter-rouge">min</code> and <code
class="language-plaintext highlighter-rouge">max</code> are passed through as
dynamic attributes and must be written as <code class="language-plaintext
highlighter-rouge">yyyy-MM-dd</code></li>
+</ul>
+
+<p>With the <a href="../plugins/javatemplates/">JavaTemplates Plugin</a> the
tag renders one text input per date field, laid out
+by the <code class="language-plaintext highlighter-rouge">format</code>
attribute, and <code class="language-plaintext
highlighter-rouge">DateTextFieldInterceptor</code> assembles them back into a
<code class="language-plaintext highlighter-rouge">java.util.Date</code>:</p>
+
+<div class="language-jsp highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><s:datetextfield </span><span
class="na">name=</span><span class="s">"birthday"</span><span class="na">
format=</span><span class="s">"dd/MM/yyyy"</span><span class="nt">/></span>
+</code></pre></div></div>
+
+<p>The simple, xhtml and css_xhtml themes do not support this tag.</p>
+
</section>
</article>
diff --git a/output/tag-developers/html5-theme.html
b/output/tag-developers/html5-theme.html
index 1f5b7f7db6..e3bf9d37ef 100644
--- a/output/tag-developers/html5-theme.html
+++ b/output/tag-developers/html5-theme.html
@@ -222,7 +222,7 @@
<p>The HTML5 theme includes templates for all standard Struts UI tags
including:
textfield, textarea, password, checkbox, checkboxlist, radio, select, file,
-hidden, label, combobox, reset, submit, form, and more.</p>
+hidden, label, combobox, datetextfield, reset, submit, form, and more.</p>
<h2 id="text-field-template-example">Text Field Template Example</h2>
