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'

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

Описание справа

Описание справаtype='descriptionRight'

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

Инфраструктура, данные и AI в одном облаке.
tsx
import { SectionTitle } from '@cloud-ru/ds-site-section-title';

export function DescriptionRight() {
  return (
    <SectionTitle
      type='descriptionRight'
      title='Облачные сервисы'
      description='Инфраструктура, данные и AI в одном облаке.'
    />
  );
}

По центру

По центруtype='centered'

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

Инфраструктура, данные и AI в одном облаке.
tsx
import { SectionTitle } from '@cloud-ru/ds-site-section-title';

export function Centered() {
  return (
    <SectionTitle type='centered' title='Облачные сервисы' description='Инфраструктура, данные и AI в одном облаке.' />
  );
}

Уменьшенный

Уменьшенныйtype='small', titleTag='h3'

Тарифы

Оплата по факту потребления, без минимального платежа.
tsx
import { SectionTitle } from '@cloud-ru/ds-site-section-title';

export function Small() {
  return (
    <SectionTitle
      type='small'
      titleTag='h3'
      title='Тарифы'
      description='Оплата по факту потребления, без минимального платежа.'
    />
  );
}

HTML-разметка в строках

HTML-разметка в строкахtype='descriptionUnderTitle'

Облако для бизнеса

Строки из 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

PropsSectionTitleProps
PropTypeDefaultRequiredDescription
classNamestring—noCSS-класс корня.
data-test-idstring—no
descriptionstring—noОписание. Строка может содержать HTML-разметку.
titlestring—noЗаголовок. Строка может содержать строчную HTML-разметку (`a`, `strong`, `em`, `br`).
titleTag"h1" | "h2" | "h3" | "h4"h2noТег заголовка.
type"centered" | "descriptionRight" | "descriptionUnderTitle" | "small"descriptionRightnoРаскладка блока.

Unions

Types

SectionTitleProps

Unions

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

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

Typedesktop: заголовок / описание / шагtabletmobile
descriptionRightdisplay/m / headline/l / 24headline/l / title/l / 8headline/m / body/m / 4
descriptionUnderTitledisplay/m / headline/s / 12headline/l / title/l / 8headline/m / body/m / 4
centereddisplay/m / headline/l / 12headline/l / title/l / 8headline/m / body/m / 4
smalldisplay/s / title/l / 12headline/l / title/m / 8headline/m / body/m / 4

desktopSmall использует значения desktop.

Storybook

Figma