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 — верхнеуровневый

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

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

PropsTabBarProps
PropTypeDefaultRequiredDescription
afterContentReactNode—noСлот действия: контент после списка табов — справа при горизонтальной ориентации, снизу при вертикальной. Разделитель проходит вдоль всей панели.
childrenReactElement<TabProps, string | JSXElementConstructor<any>>[]—yesКонтент (элементы Tabs.Tab)
classNamestring—noCSS-класс
data-test-idstring—no
dividerbooleantruenoПоказывать разделитель под/рядом с панелью табов
markerPosition"after" | "before"afternoПозиция маркера относительно таб-бара. Значения ориентационно-нейтральны, в Figma та же ось названа сторонами: `before` = Figma `top` (horizontal) / `left` (vertical), `after` = Figma `bottom` (horizontal) / `right` (vertical).
variant"primary" | "secondary"primarynoВариант панели: primary — верхнеуровневый, secondary — на уровне контента

Unions

Types

TabBarProps

Unions

Storybook

Figma