Global search

Provide keyboard-accessible navigation search from the shared shell.

Start with your first page. Shared ui* providers are registered by createAdmin. Examples belong inside a route template, not the root HTML document. The page and its optional controller load through Atrium’s lazy route registry.

Minimal example

<button type="button" class="btn btn-secondary" @click="$dispatch('dialog-open', { id: 'global-search' })">Search pages</button>

Settings and behavior

• The shell includes the search dialog once.
• Ctrl+K or Cmd+K opens search.
• Only grouped routes allowed by current presentation capabilities appear.
• uiSearch exposes query, results, index, move(delta), choose(route), and reset.
• Arrow keys select results, Enter navigates, and Escape dismisses the overlay.

Integration notes

This is local navigation search. Add a consumer-owned service for backend record search. Keep authorization on the server even when navigation links are hidden.

Working reference

See the shared search template. Return to the component index.

Author

Laurent Declercq l.declercq@agon-innovation.ch

License

Unless otherwise stated all source code is licensed under LGPL 2.1 and has the following copyright:

© 2026, Agon Partners Innovation AG, All rights reserved.

The design material and the “Agon Ātrium” trademark is the property of their authors. Reuse of them without prior consent of their respective authors is strictly prohibited.

Version

Version: 20260921