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
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.
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
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.