Chapter 17. Seam JSF controls - JBoss Seam 1.1.0 cr2 英文参考手册
Seam includes a number of JSF controls that are useful for working with Seam. These are intended to complement the built-in JSF controls, and controls from other third-party libraries. We recommend the Ajax4JSF and ADF faces (now Trinidad) tag libraries for use with Seam. We do not recommend the use of the Tomahawk tag library.
- <s:validate>
Validate a JSF input field against the bound property using Hibernate Validator.
- <s:validateAll>
Validate all child JSF input fields against the bound propertys using Hibernate Validator.
- <s:convertDateTime>
Perform date or time conversions in the Seam timezone.
- <s:decorate>
"Decorate" a JSF input field when validation fails.
- <s:message>
"Decorate" a JSF input field with the validation error message.
- <s:span>
Render a HTML <span>.
- <s:div>
Render a HTML <div>.
- <s:cache>
Cache the rendered page fragment using JBoss Cache. Note that <s:cache> actually uses the instance of JBoss Cache managed by the built-in pojoCache component.
key — the key to cache rendered content, often a value expression. For example, if we were caching a page fragment that displays a document, we might use key="Document-#{document.id}".
enabled — a value expression that determines if the cache should be used.
region — a JBoss Cache node to use (different nodes can have different expiry policies).
- <s:link>
A link that supports invocation of an action with control over conversation propagation. Does not submit the form.
value — the label.
action — a method binding that specified the action listener.
view — the JSF view id to link to.
fragment — the fragment identifier to link to.
disabled — is the link disabled?
propagation — determines the conversation propagation style: begin, join, nest, none or end.
pageflow — a pageflow definition to begin. (This is only useful when propagation="begin" or propagation="join".)
- <s:button>
A button that supports invocation of an action with control over conversation propagation. Does not submit the form.
value — the label.
action — a method binding that specified the action listener.
view — the JSF view id to link to.
fragment — the fragment identifier to link to.
disabled — is the link disabled?
propagation — determines the conversation propagation style: begin, join, nest, none or end.
pageflow — a pageflow definition to begin. (This is only useful when propagation="begin" or propagation="join".)
- <s:conversationPropagation>
Customize the conversation propagation for a command link or button (or similar JSF control). Facelets only.
propagation — determines the conversation propagation style: begin, join, nest, none or end.
pageflow — a pageflow definition to begin. (This is only useful when propagation="begin" or propagation="join".)
- <s:conversationId>
Add the conversation id to an output link (or similar JSF control). Facelets only.
- <s:taskId>
Add the task id to an output link (or similar JSF control), when the task is available via #{task}. Facelets only.