@cloud-ru/ds-bottom-sheet 2.1.2-preview-87834313.0 → 2.1.2-preview-de7dadcf.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/README.md +9 -5
- package/dist/cjs/components/BottomSheetCustom/BottomSheetCustom.js +7 -5
- package/dist/cjs/constants.d.ts +5 -0
- package/dist/cjs/constants.js +6 -1
- package/dist/cjs/types.d.ts +9 -4
- package/dist/esm/components/BottomSheetCustom/BottomSheetCustom.js +8 -6
- package/dist/esm/constants.d.ts +5 -0
- package/dist/esm/constants.js +5 -0
- package/dist/esm/types.d.ts +9 -4
- package/dist/tsconfig.cjs.tsbuildinfo +1 -1
- package/dist/tsconfig.esm.tsbuildinfo +1 -1
- package/package.json +1 -1
- package/src/components/BottomSheetCustom/BottomSheetCustom.tsx +10 -8
- package/src/constants.ts +6 -0
- package/src/types.ts +11 -4
package/README.md
CHANGED
|
@@ -19,7 +19,7 @@ Drag-индикатор 32×4px сверху — визуальная подск
|
|
|
19
19
|
### Backdrop (default `showBackdrop=true`)
|
|
20
20
|
Полупрозрачная подложка. Click по backdrop'у вызывает `onClose`. При `showBackdrop={false}` фон не затемняется и click-outside не закрывает sheet.
|
|
21
21
|
|
|
22
|
-
`
|
|
22
|
+
`mode` задаёт поведение sheet: `regular` (по умолчанию) сохраняет стандартное закрытие; `aggressive` размывает фон и запрещает закрытие кликом по подложке; `forced` дополнительно отключает свайп независимо от `swipeEnabled`. Размытие применяется только при `showBackdrop={true}`.
|
|
23
23
|
|
|
24
24
|
### Non-modal (default `lockScroll=true`)
|
|
25
25
|
По умолчанию sheet — модальный: фон затемнён и заблокирован для скролла. Для non-modal сценария (sheet поверх контента, с которым продолжают работать) передайте `lockScroll={false}` (страница под sheet'ом скроллится) — обычно вместе с `showBackdrop={false}`.
|
|
@@ -677,7 +677,6 @@ export function NonModal() {
|
|
|
677
677
|
| `actionButton` | `ReactNode` | — | Action-кнопка справа в шапке (любой ReactNode — обычно `Button view='function'`). |
|
|
678
678
|
| `additionalButton` | `BottomSheetActionButton` | — | Дополнительная (третья) кнопка — объект пропсов `Button` (по умолчанию `view='simple'`, <br/> `appearance='neutral'`). |
|
|
679
679
|
| `approveButton` | `BottomSheetActionButton` | — | Основная кнопка действия — объект пропсов `Button` (по умолчанию `view='filled'`, <br/> `appearance='primary'`). Ширина зависит от `footerActionsOrientation` и числа кнопок. |
|
|
680
|
-
| `backdropBlur` | `boolean` | `false` | Размытие фона под подложкой. Применяется только при `showBackdrop=true`. |
|
|
681
680
|
| `bodyPadding` | `boolean` | `true` | Горизонтальные паддинги body. При `false` контент идёт во всю ширину (edge-to-edge) — для карт, <br/> изображений, списков без отступов. Соответствует Figma-оси `padding=false`. |
|
|
682
681
|
| `cancelButton` | `BottomSheetActionButton` | — | Кнопка отмены — объект пропсов `Button` (по умолчанию `view='outline'`, `appearance='neutral'`). |
|
|
683
682
|
| `className` | `string` | — | CSS-класс самого sheet-контейнера. |
|
|
@@ -691,6 +690,7 @@ export function NonModal() {
|
|
|
691
690
|
| `footerTestIds` | `{ approve?: string; cancel?: string; additional?: string \| undefined; } \| undefined` | — | Переопределение `data-test-id` собранных слотов футера (approve/cancel/additional). <br/> По умолчанию — собственные id `BottomSheet`. Адаптивные `Modal`/`Drawer` передают сюда свои <br/> `TEST_IDS.footer*`, чтобы футер метился одинаково на desktop-поверхности и в mobile-sheet'е. |
|
|
692
691
|
| `lockScroll` | `boolean` | `true` | Блокировать ли скролл фона на время открытия (`react-remove-scroll`). При `false` страница <br/> под sheet'ом остаётся прокручиваемой — для non-modal сценариев (sheet поверх контента, с <br/> которым продолжают взаимодействовать). Обычно используется вместе с `showBackdrop={false}`. |
|
|
693
692
|
| `media` | `PopupMediaProps` | — | Media-блок над шапкой: изображение / иконка либо произвольный `ReactNode`. |
|
|
693
|
+
| `mode` | `"aggressive"` \| `"forced"` \| `"regular"` | `'regular'` | Режим поведения: `regular` — стандартное закрытие; `aggressive` — размытие фона <br/> и запрет закрытия кликом по подложке; `forced` — дополнительно отключает свайп. <br/> Размытие применяется только при `showBackdrop=true`. |
|
|
694
694
|
| `onBackButtonClick` | `(() => void)` | — | Callback клика на back-кнопку (слева в шапке). <br/> Наличие callback'а рендерит ArrowLeft-кнопку. |
|
|
695
695
|
| `onClose` | `() => void` | — | Колбэк закрытия (вызывается при click outside, Esc, swipe-down, browser-back). |
|
|
696
696
|
| `onSnapIndexChange` | `((snapIndex: number) => void)` | — | Callback изменения активного snap'а (пересечение swipe-границы или click по UI). <br/> Не вызывается при программной смене controlled `snapIndex`. |
|
|
@@ -704,12 +704,14 @@ export function NonModal() {
|
|
|
704
704
|
| `snapIndex` | `number` | — | Controlled-индекс активного snap'а. Если задан, sheet всегда находится на этом snap'е; <br/> swipe-up/down вызывают `onSnapIndexChange`, но не меняют позицию сами — consumer должен <br/> передать новое значение. |
|
|
705
705
|
| `snapPoints` | `SnapPoint` | — | Массив фиксированных позиций sheet'а от меньшей к большей. По дефолту `undefined` — <br/> sheet `height: auto` с одним snap'ом по высоте контента. <br/> Пример: `[0.5, 1]` — sheet открывается на половину экрана, drag вверх раскрывает <br/> до full-viewport; drag вниз ниже `0.5` ведёт к закрытию. <br/> Контракт массива (движок не сортирует и не дедуплицирует — порядок и различимость на <br/> стороне потребителя): <br/> - строго по возрастанию: индекс `0` — самая компактная позиция, последний — top / expanded; <br/> - значения должны резолвиться в различные высоты (`['50%', 0.5]` на типичном вьюпорте дадут <br/> одну высоту → дубль-индекс будет недостижим свайпом); <br/> - `'fit-content'` имеет смысл только как ЕДИНСТВЕННЫЙ snap (без `snapPoints`); внутри массива <br/> фиксированных позиций его «контентная» высота не определена. |
|
|
706
706
|
| `subtitle` | `ReactNode` | — | Текстовая строка-подзаголовок под title. |
|
|
707
|
-
| `swipeEnabled` | `boolean` | `true` | Включает swipe-down для закрытия / swipe-up для раскрытия на следующий snap-point. <br/> При `swipeEnabled=false` snap-point по-прежнему можно переключить через controlled `snapIndex` prop'ом. |
|
|
707
|
+
| `swipeEnabled` | `boolean` | `true` | Включает swipe-down для закрытия / swipe-up для раскрытия на следующий snap-point. <br/> В режиме `forced` свайп отключён независимо от значения свойства. <br/> При `swipeEnabled=false` snap-point по-прежнему можно переключить через controlled `snapIndex` prop'ом. |
|
|
708
708
|
| `title` | `ReactNode` | — | Заголовок в шапке. |
|
|
709
709
|
| `withDividers` | `boolean` | `true` | Тонкие линии между topBar↔body и body↔footer: разграничивают закреплённые шапку и подвал <br/> от прокручиваемого под ними содержимого. Передайте `false`, чтобы убрать обе линии. |
|
|
710
710
|
|
|
711
711
|
#### Related types
|
|
712
712
|
|
|
713
|
+
- `BottomSheetMode` = `"aggressive"` \| `"forced"` \| `"regular"`
|
|
714
|
+
|
|
713
715
|
- `SnapPoint` = `number | "fit-content" | `${number}px` | `${number}%` | `${number}dvh` | `${number}svh` | `${number}lvh``
|
|
714
716
|
|
|
715
717
|
## Смотри также
|
|
@@ -944,7 +946,6 @@ export function CustomDisableMotions() {
|
|
|
944
946
|
|
|
945
947
|
| Prop | Type | Default | Description |
|
|
946
948
|
|------|------|---------|-------------|
|
|
947
|
-
| `backdropBlur` | `boolean` | `false` | Размытие фона под подложкой. Применяется только при `showBackdrop=true`. |
|
|
948
949
|
| `children` | `string \| number \| boolean \| ReactElement<any, string \| JSXElementConstructor<any>> \| Iterable<ReactNode> \| ReactPortal \| null \| undefined` | — | |
|
|
949
950
|
| `className` | `string` | — | CSS-класс самого sheet-контейнера. |
|
|
950
951
|
| `closeOnPopstate` | `boolean` | `true` | Закрывать sheet при `popstate` (browser-back на mobile). |
|
|
@@ -953,6 +954,7 @@ export function CustomDisableMotions() {
|
|
|
953
954
|
| `defaultSnapIndex` | `number` | `0` | Индекс snap'а, на котором sheet открывается по дефолту. Игнорируется при controlled `snapIndex`. |
|
|
954
955
|
| `disableMotions` | `boolean` | `false` | Отключить анимации открытия / закрытия и перехода между snap-точками. |
|
|
955
956
|
| `lockScroll` | `boolean` | `true` | Блокировать ли скролл фона на время открытия (`react-remove-scroll`). При `false` страница <br/> под sheet'ом остаётся прокручиваемой — для non-modal сценариев (sheet поверх контента, с <br/> которым продолжают взаимодействовать). Обычно используется вместе с `showBackdrop={false}`. |
|
|
957
|
+
| `mode` | `"aggressive"` \| `"forced"` \| `"regular"` | `'regular'` | Режим поведения: `regular` — стандартное закрытие; `aggressive` — размытие фона <br/> и запрет закрытия кликом по подложке; `forced` — дополнительно отключает свайп. <br/> Размытие применяется только при `showBackdrop=true`. |
|
|
956
958
|
| `onClose` | `() => void` | — | Колбэк закрытия (вызывается при click outside, Esc, swipe-down, browser-back). |
|
|
957
959
|
| `onSnapIndexChange` | `((snapIndex: number) => void)` | — | Callback изменения активного snap'а (пересечение swipe-границы или click по UI). <br/> Не вызывается при программной смене controlled `snapIndex`. |
|
|
958
960
|
| `open` | `boolean` | — | Управление состоянием показан / не показан. |
|
|
@@ -962,10 +964,12 @@ export function CustomDisableMotions() {
|
|
|
962
964
|
| `showBackdrop` | `boolean` | `true` | Отображение тёмной подложки за sheet'ом. При `false` фон не затемняется и click-outside <br/> не закрывает sheet (нет backdrop-узла, по которому ловится клик). |
|
|
963
965
|
| `snapIndex` | `number` | — | Controlled-индекс активного snap'а. Если задан, sheet всегда находится на этом snap'е; <br/> swipe-up/down вызывают `onSnapIndexChange`, но не меняют позицию сами — consumer должен <br/> передать новое значение. |
|
|
964
966
|
| `snapPoints` | `SnapPoint` | — | Массив фиксированных позиций sheet'а от меньшей к большей. По дефолту `undefined` — <br/> sheet `height: auto` с одним snap'ом по высоте контента. <br/> Пример: `[0.5, 1]` — sheet открывается на половину экрана, drag вверх раскрывает <br/> до full-viewport; drag вниз ниже `0.5` ведёт к закрытию. <br/> Контракт массива (движок не сортирует и не дедуплицирует — порядок и различимость на <br/> стороне потребителя): <br/> - строго по возрастанию: индекс `0` — самая компактная позиция, последний — top / expanded; <br/> - значения должны резолвиться в различные высоты (`['50%', 0.5]` на типичном вьюпорте дадут <br/> одну высоту → дубль-индекс будет недостижим свайпом); <br/> - `'fit-content'` имеет смысл только как ЕДИНСТВЕННЫЙ snap (без `snapPoints`); внутри массива <br/> фиксированных позиций его «контентная» высота не определена. |
|
|
965
|
-
| `swipeEnabled` | `boolean` | `true` | Включает swipe-down для закрытия / swipe-up для раскрытия на следующий snap-point. <br/> При `swipeEnabled=false` snap-point по-прежнему можно переключить через controlled `snapIndex` prop'ом. |
|
|
967
|
+
| `swipeEnabled` | `boolean` | `true` | Включает swipe-down для закрытия / swipe-up для раскрытия на следующий snap-point. <br/> В режиме `forced` свайп отключён независимо от значения свойства. <br/> При `swipeEnabled=false` snap-point по-прежнему можно переключить через controlled `snapIndex` prop'ом. |
|
|
966
968
|
|
|
967
969
|
##### Related types
|
|
968
970
|
|
|
971
|
+
- `BottomSheetMode` = `"aggressive"` \| `"forced"` \| `"regular"`
|
|
972
|
+
|
|
969
973
|
- `SnapPoint` = `number | "fit-content" | `${number}px` | `${number}%` | `${number}dvh` | `${number}svh` | `${number}lvh``
|
|
970
974
|
|
|
971
975
|
### Смотри также
|
|
@@ -34,10 +34,12 @@ function resolveContainer(container, portalContextNode) {
|
|
|
34
34
|
* Pointer-Events swipe / snap-engine. Готовая анатомия — `BottomSheet`.
|
|
35
35
|
*/
|
|
36
36
|
function BottomSheetCustom(props) {
|
|
37
|
-
const { open, onClose, showBackdrop = true,
|
|
37
|
+
const { open, onClose, showBackdrop = true, mode = constants_1.MODE.Regular, lockScroll = true, swipeEnabled = true, safeAreaTop = true, safeAreaBottom = true, snapPoints, defaultSnapIndex, snapIndex, onSnapIndexChange, closeOnPopstate = true, disableMotions = false, container, className, rootClassName, children, ...rest } = props;
|
|
38
38
|
// Sheet модальный, если затемняет фон или лочит скролл. Non-modal не прячет фон от AT,
|
|
39
39
|
// не ловит фокус и закрывается по Esc при фокусе снаружи.
|
|
40
40
|
const isModal = showBackdrop || lockScroll;
|
|
41
|
+
const backdropBlur = mode !== constants_1.MODE.Regular;
|
|
42
|
+
const isSwipeEnabled = swipeEnabled && mode !== constants_1.MODE.Forced;
|
|
41
43
|
(0, utils_1.useModalOpenState)(open, onClose, { closeOnPopstate });
|
|
42
44
|
// Возврат фокуса на триггер: запоминаем активный элемент при open=true, возвращаем при open=false.
|
|
43
45
|
const restoreFocusRef = (0, react_1.useRef)(null);
|
|
@@ -88,7 +90,7 @@ function BottomSheetCustom(props) {
|
|
|
88
90
|
snapIndex,
|
|
89
91
|
onSnapIndexChange,
|
|
90
92
|
onClose,
|
|
91
|
-
swipeEnabled,
|
|
93
|
+
swipeEnabled: isSwipeEnabled,
|
|
92
94
|
isActive,
|
|
93
95
|
});
|
|
94
96
|
// Верхний safe-area отступ нужен только на full-height (верх под notch); флаг — в `data-full-height`.
|
|
@@ -99,9 +101,9 @@ function BottomSheetCustom(props) {
|
|
|
99
101
|
setContentNode(node);
|
|
100
102
|
}, [focusTrapRef, setContentNode]);
|
|
101
103
|
const handleBackdropClick = (0, react_1.useCallback)(() => {
|
|
102
|
-
if (showBackdrop)
|
|
104
|
+
if (showBackdrop && mode === constants_1.MODE.Regular)
|
|
103
105
|
onClose();
|
|
104
|
-
}, [showBackdrop, onClose]);
|
|
106
|
+
}, [showBackdrop, mode, onClose]);
|
|
105
107
|
// Мобильная поверхность фиксирует только платформу webMobile, плотность наследуется от приложения.
|
|
106
108
|
const themeClassName = (0, theme_1.useThemeClassnames)({ platform: theme_1.PLATFORM.WebMobile });
|
|
107
109
|
if (!isMounted)
|
|
@@ -113,7 +115,7 @@ function BottomSheetCustom(props) {
|
|
|
113
115
|
return (0, react_dom_1.createPortal)(
|
|
114
116
|
// RemoveScroll лочит фон-скролл (refcount для вложенных sheet'ов); `enabled={lockScroll}` —
|
|
115
117
|
// для non-modal фон остаётся прокручиваемым.
|
|
116
|
-
(0, jsx_runtime_1.jsx)(react_remove_scroll_1.RemoveScroll, { enabled: lockScroll, children: (0, jsx_runtime_1.jsxs)("div", { className: (0, classnames_1.default)(styles_module_scss_1.default.root, rootClassName), "data-active": isActive || undefined, "data-disable-motions": disableMotions || undefined, children: [showBackdrop && ((0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.backdrop, "data-backdrop-blur": backdropBlur || undefined, "data-test-id": constants_1.TEST_IDS.backdrop, onClick: handleBackdropClick, "aria-hidden": true })), (0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.contentWrapper, "data-active": isActive || undefined, "data-full-height": isFullHeight || undefined, children: (0, jsx_runtime_1.jsxs)("div", { ref: mergeRefCb, className: (0, classnames_1.default)(styles_module_scss_1.default.content, themeClassName, className), role: 'dialog', "aria-modal": isModal ? 'true' : undefined, "data-test-id": constants_1.TEST_IDS.root, "data-safe-area-top": (safeAreaTop && isFullHeight) || undefined, "data-safe-area-bottom": safeAreaBottom || undefined, "data-snap-index": activeSnapIndex, "data-snap-points": snapPoints && snapPoints.length > 0 ? snapPoints.length : undefined, "data-swipe-enabled":
|
|
118
|
+
(0, jsx_runtime_1.jsx)(react_remove_scroll_1.RemoveScroll, { enabled: lockScroll, children: (0, jsx_runtime_1.jsxs)("div", { className: (0, classnames_1.default)(styles_module_scss_1.default.root, rootClassName), "data-active": isActive || undefined, "data-disable-motions": disableMotions || undefined, children: [showBackdrop && ((0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.backdrop, "data-backdrop-blur": backdropBlur || undefined, "data-test-id": constants_1.TEST_IDS.backdrop, onClick: handleBackdropClick, "aria-hidden": true })), (0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.contentWrapper, "data-active": isActive || undefined, "data-full-height": isFullHeight || undefined, children: (0, jsx_runtime_1.jsxs)("div", { ref: mergeRefCb, className: (0, classnames_1.default)(styles_module_scss_1.default.content, themeClassName, className), role: 'dialog', "aria-modal": isModal ? 'true' : undefined, "data-test-id": constants_1.TEST_IDS.root, "data-safe-area-top": (safeAreaTop && isFullHeight) || undefined, "data-safe-area-bottom": safeAreaBottom || undefined, "data-snap-index": activeSnapIndex, "data-snap-points": snapPoints && snapPoints.length > 0 ? snapPoints.length : undefined, "data-swipe-enabled": isSwipeEnabled || undefined, "data-dragging": isDragging || undefined, "data-full-height": isFullHeight || undefined, ...supportProps, ...(isSwipeEnabled ? dragHandlers : {}), children: [isSwipeEnabled && (0, jsx_runtime_1.jsx)(helperComponents_1.Handle, {}), (0, jsx_runtime_1.jsx)(popup_private_1.OverlaySurfaceProvider, { surface: popup_private_1.OVERLAY_SURFACE.Sheet, children: children })] }) })] }) }), targetNode);
|
|
117
119
|
}
|
|
118
120
|
BottomSheetCustom.Header = popup_private_1.PopupHeader;
|
|
119
121
|
BottomSheetCustom.Body = popup_private_1.PopupBody;
|
package/dist/cjs/constants.d.ts
CHANGED
|
@@ -20,3 +20,8 @@ export declare const SNAP_POINTS_PRESET: {
|
|
|
20
20
|
/** Открывается на половину вьюпорта, drag вверх раскрывает на всю высоту. */
|
|
21
21
|
halfFull: number[];
|
|
22
22
|
};
|
|
23
|
+
export declare const MODE: {
|
|
24
|
+
readonly Regular: "regular";
|
|
25
|
+
readonly Aggressive: "aggressive";
|
|
26
|
+
readonly Forced: "forced";
|
|
27
|
+
};
|
package/dist/cjs/constants.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
// Общий overlay-chrome (media / footer-ориентация / слот-`data-test-id`) вынесен в `@cloud-ru/ds-popup-private`.
|
|
3
3
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
4
|
-
exports.SNAP_POINTS_PRESET = exports.NO_DRAG_ATTRIBUTE = exports.TEST_IDS = exports.MEDIA_KIND = exports.FOOTER_ACTIONS_ORIENTATION = void 0;
|
|
4
|
+
exports.MODE = exports.SNAP_POINTS_PRESET = exports.NO_DRAG_ATTRIBUTE = exports.TEST_IDS = exports.MEDIA_KIND = exports.FOOTER_ACTIONS_ORIENTATION = void 0;
|
|
5
5
|
// Реэкспортируем под теми же именами — внешний контракт `@cloud-ru/ds-bottom-sheet` не меняется.
|
|
6
6
|
var popup_private_1 = require("@cloud-ru/ds-popup-private");
|
|
7
7
|
Object.defineProperty(exports, "FOOTER_ACTIONS_ORIENTATION", { enumerable: true, get: function () { return popup_private_1.FOOTER_ACTIONS_ORIENTATION; } });
|
|
@@ -28,3 +28,8 @@ exports.SNAP_POINTS_PRESET = {
|
|
|
28
28
|
/** Открывается на половину вьюпорта, drag вверх раскрывает на всю высоту. */
|
|
29
29
|
halfFull: [0.5, 1],
|
|
30
30
|
};
|
|
31
|
+
exports.MODE = {
|
|
32
|
+
Regular: 'regular',
|
|
33
|
+
Aggressive: 'aggressive',
|
|
34
|
+
Forced: 'forced',
|
|
35
|
+
};
|
package/dist/cjs/types.d.ts
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
import { BottomSheetActionButton, FooterActionsOrientation, PopupMediaProps } from '@cloud-ru/ds-popup-private';
|
|
2
|
-
import { WithSupportProps } from '@cloud-ru/ds-utils';
|
|
2
|
+
import { ValueOf, WithSupportProps } from '@cloud-ru/ds-utils';
|
|
3
3
|
import { PropsWithChildren, ReactNode } from 'react';
|
|
4
|
+
import { MODE } from './constants';
|
|
5
|
+
export type BottomSheetMode = ValueOf<typeof MODE>;
|
|
4
6
|
export type { BottomSheetActionButton, FooterActionsOrientation, MediaKind, PopupBodyProps as BottomSheetBodyProps, PopupFooterProps as BottomSheetFooterProps, PopupHeaderProps as BottomSheetHeaderProps, PopupMediaProps as BottomSheetMediaProps, } from '@cloud-ru/ds-popup-private';
|
|
5
7
|
/**
|
|
6
8
|
* Фиксированная позиция bottom-sheet'а по высоте.
|
|
@@ -24,10 +26,12 @@ export type BottomSheetCustomProps = WithSupportProps<PropsWithChildren<{
|
|
|
24
26
|
*/
|
|
25
27
|
showBackdrop?: boolean;
|
|
26
28
|
/**
|
|
27
|
-
*
|
|
28
|
-
*
|
|
29
|
+
* Режим поведения: `regular` — стандартное закрытие; `aggressive` — размытие фона
|
|
30
|
+
* и запрет закрытия кликом по подложке; `forced` — дополнительно отключает свайп.
|
|
31
|
+
* Размытие применяется только при `showBackdrop=true`.
|
|
32
|
+
* @default 'regular'
|
|
29
33
|
*/
|
|
30
|
-
|
|
34
|
+
mode?: BottomSheetMode;
|
|
31
35
|
/**
|
|
32
36
|
* Блокировать ли скролл фона на время открытия (`react-remove-scroll`). При `false` страница
|
|
33
37
|
* под sheet'ом остаётся прокручиваемой — для non-modal сценариев (sheet поверх контента, с
|
|
@@ -37,6 +41,7 @@ export type BottomSheetCustomProps = WithSupportProps<PropsWithChildren<{
|
|
|
37
41
|
lockScroll?: boolean;
|
|
38
42
|
/**
|
|
39
43
|
* Включает swipe-down для закрытия / swipe-up для раскрытия на следующий snap-point.
|
|
44
|
+
* В режиме `forced` свайп отключён независимо от значения свойства.
|
|
40
45
|
* При `swipeEnabled=false` snap-point по-прежнему можно переключить через controlled `snapIndex` prop'ом.
|
|
41
46
|
* @default true
|
|
42
47
|
*/
|
|
@@ -7,7 +7,7 @@ import cn from 'classnames';
|
|
|
7
7
|
import { useCallback, useEffect, useRef } from 'react';
|
|
8
8
|
import { createPortal } from 'react-dom';
|
|
9
9
|
import { RemoveScroll } from 'react-remove-scroll';
|
|
10
|
-
import { TEST_IDS } from '../../constants.js';
|
|
10
|
+
import { MODE, TEST_IDS } from '../../constants.js';
|
|
11
11
|
import { Handle } from '../../helperComponents/index.js';
|
|
12
12
|
import { CLOSING_TIMEOUT } from './constants.js';
|
|
13
13
|
import { useDragEngine, useFocusTrap, useTransitionPhase } from './hooks/index.js';
|
|
@@ -28,10 +28,12 @@ function resolveContainer(container, portalContextNode) {
|
|
|
28
28
|
* Pointer-Events swipe / snap-engine. Готовая анатомия — `BottomSheet`.
|
|
29
29
|
*/
|
|
30
30
|
export function BottomSheetCustom(props) {
|
|
31
|
-
const { open, onClose, showBackdrop = true,
|
|
31
|
+
const { open, onClose, showBackdrop = true, mode = MODE.Regular, lockScroll = true, swipeEnabled = true, safeAreaTop = true, safeAreaBottom = true, snapPoints, defaultSnapIndex, snapIndex, onSnapIndexChange, closeOnPopstate = true, disableMotions = false, container, className, rootClassName, children, ...rest } = props;
|
|
32
32
|
// Sheet модальный, если затемняет фон или лочит скролл. Non-modal не прячет фон от AT,
|
|
33
33
|
// не ловит фокус и закрывается по Esc при фокусе снаружи.
|
|
34
34
|
const isModal = showBackdrop || lockScroll;
|
|
35
|
+
const backdropBlur = mode !== MODE.Regular;
|
|
36
|
+
const isSwipeEnabled = swipeEnabled && mode !== MODE.Forced;
|
|
35
37
|
useModalOpenState(open, onClose, { closeOnPopstate });
|
|
36
38
|
// Возврат фокуса на триггер: запоминаем активный элемент при open=true, возвращаем при open=false.
|
|
37
39
|
const restoreFocusRef = useRef(null);
|
|
@@ -82,7 +84,7 @@ export function BottomSheetCustom(props) {
|
|
|
82
84
|
snapIndex,
|
|
83
85
|
onSnapIndexChange,
|
|
84
86
|
onClose,
|
|
85
|
-
swipeEnabled,
|
|
87
|
+
swipeEnabled: isSwipeEnabled,
|
|
86
88
|
isActive,
|
|
87
89
|
});
|
|
88
90
|
// Верхний safe-area отступ нужен только на full-height (верх под notch); флаг — в `data-full-height`.
|
|
@@ -93,9 +95,9 @@ export function BottomSheetCustom(props) {
|
|
|
93
95
|
setContentNode(node);
|
|
94
96
|
}, [focusTrapRef, setContentNode]);
|
|
95
97
|
const handleBackdropClick = useCallback(() => {
|
|
96
|
-
if (showBackdrop)
|
|
98
|
+
if (showBackdrop && mode === MODE.Regular)
|
|
97
99
|
onClose();
|
|
98
|
-
}, [showBackdrop, onClose]);
|
|
100
|
+
}, [showBackdrop, mode, onClose]);
|
|
99
101
|
// Мобильная поверхность фиксирует только платформу webMobile, плотность наследуется от приложения.
|
|
100
102
|
const themeClassName = useThemeClassnames({ platform: PLATFORM.WebMobile });
|
|
101
103
|
if (!isMounted)
|
|
@@ -107,7 +109,7 @@ export function BottomSheetCustom(props) {
|
|
|
107
109
|
return createPortal(
|
|
108
110
|
// RemoveScroll лочит фон-скролл (refcount для вложенных sheet'ов); `enabled={lockScroll}` —
|
|
109
111
|
// для non-modal фон остаётся прокручиваемым.
|
|
110
|
-
_jsx(RemoveScroll, { enabled: lockScroll, children: _jsxs("div", { className: cn(styles.root, rootClassName), "data-active": isActive || undefined, "data-disable-motions": disableMotions || undefined, children: [showBackdrop && (_jsx("div", { className: styles.backdrop, "data-backdrop-blur": backdropBlur || undefined, "data-test-id": TEST_IDS.backdrop, onClick: handleBackdropClick, "aria-hidden": true })), _jsx("div", { className: styles.contentWrapper, "data-active": isActive || undefined, "data-full-height": isFullHeight || undefined, children: _jsxs("div", { ref: mergeRefCb, className: cn(styles.content, themeClassName, className), role: 'dialog', "aria-modal": isModal ? 'true' : undefined, "data-test-id": TEST_IDS.root, "data-safe-area-top": (safeAreaTop && isFullHeight) || undefined, "data-safe-area-bottom": safeAreaBottom || undefined, "data-snap-index": activeSnapIndex, "data-snap-points": snapPoints && snapPoints.length > 0 ? snapPoints.length : undefined, "data-swipe-enabled":
|
|
112
|
+
_jsx(RemoveScroll, { enabled: lockScroll, children: _jsxs("div", { className: cn(styles.root, rootClassName), "data-active": isActive || undefined, "data-disable-motions": disableMotions || undefined, children: [showBackdrop && (_jsx("div", { className: styles.backdrop, "data-backdrop-blur": backdropBlur || undefined, "data-test-id": TEST_IDS.backdrop, onClick: handleBackdropClick, "aria-hidden": true })), _jsx("div", { className: styles.contentWrapper, "data-active": isActive || undefined, "data-full-height": isFullHeight || undefined, children: _jsxs("div", { ref: mergeRefCb, className: cn(styles.content, themeClassName, className), role: 'dialog', "aria-modal": isModal ? 'true' : undefined, "data-test-id": TEST_IDS.root, "data-safe-area-top": (safeAreaTop && isFullHeight) || undefined, "data-safe-area-bottom": safeAreaBottom || undefined, "data-snap-index": activeSnapIndex, "data-snap-points": snapPoints && snapPoints.length > 0 ? snapPoints.length : undefined, "data-swipe-enabled": isSwipeEnabled || undefined, "data-dragging": isDragging || undefined, "data-full-height": isFullHeight || undefined, ...supportProps, ...(isSwipeEnabled ? dragHandlers : {}), children: [isSwipeEnabled && _jsx(Handle, {}), _jsx(OverlaySurfaceProvider, { surface: OVERLAY_SURFACE.Sheet, children: children })] }) })] }) }), targetNode);
|
|
111
113
|
}
|
|
112
114
|
BottomSheetCustom.Header = PopupHeader;
|
|
113
115
|
BottomSheetCustom.Body = PopupBody;
|
package/dist/esm/constants.d.ts
CHANGED
|
@@ -20,3 +20,8 @@ export declare const SNAP_POINTS_PRESET: {
|
|
|
20
20
|
/** Открывается на половину вьюпорта, drag вверх раскрывает на всю высоту. */
|
|
21
21
|
halfFull: number[];
|
|
22
22
|
};
|
|
23
|
+
export declare const MODE: {
|
|
24
|
+
readonly Regular: "regular";
|
|
25
|
+
readonly Aggressive: "aggressive";
|
|
26
|
+
readonly Forced: "forced";
|
|
27
|
+
};
|
package/dist/esm/constants.js
CHANGED
package/dist/esm/types.d.ts
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
import { BottomSheetActionButton, FooterActionsOrientation, PopupMediaProps } from '@cloud-ru/ds-popup-private';
|
|
2
|
-
import { WithSupportProps } from '@cloud-ru/ds-utils';
|
|
2
|
+
import { ValueOf, WithSupportProps } from '@cloud-ru/ds-utils';
|
|
3
3
|
import { PropsWithChildren, ReactNode } from 'react';
|
|
4
|
+
import { MODE } from './constants.js';
|
|
5
|
+
export type BottomSheetMode = ValueOf<typeof MODE>;
|
|
4
6
|
export type { BottomSheetActionButton, FooterActionsOrientation, MediaKind, PopupBodyProps as BottomSheetBodyProps, PopupFooterProps as BottomSheetFooterProps, PopupHeaderProps as BottomSheetHeaderProps, PopupMediaProps as BottomSheetMediaProps, } from '@cloud-ru/ds-popup-private';
|
|
5
7
|
/**
|
|
6
8
|
* Фиксированная позиция bottom-sheet'а по высоте.
|
|
@@ -24,10 +26,12 @@ export type BottomSheetCustomProps = WithSupportProps<PropsWithChildren<{
|
|
|
24
26
|
*/
|
|
25
27
|
showBackdrop?: boolean;
|
|
26
28
|
/**
|
|
27
|
-
*
|
|
28
|
-
*
|
|
29
|
+
* Режим поведения: `regular` — стандартное закрытие; `aggressive` — размытие фона
|
|
30
|
+
* и запрет закрытия кликом по подложке; `forced` — дополнительно отключает свайп.
|
|
31
|
+
* Размытие применяется только при `showBackdrop=true`.
|
|
32
|
+
* @default 'regular'
|
|
29
33
|
*/
|
|
30
|
-
|
|
34
|
+
mode?: BottomSheetMode;
|
|
31
35
|
/**
|
|
32
36
|
* Блокировать ли скролл фона на время открытия (`react-remove-scroll`). При `false` страница
|
|
33
37
|
* под sheet'ом остаётся прокручиваемой — для non-modal сценариев (sheet поверх контента, с
|
|
@@ -37,6 +41,7 @@ export type BottomSheetCustomProps = WithSupportProps<PropsWithChildren<{
|
|
|
37
41
|
lockScroll?: boolean;
|
|
38
42
|
/**
|
|
39
43
|
* Включает swipe-down для закрытия / swipe-up для раскрытия на следующий snap-point.
|
|
44
|
+
* В режиме `forced` свайп отключён независимо от значения свойства.
|
|
40
45
|
* При `swipeEnabled=false` snap-point по-прежнему можно переключить через controlled `snapIndex` prop'ом.
|
|
41
46
|
* @default true
|
|
42
47
|
*/
|