You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@struts.apache.org by hu...@apache.org on 2006/01/06 12:28:41 UTC
svn commit: r366476 [2/3] - in
/struts/sandbox/trunk/mailreader-course/lab-1-1-src/webapp: MainMenu.jsp
RegisterForm.jsp Success.html WEB-INF/classes/ WEB-INF/struts-config.xml
WEB-INF/struts-html.tld WEB-INF/validator.xml
Added: struts/sandbox/trunk/mailreader-course/lab-1-1-src/webapp/WEB-INF/struts-html.tld
URL: http://svn.apache.org/viewcvs/struts/sandbox/trunk/mailreader-course/lab-1-1-src/webapp/WEB-INF/struts-html.tld?rev=366476&view=auto
==============================================================================
--- struts/sandbox/trunk/mailreader-course/lab-1-1-src/webapp/WEB-INF/struts-html.tld (added)
+++ struts/sandbox/trunk/mailreader-course/lab-1-1-src/webapp/WEB-INF/struts-html.tld Fri Jan 6 03:28:32 2006
@@ -0,0 +1,8752 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE taglib
+ PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
+ "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
+<taglib>
+ <tlib-version>1.3</tlib-version>
+ <jsp-version>1.2</jsp-version>
+ <short-name>html</short-name>
+ <uri>http://struts.apache.org/tags-html</uri>
+ <description>
+ <![CDATA[
+ <p>
+ This taglib contains tags used to create struts
+ input forms, as well as other tags generally useful
+ in the creation of HTML-based user interfaces.
+ </p>
+
+ <p>Many of the tags in this tag library will throw a
+ <code>JspException</code> at runtime when they are utilized incorrectly
+ (such as when you specify an invalid combination of tag attributes). JSP
+ allows you to declare an "error page" in the <code><%@ page %></code>
+ directive. If you wish to process the actual exception that caused the
+ problem, it is passed to the error page as a request attribute under key
+ <code>org.apache.struts.action.EXCEPTION</code>.</p>
+ ]]>
+ </description>
+ <tag>
+ <name>base</name>
+ <tag-class>org.apache.struts.taglib.html.BaseTag</tag-class>
+ <body-content>empty</body-content>
+ <description>
+ <![CDATA[
+ <p><strong>Render an HTML <code><base></code> Element</strong></p>
+
+ <p>Renders an HTML <code><base></code> element with an
+ <code>href</code> attribute pointing to the absolute location of
+ the enclosing JSP page. This tag is valid only when nested inside
+ an HTML <code><head></code> element.</p>
+
+ <p>This tag is useful because it allows you to use relative URL
+ references in the page that are calculated based on the URL of the
+ page itself, rather than the URL to which the most recent submit
+ took place (which is where the browser would normally resolve
+ relative references against).</p>
+ ]]>
+ </description>
+ <attribute>
+ <name>target</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The window target for this base reference.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>server</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The server name to use instead of request.getServerName().</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>ref</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The reference from which the base uri will created. Possible values are:
+ </p>
+ <ul>
+ <li><code>page</code> - The base uri will be the jsp page location. (default)</li>
+ <li><code>site</code> - The base uri will be the application context path.</li>
+ </ul>
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.3</dd></dl>
+
+ ]]>
+ </description>
+ </attribute>
+ </tag>
+ <tag>
+ <name>button</name>
+ <tag-class>org.apache.struts.taglib.html.ButtonTag</tag-class>
+ <description>
+ <![CDATA[
+ <p><strong>Render A Button Input Field</strong></p>
+
+ <p>
+ Renders an HTML <input> element of type
+ <code>button</code>, populated from the specified value or the
+ content of this tag body. This tag is only valid when nested
+ inside a form tag body.
+ </p>
+ <p>
+ If a graphical button is needed (a button with an image), then the
+ <a href="#image"><code>image</code></a> tag is more appropriate.
+ </p>
+ ]]>
+ </description>
+ <attribute>
+ <name>accesskey</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The keyboard character used to move focus immediately to this
+ element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>alt</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The alternate text for this element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>altKey</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The message resources key of the alternate text for this
+ element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>bundle</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The servlet context attributes key for the MessageResources
+ instance to use. If not specified, defaults to the
+ application resources configured for our action servlet.</p>
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.5</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>disabled</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <type>boolean</type>
+ <description>
+ <![CDATA[
+ <p>Set to <code>true</code> if this input field should be
+ disabled.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>indexed</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <type>boolean</type>
+ <description>
+ <![CDATA[
+ <p>Valid only inside of <code>logic:iterate</code> tag.
+ If <code>true</code> then name of the html tag will be rendered as
+ "propertyName[34]". Number in brackets will be generated for
+ every iteration and taken from ancestor logic:iterate tag.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onblur</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element loses input
+ focus.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onchange</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element loses input
+ focus and its value has changed.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onclick</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element receives a
+ mouse click.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>ondblclick</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element receives a
+ mouse double click.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onfocus</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element receives input
+ focus.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onkeydown</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element has focus and a
+ key is depressed.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onkeypress</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element has focus and a
+ key is depressed and released.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onkeyup</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element has focus and a
+ key is released.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmousedown</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element is under the mouse
+ pointer and a mouse button is depressed.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmousemove</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element is under the
+ mouse pointer and the pointer is moved.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmouseout</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element was under the
+ mouse pointer but the pointer was moved outside the element.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmouseover</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element was not under
+ the mouse pointer but the pointer is moved inside the element.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmouseup</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element is under the
+ mouse pointer and a mouse button is released.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>property</name>
+ <required>true</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ Name of the request parameter that will be included with this
+ submission, set to the specified value.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>style</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ CSS styles to be applied to this HTML element.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>styleClass</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ CSS stylesheet class to be applied to this HTML element
+ (renders a "class" attribute).
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>styleId</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ Identifier to be assigned to this HTML element (renders
+ an "id" attribute).
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>tabindex</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The tab order (ascending positive integers) for this element.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>title</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The advisory title for this element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>titleKey</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The message resources key for the advisory title
+ for this element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>value</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ Value of the label to be placed on this button. This value will
+ also be submitted as the value of the specified request parameter.
+ [Body of this tag (if any), or "Click"]
+ ]]>
+ </description>
+ </attribute>
+ </tag>
+ <tag>
+ <name>cancel</name>
+ <tag-class>org.apache.struts.taglib.html.CancelTag</tag-class>
+ <description>
+ <![CDATA[
+ <p><strong>
+ Render a Cancel Button
+ </strong></p>
+
+ <p>
+ Renders an HTML <input> element of type submit. This tag is only
+ valid when nested inside a form tag body. Pressing of this submit
+ button causes the action servlet to bypass calling the associated
+ form bean validate() method. The action is called normally.
+ </p>
+ ]]>
+ </description>
+ <attribute>
+ <name>accesskey</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The keyboard character used to move focus immediately to this
+ element.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>alt</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The alternate text for this element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>altKey</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The message resources key of the alternate text for this
+ element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>bundle</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The servlet context attributes key for the MessageResources
+ instance to use. If not specified, defaults to the
+ application resources configured for our action servlet.
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.5</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>disabled</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <type>boolean</type>
+ <description>
+ <![CDATA[
+ Set to <code>true</code> if this input field should be
+ disabled.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onblur</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element loses input
+ focus.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onchange</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element loses input
+ focus and its value has changed.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onclick</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element receives a
+ mouse click.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>ondblclick</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element receives a
+ mouse double click.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onfocus</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element receives input
+ focus.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onkeydown</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element has focus and a
+ key is depressed.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onkeypress</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element has focus and a
+ key is depressed and released.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onkeyup</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element has focus and a
+ key is released.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmousedown</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element is under the mouse
+ pointer and a mouse button is depressed.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmousemove</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element is under the
+ mouse pointer and the pointer is moved.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmouseout</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element was under the
+ mouse pointer but the pointer was moved outside the element.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmouseover</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element was not under
+ the mouse pointer but the pointer is moved inside the element.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmouseup</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element is under the
+ mouse pointer and a mouse button is released.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>property</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ Name of the request parameter that will be included with this
+ submission, set to the specified value.
+ <strong>WARNING</strong> - If you set this attribute to a
+ value other than the default, this will <em>NOT</em> be
+ recognized as the cancel key by the Struts controller servlet
+ or the <code>Action.isCancelled()</code> method. You will
+ need to do your own cancel detection.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>style</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ CSS styles to be applied to this HTML element.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>styleClass</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ CSS stylesheet class to be applied to this HTML element
+ (renders a "class" attribute).
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>styleId</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ Identifier to be assigned to this HTML element (renders
+ an "id" attribute).
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>tabindex</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The tab order (ascending positive integers) for this element.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>title</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The advisory title for this element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>titleKey</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The message resources key for the advisory title
+ for this element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>value</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ Value of the label to be placed on this button. This value will
+ also be submitted as the value of the specified request parameter.
+ [Body of this tag (if any), or "Cancel"]
+ ]]>
+ </description>
+ </attribute>
+ </tag>
+ <tag>
+ <name>checkbox</name>
+ <tag-class>org.apache.struts.taglib.html.CheckboxTag</tag-class>
+ <description>
+ <![CDATA[
+ <p><strong>
+ Render A Checkbox Input Field
+ </strong></p>
+
+ <p>Renders an HTML <input> element of type
+ <code>checkbox</code>, populated from the specified
+ value or the specified property of the bean associated
+ with our current form. This tag is only valid when
+ nested inside a form tag body.</p>
+
+ <p><strong>NOTE</strong>: The underlying property value
+ associated with this field should be of type <code>boolean</code>,
+ and any <code>value</code> you specify should correspond to one
+ of the Strings that indicate a true value ("true", "yes", or
+ "on"). If you wish to utilize a set of related String values,
+ consider using the <code>multibox</code> tag.</p>
+
+ <p><strong>WARNING</strong>: In order to correctly
+ recognize unchecked checkboxes, the
+ <code>ActionForm</code> bean associated with this form
+ must include a statement setting the corresponding
+ boolean property to <code>false</code> in the
+ <code>reset()</code> method.</p>
+ ]]>
+ </description>
+ <attribute>
+ <name>accesskey</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The keyboard character used to move focus immediately to this
+ element.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>alt</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The alternate text for this element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>altKey</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The message resources key of the alternate text for this
+ element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>bundle</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The servlet context attributes key for the MessageResources
+ instance to use. If not specified, defaults to the
+ application resources configured for our action servlet.
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.5</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>disabled</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <type>boolean</type>
+ <description>
+ <![CDATA[
+ Set to <code>true</code> if this input field should be
+ disabled.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>errorKey</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>Name of the request scope bean under which our error messages
+ have been stored. If not present, the name specified by the
+ <code>Globals.ERROR_KEY</code> constant string will be used.</p>
+
+ <p><strong>N.B.</strong> This is used in conjunction with the
+ <code>errorStyle</code>, <code>errorStyleClass</code> and
+ <code>errorStyleId</code> attributes and should be set to
+ the same value as the <code>name</code> attribute on the
+ <html:errors/> tag.</p>
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.5</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>errorStyle</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>CSS styles to be applied to this HTML element if
+ an error exists for it.</p>
+
+ <p><strong>N.B.</strong> If present, this overrides the
+ <code>style</code> attribute in the event of an error.</p>
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.5</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>errorStyleClass</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>CSS stylesheet class to be applied to this HTML element if
+ an error exists for it (renders a "class" attribute).</p>
+
+ <p><strong>N.B.</strong> If present, this overrides the
+ <code>styleClass</code> attribute in the event of an error.</p>
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.5</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>errorStyleId</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>Identifier to be assigned to this HTML element if
+ an error exists for it (renders an "id" attribute).</p>
+
+ <p><strong>N.B.</strong> If present, this overrides the
+ <code>styleId</code> attribute in the event of an error.</p>
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.5</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>indexed</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <type>boolean</type>
+ <description>
+ <![CDATA[
+ Valid only inside of <code>logic:iterate</code> tag.
+ If <code>true</code> then name of the html tag will be rendered as
+ "id[34].propertyName". Number in brackets will be generated
+ for every iteration and taken from ancestor logic:iterate tag.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>name</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The attribute name of the bean whose properties are consulted when
+ rendering the current value of this input field. If not specified,
+ the bean associated with the form tag we are nested within is utilized.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onblur</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element loses input
+ focus.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onchange</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element loses input
+ focus and its value has changed.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onclick</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element receives a
+ mouse click.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>ondblclick</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element receives a
+ mouse double click.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onfocus</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element receives input
+ focus.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onkeydown</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element has focus and a
+ key is depressed.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onkeypress</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element has focus and a
+ key is depressed and released.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onkeyup</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element has focus and a
+ key is released.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmousedown</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element is under the mouse
+ pointer and a mouse button is depressed.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmousemove</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element is under the
+ mouse pointer and the pointer is moved.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmouseout</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element was under the
+ mouse pointer but the pointer was moved outside the element.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmouseover</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element was not under
+ the mouse pointer but the pointer is moved inside the element.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmouseup</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element is under the
+ mouse pointer and a mouse button is released.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>property</name>
+ <required>true</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ Name of the request parameter that will be included with this
+ submission, set to the specified value.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>style</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>CSS styles to be applied to this HTML element.</p>
+
+ <p><strong>N.B.</strong> If present, the <code>errorStyle</code>
+ overrides this attribute in the event of an error for the element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>styleClass</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>CSS stylesheet class to be applied to this HTML element
+ (renders a "class" attribute).</p>
+
+ <p><strong>N.B.</strong> If present, the <code>errorStyleClass</code>
+ overrides this attribute in the event of an error for the element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>styleId</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>Identifier to be assigned to this HTML element (renders
+ an "id" attribute).</p>
+
+ <p><strong>N.B.</strong> If present, the <code>errorStyleId</code>
+ overrides this attribute in the event of an error for the element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>tabindex</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The tab order (ascending positive integers) for this element.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>title</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The advisory title for this element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>titleKey</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The message resources key for the advisory title
+ for this element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>value</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The value to be transmitted if this checkbox is
+ checked when the form is submitted. If not specified,
+ the value "on" will be returned.
+ ]]>
+ </description>
+ </attribute>
+ </tag>
+ <tag>
+ <name>errors</name>
+ <tag-class>org.apache.struts.taglib.html.ErrorsTag</tag-class>
+ <body-content>empty</body-content>
+ <description>
+ <![CDATA[
+ <p><strong>
+ Conditionally display a set of accumulated error messages.
+ </strong></p>
+
+ <p>Displays a set of error messages prepared by a business
+ logic component and stored as an <code>ActionMessages</code>
+ object, an <code>ActionErrors</code>
+ object, a String, or a String array in request scope. If
+ such a bean is not found, nothing will be rendered.</p>
+
+ <p>In order to use this tag successfully, you must have
+ defined an application scope <code>MessageResources</code>
+ bean under the default attribute name, with optional
+ definitions of message keys specified in the following
+ attributes:</p>
+ <ul>
+ <li><strong>header</strong> - Text that will be rendered
+ before the error messages list. Typically, this message text
+ will end with <code><ul></code> to start the
+ error messages list (default "errors.header").</li>
+ <li><strong>footer</strong> - Text that will be rendered
+ after the error messages list. Typically, this message text
+ will begin with <code></ul></code> to end the error
+ messages list (default "errors.footer").</li>
+ <li><strong>prefix</strong> - Text that will be rendered
+ before each individual error in the list (default "errors.prefix").</li>
+ <li><strong>suffix</strong> - Text that will be rendered
+ after each individual error in the list (default "errors.suffix").</li>
+ </ul>
+
+ <p>See the <code>messages</code> tag for an alternative to this tag that
+ does not rely on HTML in your <code>MessageResources</code>.</p>
+
+ ]]>
+ </description>
+ <attribute>
+ <name>bundle</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The servlet context attribute key for the MessageResources
+ instance to use. If not specified, defaults to the
+ application resources configured for our action servlet.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>footer</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ This value is an optional message resource key that will
+ be printed after the iteration of error messages has finished.
+ Defaults to "errors.footer" if not specified.
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.5</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>header</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ This value is an optional message resource key that will
+ be printed before the iteration of error messages begins.
+ Defaults to "errors.header" if not specified.
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.5</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>locale</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The session attribute key for the Locale used to select
+ messages to be displayed. If not specified, defaults to
+ the Struts standard value.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>name</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ Name of the request scope bean under which our error messages
+ have been stored. If not present, the name specified by the
+ <code>Globals.ERROR_KEY</code> constant string will be used.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>prefix</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ This value is an optional message resource key that will
+ be printed before an error message.
+ Defaults to "errors.prefix" if not specified.
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.5</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>property</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ Name of the property for which error messages should be
+ displayed. If not specified, all error messages (regardless
+ of property) are displayed.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>suffix</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ This value is an optional message resource key that will
+ be printed after an error message.
+ Defaults to "errors.suffix" if not specified.
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.5</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ </tag>
+ <tag>
+ <name>file</name>
+ <tag-class>org.apache.struts.taglib.html.FileTag</tag-class>
+ <description>
+ <![CDATA[
+ <p><strong>
+ Render A File Select Input Field
+ </strong></p>
+
+ <p>
+ Renders an HTML <input> element of type file, defaulting to
+ the specified value or the specified property of the bean
+ associated with our current form. This tag is only valid when
+ nested inside a form tag body.
+ </p>
+ <p>
+ As with the corresponding HTML <input> element, the
+ enclosing form element must specify "POST" for the <code>method</code>
+ attribute, and "multipart/form-data" for the <code>enctype</code>
+ attribute. For example:
+ </p>
+ <pre>
+ <html:form method="POST" enctype="multipart/form-data">
+ <html:file property="theFile" />
+ </html:form></pre>
+
+ <p>
+ WARNING: In order to correctly recognize uploaded files, the ActionForm bean
+ associated with this form must include a statement setting the corresponding
+ org.apache.struts.upload.FormFile property to null in the reset() method.
+ </p>
+ ]]>
+ </description>
+ <attribute>
+ <name>accesskey</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The keyboard character used to move focus immediately to this
+ element.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>accept</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ Comma-delimited set of content types that the server you submit to
+ knows how to process. This list can be used by the client browser
+ to limit the set of file options that is made available for selection.
+ If not specified, no content type list will be sent.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>alt</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The alternate text for this element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>altKey</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The message resources key of the alternate text for this
+ element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>bundle</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The servlet context attributes key for the MessageResources
+ instance to use. If not specified, defaults to the
+ application resources configured for our action servlet.
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.5</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>disabled</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <type>boolean</type>
+ <description>
+ <![CDATA[
+ Set to <code>true</code> if this input field should be
+ disabled.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>errorKey</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>Name of the request scope bean under which our error messages
+ have been stored. If not present, the name specified by the
+ <code>Globals.ERROR_KEY</code> constant string will be used.</p>
+
+ <p><strong>N.B.</strong> This is used in conjunction with the
+ <code>errorStyle</code>, <code>errorStyleClass</code> and
+ <code>errorStyleId</code> attributes and should be set to
+ the same value as the <code>name</code> attribute on the
+ <html:errors/> tag.</p>
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.5</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>errorStyle</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>CSS styles to be applied to this HTML element if
+ an error exists for it.</p>
+
+ <p><strong>N.B.</strong> If present, this overrides the
+ <code>style</code> attribute in the event of an error.</p>
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.5</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>errorStyleClass</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>CSS stylesheet class to be applied to this HTML element if
+ an error exists for it (renders a "class" attribute).</p>
+
+ <p><strong>N.B.</strong> If present, this overrides the
+ <code>styleClass</code> attribute in the event of an error.</p>
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.5</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>errorStyleId</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>Identifier to be assigned to this HTML element if
+ an error exists for it (renders an "id" attribute).</p>
+
+ <p><strong>N.B.</strong> If present, this overrides the
+ <code>styleId</code> attribute in the event of an error.</p>
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.5</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>indexed</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <type>boolean</type>
+ <description>
+ <![CDATA[
+ Valid only inside of <code>logic:iterate</code> tag.
+ If <code>true</code> then name of the html tag will be rendered as
+ "id[34].propertyName". Number in brackets will be generated
+ for every iteration and taken from ancestor logic:iterate tag.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>maxlength</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ Maximum number of input characters to accept. This is ignored
+ by most browsers. [No limit]
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>name</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The attribute name of the bean whose properties are consulted when
+ rendering the current value of this input field. If not specified,
+ the bean associated with the form tag we are nested within is utilized.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onblur</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element loses input
+ focus.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onchange</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element loses input
+ focus and its value has changed.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onclick</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element receives a
+ mouse click.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>ondblclick</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element receives a
+ mouse double click.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onfocus</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element receives input
+ focus.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onkeydown</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element has focus and a
+ key is depressed.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onkeypress</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element has focus and a
+ key is depressed and released.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onkeyup</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element has focus and a
+ key is released.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmousedown</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element is under the mouse
+ pointer and a mouse button is depressed.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmousemove</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element is under the
+ mouse pointer and the pointer is moved.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmouseout</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element was under the
+ mouse pointer but the pointer was moved outside the element.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmouseover</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element was not under
+ the mouse pointer but the pointer is moved inside the element.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onmouseup</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed when this element is under the
+ mouse pointer and a mouse button is released.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>property</name>
+ <required>true</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ Name of the request parameter that will be included with this
+ submission, set to the specified value.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>size</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ Size of the file selection box to be displayed.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>style</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>CSS styles to be applied to this HTML element.</p>
+
+ <p><strong>N.B.</strong> If present, the <code>errorStyle</code>
+ overrides this attribute in the event of an error for the element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>styleClass</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>CSS stylesheet class to be applied to this HTML element
+ (renders a "class" attribute).</p>
+
+ <p><strong>N.B.</strong> If present, the <code>errorStyleClass</code>
+ overrides this attribute in the event of an error for the element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>styleId</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>Identifier to be assigned to this HTML element (renders
+ an "id" attribute).</p>
+
+ <p><strong>N.B.</strong> If present, the <code>errorStyleId</code>
+ overrides this attribute in the event of an error for the element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>tabindex</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The tab order (ascending positive integers) for this element.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>title</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The advisory title for this element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>titleKey</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The message resources key for the advisory title
+ for this element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>value</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>
+ <strong>NOTE</strong>: When setting this to some value, whether
+ intentional or as the result (for example) of validation errors
+ forcing the user back to the original jsp, this value is ignored
+ by most browsers (for security reasons).
+ This means that your users will have to re-select any previously
+ selected files when submitting the form. Opera web browser will
+ prompt the user so they have a chance to abort the submit.
+ </p>
+ Value to which this field should be initialized. [Use the
+ corresponding bean property value or body content (if any) if
+ property is not specified]
+ ]]>
+ </description>
+ </attribute>
+ </tag>
+ <tag>
+ <name>form</name>
+ <tag-class>org.apache.struts.taglib.html.FormTag</tag-class>
+ <body-content>JSP</body-content>
+ <description>
+ <![CDATA[
+ <p><strong>
+ Define An Input Form
+ </strong></p>
+
+ <p>
+ Renders an HTML <form> element whose contents are described
+ by the body content of this tag. The form implicitly interacts
+ with the specified request scope or session scope bean to populate
+ the input fields with the current property values from the bean.
+ </p>
+ <p>
+ The form bean is located, and created if necessary, based on the
+ form bean specification for the associated <code>ActionMapping</code>.
+ </p>
+ ]]>
+ </description>
+ <attribute>
+ <name>action</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The URL to which this form will be submitted. This
+ value is also used to select the ActionMapping we are
+ assumed to be processing, from which we can identify
+ the appropriate form bean and scope. If a value is not
+ provided, the original URI (servletPath) for the request is
+ used. </p>
+
+ <p>If you are using extension mapping for selecting the
+ controller servlet, this value should be equal to the
+ <code>path</code> attribute of the corresponding
+ <code><action></code> element, optionally
+ followed by the correct extension suffix.</p>
+
+ <p>If you are using path mapping to select the
+ controller servlet, this value should be exactly equal
+ to the <code>path</code> attribute of the corresponding
+ <code><action></code> element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>acceptCharset</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The list of character encodings for input data that the server should
+ accept.
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.2</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>disabled</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <type>boolean</type>
+ <description>
+ <![CDATA[
+ Set to <code>true</code> if the Form's input fields should be
+ disabled.
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.7</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>enctype</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The content encoding to be used to submit this form, if the method
+ is POST. This must be set to "multipart/form-data" if you are using
+ the file tag to enable file upload. If not specified, the browser
+ default (normally "application/x-www-form-urlencoded") is used.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>focus</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The field name (among the fields on this form) to which initial
+ focus will be assigned with a JavaScript function. If not specified,
+ no special JavaScript for this purpose will be rendered.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>focusIndex</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ If the focus field is a field array, such as a radio button group, you can
+ specify the index in the array to receive focus.
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.1</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>method</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The HTTP method that will be used to submit this request
+ (GET, POST). [POST]
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onreset</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed if the form is reset.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>onsubmit</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ JavaScript event handler executed if the form is submitted.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>readonly</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <type>boolean</type>
+ <description>
+ <![CDATA[
+ Set to <code>true</code> if the Form's input fields should be
+ read only.
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.7</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>scriptLanguage</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <type>boolean</type>
+ <description>
+ <![CDATA[
+ The form's focus <script> element will not contain a language attribute
+ when this is set to false. The default is true but this property is ignored
+ in XHMTL mode.
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>style</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ CSS styles to be applied to this HTML element.
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>styleClass</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ CSS stylesheet class to be applied to this HTML element
+ (renders a "class" attribute).
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>styleId</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ Identifier to be assigned to this HTML element (renders
+ an "id" attribute).
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>target</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ Window target to which this form is submitted, such as
+ for use in framed presentations.
+ ]]>
+ </description>
+ </attribute>
+ </tag>
+ <tag>
+ <name>frame</name>
+ <tag-class>org.apache.struts.taglib.html.FrameTag</tag-class>
+ <description>
+ <![CDATA[
+ <p><strong>Render an HTML frame element</strong></p>
+
+
+ <p>Renders an HTML <code><frame></code> element
+ with processing for the <code>src</code> attribute that is
+ identical to that performed by the <code><html:link></code>
+ tag for the <code>href</code> attribute. URL rewriting will be
+ applied automatically, to maintain session state in the
+ absence of cookies.</p>
+
+ <p>The base URL for this frame is calculated based on
+ which of the following attributes you specify (you must
+ specify exactly one of them):</p>
+ <ul>
+ <li><em>forward</em> - Use the value of this attribute as the
+ name of a global <code>ActionForward</code> to be looked
+ up, and use the module-relative or context-relative
+ URI found there.</li>
+ <li><em>href</em> - Use the value of this attribute unchanged.
+ </li>
+ <li><em>page</em> - Use the value of this attribute as a
+ module-relative URI, and generate a server-relative
+ URI by including the context path and application
+ prefix.</li>
+ <li><em>action</em> - Use the value of this attribute as the
+ logical name of a global Action that contains the actual
+ content-relative URI of the destination of this transfer.</li>
+ </ul>
+
+ <p>Normally, the hyperlink you specify with one of the
+ attributes described in the previous paragraph will be left
+ unchanged (other than URL rewriting if necessary). However,
+ there are two ways you can append one or more dynamically
+ defined query parameters to the hyperlink -- specify a single
+ parameter with the <code>paramId</code> attribute (and its
+ associated attributes to select the value), or specify the
+ <code>name</code> (and optional <code>property</code>)
+ attributes to select a <code>java.util.Map</code> bean that
+ contains one or more parameter ids and corresponding values.
+ </p>
+
+ <p>To specify a single parameter, use the <code>paramId</code>
+ attribute to define the name of the request parameter to be
+ submitted. To specify the corresponding value, use one of the
+ following approaches:</p>
+ <ul>
+ <li><em>Specify only the <code>paramName</code> attribute</em>
+ - The named JSP bean (optionally scoped by the value of the
+ <code>paramScope</code> attribute) must identify a value
+ that can be converted to a String.</li>
+ <li><em>Specify both the <code>paramName</code> and
+ <code>paramProperty</code> attributes</em> - The specified
+ property getter method will be called on the JSP bean
+ identified by the <code>paramName</code> (and optional
+ <code>paramScope</code>) attributes, in order to select
+ a value that can be converted to a String.</li>
+ </ul>
+
+ <p>If you prefer to specify a <code>java.util.Map</code> that
+ contains all of the request parameters to be added to the
+ hyperlink, use one of the following techniques:</p>
+ <ul>
+ <li><em>Specify only the <code>name</code> attribute</em> -
+ The named JSP bean (optionally scoped by the value of
+ the <code>scope</code> attribute) must identify a
+ <code>java.util.Map</code> containing the parameters.</li>
+ <li><em>Specify both <code>name</code> and
+ <code>property</code> attributes</em> - The specified
+ property getter method will be called on the bean
+ identified by the <code>name</code> (and optional
+ <code>scope</code>) attributes, in order to return the
+ <code>java.util.Map</code> containing the parameters.</li>
+ </ul>
+
+ <p>As the <code>Map</code> is processed, the keys are assumed
+ to be the names of query parameters to be appended to the
+ hyperlink. The value associated with each key must be either
+ a String or a String array representing the parameter value(s),
+ or an object whose toString() method will be called.
+ If a String array is specified, more than one value for the
+ same query parameter name will be created.</p>
+
+ <p>Additionally, you can request that the current transaction
+ control token, if any, be included in the generated hyperlink
+ by setting the <code>transaction</code> attribute to
+ <code>true</code>.
+ You can also request that an anchor ("#xxx") be added to the
+ end of the URL that is created by any of the above mechanisms,
+ by using the <code>anchor</code> attribute.</p>
+
+ ]]>
+ </description>
+ <attribute>
+ <name>bundle</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ The servlet context attributes key for the MessageResources
+ instance to use. If not specified, defaults to the
+ application resources configured for our action servlet.
+
+ <dl><dt><b>Since:</b></dt>
+ <dd>Struts 1.2.5</dd></dl>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>action</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>Logical name of a global <code>Action</code> that
+ contains the actual content-relative URI of the destination
+ of this transfer. This hyperlink may be dynamically
+ modified by the inclusion of query parameters, as described
+ in the tag description. You <strong>must</strong> specify
+ exactly one of the <code>action</code> attribute, the
+ <code>forward</code> attribute, the
+ <code>href</code> attribute,
+ or the <code>page</code> attribute.</p>
+
+ <p>Additionally, you can specify a <code>module</code> prefix
+ for linking to other modules.</p>
+
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>module</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>Prefix name of a <code>Module</code> that
+ contains the action mapping for the <code>Action</code>
+ that is specified by the <code>action</code> attribute.
+ You <strong>must</strong> specify an <code>action</code>
+ attribute for this to have an effect.</p>
+
+ <p><strong>Note: </strong>Use "" to map to the default module.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>anchor</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>Optional anchor tag ("#xxx") to be added to the generated
+ hyperlink. Specify this value <strong>without</strong> any
+ "#" character.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>forward</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>Logical name of a global <code>ActionForward</code> that
+ contains the actual content-relative URI of the destination
+ of this transfer. This hyperlink may be dynamically
+ modified by the inclusion of query parameters, as described
+ in the tag description. You <strong>must</strong> specify
+ exactly one of the <code>action</code> attribute, the
+ <code>forward</code> attribute, the
+ <code>href</code> attribute,
+ or the <code>page</code> attribute.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>frameborder</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>Should a frame border be generated around this frame (1)
+ or not (0)?</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>frameName</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>Value for the <code>name</code> attribute of the rendered
+ <code><frame></code> element.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>href</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The URL to which this hyperlink will transfer control
+ if activated. This hyperlink may be dynamically modified
+ by the inclusion of query parameters, as described in the
+ tag description. You <strong>must</strong> specify
+ exactly one of the <code>action</code> attribute, the
+ <code>forward</code> attribute, the
+ <code>href</code> attribute,
+ or the <code>page</code> attribute.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>longdesc</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>URI of a long description of the frame. This description
+ should supplement the short description provided by the
+ <code>title</code> attribute, and may be particularly useful
+ for non-visual user agents.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>marginheight</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <type>java.lang.Integer</type>
+ <description>
+ <![CDATA[
+ <p>The amount of space (in pixels) to be left between the
+ frame's contents and its top and bottom margins.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>marginwidth</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <type>java.lang.Integer</type>
+ <description>
+ <![CDATA[
+ <p>The amount of space (in pixels) to be left between the
+ frame's contents and its left and right margins.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>name</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The name of a JSP bean that contains a <code>Map</code>
+ representing the query parameters (if <code>property</code>
+ is not specified), or a JSP bean whose property getter is
+ called to return a <code>Map</code> (if <code>property</code>
+ is specified).</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>noresize</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <type>boolean</type>
+ <description>
+ <![CDATA[
+ <p>Should users be disallowed from resizing the frame?
+ (true, false).</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>page</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The module-relative path (beginning with a "/"
+ character) to which this hyperlink will transfer control
+ if activated. This hyperlink may be dynamically modified
+ by the inclusion of query parameters, as described in the
+ tag description. You <strong>must</strong> specify exactly
+ one of the <code>action</code> attribute, the
+ <code>forward</code> attribute, the
+ <code>href</code> attribute,
+ or the <code>page</code> attribute.</p>
+ ]]>
+ </description>
+ </attribute>
+ <attribute>
+ <name>paramId</name>
+ <required>false</required>
+ <rtexprvalue>true</rtexprvalue>
+ <description>
+ <![CDATA[
+ <p>The name of the request parameter that will be dynamically
[... 6457 lines stripped ...]
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org