TabsSegmented

Горизонтальные вкладки сайта: подписи стоят вплотную в общей обводке, выбранная вкладка залита. Используются в секциях сайта (@cloud-ru/ds-site-section) и отдельно.

Когда использовать

  • Переключение 2–7 разделов контента на странице сайта.
  • Переключение периода или режима над списком или графиком.

Когда не нужен:

  • Навигация внутри приложения консоли:
    • используйте Tabs из @cloud-ru/ds-tabs.
  • Выбор значения в форме:
    • используйте SegmentControl из @cloud-ru/ds-segment-control.

Анатомия

Каждая вкладка — кнопка с подписью. Обводка общая: на стыке соседних вкладок и рядов линия одна. Выбранная вкладка залита, её обводка — цвета заливки.

Size (default m)

  • s — отступы 6 / 12, текст thin/body/m.
  • m — отступы 8 / 16, текст thin/body/l.
  • l — отступы 12 / 20, текст thin/body/l.

Размеры

Размерыs, m, l
tsx
import { TabsSegmented } from '@cloud-ru/ds-site-tabs-segmented';

const ITEMS = [
  { value: 'infrastructure', label: 'Инфраструктура' },
  { value: 'data', label: 'Данные' },
  { value: 'ai', label: 'AI' },
];

export function Sizes() {
  return (
    <div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
      <TabsSegmented items={ITEMS} size='s' />
      <TabsSegmented items={ITEMS} size='m' />
      <TabsSegmented items={ITEMS} size='l' />
    </div>
  );
}

Appearance (default default)

  • default — по теме страницы: на светлом фоне выбранная вкладка тёмная, на тёмном — светлая.
  • onAccent — для тёмного акцентного фона: ряд всегда в тёмной теме, выбранная вкладка залита акцентным цветом бренда.

Wrap (default false)

  • false — ряд в одну строку, при нехватке ширины прокручивается по горизонтали.
  • true — вкладки переносятся на новые строки.

Клавиатура

  • Tab — фокус на выбранную вкладку; в порядке Tab весь ряд — одна остановка.
  • ← / → — фокус на соседнюю вкладку по кругу, недоступные пропускаются.
  • Home / End — фокус на первую / последнюю доступную вкладку.
  • Enter / Space — выбрать вкладку в фокусе.

Имя ряда для экранных дикторов задаётся атрибутом aria-label или aria-labelledby — он передаётся на элемент tablist.

Установка

pnpm add @cloud-ru/ds-site-tabs-segmented
import { TabsSegmented } from '@cloud-ru/ds-site-tabs-segmented'

Примеры использования

Controlled

Controlledvalue и onChange, недоступная вкладка
Период: quarter
tsx
import { TabsSegmented } from '@cloud-ru/ds-site-tabs-segmented';
import { useState } from 'react';

const ITEMS = [
  { value: 'month', label: 'Месяц' },
  { value: 'quarter', label: 'Квартал' },
  { value: 'year', label: 'Год' },
  { value: 'archive', label: 'Архив', disabled: true },
];

export function Controlled() {
  const [period, setPeriod] = useState('quarter');

  return (
    <div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
      <TabsSegmented items={ITEMS} value={period} onChange={setPeriod} />
      <span>Период: {period}</span>
    </div>
  );
}

Перенос на новые строки

Перенос на новые строкиwrap
tsx
import { TabsSegmented } from '@cloud-ru/ds-site-tabs-segmented';

const ITEMS = [
  'Инфраструктура',
  'Данные',
  'Искусственный интеллект',
  'Безопасность',
  'Сеть',
  'Хранилища',
  'Аналитика',
  'Разработка',
  'Мониторинг',
  'Поддержка',
].map(label => ({ value: label, label }));

export function Wrap() {
  return <TabsSegmented items={ITEMS} wrap />;
}

Без value компонент хранит выбор сам, изначально выбрана вкладка из defaultValue или первая.

Props

Types

PropsTabsSegmentedProps
PropTypeDefaultRequiredDescription
appearance"default" | "onAccent"defaultnoОформление.
classNamestring—noCSS-класс корня.
data-test-idstring—no
defaultValuestring—noЗначение вкладки, выбранной изначально (uncontrolled). По умолчанию — первая вкладка.
itemsTabsSegmentedItem[]—yesВкладки.
onChange((value: string) => void)—noКолбэк выбора вкладки.
size"l" | "m" | "s"mnoРазмер.
valuestring—noЗначение выбранной вкладки (controlled).
wrapbooleanfalsenoПереносить вкладки на новую строку. Без переноса ряд прокручивается по горизонтали.

Unions

Types

TabsSegmentedProps

Unions

Storybook

Figma