Обзор
Loader отображает анимированную точку внутри небольшой капсулы с рамкой. Используйте его, когда выполняется операция и процент выполнения неизвестен. Для числового прогресса используйте ProgressBar.
Использование
aria-hidden="true", когда окружающий текст или кнопка уже сообщают о загрузке.
Нативная композиция и именование
Нативные пропсы,className, style и ref применяются к контейнеру div. render принимает элемент или функцию обратного вызова через композицию Base UI. Стили переопределяют цвета по умолчанию. LoaderProps экспортируется из семейства feedback.
Для автономного индикатора укажите явную роль состояния и доступное имя. Анимированная точка остаётся декоративной.
aria-labelledby, когда видимый текст называет состояние. Оставляйте владельца живой области смонтированным, когда ему нужно объявлять об изменении текста. Приложение определяет, когда отображается обратная связь и что она сообщает.
Цвет
Передайте цвет из палитры темы, чтобы задать и рамку, и точку. Без цвета загрузчик наследует цвет окружающей кнопки, если он доступен; в противном случае используется третичный цвет текста. Для действия кнопки предпочтительно использовать состояние загрузки Button, при котором индикатор остаётся внутри элемента управления.Свойства
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.