Shells
Toast
A stack of transient messages in the corner of the page. The CSS ships the region and the message; appearing and leaving on a timer are the consumer’s, because this language ships no script.
Insert a .axi-toast into the region and remove it when it is done.
There is no timer here and no animation: that is the same contract .axi-menu
publishes for its open state, not a new kind of promise.
The region is pointer-events: none and each toast takes its events back;
the flex gaps between stacked toasts would otherwise eat clicks aimed at the
corner beneath them.
role="status" aria-live="polite" belongs on .axi-toasts itself, not on
each toast - that is the half of this contract the CSS cannot enforce. A live
region announces content inserted into it; a node with no live semantics
produces no announcement at all, and a toast is typically removed again
before a screen reader user could even navigate to find it. Skip the
attribute and every toast this markup ships is invisible to anyone not
looking at the screen.
A toast is control weight, not panel: four panels stacked over the page is a
wall. Its fill is --axi-surface-float all the same - weight and opacity are
different questions, and a toast is the one floating thing the reader did not
open and cannot hold still, so whatever is under it is mid-scroll by
definition.
The region lives at layer 60 - above the drawer, below the tooltip. See the layer stack in the rules.
A stack of three
Shown in flow rather than fixed to the corner, so the demo can hold it<div class="axi-toasts" role="status" aria-live="polite" style="position: static">
<div class="axi-toast"><i class="axi-toast__dot" aria-hidden="true"></i> Link copied to clipboard</div>
<div class="axi-toast axi-toast--ok"><i class="axi-toast__dot" aria-hidden="true"></i> Upload finished — 3 logs parsed</div>
<div class="axi-toast axi-toast--danger"><i class="axi-toast__dot" aria-hidden="true"></i> Could not reach the server</div>
</div>
One with a name on it
<div class="axi-toasts" role="status" aria-live="polite" style="position: static">
<div class="axi-toast axi-toast--warn">
<span class="axi-avatar" style="--axi-avatar-size: 24px">KJ</span>
Kay left the squad
</div>
</div>