@cloud-ru/ds-carousel 1.0.0

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.
Files changed (63) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/LICENSE +201 -0
  3. package/README.md +124 -0
  4. package/dist/cjs/Carousel.d.ts +75 -0
  5. package/dist/cjs/Carousel.js +55 -0
  6. package/dist/cjs/constants.d.ts +12 -0
  7. package/dist/cjs/constants.js +15 -0
  8. package/dist/cjs/helperComponents/Control/Control.d.ts +7 -0
  9. package/dist/cjs/helperComponents/Control/Control.js +14 -0
  10. package/dist/cjs/helperComponents/Control/index.d.ts +1 -0
  11. package/dist/cjs/helperComponents/Control/index.js +17 -0
  12. package/dist/cjs/helperComponents/Control/styles.module.css +24 -0
  13. package/dist/cjs/helperComponents/ItemProvider/ItemProvider.d.ts +12 -0
  14. package/dist/cjs/helperComponents/ItemProvider/ItemProvider.js +130 -0
  15. package/dist/cjs/helperComponents/ItemProvider/index.d.ts +1 -0
  16. package/dist/cjs/helperComponents/ItemProvider/index.js +17 -0
  17. package/dist/cjs/helperComponents/ItemProvider/styles.module.css +44 -0
  18. package/dist/cjs/helperComponents/index.d.ts +2 -0
  19. package/dist/cjs/helperComponents/index.js +18 -0
  20. package/dist/cjs/index.d.ts +3 -0
  21. package/dist/cjs/index.js +19 -0
  22. package/dist/cjs/package.json +3 -0
  23. package/dist/cjs/style.css +100 -0
  24. package/dist/cjs/styles.module.css +32 -0
  25. package/dist/cjs/types.d.ts +2 -0
  26. package/dist/cjs/types.js +2 -0
  27. package/dist/esm/Carousel.d.ts +75 -0
  28. package/dist/esm/Carousel.js +49 -0
  29. package/dist/esm/constants.d.ts +12 -0
  30. package/dist/esm/constants.js +12 -0
  31. package/dist/esm/helperComponents/Control/Control.d.ts +7 -0
  32. package/dist/esm/helperComponents/Control/Control.js +8 -0
  33. package/dist/esm/helperComponents/Control/index.d.ts +1 -0
  34. package/dist/esm/helperComponents/Control/index.js +1 -0
  35. package/dist/esm/helperComponents/Control/styles.module.css +24 -0
  36. package/dist/esm/helperComponents/ItemProvider/ItemProvider.d.ts +12 -0
  37. package/dist/esm/helperComponents/ItemProvider/ItemProvider.js +124 -0
  38. package/dist/esm/helperComponents/ItemProvider/index.d.ts +1 -0
  39. package/dist/esm/helperComponents/ItemProvider/index.js +1 -0
  40. package/dist/esm/helperComponents/ItemProvider/styles.module.css +44 -0
  41. package/dist/esm/helperComponents/index.d.ts +2 -0
  42. package/dist/esm/helperComponents/index.js +2 -0
  43. package/dist/esm/index.d.ts +3 -0
  44. package/dist/esm/index.js +3 -0
  45. package/dist/esm/style.css +100 -0
  46. package/dist/esm/styles.module.css +32 -0
  47. package/dist/esm/types.d.ts +2 -0
  48. package/dist/esm/types.js +1 -0
  49. package/dist/tsconfig.cjs.tsbuildinfo +1 -0
  50. package/dist/tsconfig.esm.tsbuildinfo +1 -0
  51. package/package.json +46 -0
  52. package/src/Carousel.tsx +207 -0
  53. package/src/constants.ts +13 -0
  54. package/src/helperComponents/Control/Control.tsx +36 -0
  55. package/src/helperComponents/Control/index.ts +1 -0
  56. package/src/helperComponents/Control/styles.module.scss +27 -0
  57. package/src/helperComponents/ItemProvider/ItemProvider.tsx +220 -0
  58. package/src/helperComponents/ItemProvider/index.ts +1 -0
  59. package/src/helperComponents/ItemProvider/styles.module.scss +55 -0
  60. package/src/helperComponents/index.ts +2 -0
  61. package/src/index.ts +3 -0
  62. package/src/styles.module.scss +42 -0
  63. package/src/types.ts +3 -0
@@ -0,0 +1,130 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.ItemProvider = ItemProvider;
7
+ const jsx_runtime_1 = require("react/jsx-runtime");
8
+ const utils_1 = require("@cloud-ru/ds-utils");
9
+ const merge_refs_1 = __importDefault(require("merge-refs"));
10
+ const react_1 = require("react");
11
+ const constants_1 = require("../../constants");
12
+ const styles_module_scss_1 = __importDefault(require('./styles.module.css'));
13
+ function parseCssLength(value) {
14
+ const parsed = Number.parseFloat(value);
15
+ return Number.isFinite(parsed) ? parsed : 0;
16
+ }
17
+ const hideNonVisibleItems = (trackerElement) => {
18
+ trackerElement?.querySelectorAll(`[data-test-id=${constants_1.TEST_IDS.trackItem}]`).forEach(slide => {
19
+ slide.setAttribute('aria-hidden', '0');
20
+ slide.querySelectorAll('a, button, select, input, textarea, [tabindex="0"]').forEach(focusableElement => {
21
+ focusableElement.setAttribute('tabindex', '-5');
22
+ focusableElement.classList.add(styles_module_scss_1.default.hiddenItem);
23
+ });
24
+ });
25
+ };
26
+ const showVisibleItems = (trackerElement, slide, page, show) => {
27
+ trackerElement.querySelectorAll(`[data-test-id=${constants_1.TEST_IDS.trackItem}]`).forEach((item, i) => {
28
+ if (i >= page * slide && i < page * slide + Math.trunc(show)) {
29
+ item.removeAttribute('aria-hidden');
30
+ item.querySelectorAll('a, button, select, input, textarea, [tabindex="-5"]').forEach(focusableElement => {
31
+ focusableElement.setAttribute('tabindex', '0');
32
+ focusableElement.classList.remove(styles_module_scss_1.default.hiddenItem);
33
+ });
34
+ }
35
+ });
36
+ };
37
+ function ItemProvider({ children, showItems, scrollBy, slideCallback, transition, swipe, swipeActivateLength, page, gap, }) {
38
+ const containerRef = (0, react_1.useRef)(null);
39
+ const itemsTrackerRef = (0, react_1.useRef)(null);
40
+ const [computedValues, setComputedValues] = (0, react_1.useState)({
41
+ itemWidth: 0,
42
+ gap: 0,
43
+ });
44
+ const recalculateItemsSize = (0, react_1.useCallback)(() => {
45
+ const containerElement = containerRef.current;
46
+ const trackerElement = itemsTrackerRef.current;
47
+ if (!containerElement || !trackerElement) {
48
+ return;
49
+ }
50
+ const containerStyles = getComputedStyle(containerElement);
51
+ const trackerStyles = getComputedStyle(trackerElement);
52
+ const gapValue = gap ? parseCssLength(gap) : parseCssLength(trackerStyles.columnGap || trackerStyles.gap);
53
+ const paddingLeft = parseCssLength(containerStyles.paddingLeft);
54
+ const paddingRight = parseCssLength(containerStyles.paddingRight);
55
+ const gapsCount = Math.max(Math.trunc(showItems) - 1, 0);
56
+ const contentWidth = containerElement.getBoundingClientRect().width - paddingLeft - paddingRight;
57
+ const itemWidth = (contentWidth - gapsCount * gapValue) / showItems;
58
+ setComputedValues({ itemWidth, gap: gapValue });
59
+ }, [showItems, gap]);
60
+ (0, utils_1.useLayoutEffect)(() => {
61
+ const node = containerRef.current;
62
+ if (!node) {
63
+ return;
64
+ }
65
+ recalculateItemsSize();
66
+ const observer = new ResizeObserver((0, utils_1.debounce)(recalculateItemsSize, 100));
67
+ observer.observe(node);
68
+ return () => observer.disconnect();
69
+ }, [recalculateItemsSize]);
70
+ const transform = (0, react_1.useMemo)(() => Number(-(page * scrollBy * computedValues.itemWidth + computedValues.gap * page * scrollBy)), [computedValues.gap, computedValues.itemWidth, page, scrollBy]);
71
+ (0, react_1.useEffect)(() => {
72
+ const trackerElement = itemsTrackerRef.current;
73
+ if (!trackerElement) {
74
+ return;
75
+ }
76
+ hideNonVisibleItems(trackerElement);
77
+ showVisibleItems(trackerElement, scrollBy, page, showItems);
78
+ }, [page, scrollBy, showItems]);
79
+ const handleSlideClick = (0, react_1.useCallback)(e => {
80
+ if (showItems === 1) {
81
+ return;
82
+ }
83
+ const slideRect = e.currentTarget.getBoundingClientRect();
84
+ const containerRect = containerRef.current?.getBoundingClientRect();
85
+ const containerViewport = containerRect?.right ?? 0;
86
+ const slidePositionDelta = containerViewport - slideRect.right;
87
+ const minPos = Math.min(slidePositionDelta, slideRect.x);
88
+ if (minPos < 0) {
89
+ slideCallback(slidePositionDelta);
90
+ }
91
+ }, [showItems, slideCallback]);
92
+ const itemWidth = (0, react_1.useMemo)(() => {
93
+ if (computedValues.itemWidth > 0) {
94
+ return computedValues.itemWidth;
95
+ }
96
+ const fallbackWidth = Math.floor(100 / showItems);
97
+ return `${fallbackWidth}%`;
98
+ }, [computedValues.itemWidth, showItems]);
99
+ const [drag, setDrag] = (0, react_1.useState)({ drag: 0, pointers: true });
100
+ const handleSwiping = eventData => {
101
+ setDrag({ drag: eventData.deltaX, pointers: Math.abs(eventData.deltaX) < Number.MIN_SAFE_INTEGER });
102
+ };
103
+ const handleSwiped = eventData => {
104
+ if (Math.abs(drag.drag) < swipeActivateLength) {
105
+ return setDrag({ drag: 0, pointers: true });
106
+ }
107
+ slideCallback(eventData.dir === 'Left' ? -1 : 1);
108
+ setDrag({ drag: 0, pointers: true });
109
+ return;
110
+ };
111
+ const { ref, ...swipeProps } = (0, utils_1.useSwipeable)({
112
+ onSwiping: handleSwiping,
113
+ onSwiped: handleSwiped,
114
+ trackMouse: true,
115
+ enabled: swipe,
116
+ availableDirections: ['Left', 'Right'],
117
+ });
118
+ return ((0, jsx_runtime_1.jsx)("div", { ref: containerRef, className: styles_module_scss_1.default.itemProvider, "data-pointers": !drag.pointers || undefined, "data-swipe": swipe || undefined, "data-gap": gap, style: {
119
+ ...(gap ? { '--gap': gap } : {}),
120
+ }, children: (0, jsx_runtime_1.jsx)("div", { ...swipeProps, className: styles_module_scss_1.default.itemTracker, "data-test-id": constants_1.TEST_IDS.trackLine,
121
+ // Гасим нативный HTML5 drag контента слайдов (`<img>` и т.п.): при mouse-swipe
122
+ // браузер иначе стартует перетаскивание картинки-призрака вместо переключения
123
+ // слайда. `-webkit-user-drag` на родителе не наследуется дочерними img.
124
+ onDragStart: event => event.preventDefault(), style: {
125
+ transform: `translateX(${transform + drag.drag}px)`,
126
+ transition: `transform ${transition}s ease 0s`,
127
+ }, ref: (0, merge_refs_1.default)(ref, itemsTrackerRef), children: react_1.Children.toArray(children).map((item, i) => (
128
+ // eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions
129
+ (0, jsx_runtime_1.jsx)("div", { style: { width: itemWidth }, className: styles_module_scss_1.default.itemContainer, role: 'group', "data-test-id": constants_1.TEST_IDS.trackItem, onClick: handleSlideClick, children: item }, i))) }) }));
130
+ }
@@ -0,0 +1 @@
1
+ export * from './ItemProvider';
@@ -0,0 +1,17 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./ItemProvider"), exports);
@@ -0,0 +1,44 @@
1
+ .itemProvider{
2
+ --gap:var(--sn-primitive-dimension-16, 16px);
3
+ padding-top:var(--sn-carousel-anatomy-contentWrapper-content-paddingVertical, var(--sn-primitive-dimension-4, 4px));
4
+ padding-bottom:var(--sn-carousel-anatomy-contentWrapper-content-paddingVertical, var(--sn-primitive-dimension-4, 4px));
5
+ padding-left:var(--sn-carousel-anatomy-contentWrapper-content-paddingHorizontal, var(--sn-primitive-dimension-4, 4px));
6
+ padding-right:var(--sn-carousel-anatomy-contentWrapper-content-paddingHorizontal, var(--sn-primitive-dimension-4, 4px));
7
+ overflow-x:hidden;
8
+ display:flex;
9
+ flex:1 0 0;
10
+ align-items:flex-start;
11
+ box-sizing:border-box;
12
+ width:100%;
13
+ padding-inline:0;
14
+ }
15
+ .itemProvider[data-swipe]{
16
+ cursor:grab;
17
+ }
18
+ .itemProvider[data-swipe][data-pointers]{
19
+ cursor:grabbing;
20
+ -webkit-user-select:none;
21
+ -moz-user-select:none;
22
+ user-select:none;
23
+ -webkit-user-drag:none;
24
+ }
25
+
26
+ .itemContainer{
27
+ flex-shrink:0;
28
+ box-sizing:border-box;
29
+ padding:var(--sn-primitive-strokeWeight-strokeRegular, 1px);
30
+ }
31
+
32
+ .itemTracker{
33
+ display:flex;
34
+ gap:var(--gap, var(--sn-primitive-dimension-16, 16px));
35
+ box-sizing:border-box;
36
+ height:100%;
37
+ }
38
+
39
+ .hiddenItem{
40
+ pointer-events:none;
41
+ }
42
+ .hiddenItem *{
43
+ pointer-events:none;
44
+ }
@@ -0,0 +1,2 @@
1
+ export * from './Control';
2
+ export * from './ItemProvider';
@@ -0,0 +1,18 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./Control"), exports);
18
+ __exportStar(require("./ItemProvider"), exports);
@@ -0,0 +1,3 @@
1
+ export * from './Carousel';
2
+ export * from './constants';
3
+ export * from './types';
@@ -0,0 +1,19 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./Carousel"), exports);
18
+ __exportStar(require("./constants"), exports);
19
+ __exportStar(require("./types"), exports);
@@ -0,0 +1,3 @@
1
+ {
2
+ "type": "commonjs"
3
+ }
@@ -0,0 +1,100 @@
1
+ .control{
2
+ top:50%;
3
+ }
4
+ :global(.sn-mobile) .control{
5
+ display:none;
6
+ }
7
+ .control[data-direction=prev]{
8
+ padding-top:var(--sn-carousel-anatomy-contentWrapper-controlWrapper-controlBack-paddingTop, var(--sn-primitive-dimension-0, 0));
9
+ padding-bottom:var(--sn-carousel-anatomy-contentWrapper-controlWrapper-controlBack-paddingBottom, var(--sn-primitive-dimension-0, 0));
10
+ padding-left:var(--sn-carousel-anatomy-contentWrapper-controlWrapper-controlBack-paddingLeft, var(--sn-primitive-dimension-0, 0));
11
+ padding-right:var(--sn-carousel-anatomy-contentWrapper-controlWrapper-controlBack-paddingRight, var(--sn-primitive-dimension-0, 0));
12
+ position:absolute;
13
+ left:0;
14
+ transform:translateY(-50%) translateX(-50%);
15
+ }
16
+ .control[data-direction=next]{
17
+ padding-top:var(--sn-carousel-anatomy-contentWrapper-controlWrapper-controlForward-paddingTop, var(--sn-primitive-dimension-0, 0));
18
+ padding-bottom:var(--sn-carousel-anatomy-contentWrapper-controlWrapper-controlForward-paddingBottom, var(--sn-primitive-dimension-0, 0));
19
+ padding-left:var(--sn-carousel-anatomy-contentWrapper-controlWrapper-controlForward-paddingLeft, var(--sn-primitive-dimension-0, 0));
20
+ padding-right:var(--sn-carousel-anatomy-contentWrapper-controlWrapper-controlForward-paddingRight, var(--sn-primitive-dimension-0, 0));
21
+ position:absolute;
22
+ right:0;
23
+ transform:translateY(-50%) translateX(50%);
24
+ }
25
+ .itemProvider{
26
+ --gap:var(--sn-primitive-dimension-16, 16px);
27
+ padding-top:var(--sn-carousel-anatomy-contentWrapper-content-paddingVertical, var(--sn-primitive-dimension-4, 4px));
28
+ padding-bottom:var(--sn-carousel-anatomy-contentWrapper-content-paddingVertical, var(--sn-primitive-dimension-4, 4px));
29
+ padding-left:var(--sn-carousel-anatomy-contentWrapper-content-paddingHorizontal, var(--sn-primitive-dimension-4, 4px));
30
+ padding-right:var(--sn-carousel-anatomy-contentWrapper-content-paddingHorizontal, var(--sn-primitive-dimension-4, 4px));
31
+ overflow-x:hidden;
32
+ display:flex;
33
+ flex:1 0 0;
34
+ align-items:flex-start;
35
+ box-sizing:border-box;
36
+ width:100%;
37
+ padding-inline:0;
38
+ }
39
+ .itemProvider[data-swipe]{
40
+ cursor:grab;
41
+ }
42
+ .itemProvider[data-swipe][data-pointers]{
43
+ cursor:grabbing;
44
+ -webkit-user-select:none;
45
+ -moz-user-select:none;
46
+ user-select:none;
47
+ -webkit-user-drag:none;
48
+ }
49
+
50
+ .itemContainer{
51
+ flex-shrink:0;
52
+ box-sizing:border-box;
53
+ padding:var(--sn-primitive-strokeWeight-strokeRegular, 1px);
54
+ }
55
+
56
+ .itemTracker{
57
+ display:flex;
58
+ gap:var(--gap, var(--sn-primitive-dimension-16, 16px));
59
+ box-sizing:border-box;
60
+ height:100%;
61
+ }
62
+
63
+ .hiddenItem{
64
+ pointer-events:none;
65
+ }
66
+ .hiddenItem *{
67
+ pointer-events:none;
68
+ }
69
+ .control{
70
+ pointer-events:none;
71
+ opacity:0;
72
+ transition:opacity 0.2s;
73
+ }
74
+
75
+ .carousel{
76
+ position:relative;
77
+ display:flex;
78
+ flex-direction:column;
79
+ align-items:center;
80
+ box-sizing:border-box;
81
+ width:100%;
82
+ }
83
+ .carousel[data-controls-visibility=always] .control, .carousel[data-controls-visibility=hover]:hover .control{
84
+ pointer-events:auto;
85
+ opacity:1;
86
+ }
87
+
88
+ .pagination{
89
+ padding-top:var(--sn-carousel-anatomy-sliderWrapper-paddingTop, var(--sn-primitive-dimension-8, 8px));
90
+ display:flex;
91
+ justify-content:center;
92
+ box-sizing:border-box;
93
+ }
94
+
95
+ .carouselBase{
96
+ position:relative;
97
+ box-sizing:border-box;
98
+ width:100%;
99
+ outline:none;
100
+ }
@@ -0,0 +1,32 @@
1
+ .control{
2
+ pointer-events:none;
3
+ opacity:0;
4
+ transition:opacity 0.2s;
5
+ }
6
+
7
+ .carousel{
8
+ position:relative;
9
+ display:flex;
10
+ flex-direction:column;
11
+ align-items:center;
12
+ box-sizing:border-box;
13
+ width:100%;
14
+ }
15
+ .carousel[data-controls-visibility=always] .control, .carousel[data-controls-visibility=hover]:hover .control{
16
+ pointer-events:auto;
17
+ opacity:1;
18
+ }
19
+
20
+ .pagination{
21
+ padding-top:var(--sn-carousel-anatomy-sliderWrapper-paddingTop, var(--sn-primitive-dimension-8, 8px));
22
+ display:flex;
23
+ justify-content:center;
24
+ box-sizing:border-box;
25
+ }
26
+
27
+ .carouselBase{
28
+ position:relative;
29
+ box-sizing:border-box;
30
+ width:100%;
31
+ outline:none;
32
+ }
@@ -0,0 +1,2 @@
1
+ import { CONTROLS_VISIBILITY } from './constants';
2
+ export type ControlsVisibility = (typeof CONTROLS_VISIBILITY)[keyof typeof CONTROLS_VISIBILITY];
@@ -0,0 +1,2 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,75 @@
1
+ import { WithSupportProps } from '@cloud-ru/ds-utils';
2
+ import { ReactElement } from 'react';
3
+ import { ControlsVisibility } from './types.js';
4
+ export type CarouselProps = WithSupportProps<{
5
+ /**
6
+ * CSS - класснейм
7
+ */
8
+ className?: string;
9
+ /**
10
+ * Массив айтемов
11
+ */
12
+ children: ReactElement[];
13
+ /**
14
+ * Кол-во отображаемых единовременно айтемов
15
+ * @default 1
16
+ */
17
+ showItems?: number;
18
+ /**
19
+ * Сдвиг айтемов при смене 1 страницы
20
+ * @default Math.trunc(show)
21
+ */
22
+ scrollBy?: number;
23
+ /**
24
+ * Время переключения 1 страницы (в s)
25
+ * @default 0.4
26
+ */
27
+ transition?: number;
28
+ /**
29
+ * Переключение страниц свайпом
30
+ * @default true
31
+ */
32
+ swipe?: boolean;
33
+ /**
34
+ * Автоматическое переключение слайдов в секундах
35
+ */
36
+ autoSwipe?: number;
37
+ /**
38
+ * Минимальная длина в px для активации свайпа
39
+ * @default 48
40
+ */
41
+ swipeActivateLength?: number;
42
+ /**
43
+ * Использовать стрелки для переключения страниц
44
+ * @default true
45
+ */
46
+ arrows?: boolean;
47
+ /**
48
+ * Использовать пагинацию для переключения страниц
49
+ * @default true
50
+ */
51
+ pagination?: boolean;
52
+ /**
53
+ * Расстояние между айтемами
54
+ * @default var(--dimension-2m)
55
+ */
56
+ gap?: string;
57
+ /**
58
+ * Управление состоянием извне
59
+ */
60
+ state?: {
61
+ page: number;
62
+ onChange(page: number): void;
63
+ };
64
+ /**
65
+ * Цикличная прокрутка
66
+ * @default false
67
+ */
68
+ infiniteScroll?: boolean;
69
+ /**
70
+ * Управление видимостью стрелок: 'hover' — по ховеру, 'always' — всегда
71
+ * @default 'hover'
72
+ */
73
+ controlsVisibility?: ControlsVisibility;
74
+ }>;
75
+ export declare function Carousel({ children: items, showItems, scrollBy: scrollByProp, transition, swipe, arrows, pagination, className, gap, state, infiniteScroll, swipeActivateLength, autoSwipe, controlsVisibility, ...rest }: CarouselProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,49 @@
1
+ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { PaginationSlider } from '@cloud-ru/ds-pagination';
3
+ import { extractSupportProps, useUncontrolledProp } from '@cloud-ru/ds-utils';
4
+ import cn from 'classnames';
5
+ import { useCallback, useEffect, useMemo, useRef } from 'react';
6
+ import { CONTROLS_VISIBILITY, TEST_IDS } from './constants.js';
7
+ import { Control, ItemProvider } from './helperComponents/index.js';
8
+ import styles from './styles.module.css';
9
+ export function Carousel({ children: items, showItems = 1, scrollBy: scrollByProp, transition = 0.4, swipe = true, arrows = true, pagination = true, className, gap, state, infiniteScroll = false, swipeActivateLength = 48, autoSwipe, controlsVisibility = CONTROLS_VISIBILITY.hover, ...rest }) {
10
+ const timerRef = useRef(null);
11
+ const scrollBy = useMemo(() => scrollByProp ?? Math.trunc(showItems), [showItems, scrollByProp]);
12
+ const [page, setPage] = useUncontrolledProp(state?.page, state?.page ?? 0, newPage => {
13
+ const result = typeof newPage === 'function' ? newPage(page) : newPage;
14
+ state?.onChange(result);
15
+ });
16
+ const total = useMemo(() => {
17
+ if (items.length <= showItems) {
18
+ return 1;
19
+ }
20
+ return 1 + Math.ceil((items.length - showItems) / scrollBy);
21
+ }, [items.length, scrollBy, showItems]);
22
+ const onLeftArrowClick = useCallback(() => {
23
+ setPage((page) => (infiniteScroll ? (total + page - 1) % total : Math.max(0, page - 1)));
24
+ }, [infiniteScroll, setPage, total]);
25
+ const onRightArrowClick = useCallback(() => {
26
+ setPage((page) => (infiniteScroll ? (page + 1) % total : Math.min(total - 1, page + 1)));
27
+ }, [infiniteScroll, setPage, total]);
28
+ const slideCallback = useCallback((direction) => {
29
+ if (direction < 0) {
30
+ onRightArrowClick();
31
+ return;
32
+ }
33
+ onLeftArrowClick();
34
+ }, [onLeftArrowClick, onRightArrowClick]);
35
+ useEffect(() => {
36
+ if (!autoSwipe || !infiniteScroll) {
37
+ return;
38
+ }
39
+ timerRef.current = setTimeout(() => onRightArrowClick(), autoSwipe * 1000);
40
+ return () => {
41
+ if (timerRef.current) {
42
+ clearTimeout(timerRef.current);
43
+ }
44
+ };
45
+ }, [autoSwipe, infiniteScroll, onRightArrowClick]);
46
+ return (_jsxs("div", { className: cn(styles.carousel, className), "data-controls-visibility": controlsVisibility, ...extractSupportProps(rest), children: [_jsxs("div", { className: styles.carouselBase, children: [_jsx(ItemProvider, { showItems: showItems, scrollBy: scrollBy, swipe: swipe, transition: transition, slideCallback: slideCallback, page: page, gap: gap, swipeActivateLength: swipeActivateLength, children: items }), arrows && (_jsxs(_Fragment, { children: [(infiniteScroll || page > 0) && (_jsx(Control, { onClick: onLeftArrowClick, direction: 'prev', "data-test-id": TEST_IDS.arrowPrev, className: styles.control })), (infiniteScroll || page + 1 < total) && (_jsx(Control, { onClick: onRightArrowClick, direction: 'next', "data-test-id": TEST_IDS.arrowNext, className: styles.control }))] }))] }), pagination && (_jsx("div", { className: styles.pagination, children: _jsx(PaginationSlider, { "data-test-id": TEST_IDS.pagination, size: 'xs', page: page + 1, onChange: (page) => {
47
+ setPage(page - 1);
48
+ }, total: total }) }))] }));
49
+ }
@@ -0,0 +1,12 @@
1
+ export declare const TEST_IDS: {
2
+ readonly root: "carousel";
3
+ readonly arrowNext: "carousel__arrow-next";
4
+ readonly arrowPrev: "carousel__arrow-prev";
5
+ readonly pagination: "carousel__pagination";
6
+ readonly trackLine: "carousel__track-line";
7
+ readonly trackItem: "carousel__track-item";
8
+ };
9
+ export declare const CONTROLS_VISIBILITY: {
10
+ readonly hover: "hover";
11
+ readonly always: "always";
12
+ };
@@ -0,0 +1,12 @@
1
+ export const TEST_IDS = {
2
+ root: 'carousel',
3
+ arrowNext: 'carousel__arrow-next',
4
+ arrowPrev: 'carousel__arrow-prev',
5
+ pagination: 'carousel__pagination',
6
+ trackLine: 'carousel__track-line',
7
+ trackItem: 'carousel__track-item',
8
+ };
9
+ export const CONTROLS_VISIBILITY = {
10
+ hover: 'hover',
11
+ always: 'always',
12
+ };
@@ -0,0 +1,7 @@
1
+ export declare const Control: import("react").ForwardRefExoticComponent<{
2
+ 'data-test-id'?: string;
3
+ } & import("react").AriaAttributes & {
4
+ onClick?(): void;
5
+ direction: "prev" | "next";
6
+ className?: string;
7
+ } & import("react").RefAttributes<HTMLButtonElement>>;
@@ -0,0 +1,8 @@
1
+ import { jsx as _jsx } from "react/jsx-runtime";
2
+ import { Button } from '@cloud-ru/ds-button';
3
+ import { ChevronLeftSVG, ChevronRightSVG } from '@cloud-ru/ds-icons/interface/system';
4
+ import { extractSupportProps } from '@cloud-ru/ds-utils';
5
+ import cn from 'classnames';
6
+ import { forwardRef } from 'react';
7
+ import styles from './styles.module.css';
8
+ export const Control = forwardRef(({ onClick, direction, className, ...rest }, ref) => (_jsx(Button, { innerRef: ref, className: cn(styles.control, className), onClick: onClick, size: 'm', view: 'elevated', appearance: 'neutral', type: 'button', "data-direction": direction, icon: direction === 'prev' ? (_jsx(ChevronLeftSVG, { size: 24, className: styles.icon })) : (_jsx(ChevronRightSVG, { size: 24, className: styles.icon })), ...extractSupportProps(rest) })));
@@ -0,0 +1 @@
1
+ export * from './Control.js';
@@ -0,0 +1 @@
1
+ export * from './Control.js';
@@ -0,0 +1,24 @@
1
+ .control{
2
+ top:50%;
3
+ }
4
+ :global(.sn-mobile) .control{
5
+ display:none;
6
+ }
7
+ .control[data-direction=prev]{
8
+ padding-top:var(--sn-carousel-anatomy-contentWrapper-controlWrapper-controlBack-paddingTop, var(--sn-primitive-dimension-0, 0));
9
+ padding-bottom:var(--sn-carousel-anatomy-contentWrapper-controlWrapper-controlBack-paddingBottom, var(--sn-primitive-dimension-0, 0));
10
+ padding-left:var(--sn-carousel-anatomy-contentWrapper-controlWrapper-controlBack-paddingLeft, var(--sn-primitive-dimension-0, 0));
11
+ padding-right:var(--sn-carousel-anatomy-contentWrapper-controlWrapper-controlBack-paddingRight, var(--sn-primitive-dimension-0, 0));
12
+ position:absolute;
13
+ left:0;
14
+ transform:translateY(-50%) translateX(-50%);
15
+ }
16
+ .control[data-direction=next]{
17
+ padding-top:var(--sn-carousel-anatomy-contentWrapper-controlWrapper-controlForward-paddingTop, var(--sn-primitive-dimension-0, 0));
18
+ padding-bottom:var(--sn-carousel-anatomy-contentWrapper-controlWrapper-controlForward-paddingBottom, var(--sn-primitive-dimension-0, 0));
19
+ padding-left:var(--sn-carousel-anatomy-contentWrapper-controlWrapper-controlForward-paddingLeft, var(--sn-primitive-dimension-0, 0));
20
+ padding-right:var(--sn-carousel-anatomy-contentWrapper-controlWrapper-controlForward-paddingRight, var(--sn-primitive-dimension-0, 0));
21
+ position:absolute;
22
+ right:0;
23
+ transform:translateY(-50%) translateX(50%);
24
+ }
@@ -0,0 +1,12 @@
1
+ import { PropsWithChildren } from 'react';
2
+ export type ItemProviderProps = PropsWithChildren<{
3
+ showItems: number;
4
+ scrollBy: number;
5
+ slideCallback(direction: number): void;
6
+ transition: number;
7
+ swipe: boolean;
8
+ swipeActivateLength: number;
9
+ page: number;
10
+ gap?: string;
11
+ }>;
12
+ export declare function ItemProvider({ children, showItems, scrollBy, slideCallback, transition, swipe, swipeActivateLength, page, gap, }: ItemProviderProps): import("react/jsx-runtime").JSX.Element;