SectionBasic
Базовая секция страницы сайта. Задаёт фоны, отступы и вертикальный ритм, собирает типовые блоки по данным: заголовок, вкладки, фильтры и футер. Содержимое между фильтрами и футером передаётся через children.
Когда использовать
- Типовой блок лендинга или каталога: заголовок, контент, «Показать еще».
- Список с переключением вкладками и фильтрацией по полям.
Когда не нужен:
- Вёрстка внутри приложения консоли:
- используйте компоненты
@ds/uikit-product-*.
- используйте компоненты
Анатомия
У секции два фона:
- внешний — во всю ширину экрана;
- блок — по ширине
container, по центру внешнего фона. В блоке лежит всё содержимое.
Блоки содержимого сверху вниз, каждый рендерится только при наличии данных:
- Заголовок —
SectionTitleиз@cloud-ru/ds-site-section-title, типdescriptionRight:descriptionсправа отtitleна desktop и под ним на tablet/mobile. Строки могут содержать HTML-разметку (рендерятся через@cloud-ru/ds-site-rich-text, который очищает HTML от XSS). - Вкладки —
tabBarItems, рендерятся какTabsSegmentedиз@cloud-ru/ds-site-tabs-segmented. Выбор:- без
tabBarValueхранится внутри секции, изначально —defaultTabBarValueили первая доступная вкладка; - с
tabBarValue+onTabBarChangeуправляется снаружи, например из параметра URL?tab=ai.
- без
- Фильтры —
filterItems, поляFieldSelectразмераl. Делят ширину поровну и переносятся на новую строку. - Контент —
children. - Футер —
paginationиmoreButton. Текст кнопки по умолчанию — «Показать еще» из локали пакета.
Container (обязательный)
Временная настройка на период редизайна: задаётся явно в каждом месте использования.
new— целевой вид: блок до 1824 px, отступы меньше.old— визуальная совместимость со страницами до редизайна: блок до 1408 px (контент 1216 px), отступы как в прежней секции.
Фоны
У секции два слоя, у каждого своя тема и заливка:
background— внешний слой во всю ширину экрана (FigmasectionBackground):theme— тема слоя. Не задана — тема страницы.fill— заливка изSECTION_BACKGROUND_FILL(defaultneutralBackground).
containerBackground— блок по ширинеcontainer, в нём всё содержимое (FigmacontentWrapper+bgLocal):theme— тема блока и содержимого. Не задана — тема внешнего слоя.type— вид заливки (defaultbg).
theme принимает те же оси, что ChildThemeProvider из @cloud-ru/ds-theme (colorScheme, brand и другие), поэтому блок может быть тёмным на светлом фоне и наоборот.
Заливка блока по type:
bg— подложка изSECTION_BACKGROUND_FILL, полеfill(defaultneutralBackground).image— картинка во весь блок, полеsrc. Картинка декоративная и кадрируется по размеру блока.accent— акцентный цвет бренда.
Значения SECTION_BACKGROUND_FILL:
neutralBackground— нейтральный фон страницы.neutralBackground1Level— светлая нейтральная подложка.primaryBackground,redBackground,orangeBackground,yellowBackground,greenBackground,blueBackground,violetBackground,pinkBackground— цветные подложки.transparent,decorTransparent— прозрачные подложки.
Тег заголовка (default h2)
titleTag — h1, h2, h3 или h4.
Установка
pnpm add @cloud-ru/ds-site-section
import { SectionBasic } from '@cloud-ru/ds-site-section'
Примеры использования
Заголовок и контент
Облачные сервисы
Произвольный контент секции: карточки, сетка, карусель.
import { SectionBasic } from '@cloud-ru/ds-site-section';
export function TitleAndContent() {
return (
<SectionBasic container='new' title='Облачные сервисы' description='Инфраструктура, данные и AI в одном облаке.'>
<p>Произвольный контент секции: карточки, сетка, карусель.</p>
</SectionBasic>
);
}Вкладки и фильтры
Каталог
Выбрана категория: all
import { SectionBasic } from '@cloud-ru/ds-site-section';
import { useState } from 'react';
const TABS = [
{ value: 'infrastructure', label: 'Создание инфраструктуры' },
{ value: 'data', label: 'Данные' },
{ value: 'ai', label: 'Искусственный интеллект' },
];
const ITEMS = [
{ id: 'all', content: { label: 'Все' } },
{ id: 'popular', content: { label: 'Популярные' } },
{ id: 'new', content: { label: 'Новые' } },
];
export function TabsAndFilters() {
const [category, setCategory] = useState('all');
return (
<SectionBasic
container='new'
title='Каталог'
tabBarItems={TABS}
filterItems={[
{
id: 'category',
label: 'Категория',
items: ITEMS,
value: category,
onChange: value => setCategory(String(value ?? 'all')),
},
]}
>
<p>Выбрана категория: {category}</p>
</SectionBasic>
);
}Вкладка из URL
Каталог
Выбрана вкладка: ai
import { SectionBasic } from '@cloud-ru/ds-site-section';
import { useState } from 'react';
const TABS = [
{ value: 'infrastructure', label: 'Создание инфраструктуры' },
{ value: 'data', label: 'Данные' },
{ value: 'ai', label: 'Искусственный интеллект' },
];
export function ControlledTabs() {
// На странице начальное значение берётся из параметра URL, например `/catalog?tab=ai`.
const [tab, setTab] = useState('ai');
return (
<SectionBasic container='new' title='Каталог' tabBarItems={TABS} tabBarValue={tab} onTabBarChange={setTab}>
<p>Выбрана вкладка: {tab}</p>
</SectionBasic>
);
}Футер
Новости
Страница 1, показано новостей: 3
import { SectionBasic } from '@cloud-ru/ds-site-section';
import { useState } from 'react';
export function Footer() {
const [page, setPage] = useState(1);
const [shown, setShown] = useState(3);
return (
<SectionBasic
container='new'
title='Новости'
pagination={{ total: 5, page, onChange: setPage }}
moreButton={{ onClick: () => setShown(count => count + 3) }}
>
<p>
Страница {page}, показано новостей: {shown}
</p>
</SectionBasic>
);
}Тёмный блок на светлом фоне
Облачные сервисы
Контент секции
import { SectionBasic } from '@cloud-ru/ds-site-section';
export function ContainerTheme() {
return (
<SectionBasic
container='new'
background={{ theme: { colorScheme: 'light' } }}
containerBackground={{ type: 'bg', theme: { colorScheme: 'dark' } }}
title='Облачные сервисы'
description='Блок по ширине container тёмный, внешний фон остаётся светлым.'
tabBarItems={[
{ value: 'infrastructure', label: 'Инфраструктура' },
{ value: 'data', label: 'Данные' },
]}
>
<p>Контент секции</p>
</SectionBasic>
);
}Акцентный блок
Облачные сервисы
Контент секции
import { SectionBasic } from '@cloud-ru/ds-site-section';
export function AccentContainer() {
return (
<SectionBasic
container='new'
containerBackground={{ type: 'accent' }}
title='Облачные сервисы'
description='Блок по ширине container залит акцентным цветом бренда.'
>
<p>Контент секции</p>
</SectionBasic>
);
}Заливки слоёв
Облачные сервисы
Контент секции
import { SectionBasic } from '@cloud-ru/ds-site-section';
export function BackgroundFill() {
return (
<SectionBasic
container='new'
background={{ fill: 'blueBackground' }}
containerBackground={{ type: 'bg', fill: 'neutralBackground1Level' }}
title='Облачные сервисы'
description='Голубой внешний фон и светлая подложка блока.'
>
<p>Контент секции</p>
</SectionBasic>
);
}Совместимость со страницами до редизайна
Облачные сервисы
Контент секции
import { SectionBasic } from '@cloud-ru/ds-site-section';
export function OldContainer() {
return (
<SectionBasic container='old' title='Облачные сервисы' description='Отступы и ширина страниц до редизайна.'>
<p>Контент секции</p>
</SectionBasic>
);
}Props
Types
SectionBasicProps| Prop | Type | Default | Required | Description |
|---|---|---|---|---|
background | SectionBackground | — | no | Внешний слой фона во всю ширину экрана (Figma `sectionBackground`): тема и заливка. |
children | ReactNode | — | no | Содержимое секции между фильтрами и футером. |
className | string | — | no | CSS-класс корня. |
container | "new" | "old" | — | yes | Ширина и отступы секции: `new` — целевой вид, `old` — совместимость со страницами до редизайна. Временная настройка на период реди зайна, задаётся явно. |
containerBackground | SectionContainerBackground | { type: SECTION_CONTAINER_BACKGROUND_TYPE.Bg } | no | Блок по ширине `container` (Figma `contentWrapper` + `bgLocal`): тема блока и всего содержимого и заливка — подложка, картинка или акцентный цвет. Тема не задана — тема внешнего слоя. |
data-test-id | string | — | no | |
defaultTabBarValue | string | — | no | Изначально выбранная вкладка (uncontrolled). |
description | string | — | no | Описание. Строка может содержать HTML-разметку. |
filterItems | FieldSelectProps[] | — | no | Поля-фильтры под вкладками. Рендерятся как `FieldSelect` размера `l`. |
id | string | — | no | HTML-атрибут `id` секции — якорь для навигации по странице. |
moreButton | SectionMoreButton | — | no | Кнопка «Показать еще» в футере. |
onTabBarChange | ((value: string) => void) | — | no | Колбэк выбора вкладки: значение `value` выбранного элемента `tabBarItems`. |
pagination | PaginationProps | — | no | Пагинация в футере. |
tabBarItems | TabsSegmentedItem[] | — | no | Вкладки под заголовком. Без `tabBarValue` / `defaultTabBarValue` изнача льно выбрана первая доступная. |
tabBarValue | string | — | no | Выбранная вкладка (controlled), например из параметра URL `?tab=ai`. |
title | string | — | no | Заголовок. Строка может содержать строчную HTML-разметку (`a`, `strong`, `em`, `br`). |
titleTag | "h1" | "h2" | "h3" | "h4" | — | no | Тег заголовка. |