Reference · Components and layout
Empty state
This is a spec: descriptive guidance, not a checkable rule. It carries no forbidden and instead pair, and no jig check detector applies to it directly.
The spec
Four distinct cases. Collapsing them into one generic "No data" is the failure (E-30).
| Case | Message | Action |
|---|---|---|
| Never had data | What this collection is for | The creation action, prominent |
| Filtered to nothing | Which filters are active | Clear filters |
| Error loading | That it failed, and whether it is transient | Retry |
| No permission | That access is restricted, not that it is empty | Who to ask |
Rules
- Never show "no results" when the cause was an error. The user will search for something that was there all along.
- The filtered-empty state repeats the active query so the user can see the typo.
- Empty is not a full-page illustration in
productoroperator. It is a sentence and a button inside the container that would have held the data. - Empty state occupies roughly the space the filled state would, or the layout jumps when data arrives.
Mode variance: illustration is permitted in product empty states only, and never in operator (01-modes.md).
- Kind
- Spec
- Section
- Components and layout