TabBar
Панель переключателей табов. Задаёт:
variant—primary(по умолчанию, верхнеуровневый) илиsecondary(внутри контента).- Ориентация задаётся через
Tabs.orientation:horizontal(по умолчанию) илиvertical. markerPosition— позиция активного маркера (before/after).afterContent— действие справа от горизонтального списка или снизу от вертикального. При отсутствии содержимого вся обёртка скрыта; разделитель проходит вдоль всей панели.
При переполнении появляются кнопки прокрутки: слева/справа для горизонтальной панели и сверху/снизу для вертикальной. У достигнутого края кнопка скрывается. Для вертикальной прокрутки контейнеру Tabs нужна ограниченная высота, например родитель с height: 240px.
Когда использовать
- Внутри
Tabsкак единственный контейнер списка кнопок-табов. - Если нужно разместить дополнительные действия справа от табов (через слот
afterContent).
Анатомия
Orientation
horizontal — бар в строку, vertical — колонкой.
Variant
primary — по умолчанию, secondary — для навигации внутри контента.
Marker position
Положение активного маркера относительно содержимого таба: before — перед, after — после.
Установка
pnpm add @cloud-ru/ds-tabs
import { Tabs } from '@cloud-ru/ds-tabs'
<Tabs.TabBar />
Примеры использования
Primary — верхнеуровневый
tsx
import { Tabs, VARIANT } from '@cloud-ru/ds-tabs';
export function Primary() {
return (
<Tabs defaultValue='a'>
<Tabs.TabBar variant={VARIANT.Primary}>
<Tabs.Tab value='a' label='Первая' />
<Tabs.Tab value='b' label='Вторая' />
</Tabs.TabBar>
</Tabs>
);
}Vertical orientation
tsx
import { ORIENTATION, Tabs } from '@cloud-ru/ds-tabs';
export function Vertical() {
return (
<Tabs defaultValue='a' orientation={ORIENTATION.Vertical}>
<Tabs.TabBar>
<Tabs.Tab value='a' label='Профиль' />
<Tabs.Tab value='b' label='Безопасность' />
</Tabs.TabBar>
</Tabs>
);
}Props
Types
Props
TabBarProps| Prop | Type | Default | Required | Description |
|---|---|---|---|---|
afterContent | ReactNode | — | no | Слот действия: контент после списка табов — справа при горизонтальной ориентации, снизу при вертикальной. Разделитель проходит вдоль всей панели. |
children | ReactElement<TabProps, string | JSXElementConstructor<any>>[] | — | yes | Контент (элементы Tabs.Tab) |
className | string | — | no | CSS-класс |
data-test-id | string | — | no | |
divider | boolean | true | no | Показывать разделитель под/рядом с панелью табов |
markerPosition | "after" | "before" | after | no | Позиция маркера относительно таб-бара. Значения ориентационно-нейтральны, в Figma та же ось названа сторонами: `before` = Figma `top` (horizontal) / `left` (vertical), `after` = Figma `bottom` (horizontal) / `right` (vertical). |
variant | "primary" | "secondary" | primary | no | Вариант панели: primary — верхнеуровневый, secondary — на уровне контента |