TitleClickable
Кликабельный заголовок раздела — нативный <a> с заголовком, опциональной иконкой слева и шевроном справа. Используется в шапках продуктовых блоков, где сам заголовок одновременно является ссылкой на раздел. Длинный текст автоматически усекается через TruncateString.
Когда использовать
- Заголовок продуктового раздела ведёт на отдельную страницу/детальный вид.
- В шапке карточки/секции, где навигация по клику на заголовок ожидаема пользователем.
- Когда нужен визуальный аффорданс перехода (шеврон) поверх обычной ссылки.
Когда не нужен:
- Inline-ссылка в тексте:
- используйте
@cloud-ru/ds-link.
- используйте
- Action-кнопка:
- используйте
@cloud-ru/ds-button.
- используйте
- Строка списка с действием:
- используйте
@cloud-ru/ds-uikit-product-info-row.
- используйте
Анатомия
Содержимое
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'
Примеры использования
Простой заголовок
tsx
import { TitleClickable } from '@cloud-ru/ds-uikit-product-title-clickable';
export function Basic() {
return <TitleClickable href='#' content={<TitleClickable.SimpleTitle title='Production environment' />} />;
}С иконкой
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`
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
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
/>
);
}Внешняя ссылка
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='Внешняя ссылка' />}
/>
);
}Без шеврона
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}
/>
);
}С аватаром
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
Props
TitleClickableProps| Prop | Type | Default | Required | Description |
|---|---|---|---|---|
as | ElementType | — | no | Полиморфный тег корня — `'a'` по умолчанию, либо компонент-роутер (`Link` из react-router-dom). |
className | string | — | no | CSS-класс |
content | ReactNode | — | yes | Содержимое: TitleClickable.SimpleTitle, TitleClickable.UserTitle или произвольная React-нода. |
data-test-id | string | — | no | |
fullWidth | boolean | — | no | Занимает ли всю шир ину |
innerRef | any | — | no | Ref на корневой элемент. |
showArrow | boolean | true | no | Показывать иконку-стрелку справа. Иконка автоматически меняется на `external link` при `target='_blank'`. |
Types
TitleClickableProps
PolymorphicRef
Types
Props
TitleClickable.SimpleTitleProps| Prop | Type | Default | Required | Description |
|---|---|---|---|---|
className | string | — | no | CSS-класс корневого контейнера. |
data-test-id | string | — | no | |
icon | ReactNode | — | no | Иконка слева, 24×24. |
title | string | — | yes | Текст заголовка. |
titleTag | ElementType | — | no | Семантический тег заголовка. |
Types
Props
TitleClickable.UserTitleProps| Prop | Type | Default | Required | Description |
|---|---|---|---|---|
appearance | "blue" | "green" | "neutral" | "orange" | "pink" | "red" | "violet" | "yellow" | — | no | Внешний вид (цвет) |
badge | ReactNode | — | no | Произвольный нод в слот значка (правый-нижний угол). Перекрывает `status`. |
className | string | — | no | CSS-класс |
data-test-id | string | — | no | |
innerRef | Ref<HTMLDivElement> | — | no | Ref на корневой DOM-элемент. Используем явный проп, чтобы не зависеть от `forwardRef` и не тащить type-assertions на экспорт. |
name | string | — | yes | Имя пользователя для генерации аббревиатуры |
shape | "rounded" | "squared" | — | no | Форма: круглая или квадратная |
showTwoSymbols | boolean | — | no | Отображение двух заглавных символов имени вместо одного |
size | "3xl" | "6xl" | "9xl" | "l" | "m" | "s" | "xs" | — | no | Размер |
src | string | — | no | URL изображения аватара |
status | "blue" | "green" | "neutral" | "orange" | "pink" | "red" | "violet" | "yellow" | — | no | Appearance дефолтного `StatusIndicator` в правом-нижнем углу. Размер индикатора подбирается из `size` аватара автоматически. Полностью настроить значок можно через слот `badge`, который перекрывает `status`. |
subtitle | string | — | no | Подпись под именем пользователя. |