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 — внешний слой во всю ширину экрана (Figma sectionBackground):
    • theme — тема слоя. Не задана — тема страницы.
    • fill — заливка из SECTION_BACKGROUND_FILL (default neutralBackground).
  • containerBackground — блок по ширине container, в нём всё содержимое (Figma contentWrapper + bgLocal):
    • theme — тема блока и содержимого. Не задана — тема внешнего слоя.
    • type — вид заливки (default bg).

theme принимает те же оси, что ChildThemeProvider из @cloud-ru/ds-theme (colorScheme, brand и другие), поэтому блок может быть тёмным на светлом фоне и наоборот.

Заливка блока по type:

  • bg — подложка из SECTION_BACKGROUND_FILL, поле fill (default neutralBackground).
  • 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'

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

Заголовок и контент

Заголовок и контентtitle, description и children

Облачные сервисы

Инфраструктура, данные и AI в одном облаке.

Произвольный контент секции: карточки, сетка, карусель.

tsx
import { SectionBasic } from '@cloud-ru/ds-site-section';

export function TitleAndContent() {
  return (
    <SectionBasic container='new' title='Облачные сервисы' description='Инфраструктура, данные и AI в одном облаке.'>
      <p>Произвольный контент секции: карточки, сетка, карусель.</p>
    </SectionBasic>
  );
}

Вкладки и фильтры

Вкладки и фильтрыtabBarItems и filterItems

Каталог

Выбрана категория: all

tsx
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

Вкладка из URLtabBarValue и onTabBarChange

Каталог

Выбрана вкладка: ai

tsx
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>
  );
}

Футер

Футерpagination и moreButton

Новости

Страница 1, показано новостей: 3

tsx
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>
  );
}

Тёмный блок на светлом фоне

Тёмный блок на светлом фонеbackground.theme и containerBackground.theme

Облачные сервисы

Блок по ширине container тёмный, внешний фон остаётся светлым.

Контент секции

tsx
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>
  );
}

Акцентный блок

Акцентный блокcontainerBackground={{ type: 'accent' }}

Облачные сервисы

Блок по ширине container залит акцентным цветом бренда.

Контент секции

tsx
import { SectionBasic } from '@cloud-ru/ds-site-section';

export function AccentContainer() {
  return (
    <SectionBasic
      container='new'
      containerBackground={{ type: 'accent' }}
      title='Облачные сервисы'
      description='Блок по ширине container залит акцентным цветом бренда.'
    >
      <p>Контент секции</p>
    </SectionBasic>
  );
}

Заливки слоёв

Заливки слоёвbackground.fill и containerBackground.fill

Облачные сервисы

Голубой внешний фон и светлая подложка блока.

Контент секции

tsx
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>
  );
}

Совместимость со страницами до редизайна

Совместимость со страницами до редизайнаcontainer='old'

Облачные сервисы

Отступы и ширина страниц до редизайна.

Контент секции

tsx
import { SectionBasic } from '@cloud-ru/ds-site-section';

export function OldContainer() {
  return (
    <SectionBasic container='old' title='Облачные сервисы' description='Отступы и ширина страниц до редизайна.'>
      <p>Контент секции</p>
    </SectionBasic>
  );
}

Props

Types

PropsSectionBasicProps
PropTypeDefaultRequiredDescription
backgroundSectionBackground—noВнешний слой фона во всю ширину экрана (Figma `sectionBackground`): тема и заливка.
childrenReactNode—noСодержимое секции между фильтрами и футером.
classNamestring—noCSS-класс корня.
container"new" | "old"—yesШирина и отступы секции: `new` — целевой вид, `old` — совместимость со страницами до редизайна. Временная настройка на период редизайна, задаётся явно.
containerBackgroundSectionContainerBackground{ type: SECTION_CONTAINER_BACKGROUND_TYPE.Bg }noБлок по ширине `container` (Figma `contentWrapper` + `bgLocal`): тема блока и всего содержимого и заливка — подложка, картинка или акцентный цвет. Тема не задана — тема внешнего слоя.
data-test-idstring—no
defaultTabBarValuestring—noИзначально выбранная вкладка (uncontrolled).
descriptionstring—noОписание. Строка может содержать HTML-разметку.
filterItemsFieldSelectProps[]—noПоля-фильтры под вкладками. Рендерятся как `FieldSelect` размера `l`.
idstring—noHTML-атрибут `id` секции — якорь для навигации по странице.
moreButtonSectionMoreButton—noКнопка «Показать еще» в футере.
onTabBarChange((value: string) => void)—noКолбэк выбора вкладки: значение `value` выбранного элемента `tabBarItems`.
paginationPaginationProps—noПагинация в футере.
tabBarItemsTabsSegmentedItem[]—noВкладки под заголовком. Без `tabBarValue` / `defaultTabBarValue` изначально выбрана первая доступная.
tabBarValuestring—noВыбранная вкладка (controlled), например из параметра URL `?tab=ai`.
titlestring—noЗаголовок. Строка может содержать строчную HTML-разметку (`a`, `strong`, `em`, `br`).
titleTag"h1" | "h2" | "h3" | "h4"—noТег заголовка.

Unions

Types

SectionBasicProps

Unions

Адаптивность

Раскладка читается из AdaptiveProvider (@cloud-ru/ds-adaptive), пропа layoutType нет.

Отступы по раскладке и container (внешние — вокруг блока, внутренние — внутри блока, по вертикали / по горизонтали):

Раскладкаnew: внешние / внутренниеold: внешние / внутренниеШаг между блоками
desktop, desktopSmall24 / 16 и 48 / 320 / 16 и 56 / 9640
tablet16 / 8 и 24 / 160 / 16 и 40 / 2432
mobile16 / 0 и 24 / 160 / 0 и 32 / 1624

Вкладки на desktop — размер l, на tablet и mobile — m. Типографика заголовка — в документации @cloud-ru/ds-site-section-title.

Storybook

Figma