Components/Layout/CardFolderTabs
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/cardfoldertabs
Card folder tabs allow users to organize content by a certain criteria in a card layout.
<Tabs/> instead.This component is composed of a <CardFolderTabs> wrapper that holds any number of <CardFolderTabs.Tab/> items inside of it. You can specify content for each tab separately.
Specify maximum allowed tab width in pixels or percentage with `maxTabWidth` prop. Stretch tabs equally to fill the full width of a card with `fluid` prop.
Initially all tab buttons are sized to be equal with a maximum width of 138px. Set `maxTabWidth` value to "fit-content" to size them to match title width.
Restrict users from opening a certain tab with `disabled` prop.
Customize the tab title by overriding default text string value of `name` prop to any required components or their composition.
Control text overflow with `ellipsis` prop. By default, tab titles that exceed `maxTabWidth` will be truncated and displayed in a tooltip when the user hover over a tab. Set `ellipsis` to false to enable text wrapping.
Use section <EmptyState/> as tab content when there's no data to display.
| Name | Type | Default | Description |
|---|---|---|---|
activeId (required) | string | — | Specifies an id of a currently visible tab. |
children | ReactNode | — | Sets the tabs of the card, as CardFolderTabs.Tab elements. |
dataHook | string | — | Applies a data-hook HTML attribute that can be used in the tests. |
ellipsis | boolean | true | Specifies whether text that exceeds tab width is truncated with ellipsis. If false, text wraps to another line. Has no effect when mobile is enabled on <WixDesignSystemProvider/>, where labels never truncate or wrap. |
fluid | boolean | false | Stretches tabs to fill a 100% of a parent container width. |
maxTabWidth | string | number | string & {} | '138px' | Defines a maximum width of a tab button. Ignored when mobile is enabled on <WixDesignSystemProvider/>, where tabs keep their full width and the row scrolls horizontally. |
onTabChange | (newActiveId: string) => void | — | Defines a callback function which is called on tab change. An id of a newly selected tab is passed as a parameter. |
size | "small" | "medium" | 'medium' | Controls tab label font size. |
Import the driver matching your test environment:
| Method | Description |
|---|---|
isTabDisabledById | Checks whether tab is disabled by id |
selectTabById | Selects tab by tab by id |
getSize | Return tab text size |
exists | Checks whether the component found with the given data hook. |
element | Gets the component root element. |
click | Clicks on the component root element. |
base | Returns UniDriver for the base element. |
WixDesignSystemProvider with mobile) the tab row scrolls horizontally instead of squeezing labels. Tabs keep their full label width, selecting a tab scrolls it to the start of the row with the previous tab peeking, and a fade marks the edges that still hide tabs. The scroll is smooth, or instant when the user prefers reduced motion. Desktop is unchanged. (#17333) — has visual changesLast updated: 30 October 2026