<kbq-progress-bar> - компонент, отображающий индикатор выполнения.
Элемент <kbq-progress-bar> может быть использован отдельно для создания горизонтальной линии прогресса с темой Koobiq.
<kbq-progress-bar></kbq-progress-bar>Степень заполнения линии, определяющая прогресс, зависит от свойства value. Его значение может меняться в диапазоне [0, 100]. Значение по умолчанию: 0
Значения вне диапазона обрезаются, а в режиме indeterminate свойство не используется.
Такое значение заполнит 30% линии:
<kbq-progress-bar [value]="30"></kbq-progress-bar>Возможные значения: 'determinate', 'indeterminate'. Значение по умолчанию: 'determinate'.
Для отображения неопределенного по завершенности прогресса:
<kbq-progress-bar [mode]="'indeterminate'"></kbq-progress-bar>Для отображения определенного по завершенности прогресса:
<kbq-progress-bar [mode]="'determinate'" [value]="30"></kbq-progress-bar>Возможные значения: 'theme', 'contrast', 'contrast-fade', 'error'. Значение по умолчанию: 'theme'. Задает цвет заполненной части линии. Цвет дорожки одинаков для всех вариантов.
<kbq-progress-bar [color]="'theme'" [value]="30"></kbq-progress-bar>
<kbq-progress-bar [color]="'contrast'" [value]="30"></kbq-progress-bar>
<kbq-progress-bar [color]="'contrast-fade'" [value]="30"></kbq-progress-bar>
<kbq-progress-bar [color]="'error'" [value]="30"></kbq-progress-bar>Пустое значение, null или undefined возвращают компонент к цвету 'theme', поэтому индикатор
остается видимым, даже если цвет еще не вычислен.
Доступное имя индикатора. Значение по умолчанию: берется из конфигурации локали a11y.
Задавайте его, если у индикатора нет собственной видимой подписи:
<kbq-progress-bar [value]="30" aria-label="Загрузка архива"></kbq-progress-bar>kbq-progress-bar-text отображает подпись над линией, а kbq-progress-bar-caption — подпись под ней.
Обе необязательны, их можно использовать вместе.
<kbq-progress-bar [value]="30">
<div kbq-progress-bar-text>Загрузка архива</div>
<div kbq-progress-bar-caption>3 из 12 файлов</div>
</kbq-progress-bar>Спроецированный текст также задает доступное имя индикатора, а нижняя подпись — его описание: компонент
связывает их через aria-labelledby и aria-describedby. Переданный aria-label имеет приоритет над
спроецированным текстом.
Корневой элемент имеет role="progressbar". В режиме determinate он сообщает aria-valuenow
(обрезанное значение value) вместе с aria-valuemin="0" и aria-valuemax="100"; в режиме
indeterminate все три атрибута отсутствуют — именно так выражается неизвестная продолжительность.
Цвет <kbq-progress-bar> меняется свойством color. По умолчанию используется цвет theme.
Отдельный индикатор можно перекрасить и через две CSS-переменные, из которых он берет цвет:
--kbq-progress-bar-fill для заполненной части и --kbq-progress-bar-track для дорожки.
Переопределять нужно именно их, а не токены --kbq-progress-bar-bar-*, значения которых они
принимают по умолчанию. Цвета contrast, contrast-fade и error объявляют
--kbq-progress-bar-fill заново, поэтому переопределение --kbq-progress-bar-bar-foreground
подействует только на индикатор с цветом по умолчанию.