public abstract class PartialRichPanelFormLayout
extends org.apache.myfaces.trinidad.component.UIXPanel
implements javax.faces.component.behavior.ClientBehaviorHolder
The panelFormLayout positions input form controls, such that their labels and fields line up vertically. It supports multiple columns, and also supports a footer facet.
Usually, this component will simply contain labelled ADF Faces input components in its main content. This includes components whose names start with 'input' (like inputText and inputDate) and components that start with 'select' (like selectOneChoice, selectBooleanRadio, and selectManyChoice). These components must have their 'simple' attribute set to false, which is the default, and will cause the labels and fields inside the panelFormLayout to be aligned vertically.
When more complex field content is needed, use a panelLabelAndMessage around the content.
Other components can be added to panelFormLayout, but they will not line up with labels and fields automatically, and each will appear on its own row. You can use other panel components, like a horizontal layout panelGroupLayout, to layout a row of buttons or fields. To align content with other labels and fields, use panelLabelAndMessage or use the 'footer' facet. You may also alternatively place a facetRef, iterator, or switcher inside of the panelFormLayout and their resolved children will be treated as if they were direct children of the panelFormLayout.
PanelFormLayout supports grouping of its child components. If you place panelFormLayout children inside of a group, by default separators will be drawn around the group of items if adjacent to other form items. By default separators won't be drawn at the top if the group is the first item in the column or, at the bottom if the group is the last item in the column. Grouped panelFormLayout items are kept in the same column of the panelFormLayout even when the assigned rows attribute is set to a value smaller than the number of items in the group. The panelFormLayout component also supports the group component in its footer facet so you can place more than one item in the footer. You can group footer items one additional time to get separators to appear. In responsive layout mode, nesting of groups isn't supported.
By default visual group separators always appear (following the rules above). If you want a group but do not want the group separator to appear, you can set the group's startBoundary or endBoundary attributes to 'hide' to request that the corresponding boundary be hidden. Note that when a first group's endBoundary and a second group's startBoundary are both set, the separator will only be hidden if both values are set to 'hide' or one value is 'hide' while the other value is 'dontCare'.
A group of items can also have a title, by setting the group's title attribute. Only groups that have their start boundaries displayed will show their title values. Note that you should use a group title that is not horizontally longer than the width of the current panelFormLayout column. If you choose a group title that is longer than the width of the panelFormLayout, the panelFormLayout will stretch horizontally to accommodate the title.
Type | Phases | Description |
---|---|---|
org.apache.myfaces.trinidad.event.AttributeChangeEvent |
Invoke Application Apply Request Values |
Event delivered to describe an attribute change. Attribute change events are not delivered for any programmatic change to a property. They are only delivered when a renderer changes a property without the application's specific request. An example of an attribute change event might include the width of a column that supported client-side resizing. |
Modifier and Type | Field and Description |
---|---|
static org.apache.myfaces.trinidad.bean.PropertyKey |
CLIENT_ATTRIBUTES_KEY |
static org.apache.myfaces.trinidad.bean.PropertyKey |
CLIENT_COMPONENT_KEY |
static org.apache.myfaces.trinidad.bean.PropertyKey |
CLIENT_LISTENERS_KEY |
static String |
COMPONENT_FAMILY |
static String |
COMPONENT_TYPE |
static org.apache.myfaces.trinidad.bean.PropertyKey |
CUSTOMIZATION_ID_KEY
Deprecated.
|
static org.apache.myfaces.trinidad.bean.PropertyKey |
FIELD_WIDTH_KEY |
static String |
FOOTER_FACET |
static org.apache.myfaces.trinidad.bean.PropertyKey |
INLINE_STYLE_KEY |
static org.apache.myfaces.trinidad.bean.PropertyKey |
LABEL_ALIGNMENT_KEY |
static String |
LABEL_ALIGNMENT_START |
static String |
LABEL_ALIGNMENT_TOP |
static org.apache.myfaces.trinidad.bean.PropertyKey |
LABEL_WIDTH_KEY |
static org.apache.myfaces.trinidad.bean.PropertyKey |
LAYOUT_KEY |
static org.apache.myfaces.trinidad.bean.PropertyKey |
MAX_COLUMNS_KEY |
static org.apache.myfaces.trinidad.bean.PropertyKey |
PARTIAL_TRIGGERS_KEY |
static org.apache.myfaces.trinidad.bean.PropertyKey |
ROWS_KEY |
static org.apache.myfaces.trinidad.bean.PropertyKey |
SHORT_DESC_KEY |
static org.apache.myfaces.trinidad.bean.PropertyKey |
STYLE_CLASS_KEY |
static org.apache.myfaces.trinidad.bean.FacesBean.Type |
TYPE |
static org.apache.myfaces.trinidad.bean.PropertyKey |
UNSECURE_KEY |
static org.apache.myfaces.trinidad.bean.PropertyKey |
VISIBLE_KEY |
Modifier | Constructor and Description |
---|---|
protected |
PartialRichPanelFormLayout(String rendererType)
Construct an instance of the PartialRichPanelFormLayout
with the specified renderer type.
|
Modifier and Type | Method and Description |
---|---|
void |
addClientBehavior(String eventName,
javax.faces.component.behavior.ClientBehavior behavior) |
protected org.apache.myfaces.trinidad.bean.FacesBean.Type |
getBeanType() |
Set |
getClientAttributes()
Gets a set of client attribute names.
|
Map<String,List<javax.faces.component.behavior.ClientBehavior>> |
getClientBehaviors() |
ClientListenerSet |
getClientListeners()
Gets a set of client listeners.
|
String |
getCustomizationId()
Deprecated.
This attribute is deprecated. This attribute will be removed in the next release. Use the 'id' attribute instead.
|
String |
getDefaultEventName() |
Collection<String> |
getEventNames() |
String |
getFamily() |
String |
getFieldWidth()
Gets The preferred width of the fields.
|
javax.faces.component.UIComponent |
getFooter()
This facet is rendered under the columns and usually contains an af:group when you want to have more than a single item in the footer.
|
String |
getInlineStyle()
Gets the CSS styles to use for this component.
|
String |
getLabelAlignment()
Gets The alignment of label prompts for the form items.
|
String |
getLabelWidth()
Gets The preferred width of the labels.
|
RichPanelFormLayout.Layout |
getLayout()
Gets The layout style to be used.
|
int |
getMaxColumns()
Gets the maximum number of columns to show.
|
String[] |
getPartialTriggers()
Gets the IDs of the components that should trigger a partial update.
|
int |
getRows()
Gets the number of rows after which to start a new column.
|
String |
getShortDesc()
Gets the short description of the component.
|
String |
getStyleClass()
Gets a CSS style class to use for this component.
|
Set<String> |
getUnsecure()
Gets A whitespace separated list of attributes whose values ordinarily can be set
only on the server, but need to be settable on the client.
|
boolean |
isClientComponent()
Gets whether a client-side component will be generated.
|
boolean |
isVisible()
Gets the visibility of the component.
|
void |
setClientAttributes(Set clientAttributes)
Sets a set of client attribute names.
|
void |
setClientComponent(boolean clientComponent)
Sets whether a client-side component will be generated.
|
void |
setClientListeners(ClientListenerSet clientListeners)
Sets a set of client listeners.
|
void |
setCustomizationId(String customizationId)
Deprecated.
This attribute is deprecated. This attribute will be removed in the next release. Use the 'id' attribute instead.
|
void |
setFieldWidth(String fieldWidth)
Sets The preferred width of the fields.
|
void |
setFooter(javax.faces.component.UIComponent footerFacet)
This facet is rendered under the columns and usually contains an af:group when you want to have more than a single item in the footer.
|
void |
setInlineStyle(String inlineStyle)
Sets the CSS styles to use for this component.
|
void |
setLabelAlignment(String labelAlignment)
Sets The alignment of label prompts for the form items.
|
void |
setLabelWidth(String labelWidth)
Sets The preferred width of the labels.
|
void |
setLayout(RichPanelFormLayout.Layout layout)
Sets The layout style to be used.
|
void |
setMaxColumns(int maxColumns)
Sets the maximum number of columns to show.
|
void |
setPartialTriggers(String[] partialTriggers)
Sets the IDs of the components that should trigger a partial update.
|
void |
setRows(int rows)
Sets the number of rows after which to start a new column.
|
void |
setShortDesc(String shortDesc)
Sets the short description of the component.
|
void |
setStyleClass(String styleClass)
Sets a CSS style class to use for this component.
|
void |
setUnsecure(Set<String> unsecure)
Sets A whitespace separated list of attributes whose values ordinarily can be set
only on the server, but need to be settable on the client.
|
void |
setVisible(boolean visible)
Sets the visibility of the component.
|
adaptMethodBinding, addAttributeChange, addAttributeChangeListener, addComponentChange, addComponentChange, addComponentChangeFilter, addFacesListener, broadcast, broadcastToMethodBinding, broadcastToMethodExpression, clearCachedClientIds, clearInitialState, createFacesBean, decode, decodeChildren, decodeChildrenImpl, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributeChangeListener, getAttributeChangeListeners, getAttributes, getBooleanProperty, getChildCount, getChildren, getClientId, getComponentChangeFilters, getContainerClientId, getFacesBean, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacetNames, getFacets, getFacetsAndChildren, getId, getIntProperty, getLifecycleRenderer, getListenersForEventClass, getParent, getPassThroughAttributes, getProperty, getPropertyKey, getRenderedFacetsAndChildren, getRenderer, getRendererType, getRendersChildren, getValueBinding, getValueExpression, initialStateMarked, invokeOnChildrenComponents, invokeOnComponent, invokeOnNamingContainerComponent, isRendered, isTransient, markInitialState, processDecodes, processRestoreState, processSaveState, processUpdates, processValidators, queueEvent, removeAttributeChangeListener, removeComponentChangeFilter, removeFacesListener, restoreState, satisfiesPartialTrigger, saveState, setAttributeChangeListener, setAttributeChangeListener, setBooleanProperty, setId, setIntProperty, setParent, setProperty, setRendered, setRendererType, setTransient, setupFlattenedChildrenContext, setupFlattenedContext, setValueBinding, setValueExpression, subscribeToEvent, tearDownFlattenedChildrenContext, tearDownFlattenedContext, toString, unsubscribeFromEvent, updateChildren, updateChildrenImpl, validateChildren, validateChildrenImpl
addPartialTarget, broadcastInContext, clearCachedClientIds, defaultGetRenderedFacetsAndChildren, encodeFlattenedChild, encodeFlattenedChildren, getLogicalParent, getLogicalParent, getStateHelper, getStateHelper, isVisitable, partialEncodeVisit, processFlattenedChildren, processFlattenedChildren, processFlattenedChildren, processFlattenedChildren, setPartialTarget, setupChildrenEncodingContext, setupChildrenVisitingContext, setupEncodingContext, setUpEncodingContext, setupVisitingContext, tearDownChildrenEncodingContext, tearDownChildrenVisitingContext, tearDownEncodingContext, tearDownVisitingContext, visitAllChildren, visitChildren, visitChildren, visitTree, visitTree
encodeAll, getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getNamingContainer, getPassThroughAttributes, getResourceBundleMap, getTransientStateHelper, getTransientStateHelper, isCompositeComponent, isInView, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView
public static final String LABEL_ALIGNMENT_START
public static final String LABEL_ALIGNMENT_TOP
public static final org.apache.myfaces.trinidad.bean.FacesBean.Type TYPE
public static final org.apache.myfaces.trinidad.bean.PropertyKey INLINE_STYLE_KEY
public static final org.apache.myfaces.trinidad.bean.PropertyKey STYLE_CLASS_KEY
public static final org.apache.myfaces.trinidad.bean.PropertyKey SHORT_DESC_KEY
public static final org.apache.myfaces.trinidad.bean.PropertyKey UNSECURE_KEY
public static final org.apache.myfaces.trinidad.bean.PropertyKey VISIBLE_KEY
@Deprecated public static final org.apache.myfaces.trinidad.bean.PropertyKey CUSTOMIZATION_ID_KEY
public static final org.apache.myfaces.trinidad.bean.PropertyKey CLIENT_COMPONENT_KEY
public static final org.apache.myfaces.trinidad.bean.PropertyKey CLIENT_ATTRIBUTES_KEY
public static final org.apache.myfaces.trinidad.bean.PropertyKey PARTIAL_TRIGGERS_KEY
public static final org.apache.myfaces.trinidad.bean.PropertyKey CLIENT_LISTENERS_KEY
public static final org.apache.myfaces.trinidad.bean.PropertyKey FIELD_WIDTH_KEY
public static final org.apache.myfaces.trinidad.bean.PropertyKey LAYOUT_KEY
public static final org.apache.myfaces.trinidad.bean.PropertyKey LABEL_WIDTH_KEY
public static final org.apache.myfaces.trinidad.bean.PropertyKey MAX_COLUMNS_KEY
public static final org.apache.myfaces.trinidad.bean.PropertyKey ROWS_KEY
public static final org.apache.myfaces.trinidad.bean.PropertyKey LABEL_ALIGNMENT_KEY
public static final String FOOTER_FACET
public static final String COMPONENT_FAMILY
public static final String COMPONENT_TYPE
protected PartialRichPanelFormLayout(String rendererType)
rendererType
- the renderer type
Construct an instance of the PartialRichPanelFormLayout.public final javax.faces.component.UIComponent getFooter()
This facet may not always line up perfectly, particularly if the labels or fields used in the panelFormLayout are longer than what you have allocated for them. Adjust the allocations you have with the labelWidth and fieldWidth attributes when necessary. Remember that labelWidth and fieldWidth must use the same units. Also, the columns attribute on inputText may be helpful to reduce the amount of space that it consumes. In responsive layout mode, the extra wide fields will stretch and end align with the widest field in the second column if there are three or more columns being displayed. Else the extra wide fields will end align with widest field in the last column being displayed. In JSP pages, only one component is allowed. When using Facelets, multiple components are allowed.
public final void setFooter(javax.faces.component.UIComponent footerFacet)
This facet may not always line up perfectly, particularly if the labels or fields used in the panelFormLayout are longer than what you have allocated for them. Adjust the allocations you have with the labelWidth and fieldWidth attributes when necessary. Remember that labelWidth and fieldWidth must use the same units. Also, the columns attribute on inputText may be helpful to reduce the amount of space that it consumes. In responsive layout mode, the extra wide fields will stretch and end align with the widest field in the second column if there are three or more columns being displayed. Else the extra wide fields will end align with widest field in the last column being displayed. In JSP pages, only one component is allowed. When using Facelets, multiple components are allowed.
footerFacet
- the new footer facetpublic final String getInlineStyle()
public final void setInlineStyle(String inlineStyle)
inlineStyle
- the new inlineStyle valuepublic final String getStyleClass()
public final void setStyleClass(String styleClass)
styleClass
- the new styleClass valuepublic final String getShortDesc()
For components with images, the shortDesc is often used to render an HTML alt attribute for the image. Please see the accessibility guidelines section for correct alt text usage of the shortDesc attribute.
shortDesc is also commonly used to render an HTML title attribute, which is used by user agents to display tooltip help text. In this case the behavior for the tooltip is controlled by the user agent, e.g. Firefox 2 truncates long tooltips. For form components, the shortDesc is displayed in a note window. For components that support the helpTopicId attribute and are not using the shortDesc as image alt text, it is recommended that helpTopicId is used instead of shortDesc as it is more flexible and provides more accessible descriptive text than the use of the title attribute.
public final void setShortDesc(String shortDesc)
For components with images, the shortDesc is often used to render an HTML alt attribute for the image. Please see the accessibility guidelines section for correct alt text usage of the shortDesc attribute.
shortDesc is also commonly used to render an HTML title attribute, which is used by user agents to display tooltip help text. In this case the behavior for the tooltip is controlled by the user agent, e.g. Firefox 2 truncates long tooltips. For form components, the shortDesc is displayed in a note window. For components that support the helpTopicId attribute and are not using the shortDesc as image alt text, it is recommended that helpTopicId is used instead of shortDesc as it is more flexible and provides more accessible descriptive text than the use of the title attribute.
shortDesc
- the new shortDesc valuepublic final Set<String> getUnsecure()
public final void setUnsecure(Set<String> unsecure)
unsecure
- the new unsecure valuepublic final boolean isVisible()
public final void setVisible(boolean visible)
visible
- the new visible value@Deprecated public final String getCustomizationId()
@Deprecated public final void setCustomizationId(String customizationId)
customizationId
- the new customizationId valuepublic final boolean isClientComponent()
public final void setClientComponent(boolean clientComponent)
clientComponent
- the new clientComponent valuepublic final Set getClientAttributes()
public final void setClientAttributes(Set clientAttributes)
clientAttributes
- the new clientAttributes valuepublic final String[] getPartialTriggers()
public final void setPartialTriggers(String[] partialTriggers)
partialTriggers
- the new partialTriggers valuepublic final ClientListenerSet getClientListeners()
public final void setClientListeners(ClientListenerSet clientListeners)
clientListeners
- the new clientListeners valuepublic final String getFieldWidth()
public final void setFieldWidth(String fieldWidth)
fieldWidth
- the new fieldWidth valuepublic final RichPanelFormLayout.Layout getLayout()
public final void setLayout(RichPanelFormLayout.Layout layout)
layout
- the new layout valuepublic final String getLabelWidth()
public final void setLabelWidth(String labelWidth)
labelWidth
- the new labelWidth valuepublic final int getMaxColumns()
public final void setMaxColumns(int maxColumns)
maxColumns
- the new maxColumns valuepublic final int getRows()
public final void setRows(int rows)
rows
- the new rows valuepublic final String getLabelAlignment()
public final void setLabelAlignment(String labelAlignment)
labelAlignment
- the new labelAlignment valuepublic String getDefaultEventName()
getDefaultEventName
in interface javax.faces.component.behavior.ClientBehaviorHolder
getDefaultEventName
in class org.apache.myfaces.trinidad.component.UIXComponentBase
public Collection<String> getEventNames()
getEventNames
in interface javax.faces.component.behavior.ClientBehaviorHolder
public Map<String,List<javax.faces.component.behavior.ClientBehavior>> getClientBehaviors()
getClientBehaviors
in interface javax.faces.component.behavior.ClientBehaviorHolder
getClientBehaviors
in class org.apache.myfaces.trinidad.component.UIXComponentBase
public void addClientBehavior(String eventName, javax.faces.component.behavior.ClientBehavior behavior)
addClientBehavior
in interface javax.faces.component.behavior.ClientBehaviorHolder
addClientBehavior
in class org.apache.myfaces.trinidad.component.UIXComponentBase
public String getFamily()
getFamily
in class org.apache.myfaces.trinidad.component.UIXPanel
protected org.apache.myfaces.trinidad.bean.FacesBean.Type getBeanType()
getBeanType
in class org.apache.myfaces.trinidad.component.UIXPanel