Défiler d’un élément à la fois au lieu d’une page entière
onClick de la flèche appelle. Même menu, mêmes éléments, cible de défilement différente.Cliquez sur une flèche — la rangée avance d’une carte, pas d’une page. Les flèches se désactivent aux extrémités.
Modifier cet exemple en direct dans Storybook
Comment ça marche
getNextElement() renvoie le premier élément au-delà du groupe visible ; getPrevElement() celui juste avant. La flèche droite appelle scrollToItem(visibility.getNextElement(), ’smooth’, ’end’) — aligner cet élément avec le bord final du conteneur fait défiler juste assez pour l’amener à la vue, ce qui bouge la rangée d’exactement une carte. La flèche gauche est son miroir : élément précédent, aligné sur ’start’.
L’alignement est tout le truc
Le scrollNext() standard résout le même élément suivant en interne, mais l’aligne sur le bord initial — la vue défile au-delà de tout le groupe visible pour mettre cet élément en premier. Un argument ScrollLogicalPosition est la différence entre paginer et faire des pas. Le troisième paramètre de scrollToItem est l’alignement inline standard du scroll-into-view ; le deuxième est le comportement, ici ’smooth’.
Notes
- L’état des flèches utilise les raccourcis
’first’et’last’:useIsVisible(’first’, true)désactive la flèche gauche au début,useIsVisible(’last’, false)la droite à la fin. - Aux extrémités,
getNextElement()renvoie undefined etscrollToItemne fait rien en silence, donc une flèche activée ne peut toujours pas défiler en trop. - Le gestionnaire
onWheelde la story pagine encore une vue entière par cran de molette — faire des pas est le comportement des flèches, pas un mode global. - Les clics d’élément restent intacts : les cartes basculent la sélection via leur propre
onClick, indépendant de la façon dont les flèches défilent.
Source complète
Complète et prête à copier-coller — c’est le fichier exact derrière la version Storybook modifiable en direct.
import 'react-horizontal-scrolling-menu/dist/styles.css';
import styled from '@emotion/styled';
import React from 'react';
import {
type publicApiType,
ScrollMenu,
VisibilityContext,
} from 'react-horizontal-scrolling-menu';
export function OneItemScroll() {
const [items] = React.useState(() => getItems());
const [selected, setSelected] = React.useState<string[]>([]);
const isItemSelected = (id: string): boolean =>
!!selected.find((el) => el === id);
const handleItemClick = (itemId: string) => {
const itemSelected = isItemSelected(itemId);
setSelected((currentSelected: string[]) =>
itemSelected
? currentSelected.filter((el) => el !== itemId)
: currentSelected.concat(itemId),
);
};
return (
<NoScrollbar>
<ScrollMenu
LeftArrow={LeftArrow}
RightArrow={RightArrow}
onWheel={onWheel}
>
{items.map(({ id }) => (
<Card
title={id}
itemId={id} // NOTE: itemId is required for track items
key={id}
onClick={() => handleItemClick(id)}
selected={isItemSelected(id)}
/>
))}
</ScrollMenu>
</NoScrollbar>
);
}
export default OneItemScroll;
function LeftArrow() {
const visibility = React.useContext<publicApiType>(VisibilityContext);
const isFirstItemVisible = visibility.useIsVisible('first', true);
// NOTE: Look here
const onClick = () =>
visibility.scrollToItem(visibility.getPrevElement(), 'smooth', 'start');
return (
<Arrow disabled={isFirstItemVisible} onClick={onClick} testId="left-arrow">
Left
</Arrow>
);
}
function RightArrow() {
const visibility = React.useContext<publicApiType>(VisibilityContext);
const isLastItemVisible = visibility.useIsVisible('last', false);
// NOTE: Look here
const onClick = () =>
visibility.scrollToItem(visibility.getNextElement(), 'smooth', 'end');
return (
<Arrow disabled={isLastItemVisible} onClick={onClick} testId="right-arrow">
Right
</Arrow>
);
}
const NoScrollbar = styled('div')({
'& .react-horizontal-scrolling-menu--scroll-container::-webkit-scrollbar': {
display: 'none',
},
'& .react-horizontal-scrolling-menu--scroll-container': {
scrollbarWidth: 'none',
'-ms-overflow-style': 'none',
},
});
function Arrow({
children,
disabled,
onClick,
className,
testId,
}: {
children: React.ReactNode;
disabled: boolean;
onClick: VoidFunction;
className?: string;
testId: string;
}) {
return (
<ArrowButton
disabled={disabled}
onClick={onClick}
className={'arrow' + `-${className}`}
data-testid={testId}
>
{children}
</ArrowButton>
);
}
const ArrowButton = styled('button')((props) => ({
cursor: 'pointer',
display: 'flex',
flexDirection: 'column',
justifyContent: 'center',
marginBottom: '2px',
opacity: props.disabled ? '0' : '1',
userSelect: 'none',
borderRadius: '6px',
borderWidth: '1px',
}));
function Card({
onClick,
selected,
title,
itemId,
}: {
onClick: (context: publicApiType) => void;
selected: boolean;
title: string;
itemId: string;
}) {
const visibility = React.useContext<publicApiType>(VisibilityContext);
const isVisible = visibility.useIsVisible(itemId, true);
return (
<CardBody
data-cy={itemId}
onClick={() => onClick(visibility)}
onKeyDown={(ev: React.KeyboardEvent) => {
ev.code === 'Enter' && onClick(visibility);
}}
data-testid="card"
role="button"
tabIndex={0}
className="card"
visible={isVisible}
selected={selected}
>
<div className="header">
<div>{title}</div>
<div className="visible">visible: {JSON.stringify(isVisible)}</div>
<div className="selected">selected: {JSON.stringify(!!selected)}</div>
</div>
<div className="background" />
</CardBody>
);
}
const CardBody = styled('div')<{ selected?: boolean; visible?: boolean }>(
(props) => ({
border: '1px solid',
display: 'inline-block',
margin: '0 10px',
width: '160px',
userSelect: 'none',
borderRadius: '8px',
overflow: 'hidden',
'& .header': {
backgroundColor: 'white',
},
'& .visible': {
backgroundColor: props.visible ? 'transparent' : 'gray',
},
'& .background': {
backgroundColor: props.selected ? 'green' : 'bisque',
height: '200px',
},
}),
);
const getId = (index: number) => `${'test'}${index}`;
const getItems = () =>
Array(10)
.fill(0)
.map((_, ind) => ({ id: getId(ind) }));
function onWheel(apiObj: publicApiType, ev: React.WheelEvent): void {
// NOTE: no good standart way to distinguish touchpad scrolling gestures
// but can assume that gesture will affect X axis, mouse scroll only Y axis
// of if deltaY too small probably is it touchpad
const isThouchpad = Math.abs(ev.deltaX) !== 0 || Math.abs(ev.deltaY) < 15;
if (isThouchpad) {
ev.stopPropagation();
return;
}
if (ev.deltaY < 0) {
apiObj.scrollNext();
} else {
apiObj.scrollPrev();
}
}