blocks/status-tray
Type Aliases
Section titled “Type Aliases”StatusTrayItem
Section titled “StatusTrayItem”StatusTrayItem =
Readonly<{id:string;label:ReactNode;count?:number;tone?:StatusTone;glyph?:StatusGlyph;motion?:StatusMotion;accessibleLabel?:string;title?:ReactNode;actions?:ReactNode;content:ReactNode;disabled?:boolean;after?:ReactNode; }>
One footer readout and the small tray it opens. Semantic data only: the chip’s
finish, the tray’s material and the seam between them come from theme tokens
(--caps-status-tray-*), never from a prop.
StatusTrayProps
Section titled “StatusTrayProps”StatusTrayProps =
Omit<HTMLAttributes<HTMLDivElement>>,"title"> > &object
Controlled selection and structural slots for a row of footer trays.
Type Declaration
Section titled “Type Declaration”items: readonly
StatusTrayItem[]
Readouts and their tray contents in display order.
openId
Section titled “openId”openId:
string|null
Which tray is open. The host owns this state.
onOpenChange
Section titled “onOpenChange”onOpenChange: (
id) =>void
Requests a selection change or dismissal.
Parameters
Section titled “Parameters”string | null
Returns
Section titled “Returns”void
leading?
Section titled “leading?”
optionalleading?:ReactNode
Leading readouts that never open a tray (connection state, etc.).
trailing?
Section titled “trailing?”
optionaltrailing?:ReactNode
Trailing controls after the chips (Send, Expand, …).
placement?
Section titled “placement?”
optionalplacement?:"housing"|"screen"
Structural seat. housing sits on the plastic below a screen; screen sits
inside a Display as flat, screen-native text (the wiki’s screen material rule).
The look of each seat is theme-owned.
align?
Section titled “align?”
optionalalign?:"start"|"end"
Which edge the tray aligns to.
Functions
Section titled “Functions”StatusTray()
Section titled “StatusTray()”StatusTray(
__namedParameters):Element
A footer row of readout chips; one opens its tray above the row at a time.
Parameters
Section titled “Parameters”__namedParameters
Section titled “__namedParameters”Returns
Section titled “Returns”Element
StatusTrayList()
Section titled “StatusTrayList()”StatusTrayList(
__namedParameters):Element
Readout rows on the tray’s screen, with each row’s keys on the bezel beside it. Several lists in one tray share that one screen.
Parameters
Section titled “Parameters”__namedParameters
Section titled “__namedParameters”HTMLAttributes<HTMLDivElement>
Returns
Section titled “Returns”Element
StatusTrayRow()
Section titled “StatusTrayRow()”StatusTrayRow(
__namedParameters):Element
One readout row and its associated actions on the bezel.
Parameters
Section titled “Parameters”__namedParameters
Section titled “__namedParameters”Omit<HTMLAttributes<HTMLDivElement>, "children"> & object
Returns
Section titled “Returns”Element
StatusTrayNote()
Section titled “StatusTrayNote()”StatusTrayNote(
__namedParameters):Element
A quiet sentence on the tray’s screen for an empty or unavailable feed.
Parameters
Section titled “Parameters”__namedParameters
Section titled “__namedParameters”children
Section titled “children”ReactNode
title?
Section titled “title?”string
Returns
Section titled “Returns”Element