Abas roláveis além do MUI
value/onChange — e troca a faixa por baixo: rolagem nativa, uma seleção que se centraliza sozinha, abas que podem conter qualquer coisa.Clique em uma aba perto de qualquer borda — ela se centraliza sozinha. Arraste a linha, como num telefone.
Edite este exemplo ao vivo no Storybook
Mantenha o contrato value/onChange
O handleChange na fonte tem a assinatura exata do MUI — (event, newValue). Migrar significa trocar o markup, não reconectar o estado: seu useState, handlers e painéis de aba permanecem intocados. A seleção se centraliza sozinha com api.scrollToItem(el, ’smooth’, ’center’), ligada exatamente como em center-on-click.
Botões de rolagem que sobrevivem ao mobile
O MUI esconde seus botões de rolagem abaixo de 600px, a menos que você habilite com allowScrollButtonsMobile — e mesmo assim eles são internos ao Tabs. Aqui as setas são seus próprios componentes: useIsVisible(’first’) / useIsVisible(’last’) conduzem um fade de opacidade, elas renderizam em qualquer viewport, e a rolagem por toque é nativa independente do que as setas fazem.
Centralização e rolagem, juntas
No MUI, a prop centered e a variante scrollable são mutuamente exclusivas — a documentação manda escolher uma. Aqui centralizar não é um modo de layout, mas uma rolagem por clique, então a faixa é as duas coisas ao mesmo tempo: ela transborda nativamente e cada aba selecionada desliza para o meio.
Abas que param de ser abas
Duas abas na demo carregam badges de contagem; chips, avatares ou conteúdo misto funcionam do mesmo jeito — o único requisito é um itemId. Estilize com @emotion/styled como a fonte faz, com o próprio styled() do MUI para se encaixar num app Material, ou com Tailwind. A demo acima adiciona arraste para rolar; restaurar a aba selecionada ao montar é salvar e restaurar posição.
Notas
- Escolha seu padrão ARIA: mantenha
role="tablist"/role="tab"/aria-selectedquando painéis reais forem trocados (como aqui), ouaria-currentquando as "abas" forem links de navegação. - Com o arraste habilitado, suprima o clique que dispara ao soltar o arraste — a demo verifica
dragManager.draggingantes de selecionar, assim como na receita de arraste. - RTL não exige trabalho extra: a faixa é um contêiner de rolagem nativo, então
direction: rtla inverte, setas incluídas.
Fonte completa
Completa e pronta para copiar e colar — este é o arquivo exato por trás da versão do Storybook editável ao vivo.
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 TABS = [
{ value: 'overview', label: 'Overview' },
{ value: 'analytics', label: 'Analytics' },
{ value: 'reports', label: 'Reports', count: 12 },
{ value: 'campaigns', label: 'Campaigns' },
{ value: 'audiences', label: 'Audiences' },
{ value: 'attribution', label: 'Attribution' },
{ value: 'conversions', label: 'Conversions', count: 3 },
{ value: 'realtime', label: 'Realtime' },
{ value: 'integrations', label: 'Integrations' },
{ value: 'settings', label: 'Settings' },
];
// role="tab" needs a tablist ancestor; the scroll container is exactly
// that, reached through the containerRef prop.
const tablistRef = (el: HTMLElement | null) => {
if (el) {
el.setAttribute('role', 'tablist');
el.setAttribute('aria-label', 'Sections');
}
};
export function MuiTabs() {
const [value, setValue] = React.useState(TABS[0].value);
// Same contract as MUI <Tabs onChange>: (event, newValue).
const handleChange = (
_event: React.SyntheticEvent | null,
newValue: string,
) => setValue(newValue);
return (
<Root>
<ScrollMenu
LeftArrow={LeftArrow}
RightArrow={RightArrow}
containerRef={tablistRef}
>
{TABS.map((tab) => (
<Tab
key={tab.value}
itemId={tab.value} // NOTE: itemId is required for track items
tab={tab}
selected={value === tab.value}
onSelect={(event) => handleChange(event, tab.value)}
/>
))}
</ScrollMenu>
</Root>
);
}
export default MuiTabs;
function Tab({
itemId,
tab,
selected,
onSelect,
}: {
itemId: string;
tab: (typeof TABS)[number];
selected: boolean;
onSelect: (event: React.SyntheticEvent) => void;
}) {
const api = React.useContext<publicApiType>(VisibilityContext);
const select = (event: React.SyntheticEvent) => {
onSelect(event);
const el = api.getItemElementById(itemId);
// The behavior MUI cannot combine with `scrollable`: center the
// selected tab, revealing its neighbors on both sides.
if (el) api.scrollToItem(el, 'smooth', 'center');
};
return (
<TabButton
type="button"
role="tab"
aria-selected={selected}
selected={selected}
onClick={select}
onKeyDown={(ev: React.KeyboardEvent) => {
ev.code === 'Enter' && select(ev);
}}
>
{tab.label}
{tab.count !== undefined && <Badge>{tab.count}</Badge>}
</TabButton>
);
}
function LeftArrow() {
const visibility = React.useContext<publicApiType>(VisibilityContext);
const isFirstItemVisible = visibility.useIsVisible('first', true);
return (
<ArrowButton
type="button"
hidden={isFirstItemVisible}
aria-label="Scroll tabs left"
onClick={() => visibility.scrollPrev()}
>
‹
</ArrowButton>
);
}
function RightArrow() {
const visibility = React.useContext<publicApiType>(VisibilityContext);
const isLastItemVisible = visibility.useIsVisible('last', false);
return (
<ArrowButton
type="button"
hidden={isLastItemVisible}
aria-label="Scroll tabs right"
onClick={() => visibility.scrollNext()}
>
›
</ArrowButton>
);
}
// MUI's own tab metrics: uppercase 14px labels, 48px height, a 2px
// primary indicator. Swap the styled() calls for your theme's — nothing
// below depends on these exact values.
const PRIMARY = '#1976d2';
const Root = styled('div')({
fontFamily: 'Roboto, Helvetica, Arial, sans-serif',
borderBottom: '1px solid rgba(0, 0, 0, 0.12)',
});
const TabButton = styled('button')<{ selected?: boolean }>((props) => ({
appearance: 'none',
border: 'none',
background: 'none',
cursor: 'pointer',
minWidth: '90px',
minHeight: '48px',
padding: '12px 16px',
display: 'inline-flex',
alignItems: 'center',
gap: '8px',
textTransform: 'uppercase',
fontSize: '0.875rem',
fontWeight: 500,
letterSpacing: '0.02857em',
whiteSpace: 'nowrap',
userSelect: 'none',
color: props.selected ? PRIMARY : 'rgba(0, 0, 0, 0.6)',
boxShadow: props.selected ? `inset 0 -2px 0 0 ${PRIMARY}` : 'none',
transition: 'color 0.2s, box-shadow 0.2s',
'&:hover': {
color: props.selected ? PRIMARY : 'rgba(0, 0, 0, 0.87)',
},
}));
const Badge = styled('span')({
background: PRIMARY,
color: 'white',
borderRadius: '10px',
padding: '1px 7px',
fontSize: '0.75rem',
});
// Unlike MUI's scroll buttons, these are plain components you own — they
// render on every viewport (MUI hides its buttons below 600px) and fade
// out at the edges via useIsVisible instead of unmounting.
const ArrowButton = styled('button')<{ hidden?: boolean }>((props) => ({
appearance: 'none',
border: 'none',
background: 'none',
cursor: props.hidden ? 'default' : 'pointer',
width: '40px',
fontSize: '1.5rem',
color: 'rgba(0, 0, 0, 0.54)',
opacity: props.hidden ? 0 : 1,
pointerEvents: props.hidden ? 'none' : 'auto',
transition: 'opacity 0.2s',
}));