Skip to content

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.tsx
index 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.tsx
index 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.tsx
index 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.tsx
index 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%',