|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.faces.component.UIComponent
org.apache.myfaces.trinidad.component.UIXComponent
org.apache.myfaces.trinidad.component.UIXComponentBase
org.apache.myfaces.trinidad.component.UIXSwitcher
public class UIXSwitcher
The switcher component dynamically decides which facet component should be rendered. It has two properties. The switcher will render the facet matching "facetName"; however, if no such facet exists (or "facetName" is null), and "defaultFacet" has been set, then that facet will be used instead. (It's possible to achieve this same functionality by using a panelGroup and binding the "rendered" property of each child, but this component can be simpler. Ordinary children of the switcher component are not rendered at all.)
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. |
Field Summary | |
---|---|
static String |
COMPONENT_FAMILY
|
static String |
COMPONENT_TYPE
|
static PropertyKey |
DEFAULT_FACET_KEY
|
static PropertyKey |
FACET_NAME_KEY
|
static FacesBean.Type |
TYPE
|
Fields inherited from class org.apache.myfaces.trinidad.component.UIXComponentBase |
---|
BINDING_KEY, ID_KEY, RENDERED_KEY, RENDERER_TYPE_KEY, TRANSIENT_KEY |
Fields inherited from class javax.faces.component.UIComponent |
---|
bindings |
Constructor Summary | |
---|---|
|
UIXSwitcher()
Construct an instance of the UIXSwitcher. |
protected |
UIXSwitcher(String rendererType)
Construct an instance of the UIXSwitcher. |
Method Summary | ||
---|---|---|
void |
encodeChildren(FacesContext context)
Only render the currently active facet. |
|
protected FacesBean.Type |
getBeanType()
|
|
String |
getDefaultFacet()
Gets the name of the facet to render and process if "facetName" is null or otherwise does not refer to an existing facet. |
|
String |
getFacetName()
Gets the name of the facet to render and process. |
|
String |
getFamily()
|
|
boolean |
getRendersChildren()
Override to return true. |
|
boolean |
isFlatteningChildren(FacesContext context)
Returns true if this FlattenedComponent is currently flattening its children |
|
void |
processDecodes(FacesContext context)
Only decode the currently active facet. |
|
|
processFlattenedChildren(FacesContext context,
ComponentProcessingContext cpContext,
ComponentProcessor<S> childProcessor,
S callbackContext)
Processes the selected switcher facet |
|
void |
processUpdates(FacesContext context)
Only process updates on the currently active facet. |
|
void |
processValidators(FacesContext context)
Only process validations on the currently active facet. |
|
void |
setDefaultFacet(String defaultFacet)
Sets the name of the facet to render and process if "facetName" is null or otherwise does not refer to an existing facet. |
|
void |
setFacetName(String facetName)
Sets the name of the facet to render and process. |
|
protected boolean |
visitChildren(VisitContext visitContext,
VisitCallback callback)
Hook for subclasses to override the manner in which the component's children are visited. |
Methods inherited from class javax.faces.component.UIComponent |
---|
encodeAll, getContainerClientId |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final FacesBean.Type TYPE
public static final PropertyKey FACET_NAME_KEY
public static final PropertyKey DEFAULT_FACET_KEY
public static final String COMPONENT_FAMILY
public static final String COMPONENT_TYPE
Constructor Detail |
---|
public UIXSwitcher()
protected UIXSwitcher(String rendererType)
Method Detail |
---|
public void processDecodes(FacesContext context)
processDecodes
in class UIXComponentBase
public void processValidators(FacesContext context)
processValidators
in class UIXComponentBase
public void processUpdates(FacesContext context)
processUpdates
in class UIXComponentBase
public <S> boolean processFlattenedChildren(FacesContext context, ComponentProcessingContext cpContext, ComponentProcessor<S> childProcessor, S callbackContext) throws IOException
processFlattenedChildren
in interface FlattenedComponent
context
- Current FacesContextcpContext
- ComponentProcesingContext represetning the current child iteration statechildProcessor
- ComponentProcessor to call for each flattened childcallbackContext
- childProcessor-specific context to be passed on each call to the
childProcessor
true
if this FlattenedComponent actually processed any children
IOException
- if an error occurs while processing childrenUIXComponent.processFlattenedChildren(FacesContext, ComponentProcessingContext, ComponentProcessor, UIComponent, Object)
,
UIXComponent.processFlattenedChildren(FacesContext, ComponentProcessingContext, ComponentProcessor, Iterable, Object)
,
FlattenedComponent.isFlatteningChildren(javax.faces.context.FacesContext)
public boolean isFlatteningChildren(FacesContext context)
true
if this FlattenedComponent is currently flattening its children
isFlatteningChildren
in interface FlattenedComponent
context
- FacesContext
true
if this FlattenedComponent is currently flattening its childrenFlattenedComponent.processFlattenedChildren(javax.faces.context.FacesContext, org.apache.myfaces.trinidad.component.ComponentProcessingContext, org.apache.myfaces.trinidad.component.ComponentProcessor, S)
public void encodeChildren(FacesContext context) throws IOException
encodeChildren
in class UIXComponentBase
IOException
public boolean getRendersChildren()
getRendersChildren
in class UIXComponentBase
protected boolean visitChildren(VisitContext visitContext, VisitCallback callback)
UIXComponent
setupChildrenVisitingContext
will have been called before this method is
invoked and tearDownChildrenVisitingContext
will be called after.
respectively. If the purpose of this visit was to encode the component and the
component uses a CoreRenderer, the CoreRenderer's
setupChildrenEncodingContext
and tearDownChildrenEncodingContext
will be called before and after this method is invoked, respectively.
visitChildren
in class UIXComponent
visitContext
- the VisitContext
for this visitcallback
- the VisitCallback
instance
true
if the visit is complete.UIXComponent.setupChildrenVisitingContext(javax.faces.context.FacesContext)
,
UIXComponent.tearDownChildrenVisitingContext(javax.faces.context.FacesContext)
,
CoreRenderer.setupChildrenEncodingContext(javax.faces.context.FacesContext, org.apache.myfaces.trinidad.context.RenderingContext, javax.faces.component.UIComponent)
,
CoreRenderer.tearDownChildrenEncodingContext(javax.faces.context.FacesContext, org.apache.myfaces.trinidad.context.RenderingContext, javax.faces.component.UIComponent)
public final String getFacetName()
public final void setFacetName(String facetName)
facetName
- the new facetName valuepublic final String getDefaultFacet()
public final void setDefaultFacet(String defaultFacet)
defaultFacet
- the new defaultFacet valuepublic String getFamily()
getFamily
in class UIXComponentBase
protected FacesBean.Type getBeanType()
getBeanType
in class UIXComponentBase
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |