TitleClickable

Кликабельный заголовок раздела — нативный <a> с заголовком, опциональной иконкой слева и шевроном справа. Используется в шапках продуктовых блоков, где сам заголовок одновременно является ссылкой на раздел. Длинный текст автоматически усекается через TruncateString.

Когда использовать

  • Заголовок продуктового раздела ведёт на отдельную страницу/детальный вид.
  • В шапке карточки/секции, где навигация по клику на заголовок ожидаема пользователем.
  • Когда нужен визуальный аффорданс перехода (шеврон) поверх обычной ссылки.

Когда не нужен:

Анатомия

Содержимое

  • content — обязательный слот для TitleClickable.SimpleTitle, TitleClickable.UserTitle или произвольной React-ноды.
  • TitleClickable.SimpleTitle — обязательный title, необязательные icon и titleTag. Иконка занимает 24×24, текст использует title/m и усекается до одной строки.
  • TitleClickable.UserTitle — пропы Avatar на верхнем уровне и необязательный subtitle. Имя берётся из name, размер аватара по умолчанию m (32 px). Имя и подпись усекаются до одной строки.
  • Оба компонента можно использовать самостоятельно. className, data-test-id и aria-* относятся к их корневому контейнеру.
  • showArrow — видимость стрелки справа. При target='_blank' отображается иконка внешней ссылки.

Иконка справа (auto)

  • chevron (default) — внутренний переход.
  • external link — выставляется автоматически, когда target='_blank'.

Width (default auto)

  • auto — компонент занимает место по контенту, шеврон прижат к заголовку.
  • fullWidth — растягивается на ширину контейнера, шеврон уезжает в правый край.

Target (default _self)

HTML-атрибут target нативной ссылки:

  • _self — открыть в текущей вкладке.
  • _blank — открыть в новой вкладке; rel='noopener noreferrer' проставляется автоматически.
  • _parent — открыть в родительском frame.
  • _top — открыть в верхнем frame.

Установка

pnpm add @cloud-ru/ds-uikit-product-title-clickable
import { TitleClickable } from '@cloud-ru/ds-uikit-product-title-clickable'

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

Простой заголовок

Простой заголовокМинимальный набор: href + content

Production environment

tsx
import { TitleClickable } from '@cloud-ru/ds-uikit-product-title-clickable';

export function Basic() {
  return <TitleClickable href='#' content={<TitleClickable.SimpleTitle title='Production environment' />} />;
}

С иконкой

С иконкойИконка слева от заголовка через проп icon у TitleClickable.SimpleTitle
tsx
import { PlaceholderSVG } from '@cloud-ru/ds-icons/interface/system';
import { TitleClickable } from '@cloud-ru/ds-uikit-product-title-clickable';

export function WithIcon() {
  return (
    <TitleClickable
      href='#'
      content={<TitleClickable.SimpleTitle title='Production environment' icon={<PlaceholderSVG />} />}
    />
  );
}

Произвольный контент в `content`

Произвольный контент в `content`Слот content принимает произвольную React-ноду.
tsx
import { Typography } from '@cloud-ru/ds-typography';
import { TitleClickable } from '@cloud-ru/ds-uikit-product-title-clickable';

export function WithCustomNode() {
  return (
    <TitleClickable
      href='#'
      content={
        <Typography variant='label' size='s' as='span'>
          Custom content
        </Typography>
      }
    />
  );
}

Full-width

Full-widthfullWidth: шеврон уезжает в правый край контейнера
tsx
import { PlaceholderSVG } from '@cloud-ru/ds-icons/interface/system';
import { TitleClickable } from '@cloud-ru/ds-uikit-product-title-clickable';

export function FullWidth() {
  return (
    <TitleClickable
      href='#'
      content={<TitleClickable.SimpleTitle title='Раздел занимает всю ширину контейнера' icon={<PlaceholderSVG />} />}
      fullWidth
    />
  );
}

Внешняя ссылка

Внешняя ссылкаtarget='_blank' → rel='noopener noreferrer' автоматически
tsx
import { TitleClickable } from '@cloud-ru/ds-uikit-product-title-clickable';

export function External() {
  return (
    <TitleClickable
      href='https://example.com'
      target='_blank'
      content={<TitleClickable.SimpleTitle title='Внешняя ссылка' />}
    />
  );
}

Без шеврона

Без шевронаshowArrow={false}: компактный режим без визуального аффорданса
tsx
import { PlaceholderSVG } from '@cloud-ru/ds-icons/interface/system';
import { TitleClickable } from '@cloud-ru/ds-uikit-product-title-clickable';

export function HiddenArrow() {
  return (
    <TitleClickable
      href='#'
      content={<TitleClickable.SimpleTitle title='Без шеврона' icon={<PlaceholderSVG />} />}
      showArrow={false}
    />
  );
}

С аватаром

С аватаромTitleClickable.UserTitle в слоте content: аватар, имя и подпись.
tsx
import { TitleClickable } from '@cloud-ru/ds-uikit-product-title-clickable';

export function WithAvatar() {
  return (
    <TitleClickable
      href='#'
      fullWidth
      content={<TitleClickable.UserTitle name='John Doe' subtitle='jdoe@example.com' />}
    />
  );
}

Props

Types

PropsTitleClickableProps
PropTypeDefaultRequiredDescription
asElementType—noПолиморфный тег корня — `'a'` по умолчанию, либо компонент-роутер (`Link` из react-router-dom).
classNamestring—noCSS-класс
contentReactNode—yesСодержимое: TitleClickable.SimpleTitle, TitleClickable.UserTitle или произвольная React-нода.
data-test-idstring—no
fullWidthboolean—noЗанимает ли всю ширину
innerRefany—noRef на корневой элемент.
showArrowbooleantruenoПоказывать иконку-стрелку справа. Иконка автоматически меняется на `external link` при `target='_blank'`.

Types

TitleClickableProps

Types

PropsTitleClickable.SimpleTitleProps
PropTypeDefaultRequiredDescription
classNamestring—noCSS-класс корневого контейнера.
data-test-idstring—no
iconReactNode—noИконка слева, 24×24.
titlestring—yesТекст заголовка.
titleTagElementType—noСемантический тег заголовка.

Types

PropsTitleClickable.UserTitleProps
PropTypeDefaultRequiredDescription
appearance"blue" | "green" | "neutral" | "orange" | "pink" | "red" | "violet" | "yellow"—noВнешний вид (цвет)
badgeReactNode—noПроизвольный нод в слот значка (правый-нижний угол). Перекрывает `status`.
classNamestring—noCSS-класс
data-test-idstring—no
innerRefRef<HTMLDivElement>—noRef на корневой DOM-элемент. Используем явный проп, чтобы не зависеть от `forwardRef` и не тащить type-assertions на экспорт.
namestring—yesИмя пользователя для генерации аббревиатуры
shape"rounded" | "squared"—noФорма: круглая или квадратная
showTwoSymbolsboolean—noОтображение двух заглавных символов имени вместо одного
size"3xl" | "6xl" | "9xl" | "l" | "m" | "s" | "xs"—noРазмер
srcstring—noURL изображения аватара
status"blue" | "green" | "neutral" | "orange" | "pink" | "red" | "violet" | "yellow"—noAppearance дефолтного `StatusIndicator` в правом-нижнем углу. Размер индикатора подбирается из `size` аватара автоматически. Полностью настроить значок можно через слот `badge`, который перекрывает `status`.
subtitlestring—noПодпись под именем пользователя.

Storybook

Figma