craigmcc02/03/16 18:49:06
Modified:doc/userGuide struts-html.xml
src/share/org/apache/struts/taglib/html LinkTag.java
Added: src/share/org/apache/struts/taglib/html FrameTag.java
Log:
Added a new html:frame tag that provides the same sort of manipulations to
the src attribute that html:link does for the href attribute.
PR: Bugzilla #6923
Submitted by: Joe Germuska joe at germuska.com, who also
provided the implementation class
Revision ChangesPath
1.6 +374 -0jakarta-struts/doc/userGuide/struts-html.xml
Index: struts-html.xml
===
RCS file: /home/cvs/jakarta-struts/doc/userGuide/struts-html.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- struts-html.xml 17 Mar 2002 01:44:41 - 1.5
+++ struts-html.xml 17 Mar 2002 02:49:06 - 1.6
@@ -1499,6 +1499,380 @@
tag
+nameframe/name
+summaryRender an HTML frame element/summary
+tagclassorg.apache.struts.taglib.html.FrameTag/tagclass
+info
+
+pRenders an HTML codelt;framegt;/code element
+with processing for the codesrc/code attribute that is
+identical to that performed by the codelt;html:linkgt;/code
+tag for the codehref/code attribute. URL rewriting will be
+applied automatically, to maintain session state in the
+absence of cookies./p
+
+pThe 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
+liemforward/em - Use the value of this attribute as the
+name of a global codeActionForward/code to be looked
+up, and use the application-relative or context-relative
+URI found there./li
+liemhref/em - Use the value of this attribute unchanged.
+/li
+liempage/em - Use the value of this attribute as a
+application-relative URI, and generate a server-relative
+URI by including the context path and application
+prefix./li
+/ul
+
+pNormally, 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 codeparamId/code attribute (and its
+associated attributes to select the value), or specify the
+codename/code (and optional codeproperty/code)
+attributes to select a codejava.util.Map/code bean that
+contains one or more parameter ids and corresponding values.
+/p
+
+pTo specify a single parameter, use the codeparamId/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
+liemSpecify only the codeparamName/code attribute/em
+- The named JSP bean (optionally scoped by the value of the
+codeparamScope/code attribute) must identify a value
+that can be converted to a String./li
+liemSpecify both the codeparamName/code and
+codeparamProperty/code attributes/em - The specified
+property getter method will be called on the JSP bean
+identified by the codeparamName/code (and optional
+codeparamScope/code) attributes, in order to select
+a value that can be converted to a String./li
+/ul
+
+pIf you prefer to specify a codejava.util.Map/code that
+contains all of the request parameters to be added to the
+hyperlink, use one of the following techniques:/p
+ul
+liemSpecify only the codename/code attribute/em -
+The named JSP bean (optionally scoped by the value of
+the codescope/code attribute) must identify a
+codejava.util.Map/code containing the parameters./li
+liemSpecify both codename/code and
+codeproperty/code attributes/em - The specified
+property getter method will be called on the bean
+identified by the codename/code (and optional
+codescope/code) attributes, in order to return the
+codejava.util.Map/code containing the