Move reference docs => src/reference
This change eliminates the spring-framework-reference subproject, moving these sources into the root project's own src directory. This makes sense because the reference docs span all submodules, and also because api Javadoc is created at the root project level as well. This means that both api and reference documentation output will now reside in the root project's 'build' directory. This is more consistent and easy to discover.
This commit is contained in:
Chris Beams
964
src/reference/docbook/spring.tld.xml
Normal file
964
src/reference/docbook/spring.tld.xml
Normal file
@@ -0,0 +1,964 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
||||
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<appendix id="spring.tld">
|
||||
<title>spring.tld</title>
|
||||
<section id="spring.tld-intro">
|
||||
<title>Introduction</title>
|
||||
</section>
|
||||
<para>One of the view technologies you can use with the Spring Framework
|
||||
is Java Server Pages (JSPs). To help you implement views using Java Server Pages
|
||||
the Spring Framework provides you with some tags for evaluating errors, setting
|
||||
themes and outputting internationalized messages.</para>
|
||||
<para>Please note that the various tags generated by this form tag library
|
||||
are compliant with the <ulink url="http://www.w3.org/TR/xhtml1/">XHTML-1.0-Strict specification</ulink> and attendant <ulink url="http://www.w3.org/TR/xhtml1/dtds.html#a_dtd_XHTML-1.0-Strict">DTD</ulink>.</para>
|
||||
<para>This appendix describes the <literal>spring.tld</literal> tag library.</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<xref linkend="spring.tld.bind"/>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<xref linkend="spring.tld.escapeBody"/>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<xref linkend="spring.tld.hasBindErrors"/>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<xref linkend="spring.tld.htmlEscape"/>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<xref linkend="spring.tld.message"/>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<xref linkend="spring.tld.nestedPath"/>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<xref linkend="spring.tld.theme"/>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<xref linkend="spring.tld.transform"/>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<xref linkend="spring.tld.url"/>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<xref linkend="spring.tld.eval"/>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
<section id="spring.tld.bind">
|
||||
<title>The <literal>bind</literal> tag</title>
|
||||
<para>
|
||||
Provides BindStatus object for the given bind path.
|
||||
The HTML escaping flag participates in a page-wide or application-wide setting
|
||||
(i.e. by HtmlEscapeTag or a "defaultHtmlEscape" context-param in web.xml).
|
||||
</para>
|
||||
<table id="spring.tld.bind.table">
|
||||
<title>Attributes</title>
|
||||
<tgroup cols="3">
|
||||
<colspec align="center" colname="Attribute"/>
|
||||
<colspec align="center" colname="Required"/>
|
||||
<colspec align="center" colname="Runtime.Expression"/>
|
||||
<colspec align="left" colname="Description"/>
|
||||
<thead>
|
||||
<row>
|
||||
<entry align="center">Attribute</entry>
|
||||
<entry align="center">Required?</entry>
|
||||
<entry align="center">Runtime Expression?</entry>
|
||||
<entry align="left">Description</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>
|
||||
<para>htmlEscape</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Set HTML escaping for this tag, as boolean value. Overrides
|
||||
the default HTML escaping setting for the current page.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>ignoreNestedPath</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Set whether to ignore a nested path, if any. Default is to not ignore.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>path</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The path to the bean or bean property to bind status
|
||||
information for. For instance account.name, company.address.zipCode
|
||||
or just employee. The status object will exported to the page scope,
|
||||
specifically for this bean or bean property</para>
|
||||
</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
</section>
|
||||
<section id="spring.tld.escapeBody">
|
||||
<title>The <literal>escapeBody</literal> tag</title>
|
||||
<para>
|
||||
Escapes its enclosed body content, applying HTML escaping and/or JavaScript escaping.
|
||||
The HTML escaping flag participates in a page-wide or application-wide setting
|
||||
(i.e. by HtmlEscapeTag or a "defaultHtmlEscape" context-param in web.xml).
|
||||
</para>
|
||||
<table id="spring.tld.escapeBody.table">
|
||||
<title>Attributes</title>
|
||||
<tgroup cols="3">
|
||||
<colspec align="center" colname="Attribute"/>
|
||||
<colspec align="center" colname="Required"/>
|
||||
<colspec align="center" colname="Runtime.Expression"/>
|
||||
<colspec align="left" colname="Description"/>
|
||||
<thead>
|
||||
<row>
|
||||
<entry align="center">Attribute</entry>
|
||||
<entry align="center">Required?</entry>
|
||||
<entry align="center">Runtime Expression?</entry>
|
||||
<entry align="left">Description</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>
|
||||
<para>htmlEscape</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Set HTML escaping for this tag, as boolean value. Overrides the
|
||||
default HTML escaping setting for the current page.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>javaScriptEscape</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Set JavaScript escaping for this tag, as boolean value.
|
||||
Default is false.</para>
|
||||
</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
</section>
|
||||
<section id="spring.tld.hasBindErrors">
|
||||
<title>The <literal>hasBindErrors</literal> tag</title>
|
||||
<para>
|
||||
Provides Errors instance in case of bind errors.
|
||||
The HTML escaping flag participates in a page-wide or application-wide setting
|
||||
(i.e. by HtmlEscapeTag or a "defaultHtmlEscape" context-param in web.xml).
|
||||
</para>
|
||||
<table id="spring.tld.hasBindErrors.table">
|
||||
<title>Attributes</title>
|
||||
<tgroup cols="3">
|
||||
<colspec align="center" colname="Attribute"/>
|
||||
<colspec align="center" colname="Required"/>
|
||||
<colspec align="center" colname="Runtime.Expression"/>
|
||||
<colspec align="left" colname="Description"/>
|
||||
<thead>
|
||||
<row>
|
||||
<entry align="center">Attribute</entry>
|
||||
<entry align="center">Required?</entry>
|
||||
<entry align="center">Runtime Expression?</entry>
|
||||
<entry align="left">Description</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>
|
||||
<para>htmlEscape</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Set HTML escaping for this tag, as boolean value.
|
||||
Overrides the default HTML escaping setting for the current page.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>name</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The name of the bean in the request, that needs to be
|
||||
inspected for errors. If errors are available for this bean, they
|
||||
will be bound under the 'errors' key.</para>
|
||||
</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
</section>
|
||||
<section id="spring.tld.htmlEscape">
|
||||
<title>The <literal>htmlEscape</literal> tag</title>
|
||||
<para>
|
||||
Sets default HTML escape value for the current page.
|
||||
Overrides a "defaultHtmlEscape" context-param in web.xml, if any.
|
||||
</para>
|
||||
<table id="spring.tld.htmlEscape.table">
|
||||
<title>Attributes</title>
|
||||
<tgroup cols="3">
|
||||
<colspec align="center" colname="Attribute"/>
|
||||
<colspec align="center" colname="Required"/>
|
||||
<colspec align="center" colname="Runtime.Expression"/>
|
||||
<colspec align="left" colname="Description"/>
|
||||
<thead>
|
||||
<row>
|
||||
<entry align="center">Attribute</entry>
|
||||
<entry align="center">Required?</entry>
|
||||
<entry align="center">Runtime Expression?</entry>
|
||||
<entry align="left">Description</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>
|
||||
<para>defaultHtmlEscape</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Set the default value for HTML escaping, to be put
|
||||
into the current PageContext.</para>
|
||||
</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
</section>
|
||||
<section id="spring.tld.message">
|
||||
<title>The <literal>message</literal> tag</title>
|
||||
<para>
|
||||
Retrieves the message with the given code, or text if code isn't resolvable.
|
||||
The HTML escaping flag participates in a page-wide or application-wide setting
|
||||
(i.e. by HtmlEscapeTag or a "defaultHtmlEscape" context-param in web.xml).
|
||||
</para>
|
||||
<table id="spring.tld.message.table">
|
||||
<title>Attributes</title>
|
||||
<tgroup cols="3">
|
||||
<colspec align="center" colname="Attribute"/>
|
||||
<colspec align="center" colname="Required"/>
|
||||
<colspec align="center" colname="Runtime.Expression"/>
|
||||
<colspec align="left" colname="Description"/>
|
||||
<thead>
|
||||
<row>
|
||||
<entry align="center">Attribute</entry>
|
||||
<entry align="center">Required?</entry>
|
||||
<entry align="center">Runtime Expression?</entry>
|
||||
<entry align="left">Description</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>
|
||||
<para>arguments</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Set optional message arguments for this tag, as a
|
||||
(comma-)delimited String (each String argument can contain JSP EL),
|
||||
an Object array (used as argument array), or a single Object (used
|
||||
as single argument).</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>argumentSeparator</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The separator character to be used for splitting the
|
||||
arguments string value; defaults to a 'comma' (',').</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>code</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The code (key) to use when looking up the message.
|
||||
If code is not provided, the text attribute will be used.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>htmlEscape</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Set HTML escaping for this tag, as boolean value.
|
||||
Overrides the default HTML escaping setting for the current page.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>javaScriptEscape</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Set JavaScript escaping for this tag, as boolean value. Default is false.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>message</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>A MessageSourceResolvable argument (direct or through JSP EL).
|
||||
Fits nicely when used in conjunction with Spring's own validation error
|
||||
classes which all implement the MessageSourceResolvable interface. For
|
||||
example, this allows you to iterate over all of the errors in a form,
|
||||
passing each error (using a runtime expression) as the value of this
|
||||
'message' attribute, thus effecting the easy display of such error
|
||||
messages.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>scope</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The scope to use when exporting the result to a variable.
|
||||
This attribute is only used when var is also set. Possible values are
|
||||
page, request, session and application.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>text</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Default text to output when a message for the given code
|
||||
could not be found. If both text and code are not set, the tag will
|
||||
output null.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>var</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The string to use when binding the result to the page,
|
||||
request, session or application scope. If not specified, the result
|
||||
gets outputted to the writer (i.e. typically directly to the JSP).</para>
|
||||
</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
</section>
|
||||
<section id="spring.tld.nestedPath">
|
||||
<title>The <literal>nestedPath</literal> tag</title>
|
||||
<para>
|
||||
Sets a nested path to be used by the bind tag's path.
|
||||
</para>
|
||||
<table id="spring.tld.nestedPath.table">
|
||||
<title>Attributes</title>
|
||||
<tgroup cols="3">
|
||||
<colspec align="center" colname="Attribute"/>
|
||||
<colspec align="center" colname="Required"/>
|
||||
<colspec align="center" colname="Runtime.Expression"/>
|
||||
<colspec align="left" colname="Description"/>
|
||||
<thead>
|
||||
<row>
|
||||
<entry align="center">Attribute</entry>
|
||||
<entry align="center">Required?</entry>
|
||||
<entry align="center">Runtime Expression?</entry>
|
||||
<entry align="left">Description</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>
|
||||
<para>path</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Set the path that this tag should apply. E.g. 'customer'
|
||||
to allow bind paths like 'address.street' rather than
|
||||
'customer.address.street'.</para>
|
||||
</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
</section>
|
||||
<section id="spring.tld.theme">
|
||||
<title>The <literal>theme</literal> tag</title>
|
||||
<para>
|
||||
Retrieves the theme message with the given code, or text if code isn't resolvable.
|
||||
The HTML escaping flag participates in a page-wide or application-wide setting
|
||||
(i.e. by HtmlEscapeTag or a "defaultHtmlEscape" context-param in web.xml).
|
||||
</para>
|
||||
<table id="spring.tld.theme.table">
|
||||
<title>Attributes</title>
|
||||
<tgroup cols="3">
|
||||
<colspec align="center" colname="Attribute"/>
|
||||
<colspec align="center" colname="Required"/>
|
||||
<colspec align="center" colname="Runtime.Expression"/>
|
||||
<colspec align="left" colname="Description"/>
|
||||
<thead>
|
||||
<row>
|
||||
<entry align="center">Attribute</entry>
|
||||
<entry align="center">Required?</entry>
|
||||
<entry align="center">Runtime Expression?</entry>
|
||||
<entry align="left">Description</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>
|
||||
<para>arguments</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Set optional message arguments for this tag, as a
|
||||
(comma-)delimited String (each String argument can contain JSP EL),
|
||||
an Object array (used as argument array), or a single Object (used
|
||||
as single argument).</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>argumentSeparator</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The separator character to be used for splitting the
|
||||
arguments string value; defaults to a 'comma' (',').</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>code</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The code (key) to use when looking up the message.
|
||||
If code is not provided, the text attribute will be used.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>htmlEscape</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Set HTML escaping for this tag, as boolean value.
|
||||
Overrides the default HTML escaping setting for the current page.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>javaScriptEscape</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Set JavaScript escaping for this tag, as boolean value. Default is false.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>message</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>A MessageSourceResolvable argument (direct or through JSP EL).</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>scope</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The scope to use when exporting the result to a variable.
|
||||
This attribute is only used when var is also set. Possible values are
|
||||
page, request, session and application.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>text</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Default text to output when a message for the given code
|
||||
could not be found. If both text and code are not set, the tag will
|
||||
output null.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>var</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The string to use when binding the result to the page,
|
||||
request, session or application scope. If not specified, the result
|
||||
gets outputted to the writer (i.e. typically directly to the JSP).</para>
|
||||
</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
</section>
|
||||
<section id="spring.tld.transform">
|
||||
<title>The <literal>transform</literal> tag</title>
|
||||
<para>
|
||||
Provides transformation of variables to Strings, using an appropriate
|
||||
custom PropertyEditor from BindTag (can only be used inside BindTag).
|
||||
The HTML escaping flag participates in a page-wide or application-wide setting
|
||||
(i.e. by HtmlEscapeTag or a 'defaultHtmlEscape' context-param in web.xml).
|
||||
</para>
|
||||
<table id="spring.tld.transform.table">
|
||||
<title>Attributes</title>
|
||||
<tgroup cols="3">
|
||||
<colspec align="center" colname="Attribute"/>
|
||||
<colspec align="center" colname="Required"/>
|
||||
<colspec align="center" colname="Runtime.Expression"/>
|
||||
<colspec align="left" colname="Description"/>
|
||||
<thead>
|
||||
<row>
|
||||
<entry align="center">Attribute</entry>
|
||||
<entry align="center">Required?</entry>
|
||||
<entry align="center">Runtime Expression?</entry>
|
||||
<entry align="left">Description</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>
|
||||
<para>htmlEscape</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Set HTML escaping for this tag, as boolean value. Overrides
|
||||
the default HTML escaping setting for the current page.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>scope</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The scope to use when exported the result to a variable.
|
||||
This attribute is only used when var is also set. Possible values are
|
||||
page, request, session and application.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>value</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The value to transform. This is the actual object you want
|
||||
to have transformed (for instance a Date). Using the PropertyEditor that
|
||||
is currently in use by the 'spring:bind' tag.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>var</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The string to use when binding the result to the page,
|
||||
request, session or application scope. If not specified, the result gets
|
||||
outputted to the writer (i.e. typically directly to the JSP).</para>
|
||||
</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
</section>
|
||||
<section id="spring.tld.url">
|
||||
<title>The <literal>url</literal> tag</title>
|
||||
<para>
|
||||
Creates URLs with support for URI template variables, HTML/XML escaping, and Javascript escaping.
|
||||
Modeled after the JSTL c:url tag with backwards compatibility in mind.
|
||||
</para>
|
||||
<table id="spring.tld.url.table">
|
||||
<title>Attributes</title>
|
||||
<tgroup cols="3">
|
||||
<colspec align="center" colname="Attribute"/>
|
||||
<colspec align="center" colname="Required"/>
|
||||
<colspec align="center" colname="Runtime.Expression"/>
|
||||
<colspec align="left" colname="Description"/>
|
||||
<thead>
|
||||
<row>
|
||||
<entry align="center">Attribute</entry>
|
||||
<entry align="center">Required?</entry>
|
||||
<entry align="center">Runtime Expression?</entry>
|
||||
<entry align="left">Description</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>
|
||||
<para>url</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The URL to build. This value can include template {placeholders}
|
||||
that are replaced with the URL encoded value of the named parameter. Parameters
|
||||
must be defined using the param tag inside the body of this tag.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>context</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Specifies a remote application context path. The default is the
|
||||
current application context path.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>var</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The name of the variable to export the URL value to.
|
||||
If not specified the URL is written as output.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>scope</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The scope for the var. 'application', 'session', 'request' and
|
||||
'page' scopes are supported. Defaults to page scope. This attribute has no
|
||||
effect unless the var attribute is also defined.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>htmlEscape</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Set HTML escaping for this tag, as a boolean value. Overrides the
|
||||
default HTML escaping setting for the current page.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>javascriptEncoding</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Set JavaScript escaping for this tag, as a boolean value.
|
||||
Default is false.</para>
|
||||
</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
</section>
|
||||
<section id="spring.tld.eval">
|
||||
<title>The <literal>eval</literal> tag</title>
|
||||
<para>
|
||||
Evaluates a Spring expression (SpEL) and either prints the result or assigns it to a variable.
|
||||
</para>
|
||||
<table id="spring.tld.eval.table">
|
||||
<title>Attributes</title>
|
||||
<tgroup cols="3">
|
||||
<colspec align="center" colname="Attribute"/>
|
||||
<colspec align="center" colname="Required"/>
|
||||
<colspec align="center" colname="Runtime.Expression"/>
|
||||
<colspec align="left" colname="Description"/>
|
||||
<thead>
|
||||
<row>
|
||||
<entry align="center">Attribute</entry>
|
||||
<entry align="center">Required?</entry>
|
||||
<entry align="center">Runtime Expression?</entry>
|
||||
<entry align="left">Description</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
<entry>
|
||||
<para>expression</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The expression to evaluate.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>var</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The name of the variable to export the evaluation result to.
|
||||
If not specified the evaluation result is converted to a String and written as output.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>scope</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>The scope for the var. 'application', 'session', 'request' and
|
||||
'page' scopes are supported. Defaults to page scope. This attribute has no
|
||||
effect unless the var attribute is also defined.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>htmlEscape</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Set HTML escaping for this tag, as a boolean value. Overrides the
|
||||
default HTML escaping setting for the current page.</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>
|
||||
<para>javascriptEncoding</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>false</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>true</para>
|
||||
</entry>
|
||||
<entry>
|
||||
<para>Set JavaScript escaping for this tag, as a boolean value.
|
||||
Default is false.</para>
|
||||
</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
</section>
|
||||
</appendix>
|
||||
Reference in New Issue
Block a user