Un élément par vue : un slider pleine largeur depuis le même menu
min-width: 100% sur l’enveloppe d’élément de la bibliothèque — transforme le même composant en slider : chaque carte remplit la vue, et les flèches de pagination ordinaires avancent exactement d’un élément.Paginez avec les flèches — chaque diapositive fait exactement une vue de large, et chaque diapositive signale sa propre visibilité.
Modifier cet exemple en direct dans Storybook
Comment ça marche
La story enveloppe le menu dans un conteneur stylé ciblant .react-horizontal-scrolling-menu--item — le div que la bibliothèque rend autour de chaque enfant — et lui donne minWidth: ’100%’ plus un centrage flex. Chaque enveloppe couvre désormais tout le conteneur de défilement, donc une seule carte tient dans la vue. Les flèches sont standard : scrollPrev() et scrollNext() paginent par le groupe visible, et quand le groupe visible est un élément, une page et un élément sont la même chose.
Les flèches et la molette
L’état des flèches vient de useLeftArrowVisible() et useRightArrowVisible() — chacune renvoie true quand la rangée est à cette extrémité, et la story l’alimente dans disabled et estompe le bouton. La prop onWheel reçoit l’objet API avec l’événement, donc une molette verticale pagine la rangée par le signe de deltaY. Elle flaire d’abord les trackpads : tout delta horizontal, ou un delta vertical inférieur à 15, est supposé être un geste de trackpad et laissé au défilement natif.
Notes
itemIdsur chaque enfant est la seule exigence dure — c’est ainsi que les éléments sont suivis et vers quoi on défile.- Les cartes appellent toujours
useIsVisible(itemId, true); avec un élément par vue, chaque diapositive hors écran signalevisible: false. - La barre de défilement est masquée avec du CSS simple sur le conteneur de défilement (
scrollbar-width: noneplus le pseudo-élément WebKit) — ce choix est le vôtre, pas celui de la bibliothèque. - La largeur vit entièrement dans votre feuille de styles. Remplacez 100% par 50% et vous avez un slider de deux par vue ; la bibliothèque ne mesure rien.
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';
const WideItems = styled('div')({
'& .react-horizontal-scrolling-menu--item ': {
minWidth: '100%',
display: 'flex',
justifyContent: 'center',
},
});
export function OneItem() {
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 (
<WideItems>
<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>
</WideItems>
);
}
export default OneItem;
function LeftArrow() {
const visibility = React.useContext<publicApiType>(VisibilityContext);
const disabled = visibility.useLeftArrowVisible();
return (
<Arrow
disabled={disabled}
onClick={() => visibility.scrollPrev()}
testId="left-arrow"
>
Left
</Arrow>
);
}
function RightArrow() {
const visibility = React.useContext<publicApiType>(VisibilityContext);
const disabled = visibility.useRightArrowVisible();
return (
<Arrow
disabled={disabled}
onClick={() => visibility.scrollNext()}
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();
}
}