Empty and error states

Tell users what happened and provide a useful next action.

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

<div class="empty-state">
  <span x-icon="'box'"></span>
  <h2>No resources yet</h2>
  <p>Create a resource to begin.</p>
  <button type="button" class="btn btn-primary" @click="create">Create resource</button>
</div>

Settings and behavior

• Supply the create method in your page provider.
• Distinguish an empty collection, an empty filtered result, and a failed request.
• A retry action should rerun the failed operation without losing the user’s input.

Integration notes

The shared data table already provides loading, empty, and retryable error states. For backend errors, display an appropriate user message without exposing tokens or private server diagnostics.

Working reference

See the production example. 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