org.apache.myfaces.trinidad.component.core
Class CoreSubform
java.lang.Object
javax.faces.component.UIComponent
org.apache.myfaces.trinidad.component.UIXComponent
org.apache.myfaces.trinidad.component.UIXComponentBase
org.apache.myfaces.trinidad.component.UIXSubform
org.apache.myfaces.trinidad.component.core.CoreSubform
- All Implemented Interfaces:
- javax.faces.component.NamingContainer, javax.faces.component.StateHolder
public class CoreSubform
- extends UIXSubform
The CoreSubform represents an independently submittable
region of a page. The contents of a subform will only be validated
(or otherwise processed) if a component inside of the subform is
responsible for submitting the page or if the default attribute is set to true. This allows for comparatively
fine-grained control of which components will be validated and pushed
into the model without the compromises of using entirely separate form
elements.
We strongly recommend the use of a single <tr:form> per page, and
using <tr:subform> where you might otherwise be tempted to use multiple
forms. Multiple forms require multiple copies of page state, and user
edits in forms that aren't submitted are always lost. When a page using
subforms is submitted, page state is only written once, and all
user edits are preserved.
See the UIXSubform Javadoc for more details on how subforms work.
Events:
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 events might include the width of a column that supported client-side resizing. |
Fields inherited from interface javax.faces.component.NamingContainer |
SEPARATOR_CHAR |
Constructor Summary |
|
CoreSubform()
Construct an instance of the CoreSubform. |
protected |
CoreSubform(java.lang.String rendererType)
Construct an instance of the CoreSubform. |
Methods inherited from class org.apache.myfaces.trinidad.component.UIXComponentBase |
addAttributeChange, addAttributeChangeListener, addFacesListener, broadcast, broadcastToMethodBinding, createFacesBean, decode, decodeChildren, decodeChildrenImpl, encodeAll, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributeChangeListener, getAttributeChangeListeners, getAttributes, getBooleanProperty, getChildCount, getChildren, getClientId, getFacesBean, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacetNames, getFacets, getFacetsAndChildren, getId, getIntProperty, getLifecycleRenderer, getLocalClientId, getParent, getProperty, getPropertyKey, getRenderer, getRendererType, getRendersChildren, getValueBinding, isRendered, isTransient, markInitialState, processRestoreState, processSaveState, removeAttributeChangeListener, removeFacesListener, restoreState, saveState, setAttributeChangeListener, setBooleanProperty, setId, setIntProperty, setParent, setProperty, setRendered, setRendererType, setTransient, setValueBinding, toString, updateChildren, updateChildrenImpl, validateChildren, validateChildrenImpl |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
TYPE
public static final FacesBean.Type TYPE
COMPONENT_FAMILY
public static final java.lang.String COMPONENT_FAMILY
- See Also:
- Constant Field Values
COMPONENT_TYPE
public static final java.lang.String COMPONENT_TYPE
- See Also:
- Constant Field Values
CoreSubform
public CoreSubform()
- Construct an instance of the CoreSubform.
CoreSubform
protected CoreSubform(java.lang.String rendererType)
- Construct an instance of the CoreSubform.
getFamily
public java.lang.String getFamily()
- Overrides:
getFamily
in class UIXSubform
getBeanType
protected FacesBean.Type getBeanType()
- Overrides:
getBeanType
in class UIXSubform
Copyright © 2001-2010 The Apache Software Foundation. All Rights Reserved.