Обзор
ProgressBar обеспечивает горизонтальное представление для прогресса. Он сохраняет полный контракт корневого элемента, включая нативные атрибуты, refs, композицию рендеринга, форматирование, пользовательские диапазоны и неопределенный прогресс. Укажите для него aria-label, идентифицирующий операцию.
Использование
Управление состоянием и диапазоны
value является обязательным и управляется приложением. Режим defaultValue отсутствует. Компонент не запускает запрос и не увеличивает прогресс самостоятельно. Передайте null, если ход выполнения неизвестен. Неконечные значения также остаются неопределёнными.
Значение min по умолчанию равно 0, а max — 100. Конечные значения ограничиваются диапазоном для семантического значения и нормализованного заполнения. Значение 70 в диапазоне от 20 до 120 заполняет половину полосы и сообщает 50%, при этом aria-valuenow остаётся равным 70.
Используйте aria-valuetext, getAriaValueText, locale и format, как описано в Progress. Используйте составные части Progress, когда меткам и значениям требуется собственное видимое расположение.
Используйте Toast для уведомлений с обратным отсчетом до закрытия и приостановкой при наведении.
Внешний вид и композиция
size выбирает полосу шириной 6px или 8px. barColor и backgroundColor принимают цвета CSS, включая переменные темы. withBorderRadius скругляет дорожку и индикатор. withMinimumFillWidth сохраняет небольшое декоративное заполнение только между минимумом и завершением. Этот минимум составляет не более 12px и половины ширины полосы, поэтому узкая полоса всё равно отличает незавершённый прогресс от завершения. Он не заполняет пустую полосу и не изменяет семантические значения.
Нативные атрибуты, className, style и ref нацелены на корневой элемент. className и style могут получать состояние прогресса. render может заменять корневой элемент, сохраняя его семантику. Неопределённый прогресс имеет собственный вид без указания числового процента. Настройки уменьшения движения отключают переходы заполнения и движение неопределённого прогресса.
Комбинируйте части Progress для пользовательских макетов или анимации функций. Сроки функций, анимация появления, блики, пружинная анимация и обратные вызовы завершения относятся к композиции приложения.
Миграция
ЗаменитеariaLabel на нативный aria-label. Свойства withGrowIn, withGlint, withSpringFill и onGrowInComplete удалены. Реализуйте их внешний вид, сроки и обратные вызовы завершения в композиции приложения, используя части Progress. Нативный onAnimationEnd остаётся доступным в корневом элементе.
Свойства
string
Accessible name identifying the measured operation.
string
ID of the visible label that names the operation.
string
Human-readable progress value overriding the default formatted value.
string
по умолчанию:"none"
CSS background color of the track.
string
CSS color of the filled bar. Defaults to the primary text color.
ReactNode
Additional Progress parts or supporting content inside the root.
string | ((state: ProgressRootState) => string | undefined)
Class applied to the progress root, or a callback receiving its status.
NumberFormatOptions
Intl.NumberFormat options for the clamped numeric value. The default displays the normalized percentage.
((formattedValue: string, value: number | null) => string)
Receives the formatted value and raw value, including null, and returns an accessible value description.
LocalesArgument
Locale or locale list used to format the value. Defaults to the runtime locale.
number
по умолчанию:"100"
Inclusive maximum. Defaults to 100.
number
по умолчанию:"0"
Inclusive minimum. Defaults to 0.
Ref<HTMLDivElement>
Ref to the root div, or the element composed through render.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, ProgressRootState>
Composes the root with an element or render callback. Forward the supplied props and ref to retain progress semantics.
"md" | "sm"
по умолчанию:"md"
Bar height: sm (6px) or md (8px).
CSSProperties | ((state: ProgressRootState) => CSSProperties | undefined)
Inline styles applied to the progress root, or a callback receiving its status.
number | null
обязательно
Controlled value in the min/max range. Use null for indeterminate progress.
boolean
по умолчанию:"false"
Rounds the track and indicator corners.
boolean
по умолчанию:"true"
Applies a cosmetic minimum of up to 12px, capped at half the track width, only above the minimum and below completion.