tld.t5.4.0.tld Maven / Gradle / Ivy
5.4.0
t
http://tapestry.apache.org/schema/tapestry_5_1_0.xsd
A component used to implement the progressive
enhancement web design strategy; the component renders itself with a
simplified initial content (i.e., "loading
...") and an Ajax request then supplies the component's true body. This
results in much faster page loads. You can
even nest these!
The component simply does not render its body on initial render. On the subsequent action event request, it fires a
org.apache.tapestry5.EventConstants#PROGRESSIVE_DISPLAY event to inform the container about the (optional)
event context. The event handler method may return a renderable object; if not then the component's body is rendered
as the partial markup response.
progressivedisplay
org.apache.tapestry5.corelib.components.ProgressiveDisplay
JSP
If provided, this is the event context, which will be provided via the
event. <br/> Allow null : true
<br/> Default prefix : prop
context
false
[Ljava.lang.Object;
The initial content to display until the real content arrives. Defaults
to "Loading ..." and an Ajax activity
icon. <br/> Allow null : true
<br/> Default prefix : literal
initial
false
org.apache.tapestry5.Block
Name of a function on the client-side Tapestry.ElementEffect object that
is invoked after the elements's body
content has been updated. If not specified, then the basic "highlight"
method is used, which performs a classic
"yellow fade" to indicate to the user that and update has taken place. <br/> Allow null : true
<br/> Default prefix : literal
update
false
java.lang.String
Outputs a single property value. Overrides for individual properties come from block parameters whose name matches
the . This component is rarely used on its own, but is a critical piece
of the org.apache.tapestry5.corelib.components.BeanDisplay component.
propertydisplay
org.apache.tapestry5.corelib.components.PropertyDisplay
JSP
Used to search for block parameter overrides (this is normally the enclosing Grid component's resources). <br/> Allow null : false
<br/> Default prefix : prop
overrides
true
org.apache.tapestry5.PropertyOverrides
Model for property displayed by the cell. <br/> Allow null : false
<br/> Default prefix : prop
model
true
org.apache.tapestry5.beaneditor.PropertyModel
Identifies the object being rendered. The component will extract a property from the object and render its value
(or delegate to a org.apache.tapestry5.Block that will do so). <br/> Allow null : true
<br/> Default prefix : prop
object
true
java.lang.Object
Source for property display blocks. This defaults to the default implementation of org.apache.tapestry5.services.BeanBlockSource. <br/> Allow null : false
<br/> Default prefix : prop
beanBlockSource
true
org.apache.tapestry5.services.BeanBlockSource
localdate
org.apache.tapestry5.corelib.components.LocalDate
JSP
value
false
java.util.Date
format
false
java.lang.String
Generates a client-side hyperlink that submits the enclosing form. If the link is clicked in the browser, the
component will trigger an event ( by default) , just like
org.apache.tapestry5.corelib.components.Submit.
linksubmit
org.apache.tapestry5.corelib.components.LinkSubmit
JSP
The name of the event that will be triggered if this component is the cause of the form submission. The default
is "selected". <br/> Allow null : false
<br/> Default prefix : literal
event
false
java.lang.String
If true, then no link (or accompanying JavaScript) is written (though the body still is). <br/> Allow null : true
<br/> Default prefix : prop
disabled
false
boolean
If true (the default), then any notification sent by the component will be deferred until the end of the form
submission (this is usually desirable). In general, this can be left as the default except when the LinkSubmit
component is rendering inside a org.apache.tapestry5.corelib.components.Loop, in which case defer should be bound to false (otherwise, the
event context will always be the final value of the Loop). <br/> Allow null : true
<br/> Default prefix : prop
defer
false
boolean
Defines the mode, or client-side behavior, for the submit. The default is org.apache.tapestry5.corelib.SubmitMode#NORMAL; clicking the
button submits the form with validation. org.apache.tapestry5.corelib.SubmitMode#CANCEL indicates the form should be submitted as a cancel,
with no client-side validation. org.apache.tapestry5.corelib.SubmitMode#UNCONDITIONAL bypasses client-side validation, but does not indicate
that the form was cancelled. <br/> Allow null : false
<br/> Default prefix : literal
mode
false
org.apache.tapestry5.corelib.SubmitMode
The list of values that will be made available to event handler method of this component when the form is
submitted. <br/> Allow null : true
<br/> Default prefix : prop
context
false
[Ljava.lang.Object;
A component that generates a user interface for editing the properties of a bean. This is the central component of
the org.apache.tapestry5.corelib.components.BeanEditForm, and utilizes a org.apache.tapestry5.corelib.components.PropertyEditor for much of its functionality. This component places
a org.apache.tapestry5.services.BeanEditContext into the environment.
beaneditor
org.apache.tapestry5.corelib.components.BeanEditor
JSP
A comma-separated list of property names to be retained from the
org.apache.tapestry5.beaneditor.BeanModel (only used
when a default model is created automatically).
Only these properties will be retained, and the properties will also be reordered. The names are
case-insensitive. <br/> Allow null : true
<br/> Default prefix : literal
include
false
java.lang.String
The model that identifies the parameters to be edited, their order, and every other aspect. If not specified, a
default bean model will be created from the type of the object bound to the object parameter. The add, include,
exclude and reorder
parameters are only applied to a default model, not an explicitly provided one. <br/> Allow null : true
<br/> Default prefix : prop
model
false
org.apache.tapestry5.beaneditor.BeanModel
The object to be edited by the BeanEditor. This will be read when the component renders and updated when the form
for the component is submitted. Typically, the container will listen for a "prepare" event, in order to ensure
that a non-null value is ready to be read or updated. <br/> Allow null : true
<br/> Default prefix : prop
object
false
java.lang.Object
A comma-separated list of property names to be added to the org.apache.tapestry5.beaneditor.BeanModel
(only used
when a default model is created automatically). <br/> Allow null : true
<br/> Default prefix : literal
add
false
java.lang.String
A comma-separated list of property names to be removed from the org.apache.tapestry5.beaneditor.BeanModel
(only used
when a default model is created automatically).
The names are case-insensitive. <br/> Allow null : true
<br/> Default prefix : literal
exclude
false
java.lang.String
A comma-separated list of property names indicating the order in which the properties should be presented. The
names are case insensitive. Any properties not indicated in the list will be appended to the end of the display
orde. Only used
when a default model is created automatically. <br/> Allow null : true
<br/> Default prefix : literal
reorder
false
java.lang.String
Where to search for local overrides of property editing blocks as block parameters. Further, the container of the
overrides is used as the source for overridden validation messages. This is normally the BeanEditor component
itself, but when the component is used within a BeanEditForm, it will be the BeanEditForm's resources that will
be searched. <br/> Allow null : false
<br/> Default prefix : prop
overrides
false
org.apache.tapestry5.PropertyOverrides
Generates a render request link to some other page in the application. If an activation context is supplied (as the
context parameter), then the context values will be encoded into the URL. If no context is supplied, then the target
page itself will supply the context via a passivate event.
Pages are not required to have an activation context. When a page does have an activation context, the value
typically represents the identity of some object displayed or otherwise manipulated by the page.
pagelink
org.apache.tapestry5.corelib.components.PageLink
JSP
If true, then then no link element is rendered (and no informal parameters as well). The body is, however, still
rendered. <br/> Allow null : true
<br/> Default prefix : prop
disabled
false
boolean
If specified, the parameters are added to the link as query parameters in key=value fashion.
Values will be coerced to string using value encoder; keys should be Strings. <br/> Allow null : false
<br/> Default prefix : prop
parameters
false
java.util.Map
An anchor value to append to the generated URL (the hash separator will be added automatically). <br/> Allow null : true
<br/> Default prefix : literal
anchor
false
java.lang.String
The logical name of the page to link to. <br/> Allow null : false
<br/> Default prefix : literal
page
true
java.lang.Object
If provided, this is the activation context for the target page (the information will be encoded into the URL).
If not provided, then the target page will provide its own activation context. <br/> Allow null : true
<br/> Default prefix : prop
context
false
[Ljava.lang.Object;
Renders out the column headers for the grid, including links (where appropriate) to control column sorting.
gridcolumns
org.apache.tapestry5.corelib.components.GridColumns
JSP
Where to look for informal parameter Blocks used to override column headers. The default is to look for such
overrides in the GridColumns component itself, but this is usually overridden. <br/> Allow null : true
<br/> Default prefix : prop
overrides
false
org.apache.tapestry5.PropertyOverrides
If not null, then each link is output as a link to update the specified zone. <br/> Allow null : true
<br/> Default prefix : prop
zone
false
java.lang.String
Optional output parameter that stores the current column index. <br/> Allow null : true
<br/> Default prefix : prop
index
false
int
The object that provides access to bean and data models, which is typically the enclosing Grid component. <br/> Allow null : true
<br/> Default prefix : prop
gridModel
false
org.apache.tapestry5.grid.GridModel
If true, then the CSS class on each TH element will be omitted, which can reduce the amount of output
from the component overall by a considerable amount. Leave this as false, the default, when you are leveraging
the CSS to customize the look and feel of particular columns. <br/> Allow null : true
<br/> Default prefix : prop
lean
false
boolean
A Checkbox component is simply a input type="checkbox".
checkbox
org.apache.tapestry5.corelib.components.Checkbox
JSP
No description found <br/> Allow null : true
<br/> Default prefix : literal
clientId
false
java.lang.String
The value to be read or updated. If not bound, the Checkbox will attempt to edit a property of its container
whose name matches the component's id. <br/> Allow null : true
<br/> Default prefix : prop
value
true
boolean
No description found <br/> Allow null : true
<br/> Default prefix : literal
label
false
java.lang.String
No description found <br/> Allow null : true
<br/> Default prefix : prop
disabled
false
boolean
No description found <br/> Allow null : true
<br/> Default prefix : prop
ensureClientIdUnique
false
boolean
A version of org.apache.tapestry5.corelib.components.TextField, but rendered out as an input type="password" element. Further, the output
value for a PasswordField is always blank. When the value provided to the PasswordField is blank, it does not update
its property (care should be taken that the "required" validator not be used in that case).
Includes the size attribute, if a org.apache.tapestry5.beaneditor.Width annotation is present on
the property bound to the value parameter.
passwordfield
org.apache.tapestry5.corelib.components.PasswordField
JSP
Provider of annotations used for some defaults. Annotation are usually provided in terms of the value parameter
(i.e., from the getter and/or setter bound to the value parameter). <br/> Allow null : true
<br/> Default prefix : prop
annotationProvider
false
org.apache.tapestry5.ioc.AnnotationProvider
Defines how nulls on the server side, or sent from the client side, are treated. The selected strategy may
replace the nulls with some other value. The default strategy leaves nulls alone. Another built-in strategy,
zero, replaces nulls with the value 0. <br/> Allow null : true
<br/> Default prefix : nullfieldstrategy
nulls
false
org.apache.tapestry5.NullFieldStrategy
No description found <br/> Allow null : true
<br/> Default prefix : literal
clientId
false
java.lang.String
No description found <br/> Allow null : true
<br/> Default prefix : literal
label
false
java.lang.String
No description found <br/> Allow null : true
<br/> Default prefix : prop
disabled
false
boolean
The object that will perform input validation (which occurs after translation). The validate binding prefix is
generally used to provide this object in a declarative fashion. <br/> Allow null : false
<br/> Default prefix : validate
validate
false
org.apache.tapestry5.FieldValidator
The value to be read and updated. This is not necessarily a string, a translator may be provided to convert
between client side and server side representations. If not bound, a default binding is made to a property of the
container matching the component's id. If no such property exists, then you will see a runtime exception due to
the unbound value parameter. <br/> Allow null : true
<br/> Default prefix : prop
value
true
java.lang.Object
The object which will perform translation between server-side and client-side representations. If not specified,
a value will usually be generated based on the type of the value parameter. <br/> Allow null : false
<br/> Default prefix : translate
translate
true
org.apache.tapestry5.FieldTranslator
No description found <br/> Allow null : true
<br/> Default prefix : prop
ensureClientIdUnique
false
boolean
Multiple selection component. Generates a UI consisting of two select elements configured for multiple
selection; the one on the left is the list of "available" elements, the one on the right is "selected". Elements can
be moved between the lists by clicking a button, or double clicking an option (and eventually, via drag and drop).
The items in the available list are kept ordered as per org.apache.tapestry5.SelectModel order. When items are moved from the
selected list to the available list, they items are inserted back into their proper positions.
The Palette may operate in normal or re-orderable mode, controlled by the reorder parameter.
In normal mode, the items in the selected list are kept in the same "natural" order as the items in the available
list.
In re-order mode, items moved to the selected list are simply added to the bottom of the list. In addition, two extra
buttons appear to move items up and down within the selected list.
Much of the look and feel is driven by CSS, the default Tapestry CSS is used to set up the columns, etc. By default,
the select element's widths are 200px, and it is common to override this to a specific value:
style
DIV.t-palette SELECT { width: 300px; }
/style
You'll want to ensure that both select in each column is the same width, otherwise the display will update
poorly as options are moved from one column to the other.
Option groups within the org.apache.tapestry5.SelectModel will be rendered, but are not supported by many browsers, and are not
fully handled on the client side.
For an alternative component that can be used for similar purposes, see
org.apache.tapestry5.corelib.components.Checklist.
palette
org.apache.tapestry5.corelib.components.Palette
JSP
No description found <br/> Allow null : true
<br/> Default prefix : literal
clientId
false
java.lang.String
Number of rows to display. <br/> Allow null : true
<br/> Default prefix : prop
size
false
int
Allows the title text for the available column (on the left) to be modified. As this is a Block, it can contain
conditionals and components. The default is the text "Available". <br/> Allow null : false
<br/> Default prefix : literal
availableLabel
true
org.apache.tapestry5.Block
No description found <br/> Allow null : true
<br/> Default prefix : prop
ensureClientIdUnique
false
boolean
The list of selected values from the org.apache.tapestry5.SelectModel. This will be updated when the form
is submitted. If the value for the parameter is null, a new list will be created, otherwise the existing list
will be cleared. If unbound, defaults to a property of the container matching this component's id.
Prior to Tapestry 5.4, this allowed null, and a list would be created when the form was submitted. Starting
with 5.4, the selected list may not be null, and may not be a list (it may be, for example, a set). <br/> Allow null : false
<br/> Default prefix : prop
selected
true
java.util.Collection
A ValueEncoder used to convert server-side objects (provided from the
"source" parameter) into unique client-side strings (typically IDs) and
back. Note: this component does NOT support ValueEncoders configured to
be provided automatically by Tapestry. <br/> Allow null : false
<br/> Default prefix : prop
encoder
true
org.apache.tapestry5.ValueEncoder
If true, then additional buttons are provided on the client-side to allow for re-ordering of the values.
This is only useful when the selected parameter is bound to a , rather than a or other
unordered collection. <br/> Allow null : true
<br/> Default prefix : prop
reorder
false
boolean
The image to use for the move up button (the default is an upward pointing arrow). <br/> Allow null : true
<br/> Default prefix : prop
moveUp
false
org.apache.tapestry5.Asset
The object that will perform input validation. The validate binding prefix is generally used to provide
this object in a declarative fashion. <br/> Allow null : true
<br/> Default prefix : validate
validate
false
org.apache.tapestry5.FieldValidator
No description found <br/> Allow null : true
<br/> Default prefix : literal
label
false
java.lang.String
No description found <br/> Allow null : true
<br/> Default prefix : prop
disabled
false
boolean
The image to use for the select button (the default is a right pointing arrow). <br/> Allow null : true
<br/> Default prefix : prop
select
false
org.apache.tapestry5.Asset
The image to use for the deselect button (the default is a left pointing arrow). <br/> Allow null : true
<br/> Default prefix : prop
deselect
false
org.apache.tapestry5.Asset
The image to use for the move down button (the default is a downward pointing arrow). <br/> Allow null : true
<br/> Default prefix : prop
moveDown
false
org.apache.tapestry5.Asset
Allows the title text for the selected column (on the right) to be modified. As this is a Block, it can contain
conditionals and components. The default is the text "Available". <br/> Allow null : false
<br/> Default prefix : literal
selectedLabel
true
org.apache.tapestry5.Block
Model used to define the values and labels used when rendering. <br/> Allow null : false
<br/> Default prefix : prop
model
true
org.apache.tapestry5.SelectModel
Renders out an empty element and provides JavaScript initialization to make the element
the container for alerts. After rendering markup (and initialization JavaScript), it
.
Alerts are created using the org.apache.tapestry5.alerts.AlertManager service.
alerts
org.apache.tapestry5.corelib.components.Alerts
JSP
Allows the button used to dismiss all alerts to be customized (and localized). <br/> Allow null : true
<br/> Default prefix : literal
dismissText
false
java.lang.String
No description found <br/> Allow null : true
<br/> Default prefix : literal
showDismissAll
false
boolean
Presents validation errors of a single field. Must be enclosed by a
org.apache.tapestry5.corelib.components.Form component.
error
org.apache.tapestry5.corelib.components.Error
JSP
The for parameter is used to identify the org.apache.tapestry5.Field to present errors of. <br/> Allow null : false
<br/> Default prefix : component
for
true
org.apache.tapestry5.Field
A special form of the org.apache.tapestry5.corelib.components.Loop
component that adds Ajax support to handle adding new rows and removing
existing rows dynamically.
This component expects that the values being iterated over are entities that
can be identified via a org.apache.tapestry5.ValueEncoder, therefore
you must either bind the "encoder" parameter to a ValueEncoder or use an
entity type for the "value" parameter for which Tapestry can provide a
ValueEncoder automatically.
Works with org.apache.tapestry5.corelib.components.AddRowLink and
org.apache.tapestry5.corelib.components.RemoveRowLink components.
The addRow event will receive the context specified by the context parameter.
The removeRow event will receive the client-side value for the row being iterated.
ajaxformloop
org.apache.tapestry5.corelib.components.AjaxFormLoop
JSP
The element to render for each iteration of the loop. The default comes from the template, or "div" if the
template did not specify an element. <br/> Allow null : true
<br/> Default prefix : literal
element
false
java.lang.String
A ValueEncoder used to convert server-side objects (provided by the
"source" parameter) into unique client-side strings (typically IDs) and
back. Note: this parameter may be OMITTED if Tapestry is configured to
provide a ValueEncoder automatically for the type of property bound to
the "value" parameter. <br/> Allow null : false
<br/> Default prefix : prop
encoder
true
org.apache.tapestry5.ValueEncoder
Name of a function on the client-side Tapestry.ElementEffect object that is invoked to make added content
visible. This is used with the org.apache.tapestry5.corelib.components.FormInjector component, when adding a new row to the loop. Leaving as
null uses the default function, "highlight". <br/> Allow null : true
<br/> Default prefix : literal
show
false
java.lang.String
The objects to iterate over (passed to the internal Loop component). <br/> Allow null : true
<br/> Default prefix : prop
source
true
java.lang.Iterable
A block to render after the loop as the body of the org.apache.tapestry5.corelib.components.FormInjector.
This typically contains a org.apache.tapestry5.corelib.components.AddRowLink. <br/> Allow null : true
<br/> Default prefix : literal
addRow
false
org.apache.tapestry5.Block
The context for the form loop (optional parameter). This list of values will be converted into strings and
included in the URI. The strings will be coerced back to whatever their values are and made available to event
handler methods. Note that the context is only encoded and available to the
event; for the event, the context passed to event handlers
is simply the decoded value for the row that is to be removed. <br/> Allow null : true
<br/> Default prefix : prop
context
false
[Ljava.lang.Object;
The current value from the source. <br/> Allow null : true
<br/> Default prefix : prop
value
true
java.lang.Object
Renders out a series of rows within the table.
Inside a org.apache.tapestry5.corelib.components.Form, a series of row index numbers are stored into the form
( ). This can be a problem in situations where the data set
can shift between the form render and the form submission, with a risk of
applying changes to the wrong objects.
For this reason, when using GridRows inside a Form, you should generally
provide a org.apache.tapestry5.ValueEncoder (via the encoder
parameter), or use an entity type for the "row" parameter for which
Tapestry can provide a ValueEncoder automatically. This will allow Tapestry
to use a unique ID for each row that doesn't change when rows are reordered.
gridrows
org.apache.tapestry5.corelib.components.GridRows
JSP
The current row being rendered, this is primarily an output parameter used to allow the Grid, and the Grid's
container, to know what object is being rendered. <br/> Allow null : true
<br/> Default prefix : prop
row
true
java.lang.Object
Object that provides access to the bean and data models used to render the Grid. <br/> Allow null : true
<br/> Default prefix : prop
gridModel
false
org.apache.tapestry5.grid.GridModel
A ValueEncoder used to convert server-side objects (provided by the
"row" parameter) into unique client-side strings (typically IDs) and
back. In general, when using Grid and Form together, you should either
provide the encoder parameter or use a "row" type for which Tapestry is
configured to provide a ValueEncoder automatically. Otherwise Tapestry
must fall back to using the plain index of each row, rather
than the ValueEncoder-provided unique ID, for recording state into the
form. <br/> Allow null : true
<br/> Default prefix : prop
encoder
false
org.apache.tapestry5.ValueEncoder
Optional output parameter (only set during rendering) that identifies the current row index. This is the index on
the page (i.e., always numbered from zero) as opposed to the row index inside the org.apache.tapestry5.grid.GridDataSource. <br/> Allow null : true
<br/> Default prefix : prop
rowIndex
false
int
Where to search for property override blocks. <br/> Allow null : false
<br/> Default prefix : prop
overrides
true
org.apache.tapestry5.PropertyOverrides
The current page number within the available pages (indexed from 1). <br/> Allow null : true
<br/> Default prefix : prop
currentPage
true
int
If true and the component is enclosed by a Form, then the normal state saving logic is turned off. Defaults to
false, enabling state saving logic within Forms. This can be set to false when form elements within the Grid are
not related to the current row of the grid, or where another component (such as org.apache.tapestry5.corelib.components.Hidden) is used to maintain row state. <br/> Allow null : true
<br/> Default prefix : prop
volatile
false
boolean
If true, then the CSS class on each TD cell will be omitted, which can reduce the amount of output from
the component overall by a considerable amount. Leave this as false, the default, when you are leveraging the CSS
to customize the look and feel of particular columns. <br/> Allow null : true
<br/> Default prefix : prop
lean
false
boolean
Parameter used to set the CSS class for each row (each tr element) within the tbody). This is not
cached, so it will be recomputed for each row. <br/> Allow null : true
<br/> Default prefix : prop
rowClass
false
java.lang.String
Number of rows displayed on each page. Long result sets are split across multiple pages. <br/> Allow null : true
<br/> Default prefix : prop
rowsPerPage
true
int
Optional output parameter that stores the current column index. <br/> Allow null : true
<br/> Default prefix : prop
columnIndex
false
int
A basic looping component; loops over a number of items (provided by its source parameter), rendering its body for each
one. When a Loop is inside a org.apache.tapestry5.corelib.components.Form, it records quite a bit of state into the Form to coordinate access
to the same (or equivalent) objects during the form submission as during the render. This is controlled by
the formState parameter (of type org.apache.tapestry5.corelib.LoopFormState) and can be 'none' (nothing stored into the form), 'values'
(which stores the individual values looped over, or via a org.apache.tapestry5.ValueEncoder, just the value's ids), and
'iteration' (which just stores indexes to the values within the source parameter, which means that the source
parameter will be accessed during the form submission).
For a non-volatile Loop inside the form, the Loop stores a series of commands that start and end
, and stores state for each value in the source parameter (either as full objects
when the encoder parameter is not bound, or as client-side objects when there is an encoder). For a Loop that doesn't
need to be aware of the enclosing Form (if any), the formState parameter should be bound to 'none'.
When the Loop is used inside a Form, it will generate an
org.apache.tapestry5.EventConstants#SYNCHRONIZE_VALUES event to inform its container what values were
submitted and in what order; this can allow the container to pre-load the values in a single batch form external
storage, if that is appropriate.
loop
org.apache.tapestry5.corelib.components.Loop
JSP
Defines the collection of values for the loop to iterate over. If not specified, defaults to a property of the
container whose name matches the Loop cmponent's id. <br/> Allow null : true
<br/> Default prefix : prop
source
true
java.lang.Iterable
A Block to render instead of the loop when the source is empty. The default is to render nothing. <br/> Allow null : true
<br/> Default prefix : literal
empty
false
org.apache.tapestry5.Block
The current value, set before the component renders its body. <br/> Allow null : true
<br/> Default prefix : prop
value
false
java.lang.Object
The index into the source items. <br/> Allow null : true
<br/> Default prefix : prop
index
false
int
A ValueEncoder used to convert server-side objects (provided by the
"value" parameter) into unique client-side strings (typically IDs) and
back. In general, when using a non-volatile Loop in a Form, you should
either provide a ValueEncoder with the encoder parameter or use a "value"
type for which Tapestry is configured to provide a ValueEncoder
automatically. Otherwise Tapestry must fall back to using the plain
index of each loop iteration, rather than the ValueEncoder-provided
unique ID, for recording state into the form. <br/> Allow null : true
<br/> Default prefix : prop
encoder
false
org.apache.tapestry5.ValueEncoder
The element to render. If not null, then the loop will render the indicated element around its body (on each pass
through the loop). The default is derived from the component template. <br/> Allow null : true
<br/> Default prefix : literal
element
false
java.lang.String
Controls what information, if any, is encoded into an enclosing Form. The default value
is org.apache.tapestry5.corelib.LoopFormState#VALUES. This parameter
is only used if the component is enclosed by a Form. <br/> Allow null : false
<br/> Default prefix : literal
formState
false
org.apache.tapestry5.corelib.LoopFormState
A list of checkboxes, allowing selection of multiple items in a list.
For an alternative component that can be used for similar purposes, see
org.apache.tapestry5.corelib.components.Palette.
checklist
org.apache.tapestry5.corelib.components.Checklist
JSP
No description found <br/> Allow null : true
<br/> Default prefix : literal
clientId
false
java.lang.String
A ValueEncoder used to convert server-side objects (provided from the
"source" parameter) into unique client-side strings (typically IDs) and
back. Note: this component does NOT support ValueEncoders configured to
be provided automatically by Tapestry. <br/> Allow null : false
<br/> Default prefix : prop
encoder
true
org.apache.tapestry5.ValueEncoder
No description found <br/> Allow null : true
<br/> Default prefix : literal
label
false
java.lang.String
No description found <br/> Allow null : true
<br/> Default prefix : prop
disabled
false
boolean
The list of selected values from the
org.apache.tapestry5.SelectModel. This will be updated when the
form is submitted. If the value for the parameter is null, a new list
will be created, otherwise the existing list will be cleared. If unbound,
defaults to a property of the container matching this component's id. <br/> Allow null : true
<br/> Default prefix : prop
selected
true
java.util.List
The object that will perform input validation. The validate binding prefix is generally used to provide
this object in a declarative fashion. <br/> Allow null : true
<br/> Default prefix : validate
validate
false
org.apache.tapestry5.FieldValidator
No description found <br/> Allow null : true
<br/> Default prefix : prop
ensureClientIdUnique
false
boolean
Model used to define the values and labels used when rendering the
checklist. <br/> Allow null : true
<br/> Default prefix : prop
model
true
org.apache.tapestry5.SelectModel
A component used to render a recursive tree structure, with expandable/collapsable/selectable nodes. The data that is displayed
by the component is provided as a org.apache.tapestry5.tree.TreeModel. A secondary model, the org.apache.tapestry5.tree.TreeExpansionModel, is used
to track which nodes have been expanded. The optional org.apache.tapestry5.tree.TreeSelectionModel is used to track node selections (as currently
implemented, only leaf nodes may be selected).
Tree is not a form control component; all changes made to the tree on the client
(expansions, collapsing, and selections) are propogated immediately back to the server.
The Tree component uses special tricks to support recursive rendering of the Tree as necessary.
tree
org.apache.tapestry5.corelib.components.Tree
JSP
Used to control the Tree's expansion model. By default, a persistent field inside the Tree
component stores a org.apache.tapestry5.tree.DefaultTreeExpansionModel. This parameter may be bound when more
control over the implementation of the expansion model, or how it is stored, is
required. <br/> Allow null : false
<br/> Default prefix : prop
expansionModel
false
org.apache.tapestry5.tree.TreeExpansionModel
Allows the container to specify additional CSS class names for the outer DIV element. The outer DIV
always has the class name "t-tree-container"; the additional class names are typically used to apply
a specific size and width to the component. <br/> Allow null : true
<br/> Default prefix : literal
class
false
java.lang.String
Optional parameter used to inform the container about what TreeNode is currently rendering; this
is primarily used when the label parameter is bound. <br/> Allow null : true
<br/> Default prefix : prop
node
false
org.apache.tapestry5.tree.TreeNode
Used to control the Tree's selections. When this parameter is bound, then the client-side Tree
will track what is selected or not selected, and communicate this (via Ajax requests) up to
the server, where it will be recorded into the model. On the client-side, the Tree component will
add or remove the CSS class from
for the node. <br/> Allow null : true
<br/> Default prefix : prop
selectionModel
false
org.apache.tapestry5.tree.TreeSelectionModel
The model that drives the tree, determining top level nodes and making revealing the overall structure of the
tree. <br/> Allow null : true
<br/> Default prefix : prop
model
true
org.apache.tapestry5.tree.TreeModel
Optional parameter used to inform the container about the value of the currently rendering TreeNode; this
is often preferable to the TreeNode, and like the node parameter, is primarily used when the label parameter
is bound. <br/> Allow null : true
<br/> Default prefix : prop
value
false
java.lang.Object
A renderable (usually a org.apache.tapestry5.Block) that can render the label for a tree node.
This will be invoked after the org.apache.tapestry5.corelib.components.Tree#value parameter has been updated. <br/> Allow null : true
<br/> Default prefix : prop
label
false
org.apache.tapestry5.runtime.RenderCommand
A close relative of the org.apache.tapestry5.corelib.components.If component that inverts the meaning of its
test. This is easier than an org.apache.tapestry5.corelib.components.If component with the negate parameter set to .
unless
org.apache.tapestry5.corelib.components.Unless
JSP
If true, then the body of the component is omitted. If false, the body is rendered. <br/> Allow null : true
<br/> Default prefix : prop
test
true
boolean
An alternate org.apache.tapestry5.Block to render if org.apache.tapestry5.corelib.base.AbstractConditional#test() is false. The default, null, means
render nothing in that situation. <br/> Allow null : true
<br/> Default prefix : literal
else
false
org.apache.tapestry5.Block
Triggers an arbitrary event during rendering. This is often useful to add JavaScript
to a page or a component (via calls to the org.apache.tapestry5.services.javascript.JavaScriptSupport environmental).
trigger
org.apache.tapestry5.corelib.components.Trigger
JSP
No description found <br/> Allow null : true
<br/> Default prefix : literal
event
false
java.lang.String
Renders an arbitrary element including informal parameters.
any
org.apache.tapestry5.corelib.components.Any
JSP
No description found <br/> Allow null : true
<br/> Default prefix : literal
element
false
java.lang.String
The desired client id, which defaults to the components id. <br/> Allow null : true
<br/> Default prefix : literal
clientId
false
java.lang.String
A Zone is portion of the output page designed for easy dynamic updating via Ajax or other client-side effects. A
Zone renders out as a div element (or whatever is specified in the template) and may have content initially,
or may only get its content as a result of client side activity.
When a user clicks an org.apache.tapestry5.corelib.components.ActionLink whose zone parameter is set triggers a
series of client-side behaviors, and an Ajax request to the server.
The server side event handler can return a org.apache.tapestry5.Block or a component to render as the new
content on the client side. Often, re-rendering the Zone's is useful. Multiple
client-side zones may be updated via the org.apache.tapestry5.services.ajax.AjaxResponseRenderer service.
You will often want to specify the id parameter of the Zone, in addition to it's Tapestry component id; this "locks
down" the client-side id, so the same value is used even in later partial renders of the page (essential if the Zone
is nested inside another Zone). When you specify the client-side id, it is used exactly as provided (meaning that you
are responsible for ensuring that there will not be an id conflict even in the face of multiple partial renders of
the page). Failure to provide an explicit id results in a new, and non-predictable, id being generated for each
partial render, which will often result in client-side failures to locate the element to update when the Zone is
triggered.
In some cases, you may want to know (on the server side) the client id of the zone that was updated; this is passed
as part of the Ajax request, as the org.apache.tapestry5.QueryParameterConstants#ZONE_ID parameter. An example use of this would
be to provide new content into a Zone that updates the same Zone, when the Zone's client-side id is dynamically
allocated (rather than statically defined). In most cases, however, the programmer is responsible for assigning a
specific client-side id, via the id parameter.
A Zone starts and stops a org.apache.tapestry5.services.Heartbeat when it renders (both normally, and when re-rendering).
After the client-side content is updated, a client-side event is fired on the zone's element. The constant
core/events:zone.didUpdate can be used to listen to the event.
zone
org.apache.tapestry5.corelib.components.Zone
JSP
Name of a function on the client-side Tapestry.ElementEffect object that is invoked to make the Zone's
div visible before being updated. If not specified, then the basic "show" method is used. <br/> Allow null : true
<br/> Default prefix : literal
show
false
java.lang.String
No description found <br/> Allow null : true
<br/> Default prefix : prop
simpleIds
false
boolean
If bound, then the id attribute of the rendered element will be this exact value. If not bound, then a unique id
is generated for the element. <br/> Allow null : true
<br/> Default prefix : literal
id
false
java.lang.String
The element name to render for the zone; this defaults to the element actually used in the template, or "div" if
no specific element was specified. <br/> Allow null : false
<br/> Default prefix : literal
elementName
true
java.lang.String
In prior releases, this parameter could be overridden to false to force the outer element of the rendered
Zone to be non-visible. This behavior is no longer supported. <br/> Allow null : true
<br/> Default prefix : prop
visible
false
boolean
Name of a function on the client-side Tapestry.ElementEffect object that is invoked after the Zone's content has
been updated. If not specified, then the basic "highlight" method is used, which performs a classic "yellow fade"
to indicate to the user that and update has taken place. <br/> Allow null : true
<br/> Default prefix : literal
update
false
java.lang.String
Outputs paragraph oriented text, typically collected via a org.apache.tapestry5.corelib.components.TextArea
component. The TextArea is split into lines, and each line it output inside its own p element.
textoutput
org.apache.tapestry5.corelib.components.TextOutput
JSP
No description found <br/> Allow null : true
<br/> Default prefix : prop
value
true
java.lang.String
An HTML form, which will enclose other components to render out the various
types of fields.
A Form triggers many notification events. When it renders, it triggers a
org.apache.tapestry5.EventConstants#PREPARE_FOR_RENDER notification, followed by a
org.apache.tapestry5.EventConstants#PREPARE notification.
When the form is submitted, the component triggers several notifications: first a
org.apache.tapestry5.EventConstants#PREPARE_FOR_SUBMIT, then a org.apache.tapestry5.EventConstants#PREPARE: these allow the page to update its
state as necessary to prepare for the form submission.
The Form component then determines if the form was cancelled (see org.apache.tapestry5.corelib.SubmitMode#CANCEL). If so,
a org.apache.tapestry5.EventConstants#CANCELED event is triggered.
Next come notifications to contained components (or more accurately, the execution of stored org.apache.tapestry5.ComponentActions), to allow each component to retrieve and validate
submitted values, and update server-side properties. This is based on the query parameter,
which contains serialized object data (generated when the form initially renders).
Once the form data is processed, the next step is to trigger the
org.apache.tapestry5.EventConstants#VALIDATE, which allows for cross-form validation. After that, either a
org.apache.tapestry5.EventConstants#SUCCESS OR org.apache.tapestry5.EventConstants#FAILURE event (depending on whether the
org.apache.tapestry5.ValidationTracker has recorded any errors). Lastly, a org.apache.tapestry5.EventConstants#SUBMIT event, for any listeners
that care only about form submission, regardless of success or failure.
For all of these notifications, the event context is derived from the context component parameter. This
context is encoded into the form's action URI (the parameter is not read when the form is submitted, instead the
values encoded into the form are used).
While rendering, or processing a Form submission, the Form component places a org.apache.tapestry5.services.FormSupport object into the ,
so that enclosed components can coordinate with the Form component. It also places a org.apache.tapestry5.ValidationTracker into the environment during both render and submission.
During submission it also pushes a org.apache.tapestry5.services.Heartbeat into the environment, which is ended just before
are executed.
form
org.apache.tapestry5.corelib.components.Form
JSP
The object which will record user input and validation errors. When not using
the default behavior supplied by the Form component (an immediate re-render of the active
page when there are form validation errors), it is necessary to bind this parameter
to a persistent value that can be maintained until the active page is re-rendered. See
TAP5-1801. <br/> Allow null : true
<br/> Default prefix : prop
tracker
false
org.apache.tapestry5.ValidationTracker
Controls when client validation occurs on the client, if at all. Defaults to org.apache.tapestry5.corelib.ClientValidation#SUBMIT.
org.apache.tapestry5.corelib.ClientValidation#BLUR was the default, prior to Tapestry 5.4, but is no longer supported. <br/> Allow null : false
<br/> Default prefix : literal
clientValidation
false
org.apache.tapestry5.corelib.ClientValidation
The context for the link (optional parameter). This list of values will
be converted into strings and included in
the URI. The strings will be coerced back to whatever their values are
and made available to event handler
methods. <br/> Allow null : true
<br/> Default prefix : prop
context
false
[Ljava.lang.Object;
Prefix value used when searching for validation messages and constraints.
The default is the Form component's
id. This is overridden by org.apache.tapestry5.corelib.components.BeanEditForm. <br/> Allow null : true
<br/> Default prefix : prop
validationId
false
java.lang.String
Binding the zone parameter will cause the form submission to be handled
as an Ajax request that updates the
indicated zone. Often a Form will update the same zone that contains it. <br/> Allow null : true
<br/> Default prefix : literal
zone
false
java.lang.String
If true (the default), then the JavaScript will be added to position the
cursor into the form. The field to
receive focus is the first rendered field that is in error, or required,
or present (in that order of priority). <br/> Allow null : true
<br/> Default prefix : prop
autofocus
false
boolean
No description found <br/> Allow null : true
<br/> Default prefix : prop
async
false
boolean
If true, then the Form's action will be secure (using an absolute URL with the HTTPs scheme) regardless
of whether the containing page itself is secure or not. This parameter does nothing
when (which is often
the case in development mode). This only affects how the Form's action attribute is rendered, there is
not (currently) a check that the form is actually submitted securely. <br/> Allow null : true
<br/> Default prefix : prop
secure
false
boolean
Object to validate during the form submission process. The default is the Form component's container.
This parameter should only be used in combination with the Bean Validation Library. <br/> Allow null : true
<br/> Default prefix : prop
validate
false
java.lang.Object
Generates a label element for a particular field. It writes the CSS class "control-label", unless
an informal parameter writes a class attribute.
A Label will render its body, if it has one. However, in most cases it will not have a body, and will render its
as it's body. Remember, however, that it is the
field label that will be used in any error messages. The Label component allows for client- and server-side
validation error decorations.
label
org.apache.tapestry5.corelib.components.Label
JSP
If true, then the body of the label element (in the template) is ignored. This is used when a designer places a
value inside the label element for WYSIWYG purposes, but it should be replaced with a different
(probably, localized) value at runtime. The default is false, so a body will be used if present and the field's
label will only be used if the body is empty or blank. <br/> Allow null : true
<br/> Default prefix : prop
ignoreBody
false
boolean
The for parameter is used to identify the org.apache.tapestry5.Field linked to this label (it is named this way because it
results in the for attribute of the label element). <br/> Allow null : false
<br/> Default prefix : component
for
true
org.apache.tapestry5.Field
Used to edit a single property of a bean. This is used primarily by org.apache.tapestry5.corelib.components.BeanEditForm. Unlike BeanEditForm, the
object to be edited must already exist and the must be passed in explicitly.
propertyeditor
org.apache.tapestry5.corelib.components.PropertyEditor
JSP
The object to be edited by the BeanEditor. This will be read when the component renders and updated when the form
for the component is submitted. Typically, the container will listen for a "prepare" event, in order to ensure
that a non-null value is ready to be read or updated. <br/> Allow null : false
<br/> Default prefix : prop
object
true
java.lang.Object
The model that identifies the parameters to be edited, their order, and every other aspect. <br/> Allow null : false
<br/> Default prefix : prop
model
true
org.apache.tapestry5.beaneditor.BeanModel
Source for property editor blocks. This defaults to the default implementation of org.apache.tapestry5.services.BeanBlockSource. <br/> Allow null : false
<br/> Default prefix : prop
beanBlockSource
true
org.apache.tapestry5.services.BeanBlockSource
Identifies the property to be edited by the editor. <br/> Allow null : true
<br/> Default prefix : prop
property
true
java.lang.String
Where to search for local overrides of property editing blocks as block parameters. This is normally the
containing component of the PropertyEditor, but when the component is used within a BeanEditor, it will be the
BeanEditor's block parameters that will be searched. <br/> Allow null : false
<br/> Default prefix : prop
overrides
false
org.apache.tapestry5.PropertyOverrides
A close relative of org.apache.tapestry5.corelib.components.ActionLink except in two ways.
First, the event that it triggers is explicitly controlled, rather than always "action".
Second, the event is triggered in its container.
This allows slightly shorter URLs but also allows multiple components within the same container to generate identical
URLs for common actions.
eventlink
org.apache.tapestry5.corelib.components.EventLink
JSP
If true, then then no link element is rendered (and no informal parameters as well). The body is, however, still
rendered. <br/> Allow null : true
<br/> Default prefix : prop
disabled
false
boolean
If specified, the parameters are added to the link as query parameters in key=value fashion.
Values will be coerced to string using value encoder; keys should be Strings. <br/> Allow null : false
<br/> Default prefix : prop
parameters
false
java.util.Map
No description found <br/> Allow null : true
<br/> Default prefix : prop
async
false
boolean
The context for the link (optional parameter). This list of values will be converted into strings and included in
the URI. The strings will be coerced back to whatever their values are and made available to event handler
methods. <br/> Allow null : true
<br/> Default prefix : prop
context
false
[Ljava.lang.Object;
Binding the zone parameter turns the link into a an Ajax control that causes the related zone to be updated. <br/> Allow null : true
<br/> Default prefix : literal
zone
false
java.lang.String
An anchor value to append to the generated URL (the hash separator will be added automatically). <br/> Allow null : true
<br/> Default prefix : literal
anchor
false
java.lang.String
The name of the event to be triggered in the parent component. Defaults to the id of the component. An org.apache.tapestry5.corelib.components.ActionLink triggers an "action" event on itself, and EventLink component
triggers any arbitrary event on its container. <br/> Allow null : true
<br/> Default prefix : literal
event
false
java.lang.String
Generates a series of links used to jump to a particular page index within the overall data set.
gridpager
org.apache.tapestry5.corelib.components.GridPager
JSP
The source of the data displayed by the grid (this is used to determine how many rows are available, which in turn determines the page count). <br/> Allow null : true
<br/> Default prefix : prop
source
true
org.apache.tapestry5.grid.GridDataSource
The current page number (indexed from 1). <br/> Allow null : true
<br/> Default prefix : prop
currentPage
true
int
Number of pages before and after the current page in the range. The pager always displays links for 2 * range + 1
pages, unless that's more than the total number of available pages. <br/> Allow null : true
<br/> Default prefix : prop
range
false
int
The number of rows displayed per page. <br/> Allow null : true
<br/> Default prefix : prop
rowsPerPage
true
int
If not null, then each link is output as a link to update the specified zone. <br/> Allow null : true
<br/> Default prefix : prop
zone
false
java.lang.String
TextField component corresponds to element. The value parameter will be edited (read when the containing
org.apache.tapestry5.corelib.components.Form is rendered, and updated when the form is submitted). TextField
is generally used with string values, but other values are acceptable, as long as they can be freely converted back
and forth to strings.
Includes the size attribute, if a org.apache.tapestry5.beaneditor.Width annotation is present on
the property bound to the value parameter.
textfield
org.apache.tapestry5.corelib.components.TextField
JSP
Provider of annotations used for some defaults. Annotation are usually provided in terms of the value parameter
(i.e., from the getter and/or setter bound to the value parameter). <br/> Allow null : true
<br/> Default prefix : prop
annotationProvider
false
org.apache.tapestry5.ioc.AnnotationProvider
Defines how nulls on the server side, or sent from the client side, are treated. The selected strategy may
replace the nulls with some other value. The default strategy leaves nulls alone. Another built-in strategy,
zero, replaces nulls with the value 0. <br/> Allow null : true
<br/> Default prefix : nullfieldstrategy
nulls
false
org.apache.tapestry5.NullFieldStrategy
No description found <br/> Allow null : true
<br/> Default prefix : literal
clientId
false
java.lang.String
Sets the type attribute of the element. The default is "text", but this can be overriden
when using HTML5 types such as "number". <br/> Allow null : false
<br/> Default prefix : literal
type
false
java.lang.String
No description found <br/> Allow null : true
<br/> Default prefix : literal
label
false
java.lang.String
No description found <br/> Allow null : true
<br/> Default prefix : prop
disabled
false
boolean
The object that will perform input validation (which occurs after translation). The validate binding prefix is
generally used to provide this object in a declarative fashion. <br/> Allow null : false
<br/> Default prefix : validate
validate
false
org.apache.tapestry5.FieldValidator
The value to be read and updated. This is not necessarily a string, a translator may be provided to convert
between client side and server side representations. If not bound, a default binding is made to a property of the
container matching the component's id. If no such property exists, then you will see a runtime exception due to
the unbound value parameter. <br/> Allow null : true
<br/> Default prefix : prop
value
true
java.lang.Object
The object which will perform translation between server-side and client-side representations. If not specified,
a value will usually be generated based on the type of the value parameter. <br/> Allow null : false
<br/> Default prefix : translate
translate
true
org.apache.tapestry5.FieldTranslator
No description found <br/> Allow null : true
<br/> Default prefix : prop
ensureClientIdUnique
false
boolean
Standard validation error presenter. Must be enclosed by a
org.apache.tapestry5.corelib.components.Form component. If errors are present, renders a
div element around a banner message and around an unnumbered list of
error messages. Renders nothing if the org.apache.tapestry5.ValidationTracker shows no
errors.
errors
org.apache.tapestry5.corelib.components.Errors
JSP
The CSS class for the div element rendered by the component. The default value is "t-error". <br/> Allow null : true
<br/> Default prefix : literal
class
false
java.lang.String
The banner message displayed above the errors. The default value is "You must correct the
following errors before
you may continue.". <br/> Allow null : true
<br/> Default prefix : prop
banner
false
java.lang.String
No description found <br/> Allow null : true
<br/> Default prefix : prop
globalOnly
false
boolean
A component that creates an entire form editing the properties of a particular bean. Inspired by Trails and BeanForm (both
for Tapestry 4). Generates a simple UI for editing the properties of a JavaBean, with the flavor of UI for each
property (text field, checkbox, drop down list) determined from the property type (or by other means, such as an
annotation), and the order and validation for the properties determined from annotations on the property's getter and
setter methods.
You may add block parameters to the component; when the name matches (case insensitive) the name of a property, then
the corresponding Block is renderered, rather than any of the built in property editor blocks. This allows you to
override specific properties with your own customized UI, for cases where the default UI is insufficient, or no
built-in editor type is appropriate.
BeanEditForm contains a org.apache.tapestry5.corelib.components.Form component and will trigger all the
events of a Form.
beaneditform
org.apache.tapestry5.corelib.components.BeanEditForm
JSP
A comma-separated list of property names to be removed from the org.apache.tapestry5.beaneditor.BeanModel
(only used
when a default model is created automatically).
The names are case-insensitive. <br/> Allow null : true
<br/> Default prefix : literal
exclude
false
java.lang.String
A comma-separated list of property names indicating the order in which the properties should be presented. The
names are case insensitive. Any properties not indicated in the list will be appended to the end of the display
orde. Only used
when a default model is created automatically. <br/> Allow null : true
<br/> Default prefix : literal
reorder
false
java.lang.String
A comma-separated list of property names to be added to the org.apache.tapestry5.beaneditor.BeanModel
(only used
when a default model is created automatically). <br/> Allow null : true
<br/> Default prefix : literal
add
false
java.lang.String
The object to be edited. This will be read when the component renders and updated when the form for the component
is submitted. Typically, the container will listen for a "prepare" event, in order to ensure that a non-null
value is ready to be read or updated. Often, the BeanEditForm can create the object as needed (assuming a public,
no arguments constructor). The object property defaults to a property with the same name as the component id. <br/> Allow null : true
<br/> Default prefix : prop
object
true
java.lang.Object
If set to true, then the form will include an additional button after the submit button labeled "Cancel".
The cancel button will submit the form, bypassing client-side validation. The BeanEditForm will fire a
org.apache.tapestry5.EventConstants#CANCELED event (before the form's org.apache.tapestry5.EventConstants#VALIDATE event). <br/> Allow null : true
<br/> Default prefix : prop
cancel
false
boolean
The text label for the submit button of the form, by default "Create/Update". <br/> Allow null : true
<br/> Default prefix : literal
submitLabel
false
java.lang.String
A comma-separated list of property names to be retained from the
org.apache.tapestry5.beaneditor.BeanModel (only used
when a default model is created automatically).
Only these properties will be retained, and the properties will also be reordered. The names are
case-insensitive. <br/> Allow null : true
<br/> Default prefix : literal
include
false
java.lang.String
Specifies the CSS class attribute for the form; the factory default is "well". <br/> Allow null : true
<br/> Default prefix : literal
class
false
java.lang.String
The model that identifies the parameters to be edited, their order, and every other aspect. If not specified, a
default bean model will be created from the type of the object bound to the object parameter. The add, include,
exclude and reorder parameters are only applied to a default model, not an explicitly provided one. <br/> Allow null : true
<br/> Default prefix : prop
model
false
org.apache.tapestry5.beaneditor.BeanModel
A FormFragment is a portion of a Form that may be selectively displayed. Form elements inside a FormFragment will
automatically bypass validation when the fragment is invisible. The trick is to also bypass server-side form
processing for such fields when the form is submitted; client-side logic "removes" the
form data for the fragment if it is invisible when the
form is submitted (e.g., the hidden form field is disabled);
alternately, client-side logic can simply remove the form fragment element (including its visible and
hidden fields) to prevent server-side processing.
The client-side element will now listen to two new events defined by client-side constants:
core/events.formfragment.changeVisibility or Tapestry.CHANGE_VISIBILITY_EVENT
Change the visibility as per the event memo's visibility property. When the visibility changes, the correct
animation is executed.
core/events.formfragment.remove or Tapestry.HIDE_AND_REMOVE_EVENT
Hides the element, then removes it from the DOM entirely.
formfragment
org.apache.tapestry5.corelib.components.FormFragment
JSP
Determines if the fragment is initially visible or initially invisible (the default). This is only used when
rendering; when the form is submitted, the hidden field value is used to determine whether the elements within
the fragment should be processed (or ignored if still invisible). <br/> Allow null : true
<br/> Default prefix : prop
visible
false
boolean
If true, then the fragment submits the values from fields it contains even if the fragment is not
visible.
The default is to omit values from fields when the enclosing fragment is non visible. <br/> Allow null : true
<br/> Default prefix : prop
alwaysSubmit
false
boolean
Name of a function on the client-side Tapestry.ElementEffect object that is invoked when the fragment is to be
hidden. This is no longer used. <br/> Allow null : true
<br/> Default prefix : literal
hide
false
java.lang.String
If bound, then the id attribute of the rendered element will be this exact value. If not bound, then a unique id
is generated for the element. <br/> Allow null : true
<br/> Default prefix : literal
id
false
java.lang.String
The element to render for each iteration of the loop. The default comes from the template, or "div" if the
template did not specific an element. <br/> Allow null : true
<br/> Default prefix : literal
element
false
java.lang.String
Name of a function on the client-side Tapestry.ElementEffect object that is invoked to make the fragment visible.
This is no longer used. <br/> Allow null : true
<br/> Default prefix : literal
show
false
java.lang.String
The name of a javascript function that overrides the default visibility search bound.
Tapestry normally ensures that not only the form fragment but all parent elements up to the containing body
are visible when determining whether to submit the contents of a form fragment. This behavior can be modified by
supplying a javascript function that receives the "current" element in the chain. Returning true will stop the
search (and report ElementWrapper.deepVisible() as true). Returning false will continue the search up the chain. <br/> Allow null : false
<br/> Default prefix : literal
visibleBound
false
java.lang.String
A radio button (i.e., input type="radio"). Radio buttons must operate within a
org.apache.tapestry5.RadioContainer (normally, the org.apache.tapestry5.corelib.components.RadioGroup component).
If the value parameter is not bound, then the default value is a property of the container component whose name
matches the Radio component's id.
radio
org.apache.tapestry5.corelib.components.Radio
JSP
The value associated with this radio button. This is used to determine which radio button will be selected when
the page is rendered, and also becomes the value assigned when the form is submitted. <br/> Allow null : true
<br/> Default prefix : prop
value
true
java.lang.Object
If true, then the field will render out with a disabled attribute (to turn off client-side behavior). Further, a
disabled field ignores any value in the request when the form is submitted. <br/> Allow null : true
<br/> Default prefix : prop
disabled
false
boolean
The user presentable label for the field. If not provided, a reasonable label is generated from the component's
id, first by looking for a message key named "id-label" (substituting the component's actual id), then by
converting the actual id to a presentable string (for example, "userId" to "User Id"). <br/> Allow null : true
<br/> Default prefix : literal
label
false
java.lang.String
A component used to collect a provided date from the user using a client-side JavaScript calendar. Non-JavaScript
clients can simply type into a text field.
One aspect here is that, because client-side JavaScript formatting and parsing is so limited, we (currently)
use Ajax to send the user's input to the server for parsing (before raising the popup) and formatting (after closing
the popup). Weird and inefficient, but easier than writing client-side JavaScript for that purpose.
Tapestry's DateField component is a wrapper around WebFX DatePicker.
datefield
org.apache.tapestry5.corelib.components.DateField
JSP
No description found <br/> Allow null : true
<br/> Default prefix : literal
clientId
false
java.lang.String
The object that will perform input validation (which occurs after translation). The translate binding prefix is
generally used to provide this object in a declarative fashion. <br/> Allow null : true
<br/> Default prefix : validate
validate
false
org.apache.tapestry5.FieldValidator
No description found <br/> Allow null : true
<br/> Default prefix : literal
label
false
java.lang.String
No description found <br/> Allow null : true
<br/> Default prefix : prop
disabled
false
boolean
No description found <br/> Allow null : true
<br/> Default prefix : prop
lenient
false
boolean
If true, then the text field will be hidden, and only the icon for the date picker will be visible. The default
is false. <br/> Allow null : true
<br/> Default prefix : prop
hideTextField
false
boolean
The value parameter of a DateField must be a java.util.Date. <br/> Allow null : true
<br/> Default prefix : prop
value
true
java.util.Date
The format used to format and parse dates. This is typically specified as a string which is coerced to a
DateFormat. You should be aware that using a date format with a two digit year is problematic: Java (not
Tapestry) may get confused about the century. <br/> Allow null : false
<br/> Default prefix : literal
format
true
java.text.DateFormat
Icon used for the date field trigger button. This was used in Tapestry 5.3 and earlier and is now ignored. <br/> Allow null : true
<br/> Default prefix : asset
icon
false
org.apache.tapestry5.Asset
No description found <br/> Allow null : true
<br/> Default prefix : prop
ensureClientIdUnique
false
boolean
Used to override the component's message catalog. <br/> Allow null : true
<br/> Default prefix : prop
messages
false
org.apache.tapestry5.ioc.Messages
No description found <br/> Allow null : false
<br/> Default prefix : literal
type
false
java.lang.String
Used inside a org.apache.tapestry5.corelib.components.AjaxFormLoop to remove the current row from the loop.
This fires a server-side event (from the AjaxFormLoop component); the event context is the object to be removed. On
the client-side, the element for the row is hidden, then removed altogether.
removerowlink
org.apache.tapestry5.corelib.components.RemoveRowLink
JSP
A component that does not do any rendering of its own, but will delegate to some other object that can do rendering.
This other object may be a component or a org.apache.tapestry5.Block (among other things).
This component may also be used to create inline components. For each informal parameter the value will be stored as a
render variable. To create an inline component, create a block
and use Delegate multiple times in the template to render the block passing parameters to Delegate. In the block body
reference the render variables using the "var:" binding prefix and the name of the parameter.
Note that the default binding prefix for informal parameter values is "literal".
delegate
org.apache.tapestry5.corelib.components.Delegate
JSP
The object which will be rendered in place of the Delegate component. This is typically a specific component
instance, or a org.apache.tapestry5.Block. <br/> Allow null : true
<br/> Default prefix : prop
to
true
java.lang.Object
Overrides the DOCTYPE of the rendered document (via org.apache.tapestry5.dom.Document#dtd(String, String, String)
which can be useful when different component templates that render to the same document disagree about what the correct DOCTYPE
is.
doctype
org.apache.tapestry5.corelib.components.Doctype
JSP
No description found <br/> Allow null : true
<br/> Default prefix : literal
publicId
false
java.lang.String
No description found <br/> Allow null : false
<br/> Default prefix : literal
name
true
java.lang.String
No description found <br/> Allow null : true
<br/> Default prefix : literal
systemId
false
java.lang.String
Conditionally renders its body. May render its tag and any informal parameters.
if
org.apache.tapestry5.corelib.components.If
JSP
If true, then the body of the If component is rendered. If false, the body is omitted. <br/> Allow null : true
<br/> Default prefix : prop
test
true
boolean
Optional parameter to invert the test. If true, then the body is rendered when the test parameter is false (not
true). <br/> Allow null : true
<br/> Default prefix : prop
negate
false
boolean
An alternate org.apache.tapestry5.Block to render if org.apache.tapestry5.corelib.base.AbstractConditional#test() is false. The default, null, means
render nothing in that situation. <br/> Allow null : true
<br/> Default prefix : literal
else
false
org.apache.tapestry5.Block
Used inside an org.apache.tapestry5.corelib.components.AjaxFormLoop component to spur the addition of a new
row. Triggers a server-side event on the
AjaxFormLoop, which must return the newly added object, which will be rendered in the body of the AjaxFormLoop and
sent to the client web browser.
addrowlink
org.apache.tapestry5.corelib.components.AddRowLink
JSP
Renders out an object using the @org.apache.tapestry5.ioc.annotations.Primary org.apache.tapestry5.services.ObjectRenderer service. Used primarily on the
org.apache.tapestry5.corelib.pages.ExceptionReport page.
This is focused on objects that have a specific org.apache.tapestry5.services.ObjectRenderer strategy. The org.apache.tapestry5.corelib.components.BeanDisplay component is
used for displaying the contents of arbitrary objects in terms of a series of property names and values.
renderobject
org.apache.tapestry5.corelib.components.RenderObject
JSP
No description found <br/> Allow null : true
<br/> Default prefix : prop
object
true
java.lang.Object
The Dynamic component allows a component to render itself differently at different times, by making use of
an external template file.
The content of the template file replaces the Dynamic component entirely with one exception: certain elements will be
replaced with s passed to the Dynamic component as informal parameters; this is triggered by
id of the element. When the id attribute has the prefix , the remainder is the name of
a Block parameter. There are no limitations on what can appear inside such a Block: text, components, forms, even the
directive.
Dynamic templates emulate how expansions work in standard Tapestry templates: Expansions (the ${ ... }
syntax) can appear in attribute values or interspersed in element text. This allows container properties, messages,
assets, and so forth to be referenced within the external template. It should be noted that such access is quite a
bit less efficient than putting such expansions inside a referenced Block, but this should not be a big concern
outside of some kind of tight rendering loop.
dynamic
org.apache.tapestry5.corelib.components.Dynamic
JSP
The dynamic template containing the content to be rendered by the component. <br/> Allow null : false
<br/> Default prefix : asset
template
true
org.apache.tapestry5.services.dynamic.DynamicTemplate
Integral part of the default org.apache.tapestry5.corelib.pages.ExceptionReport page used to break apart and
display the properties of the exception.
exceptiondisplay
org.apache.tapestry5.corelib.components.ExceptionDisplay
JSP
Exception to report. <br/> Allow null : false
<br/> Default prefix : prop
exception
true
java.lang.Throwable
timeinterval
org.apache.tapestry5.corelib.components.TimeInterval
JSP
plain
false
boolean
end
false
java.util.Date
start
false
java.util.Date
A non visual component used to provide notifications to its container during a form submission. Records actions into
the form on org.apache.tapestry5.annotations.BeginRender and org.apache.tapestry5.annotations.AfterRender
that (during the form submission) triggers "BeginSubmit" and "AfterSubmit" events. The container can receive these
events to perform setup before a group of components process their submission, and perform cleanup afterwards.
submitnotifier
org.apache.tapestry5.corelib.components.SubmitNotifier
JSP
Part of org.apache.tapestry5.corelib.components.Grid that renders the markup inside a single data cell. GridCell is used inside a pair of loops; the
outer loop for each row, the inner loop for each property of the row.
gridcell
org.apache.tapestry5.corelib.components.GridCell
JSP
Used to search for block parameter overrides (this is normally the enclosing Grid component's resources). <br/> Allow null : false
<br/> Default prefix : prop
overrides
true
org.apache.tapestry5.PropertyOverrides
Model for property displayed by the cell. <br/> Allow null : false
<br/> Default prefix : prop
model
true
org.apache.tapestry5.beaneditor.PropertyModel
Identifies the object being rendered. The component will extract a property from the object and render its value
(or delegate to a org.apache.tapestry5.Block that will do so). <br/> Allow null : true
<br/> Default prefix : prop
object
true
java.lang.Object
Source for property display blocks. This defaults to the default implementation of org.apache.tapestry5.services.BeanBlockSource. <br/> Allow null : false
<br/> Default prefix : prop
beanBlockSource
true
org.apache.tapestry5.services.BeanBlockSource
A wrapper component around some number of org.apache.tapestry5.corelib.components.Radio components, used to organize the selection and define the
property to be edited. Examples of its use are in the org.apache.tapestry5.corelib.components.Radio documentation.
radiogroup
org.apache.tapestry5.corelib.components.RadioGroup
JSP
If true, then the field will render out with a disabled attribute (to turn off client-side behavior). Further, a
disabled field ignores any value in the request when the form is submitted. <br/> Allow null : true
<br/> Default prefix : prop
disabled
false
boolean
The id used to generate a page-unique client-side identifier for the component. If a component renders multiple
times, a suffix will be appended to the to id to ensure uniqueness. The uniqued value may be accessed via the
clientId property. <br/> Allow null : true
<br/> Default prefix : literal
clientId
false
java.lang.String
A ValueEncoder used to convert server-side objects (provided by the
selected Radio componnent's "value" parameter) into unique client-side
strings (typically IDs) and back. Note: this parameter may be OMITTED if
Tapestry is configured to provide a ValueEncoder automatically for the
type of property bound to the "value" parameter. <br/> Allow null : false
<br/> Default prefix : prop
encoder
true
org.apache.tapestry5.ValueEncoder
The property read and updated by the group as a whole. <br/> Allow null : true
<br/> Default prefix : prop
value
true
java.lang.Object
The object that will perform input validation. The validate binding prefix is generally used to provide this
object in a declarative fashion. <br/> Allow null : true
<br/> Default prefix : validate
validate
false
org.apache.tapestry5.FieldValidator
The user presentable label for the field. If not provided, a reasonable label is generated from the component's
id, first by looking for a message key named "id-label" (substituting the component's actual id), then by
converting the actual id to a presentable string (for example, "userId" to "User Id"). <br/> Allow null : true
<br/> Default prefix : literal
label
false
java.lang.String
devtool
org.apache.tapestry5.corelib.components.DevTool
JSP
class
false
java.lang.String
navbar
false
boolean
enabled
false
boolean
A component for formatting output. If the component is represented in the template using an element, then the element
(plus any informal parameters) will be output around the formatted value.
output
org.apache.tapestry5.corelib.components.Output
JSP
The format to be applied to the object. <br/> Allow null : false
<br/> Default prefix : prop
format
true
java.text.Format
The value to be output (before formatting). If the formatted value is blank, no output is produced. <br/> Allow null : true
<br/> Default prefix : prop
value
true
java.lang.Object
The element name, derived from the component template. This can even be overridden manually if desired (for
example, to sometimes render a surrounding element and other times not). <br/> Allow null : true
<br/> Default prefix : prop
elementName
false
java.lang.String
If true, the default, then output is filtered, escaping any reserved characters. If false, the output is written
raw. <br/> Allow null : true
<br/> Default prefix : prop
filter
false
boolean
Used to display the properties of a bean, using an underlying org.apache.tapestry5.beaneditor.BeanModel. The output definition list: a
dl element containing a series of dt/dd pairs. The property label is used as the dt
and the property value (formatted as per the datatype) is the dd. Only properties that have a known data type
are displayed.
The property id is used as the class attribute of the dt and dd element, allowing CSS customization
per property. This does not occur when lean is bound to true.
The outer dl element has the CSS class "t-beandisplay".
beandisplay
org.apache.tapestry5.corelib.components.BeanDisplay
JSP
The object to be rendered; if not explicitly bound, a default binding to a property whose name matches this
component's id will be used. <br/> Allow null : false
<br/> Default prefix : prop
object
true
java.lang.Object
Where to search for local overrides of property display blocks as block parameters. Further, the container of the
overrides is used as the source for overridden validation messages. This is normally the component itself, but
when the component is used within a BeanEditForm, it will be the BeanEditForm's block parameter that will be
searched. <br/> Allow null : true
<br/> Default prefix : prop
overrides
false
org.apache.tapestry5.ComponentResources
A comma-separated list of property names to be added to the org.apache.tapestry5.beaneditor.BeanModel
(only used
when a default model is created automatically). <br/> Allow null : true
<br/> Default prefix : literal
add
false
java.lang.String
A comma-separated list of property names to be removed from the org.apache.tapestry5.beaneditor.BeanModel
(only used
when a default model is created automatically).
The names are case-insensitive. <br/> Allow null : true
<br/> Default prefix : literal
exclude
false
java.lang.String
A comma-separated list of property names indicating the order in which the properties should be presented. The
names are case insensitive. Any properties not indicated in the list will be appended to the end of the display
orde. Only used
when a default model is created automatically. <br/> Allow null : true
<br/> Default prefix : literal
reorder
false
java.lang.String
The model that identifies the parameters to be edited, their order, and every other aspect. If not specified, a
default bean model will be created from the type of the object bound to the object parameter. The add, include,
exclude and reorder
parameters are only applied to a default model, not an explicitly provided one. <br/> Allow null : true
<br/> Default prefix : prop
model
false
org.apache.tapestry5.beaneditor.BeanModel
A comma-separated list of property names to be retained from the
org.apache.tapestry5.beaneditor.BeanModel (only used
when a default model is created automatically).
Only these properties will be retained, and the properties will also be reordered. The names are
case-insensitive. <br/> Allow null : true
<br/> Default prefix : literal
include
false
java.lang.String
If true, then the CSS class attribute on the dt and dd elements will be ommitted. <br/> Allow null : true
<br/> Default prefix : prop
lean
false
boolean
Used to record a page property as a value into the form. The value is encoded
when the form is rendered, then decoded after the form is submitted back to
the server, and the "value" parameter updated.
The encoding and decoding is done via a org.apache.tapestry5.ValueEncoder,
therefore you must either bind the "encoder" parameter to a ValueEncoder or
use an entity type for the "value" parameter for which Tapestry can provide a
ValueEncoder automatically.
hidden
org.apache.tapestry5.corelib.components.Hidden
JSP
A ValueEncoder used to convert the server-side object provided by the
"value" parameter into a unique client-side string (typically an ID) and
back. Note: this parameter may be OMITTED if Tapestry is configured to
provide a ValueEncoder automatically for the type of property bound to
the "value" parameter. <br/> Allow null : true
<br/> Default prefix : prop
encoder
true
org.apache.tapestry5.ValueEncoder
The value to read (when rendering) or update (when the form is submitted). <br/> Allow null : true
<br/> Default prefix : prop
value
true
java.lang.Object
Defines how nulls on the server side, or sent from the client side, are treated. The selected strategy may
replace the nulls with some other value. The default strategy leaves nulls alone. Another built-in strategy,
zero, replaces nulls with the value 0. <br/> Allow null : true
<br/> Default prefix : nullfieldstrategy
nulls
false
org.apache.tapestry5.NullFieldStrategy
glyphicon
org.apache.tapestry5.corelib.components.Glyphicon
JSP
name
true
java.lang.String
Corresponds to input type="submit" or input type="image", a client-side element that can force the
enclosing form to submit. The submit responsible for the form submission will post a notification that allows the
application to know that it was the responsible entity. The notification is named
, by default, and has no context.
submit
org.apache.tapestry5.corelib.components.Submit
JSP
If true, then the field will render out with a disabled attribute
(to turn off client-side behavior). When the form is submitted, the
bound value is evaluated again and, if true, the field's value is
ignored (not even validated) and the component's events are not fired. <br/> Allow null : true
<br/> Default prefix : prop
disabled
false
boolean
CSS class for the element. <br/> Allow null : true
<br/> Default prefix : literal
class
false
java.lang.String
If true (the default), then any notification sent by the component will be deferred until the end of the form
submission (this is usually desirable). In general, this can be left as the default except when the Submit
component is rendering inside a org.apache.tapestry5.corelib.components.Loop, in which case defer should be bound to false (otherwise, the
event context will always be the final value of the Loop). <br/> Allow null : true
<br/> Default prefix : prop
defer
false
boolean
The name of the event that will be triggered if this component is the cause of the form submission. The default
is org.apache.tapestry5.EventConstants#SELECTED. <br/> Allow null : false
<br/> Default prefix : literal
event
false
java.lang.String
Defines the mode, or client-side behavior, for the submit. The default is org.apache.tapestry5.corelib.SubmitMode#NORMAL; clicking the
button submits the form with validation. org.apache.tapestry5.corelib.SubmitMode#CANCEL indicates the form should be submitted as a cancel,
with no client-side validation. org.apache.tapestry5.corelib.SubmitMode#UNCONDITIONAL bypasses client-side validation, but does not indicate
that the form was cancelled. <br/> Allow null : false
<br/> Default prefix : literal
mode
false
org.apache.tapestry5.corelib.SubmitMode
If provided, the component renders an input tag with type "image". Otherwise "submit". <br/> Allow null : true
<br/> Default prefix : asset
image
false
org.apache.tapestry5.Asset
The list of values that will be made available to event handler method of this component when the form is
submitted. <br/> Allow null : true
<br/> Default prefix : prop
context
false
[Ljava.lang.Object;
Used to output raw markup to the client. Unlike, say, an expansion, the output from OutputRaw is unfiltered, with any
special characters or entities left exactly as is. This is used in situations where the markup is provided
externally, rather than constructed within Tapestry.
outputraw
org.apache.tapestry5.corelib.components.OutputRaw
JSP
The value to to render. If unbound, and a property of the container matches the component's id, then that
property will be the source of the value. <br/> Allow null : true
<br/> Default prefix : prop
value
true
java.lang.String
Component that triggers an action on the server with a subsequent full page refresh.
actionlink
org.apache.tapestry5.corelib.components.ActionLink
JSP
If true, then then no link element is rendered (and no informal parameters as well). The body is, however, still
rendered. <br/> Allow null : true
<br/> Default prefix : prop
disabled
false
boolean
If specified, the parameters are added to the link as query parameters in key=value fashion.
Values will be coerced to string using value encoder; keys should be Strings. <br/> Allow null : false
<br/> Default prefix : prop
parameters
false
java.util.Map
No description found <br/> Allow null : true
<br/> Default prefix : prop
async
false
boolean
The context for the link (optional parameter). This list of values will be converted into strings and included in
the URI. The strings will be coerced back to whatever their values are and made available to event handler
methods. <br/> Allow null : true
<br/> Default prefix : prop
context
false
[Ljava.lang.Object;
Binding the zone parameter turns the link into a an Ajax control that causes the related zone to be updated. <br/> Allow null : true
<br/> Default prefix : literal
zone
false
java.lang.String
An anchor value to append to the generated URL (the hash separator will be added automatically). <br/> Allow null : true
<br/> Default prefix : literal
anchor
false
java.lang.String
A grid presents tabular data. It is a composite component, created in terms of several sub-components. The
sub-components are statically wired to the Grid, as it provides access to the data and other models that they need.
A Grid may operate inside a org.apache.tapestry5.corelib.components.Form. By overriding the cell renderers of
properties, the default output-only behavior can be changed to produce a complex form with individual control for
editing properties of each row. There is a big caveat here: if the order of rows provided by
the org.apache.tapestry5.grid.GridDataSource changes between render and form submission, then there's the
possibility that data will be applied to the wrong server-side objects.
For this reason, when using Grid and Form together, you should generally
provide the Grid with a org.apache.tapestry5.ValueEncoder (via the
encoder parameter), or use an entity type for the "row" parameter for which
Tapestry can provide a ValueEncoder automatically. This will allow Tapestry
to use a unique ID for each row that doesn't change when rows are reordered.
grid
org.apache.tapestry5.corelib.components.Grid
JSP
The number of rows of data displayed on each page. If there are more rows than will fit, the Grid will divide up
the rows into "pages" and (normally) provide a pager to allow the user to navigate within the overall result
set. <br/> Allow null : true
<br/> Default prefix : prop
rowsPerPage
false
int
Used to store the current object being rendered (for the current row). This is used when parameter blocks are
provided to override the default cell renderer for a particular column ... the components within the block can
use the property bound to the row parameter to know what they should render. <br/> Allow null : true
<br/> Default prefix : prop
row
false
java.lang.Object
Optional output parmeter used to identify the index of the column being rendered. <br/> Allow null : true
<br/> Default prefix : prop
columnIndex
false
int
A comma-separated list of property names indicating the order in which the properties should be presented. The
names are case insensitive. Any properties not indicated in the list will be appended to the end of the display
order. This parameter is only used
when a default model is created automatically. <br/> Allow null : true
<br/> Default prefix : literal
reorder
false
java.lang.String
The model used to handle sorting of the Grid. This is generally not specified, and the built-in model supports
only single column sorting. The sort constraints (the column that is sorted, and ascending vs. descending) is
stored as persistent fields of the Grid component. <br/> Allow null : true
<br/> Default prefix : prop
sortModel
false
org.apache.tapestry5.grid.GridSortModel
The model used to identify the properties to be presented and the order of presentation. The model may be
omitted, in which case a default model is generated from the first object in the data source (this implies that
the objects provided by the source are uniform). The model may be explicitly specified to override the default
behavior, say to reorder or rename columns or add additional columns. The add, include,
exclude and reorder
parameters are only applied to a default model, not an explicitly provided one. <br/> Allow null : true
<br/> Default prefix : prop
model
false
org.apache.tapestry5.beaneditor.BeanModel
If true, then the Grid will be wrapped in an element that acts like a
org.apache.tapestry5.corelib.components.Zone; all the paging and sorting links will refresh the zone,
repainting the entire grid within it, but leaving the rest of the page (outside the zone) unchanged. <br/> Allow null : true
<br/> Default prefix : prop
inPlace
false
boolean
No description found <br/> Allow null : true
<br/> Default prefix : prop
paginationModel
false
org.apache.tapestry5.grid.GridPaginationModel
Defines where the pager (used to navigate within the "pages" of results) should be displayed: "top", "bottom",
"both" or "none". <br/> Allow null : true
<br/> Default prefix : literal
pagerPosition
false
org.apache.tapestry5.corelib.data.GridPagerPosition
CSS class for the table element. In addition, informal parameters to the Grid are rendered in the table
element. <br/> Allow null : true
<br/> Default prefix : literal
class
false
java.lang.String
A Block to render instead of the table (and pager, etc.) when the source is empty. The default is simply the text
"There is no data to display". This parameter is used to customize that message, possibly including components to
allow the user to create new objects. <br/> Allow null : true
<br/> Default prefix : literal
empty
false
org.apache.tapestry5.Block
A comma-separated list of property names to be removed from the org.apache.tapestry5.beaneditor.BeanModel
.
The names are case-insensitive. This parameter is only used
when a default model is created automatically. <br/> Allow null : true
<br/> Default prefix : literal
exclude
false
java.lang.String
Defines where block and label overrides are obtained from. By default, the Grid component provides block
overrides (from its block parameters). <br/> Allow null : false
<br/> Default prefix : prop
overrides
false
org.apache.tapestry5.PropertyOverrides
The source of data for the Grid to display. This will usually be a List or array but can also be an explicit
org.apache.tapestry5.grid.GridDataSource. For Lists and object arrays, a GridDataSource is created automatically as a wrapper
around the underlying List. <br/> Allow null : true
<br/> Default prefix : prop
source
true
org.apache.tapestry5.grid.GridDataSource
A comma-separated list of property names to be retained from the
org.apache.tapestry5.beaneditor.BeanModel.
Only these properties will be retained, and the properties will also be reordered. The names are
case-insensitive. This parameter is only used
when a default model is created automatically. <br/> Allow null : true
<br/> Default prefix : literal
include
false
java.lang.String
A comma-seperated list of property names to be added to the org.apache.tapestry5.beaneditor.BeanModel.
Cells for added columns will be blank unless a cell override is provided. This parameter is only used
when a default model is created automatically. <br/> Allow null : true
<br/> Default prefix : literal
add
false
java.lang.String
No description found <br/> Allow null : true
<br/> Default prefix : prop
renderTableIfEmpty
false
boolean
TextArea component corresponds to a textarea element. The value parameter is almost always bound to a string,
but this is not an absolute requirement. Since the component accepts informal parameters, the rows and cols attribute may
be set that way (there is not a formal parameter).
Includes the cols attribute, if a org.apache.tapestry5.beaneditor.Width annotation is present on
the property bound to the value parameter.
textarea
org.apache.tapestry5.corelib.components.TextArea
JSP
Provider of annotations used for some defaults. Annotation are usually provided in terms of the value parameter
(i.e., from the getter and/or setter bound to the value parameter). <br/> Allow null : true
<br/> Default prefix : prop
annotationProvider
false
org.apache.tapestry5.ioc.AnnotationProvider
Defines how nulls on the server side, or sent from the client side, are treated. The selected strategy may
replace the nulls with some other value. The default strategy leaves nulls alone. Another built-in strategy,
zero, replaces nulls with the value 0. <br/> Allow null : true
<br/> Default prefix : nullfieldstrategy
nulls
false
org.apache.tapestry5.NullFieldStrategy
No description found <br/> Allow null : true
<br/> Default prefix : literal
clientId
false
java.lang.String
No description found <br/> Allow null : true
<br/> Default prefix : literal
label
false
java.lang.String
No description found <br/> Allow null : true
<br/> Default prefix : prop
disabled
false
boolean
The object that will perform input validation (which occurs after translation). The validate binding prefix is
generally used to provide this object in a declarative fashion. <br/> Allow null : false
<br/> Default prefix : validate
validate
false
org.apache.tapestry5.FieldValidator
The value to be read and updated. This is not necessarily a string, a translator may be provided to convert
between client side and server side representations. If not bound, a default binding is made to a property of the
container matching the component's id. If no such property exists, then you will see a runtime exception due to
the unbound value parameter. <br/> Allow null : true
<br/> Default prefix : prop
value
true
java.lang.Object
The object which will perform translation between server-side and client-side representations. If not specified,
a value will usually be generated based on the type of the value parameter. <br/> Allow null : false
<br/> Default prefix : translate
translate
true
org.apache.tapestry5.FieldTranslator
No description found <br/> Allow null : true
<br/> Default prefix : prop
ensureClientIdUnique
false
boolean
Select an item from a list of values, using an [X]HTML select element on the client side. Any validation
decorations will go around the entire select element.
A core part of this component is the org.apache.tapestry5.ValueEncoder (the encoder parameter) that is used to convert between
server-side values and unique client-side strings. In some cases, a org.apache.tapestry5.ValueEncoder can be generated automatically from
the type of the value parameter. The org.apache.tapestry5.services.ValueEncoderSource service provides an encoder in these situations; it
can be overriden by binding the encoder parameter, or extended by contributing a org.apache.tapestry5.services.ValueEncoderFactory into the
service's configuration.
select
org.apache.tapestry5.corelib.components.Select
JSP
No description found <br/> Allow null : true
<br/> Default prefix : literal
clientId
false
java.lang.String
The label to use for the blank option, if rendered. If not specified, the container's message catalog is
searched for a key, id-blanklabel. <br/> Allow null : true
<br/> Default prefix : literal
blankLabel
false
java.lang.String
Controls whether an additional blank option is provided. The blank option precedes all other options and is never
selected. The value for the blank option is always the empty string, the label may be the blank string; the
label is from the blankLabel parameter (and is often also the empty string). <br/> Allow null : true
<br/> Default prefix : literal
blankOption
false
org.apache.tapestry5.corelib.data.BlankOption
No description found <br/> Allow null : true
<br/> Default prefix : literal
secure
false
org.apache.tapestry5.corelib.data.SecureOption
No description found <br/> Allow null : true
<br/> Default prefix : prop
ensureClientIdUnique
false
boolean
A ValueEncoder used to convert the server-side object provided by the
"value" parameter into a unique client-side string (typically an ID) and
back. Note: this parameter may be OMITTED if Tapestry is configured to
provide a ValueEncoder automatically for the type of property bound to
the "value" parameter. <br/> Allow null : true
<br/> Default prefix : prop
encoder
false
org.apache.tapestry5.ValueEncoder
Binding the zone parameter will cause any change of Select's value to be handled as an Ajax request that updates
the
indicated zone. The component will trigger the event org.apache.tapestry5.EventConstants#VALUE_CHANGED to inform its
container that Select's value has changed. <br/> Allow null : true
<br/> Default prefix : literal
zone
false
java.lang.String
No description found <br/> Allow null : true
<br/> Default prefix : literal
label
false
java.lang.String
No description found <br/> Allow null : true
<br/> Default prefix : prop
disabled
false
boolean
Performs input validation on the value supplied by the user in the form submission. <br/> Allow null : true
<br/> Default prefix : validate
validate
false
org.apache.tapestry5.FieldValidator
No description found <br/> Allow null : true
<br/> Default prefix : prop
raw
false
boolean
No description found <br/> Allow null : true
<br/> Default prefix : prop
context
false
[Ljava.lang.Object;
The model used to identify the option groups and options to be presented to the user. This can be generated
automatically for Enum types. <br/> Allow null : false
<br/> Default prefix : prop
model
true
org.apache.tapestry5.SelectModel
The value to read or update. <br/> Allow null : true
<br/> Default prefix : prop
value
true
java.lang.Object
block
block
JSP
container
org.apache.tapestry5.corelib.components.SubmitNotifier
JSP
body
org.apache.tapestry5.corelib.components.SubmitNotifier
JSP
© 2015 - 2025 Weber Informatics LLC | Privacy Policy