Vai al contenuto principale

Panoramica

Loader mostra un punto animato all’interno di una piccola capsula con bordo. Utilizzalo mentre è in corso un’operazione e la percentuale è sconosciuta. Per il progresso numerico, usa ProgressBar.

Utilizzo

Inserisci il testo di stato visibile accanto al loader in un wrapper. Il loader è un indicatore visivo a dimensione fissa e non accetta elementi figli. L’applicazione gestisce lo stato di caricamento. Mantieni montato il contenitore dello stato affinché gli aggiornamenti del testo possano essere annunciati. Per impostazione predefinita, il loader non assegna alcuna etichetta né alcun ruolo di area live. Usa aria-hidden="true" quando il testo circostante o un pulsante fornisce già un feedback di caricamento.

Composizione ed etichettatura native

Le proprietà native, className, style e ref sono destinate al div contenitore. render accetta un elemento o un callback tramite la composizione di Base UI. Gli stili sovrascrivono i colori predefiniti. LoaderProps viene esportato dalla famiglia di feedback. Per un indicatore autonomo, fornisci un ruolo di stato esplicito e un nome accessibile. Il punto animato rimane decorativo.
Usa invece aria-labelledby quando il testo visibile denomina lo stato. Mantieni montato un proprietario dell’area live quando deve annunciare testo variabile. L’applicazione determina quando viene visualizzato il feedback e cosa comunica.

Colore

Passa un colore della palette del tema per impostare sia il bordo sia il punto. Senza un colore, il loader eredita il colore di un pulsante circostante quando disponibile; altrimenti utilizza il colore del testo terziario. Per un’azione di pulsante, preferisci lo stato di caricamento di Button, che mantiene il feedback all’interno del controllo.

Props

Booleanish
Hide a decorative loader when another element supplies loading feedback.
string
Accessible name for a labeled loader status.
string
ID of text that names the loader status.
string
CSS class merged with the loader container class.
"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"
Theme color for the animated dot and border. When omitted, inherits the button color if available, otherwise the tertiary text color.
Ref<HTMLDivElement>
Ref to the container div, or the element supplied through render.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, {}>
Element or render callback composed through Base UI useRender.
AriaRole
Supply status to expose loading feedback as a live region. No role is assigned by default.
CSSProperties
Native styles merged with the loader color defaults. Explicit styles win.