Skip to Main Content

Search configurations

You don't need to provide a query to the item. Instead the SearchBox plug-in utilizes the search configuration feature of Oracle APEX. In the shared components of your application, there is a section called "Search Configurations". In there, you can manage search definitions based on your data. Refer to our documentation to learn how to set one up.

Creating a global SearchBox

You could add a search bar to any specific page, but in most cases, a global search offers the best user experience, as users expect to be able to search from anywhere.

To add a global SearchBox, go to page 0 and add a new page item of the type UC SearchBox Pro. Give it a fitting name, like P0_SEARCH, and set the Slot in Layout to After Logo.

Next up, we can configure which search configurations should be used in the SearchBox. We can just add the Static IDs of search configurations, separated by a new line.

We can optimize the look and feel by setting the following attributes:

  • Value Placeholder: Search...
  • Icon: fa-search
  • Template: Optional
  • Template Options → Size: Large
  • Template Options → Left Margin: Large

Now our SearchBox is available on every (non-modal) page of our application. Take a look at the customization page to see how you can customize the look and feel of the search bar.

Item vs. Spotlight

SearchBox Pro comes in two modes: Item and Spotlight.

The item mode is an input you can type into to start a search.

In spotlight mode, only a button is displayed. On clicking, a modal with an input appears.

There is also a responsive mode. This one switches from item to spotlight mode on small screen widths.

Try it out

Try it out