StatusDot

Render an inline Astryx status indicator.

Astryx renders a fixed 8px dot and surfaces label as aria-label, so the label never appears as visible text. Pair the dot with a Text widget in a horizontal Stack when the status needs a visible caption.

Astryx Props

JSON-safe StatusDot props forwarded to Astryx.

Supported Astryx props include:

variant ('success' or 'warning' or 'error' or 'accent' or 'neutral'; required): Semantic color variant.
label (string; required): Accessible label surfaced via aria-label.
isPulsing (boolean): Enables a pulse animation; respects prefers-reduced-motion: reduce.
tooltip (string): Tooltip text shown on hover to explain the status meaning.
xstyle (StyleXStyles): StyleX styles for layout customization (margins, positioning, sizing). Must be a stylex.create() value, not an inline style object like style={{}}.

Props typed as React nodes, render functions, event handlers, refs, or StyleX styles are documented for Astryx parity but cannot be serialized directly from Python unless the wrapper adapts them.

See Astryx component docs: https://astryx.atmeta.com/components/StatusDot.

Functions

constructor__init__(label, *, variant='neutral', pulsing=None, tooltip=None, **props) -> None

paramlabelstr

Accessible label describing the status. Screen readers announce it; it is not rendered as visible text.

paramvariantstr

= 'neutral'

Astryx visual variant.

parampulsingbool | None

= None

Whether to animate the status dot.

paramtooltipstr | None

= None

Hover explanation for the status.

parampropsAny

= {}

Returns

None

Functions

On this page