Status combines a colored dot, a text label, and an optional loader. Use it for workflow or record states. Use Tag for a category without the status indicator.
Usage
color is required and uses the theme palette. The label communicates the meaning independently of the color. The default element is always a span, including when a native click handler is supplied; weight="medium" emphasizes its text.
Loading and announcements
loading shows a decorative loader after the label and defaults aria-busy to true. Supply aria-busy explicitly when the surrounding workflow owns that state. The component does not add a live region or change its text automatically. Keep a role="status" container mounted when updates should be announced to assistive technology, and provide a label that describes the current state.
Change a state
render. Put its click handler, native attributes, ref, and disabled state on that owner. A real button supplies focus, pointer, Enter, and Space activation. Status.loading displays progress; pass disabled to the button when the action should wait. For navigation, render a link with its destination, such as <a href="/records" />. Native owners retain Status’s appearance. Node children preserve caller-owned text, translations, and intentional links.
Props
Types and defaults are generated from the public component types. Native attributes and event handlers are also accepted."amber" | "blue" | "bronze" | "brown" | "crimson" | "cyan" | "gold" | "grass" | "gray" | "green" | "iris" | "jade" | "lime" | "mint" | "orange" | "pink" | "plum" | "purple" | "red" | "ruby" | "sky" | "tomato" | "turquoise" | "violet" | "yellow"
required
Theme color used for the status background, text, and loader.
boolean
default:"false"
Shows a decorative loader after the label and defaults aria-busy to true. The caller owns announcements and disabled interaction.
MouseEventHandler<HTMLSpanElement>
Native click handler. Does not change the default span or add keyboard activation.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, StatusState>
Replaces the default span. Compose a button or link to provide explicit interaction semantics.
"medium" | "regular"
default:"regular"
Font weight of the label.