# @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 (
Произвольный контент секции: карточки, сетка, карусель.
);
}
```