ldc-poule-et-toque/content/plugins/elasticpress/docs/theme-integration.md
2021-04-12 15:54:29 +02:00

30 lines
No EOL
1.5 KiB
Markdown

## Autosuggest
### Connecting Autosuggest to Your Theme's Search Bar
When enabled the ElasticPress Autosuggest will automatically be added to any `input[type="search"]` elments on the page, as well as any elements with the `.ep-autosuggest` or `.search-field` classes. You can add autosuggest to additional elements yourself by adding [selectors](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors) as a comma-separated list to the _Autosuggest Selector_ setting under _ElasticPress > Features > Autosuggest > Settings_.
### Adding a Loading Indicator
While new suggestions are being fetched as the user types, an `.is-loading` class will be added to the parent `<form>` element. This class can be used to style the search form differently while suggestions are being loaded. One possible use case is to display a loading indicator. For example, if you have a loading gif in your theme's search form:
```
<form role="search" method="get" action="<?php echo esc_url( home_url( '/' ) ); ?>">
<label>
<span class="screen-reader-text">Search for:</span>
<input type="search" value="<?php echo get_search_query(); ?>" name="s">
</label>
<input type="submit" value="Search">
<img src="<?php echo esc_url( get_theme_file_uri( 'images/loading.gif' ) ); ?>" width="32" height="32" class="loading-indicator">
</form>
```
You could display the loading gif while suggestions are being fetched with this CSS:
```
.loading-indicator {
display: none;
}
.is-loading .loading-indicator {
display: block;
}
```