Oracle Fusion Middleware Data Visualization Tools Tag Reference for Oracle ADF Faces
12c (12.1.2)
E23187-01

<dvt:searchResults>

UIComponent class: oracle.adf.view.faces.bi.component.hierarchyViewer.SearchResults
Component type: oracle.dss.adf.hierarchyViewer.SearchResults

The SearchResults component is used to display a search result. The searchResults tag must be added as a child of the search tag to specify how to display the search results.

Relationship with other tags

This component must be a child of the <dvt:search> component.

The searchResults component can have the following children: facet (this facet only supports a single child component)

Example

The following example shows XML for a searchResults tag.

       <dvt:searchResults id="searchResultId"
                          emptyText="Text not found"
                          fetchSize="10"
                          value="#{XMLParser.results}"
                          resultListener="#{XMLParser.doResultAction}"
                          var="resultRow">
          <af:setPropertyListener from="#{resultRow.personId}"
                                  to="#{XMLParser.selectedId}"
                                  type="action"/>
          <f:facet name="content">
            <af:panelGroupLayout inlineStyle="width:110px;height:20px;">
              <af:commandImageLink icon="nopic.png"
                                   text="#{resultRow.lastName}"
                                   id="cil1"/>
              <af:outputText value="#{resultRow.firstName}"
                             id="ot1" />
            </af:panelGroupLayout>
          </f:facet>
       </dvt:searchResults>

Sizing

The desired size of the search result stamp should be specified in pixels using the width and height attributes in the inlineStyle property of the outermost container element in the content facet so that the results show the specified content as intended. If no size is specified, a default size of 100 x 30 will be used.

Screen Shot(s)

No image.

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.faces.bi.component.hierarchyViewer.SearchResults	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.
emptyText	String	Yes	The text of an empty search results.
fetchSize	int	Yes	Default Value: 25
id	String	Yes	the identifier for the component
rendered	boolean	Yes	Default Value: true Specifies whether the component is rendered.
resultListener	javax.el.MethodExpression	Only EL	A reference to an action listener that will be called after a row in the search results is selected.
value	Object	Yes	Specifies the search results data model. This must be an instance of oracle.adf.view.faces.bi.model.DataModel
var	String	No	Name of the EL variable used to reference cell data element of this collection. Once this component has completed rendering, this variable is removed (or reverted back to its previous value).
varStatus	String	No	Name of the EL variable used to reference the varStatus information. Once this component has completed rendering, this variable is removed (or reverted back to its previous value).