Skip to content

feat(SubnavigationBar): add prop withFade #9116

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 2 commits into from
+97 −3
Closed

feat(SubnavigationBar): add prop withFade #9116

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3dfe9d7
add prop withFade
Oct 30, 2025
b2e122b
[fix]: wrapper scroll & style
Oct 31, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions packages/vkui/src/components/SubnavigationBar/SubnavigationBar.module.css
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,11 @@
.in {
/* Отрицательный margin нужен, чтобы компенсировать увеличенный из-за тени padding (12px -> 20px) */
position: relative;
/* min-width: 100%; */
margin-block: -8px;
margin-inline: 0;
overflow-x: hidden;
isolation: isolate;
}

.scrollIn {
Expand All @@ -17,6 +21,17 @@
content: '';
}

.scroll {
display: flex;
overflow-x: auto;
-webkit-overflow-scrolling: touch;
scrollbar-width: none;
}

.scroll::-webkit-scrollbar {
display: none;
}

.item {
display: flex;
list-style-type: none;
Expand All @@ -30,3 +45,28 @@
flex: 1;
min-inline-size: 0;
}

.inFade {
display: flex;
flex: 1 0 100%;
align-items: stretch;
transition: transform var(--vkui--animation_duration_m);
}

.inFadeLeft {
mask-image: linear-gradient(to left, rgb(0, 0, 0, 1) 90%, rgb(0, 0, 0, 0));
Copy link
Contributor

@inomdzhon inomdzhon Oct 30, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mask-image (см. https://caniuse.com/?search=mask-image), к сожалению, поддерживается только в современных браузерах

Если говорить о том, что это фича будет только для современных браузеров (a.k.a Graceful Degaration), то нужно сделать без лишних обёрток. Нужно будет доработать HorizontalScroll, чтобы можно было передавать класс туда, где сейчас styles.in.

И тогда всё будет очень просто:

<ScrollWrapper contentInClassName={style.inFade} />
.inFade {
  mask-image: linear-gradient(to right, transparent 0, black 20px, black calc(100% - 20px), transparent 100%);
  mask-repeat: no-repeat;
  mask-size: 100% 100%;
}

Copy link
Contributor Author

@fm-designer fm-designer Oct 31, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Нам нужно несколько классов, для того чтобы отображать тень. Так как в зависисмости от позиции прокрутки, тень может быть:

  • только слева
  • только справа
  • слева и справа

Copy link
Contributor

@inomdzhon inomdzhon Oct 31, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

В любом случае, я бы это сделал через текущую структуру на основе HorizontalScroll, без создания новой

Нам градиент прям большой нужен? Если делать размером в var(--vkui--size_base_padding_horizontal--regular) (оступы по бокам), то нет необходимости делать лишние вычисления

.inFade {
  mask-image: linear-gradient(to right, transparent 0, black var(--vkui--size_base_padding_horizontal--regular), black calc(100% - var(--vkui--size_base_padding_horizontal--regular)), transparent 100%);
  mask-repeat: no-repeat;
  mask-size: 100% 100%;
}

И всё, весь PR будет состоять только из styles.inFade и свойства withFade (хотя подумаю как иначе переименовать, на более семантичное)

Вот демо

2025-10-31.15.39.25.mov

}

.inFadeRight {
mask-image: linear-gradient(to right, rgb(0, 0, 0, 1) 90%, rgb(0, 0, 0, 0));
}

.inFadeLeft.inFadeRight {
mask-image: linear-gradient(
to right,
rgb(0, 0, 0, 0) 0%,
rgb(0, 0, 0, 1) 10%,
rgb(0, 0, 0, 1) 90%,
rgb(0, 0, 0, 0) 100%
);
}
63 changes: 52 additions & 11 deletions packages/vkui/src/components/SubnavigationBar/SubnavigationBar.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
'use client';

import * as React from 'react';
import { hasReactNode } from '@vkontakte/vkjs';
import { useCallback, useRef, useState } from 'react';
import { classNames, hasReactNode } from '@vkontakte/vkjs';
import type { HTMLAttributesWithRootRef } from '../../types';
import {
HorizontalScroll,
Expand All @@ -19,6 +22,10 @@ export interface SubnavigationBarProps
* Отключение возможности прокручивания компонента по горизонтали.
*/
fixed?: boolean;
/**
* Добавляет тень слева и справа при скролле.
*/
withFade?: boolean;
}

const defaultScrollToLeft: ScrollPositionHandler = (x) => x - 240;
Expand All @@ -30,6 +37,7 @@ const defaultScrollToRight: ScrollPositionHandler = (x) => x + 240;
*/
export const SubnavigationBar = ({
fixed = false,
withFade = false,
children,
showArrows = true,
getScrollToLeft = defaultScrollToLeft,
Expand All @@ -52,19 +60,52 @@ export const SubnavigationBar = ({
};
}

const scrollRef = useRef<HTMLDivElement>(null);
const [ isFadeLeft, setFadeLeft ] = useState(false);
const [ isFadeRight, setFadeRight ] = useState(false);

const scrollHandler = useCallback(() => {
if (!scrollRef.current) {
return;
}

setFadeLeft(scrollRef.current.scrollLeft !== 0);
setFadeRight(
!(scrollRef.current.clientWidth + scrollRef.current.scrollLeft >= scrollRef.current.scrollWidth)
);
}, []);

const renderScrollWrapper = () => (
<ScrollWrapper className={styles.in} {...scrollWrapperProps}>
<ul className={styles.scrollIn}>
{React.Children.map(children, (child, idx) =>
hasReactNode(child) ? (
<li key={idx} className={styles.item}>
{child}
</li>
) : null,
)}
</ul>
</ScrollWrapper>
);

return (
<RootComponent baseClassName={fixed && styles.modeFixed} {...restProps}>
<ScrollWrapper className={styles.in} {...scrollWrapperProps}>
<ul className={styles.scrollIn}>
{React.Children.map(children, (child, idx) =>
hasReactNode(child) ? (
<li key={idx} className={styles.item}>
{child}
</li>
) : null,
{withFade ? (
<div
className={classNames(
styles.in,
isFadeLeft && styles.inFadeLeft,
isFadeRight && styles.inFadeRight,
)}
</ul>
</ScrollWrapper>
>
<div ref={scrollRef} className={styles.scroll} onScroll={scrollHandler}>
<div className={styles.inFade}>{renderScrollWrapper()}</div>
</div>
</div>
) : (
renderScrollWrapper()
)}
</RootComponent>
);
};
Loading