nxl
Tag widgetType
Facelet tag handler that renders a widget outside of a layout context, in a given mode.
This is helpful to reuse an existing widget within templates that do not need an entire layout to be defined.
In addition to the following attributes, any optional attributes are accepted and are used as properties of the created widget.
When rendered, some variables are exposed to the resolution context:
- 'value' references the given widget value, so that it can be used in a generic template for widgets of type 'template', for instance.
- 'widget' references the created widget.
- widgets of type 'template' also expose field values by 'field_0' or 'field_1',... the number being the field definition index in the field definitions list.
Example:
<nxl:widgetType name="text" mode="#{myMode}" value="#{myText}" required="true" /> or <nxl:widgetType name="#{myWidgetType}" mode="#{myMode}" value="#{myBoundProperty}" properties="#{myProperties}" />
| Tag Information |
| Tag Class | None |
| TagExtraInfo Class | None |
| Body Content | None |
| Display Name | None |
| Attributes |
| Name | Required | Request-time | Type | Description |
| name | true | false | java.lang.String | Name of the widget type that will be used: can be 'text', 'template',... or any widget type registered on the pluggable layout system. |
| mode | true | false | java.lang.String | Mode in which widget must be rendered. |
| value | false | false | java.lang.String | The value on which widget will apply. If the "fields" attribute is not defined, it has to represent the bound property. Otherwise, it is used as a base for fields definitions that will represent the bound properties. |
| fields | false | false | java.lang.String | The field definitions on which the widget will apply. Must resolve to a list of FieldDefinition instances, or a list of String items. |
| properties | false | false | java.lang.String | The widget properties. Must resolve to an instance of Map. Any other tag attributes are accepted and will be added on top of these properties. |
| label | false | false | java.lang.String | The String widget label. |
| helpLabel | false | false | java.lang.String | The String widget help label. |
| translated | false | false | java.lang.String | The boolean value stating it the widget labels have to be translated. |
| Variables |
No Variables Defined. |
Output Generated by
Tag Library Documentation Generator.
Java, JSP, and JavaServer Pages are trademarks or
registered trademarks of Sun Microsystems, Inc. in the US and other
countries. Copyright 2002-4 Sun Microsystems, Inc.
4150 Network Circle
Santa Clara, CA 95054, U.S.A.
All Rights Reserved.