SectionTitle
Заголовочный блок секции сайта: заголовок и описание. Типографика и положение описания зависят от type и раскладки. Используется в @cloud-ru/ds-site-section и в секциях, собранных вручную.
Когда использовать
- Заголовок секции лендинга или каталога.
- Заголовок блока внутри страницы сайта, когда нужен единый ритм с секциями.
Когда не нужен:
- Заголовок внутри карточки или формы:
- используйте
Typographyиз@cloud-ru/ds-typography.
- используйте
Анатомия
title— заголовок. Разметка вставляется прямо в тег заголовка, без вложенной обёртки, поэтому в строке допустима только строчная разметка (a,strong,em,br).description— описание, может содержать абзацы и списки.
Обе строки рендерятся через @cloud-ru/ds-site-rich-text, который очищает HTML от XSS.
Type (default descriptionRight)
descriptionRight— на desktop описание справа, заголовок и описание делят ширину поровну; описание не шире 480 px.descriptionUnderTitle— описание под заголовком.centered— описание под заголовком, текст по центру.small— уменьшенная типографика, описание под заголовком.
На tablet и mobile описание всегда под заголовком.
Тег заголовка (default h2)
titleTag — h1, h2, h3 или h4. h1 — для заголовка первой секции страницы.
Установка
pnpm add @cloud-ru/ds-site-section-title
import { SectionTitle } from '@cloud-ru/ds-site-section-title'
Примеры использования
Описание справа
Облачные сервисы
Инфраструктура, данные и AI в одном облаке.
tsx
import { SectionTitle } from '@cloud-ru/ds-site-section-title';
export function DescriptionRight() {
return (
<SectionTitle
type='descriptionRight'
title='Облачные сервисы'
description='Инфраструктура, данные и AI в одном облаке.'
/>
);
}По центру
Облачные сервисы
Инфраструктура, данные и AI в одном облаке.
tsx
import { SectionTitle } from '@cloud-ru/ds-site-section-title';
export function Centered() {
return (
<SectionTitle type='centered' title='Облачные сервисы' description='Инфраструктура, данные и AI в одном облаке.' />
);
}Уменьшенный
Тарифы
Оплата по факту потребления, без минимального платежа.
tsx
import { SectionTitle } from '@cloud-ru/ds-site-section-title';
export function Small() {
return (
<SectionTitle
type='small'
titleTag='h3'
title='Тарифы'
description='Оплата по факту потребления, без минимального платежа.'
/>
);
}HTML-разметка в строках
Облако для бизнеса
Строки из CMS могут содержать HTML-разметку.
tsx
import { SectionTitle } from '@cloud-ru/ds-site-section-title';
export function HtmlTitle() {
return (
<SectionTitle
type='descriptionUnderTitle'
title='Облако для <a href="#">бизнеса</a>'
description='Строки из CMS могут содержать <strong>HTML-разметку</strong>.'
/>
);
}Props
Types
Props
SectionTitleProps| 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 | Раскладка блока. |
Unions
Types
SectionTitleProps
Unions
SectionTitleTag
SectionTitleType
Адаптивность
Раскладка читается из AdaptiveProvider (@cloud-ru/ds-adaptive), пропа layoutType нет. Начертание везде thin.
| Type | desktop: заголовок / описание / шаг | tablet | mobile |
|---|---|---|---|
descriptionRight | display/m / headline/l / 24 | headline/l / title/l / 8 | headline/m / body/m / 4 |
descriptionUnderTitle | display/m / headline/s / 12 | headline/l / title/l / 8 | headline/m / body/m / 4 |
centered | display/m / headline/l / 12 | headline/l / title/l / 8 | headline/m / body/m / 4 |
small | display/s / title/l / 12 | headline/l / title/m / 8 | headline/m / body/m / 4 |
desktopSmall использует значения desktop.