@cloud-ru/ds-bottom-sheet 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.
- package/CHANGELOG.md +8 -0
- package/LICENSE +201 -0
- package/README.md +997 -0
- package/dist/cjs/components/BottomSheet/BottomSheet.d.ts +3 -0
- package/dist/cjs/components/BottomSheet/BottomSheet.js +39 -0
- package/dist/cjs/components/BottomSheet/index.d.ts +1 -0
- package/dist/cjs/components/BottomSheet/index.js +17 -0
- package/dist/cjs/components/BottomSheet/styles.module.css +27 -0
- package/dist/cjs/components/BottomSheetCustom/BottomSheetCustom.d.ts +19 -0
- package/dist/cjs/components/BottomSheetCustom/BottomSheetCustom.js +121 -0
- package/dist/cjs/components/BottomSheetCustom/constants.d.ts +30 -0
- package/dist/cjs/components/BottomSheetCustom/constants.js +33 -0
- package/dist/cjs/components/BottomSheetCustom/hooks/index.d.ts +3 -0
- package/dist/cjs/components/BottomSheetCustom/hooks/index.js +19 -0
- package/dist/cjs/components/BottomSheetCustom/hooks/useDragEngine.d.ts +44 -0
- package/dist/cjs/components/BottomSheetCustom/hooks/useDragEngine.js +312 -0
- package/dist/cjs/components/BottomSheetCustom/hooks/useFocusTrap.d.ts +7 -0
- package/dist/cjs/components/BottomSheetCustom/hooks/useFocusTrap.js +77 -0
- package/dist/cjs/components/BottomSheetCustom/hooks/useTransitionPhase.d.ts +22 -0
- package/dist/cjs/components/BottomSheetCustom/hooks/useTransitionPhase.js +51 -0
- package/dist/cjs/components/BottomSheetCustom/index.d.ts +1 -0
- package/dist/cjs/components/BottomSheetCustom/index.js +17 -0
- package/dist/cjs/components/BottomSheetCustom/styles.module.css +98 -0
- package/dist/cjs/components/BottomSheetCustom/utils/scroll.d.ts +17 -0
- package/dist/cjs/components/BottomSheetCustom/utils/scroll.js +39 -0
- package/dist/cjs/components/BottomSheetCustom/utils/snapPoints.d.ts +38 -0
- package/dist/cjs/components/BottomSheetCustom/utils/snapPoints.js +102 -0
- package/dist/cjs/components/index.d.ts +2 -0
- package/dist/cjs/components/index.js +18 -0
- package/dist/cjs/constants.d.ts +11 -0
- package/dist/cjs/constants.js +19 -0
- package/dist/cjs/helperComponents/Handle/Handle.d.ts +2 -0
- package/dist/cjs/helperComponents/Handle/Handle.js +13 -0
- package/dist/cjs/helperComponents/Handle/index.d.ts +1 -0
- package/dist/cjs/helperComponents/Handle/index.js +17 -0
- package/dist/cjs/helperComponents/Handle/styles.module.css +18 -0
- package/dist/cjs/helperComponents/index.d.ts +1 -0
- package/dist/cjs/helperComponents/index.js +17 -0
- package/dist/cjs/index.d.ts +9 -0
- package/dist/cjs/index.js +39 -0
- package/dist/cjs/package.json +3 -0
- package/dist/cjs/style.css +143 -0
- package/dist/cjs/types.d.ts +172 -0
- package/dist/cjs/types.js +2 -0
- package/dist/esm/components/BottomSheet/BottomSheet.d.ts +3 -0
- package/dist/esm/components/BottomSheet/BottomSheet.js +33 -0
- package/dist/esm/components/BottomSheet/index.d.ts +1 -0
- package/dist/esm/components/BottomSheet/index.js +1 -0
- package/dist/esm/components/BottomSheet/styles.module.css +27 -0
- package/dist/esm/components/BottomSheetCustom/BottomSheetCustom.d.ts +19 -0
- package/dist/esm/components/BottomSheetCustom/BottomSheetCustom.js +115 -0
- package/dist/esm/components/BottomSheetCustom/constants.d.ts +30 -0
- package/dist/esm/components/BottomSheetCustom/constants.js +30 -0
- package/dist/esm/components/BottomSheetCustom/hooks/index.d.ts +3 -0
- package/dist/esm/components/BottomSheetCustom/hooks/index.js +3 -0
- package/dist/esm/components/BottomSheetCustom/hooks/useDragEngine.d.ts +44 -0
- package/dist/esm/components/BottomSheetCustom/hooks/useDragEngine.js +309 -0
- package/dist/esm/components/BottomSheetCustom/hooks/useFocusTrap.d.ts +7 -0
- package/dist/esm/components/BottomSheetCustom/hooks/useFocusTrap.js +74 -0
- package/dist/esm/components/BottomSheetCustom/hooks/useTransitionPhase.d.ts +22 -0
- package/dist/esm/components/BottomSheetCustom/hooks/useTransitionPhase.js +48 -0
- package/dist/esm/components/BottomSheetCustom/index.d.ts +1 -0
- package/dist/esm/components/BottomSheetCustom/index.js +1 -0
- package/dist/esm/components/BottomSheetCustom/styles.module.css +98 -0
- package/dist/esm/components/BottomSheetCustom/utils/scroll.d.ts +17 -0
- package/dist/esm/components/BottomSheetCustom/utils/scroll.js +34 -0
- package/dist/esm/components/BottomSheetCustom/utils/snapPoints.d.ts +38 -0
- package/dist/esm/components/BottomSheetCustom/utils/snapPoints.js +96 -0
- package/dist/esm/components/index.d.ts +2 -0
- package/dist/esm/components/index.js +2 -0
- package/dist/esm/constants.d.ts +11 -0
- package/dist/esm/constants.js +13 -0
- package/dist/esm/helperComponents/Handle/Handle.d.ts +2 -0
- package/dist/esm/helperComponents/Handle/Handle.js +7 -0
- package/dist/esm/helperComponents/Handle/index.d.ts +1 -0
- package/dist/esm/helperComponents/Handle/index.js +1 -0
- package/dist/esm/helperComponents/Handle/styles.module.css +18 -0
- package/dist/esm/helperComponents/index.d.ts +1 -0
- package/dist/esm/helperComponents/index.js +1 -0
- package/dist/esm/index.d.ts +9 -0
- package/dist/esm/index.js +13 -0
- package/dist/esm/style.css +143 -0
- package/dist/esm/types.d.ts +172 -0
- package/dist/esm/types.js +1 -0
- package/dist/tsconfig.cjs.tsbuildinfo +1 -0
- package/dist/tsconfig.esm.tsbuildinfo +1 -0
- package/package.json +47 -0
- package/src/components/BottomSheet/BottomSheet.tsx +116 -0
- package/src/components/BottomSheet/index.ts +1 -0
- package/src/components/BottomSheet/styles.module.scss +38 -0
- package/src/components/BottomSheetCustom/BottomSheetCustom.tsx +221 -0
- package/src/components/BottomSheetCustom/constants.ts +33 -0
- package/src/components/BottomSheetCustom/hooks/index.ts +3 -0
- package/src/components/BottomSheetCustom/hooks/useDragEngine.ts +373 -0
- package/src/components/BottomSheetCustom/hooks/useFocusTrap.ts +80 -0
- package/src/components/BottomSheetCustom/hooks/useTransitionPhase.ts +52 -0
- package/src/components/BottomSheetCustom/index.ts +1 -0
- package/src/components/BottomSheetCustom/styles.module.scss +146 -0
- package/src/components/BottomSheetCustom/utils/scroll.ts +39 -0
- package/src/components/BottomSheetCustom/utils/snapPoints.ts +109 -0
- package/src/components/index.ts +2 -0
- package/src/constants.ts +14 -0
- package/src/helperComponents/Handle/Handle.tsx +11 -0
- package/src/helperComponents/Handle/index.ts +1 -0
- package/src/helperComponents/Handle/styles.module.scss +26 -0
- package/src/helperComponents/index.ts +1 -0
- package/src/index.ts +30 -0
- package/src/types.ts +185 -0
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Ищет ближайшего вертикально-прокручиваемого предка `start`, поднимаясь по DOM до `boundary`
|
|
3
|
+
* включительно. Прокручиваемым считается элемент с `overflow-y: auto | scroll` и реальным
|
|
4
|
+
* переполнением (`scrollHeight > clientHeight`).
|
|
5
|
+
*
|
|
6
|
+
* Используется drag-движком для решения «скроллить контент или тянуть sheet»: если жест начат
|
|
7
|
+
* внутри прокручиваемой области, которая ещё не упёрлась в нужный край, отдаём жест нативному
|
|
8
|
+
* скроллу, а не drag'у (vaul-подобное поведение «drag только от верха скролла»).
|
|
9
|
+
*
|
|
10
|
+
* @param start — узел-цель события (`event.target`).
|
|
11
|
+
* @param boundary — корневой узел sheet'а (`.content`); выше него не поднимаемся.
|
|
12
|
+
*/
|
|
13
|
+
export function findScrollableAncestor(start: EventTarget | null, boundary: HTMLElement | null): HTMLElement | null {
|
|
14
|
+
let node = start instanceof HTMLElement ? start : null;
|
|
15
|
+
|
|
16
|
+
while (node) {
|
|
17
|
+
const overflowY = window.getComputedStyle(node).overflowY;
|
|
18
|
+
const isScrollable = overflowY === 'auto' || overflowY === 'scroll';
|
|
19
|
+
|
|
20
|
+
if (isScrollable && node.scrollHeight > node.clientHeight) {
|
|
21
|
+
return node;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
if (node === boundary) break;
|
|
25
|
+
node = node.parentElement;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
return null;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/** Доехал ли прокручиваемый элемент до самого верха. */
|
|
32
|
+
export function isScrolledToTop(el: HTMLElement): boolean {
|
|
33
|
+
return el.scrollTop <= 0;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
/** Доехал ли прокручиваемый элемент до самого низа (с допуском в 1px на subpixel-округление). */
|
|
37
|
+
export function isScrolledToBottom(el: HTMLElement): boolean {
|
|
38
|
+
return el.scrollHeight - el.clientHeight - el.scrollTop <= 1;
|
|
39
|
+
}
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
import { SnapPoint } from '../../../types';
|
|
2
|
+
|
|
3
|
+
/** Формат `SnapPoint`-строки, который понимает рантайм (число с опц. дробной частью + юнит). */
|
|
4
|
+
const SNAP_STRING_RE = /^(\d+(?:\.\d+)?)(px|%|dvh|svh|lvh)$/;
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Валиден ли `SnapPoint` для рантайма (формат + диапазон). TS-тип `${number}` шире регэкспа
|
|
8
|
+
* (принимает `'-5px'`, `'1e3px'`, `'.5px'`), а `number` — любое число; этот предикат отсеивает то,
|
|
9
|
+
* на чём `resolveSnapPointPx` бросил бы. Используется движком, чтобы деградировать к single-snap
|
|
10
|
+
* вместо необработанного throw в pointer-обработчике.
|
|
11
|
+
*/
|
|
12
|
+
export function isValidSnapPoint(snap: SnapPoint): boolean {
|
|
13
|
+
if (snap === 'fit-content') return true;
|
|
14
|
+
if (typeof snap === 'number') return snap > 0 && snap <= 1;
|
|
15
|
+
const match = SNAP_STRING_RE.exec(snap);
|
|
16
|
+
return match !== null && Number(match[1]) > 0;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* Разрешает `SnapPoint` в высоту в пикселях для текущего viewport'а.
|
|
21
|
+
*
|
|
22
|
+
* - `'fit-content'` → `contentHeightPx` (высота контента — измеряется потребителем через ref).
|
|
23
|
+
* - `number` (0..1] → доля от `viewportHeightPx` (`0.5` → 50% viewport'а).
|
|
24
|
+
* - `'<n>px'` → литеральные `n` пикселей.
|
|
25
|
+
* - `'<n>%'` → `n%` от viewport'а.
|
|
26
|
+
* - `'<n>dvh'` / `'<n>svh'` / `'<n>lvh'` → `n%` от viewport'а (в JS-расчётах все эти юниты
|
|
27
|
+
* эквивалентны `vh` — реальное dynamic-поведение применяется CSS'ом, а в JS-снапах
|
|
28
|
+
* используется текущий `window.innerHeight`).
|
|
29
|
+
*
|
|
30
|
+
* Бросает на невалидной строке, чтобы расхождение spec'а ловилось рано.
|
|
31
|
+
*/
|
|
32
|
+
export function resolveSnapPointPx(snap: SnapPoint, viewportHeightPx: number, contentHeightPx: number): number {
|
|
33
|
+
if (snap === 'fit-content') return contentHeightPx;
|
|
34
|
+
if (typeof snap === 'number') {
|
|
35
|
+
if (snap <= 0 || snap > 1) {
|
|
36
|
+
throw new Error(`Invalid SnapPoint fraction: ${snap} (expected (0, 1])`);
|
|
37
|
+
}
|
|
38
|
+
return Math.round(snap * viewportHeightPx);
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
const match = SNAP_STRING_RE.exec(snap);
|
|
42
|
+
if (!match) {
|
|
43
|
+
throw new Error(`Invalid SnapPoint: ${snap}`);
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
const value = Number(match[1]);
|
|
47
|
+
const unit = match[2];
|
|
48
|
+
if (value <= 0) {
|
|
49
|
+
throw new Error(`Invalid SnapPoint: ${snap} (must be positive)`);
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
if (unit === 'px') return Math.round(value);
|
|
53
|
+
return Math.round((value / 100) * viewportHeightPx);
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* Порог скорости (px/ms) быстрого флик-жеста. Единый источник для обоих сценариев:
|
|
58
|
+
* multi-snap-навигации (`findTargetSnap`) и single-snap-закрытия (`useDragEngine`).
|
|
59
|
+
*/
|
|
60
|
+
export const VELOCITY_THRESHOLD_PX_PER_MS = 0.5;
|
|
61
|
+
const CLOSE_THRESHOLD_RATIO_DEFAULT = 0.3;
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* Определяет целевой snap-индекс по текущей высоте sheet'а и скорости drag'а.
|
|
65
|
+
*
|
|
66
|
+
* - `velocityPxPerMs < 0` — drag вверх (раскрытие): уходим на следующий snap, либо последний.
|
|
67
|
+
* - `velocityPxPerMs > 0` — drag вниз (схлопывание): уходим на предыдущий snap, либо ниже первого → закрытие.
|
|
68
|
+
* - `|velocity| < threshold` — скорость мала → выбираем ближайший snap по расстоянию.
|
|
69
|
+
* - Если текущая высота ниже `closeThresholdRatio * snapHeightsPx[0]` — возвращает `-1` (закрытие).
|
|
70
|
+
*
|
|
71
|
+
* @returns индекс snap'а ∈ `[0, snapHeightsPx.length)` либо `-1` (sheet хочет закрыться).
|
|
72
|
+
*/
|
|
73
|
+
export function findTargetSnap(
|
|
74
|
+
snapHeightsPx: number[],
|
|
75
|
+
currentHeightPx: number,
|
|
76
|
+
velocityPxPerMs: number,
|
|
77
|
+
closeThresholdRatio = CLOSE_THRESHOLD_RATIO_DEFAULT,
|
|
78
|
+
): number {
|
|
79
|
+
if (snapHeightsPx.length === 0) return -1;
|
|
80
|
+
|
|
81
|
+
const firstSnap = snapHeightsPx[0];
|
|
82
|
+
if (currentHeightPx < firstSnap * (1 - closeThresholdRatio)) {
|
|
83
|
+
return -1;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
if (velocityPxPerMs < -VELOCITY_THRESHOLD_PX_PER_MS) {
|
|
87
|
+
const nextIdx = snapHeightsPx.findIndex(h => h > currentHeightPx);
|
|
88
|
+
return nextIdx === -1 ? snapHeightsPx.length - 1 : nextIdx;
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
if (velocityPxPerMs > VELOCITY_THRESHOLD_PX_PER_MS) {
|
|
92
|
+
let prevIdx = -1;
|
|
93
|
+
for (let i = snapHeightsPx.length - 1; i >= 0; i--) {
|
|
94
|
+
if (snapHeightsPx[i] < currentHeightPx) {
|
|
95
|
+
prevIdx = i;
|
|
96
|
+
break;
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
return prevIdx === -1 ? -1 : prevIdx;
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
let bestIdx = 0;
|
|
103
|
+
for (let i = 1; i < snapHeightsPx.length; i++) {
|
|
104
|
+
if (Math.abs(snapHeightsPx[i] - currentHeightPx) < Math.abs(snapHeightsPx[bestIdx] - currentHeightPx)) {
|
|
105
|
+
bestIdx = i;
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
return bestIdx;
|
|
109
|
+
}
|
package/src/constants.ts
ADDED
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
// Общий overlay-chrome (media / footer-ориентация / слот-`data-test-id`) вынесен в `@cloud-ru/ds-popup-private`.
|
|
2
|
+
// Реэкспортируем под теми же именами — внешний контракт `@cloud-ru/ds-bottom-sheet` не меняется.
|
|
3
|
+
export { FOOTER_ACTIONS_ORIENTATION, MEDIA_KIND, TEST_IDS } from '@cloud-ru/ds-popup-private';
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* Data-атрибут escape-hatch: drag-to-dismiss bottom-sheet'а **не** начинается, если жест стартовал на
|
|
7
|
+
* элементе с этим атрибутом или его предке. Вешай его на собственный draggable-контент внутри sheet'а
|
|
8
|
+
* (слайдеры, color-picker, карты, canvas), иначе нативный drag контрола одновременно потащит sheet к
|
|
9
|
+
* закрытию. Аналог `touch-action`/`useSwipeable`-блокировки из легаси.
|
|
10
|
+
*
|
|
11
|
+
* @example
|
|
12
|
+
* <BottomSheet content={<div {...{ [NO_DRAG_ATTRIBUTE]: '' }}><ColorPicker … /></div>} />
|
|
13
|
+
*/
|
|
14
|
+
export const NO_DRAG_ATTRIBUTE = 'data-bottom-sheet-no-drag';
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { TEST_IDS } from '../../constants';
|
|
2
|
+
import styles from './styles.module.scss';
|
|
3
|
+
|
|
4
|
+
/** Drag-индикатор сверху bottom-sheet'а (32×4px). Декоративный — `aria-hidden`. */
|
|
5
|
+
export function Handle() {
|
|
6
|
+
return (
|
|
7
|
+
<div className={styles.wrapper} aria-hidden>
|
|
8
|
+
<span className={styles.handle} data-test-id={TEST_IDS.handle} />
|
|
9
|
+
</div>
|
|
10
|
+
);
|
|
11
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export * from './Handle';
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
@use '@cloud-ru/ds-figma-variables/build/scss/styles/styles.module' as base;
|
|
2
|
+
@use '@cloud-ru/ds-figma-variables/build/scss/components/bottomSheet.module' as bottomSheet;
|
|
3
|
+
|
|
4
|
+
.wrapper {
|
|
5
|
+
// Drag-зона: браузер не панорамирует/не делает pull-to-refresh здесь, жестом владеет pointer-движок.
|
|
6
|
+
touch-action: none;
|
|
7
|
+
|
|
8
|
+
display: flex;
|
|
9
|
+
flex-shrink: 0;
|
|
10
|
+
align-items: center;
|
|
11
|
+
justify-content: center;
|
|
12
|
+
|
|
13
|
+
box-sizing: border-box;
|
|
14
|
+
width: 100%;
|
|
15
|
+
height: base.simple-var(bottomSheet.$bottomSheet, 'anatomy', 'badgeHandle', 'height');
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
.handle {
|
|
19
|
+
display: block;
|
|
20
|
+
|
|
21
|
+
width: base.simple-var(bottomSheet.$bottomSheet, 'anatomy', 'badgeHandle', 'handle', 'width');
|
|
22
|
+
min-height: base.simple-var(bottomSheet.$bottomSheet, 'anatomy', 'badgeHandle', 'handle', 'min-height');
|
|
23
|
+
border-radius: base.simple-var(bottomSheet.$bottomSheet, 'anatomy', 'badgeHandle', 'handle', 'border-radius');
|
|
24
|
+
|
|
25
|
+
background-color: base.$sn-theme-color-neutral-decor;
|
|
26
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export * from './Handle';
|
package/src/index.ts
ADDED
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
export * from './components';
|
|
2
|
+
export * from './constants';
|
|
3
|
+
// Surface-context: общие слоты (`Dialog*`) ветвят визуал по нему; frame (sheet / modal / drawer)
|
|
4
|
+
// его проставляет. Вынесен в `@cloud-ru/ds-popup-private`, реэкспортируем для внешнего контракта.
|
|
5
|
+
export {
|
|
6
|
+
OVERLAY_SURFACE,
|
|
7
|
+
OverlaySurfaceProvider,
|
|
8
|
+
useOverlayBodyHeightAuto,
|
|
9
|
+
useOverlaySurface,
|
|
10
|
+
} from '@cloud-ru/ds-popup-private';
|
|
11
|
+
export type { OverlaySurface } from '@cloud-ru/ds-popup-private';
|
|
12
|
+
// Публичный footer-builder — единый источник правды для футера BottomSheet / Modal / Drawer
|
|
13
|
+
// (типизированные кнопки approve/cancel/additional).
|
|
14
|
+
export { FooterActions } from '@cloud-ru/ds-popup-private';
|
|
15
|
+
export type { FooterActionsProps, FooterActionsTestIds } from '@cloud-ru/ds-popup-private';
|
|
16
|
+
// Sheet-слоты под собственными именами (фасад над `@cloud-ru/ds-popup-private`). Доступны и через namespace
|
|
17
|
+
// `BottomSheetCustom.Header/.Body/.Footer/.Media`. Modal/drawer оборачивают их своими surface-aware
|
|
18
|
+
// dispatcher'ами.
|
|
19
|
+
export {
|
|
20
|
+
PopupBody as SheetBody,
|
|
21
|
+
PopupFooter as SheetFooter,
|
|
22
|
+
PopupHeader as SheetHeader,
|
|
23
|
+
PopupMedia as DialogMedia,
|
|
24
|
+
} from '@cloud-ru/ds-popup-private';
|
|
25
|
+
export type {
|
|
26
|
+
PopupBodyProps as SheetBodyProps,
|
|
27
|
+
PopupFooterProps as SheetFooterProps,
|
|
28
|
+
PopupHeaderProps as SheetHeaderProps,
|
|
29
|
+
} from '@cloud-ru/ds-popup-private';
|
|
30
|
+
export * from './types';
|
package/src/types.ts
ADDED
|
@@ -0,0 +1,185 @@
|
|
|
1
|
+
import { BottomSheetActionButton, FooterActionsOrientation, PopupMediaProps } from '@cloud-ru/ds-popup-private';
|
|
2
|
+
import { WithSupportProps } from '@cloud-ru/ds-utils';
|
|
3
|
+
import { PropsWithChildren, ReactNode } from 'react';
|
|
4
|
+
|
|
5
|
+
// Общие chrome-типы вынесены в `@cloud-ru/ds-popup-private`. Реэкспортируем под историческими именами
|
|
6
|
+
// `@cloud-ru/ds-bottom-sheet`, чтобы не ломать внешний контракт (isolatedModules → `export type`).
|
|
7
|
+
export type {
|
|
8
|
+
BottomSheetActionButton,
|
|
9
|
+
FooterActionsOrientation,
|
|
10
|
+
MediaKind,
|
|
11
|
+
PopupBodyProps as BottomSheetBodyProps,
|
|
12
|
+
PopupFooterProps as BottomSheetFooterProps,
|
|
13
|
+
PopupHeaderProps as BottomSheetHeaderProps,
|
|
14
|
+
PopupMediaProps as BottomSheetMediaProps,
|
|
15
|
+
} from '@cloud-ru/ds-popup-private';
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* Фиксированная позиция bottom-sheet'а по высоте.
|
|
19
|
+
*
|
|
20
|
+
* - `number` ∈ (0, 1] — доля от высоты viewport'а (`0.5` = половина экрана; `1` = full-viewport).
|
|
21
|
+
* - `'<n>px'` — абсолютные пиксели (`'320px'`).
|
|
22
|
+
* - `'<n>%'` — процент от высоты viewport (`'50%'`).
|
|
23
|
+
* - `'<n>dvh'` / `'<n>svh'` / `'<n>lvh'` — dynamic / small / large viewport-units (`'90dvh'`).
|
|
24
|
+
* - `'fit-content'` — высота по контенту (auto).
|
|
25
|
+
*/
|
|
26
|
+
export type SnapPoint =
|
|
27
|
+
number | `${number}px` | `${number}%` | `${number}dvh` | `${number}svh` | `${number}lvh` | 'fit-content';
|
|
28
|
+
|
|
29
|
+
export type BottomSheetCustomProps = WithSupportProps<
|
|
30
|
+
PropsWithChildren<{
|
|
31
|
+
/** Управление состоянием показан / не показан. */
|
|
32
|
+
open: boolean;
|
|
33
|
+
/** Колбэк закрытия (вызывается при click outside, Esc, swipe-down, browser-back). */
|
|
34
|
+
onClose(): void;
|
|
35
|
+
/**
|
|
36
|
+
* Отображение тёмной подложки за sheet'ом. При `false` фон не затемняется и click-outside
|
|
37
|
+
* не закрывает sheet (нет backdrop-узла, по которому ловится клик).
|
|
38
|
+
* @default true
|
|
39
|
+
*/
|
|
40
|
+
showBackdrop?: boolean;
|
|
41
|
+
/**
|
|
42
|
+
* Блокировать ли скролл фона на время открытия (`react-remove-scroll`). При `false` страница
|
|
43
|
+
* под sheet'ом остаётся прокручиваемой — для non-modal сценариев (sheet поверх контента, с
|
|
44
|
+
* которым продолжают взаимодействовать). Обычно используется вместе с `showBackdrop={false}`.
|
|
45
|
+
* @default true
|
|
46
|
+
*/
|
|
47
|
+
lockScroll?: boolean;
|
|
48
|
+
/**
|
|
49
|
+
* Включает swipe-down для закрытия / swipe-up для раскрытия на следующий snap-point.
|
|
50
|
+
* При `swipeEnabled=false` snap-point по-прежнему можно переключить через controlled `snapIndex` prop'ом.
|
|
51
|
+
* @default true
|
|
52
|
+
*/
|
|
53
|
+
swipeEnabled?: boolean;
|
|
54
|
+
/**
|
|
55
|
+
* Массив фиксированных позиций sheet'а от меньшей к большей. По дефолту `undefined` —
|
|
56
|
+
* sheet `height: auto` с одним snap'ом по высоте контента.
|
|
57
|
+
*
|
|
58
|
+
* Пример: `[0.5, 1]` — sheet открывается на половину экрана, drag вверх раскрывает
|
|
59
|
+
* до full-viewport; drag вниз ниже `0.5` ведёт к закрытию.
|
|
60
|
+
*
|
|
61
|
+
* Контракт массива (движок не сортирует и не дедуплицирует — порядок и различимость на
|
|
62
|
+
* стороне потребителя):
|
|
63
|
+
* - строго по возрастанию: индекс `0` — самая компактная позиция, последний — top / expanded;
|
|
64
|
+
* - значения должны резолвиться в различные высоты (`['50%', 0.5]` на типичном вьюпорте дадут
|
|
65
|
+
* одну высоту → дубль-индекс будет недостижим свайпом);
|
|
66
|
+
* - `'fit-content'` имеет смысл только как ЕДИНСТВЕННЫЙ snap (без `snapPoints`); внутри массива
|
|
67
|
+
* фиксированных позиций его «контентная» высота не определена.
|
|
68
|
+
*/
|
|
69
|
+
snapPoints?: SnapPoint[];
|
|
70
|
+
/**
|
|
71
|
+
* Индекс snap'а, на котором sheet открывается по дефолту. Игнорируется при controlled `snapIndex`.
|
|
72
|
+
* @default 0
|
|
73
|
+
*/
|
|
74
|
+
defaultSnapIndex?: number;
|
|
75
|
+
/**
|
|
76
|
+
* Controlled-индекс активного snap'а. Если задан, sheet всегда находится на этом snap'е;
|
|
77
|
+
* swipe-up/down вызывают `onSnapIndexChange`, но не меняют позицию сами — consumer должен
|
|
78
|
+
* передать новое значение.
|
|
79
|
+
*/
|
|
80
|
+
snapIndex?: number;
|
|
81
|
+
/**
|
|
82
|
+
* Callback изменения активного snap'а (пересечение swipe-границы или click по UI).
|
|
83
|
+
* Не вызывается при программной смене controlled `snapIndex`.
|
|
84
|
+
*/
|
|
85
|
+
onSnapIndexChange?(snapIndex: number): void;
|
|
86
|
+
/**
|
|
87
|
+
* Закрывать sheet при `popstate` (browser-back на mobile).
|
|
88
|
+
* @default true
|
|
89
|
+
*/
|
|
90
|
+
closeOnPopstate?: boolean;
|
|
91
|
+
/**
|
|
92
|
+
* Резервировать ли место под iOS notch / home-indicator и Android nav-bar. Реализовано паддингом
|
|
93
|
+
* на `.content` через `env(safe-area-inset-*)`: на устройстве без выреза/индикатора (и на desktop)
|
|
94
|
+
* inset = 0, поэтому никакого «лишнего» отступа не появляется; на notched-устройстве — ровно нужный.
|
|
95
|
+
* Верхний отступ добавляется только когда sheet раскрыт на полный вьюпорт (его верх под notch).
|
|
96
|
+
* @default true
|
|
97
|
+
*/
|
|
98
|
+
safeArea?: boolean;
|
|
99
|
+
/**
|
|
100
|
+
* Отключить анимации открытия / закрытия и перехода между snap-точками.
|
|
101
|
+
* @default false
|
|
102
|
+
*/
|
|
103
|
+
disableMotions?: boolean;
|
|
104
|
+
/** Контейнер для портала. По дефолту — `body` либо контекст-провайдер `@cloud-ru/ds-portal-context`. */
|
|
105
|
+
container?: string | HTMLElement;
|
|
106
|
+
/** CSS-класс самого sheet-контейнера. */
|
|
107
|
+
className?: string;
|
|
108
|
+
/** CSS-класс корневого элемента portal'а. */
|
|
109
|
+
rootClassName?: string;
|
|
110
|
+
}>
|
|
111
|
+
>;
|
|
112
|
+
|
|
113
|
+
export type BottomSheetProps = Omit<BottomSheetCustomProps, 'children' | 'disableMotions'> & {
|
|
114
|
+
/** Заголовок в шапке. */
|
|
115
|
+
title?: ReactNode;
|
|
116
|
+
/** Slot справа от title (внутри той же строки) — типично `QuestionTooltip`, status badge. */
|
|
117
|
+
slotAfterTitle?: ReactNode;
|
|
118
|
+
/** Текстовая строка-подзаголовок под title. */
|
|
119
|
+
subtitle?: ReactNode;
|
|
120
|
+
/** Slot под подзаголовком — типично `SearchBar`, `SegmentControl`, `Filter`. */
|
|
121
|
+
slotSecondTitle?: ReactNode;
|
|
122
|
+
/**
|
|
123
|
+
* Callback клика на back-кнопку (слева в шапке).
|
|
124
|
+
* Наличие callback'а рендерит ArrowLeft-кнопку.
|
|
125
|
+
*/
|
|
126
|
+
onBackButtonClick?(): void;
|
|
127
|
+
/** Action-кнопка справа в шапке (любой ReactNode — обычно `Button view='function'`). */
|
|
128
|
+
actionButton?: ReactNode;
|
|
129
|
+
/** Media-блок над шапкой: изображение / иконка либо произвольный `ReactNode`. */
|
|
130
|
+
media?: PopupMediaProps | ReactNode;
|
|
131
|
+
/** Основное содержимое (рендерится в `BottomSheetCustom.Body`). */
|
|
132
|
+
content?: ReactNode;
|
|
133
|
+
/**
|
|
134
|
+
* Горизонтальные паддинги body. При `false` контент идёт во всю ширину (edge-to-edge) — для карт,
|
|
135
|
+
* изображений, списков без отступов. Соответствует Figma-оси `padding=false`.
|
|
136
|
+
* @default true
|
|
137
|
+
*/
|
|
138
|
+
bodyPadding?: boolean;
|
|
139
|
+
/**
|
|
140
|
+
* Тонкие линии между topBar↔body и body↔footer: разграничивают закреплённые шапку и подвал
|
|
141
|
+
* от прокручиваемого под ними содержимого. Передайте `false`, чтобы убрать обе линии.
|
|
142
|
+
* @default true
|
|
143
|
+
*/
|
|
144
|
+
withDividers?: boolean;
|
|
145
|
+
/**
|
|
146
|
+
* Основная кнопка действия — объект пропсов `Button` (по умолчанию `view='filled'`,
|
|
147
|
+
* `appearance='primary'`). Ширина зависит от `footerActionsOrientation` и числа кнопок.
|
|
148
|
+
*/
|
|
149
|
+
approveButton?: BottomSheetActionButton;
|
|
150
|
+
/**
|
|
151
|
+
* Кнопка отмены — объект пропсов `Button` (по умолчанию `view='outline'`, `appearance='neutral'`).
|
|
152
|
+
*/
|
|
153
|
+
cancelButton?: BottomSheetActionButton;
|
|
154
|
+
/**
|
|
155
|
+
* Дополнительная (третья) кнопка — объект пропсов `Button` (по умолчанию `view='simple'`,
|
|
156
|
+
* `appearance='neutral'`).
|
|
157
|
+
*/
|
|
158
|
+
additionalButton?: BottomSheetActionButton;
|
|
159
|
+
/**
|
|
160
|
+
* Ориентация кнопок футера, собранных из `approveButton` / `cancelButton` / `additionalButton`.
|
|
161
|
+
* Применяется **только при ровно двух** кнопках (canonical cancel/confirm):
|
|
162
|
+
*
|
|
163
|
+
* - `'horizontal'` — кнопки в ряд через space-between: secondary слева, primary справа,
|
|
164
|
+
* ширина по контенту. Точное соответствие Figma `bottomBar.buttonGroup`.
|
|
165
|
+
* - `'vertical'` — кнопки в столбик, full-width (primary сверху).
|
|
166
|
+
*
|
|
167
|
+
* Одна кнопка всегда рендерится full-width (одиночный CTA); три кнопки не помещаются в ряд на
|
|
168
|
+
* mobile-вьюпорте и всегда идут в столбик — для них значение игнорируется.
|
|
169
|
+
*
|
|
170
|
+
* Игнорируется при заданном `footer` (произвольная разметка футера).
|
|
171
|
+
* @default 'horizontal'
|
|
172
|
+
*/
|
|
173
|
+
footerActionsOrientation?: FooterActionsOrientation;
|
|
174
|
+
/**
|
|
175
|
+
* Произвольный футер. Если задан — имеет приоритет над
|
|
176
|
+
* `approveButton` / `cancelButton` / `additionalButton`.
|
|
177
|
+
*/
|
|
178
|
+
footer?: ReactNode;
|
|
179
|
+
/**
|
|
180
|
+
* Переопределение `data-test-id` собранных слотов футера (approve/cancel/additional).
|
|
181
|
+
* По умолчанию — собственные id `BottomSheet`. Адаптивные `Modal`/`Drawer` передают сюда свои
|
|
182
|
+
* `TEST_IDS.footer*`, чтобы футер метился одинаково на desktop-поверхности и в mobile-sheet'е.
|
|
183
|
+
*/
|
|
184
|
+
footerTestIds?: { approve?: string; cancel?: string; additional?: string };
|
|
185
|
+
};
|