@snack-uikit/list 0.25.0 → 0.26.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 0.26.0 (2025-02-25)
+
+
+### Features
+
+* **PDS-1183:** add prop barHideStrategy for Scroll ([718a6e5](https://github.com/cloud-ru-tech/snack-uikit/commit/718a6e56331994eaaed0bf22e2b8437f67081abe))
+
+
+
+
+
 # 0.25.0 (2025-02-10)
 
 

package/README.md

@@ -85,6 +85,7 @@
 | scrollRef | `RefObject<HTMLElement>` | - | Ссылка на элемент, обозначающий самый конец прокручиваемого списка |
 | scrollContainerRef | `RefObject<HTMLElement>` | - | Ссылка на контейнер, который скроллится |
 | untouchableScrollbars | `boolean` | - | Отключает возможность взаимодействовать со скролбарами мышью. |
+| barHideStrategy | enum BarHideStrategy: `"scroll"`, `"move"`, `"never"`, `"leave"` | - | Управление скрытием скролл баров: <br> - `Never` - показывать всегда <br> - `Leave` - скрывать когда курсор покидает компонент <br> - `Scroll` - показывать только когда происходит скроллинг <br> - `Move` - показывать при движении курсора над компонентом |
 | onScroll | `(event?: Event) => void` | - | Колбек на скролл прокручиваемого списка |
 | dataFiltered | `boolean` | - |  |
 | dataError | `boolean` | - |  |
@@ -119,6 +120,7 @@
 | scrollRef | `RefObject<HTMLElement>` | - | Ссылка на элемент, обозначающий самый конец прокручиваемого списка |
 | scrollContainerRef | `RefObject<HTMLElement>` | - | Ссылка на контейнер, который скроллится |
 | untouchableScrollbars | `boolean` | - | Отключает возможность взаимодействовать со скролбарами мышью. |
+| barHideStrategy | enum BarHideStrategy: `"scroll"`, `"move"`, `"never"`, `"leave"` | - | Управление скрытием скролл баров: <br> - `Never` - показывать всегда <br> - `Leave` - скрывать когда курсор покидает компонент <br> - `Scroll` - показывать только когда происходит скроллинг <br> - `Move` - показывать при движении курсора над компонентом |
 | onScroll | `(event?: Event) => void` | - | Колбек на скролл прокручиваемого списка |
 | dataFiltered | `boolean` | - |  |
 | dataError | `boolean` | - |  |

package/dist/cjs/components/Lists/ListPrivate/ListPrivate.js

@@ -59,9 +59,10 @@ exports.ListPrivate = (0, react_1.forwardRef)((_a, ref) => {
       dataFiltered,
       scrollToSelectedItem = false,
       virtualized = false,
-      scrollContainerClassName
+      scrollContainerClassName,
+      barHideStrategy = 'never'
     } = _a,
-    props = __rest(_a, ["items", "pinTop", "pinBottom", "onKeyDown", "onBlur", "onFocus", "tabIndex", "active", "scroll", "nested", "search", "searchItem", "scrollRef", "scrollContainerRef", "onScroll", "footer", "loading", "limitedScrollHeight", "untouchableScrollbars", "className", "noDataState", "noResultsState", "errorDataState", "dataError", "dataFiltered", "scrollToSelectedItem", "virtualized", "scrollContainerClassName"]);
+    props = __rest(_a, ["items", "pinTop", "pinBottom", "onKeyDown", "onBlur", "onFocus", "tabIndex", "active", "scroll", "nested", "search", "searchItem", "scrollRef", "scrollContainerRef", "onScroll", "footer", "loading", "limitedScrollHeight", "untouchableScrollbars", "className", "noDataState", "noResultsState", "errorDataState", "dataError", "dataFiltered", "scrollToSelectedItem", "virtualized", "scrollContainerClassName", "barHideStrategy"]);
   const {
     size = 's',
     flattenItems,
@@ -170,7 +171,7 @@ exports.ListPrivate = (0, react_1.forwardRef)((_a, ref) => {
         [styles_module_scss_1.default.scrollContainerM]: scroll && limitedScrollHeight && size === 'm',
         [styles_module_scss_1.default.scrollContainerL]: scroll && limitedScrollHeight && size === 'l'
       }, scrollContainerClassName),
-      barHideStrategy: 'never',
+      barHideStrategy: barHideStrategy,
       size: size === 's' ? 's' : 'm',
       ref: ref => {
         innerScrollRef.current = ref;

package/dist/cjs/types.d.ts

@@ -15,6 +15,14 @@ export type ScrollProps = {
     scrollContainerRef?: RefObject<HTMLElement>;
     /** Отключает возможность взаимодействовать со скролбарами мышью. */
     untouchableScrollbars?: boolean;
+    /**
+     * Управление скрытием скролл баров:
+     * <br> - `Never` - показывать всегда
+     * <br> - `Leave` - скрывать когда курсор покидает компонент
+     * <br> - `Scroll` - показывать только когда происходит скроллинг
+     * <br> - `Move` - показывать при движении курсора над компонентом
+     */
+    barHideStrategy?: OriginalScrollProps['barHideStrategy'];
     /** Колбек на скролл прокручиваемого списка */
     onScroll?: OriginalScrollProps['onScroll'];
 };

package/dist/esm/components/Lists/ListPrivate/ListPrivate.js

@@ -23,7 +23,7 @@ import commonStyles from '../styles.module.css';
 import { ALL_SIZES } from './constants';
 import styles from './styles.module.css';
 export const ListPrivate = forwardRef((_a, ref) => {
-    var { items, pinTop, pinBottom, onKeyDown, onBlur, onFocus, tabIndex, active, scroll, nested, search, searchItem, scrollRef, scrollContainerRef, onScroll, footer, loading, limitedScrollHeight, untouchableScrollbars, className, noDataState, noResultsState, errorDataState, dataError, dataFiltered, scrollToSelectedItem = false, virtualized = false, scrollContainerClassName } = _a, props = __rest(_a, ["items", "pinTop", "pinBottom", "onKeyDown", "onBlur", "onFocus", "tabIndex", "active", "scroll", "nested", "search", "searchItem", "scrollRef", "scrollContainerRef", "onScroll", "footer", "loading", "limitedScrollHeight", "untouchableScrollbars", "className", "noDataState", "noResultsState", "errorDataState", "dataError", "dataFiltered", "scrollToSelectedItem", "virtualized", "scrollContainerClassName"]);
+    var { items, pinTop, pinBottom, onKeyDown, onBlur, onFocus, tabIndex, active, scroll, nested, search, searchItem, scrollRef, scrollContainerRef, onScroll, footer, loading, limitedScrollHeight, untouchableScrollbars, className, noDataState, noResultsState, errorDataState, dataError, dataFiltered, scrollToSelectedItem = false, virtualized = false, scrollContainerClassName, barHideStrategy = 'never' } = _a, props = __rest(_a, ["items", "pinTop", "pinBottom", "onKeyDown", "onBlur", "onFocus", "tabIndex", "active", "scroll", "nested", "search", "searchItem", "scrollRef", "scrollContainerRef", "onScroll", "footer", "loading", "limitedScrollHeight", "untouchableScrollbars", "className", "noDataState", "noResultsState", "errorDataState", "dataError", "dataFiltered", "scrollToSelectedItem", "virtualized", "scrollContainerClassName", "barHideStrategy"]);
     const { size = 's', flattenItems, focusFlattenItems } = useNewListContext();
     const { value, isSelectionSingle } = useSelectionContext();
     const innerScrollRef = useRef(null);
@@ -77,7 +77,7 @@ export const ListPrivate = forwardRef((_a, ref) => {
                     [commonStyles.scrollContainerS]: scroll && limitedScrollHeight && size === 's',
                     [commonStyles.scrollContainerM]: scroll && limitedScrollHeight && size === 'm',
                     [commonStyles.scrollContainerL]: scroll && limitedScrollHeight && size === 'l',
-                }, scrollContainerClassName), barHideStrategy: 'never', size: size === 's' ? 's' : 'm', ref: ref => {
+                }, scrollContainerClassName), barHideStrategy: barHideStrategy, size: size === 's' ? 's' : 'm', ref: ref => {
                     innerScrollRef.current = ref;
                     if (scrollContainerRef)
                         scrollContainerRef.current = ref;

package/dist/esm/types.d.ts

@@ -15,6 +15,14 @@ export type ScrollProps = {
     scrollContainerRef?: RefObject<HTMLElement>;
     /** Отключает возможность взаимодействовать со скролбарами мышью. */
     untouchableScrollbars?: boolean;
+    /**
+     * Управление скрытием скролл баров:
+     * <br> - `Never` - показывать всегда
+     * <br> - `Leave` - скрывать когда курсор покидает компонент
+     * <br> - `Scroll` - показывать только когда происходит скроллинг
+     * <br> - `Move` - показывать при движении курсора над компонентом
+     */
+    barHideStrategy?: OriginalScrollProps['barHideStrategy'];
     /** Колбек на скролл прокручиваемого списка */
     onScroll?: OriginalScrollProps['onScroll'];
 };

package/package.json

@@ -4,7 +4,7 @@
     "access": "public"
   },
   "title": "List",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "sideEffects": [
     "*.css",
     "*.woff",
@@ -54,5 +54,5 @@
   "peerDependencies": {
     "@snack-uikit/locale": "*"
   },
-  "gitHead": "44591f943a79171320e8db3523ec38953ff101d8"
+  "gitHead": "ad5274413320bf7880ba3c2d1124610281d0de81"
 }

package/src/components/Lists/ListPrivate/ListPrivate.tsx

@@ -45,6 +45,7 @@ export const ListPrivate = forwardRef(
       scrollToSelectedItem = false,
       virtualized = false,
       scrollContainerClassName,
+      barHideStrategy = 'never',
       ...props
     }: ListPrivateProps,
     ref: ForwardedRef<HTMLElement>,
@@ -187,7 +188,7 @@ export const ListPrivate = forwardRef(
               },
               scrollContainerClassName,
             )}
-            barHideStrategy='never'
+            barHideStrategy={barHideStrategy}
             size={size === 's' ? 's' : 'm'}
             ref={ref => {
               innerScrollRef.current = ref;

package/src/types.ts

@@ -18,6 +18,14 @@ export type ScrollProps = {
   scrollContainerRef?: RefObject<HTMLElement>;
   /** Отключает возможность взаимодействовать со скролбарами мышью. */
   untouchableScrollbars?: boolean;
+  /**
+   * Управление скрытием скролл баров:
+   * <br> - `Never` - показывать всегда
+   * <br> - `Leave` - скрывать когда курсор покидает компонент
+   * <br> - `Scroll` - показывать только когда происходит скроллинг
+   * <br> - `Move` - показывать при движении курсора над компонентом
+   */
+  barHideStrategy?: OriginalScrollProps['barHideStrategy'];
   /** Колбек на скролл прокручиваемого списка */
   onScroll?: OriginalScrollProps['onScroll'];
 };