You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@struts.apache.org by ws...@apache.org on 2005/09/19 01:33:44 UTC
svn commit: r290010 [4/9] - in /struts/taglib/trunk/src/tld: struts-bean.tld
struts-html.tld struts-logic.tld struts-nested.tld
Modified: struts/taglib/trunk/src/tld/struts-html.tld
URL: http://svn.apache.org/viewcvs/struts/taglib/trunk/src/tld/struts-html.tld?rev=290010&r1=290009&r2=290010&view=diff
==============================================================================
--- struts/taglib/trunk/src/tld/struts-html.tld (original)
+++ struts/taglib/trunk/src/tld/struts-html.tld Sun Sep 18 16:33:09 2005
@@ -1,8674 +1,8674 @@
-<?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>
- ]]>
- </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>
- <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>
- <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>
- <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>
- <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>
- <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>
- <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>
- <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>
- <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>
- <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>
- <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>
- <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>
- <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>
- <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[
[... 15089 lines stripped ...]
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org