@snack-uikit/progress-bar 0.1.10 → 0.1.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +10 -0
- package/README.md +63 -16
- package/package.json +3 -3
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,16 @@
|
|
|
3
3
|
All notable changes to this project will be documented in this file.
|
|
4
4
|
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
|
|
5
5
|
|
|
6
|
+
## <small>0.1.11 (2026-01-19)</small>
|
|
7
|
+
|
|
8
|
+
* chore(FF-6693): migrate tests from TestCafe to Playwright ([f32aff8](https://github.com/cloud-ru-tech/snack-uikit/commit/f32aff8))
|
|
9
|
+
* chore(FF-6693): tune test configs ([d194f4d](https://github.com/cloud-ru-tech/snack-uikit/commit/d194f4d))
|
|
10
|
+
* docs(FF-7788): readme update ([e3142b8](https://github.com/cloud-ru-tech/snack-uikit/commit/e3142b8))
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
|
|
6
16
|
## 0.1.10 (2025-09-01)
|
|
7
17
|
|
|
8
18
|
### Only dependencies have been changed
|
package/README.md
CHANGED
|
@@ -6,22 +6,69 @@
|
|
|
6
6
|
|
|
7
7
|
[Changelog](./CHANGELOG.md)
|
|
8
8
|
|
|
9
|
-
##
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
9
|
+
## Description
|
|
10
|
+
|
|
11
|
+
- Пакет `@snack-uikit/progress-bar` предоставляет компоненты для визуализации прогресса выполнения операций: статический индикатор прогресса (`ProgressBar`) и автоматический индикатор загрузки страницы (`ProgressBarPage`).
|
|
12
|
+
- Компоненты помогают пользователю понимать состояние длительных операций и время ожидания, поддерживают различные визуальные варианты оформления и размеры.
|
|
13
|
+
- `ProgressBar` используется для отображения известного процента выполнения операции, а `ProgressBarPage` — для автоматической индикации загрузки страницы или перехода между страницами с плавной анимацией прогресса.
|
|
14
|
+
|
|
15
|
+
## ProgressBar
|
|
16
|
+
|
|
17
|
+
### Description
|
|
18
|
+
|
|
19
|
+
- `ProgressBar` — компонент для отображения статического индикатора прогресса с заданным процентом выполнения от 0 до 100.
|
|
20
|
+
- Поддерживает **два размера** (`xs`, `s`) для адаптации под разные контексты использования.
|
|
21
|
+
- Позволяет выбрать **внешний вид** через проп `appearance` (neutral, primary, red, orange, yellow, green, blue, violet, pink) для визуального соответствия статусу операции или цветовой схеме интерфейса.
|
|
22
|
+
- Автоматически ограничивает значение прогресса диапазоном от 0 до 100, обеспечивая корректное отображение даже при некорректных входных данных.
|
|
23
|
+
- Figma: [`Progress Bar`](https://www.figma.com/file/jtGxAPvFJOMir7V0eQFukN/Snack-UI-Kit-1.1.0?node-id=2%3A2&mode=design).
|
|
24
|
+
|
|
25
|
+
### Example
|
|
26
|
+
|
|
27
|
+
```tsx
|
|
28
|
+
import { ProgressBar } from '@snack-uikit/progress-bar';
|
|
29
|
+
|
|
30
|
+
function Example() {
|
|
31
|
+
return (
|
|
32
|
+
<ProgressBar
|
|
33
|
+
progress={75}
|
|
34
|
+
size="s"
|
|
35
|
+
appearance="primary"
|
|
36
|
+
/>
|
|
37
|
+
);
|
|
38
|
+
}
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
## ProgressBarPage
|
|
42
|
+
|
|
43
|
+
### Description
|
|
44
|
+
|
|
45
|
+
- `ProgressBarPage` — компонент для автоматической индикации загрузки страницы или перехода между страницами, отображаемый в верхней части экрана.
|
|
46
|
+
- Использует библиотеку `@tanem/react-nprogress` для **автоматического управления прогрессом** с плавной анимацией и постепенным увеличением значения.
|
|
47
|
+
- Поддерживает **настройку скорости анимации** (`animationDuration`) и **интервала между обновлениями прогресса** (`incrementDuration`) для тонкой настройки поведения.
|
|
48
|
+
- Позволяет задать **минимальное значение прогресса** (`minimum` от 0 до 1), чтобы индикатор не начинался с нуля и сразу показывал видимый прогресс.
|
|
49
|
+
- Автоматически скрывается после завершения загрузки (`isFinished`), не требуя ручного управления видимостью.
|
|
50
|
+
- Figma: [`Progress Bar Page`](https://www.figma.com/file/jtGxAPvFJOMir7V0eQFukN/Snack-UI-Kit-1.1.0?node-id=2%3A2&mode=design).
|
|
51
|
+
|
|
52
|
+
### Example
|
|
53
|
+
|
|
54
|
+
```tsx
|
|
55
|
+
import { ProgressBarPage } from '@snack-uikit/progress-bar';
|
|
56
|
+
|
|
57
|
+
function Example() {
|
|
58
|
+
const [isLoading, setIsLoading] = React.useState(false);
|
|
59
|
+
|
|
60
|
+
return (
|
|
61
|
+
<>
|
|
62
|
+
<ProgressBarPage
|
|
63
|
+
inProgress={isLoading}
|
|
64
|
+
animationDuration={200}
|
|
65
|
+
incrementDuration={800}
|
|
66
|
+
minimum={0.08}
|
|
67
|
+
/>
|
|
68
|
+
{/* Остальной контент страницы */}
|
|
69
|
+
</>
|
|
70
|
+
);
|
|
71
|
+
}
|
|
25
72
|
```
|
|
26
73
|
|
|
27
74
|
[//]: DOCUMENTATION_SECTION_START
|
package/package.json
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
"access": "public"
|
|
5
5
|
},
|
|
6
6
|
"title": "Progress Bar",
|
|
7
|
-
"version": "0.1.
|
|
7
|
+
"version": "0.1.11",
|
|
8
8
|
"sideEffects": [
|
|
9
9
|
"*.css",
|
|
10
10
|
"*.woff",
|
|
@@ -36,9 +36,9 @@
|
|
|
36
36
|
"license": "Apache-2.0",
|
|
37
37
|
"scripts": {},
|
|
38
38
|
"dependencies": {
|
|
39
|
-
"@snack-uikit/utils": "4.0.
|
|
39
|
+
"@snack-uikit/utils": "4.0.1",
|
|
40
40
|
"@tanem/react-nprogress": "5.0.35",
|
|
41
41
|
"classnames": "2.5.1"
|
|
42
42
|
},
|
|
43
|
-
"gitHead": "
|
|
43
|
+
"gitHead": "84371bbf91915f650a852df849cd71d416c5b7b2"
|
|
44
44
|
}
|