Interface controls
Search shortcuts, result previews, recovery and color modes.
On this page
Search shortcuts
Enable search, then use Ctrl+K
on Windows/Linux or Cmd+K on macOS to focus the header field.
| Key | Action |
|---|---|
ArrowDown | Select the next result. |
ArrowUp | Select the previous result. |
Enter | Open the selected result. |
Escape | Close results; press again to clear the query and leave search. |
Results appear in batches of eight. Use Show more results to reveal the next
batch. Press Tab from the search field to reach this button; after activation,
arrow-key navigation resumes at the first new result. The status announces how
many results are shown out of the total. Changing the query starts a new batch.
Results include a short excerpt around a matching word in the page text, with literal query terms highlighted. The preview is limited to 180 characters. If the index has no page text, or a match uses stemming without an exact occurrence of a query term, the result keeps the page description or URL as its preview.
Result links also work with the mouse. Moving focus outside search closes the results. On small screens the shortcut hint is hidden.
Search states
The search library, language modules and index load only when you first focus search or use its shortcut. While those files load, the field shows a loading message. You can keep typing; the current query runs when loading completes.
A failed download shows the unavailable message and Retry search. Use Tab
to reach the button and Enter to retry without reloading the page. Successful
dependencies are retained, and the retry resumes at the failed file. An unusable
index retries its dependencies while keeping the existing search controls.
Escape closes the message, including when focus is on the retry button.
An empty ready field prompts for a query. A completed query with no matches shows the no-results message.
These messages use the active interface catalog:
search_start, search_loading, search_retry, search_no_results, search_unavailable, search_more and
search_results_count. The count label supports {shown} and {count}.
Color modes
The header button cycles through system → light → dark → system.
| Mode | Behavior |
|---|---|
system | Follows the device's prefers-color-scheme. |
light | Uses the light palette. |
dark | Uses the dark palette. |
A saved browser preference takes priority over the configured default. Appearance settings control the initial mode and button visibility. Brand and colors explains palette overrides.
Header separator
On the homepage, Blog and Downloads layouts, the line below the header appears after scrolling and disappears when you return to the top. Docs, Reader and ordinary content pages keep the line visible from the start. With JavaScript disabled, the line stays visible on every page.
Reduced motion
With prefers-reduced-motion: reduce, navigation animations and the drawer's
sliding transition are disabled.
Script availability
Search, the color-mode button and the announcement close button become active only after their initializer has installed its handlers. If JavaScript is disabled or one of those files cannot load, that action remains hidden. Search shows the localized unavailable message in place of its input. Other controls whose scripts loaded still work.
The inactive slots retain their dimensions, so arriving scripts do not move the header or announcement. Reading and ordinary links remain available. A failed search dependency after initialization still offers the separate Retry action described above.