<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 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 <dvt:searchResults>.

Example

The following example shows XML for a search tag.

     <dvt:search id="searchId"
                 value="#{XMLParser.searchText}"
                 actionListener="#{XMLParser.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="#{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>
     </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 events might include the width of a column that supported client-side resizing.

Attributes

Name Type Supports EL? Description
actionListener String Yes 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. The identifier must follow a subset of the syntax allowed in HTML:
  • Must not be a zero-length String.
  • First character must be an ASCII letter (A-Za-z) or an underscore ('_').
  • Subsequent characters must be an ASCII letter or digit (A-Za-z0-9), an underscore ('_'), or a dash ('-').
initialBehavior String Yes

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

  • "initCollapsed" - initially collapsed
  • "initExpanded" - initially expanded
  • "hidden" - hidden from view
rendered boolean Yes Specifies whether the component is rendered.
value String Yes the search text.