@cloud-ru/ds-bottom-sheet 2.1.2 → 2.2.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.
@@ -14,7 +14,7 @@ import { useCallback, useEffect, useRef } from 'react';
14
14
  import { createPortal } from 'react-dom';
15
15
  import { RemoveScroll } from 'react-remove-scroll';
16
16
 
17
- import { TEST_IDS } from '../../constants';
17
+ import { MODE, TEST_IDS } from '../../constants';
18
18
  import { Handle } from '../../helperComponents';
19
19
  import {
20
20
  BottomSheetBodyProps,
@@ -50,6 +50,7 @@ export function BottomSheetCustom(props: BottomSheetCustomProps) {
50
50
  open,
51
51
  onClose,
52
52
  showBackdrop = true,
53
+ mode = MODE.Regular,
53
54
  lockScroll = true,
54
55
  swipeEnabled = true,
55
56
  safeAreaTop = true,
@@ -70,8 +71,16 @@ export function BottomSheetCustom(props: BottomSheetCustomProps) {
70
71
  // Sheet модальный, если затемняет фон или лочит скролл. Non-modal не прячет фон от AT,
71
72
  // не ловит фокус и закрывается по Esc при фокусе снаружи.
72
73
  const isModal = showBackdrop || lockScroll;
74
+ const backdropBlur = mode !== MODE.Regular;
75
+ const isSwipeEnabled = swipeEnabled && mode !== MODE.Forced;
73
76
 
74
- useModalOpenState(open, onClose, { closeOnPopstate });
77
+ useModalOpenState(
78
+ open,
79
+ () => {
80
+ if (mode !== MODE.Forced) onClose();
81
+ },
82
+ { closeOnPopstate },
83
+ );
75
84
 
76
85
  // Возврат фокуса на триггер: запоминаем активный элемент при open=true, возвращаем при open=false.
77
86
  const restoreFocusRef = useRef<HTMLElement | null>(null);
@@ -106,7 +115,7 @@ export function BottomSheetCustom(props: BottomSheetCustomProps) {
106
115
  // Nested-safe для модального sheet'а: закрываем только если фокус внутри этой панели; для
107
116
  // non-modal фокус снаружи — закрываем безусловно.
108
117
  useEffect(() => {
109
- if (!isActive || !isBrowser() || 'CloseWatcher' in window) return;
118
+ if (!isActive || mode === MODE.Forced || !isBrowser() || 'CloseWatcher' in window) return;
110
119
 
111
120
  const handleKeyDown = (event: KeyboardEvent) => {
112
121
  if (event.key !== 'Escape') return;
@@ -120,7 +129,7 @@ export function BottomSheetCustom(props: BottomSheetCustomProps) {
120
129
  };
121
130
  document.addEventListener('keydown', handleKeyDown, true);
122
131
  return () => document.removeEventListener('keydown', handleKeyDown, true);
123
- }, [isActive, isModal, onClose, focusTrapRef]);
132
+ }, [isActive, isModal, mode, onClose, focusTrapRef]);
124
133
 
125
134
  const {
126
135
  setContentNode,
@@ -133,7 +142,7 @@ export function BottomSheetCustom(props: BottomSheetCustomProps) {
133
142
  snapIndex,
134
143
  onSnapIndexChange,
135
144
  onClose,
136
- swipeEnabled,
145
+ swipeEnabled: isSwipeEnabled,
137
146
  isActive,
138
147
  });
139
148
 
@@ -150,8 +159,8 @@ export function BottomSheetCustom(props: BottomSheetCustomProps) {
150
159
  );
151
160
 
152
161
  const handleBackdropClick = useCallback(() => {
153
- if (showBackdrop) onClose();
154
- }, [showBackdrop, onClose]);
162
+ if (showBackdrop && mode === MODE.Regular) onClose();
163
+ }, [showBackdrop, mode, onClose]);
155
164
 
156
165
  // Мобильная поверхность фиксирует только платформу webMobile, плотность наследуется от приложения.
157
166
  const themeClassName = useThemeClassnames({ platform: PLATFORM.WebMobile });
@@ -173,7 +182,13 @@ export function BottomSheetCustom(props: BottomSheetCustomProps) {
173
182
  data-disable-motions={disableMotions || undefined}
174
183
  >
175
184
  {showBackdrop && (
176
- <div className={styles.backdrop} data-test-id={TEST_IDS.backdrop} onClick={handleBackdropClick} aria-hidden />
185
+ <div
186
+ className={styles.backdrop}
187
+ data-backdrop-blur={backdropBlur || undefined}
188
+ data-test-id={TEST_IDS.backdrop}
189
+ onClick={handleBackdropClick}
190
+ aria-hidden
191
+ />
177
192
  )}
178
193
 
179
194
  <div
@@ -194,13 +209,13 @@ export function BottomSheetCustom(props: BottomSheetCustomProps) {
194
209
  data-snap-index={activeSnapIndex}
195
210
  // Пустой массив ведёт себя как single fit-content — атрибут не выставляем.
196
211
  data-snap-points={snapPoints && snapPoints.length > 0 ? snapPoints.length : undefined}
197
- data-swipe-enabled={swipeEnabled || undefined}
212
+ data-swipe-enabled={isSwipeEnabled || undefined}
198
213
  data-dragging={isDragging || undefined}
199
214
  data-full-height={isFullHeight || undefined}
200
215
  {...supportProps}
201
- {...(swipeEnabled ? dragHandlers : {})}
216
+ {...(isSwipeEnabled ? dragHandlers : {})}
202
217
  >
203
- {swipeEnabled && <Handle />}
218
+ {isSwipeEnabled && <Handle />}
204
219
  <OverlaySurfaceProvider surface={OVERLAY_SURFACE.Sheet}>{children}</OverlaySurfaceProvider>
205
220
  </div>
206
221
  </div>
@@ -23,6 +23,10 @@
23
23
 
24
24
  transition: opacity 0.2s;
25
25
 
26
+ &[data-backdrop-blur] {
27
+ backdrop-filter: blur(base.$sn-theme-effect-backgroundBlur);
28
+ }
29
+
26
30
  .root[data-active] & {
27
31
  opacity: 1;
28
32
  }
package/src/constants.ts CHANGED
@@ -27,3 +27,9 @@ export const SNAP_POINTS_PRESET = {
27
27
  /** Открывается на половину вьюпорта, drag вверх раскрывает на всю высоту. */
28
28
  halfFull: [0.5, 1],
29
29
  } satisfies Record<string, SnapPoint[]>;
30
+
31
+ export const MODE = {
32
+ Regular: 'regular',
33
+ Aggressive: 'aggressive',
34
+ Forced: 'forced',
35
+ } as const;
package/src/types.ts CHANGED
@@ -1,7 +1,11 @@
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
4
 
5
+ import { MODE } from './constants';
6
+
7
+ export type BottomSheetMode = ValueOf<typeof MODE>;
8
+
5
9
  // Общие chrome-типы вынесены в `@cloud-ru/ds-popup-private`. Реэкспортируем под историческими именами
6
10
  // `@cloud-ru/ds-bottom-sheet`, чтобы не ломать внешний контракт (isolatedModules → `export type`).
7
11
  export type {
@@ -38,6 +42,13 @@ export type BottomSheetCustomProps = WithSupportProps<
38
42
  * @default true
39
43
  */
40
44
  showBackdrop?: boolean;
45
+ /**
46
+ * Режим поведения: `regular` — стандартное закрытие; `aggressive` — размытие фона
47
+ * и запрет закрытия кликом по подложке; `forced` — дополнительно запрещает закрытие свайпом, Escape и переходом по истории браузера.
48
+ * Размытие применяется только при `showBackdrop=true`.
49
+ * @default 'regular'
50
+ */
51
+ mode?: BottomSheetMode;
41
52
  /**
42
53
  * Блокировать ли скролл фона на время открытия (`react-remove-scroll`). При `false` страница
43
54
  * под sheet'ом остаётся прокручиваемой — для non-modal сценариев (sheet поверх контента, с
@@ -47,6 +58,7 @@ export type BottomSheetCustomProps = WithSupportProps<
47
58
  lockScroll?: boolean;
48
59
  /**
49
60
  * Включает swipe-down для закрытия / swipe-up для раскрытия на следующий snap-point.
61
+ * В режиме `forced` свайп отключён независимо от значения свойства.
50
62
  * При `swipeEnabled=false` snap-point по-прежнему можно переключить через controlled `snapIndex` prop'ом.
51
63
  * @default true
52
64
  */