ADF RichClient API - <af:gridRow>

Summary

Tag Name:	<af:gridRow>
Java Class:	oracle.adf.view.rich.component.rich.layout.RichGridRow
Component Type:	oracle.adf.RichGridRow
Required Ancestor Tag(s):	af:panelGridLayout

The gridRow control is a layout element that arranges gridCell children for a parent panelGridLayout component.

You may also alternatively place a facetRef, iterator, or switcher inside of the gridRow and their resolved children will be treated as if they were direct children of the gridRow--those children must resolve to gridCell components.

Geometry Management

This component must be a child of a panelGridLayout; it is not valid to use a gridRow inside of any other kind of layout container.
This component must contain gridCell children; it is not valid to use other components inside of a gridRow.

Screenshot(s)

A gridRow component.

Code Example(s)

<af:panelGridLayout id="grid">
  <af:gridRow id="row" height="auto" marginTop="4px" marginBottom="4px">
    <af:gridCell id="logoCell" width="auto" valign="middle" marginStart="4px">
      <af:link id="logoLnk" action="index" shortDesc="Logo" styleClass="AFBrandingBarLogo"/>
    </af:gridCell>
    <af:gridCell id="flexibleSpace" width="100%"/>
    <af:gridCell id="searchCell" width="auto" valign="middle" marginEnd="4px">
      <af:inputText id="search" label="Search" contentStyle="width:10em"/>
    </af:gridCell>
    <af:gridCell id="statusCell" width="auto" valign="middle" marginEnd="4px">
      <af:statusIndicator id="status"/>
    </af:gridCell>
  </af:gridRow>
</af:panelGridLayout>

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 event might include the width of a column that supported client-side resizing.

Attributes

Name	Type	Supports EL?	Description
attributeChangeListener	javax.el.MethodExpression	Only EL	a method reference to an attribute change listener. 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.
binding	oracle.adf.view.rich.component.rich.layout.RichGridRow	Only EL	an EL reference that will store the component instance on a bean. This can be used to give programmatic access to a component from a backing bean, or to move creation of the component to a backing bean.
height	String	Yes	Default Value: auto Specifies the height of the row: "auto": let the browser draw the components in this row then have the panelGridLayout component ask the browser for the heights of these components to adjust the layout accordingly a fixed CSS length, e.g. "px", "em": constrain the height of this row to be exactly this size regardless of what components are in the row a "%" length: make this row use a normalized fraction of the remaining panelGridLayout space not already used by the other rows (this may resolve to zero); this option is only valid if the panelGridLayout has a fixed height or if it is being stretched by its parent component because otherwise it would be a circular definition for height
id	String	No	the identifier for the component. Every component may be named by a component identifier that must conform to the following rules: They must start with a letter (as defined by the Character.isLetter() method) or underscore ( _ ). Subsequent characters must be letters (as defined by the Character.isLetter() method), digits as defined by the Character.isDigit() method, dashes ( - ), or underscores ( _ ). To minimize the size of responses generated by JavaServer Faces, it is recommended that component identifiers be as short as possible. If a component has been given an identifier, it must be unique in the namespace of the closest ancestor to that component that is a NamingContainer (if any).
marginBottom	String	Yes	Default Value: 0px Specifies a candidate for the amount of space that will be added below this row. The next row could provide a candidate via its marginTop value. Only fixed dimension units are supported, e.g. "px", "em", "pt" (not "auto" nor "%"). The margin candidates will be resolved using the largest value of the first unit type encountered (conflicting unit types will be ignored).
marginTop	String	Yes	Default Value: 0px Specifies a candidate for the amount of space that will be added above this row. The previous row could provide a candidate via its marginBottom value. Only fixed dimension units are supported, e.g. "px", "em", "pt" (not "auto" nor "%"). The margin candidates will be resolved using the largest value of the first unit type encountered (conflicting unit types will be ignored).
rendered	boolean	Yes	Default Value: true whether the component is rendered. When set to false, no output will be delivered for this component (the component will not in any way be rendered, and cannot be made visible on the client). If you want to change a component's rendered attribute from false to true using PPR, set the partialTrigger attribute of its parent component so the parent refreshes and in turn will render this component.