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.
Размеры
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
Период: 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>
);
}Перенос на новые строки
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
Props
TabsSegmentedProps| Prop | Type | Default | Required | Description |
|---|---|---|---|---|
appearance | "default" | "onAccent" | default | no | Оформление. |
className | string | — | no | CSS-класс корня. |
data-test-id | string | — | no | |
defaultValue | string | — | no | Значение вкладки, выбранной изначально (uncontrolled). По умолчанию — первая вкладка. |
items | TabsSegmentedItem[] | — | yes | Вкладки. |
onChange | ((value: string) => void) | — | no | Колбэк выбора вкладки. |
size | "l" | "m" | "s" | m | no | Размер. |
value | string | — | no | Значение выбранной вкладки (controlled). |
wrap | boolean | false | no | Переносить вкладки на новую строку. Без переноса ряд прокручивается по горизонтали. |