Vai al contenuto principale

Panoramica

Status combina un punto colorato, un’etichetta di testo e un indicatore di caricamento facoltativo. Usalo per gli stati del workflow o dei record. Usa Tag per una categoria senza l’indicatore di stato.

Utilizzo

color è obbligatorio e utilizza la palette del tema. L’etichetta comunica il significato indipendentemente dal colore. L’elemento predefinito è sempre un span, anche quando viene fornito un gestore di clic nativo; weight="medium" enfatizza il relativo testo.

Caricamento e annunci

loading mostra un caricatore decorativo dopo l’etichetta e imposta per impostazione predefinita aria-busy su true. Fornisci esplicitamente aria-busy quando il workflow circostante gestisce quello stato. Il componente non aggiunge una regione live né modifica automaticamente il proprio testo. Mantieni montato un contenitore role="status" quando gli aggiornamenti devono essere annunciati alla tecnologia assistiva e fornisci un’etichetta che descriva lo stato corrente.

Modifica uno stato

Componi un proprietario interattivo tramite render. Inserisci il relativo gestore di clic, gli attributi nativi, ref e lo stato disabilitato su quel proprietario. Un pulsante reale fornisce l’attivazione tramite focus, puntatore, Invio e Barra spaziatrice. Status.loading mostra l’avanzamento; passa disabled al pulsante quando l’azione deve attendere. Per la navigazione, esegui il rendering di un link con la relativa destinazione, ad esempio <a href="/records" />. I proprietari nativi mantengono l’aspetto di Status. I nodi figli mantengono il testo, le traduzioni e i link intenzionali gestiti dal chiamante.

Props

I tipi e i valori predefiniti vengono generati dai tipi di componenti pubblici. Sono accettati anche gli attributi nativi e i gestori di eventi.
"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"
obbligatorio
Theme color used for the status background, text, and loader.
boolean
predefinito:"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"
predefinito:"regular"
Font weight of the label.