# @cloud-ru/ds-site-section-title
> Заголовочный блок секции сайта — заголовок и описание в четырёх раскладках.
Docs: /snack-v2/components/site-section-title/
## Установка
```sh
pnpm add @cloud-ru/ds-site-section-title
```
## Когда использовать
- Заголовок секции лендинга или каталога.
- Заголовок блока внутри страницы сайта, когда нужен единый ритм с секциями.
Когда **не** нужен:
- Заголовок внутри карточки или формы:
- используйте `Typography` из `@cloud-ru/ds-typography`.
## API
### SectionTitle
| Prop | Type | Default | Required | Description |
|------|------|---------|----------|-------------|
| `className` | `string` | — | no | CSS-класс корня. |
| `data-test-id` | `string` | — | no | |
| `description` | `string` | — | no | Описание. Строка может содержать HTML-разметку. |
| `title` | `string` | — | no | Заголовок. Строка может содержать строчную HTML-разметку (`a`, `strong`, `em`, `br`). |
| `titleTag` | `h1 \| h2 \| h3 \| h4` | `h2` | no | Тег заголовка. |
| `type` | `centered \| descriptionRight \| descriptionUnderTitle \| small` | `descriptionRight` | no | Раскладка блока. |
#### Related types
- `SectionTitleTag` = `h1 | h2 | h3 | h4`
- `SectionTitleType` = `centered | descriptionRight | descriptionUnderTitle | small`
## Примеры
### Centered
```tsx
import { SectionTitle } from '@cloud-ru/ds-site-section-title';
export function Centered() {
return (
);
}
```
### DescriptionRight
```tsx
import { SectionTitle } from '@cloud-ru/ds-site-section-title';
export function DescriptionRight() {
return (
);
}
```
### HtmlTitle
```tsx
import { SectionTitle } from '@cloud-ru/ds-site-section-title';
export function HtmlTitle() {
return (
);
}
```
### Small
```tsx
import { SectionTitle } from '@cloud-ru/ds-site-section-title';
export function Small() {
return (
);
}
```