ContentCard
Компонент для создания интерактивных карточек с изображением и текстовым содержимым. Сочетает возможности кликабельных элементов, карточек и медиа-контента. Автоматически распределяет свойства между вложенными компонентами.
Связанные компоненты:
Распределение свойств
Свойства изображения
Внутренний тэг img получает следующие свойства: getRef, maxHeight, imageObjectFit, src, srcSet, alt,
width, height, crossOrigin, decoding, loading, referrerPolicy, sizes, useMap, fetchPriority
Свойства корневого компонента Card
Внутренний компонент Card получает следующие свойства: mode, getRootRef, Component,
style, className.
Свойства Tappable
Внутренний компонент Tappable получает все остальные свойства (кроме subhead,
header, text и caption).
Семантическая настройка
- Component — базовый HTML-тег контейнера (по умолчанию
li). - titleComponent — тег для обёртки заголовка (по умолчанию
span).
Доступность (a11y)
-
По умолчанию используется тег
"li"для повышения доступности компонента. Вы можете прокинуть необходимый вам тег через propComponent. Ссылки на источники: статья про доступность карточек ↗. -
Всегда указывайте осмысленный
alt:// Плохо <ContentCard src="/product.jpg" alt="Изображение" /> // Хорошо <ContentCard src="/product.jpg" alt="Красный свитер с оленями" /> -
Используйте семантические теги для заголовков:
<ContentCard titleComponent="h3" title="Новости платформы" titleLevel="2" />
Свойства и методы
| Свойство | Описание |
|---|---|
activated | booleanПозволяет управлять По умолчанию: - |
activeClassName | stringDeprecated: Since 7.3.0. Свойство устарело и будет удалено в По умолчанию: - |
activeEffectDelay | numberДлительность показа По умолчанию: - |
activeMode | StateModeLiteralСтиль подсветки active-состояния. Если передать произвольную строку, она добавится как css-класс во время active. По умолчанию: - |
baseClassName | string | falseDeprecated: Since 7.3.0. Свойство устарело и будет удалено в По умолчанию: - |
baseStyle | CSSPropertiesDeprecated: Since 7.3.0. Свойство устарело и будет удалено в По умолчанию: - |
borderRadiusMode | "auto" | "inherit"Задает border-radius элементу
В режиме По умолчанию: - |
caption | ReactNodeНижний текст. По умолчанию: - |
Component | ElementType<any, keyof IntrinsicElements>По умолчанию: li |
description | ReactNodeТекст. По умолчанию: - |
focusVisibleMode | FocusVisibleModeСтиль аутлайна focus visible. Если передать произвольную строку, она добавится как css-класс при :focus-visible По умолчанию: - |
getRef | Ref<HTMLImageElement>По умолчанию: - |
getRootRef | Ref<HTMLDivElement>По умолчанию: - |
hasActive | booleanУказывает, должен ли компонент реагировать на По умолчанию: false |
hasHover | booleanУказывает, должен ли компонент реагировать на По умолчанию: false |
hasHoverWithChildren | booleanПозволяет родительскому компоненту
иметь Присваивается родителькому компоненту. По умолчанию: - |
hoverClassName | stringDeprecated: Since 7.3.0. Свойство устарело и будет удалено в По умолчанию: - |
hovered | booleanПозволяет управлять По умолчанию: - |
hoverMode | StateModeLiteralСтиль подсветки hover-состояния. Если передать произвольную строку, она добавится как css-класс во время hover. По умолчанию: - |
imageObjectFit | ObjectFitПользовательское значения стиля По умолчанию: - |
maxHeight | numberМаксимальная высота изображения. По умолчанию: - |
mode | "plain" | "shadow" | "tint" | "outline" | "outline-tint"Внешний вид карточки. По умолчанию: shadow |
overTitle | ReactNodeТекст над заголовком. По умолчанию: - |
title | ReactNodeЗаголовок. По умолчанию: - |
titleComponent | ElementType<any, keyof IntrinsicElements>Позволяет поменять тег используемый для заголовка. По умолчанию: span |
unlockParentHover | booleanПозволяет родительскому компоненту показывать hovered-состояние при наведении на текущий дочерний компонент. Присваивается дочернему компоненту. По умолчанию: - |