Panel

A panel is a column of chrome standing on the paper: a header pinned to its top, a body that takes the room between, and a footer pinned to its bottom. An application’s list beside its detail, an inspector, a drawer’s contents are panels.

A photograph inspector

The header and footer stay in place while metadata fills the body.

A compact review panel

A stable title and action frame a short queue.

<ds-panel>  <ds-row slot="header" fill>    <ds-text literal strong>Projects</ds-text>    <ds-button primary>New</ds-button>  </ds-row>  <ds-list>…</ds-list>  <ds-row slot="footer"><ds-text tone="muted" literal>12 projects</ds-text></ds-row></ds-panel>

Content goes to the default slot; slot="header" and slot="footer" pin to the top and bottom. Give the panel its height from the page’s layout (a page’s columns, fill). The body takes the room between them and may shrink to nothing, and when its content is taller it scrolls while the header and footer stay put. Rows inside it are one square high as everywhere; the panel adds no box or shadow of its own.

SlotWhat it holds
headerA row at the top: the panel’s title and its actions.
DefaultThe body, which scrolls.
footerA row at the bottom: a count, closing actions.
PartWhat it is
header, body, footerThe three areas, for a product’s own styles.

The header and the footer keep their own height, and the body lays its content in a column. An empty header or footer takes no room. The panel draws on --ds-paper in the text colour and sets the shared type, so what stands in it needs no type of its own.

A panel has no role. Where it is a region of its own, say so around it: put it in an aside or section, with a name. The reading order is the header, the body and the footer.

The slots and parts above are its whole interface: it has no attributes, events or tokens of its own. On Apple platforms it is DS1Panel.

Select panel in Sync 1’s components export.

Page · Row · List