<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 подействует только на индикатор с цветом по умолчанию.

Предложения по улучшению
Если вы нашли ошибку или хотите доработать статью, создайте запрос на GitHub.