Oracle Fusion Middleware Data Visualization Tools Tag Reference for Oracle ADF Faces
12c (12.2.1.4.0)

E81450-01

<dvt:search>

dvt:search search search

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

The search component usage within <dvt:hierarchyViewer> has been deprecated.

The search component is used to perform a search and display result. It is added as a child of the hierarchyViewer tag to enable searching. The searchResults tag must be added as a child of the search tag to specify how to handle results. When enabled, a collapsible search panel is displayed in the top, right corner of the hierarchyViewer.

Relationship with other tags

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

The search component can have the following children: facet (this facet only supports a single child component) and
<dvt:searchResults>.

Example

The following example shows XML for a search tag.

     <dvt:search id="searchId"
                 value="#{hvSearch.searchText}"
                 actionListener="#{hvSearch.doSearch}">
       <f:facet name="end">
         <af:commandLink id="mcl" text="More"
                         actionListener="#{bean.moreAction}"/>
       </f:facet>
       <dvt:searchResults id="searchResultId"
                          emptyText="Text not found"
                          fetchSize="10"
                          value="#{hvSearch.results}"
                          resultListener="#{hvSearch.doResultAction}"
                          var="resultRow">
          <af:setPropertyListener from="#{resultRow.personId}"
                                  to="#{hvSearch.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>
     </dvt:search>
       

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
actionListener javax.el.MethodExpression Only EL a method reference to an action listener, the method is invoked when the end user tries to perform a search
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.Search 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.
id String No the identifier for the component
initialBehavior String Yes Valid Values: initCollapsed, initExpanded, hidden
Default Value: initCollapsed

Specifies the behavior of the search panel. Valid values are:

  • "initCollapsed" - initially collapsed
  • "initExpanded" - initially expanded
  • "hidden" - hidden from view
rendered boolean Yes Default Value: true

Specifies whether the component is rendered.
value String Yes the search text.