
META-INF.tld.struts-faces.tld Maven / Gradle / Ivy
This tag library provides custom action functionality that is
similar to that provided by the Struts 1.1 tag libraries, but
is built on top of the JavaServer Faces rendering architecture.
This tag library includes the following tags:
]]>
1.4
Struts-Faces
http://struts.apache.org/tags-faces
Renders an HTML <base>
element with an
href
attribute pointing to the absolute location
of the enclosing JSP page. This tag is valid only when nested
inside an HTML <head>
element. This tag is
useful because it allows you to use relative URL references that
are based on the URL of the page itself, rather than the URL to
which the most recent submit took place.
]]>
base
org.apache.struts.faces.taglib.BaseTag
JSP
Value binding expression to bind this component to
a backing bean property.
]]>
binding
false
false
javax.el.ValueExpression
javax.faces.component.UIComponent
Component id of this component.
id
false
false
java.lang.String
Boolean attribute indicating whether this component should be
rendered or not.
rendered
false
false
javax.el.ValueExpression
boolean
Target frame for this base reference.
target
false
false
javax.el.ValueExpression
java.lang.String
Renders an HTML <a>
element defining a
hyperlink that submits the current form. This component is
required because the JSF 1.0 and 1.1 specifications require
interoperability between the renderers for the form element
and the command link element, without providing a portable
mechanism to allow intermixed libraries.
]]>
commandLink
org.apache.struts.faces.taglib.CommandLinkTag
JSP
action
false
false
javax.el.MethodExpression
java.lang.String action()
actionListener
false
false
javax.el.MethodExpression
void actionListener(javax.faces.event.ActionEvent)
id
false
false
java.lang.String
immediate
false
false
javax.el.ValueExpression
java.lang.Boolean
rendered
false
false
javax.el.ValueExpression
boolean
value
false
false
javax.el.ValueExpression
java.lang.String
accesskey
false
false
javax.el.ValueExpression
java.lang.String
charset
false
false
javax.el.ValueExpression
java.lang.String
dir
false
false
javax.el.ValueExpression
java.lang.String
hreflang
false
false
javax.el.ValueExpression
java.lang.String
lang
false
false
javax.el.ValueExpression
java.lang.String
onblur
false
false
javax.el.ValueExpression
java.lang.String
onclick
false
false
javax.el.ValueExpression
java.lang.String
ondblclick
false
false
javax.el.ValueExpression
java.lang.String
onfocus
false
false
javax.el.ValueExpression
java.lang.String
onkeydown
false
false
javax.el.ValueExpression
java.lang.String
onkeypress
false
false
javax.el.ValueExpression
java.lang.String
onkeyup
false
false
javax.el.ValueExpression
java.lang.String
onmousedown
false
false
javax.el.ValueExpression
java.lang.String
onmousemove
false
false
javax.el.ValueExpression
java.lang.String
onmouseout
false
false
javax.el.ValueExpression
java.lang.String
onmouseover
false
false
javax.el.ValueExpression
java.lang.String
onmouseup
false
false
javax.el.ValueExpression
java.lang.String
rel
false
false
javax.el.ValueExpression
java.lang.String
rev
false
false
javax.el.ValueExpression
java.lang.String
style
false
false
javax.el.ValueExpression
java.lang.String
styleClass
false
false
javax.el.ValueExpression
java.lang.String
tabindex
false
false
javax.el.ValueExpression
java.lang.String
target
false
false
javax.el.ValueExpression
java.lang.String
title
false
false
javax.el.ValueExpression
java.lang.String
type
false
false
javax.el.ValueExpression
java.lang.String
Displays a list of error messages prepared by form bean
or business logic validation processing.
In order to use this component successfully, you must have
defined an application scope MessageResources
bean
under the specified attribute name, with optinal definitions for
the following message keys:
]]>
errors
org.apache.struts.faces.taglib.ErrorsTag
JSP
Value binding expression to bind this component to
a backing bean property.
]]>
binding
false
false
javax.el.ValueExpression
javax.faces.component.UIComponent
Name of the servlet context attribute under which the desired
MessageResources
bundle is stored. If not specified,
the default bundle for this sub-application will be used.
]]>
bundle
false
false
javax.el.ValueExpression
java.lang.String
Component id of this component.
id
false
false
java.lang.String
Component of the component for which to render errors. If not
specified, all messages (regardless of property) are displayed.
property
false
false
javax.el.ValueExpression
java.lang.String
Boolean attribute indicating whether this component should be
rendered or not.
rendered
false
false
javax.el.ValueExpression
boolean
Render an HTML form element containing the nested components to
present the appropriate label and input field elements. This tag is
distinguished from the tag in the standard HTML RenderKit because it
accepts a Struts <action>
path as a parameter,
and triggers the creation of a Struts form bean if needed.
]]>
form
org.apache.struts.faces.taglib.FormTag
JSP
Struts Action
to which this form should be
submitted. This value must exactly match the path
attribute of the corresponding <action>
element in the struts-config.xml
configuration
file for this application module.
]]>
action
true
false
javax.el.ValueExpression
java.lang.String
Value binding expression to bind this component to
a backing bean property.
]]>
binding
false
false
javax.el.ValueExpression
javax.faces.component.UIComponent
The content encoding to be used to submit this form, if the
method is POST
. This must be set to
"multipart/form-data
" if your form includes file upload
field(s). If not specified, the browser default
("application/x-www-form-urlencoded
") is used.
]]>
enctype
false
false
javax.el.ValueExpression
java.lang.String
The identifier of the form field that should receive focus
when this form is rendered.
]]>
focus
false
false
javax.el.ValueExpression
java.lang.String
If the focus field is an array, such as a radio button group,
you can specify the index of the array element to receive focus.
]]>
focusIndex
false
false
javax.el.ValueExpression
java.lang.String
Component id of this component.
id
false
false
java.lang.String
JavaScript event handler executed if this form is reset.
]]>
onreset
false
false
javax.el.ValueExpression
java.lang.String
JavaScript event handler executed if this form is submitted.
]]>
onsubmit
false
false
javax.el.ValueExpression
java.lang.String
Boolean attribute indicating whether this component should be
rendered or not.
rendered
false
false
javax.el.ValueExpression
boolean
CSS styles to be applied to this HTML element.
]]>
style
false
false
javax.el.ValueExpression
java.lang.String
CSS style class to use when rendering this component.
styleClass
false
false
javax.el.ValueExpression
java.lang.String
Window target to which this form is submitted, such as for use
in framed presentations.
]]>
target
false
false
javax.el.ValueExpression
java.lang.String
Renders an HTML <html>
element with language
attributes extracted from the user's current Locale object, if there
is one.
]]>
html
org.apache.struts.faces.taglib.HtmlTag
JSP
Value binding expression to bind this component to
a backing bean property.
]]>
binding
false
false
javax.el.ValueExpression
javax.faces.component.UIComponent
Component id of this component.
id
false
false
java.lang.String
Set to true
in order to record a Locale
based on the current request's Accept-Language
header
(if any), if none has currently been set.
]]>
locale
false
false
javax.el.ValueExpression
boolean
Boolean attribute indicating whether this component should be
rendered or not.
rendered
false
false
javax.el.ValueExpression
boolean
Set to true
to render an xml:lang
element on the generated html
element. It also causes
nested Struts HTML tags (although not JavaServer Faces component
tags) to render themselves as xhtml.
]]>
xhtml
false
false
javax.el.ValueExpression
boolean
IMPLEMENTATION NOTE - Unlike other tags in this
tag library, this does not correspond to a JavaServer Faces
user interface component. It is based on the tag implementation
class used in the struts-html
tag library.
Render JavaScript validation based on the
validation rules loaded by the ValidatorPlugIn
.
The set of validation rules that should be generated is based
on the formName attribute passed in, which should match
the name attribute of the form element in the xml file.
The dynamicJavascript and staticJavascript attributes
default to true, but if dynamicJavascript is set to true
and staticJavascript is set to false
then only
the dynamic JavaScript will be rendered. If dynamicJavascript
is set to false
and staticJavascript is set to true
then only
the static JavaScript will be rendered which can then be put in
separate JSP page so the browser can cache the static JavaScript.
]]>
javascript
org.apache.struts.faces.taglib.JavascriptValidatorTag
JSP
If set to "true" and XHTML has been enabled, the JavaScript will
be wrapped in a CDATA section to prevent XML parsing. The default is
"true" to comply with the W3C's recommendation.
]]>
cdata
false
false
javax.el.ValueExpression
boolean
Whether or not to render the dynamic JavaScript.
Defaults to true
.
]]>
dynamicJavascript
false
false
javax.el.ValueExpression
boolean
The key (form name) to retrieve a specific
set of validation rules.
]]>
formName
false
false
javax.el.ValueExpression
java.lang.String
Whether or not to enclose the javascript
with HTML comments. This attribute is ignored in XHTML
mode because the script would be deleted by the XML parser. See
the cdata attribute for details on hiding scripts from XML
parsers. Defaults to true
.
]]>
htmlComment
false
false
javax.el.ValueExpression
java.lang.String
The alternate JavaScript method name to be used
instead of the of the default. The default is
'validate' concatenated in front of
the key (form name) passed in (ex: validateRegistrationForm).
]]>
method
false
false
javax.el.ValueExpression
java.lang.String
The current page of a set of validation rules
if the page attribute for the field element
in the xml file is in use.
]]>
page
false
false
javax.el.ValueExpression
java.lang.Integer
The src attribute's value when defining
the html script element.
]]>
src
false
false
javax.el.ValueExpression
java.lang.String
Whether or not to render the static JavaScript.
Defaults to true
.
]]>
staticJavascript
false
false
javax.el.ValueExpression
boolean
Create a Map wrapping the specified MessageResources instance, which
will return localized messages based on the Locale stored in the
view root component of the current view.
]]>
loadMessages
org.apache.struts.faces.taglib.LoadMessagesTag
empty
Application scope key containing the MessageResources instance
to be exposed. If not specified, the default MessageResources
instance for the current application module is exposed.
]]>
messages
false
false
javax.el.ValueExpression
java.lang.String
Request scope key under which the MessagesMap will be
stored.
]]>
var
true
false
javax.el.ValueExpression
java.lang.String
Render the message text looked up from a message resources bundle,
based on our current locale. The message key must be specified by
exactly one of the following attributes:
The MessageResources
bundle to be used is specified
by the bundle
attribute, as follows:
Substitution parameters for the message may be nested inside this
tag by using the parameter
tag from the standard
HTML RenderKit tag library.
Additional control over the rendering process is specified by the
following optional attributes, with default values as indicated:
]]>
message
org.apache.struts.faces.taglib.MessageTag
JSP
Value binding expression to bind this component to
a backing bean property.
]]>
binding
false
false
javax.el.ValueExpression
javax.faces.component.UIComponent
Name of the servlet context attribute under which the desired
MessageResources
bundle is stored. If not specified,
the default bundle for this sub-application will be used.
]]>
bundle
false
false
javax.el.ValueExpression
java.lang.String
Should we filter the output for characters that are sensitive
in HTML? The default value is true
.
]]>
filter
false
false
javax.el.ValueExpression
boolean
Component identifier of the component corresponding to this tag.
]]>
id
false
false
java.lang.String
Literal value of the message key to look up. Exactly one of
key
and value
must be specified.
]]>
key
false
false
javax.el.ValueExpression
java.lang.String
Boolean attribute indicating whether this component should be
rendered or not.
rendered
false
false
javax.el.ValueExpression
boolean
CSS styles used to render this component.
]]>
style
false
false
javax.el.ValueExpression
java.lang.String
Name of the CSS style class used to render this component.
]]>
styleClass
false
false
javax.el.ValueExpression
java.lang.String
Value reference expression used to retrieve a dynamic value for
the message key to look up. Exactly one of key
and
value
must be specified.
]]>
value
false
false
javax.el.ValueExpression
java.lang.String
Renders an HTML <link>
element with a
relative reference to a text/css
stylesheet at
the specified context-relative path.
]]>
stylesheet
org.apache.struts.faces.taglib.StylesheetTag
JSP
Value binding expression to bind this component to
a backing bean property.
]]>
binding
false
false
javax.el.ValueExpression
javax.faces.component.UIComponent
Component id of this component.
id
false
false
java.lang.String
Context-relative path to the resource for this relative link.
path
true
false
javax.el.ValueExpression
java.lang.String
Boolean attribute indicating whether this component should be
rendered or not.
rendered
false
false
javax.el.ValueExpression
boolean
Render the text associated with the specified model object or
text string, optionally performing filtering and formatting tasks
described by the optional attributes described below. The text to be
rendered is specified in exactly one of the following attributes:
Additional control over the rendering process is specified by the
following optional attributes, with default values as indicated:
]]>
write
org.apache.struts.faces.taglib.WriteTag
empty
Value binding expression to bind this component to
a backing bean property.
]]>
binding
false
false
javax.el.ValueExpression
javax.faces.component.UIComponent
Should we filter the output for characters that are sensitive
in HTML? The default value is true
.
]]>
filter
false
false
javax.el.ValueExpression
boolean
Component identifier of the component corresponding to this tag.
]]>
id
false
false
java.lang.String
Boolean attribute indicating whether this component should be
rendered or not.
rendered
false
false
javax.el.ValueExpression
boolean
CSS styles used to render this component.
]]>
style
false
false
javax.el.ValueExpression
java.lang.String
Name of the CSS style class used to render this component.
]]>
styleClass
false
false
javax.el.ValueExpression
java.lang.String
Literal text to be rendered, or value reference expression
to retrieve the text to be rendered.
]]>
value
false
false
javax.el.ValueExpression
java.lang.String