Skip to main content

Search Command Palette

Location​

Rendered in wp_footer by the meilisearch-id86 plugin (Search_UI::render_palette()). Triggered by the header search icon on every page; the desktop front page hides the trigger so the hero search is the primary entry point there.

Trigger​

The header search icon is a menu bar item registered by the plugin (it removes GeneratePress' own search modal trigger first):

add_action('wp', [$this, 'register_header_trigger'], 20);
// inside: remove_action('generate_menu_bar_items', 'generate_do_search_modal_trigger');
// remove_action('wp_footer', 'generate_do_search_modal');
// add_action('generate_menu_bar_items', [$this, 'render_header_trigger']);

It renders:

<span class="menu-bar-item id86-search-trigger">
<a href="#id86-fuse-palette" role="button" aria-label="Search documentation"
aria-haspopup="dialog" aria-controls="id86-fuse-palette" data-id86-fuse-open>
<!-- SVG search icon -->
</a>
</span>

The trigger renders on every page. On the desktop front page its #site-navigation copy is hidden by CSS (body.home #site-navigation .id86-search-trigger) so the hero search stays the sole entry point. On tablet/mobile the trigger shows in the top bar (#mobile-menu-control-wrapper) on every page, including the front page, styled as a pill matching the dark-mode toggle.

Overlay​

The palette is a fixed-position overlay:

<div class="id86-fuse-palette" id="id86-fuse-palette" aria-hidden="true">
<div class="id86-fuse-palette-overlay" data-id86-fuse-close></div>
<div class="id86-fuse-palette-panel" role="dialog" aria-modal="true"
aria-label="Search documentation">
<div class="fusejs-search-container">
<span class="fusejs-search-icon">&gt;</span>
<input type="text" id="id86-fuse-palette-input" class="fusejs-input"
placeholder="Search docs... (e.g. :docker)"
autocomplete="off">
<kbd class="fusejs-kbd">Esc</kbd>
</div>
<div class="fusejs-results" id="id86-fuse-palette-results" style="display:none;"></div>
</div>
</div>

Behavior​

  • Opening: Adds is-open class, sets aria-hidden="false", focuses the input.
  • Closing: Click overlay, press Escape, or click close trigger. Removes is-open class, clears input.
  • Body scroll is prevented via body.id86-fuse-palette-open { overflow: hidden; }.
  • Results render identically to the hero search (same renderer in meilisearch-id86/assets/js/id86-meilisearch-global.js).

CSS​

ClassRole
.id86-fuse-paletteFixed full-screen overlay container, hidden by default
.id86-fuse-palette.is-openShows the palette
.id86-fuse-palette-overlaySemi-transparent dark backdrop
.id86-fuse-palette-panelCentered dialog, max 760px width
.id86-fuse-palette-panel .fusejs-resultsResults list with max-height limit
.id86-fuse-palette-panel .fusejs-catCategory chip styling

Comparison​

The palette shares the same search renderer logic as the hero input. Both use the same setupSearch() function from id86-meilisearch-global.js. The only differences are:

  • Different DOM containers.
  • Palette has an Escape → close behavior; hero hides results on Escape.
  • Palette restores focus management; hero does not.