Layout
Well
The panel's inverse: a field sunk into the surface around it rather than raised off it. Ground fill, the internal rule for an edge, and no block.
Rule 3 gives the language two steps up off the page. This is the step
down, and it exists because every consumer that needed one reached for a
second .axi-panel inside the first - two identical fills parted by a line,
which reads as one field with a stray rule through it rather than as two
objects.
Both of a well's departures from a panel follow from the same fact. Its edge is
--axi-rule and not --axi-ink-line, because ink only reads against a fill
lighter than itself and a well is at ground level - an ink outline round one is
a black line on a black field. And it carries no block, because a recess casts
nothing.
Its fill is --axi-well-fill, which defaults to the ground. That default is a
subtraction rather than a colour: a hole in an opaque panel really does show
the page, but an opaque page colour inside a translucent pane is a black
patch rather than a recess, so a glass theme restates it as a darkening at
alpha and lets the pane's own tint carry through.
Reach for a well wherever the content standing in it brings its own edges: a picker list beside a table, a column of cards, a trough a meter fills.
A well is the one form here used at two scales - a field the size of a page
column, and a recess the size of a single reading - and --sm is the second
one. At reading scale the panel radius is the wrong one; it is the radius
everything else that small already declines. The modifier sets that and nothing
else, because the two scales differ in their corner and in nothing else: a small
well still holds objects carrying their own padding, so --axi-well-pad is
still how you say anything about its inside.
The two scales, side by side
The page-column well takes the panel radius; the reading-scale one declines itPage scale
Reading scale
<div class="axi-row" style="--axi-row-gap: 12px; align-items: stretch">
<div class="axi-well" style="flex: 1">
<p class="axi-eyebrow">Page scale</p>
</div>
<div class="axi-well axi-well--sm" style="flex: 1">
<p class="axi-eyebrow">Reading scale</p>
</div>
</div>
A well inside a panel
The picker is sunk, the cards in it are raisedSections
Offense
Defense
<div class="axi-panel">
<p class="axi-eyebrow">Sections</p>
<div class="axi-well">
<div class="axi-stack" style="--axi-stack-gap: 8px">
<div class="axi-card"><p class="axi-card__title">Offense</p></div>
<div class="axi-card"><p class="axi-card__title">Defense</p></div>
</div>
</div>
</div>
Knobs
| Property | Sets | Fallback |
|---|---|---|
--axi-well-pad | the padding inside an .axi-well | 10px |
--axi-well-radius | an .axi-well's corner radius, for a well used at reading scale rather than page scale | var(--axi-radius) |