Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle ADF Faces
11g Release 1 (11.1.1)
Class UIXDynamicDeclarativeComponent

  extended by javax.faces.component.UIComponent
      extended by org.apache.myfaces.trinidad.component.UIXComponent
          extended by org.apache.myfaces.trinidad.component.UIXComponentBase
              extended by
                  extended by
                      extended by

All Implemented Interfaces:
javax.faces.component.NamingContainer, javax.faces.component.StateHolder, org.apache.myfaces.trinidad.component.FlattenedComponent
Direct Known Subclasses:

public class UIXDynamicDeclarativeComponent
extends UIXInclude

Defines a dynamic declarative component without a need for a specific tag. Dynamic declarative components allow the UI definition of a component to be defined in terms of a composition of other components and then treated as a single component.

You can pass attributes using JSP tag attributes, or by using <f:attribute>. Facets can also be set as normal using <f:facet> tags. The definition can refer to the attributes of the component by using the "var" EL variable and the component itself using the "componentVar" EL variable that are setup on the <af:componentDef> tag. The definition can reference a facet using the <af:facetRef> tag. Each facet can only be referenced once.

If you put a component as a child of a declarative component but fail to put it inside of a facet and fail to reference that facet in the component definition file (via facetRef), that component will not be rendered.

Dynamic declarative components support flattened chlidren. This means that children of the declarative component can be seen by the declarative component parent. So for example, input components at the root level of the declarative component will be correctly rendered if the declarative component resides in a panelFormLayout component.

Note about stretching layouts and flowing/scrolling layouts:

With today's web browsers, it is not reliable to have vertically-stretched content inside of areas that also have scroll bars. If you want the outer areas of your page structure to stretch, you need to be careful of how you assemble your component tree.

Rules of thumb:

  1. Never place a scrolling panelGroupLayout inside of another scrolling panelGroupLayout since users do not like nested scroll bars.
  2. Never specify percentage heights in any component's inlineStyle attribute.
  3. Never use the "position" style in any component's inlineStyle attribute.
  4. Unless you are using fixed pixel heights on them, you would never place a panelSplitter or panelStretchLayout inside of any panelGroupLayout regardless of what you have set its layout attribute to.

If you believe that you need to break one of these rules, this is an indication that your page structure is not following the page structure guidelines and you will likely have troubles getting your application to render consistently across various web browsers and computing platforms.


Type Phases Description
org.apache.myfaces.trinidad.event.AttributeChangeEvent Invoke
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 java.lang.String COMPONENT_FAMILY
static java.lang.String COMPONENT_TYPE
static org.apache.myfaces.trinidad.bean.FacesBean.Type TYPE


Fields inherited from class


Fields inherited from class org.apache.myfaces.trinidad.component.UIXComponentBase


Fields inherited from class javax.faces.component.UIComponent


Fields inherited from interface javax.faces.component.NamingContainer


Constructor Summary
          Construct an instance of the UIXDynamicDeclarativeComponent.
protected UIXDynamicDeclarativeComponent(java.lang.String rendererType)
          Construct an instance of the UIXDynamicDeclarativeComponent.


Method Summary
protected  org.apache.myfaces.trinidad.bean.FacesBean.Type getBeanType()
 java.lang.String getFamily()


Methods inherited from class
broadcast, getAttribute, getComponentVar, getVar, getViewId, invokeOnComponent, queueEvent, setAttribute, setComponentVar, setupVisitingContext, setVar, tearDownVisitingContext


Methods inherited from class
encodeBegin, encodeEnd, finishComponentEncoding, isFlatteningChildren, processDecodes, processFlattenedChildren, processUpdates, processValidators, restoreContext, setupContext


Methods inherited from class org.apache.myfaces.trinidad.component.UIXComponentBase
adaptMethodBinding, addAttributeChange, addAttributeChangeListener, addFacesListener, broadcastToMethodBinding, broadcastToMethodExpression, createFacesBean, decode, decodeChildren, decodeChildrenImpl, encodeAll, encodeChildren, findComponent, getAttributeChangeListener, getAttributeChangeListeners, getAttributes, getBooleanProperty, getChildCount, getChildren, getClientId, getContainerClientId, getFacesBean, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacetNames, getFacets, getFacetsAndChildren, getId, getIntProperty, getLifecycleRenderer, getParent, getProperty, getPropertyKey, getRenderer, getRendererType, getRendersChildren, getValueBinding, getValueExpression, invokeOnChildrenComponents, invokeOnNamingContainerComponent, isRendered, isTransient, markInitialState, processRestoreState, processSaveState, removeAttributeChangeListener, removeFacesListener, restoreState, saveState, setAttributeChangeListener, setAttributeChangeListener, setBooleanProperty, setId, setIntProperty, setParent, setProperty, setRendered, setRendererType, setTransient, setValueBinding, setValueExpression, toString, updateChildren, updateChildrenImpl, validateChildren, validateChildrenImpl


Methods inherited from class org.apache.myfaces.trinidad.component.UIXComponent
addPartialTarget, isVisitable, partialEncodeVisit, processFlattenedChildren, processFlattenedChildren, processFlattenedChildren, processFlattenedChildren, setPartialTarget, setUpEncodingContext, tearDownEncodingContext, visitTree, visitTree


Methods inherited from class javax.faces.component.UIComponent


Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait


Field Detail


public static final org.apache.myfaces.trinidad.bean.FacesBean.Type TYPE


public static final java.lang.String COMPONENT_FAMILY
See Also:
Constant Field Values


public static final java.lang.String COMPONENT_TYPE
See Also:
Constant Field Values

Constructor Detail


public UIXDynamicDeclarativeComponent()
Construct an instance of the UIXDynamicDeclarativeComponent.


protected UIXDynamicDeclarativeComponent(java.lang.String rendererType)
Construct an instance of the UIXDynamicDeclarativeComponent.

Method Detail


public java.lang.String getFamily()
getFamily in class UIXInclude


protected org.apache.myfaces.trinidad.bean.FacesBean.Type getBeanType()
getBeanType in class UIXInclude

Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle ADF Faces
11g Release 1 (11.1.1)

Copyright (c) 1998, 2008, Oracle and/or its affiliates. All rights reserved.