An open source design system that's fully customizable and agent ready
TypeScript
feat(TabList): carousel overflow with arrow navigation (#1978)
Cindy Zhangb530311329b6
diff --git a/apps/storybook/stories/TabList.stories.tsx b/apps/storybook/stories/TabList.stories.tsxindex 683b5a400b..8c92fafbd2 100644--- a/apps/storybook/stories/TabList.stories.tsx+++ b/apps/storybook/stories/TabList.stories.tsx@@ -1,6 +1,7 @@import {useState} from 'react';import type {Meta, StoryObj} from '@storybook/react';import {XDSTabList, XDSTab, XDSTabMenu} from '@xds/core/TabList';+import {XDSCarousel} from '@xds/core/Carousel';import {XDSButton} from '@xds/core/Button';import {PlusIcon, FunnelIcon} from '@heroicons/react/24/outline';@@ -195,3 +196,54 @@ export const FillLayout: Story = {);},};++/**+ * When tabs overflow, wrap XDSTabList's children in XDSCarousel.+ * The Carousel handles scroll, fade masks, and arrow buttons.+ * Each tab keeps its intrinsic label width — no truncation.+ */+export const Overflow: Story = {+ render: () => {+ const [value, setValue] = useState('overview');+ return (+ <div style={{maxWidth: '400px', border: '1px dashed #ccc'}}>+ <XDSTabList value={value} onChange={setValue}>+ <XDSCarousel gap={0.5} hasSnap={false}>+ <XDSTab value="overview" label="Overview" />+ <XDSTab value="activity" label="Activity" />+ <XDSTab value="members" label="Members" />+ <XDSTab value="settings" label="Settings" />+ <XDSTab value="integrations" label="Integrations" />+ <XDSTab value="billing" label="Billing & Plans" />+ <XDSTab value="security" label="Security" />+ <XDSTab value="notifications" label="Notifications" />+ <XDSTab value="api" label="API Keys" />+ </XDSCarousel>+ </XDSTabList>+ </div>+ );+ },+};++/**+ * Overflow with divider — typical page header in a narrow viewport.+ */+export const OverflowWithDivider: Story = {+ render: () => {+ const [value, setValue] = useState('dashboard');+ return (+ <div style={{maxWidth: '350px'}}>+ <XDSTabList value={value} onChange={setValue} hasDivider size="lg">+ <XDSCarousel gap={0.5} hasSnap={false}>+ <XDSTab value="dashboard" label="Dashboard" />+ <XDSTab value="analytics" label="Analytics" />+ <XDSTab value="reports" label="Reports" />+ <XDSTab value="customers" label="Customers" />+ <XDSTab value="products" label="Products" />+ <XDSTab value="orders" label="Orders" />+ </XDSCarousel>+ </XDSTabList>+ </div>+ );+ },+};diff --git a/packages/core/src/Carousel/XDSCarousel.tsx b/packages/core/src/Carousel/XDSCarousel.tsxindex d444a22ec1..4085dd346f 100644--- a/packages/core/src/Carousel/XDSCarousel.tsx+++ b/packages/core/src/Carousel/XDSCarousel.tsx@@ -81,6 +81,9 @@ const styles = stylex.create({position: 'relative',display: 'flex',alignItems: 'center',+ minWidth: 0,+ maxWidth: '100%',+ overflowX: 'hidden',},scroller: {display: 'flex',diff --git a/packages/core/src/TabList/XDSTab.tsx b/packages/core/src/TabList/XDSTab.tsxindex e8933d3ec3..53cbde9c2a 100644--- a/packages/core/src/TabList/XDSTab.tsx+++ b/packages/core/src/TabList/XDSTab.tsx@@ -90,6 +90,7 @@ const styles = stylex.create({color: colorVars['--color-text-secondary'],cursor: 'pointer',textDecoration: 'none',+ whiteSpace: 'nowrap',transitionProperty: 'color',transitionDuration: durationVars['--duration-fast'],transitionTimingFunction: easeVars['--ease-standard'],diff --git a/packages/core/src/TabList/XDSTabList.tsx b/packages/core/src/TabList/XDSTabList.tsxindex 715b151597..db96e36926 100644--- a/packages/core/src/TabList/XDSTabList.tsx+++ b/packages/core/src/TabList/XDSTabList.tsx@@ -63,6 +63,8 @@ const styles = stylex.create({display: 'flex',alignItems: 'stretch',gap: spacingVars['--spacing-0-5'],+ maxWidth: '100%',+ minWidth: 0,},fill: {width: '100%',