Customizing Styles and HTML
In this guide we'll customize some styles of the Search UI, modify the default HTML of one of the Search UI components, and also create a completely new Result component.
Check out the live example below to see all the code in action.
Customizing styles
We provide a default stylesheet to get your project started quickly.
import "@elastic/react-search-ui-views/lib/styles/styles.css";
You could choose to add your own stylesheet to override or augment these styles:
import "@elastic/react-search-ui-views/lib/styles/styles.css";
import "your-custom-styles.css";
You could also choose to replace these styles completely with your own stylesheet:
import "your-custom-styles.css";
When target styles to override, we generally advise that you rely only on styles that are prefixed with .sui
. We try to keep these compatible for version upgrades so that we don't break your custom styles. However, we do recommend that you test your styles thoroughly when upgrading versions, even within minors.
Here is an example of a simple stylesheet that overrides much of the blue in the base styles with red to create a simple red theme:
.sui-search-box__submit {
background: none;
background-color: red;
}
.sui-layout-sidebar-toggle {
color: red;
border: 1px solid red;
}
.sui-result__title,
.sui-result__title-link {
color: red;
}
.sui-facet-view-more {
color: red;
}
Customizing html
All components in this library can be customized by providing a view
prop.
The view prop can be used to customize a component's look and feel while still maintaining the component's logic.
This follows the React Render Props pattern. The view
prop is a function. The various
logic and values your view needs are passed through as parameters to the view
function you provide.
Every component will have a different function signature for its view.
Here is an example of a custom view being provided for the PagingInfo
component:
<PagingInfo
view={({ start, end }: { start: number, end: number }) => (
<div className="paging-info">
<strong>
{start} - {end}
</strong>
</div>
)}
/>
You'll note that the view
function here has four parameters that are available to use:
searchTerm
- The search term used for this query.start
- The number of the first result shown.end
- The number of the last result shown.totalResults
- The total number of results for this query.
In this case, we've decided to create a simple view that shows the starting and ending result numbers on this page. We've chosen not to use
the totalResults
or searchTerm
properties.
Specific documentation for customizing the view of each component can be found in the documentation for each component. For example, the Result component.