Перейти к основному содержанию

Обзор

Loader отображает анимированную точку внутри небольшой капсулы с рамкой. Используйте его, когда выполняется операция и процент выполнения неизвестен. Для числового прогресса используйте ProgressBar.

Использование

Разместите видимый текст состояния рядом с индикатором загрузки в обертке. Индикатор загрузки — это визуальный индикатор фиксированного размера, который не принимает дочерние элементы. Приложение управляет состоянием загрузки. Не размонтируйте контейнер статуса, чтобы можно было объявлять обновления текста. По умолчанию индикатору загрузки не назначаются ни метка, ни роль живой области. Используйте aria-hidden="true", когда окружающий текст или кнопка уже сообщают о загрузке.

Нативная композиция и именование

Нативные пропсы, className, style и ref применяются к контейнеру div. render принимает элемент или функцию обратного вызова через композицию Base UI. Стили переопределяют цвета по умолчанию. LoaderProps экспортируется из семейства feedback. Для автономного индикатора укажите явную роль состояния и доступное имя. Анимированная точка остаётся декоративной.
Используйте вместо этого aria-labelledby, когда видимый текст называет состояние. Оставляйте владельца живой области смонтированным, когда ему нужно объявлять об изменении текста. Приложение определяет, когда отображается обратная связь и что она сообщает.

Цвет

Передайте цвет из палитры темы, чтобы задать и рамку, и точку. Без цвета загрузчик наследует цвет окружающей кнопки, если он доступен; в противном случае используется третичный цвет текста. Для действия кнопки предпочтительно использовать состояние загрузки Button, при котором индикатор остаётся внутри элемента управления.

Свойства

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.