Site Search

If your site has a significant amount of text in it, you might want to offer a search feature to your site visitors.

Sparkle’s site search feature produces an index of the text in all pages, making it instantly searchable.

You get started by adding the site search field element to the page, from the “Add” popup. This adds the search control where site visitors will enter their query terms.

When you add the search field, a new page is added to the site as well, and it’s pre-populated with search results.

The search field itself has minimal settings, but it acts like a group containing a text input field and a button. The text input and the button have pre-determined values for some properties, for example the button action always leads to the search results page. But other than that you can customize them like any other Sparkle text input or button.

Likewise the search results box, on the result page, has some properties of its own, but you can click through to the results text block to customize its look.

The settings for the overall search results box are the number of results and the text length of each result snippet. You can then customize the “No search results” message, for when the query doesn’t find results. Finally you can customize how to highlight the query term in the search results. The following section of the inspector is the background box, with settings identical to those of boxes.

Below the search results is a strip of numbered pagination controls. The settings are identical to those of buttons, except for the top section which has settings for the button corresponding to the current results page.

The site search element
Search results page element
Search pagination

Updated for Sparkle 3.1

Auf Deutsch

En Français

In Italiano

Please report any shortcoming in this documentation and we’ll fix it as soon as possible!

Sparkle combines an all-in-one approach, an understandable interface and a focus on producing high performance and search engine optimized websites. 

All in a powerful native Mac app. 

Nothing else comes close.

Copyright ©2021 River SRL 

IT06208340486 — REA FI-609716

This site uses cookies. Some are essential to make our site work; others help us improve the user experience and display third party content. By using the site, you agree to our site sending these cookies. Read our privacy policy to learn more or opt out.