Return-Path:
Delivered-To: apmail-struts-dev-archive@www.apache.org
Received: (qmail 83883 invoked from network); 19 Aug 2005 03:13:51 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
by minotaur.apache.org with SMTP; 19 Aug 2005 03:13:51 -0000
Received: (qmail 91307 invoked by uid 500); 19 Aug 2005 03:13:27 -0000
Delivered-To: apmail-struts-dev-archive@struts.apache.org
Received: (qmail 91262 invoked by uid 500); 19 Aug 2005 03:13:26 -0000
Mailing-List: contact dev-help@struts.apache.org; run by ezmlm
Precedence: bulk
List-Unsubscribe:
List-Help:
List-Post:
List-Id: "Struts Developers List"
Reply-To: "Struts Developers List"
Delivered-To: mailing list dev@struts.apache.org
Received: (qmail 91045 invoked by uid 500); 19 Aug 2005 03:13:24 -0000
Received: (qmail 90774 invoked by uid 99); 19 Aug 2005 03:13:22 -0000
Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49)
by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 18 Aug 2005 20:13:21 -0700
X-ASF-Spam-Status: No, hits=-9.8 required=10.0
tests=ALL_TRUSTED,NO_REAL_NAME
X-Spam-Check-By: apache.org
Received: from [209.237.227.194] (HELO minotaur.apache.org) (209.237.227.194)
by apache.org (qpsmtpd/0.29) with SMTP; Thu, 18 Aug 2005 20:13:36 -0700
Received: (qmail 83590 invoked by uid 65534); 19 Aug 2005 03:13:15 -0000
Message-ID: <20050819031315.83588.qmail@minotaur.apache.org>
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r233411 [3/3] - in /struts/taglib/trunk/doc:
stylesheets/tld.xsl
userGuide/struts-bean.xml userGuide/struts-html.xml
userGuide/struts-logic.xml userGuide/struts-nested.xml
Date: Fri, 19 Aug 2005 03:13:13 -0000
To: commits@struts.apache.org
From: wsmoak@apache.org
X-Mailer: svnmailer-1.0.3
X-Virus-Checked: Checked by ClamAV on apache.org
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N
Modified: struts/taglib/trunk/doc/userGuide/struts-logic.xml
URL: http://svn.apache.org/viewcvs/struts/taglib/trunk/doc/userGuide/struts-logic.xml?rev=233411&r1=233410&r2=233411&view=diff
==============================================================================
--- struts/taglib/trunk/doc/userGuide/struts-logic.xml (original)
+++ struts/taglib/trunk/doc/userGuide/struts-logic.xml Thu Aug 18 20:12:53 2005
@@ -9,12 +9,12 @@
- 1.2
- 1.1
+ 1.3
+ 1.2
logic
Struts Logic Tags
http://struts.apache.org/tags-logic
-
+ This tag library contains tags that are useful in managing conditional
generation of output text, looping over object collections for
repetitive generation of output text, and application flow management.
@@ -63,7 +63,7 @@
problem, it is passed to the error page as a request attribute under key
org.apache.struts.action.EXCEPTION
.
-
+ ]]>
@@ -76,7 +76,7 @@
org.apache.struts.taglib.logic.EmptyTag
JSP
Struts 1.1
-
+ This tag evaluates its nested body content only if the specified value
is either absent (i.e. null
), an empty string (i.e. a
java.lang.String
with a length of zero), or an empty
@@ -93,39 +93,39 @@
</c:if>
-
+ ]]>
name
false
true
-
+ The variable to be compared is the JSP bean specified by this
attribute, if property
is not specified, or the value
of the specified property of this bean, if property
is specified.
-
+ ]]>
property
false
true
-
+ The variable to be compared is the property (of the bean specified
by the name
attribute) specified by this attribute.
The property reference can be simple, nested, and/or indexed.
-
+ ]]>
scope
false
true
-
+ The bean scope within which to search for the bean named by the
name
property, or "any scope" if not specified.
-
+ ]]>
@@ -140,85 +140,85 @@
org.apache.struts.taglib.logic.EqualTag
JSP
-
+ Compares the variable specified by one of the selector attributes
against the specified constant value. The nested body content of this
tag is evaluated if the variable and value are equal.
-
+ ]]>
cookie
false
true
-
+ The variable to be compared is the value of the cookie whose
name is specified by this attribute.
-
+ ]]>
header
false
true
-
+ The variable to be compared is the value of the header whose
name is specified by this attribute. The name match is performed
in a case insensitive manner.
-
+ ]]>
name
false
true
-
+ The variable to be compared is the JSP bean specified by this
attribute, if property
is not specified, or the value
of the specified property of this bean, if property
is specified.
-
+ ]]>
parameter
false
true
-
+ The variable to be compared is the first, or only, value of the
request parameter specified by this attribute.
-
+ ]]>
property
false
true
-
+ The variable to be compared is the property (of the bean specified
by the name
attribute) specified by this attribute.
The property reference can be simple, nested, and/or indexed.
-
+ ]]>
scope
false
true
-
+ The bean scope within which to search for the bean named by the
name
property, or "any scope" if not specified.
-
+ ]]>
value
true
true
-
+ The constant value to which the variable, specified by other
attribute(s) of this tag, will be compared.
-
+ ]]>
@@ -233,25 +233,25 @@
org.apache.struts.taglib.logic.ForwardTag
empty
-
+ Performs a PageContext.forward()
or
HttpServletResponse.sendRedirect()
call for the global
ActionForward
entry for the specified name. URL
rewriting will occur automatically if a redirect is performed.
-
+ ]]>
name
true
true
-
+
The logical name of the global ActionForward
entry
that identifies the destination, and forwarding approach, to be used.
Note: forwarding to Tiles definitions is not supported
from this tag. You should forward to them from an Action subclass.
-
+ ]]>
@@ -266,85 +266,85 @@
org.apache.struts.taglib.logic.GreaterEqualTag
JSP
-
+ Compares the variable specified by one of the selector attributes
against the specified constant value. The nested body content of this
tag is evaluated if the variable is greater than or equal
to the value.
-
+ ]]>
cookie
false
true
-
+ The variable to be compared is the value of the cookie whose
name is specified by this attribute.
-
+ ]]>
header
false
true
-
+ The variable to be compared is the value of the header whose
name is specified by this attribute. The name match is performed
in a case insensitive manner.
-
+ ]]>
name
false
true
-
+ The variable to be compared is the JSP bean specified by this
attribute, if property
is not specified, or the value
of the specified property of this bean, if property
is specified.
-
+ ]]>
parameter
false
true
-
+ The variable to be compared is the first, or only, value of the
request parameter specified by this attribute.
-
+ ]]>
property
false
true
-
+ The variable to be compared is the property (of the bean specified
by the name
attribute) specified by this attribute.
The property reference can be simple, nested, and/or indexed.
-
+ ]]>
scope
false
true
-
+ The bean scope within which to search for the bean named by the
name
property, or "any scope" if not specified.
-
+ ]]>
value
true
true
-
+ The constant value to which the variable, specified by other
attribute(s) of this tag, will be compared.
-
+ ]]>
@@ -359,85 +359,85 @@
org.apache.struts.taglib.logic.GreaterThanTag
JSP
-
+ Compares the variable specified by one of the selector attributes
against the specified constant value. The nested body content of this
tag is evaluated if the variable is greater than
the value.
-
+ ]]>
cookie
false
true
-
+ The variable to be compared is the value of the cookie whose
name is specified by this attribute.
-
+ ]]>
header
false
true
-
+ The variable to be compared is the value of the header whose
name is specified by this attribute. The name match is performed
in a case insensitive manner.
-
+ ]]>
name
false
true
-
+ The variable to be compared is the JSP bean specified by this
attribute, if property
is not specified, or the value
of the specified property of this bean, if property
is specified.
-
+ ]]>
parameter
false
true
-
+ The variable to be compared is the first, or only, value of the
request parameter specified by this attribute.
-
+ ]]>
property
false
true
-
+ The variable to be compared is the property (of the bean specified
by the name
attribute) specified by this attribute.
The property reference can be simple, nested, or indexed.
-
+ ]]>
scope
false
true
-
+ The bean scope within which to search for the bean named by the
name
property, or "any scope" if not specified.
-
+ ]]>
value
true
true
-
+ The constant value to which the variable, specified by other
attribute(s) of this tag, will be compared.
-
+ ]]>
@@ -452,7 +452,7 @@
org.apache.struts.taglib.logic.IterateTag
org.apache.struts.taglib.logic.IterateTei
JSP
-
+ Repeats the nested body content of this tag once for every element
of the specified collection, which must be an Iterator
,
a Collection
, a Map
(whose values are to be
@@ -505,109 +505,109 @@
iteration. You can use the <logic:present>
and
<logic:notPresent>
tags to test for this case.
-
+ ]]>
collection
false
true
-
+ A runtime expression that evaluates to a collection (conforming to
the requirements listed above) to be iterated over.
-
+ ]]>
id
true
false
-
+ The name of a page scope JSP bean that will contain the current
element of the collection on each iteration, if it is not
null
.
-
+ ]]>
indexId
false
false
-
+ The name of a page scope JSP bean that will contain the current
index of the collection on each iteration.
-
+ ]]>
length
false
true
-
+ The maximum number of entries (from the underlying collection) to be
iterated through on this page. This can be either an integer that
directly expresses the desired value, or the name of a JSP bean (in
any scope) of type java.lang.Integer
that defines the
desired value. If not present, there will be no limit on the number
of iterations performed.
-
+ ]]>
name
false
true
-
+ The name of the JSP bean containing the collection to be iterated
(if property
is not specified), or the JSP bean whose
property getter returns the collection to be iterated (if
property
is specified).
-
+ ]]>
offset
false
true
-
+ The zero-relative index of the starting point at which entries from
the underlying collection will be iterated through. This can be either
an integer that directly expresses the desired value, or the name of a
JSP bean (in any scope) of type java.lang.Integer
that
defines the desired value. If not present, zero is assumed (meaning
that the collection will be iterated from the beginning.
-
+ ]]>
property
false
true
-
+ Name of the property, of the JSP bean specified by name
,
whose getter returns the collection to be iterated.
-
+ ]]>
scope
false
true
-
+ The bean scope within which to search for the bean named by the
name
property, or "any scope" if not specified.
-
+ ]]>
type
false
true
-
+ Fully qualified Java class name of the element to be exposed through
the JSP bean named from the id
attribute. If not present,
no type conversions will be performed. NOTE: The actual elements of
the collection must be assignment-compatible with this class, or a
request time ClassCastException will occur.
-
+ ]]>
@@ -622,85 +622,85 @@
org.apache.struts.taglib.logic.LessEqualTag
JSP
-
+ Compares the variable specified by one of the selector attributes
against the specified constant value. The nested body content of this
tag is evaluated if the variable is less than or equal
to the value.
-
+ ]]>
cookie
false
true
-
+ The variable to be compared is the value of the cookie whose
name is specified by this attribute.
-
+ ]]>
header
false
true
-
+ The variable to be compared is the value of the header whose
name is specified by this attribute. The name match is performed
in a case insensitive manner.
-
+ ]]>
name
false
true
-
+ The variable to be compared is the JSP bean specified by this
attribute, if property
is not specified, or the value
of the specified property of this bean, if property
is specified.
-
+ ]]>
parameter
false
true
-
+ The variable to be compared is the first, or only, value of the
request parameter specified by this attribute.
-
+ ]]>
property
false
true
-
+ The variable to be compared is the property (of the bean specified
by the name
attribute) specified by this attribute.
The property reference can be simple, nested, or indexed.
-
+ ]]>
scope
false
true
-
+ The bean scope within which to search for the bean named by the
name
property, or "any scope" if not specified.
-
+ ]]>
value
true
true
-
+ The constant value to which the variable, specified by other
attribute(s) of this tag, will be compared.
-
+ ]]>
@@ -715,85 +715,85 @@
org.apache.struts.taglib.logic.LessThanTag
JSP
-
+ Compares the variable specified by one of the selector attributes
against the specified constant value. The nested body content of this
tag is evaluated if the variable is less than
the value.
-
+ ]]>
cookie
false
true
-
+ The variable to be compared is the value of the cookie whose
name is specified by this attribute.
-
+ ]]>
header
false
true
-
+ The variable to be compared is the value of the header whose
name is specified by this attribute. The name match is performed
in a case insensitive manner.
-
+ ]]>
name
false
true
-
+ The variable to be compared is the JSP bean specified by this
attribute, if property
is not specified, or the value
of the specified property of this bean, if property
is specified.
-
+ ]]>
parameter
false
true
-
+ The variable to be compared is the first, or only, value of the
request parameter specified by this attribute.
-
+ ]]>
property
false
true
-
+ The variable to be compared is the property (of the bean specified
by the name
attribute) specified by this attribute.
The property reference can be simple, nested, and/or indexed.
-
+ ]]>
scope
false
true
-
+ The bean scope within which to search for the bean named by the
name
property, or "any scope" if not specified.
-
+ ]]>
value
true
true
-
+ The constant value to which the variable, specified by other
attribute(s) of this tag, will be compared.
-
+ ]]>
@@ -808,97 +808,97 @@
org.apache.struts.taglib.logic.MatchTag
JSP
-
+ Matches the variable specified by one of the selector attributes
(as a String) against the specified constant value. If the value is
a substring (appropriately limited by the location
attribute), the nested body content of this tag is evaluated.
-
+ ]]>
cookie
false
true
-
+ The variable to be matched is the value of the cookie whose
name is specified by this attribute.
-
+ ]]>
header
false
true
-
+ The variable to be matched is the value of the header whose
name is specified by this attribute. The name match is performed
in a case insensitive manner.
-
+ ]]>
location
false
true
-
+ If not specified, a match between the variable and the value may
occur at any position within the variable string. If specified, the
match must occur at the specified location (either start
or end
) of the variable string.
-
+ ]]>
name
false
true
-
+ The variable to be matched is the JSP bean specified by this
attribute, if property
is not specified, or the value
of the specified property of this bean, if property
is specified.
-
+ ]]>
parameter
false
true
-
+ The variable to be matched is the first, or only, value of the
request parameter specified by this attribute.
-
+ ]]>
property
false
true
-
+ The variable to be matched is the property (of the bean specified
by the name
attribute) specified by this attribute.
The property reference can be simple, nested, and/or indexed.
-
+ ]]>
scope
false
true
-
+ The bean scope within which to search for the bean named by the
name
property, or "any scope" if not specified.
-
+ ]]>
value
true
true
-
+ The constant value which is checked for existence as a substring
of the specified variable.
-
+ ]]>
@@ -913,41 +913,41 @@
org.apache.struts.taglib.logic.MessagesNotPresentTag
JSP
Struts 1.1
-
+ Evaluates the nested body content of this tag if
an ActionMessages
object, ActionErrors
object, a String,
or a String array is not in request scope. If
such a bean is not found, nothing will be rendered.
-
+ ]]>
name
false
true
-
+ The parameter key to retrieve the message from request scope.
-
+ ]]>
property
false
true
-
+ Name of the property for which messages should be
retrieved. If not specified, all messages (regardless
of property) are retrieved.
-
+ ]]>
message
false
true
-
+ By default the tag will retrieve the request scope bean it will
iterate over from the Globals.ERROR_KEY
constant string,
but if this attribute is set to 'true' the request scope bean
@@ -955,7 +955,7 @@
constant string. Also if this is set to 'true', any value
assigned to the name attribute will be ignored.
-
+ ]]>
@@ -970,41 +970,41 @@
org.apache.struts.taglib.logic.MessagesPresentTag
JSP
Struts 1.1
-
+ Evaluates the nested body content of this tag if
an ActionMessages
object, ActionErrors
object, a String,
or a String array is in request scope. If
such a bean is not found, nothing will be rendered.
-
+ ]]>
name
false
true
-
+ The parameter key to retrieve the message from request scope.
-
+ ]]>
property
false
true
-
+ Name of the property for which messages should be
retrieved. If not specified, all messages (regardless
of property) are retrieved.
-
+ ]]>
message
false
true
-
+ By default the tag will retrieve the request scope bean it will
iterate over from the Globals.ERROR_KEY
constant string,
but if this attribute is set to 'true' the request scope bean
@@ -1012,7 +1012,7 @@
constant string. Also if this is set to 'true', any value
assigned to the name attribute will be ignored.
-
+ ]]>
@@ -1028,7 +1028,7 @@
org.apache.struts.taglib.logic.NotEmptyTag
JSP
-
+ This tag evaluates its nested body content only if the specified value
is present (i.e. not null
) and is not an empty string (i.e. a
java.lang.String
with a length of zero).
@@ -1043,39 +1043,39 @@
</c:if>
-
+ ]]>
name
false
true
-
+ The variable to be compared is the JSP bean specified by this
attribute, if property
is not specified, or the value
of the specified property of this bean, if property
is specified.
-
+ ]]>
property
false
true
-
+ The variable to be compared is the property (of the bean specified
by the name
attribute) specified by this attribute.
The property reference can be simple, nested, and/or indexed.
-
+ ]]>
scope
false
true
-
+ The bean scope within which to search for the bean named by the
name
property, or "any scope" if not specified.
-
+ ]]>
@@ -1090,85 +1090,85 @@
org.apache.struts.taglib.logic.NotEqualTag
JSP
-
+ Compares the variable specified by one of the selector attributes
against the specified constant value. The nested body content of this
tag is evaluated if the variable and value are not equal.
-
+ ]]>
cookie
false
true
-
+ The variable to be compared is the value of the cookie whose
name is specified by this attribute.
-
+ ]]>
header
false
true
-
+ The variable to be compared is the value of the header whose
name is specified by this attribute. The name match is performed
in a case insensitive manner.
-
+ ]]>
name
false
true
-
+ The variable to be compared is the JSP bean specified by this
attribute, if property
is not specified, or the value
of the specified property of this bean, if property
is specified.
-
+ ]]>
parameter
false
true
-
+ The variable to be compared is the first, or only, value of the
request parameter specified by this attribute.
-
+ ]]>
property
false
true
-
+ The variable to be compared is the property (of the bean specified
by the name
attribute) specified by this attribute.
The property reference can be simple, nested, and/or indexed.
-
+ ]]>
scope
false
true
-
+ The bean scope within which to search for the bean named by the
name
property, or "any scope" if not specified.
-
+ ]]>
value
true
true
-
+ The constant value to which the variable, specified by other
attribute(s) of this tag, will be compared.
-
+ ]]>
@@ -1183,97 +1183,97 @@
org.apache.struts.taglib.logic.NotMatchTag
JSP
-
+ Matches the variable specified by one of the selector attributes
(as a String) against the specified constant value. If the value is
not a substring (appropriately limited by the location
attribute), the nested body content of this tag is evaluated.
-
+ ]]>
cookie
false
true
-
+ The variable to be matched is the value of the cookie whose
name is specified by this attribute.
-
+ ]]>
header
false
true
-
+ The variable to be matched is the value of the header whose
name is specified by this attribute. The name match is performed
in a case insensitive manner.
-
+ ]]>
location
false
true
-
+ If not specified, a match between the variable and the value may
occur at any position within the variable string. If specified, the
match must occur at the specified location (either start
or end
) of the variable string.
-
+ ]]>
name
false
true
-
+ The variable to be matched is the JSP bean specified by this
attribute, if property
is not specified, or the value
of the specified property of this bean, if property
is specified.
-
+ ]]>
parameter
false
true
-
+ The variable to be matched is the first, or only, value of the
request parameter specified by this attribute.
-
+ ]]>
property
false
true
-
+ The variable to be matched is the property (of the bean specified
by the name
attribute) specified by this attribute.
The property reference can be simple, nested, and/or indexed.
-
+ ]]>
scope
false
true
-
+ The bean scope within which to search for the bean named by the
name
property, or "any scope" if not specified.
-
+ ]]>
value
true
true
-
+ The constant value which is checked for existence as a substring
of the specified variable.
-
+ ]]>
@@ -1288,96 +1288,96 @@
org.apache.struts.taglib.logic.NotPresentTag
JSP
-
+ Depending on which attribute is specified, this tag checks the
current request, and evaluates the nested body content of this tag
only if the specified value is not present. Only one
of the attributes may be used in one occurrence of this tag, unless
you use the property
attribute, in which case the
name
attribute is also required.
-
+ ]]>
cookie
false
true
-
+ Checks for the existence of a cookie with the specified name.
-
+ ]]>
header
false
true
-
+ Checks for the existence of an HTTP header with the specified
name. The name match is performed in a case insensitive manner.
-
+ ]]>
name
false
true
-
+ Checks for the existence of a JSP bean, in any scope, with the
specified name. If property
is also specified, checks
for a non-null property value for the specified property.
-
+ ]]>
parameter
false
true
-
+ Checks for the existence of at least one occurrence of the
specified request parameter on this request, even if the parameter
value is a zero-length string.
-
+ ]]>
property
false
true
-
+ Checks for the existence of a non-null property value, returned
by a property getter method on the JSP bean (in any scope) that is
specified by the name
attribute. Property references
can be simple, nested, and/or indexed.
-
+ ]]>
role
false
true
-
+ Checks whether the currently authenticated user (if any) has been
associated with the specified security role.
-
+ ]]>
scope
false
true
-
+ The bean scope within which to search for the bean named by the
name
property, or "any scope" if not specified.
-
+ ]]>
user
false
true
-
+ Checks whether the currently authenticated user principal has the
specified name.
-
+ ]]>
@@ -1392,100 +1392,100 @@
org.apache.struts.taglib.logic.PresentTag
JSP
-
+ Depending on which attribute is specified, this tag checks the
current request, and evaluates the nested body content of this tag
only if the specified value is present. Only one
of the attributes may be used in one occurrence of this tag, unless
you use the property
attribute, in which case the
name
attribute is also required.
-
+ ]]>
cookie
false
true
-
+ Checks for the existence of a cookie with the specified name.
-
+ ]]>
header
false
true
-
+ Checks for the existence of an HTTP header with the specified
name. The name match is performed in a case insensitive manner.
-
+ ]]>
name
false
true
-
+ Checks for the existence of a JSP bean, in any scope, with the
specified name. If property
is also specified, checks
for a non-null property value for the specified property.
-
+ ]]>
parameter
false
true
-
+ Checks for the existence of at least one occurrence of the
specified request parameter on this request, even if the parameter
value is a zero-length string.
-
+ ]]>
property
false
true
-
+ Checks for the existence of a non-null property value, returned
by a property getter method on the JSP bean (in any scope) that is
specified by the name
attribute. Property references
can be simple, nested, and/or indexed.
-
+ ]]>
role
false
true
-
+ Checks whether the currently authenticated user (if any) has been
associated with any of the specified security roles. Use a comma-delimited
list to check for multiple roles. Example:
<logic:present role="role1,role2,role3">
code.....
</logic:present>
-
+ ]]>
scope
false
true
-
+ The bean scope within which to search for the bean named by the
name
property, or "any scope" if not specified.
-
+ ]]>
user
false
true
-
+ Checks whether the currently authenticated user principal has the
specified name.
-
+ ]]>
@@ -1497,7 +1497,7 @@
Render an HTTP Redirect
org.apache.struts.taglib.logic.RedirectTag
empty
-
+ Performs an HttpServletResponse.sendRedirect()
call to the hyperlink specified by the attributes to this
@@ -1570,13 +1570,13 @@
a String or a String array representing the parameter value(s).
If a String array is specified, more than one value for the
same query parameter name will be created.
-
+ ]]>
action
false
true
-
+ Logical name of a global Action
that
contains the actual content-relative URI of the destination
of this transfer. This hyperlink may be dynamically
@@ -1586,25 +1586,25 @@
forward
attribute, the
href
attribute,
or the page
attribute.
-
+ ]]>
anchor
false
true
-
+ Optional anchor tag ("#xxx") to be added to the generated
hyperlink. Specify this value without any
"#" character.
-
+ ]]>
forward
false
true
-
+ Logical name of a global ActionForward
that
contains the actual content-relative URI of the destination
of this redirect. This URI may be dynamically
@@ -1613,14 +1613,14 @@
exactly one of the forward
attribute, the
href
attribute, the linkName
attribute, or the page
attribute.
-
+ ]]>
href
false
true
-
+ The URL to which this redirect will transfer control.
This URL may be dynamically modified
by the inclusion of query parameters, as described in the
@@ -1628,27 +1628,27 @@
exactly one of the forward
attribute, the
href
attribute, the linkName
attribute, or the page
attribute.
-
+ ]]>
name
false
true
-
+ The name of a JSP bean that contains a Map
representing the query parameters (if property
is not specified), or a JSP bean whose property getter is
called to return a Map
(if property
is specified).
-
+ ]]>
page
false
true
-
+ The context-relative path (beginning with a "/"
character) to which this hyperlink will transfer control
if activated. This hyperlink may be dynamically modified
@@ -1657,27 +1657,27 @@
one of the forward
attribute, the
href
attribute, the linkName
attribute, or the page
attribute.
-
+ ]]>
paramId
false
true
-
+ The name of the request parameter that will be dynamically
added to the generated hyperlink. The corresponding value is
defined by the paramName
and (optional)
paramProperty
attributes, optionally scoped by
the paramScope
attribute
-
+ ]]>
paramName
false
true
-
+ The name of a JSP bean that is a String containing the
value for the request parameter named by paramId
(if paramProperty
is not specified), or a JSP
@@ -1685,79 +1685,79 @@
(if paramProperty
is specified). The JSP bean
is constrained to the bean scope specified by the
paramScope
property, if it is specified.
-
+ ]]>
paramProperty
false
true
-
+ The name of a property of the bean specified by the
paramName
attribute, whose return value must
be a String containing the value of the request parameter
(named by the paramId
attribute) that will be
dynamically added to this hyperlink.
-
+ ]]>
paramScope
false
true
-
+ The scope within which to search for the bean specified
by the paramName
attribute. If not specified,
all scopes are searched.
-
+ ]]>
property
false
true
-
+ The name of a property of the bean specified by the
name
attribute, whose return value must be
a java.util.Map
containing the query parameters
to be added to the hyperlink. You must
specify the name
attribute if you specify
this attribute.
-
+ ]]>
scope
false
true
-
+ The scope within which to search for the bean specified
by the name
attribute. If not specified, all
scopes are searched.
-
+ ]]>
transaction
false
true
-
+ Set to true
if you want the current
transaction control token included in the generated
URL for this redirect.
-
+ ]]>
useLocalEncoding
false
true
-
+ If set to true
, LocalCharacterEncoding will be
used, that is, the characterEncoding set to the HttpServletResponse,
as prefered character encoding rather than UTF-8, when
URLEncoding is done on parameters of the URL.
-
+ ]]>
Modified: struts/taglib/trunk/doc/userGuide/struts-nested.xml
URL: http://svn.apache.org/viewcvs/struts/taglib/trunk/doc/userGuide/struts-nested.xml?rev=233411&r1=233410&r2=233411&view=diff
==============================================================================
--- struts/taglib/trunk/doc/userGuide/struts-nested.xml (original)
+++ struts/taglib/trunk/doc/userGuide/struts-nested.xml Thu Aug 18 20:12:53 2005
@@ -8,12 +8,12 @@
- 1.2
- 1.1
+ 1.3
+ 1.2
nested
Struts Nested Tags
http://struts.apache.org/tags-nested
-
+ [Since Struts 1.1]
This tag library brings a nested context to the functionality of the
Struts custom tag library.
@@ -67,9 +67,9 @@
attributes. These uses will then fall outside the nested context, and will
most likely cause error. To take advantage of these options, markup using
the original tag for these cases. For an example see the
- <nested:options>
tag.
+ <nested:options>
tag.
-
+ ]]>
nest
@@ -78,7 +78,7 @@
org.apache.struts.taglib.nested.NestedPropertyTag
JSP
-
+
This tag provides a simple method of defining a logical nesting level in
the nested hierarchy. It run no explicit logic, is simply a place holder.
@@ -104,15 +104,15 @@
<nested:write property="propertyThree" />
</nested:nest >
-
+ ]]>
property
false
true
-
+
+ ]]>
@@ -124,37 +124,37 @@
org.apache.struts.taglib.nested.NestedWriteNestingTag
org.apache.struts.taglib.nested.NestedWriteNestingTei
JSP
-
+
+ ]]>
property
false
true
-
+
+ ]]>
id
false
true
-
+ id is supplied, then what would have been written out into the
response stream, will instead be made available as a String object
defined by the variable name provided.
-
+ ]]>
filter
false
true
-
+
+ ]]>
@@ -162,7 +162,7 @@
To start off a nested hierarchy without the need for a form
org.apache.struts.taglib.nested.NestedRootTag
JSP
-
+
This tag is provided to allow the nested tags to find a common bean
reference without the need for a form and its relative overhead. As
@@ -186,15 +186,15 @@
waiting for it. It was made this way so that you could use separate
beans within a JSP that itself is an inclusion into another.
-
+ ]]>
name
false
true
-
+
+ ]]>
@@ -212,13 +212,13 @@
org.apache.struts.taglib.nested.bean.NestedDefineTag
org.apache.struts.taglib.nested.bean.NestedDefineTei
empty
-
+ This tag is an extension of the
- <bean:define>
+ <bean:define>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
id
@@ -272,13 +272,13 @@
org.apache.struts.taglib.nested.bean.NestedMessageTag
empty
-
+ This tag is an extension of the
- <bean:message>
+ <bean:message>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
arg0
@@ -357,13 +357,13 @@
org.apache.struts.taglib.nested.bean.NestedSizeTag
org.apache.struts.taglib.bean.SizeTei
empty
-
+ This tag is an extension of the
- <bean:size>
+ <bean:size>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
collection
@@ -406,13 +406,13 @@
org.apache.struts.taglib.nested.bean.NestedWriteTag
empty
-
+ This tag is an extension of the
- <bean:write>
+ <bean:write>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
bundle
@@ -479,13 +479,13 @@
checkbox
Nested Extension - Render A Checkbox Input Field
org.apache.struts.taglib.nested.html.NestedCheckboxTag
-
+ This tag is an extension of the
- <html:checkbox>
+ <html:checkbox>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
accesskey
@@ -695,13 +695,13 @@
org.apache.struts.taglib.nested.html.NestedErrorsTag
empty
-
+ This tag is an extension of the
- <html:errors>
+ <html:errors>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
bundle
@@ -763,13 +763,13 @@
Render A File Select Input Field
org.apache.struts.taglib.nested.html.NestedFileTag
-
+ This tag is an extension of the
- <html:file>
+ <html:file>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
accesskey
@@ -992,13 +992,13 @@
Nested Extension - Define An Input Form
org.apache.struts.taglib.nested.html.NestedFormTag
JSP
-
+ This tag is an extension of the
- <html:form>
+ <html:form>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
action
@@ -1100,13 +1100,13 @@
Render A Hidden Field
org.apache.struts.taglib.nested.html.NestedHiddenTag
-
+ This tag is an extension of the
- <html:hidden>
+ <html:hidden>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
alt
@@ -1181,13 +1181,13 @@
Render an input tag of type "image"
org.apache.struts.taglib.nested.html.NestedImageTag
-
+ This tag is an extension of the
- <html:image>
+ <html:image>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
accesskey
@@ -1394,13 +1394,13 @@
Nested Extension - Render an HTML "img" tag
org.apache.struts.taglib.nested.html.NestedImgTag
empty
-
+ This tag is an extension of the
- <html:img>
+ <html:img>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
accesskey
@@ -1630,13 +1630,13 @@
link
Nested Extension - Render an HTML anchor or hyperlink
org.apache.struts.taglib.nested.html.NestedLinkTag
-
+ This tag is an extension of the
- <html:link>
+ <html:link>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
accesskey
@@ -1883,13 +1883,13 @@
org.apache.struts.taglib.nested.html.NestedMessagesTag
org.apache.struts.taglib.html.MessagesTei
JSP
-
+ This tag is an extension of the
- <html:messages>
+ <html:messages>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
id
@@ -1947,13 +1947,13 @@
Render A Checkbox Input Field
org.apache.struts.taglib.nested.html.NestedMultiboxTag
-
+ This tag is an extension of the
- <html:multibox>
+ <html:multibox>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
accesskey
@@ -2155,9 +2155,9 @@
Nested Extension - Render a Collection of Select Options
org.apache.struts.taglib.nested.html.NestedOptionsTag
empty
-
+ This tag is an extension of the
- <html:options>
+ <html:options>
tag. Please consult its documentation for information on tag attributes
and usage details.
@@ -2185,7 +2185,7 @@
valueProperty="valueProperty" />
</nested:nest >
-
+ ]]>
collection
@@ -2244,14 +2244,14 @@
org.apache.struts.taglib.nested.html.NestedOptionsCollectionTag
empty
-
+ This tag is an extension of the
- <html:optionsCollection>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
filter
@@ -2302,13 +2302,13 @@
Render A Password Input Field
org.apache.struts.taglib.nested.html.NestedPasswordTag
-
+ This tag is an extension of the
- <html:password>
+ <html:password>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
@@ -2542,13 +2542,13 @@
Render A Radio Button Input Field
org.apache.struts.taglib.nested.html.NestedRadioTag
-
+ This tag is an extension of the
- <html:radio>
+ <html:radio>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
accesskey
@@ -2739,13 +2739,13 @@
org.apache.struts.taglib.nested.html.NestedSelectTag
JSP
-
+ This tag is an extension of the
- <html:select>
+ <html:select>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
accesskey
@@ -2964,13 +2964,13 @@
submit
Nested Extension - Render A Submit Button
org.apache.struts.taglib.nested.html.NestedSubmitTag
-
+ This tag is an extension of the
- <html:submit>
+ <html:submit>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
accesskey
@@ -3145,13 +3145,13 @@
Render An Input Field of Type text
org.apache.struts.taglib.nested.html.NestedTextTag
-
+ This tag is an extension of the
- <html:text>
+ <html:text>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
@@ -3375,13 +3375,13 @@
textarea
Nested Extension - Render A Textarea
org.apache.struts.taglib.nested.html.NestedTextareaTag
-
+ This tag is an extension of the
- <html:textarea>
+ <html:textarea>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
accesskey
@@ -3618,13 +3618,13 @@
org.apache.struts.taglib.nested.logic.NestedEmptyTag
JSP
-
+ This tag is an extension of the
- <logic:empty>
+ <logic:empty>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
name
@@ -3654,13 +3654,13 @@
org.apache.struts.taglib.nested.logic.NestedEqualTag
JSP
-
+ This tag is an extension of the
- <logic:equal>
+ <logic:equal>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
cookie
@@ -3713,13 +3713,13 @@
org.apache.struts.taglib.nested.logic.NestedGreaterEqualTag
JSP
-
+ This tag is an extension of the
- <logic:greaterEqual>
+ <logic:greaterEqual>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
cookie
@@ -3773,13 +3773,13 @@
org.apache.struts.taglib.nested.logic.NestedGreaterThanTag
JSP
-
+ This tag is an extension of the
- <logic:greaterThan>
+ <logic:greaterThan>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
cookie
@@ -3833,13 +3833,13 @@
org.apache.struts.taglib.nested.logic.NestedIterateTag
org.apache.struts.taglib.nested.logic.NestedIterateTei
JSP
-
+ This tag is an extension of the
- <logic:iterate>
+ <logic:iterate>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
collection
@@ -3905,13 +3905,13 @@
org.apache.struts.taglib.nested.logic.NestedLessEqualTag
JSP
-
+ This tag is an extension of the
- <logic:lessEqual>
+ <logic:lessEqual>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
cookie
@@ -3965,13 +3965,13 @@
org.apache.struts.taglib.nested.logic.NestedLessThanTag
JSP
-
+ This tag is an extension of the
- <logic:lessThan>
+ <logic:lessThan>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
cookie
@@ -4025,13 +4025,13 @@
org.apache.struts.taglib.nested.logic.NestedMatchTag
JSP
-
+ This tag is an extension of the
- <logic:match>
+ <logic:match>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
cookie
@@ -4093,13 +4093,13 @@
org.apache.struts.taglib.nested.logic.NestedMessagesNotPresentTag
JSP
-
+ This tag is an extension of the
- <logic:messagesNotPresent>
+ <logic:messagesNotPresent>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
name
@@ -4131,13 +4131,13 @@
org.apache.struts.taglib.nested.logic.NestedMessagesPresentTag
JSP
-
+ This tag is an extension of the
- <logic:messagesPresent>
+ <logic:messagesPresent>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
name
@@ -4169,13 +4169,13 @@
org.apache.struts.taglib.nested.logic.NestedNotEmptyTag
JSP
-
+ This tag is an extension of the
- <logic:notEmpty>
+ <logic:notEmpty>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
name
@@ -4205,13 +4205,13 @@
org.apache.struts.taglib.nested.logic.NestedNotEqualTag
JSP
-
+ This tag is an extension of the
- <logic:notEqual>
+ <logic:notEqual>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
cookie
@@ -4265,13 +4265,13 @@
org.apache.struts.taglib.nested.logic.NestedNotMatchTag
JSP
-
+ This tag is an extension of the
- <logic:notMatch>
+ <logic:notMatch>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
cookie
@@ -4331,13 +4331,13 @@
org.apache.struts.taglib.nested.logic.NestedNotPresentTag
JSP
-
+ This tag is an extension of the
- <logic:notPresent>
+ <logic:notPresent>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
cookie
@@ -4397,13 +4397,13 @@
org.apache.struts.taglib.nested.logic.NestedPresentTag
JSP
-
+ This tag is an extension of the
- <logic:present>
+ <logic:present>
tag. Please consult its documentation for information on tag attributes
and usage details.
-
+ ]]>
cookie
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org