# @cloud-ru/ds-site-section > Базовая секция сайта — заголовок, вкладки, фильтры, произвольный контент и футер с пагинацией и кнопкой «Показать еще». Docs: /snack-v2/components/site-section/ ## Установка ```sh pnpm add @cloud-ru/ds-site-section ``` ## Когда использовать - Типовой блок лендинга или каталога: заголовок, контент, «Показать еще». - Список с переключением вкладками и фильтрацией по полям. Когда **не** нужен: - Вёрстка внутри приложения консоли: - используйте компоненты `@ds/uikit-product-*`. ## API ### BackgroundLayer | Prop | Type | Default | Required | Description | |------|------|---------|----------|-------------| | `data-test-id` | `string` | — | no | | | `fill` | `blueBackground \| decorTransparent \| greenBackground \| neutralBackground \| neutralBackground1Level \| orangeBackground \| pinkBackground \| primaryBackground \| redBackground \| transparent \| violetBackground \| yellowBackground` | — | yes | Подложка. | ### BgLocal | Prop | Type | Default | Required | Description | |------|------|---------|----------|-------------| | `background` | `SectionContainerBackground` | — | yes | Фон блока. | ### SectionBasic | 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 | Тег заголовка. | #### Related types - `CustomOptionProps` (interface) - `DroplistListProps` (alias) - `DroplistMobileSlots` (interface) - `EmptyState` (interface) - `FieldLength` (interface) - `FieldSelectDecoratorProps` (interface) - `FieldSelectProps` (alias) - `PaginationProps` (interface) - `PublicListContextType` (interface) - `QuestionTooltipProps` (interface) - `ScrollProps` (interface) - `SectionBackground` (interface) - `SectionBackgroundFill` = `blueBackground | decorTransparent | greenBackground | neutralBackground | neutralBackground1Level | orangeBackground | pinkBackground | primaryBackground | redBackground | transparent | violetBackground | yellowBackground` - `SectionContainer` = `new | old` - `SectionContainerBackground` (alias) - `SectionMoreButton` (interface) - `SectionTitleTag` = `h1 | h2 | h3 | h4` - `SelectionState` (interface) - `TabsSegmentedItem` (interface) - `ThemeAppearance` (interface) ### SectionFilter | Prop | Type | Default | Required | Description | |------|------|---------|----------|-------------| | `items` | `FieldSelectProps[]` | — | yes | Настройки полей-фильтров. Размер поля фиксирован — `l`. | ### SectionFooter | Prop | Type | Default | Required | Description | |------|------|---------|----------|-------------| | `moreButton` | `SectionMoreButton` | — | no | Кнопка «Показать еще». | | `pagination` | `PaginationProps` | — | no | Настройки пагинации. | ### SectionWrapper | Prop | Type | Default | Required | Description | |------|------|---------|----------|-------------| | `background` | `SectionBackground` | — | no | Внешний слой фона. | | `className` | `string` | — | no | CSS-класс корня. | | `container` | `new \| old` | — | yes | Ширина и отступы секции. | | `containerBackground` | `SectionContainerBackground` | — | yes | Блок по ширине `container`. | | `data-test-id` | `string` | — | no | | | `id` | `string` | — | no | HTML-атрибут `id` секции — якорь для навигации по странице. | ## Примеры ### AccentContainer ```tsx import { SectionBasic } from '@cloud-ru/ds-site-section'; export function AccentContainer() { return (

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

); } ``` ### BackgroundFill ```tsx import { SectionBasic } from '@cloud-ru/ds-site-section'; export function BackgroundFill() { return (

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

); } ``` ### ContainerTheme ```tsx import { SectionBasic } from '@cloud-ru/ds-site-section'; export function ContainerTheme() { return (

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

); } ``` ### ControlledTabs ```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 (

Выбрана вкладка: {tab}

); } ``` ### Footer ```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 ( setShown(count => count + 3) }} >

Страница {page}, показано новостей: {shown}

); } ``` ### OldContainer ```tsx import { SectionBasic } from '@cloud-ru/ds-site-section'; export function OldContainer() { return (

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

); } ``` ### TabsAndFilters ```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 ( setCategory(String(value ?? 'all')), }, ]} >

Выбрана категория: {category}

); } ``` ### TitleAndContent ```tsx import { SectionBasic } from '@cloud-ru/ds-site-section'; export function TitleAndContent() { return (

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

); } ```