Resumen
Loader muestra un punto animado dentro de una pequeña cápsula con borde. Úsalo mientras una operación está en curso y se desconoce el porcentaje. Para el progreso numérico, usa ProgressBar.
”Uso”
aria-hidden="true" cuando el texto circundante o un botón ya proporciona comentarios sobre la carga.
Composición y etiquetado nativos
Las props nativas,className, style y ref se aplican al div contenedor. render acepta un elemento o una devolución de llamada mediante la composición de Base UI. Los estilos anulan los colores predeterminados. LoaderProps se exporta desde la familia de comentarios.
Para un indicador independiente, proporciona una función de estado explícita y un nombre accesible. El punto animado sigue siendo decorativo.
aria-labelledby en su lugar cuando el texto visible nombra el estado. Mantén montado un propietario de región dinámica cuando necesite anunciar texto cambiante. La aplicación controla cuándo aparecen los comentarios y qué dicen.
Color
Pasa un color de la paleta del tema para establecer tanto el borde como el punto. Sin un color, el cargador hereda el color de un botón circundante cuando está disponible; de lo contrario, usa el color de texto terciario. Para una acción de botón, prefiere el estado de carga de Button, que mantiene la respuesta dentro del control.”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.