Card

Content Card

Карточка материала: обложка, надзаголовок, заголовок и подвал. Кликается вся площадь, но ссылка внутри остаётся одна.

  • card
  • content
  • link
  • grid

Превью

1440pxHost theme

Использовать с AI

  1. 1. Скопируйте ссылку.
  2. 2. Напишите агенту своими словами и вставьте её в предложение.
  3. 3. Агент откроет ссылку и поставит компонент из registry.

размести это в шапке: https://vibeui.ru/c/card-001

Показать полную инструкцию

То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.

# Установка и размещение «card-001» (Content Card) из VibeUI

## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/card-001.json

Registry item: https://vibeui.ru/r/card-001.json
Ставится в: components/vibeui/card-001.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.

Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.

## 2. Что это
Карточка материала: обложка, надзаголовок, заголовок и подвал. Кликается вся площадь, но ссылка внутри остаётся одна.

Карточка материала для сетки: обложка на градиентах, надзаголовок, заголовок-ссылка, описание и подвал. Вся площадь кликабельна за счёт ::after у единственной ссылки, поэтому в списке из двадцати карточек не появляется шестидесяти ссылок. Раскладка считается от ширины самой карточки. Ноль зависимостей, один файл, своя палитра.

## 3. Как использовать
import { Card001 } from "@/components/vibeui/card-001"

<Card001
  eyebrow="Практика"
  title="Как собрать лендинг за вечер"
  description="Разбираем сборку страницы из готовых блоков."
  href="/blog/landing"
  footer="8 минут чтения"
/>

Полный список пропсов — в установленном файле.

## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.

Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)

## 5. Сохранить как установлено
- локальную палитру --vibeui-card-001-* и не подменять её токенами вашей темы (bg-card, border-border, text-muted-foreground и подобными)
- приём с одной ссылкой: position:relative у карточки и ::after у ссылки заголовка — из-за нескольких ссылок карточка станет неудобной для скринридера
- focus-within у карточки: фокус приходит на ссылку внутри, а рамку должна показывать вся карточка
- @container-запрос вместо медиазапроса: карточка живёт в сетке и обязана считать раскладку от своей ширины, а не от ширины окна
- подъём на hover вместе с отменой transform в prefers-reduced-motion
- структуру заголовков: заголовок карточки — h3, а не div с крупным шрифтом
- блок <style> внутри компонента — в нём вся палитра, обложка и раскладка

## 6. Можно менять
- тексты title, description, eyebrow и содержимое footer — в подвал можно положить свой элемент
- href — адрес материала; уберите его, и карточка перестанет быть ссылкой
- акцент через проп accent — цвет надзаголовка, обложки и рамки при наведении
- обложку: замените градиент в [data-part="media"] на <img> с тем же aspect-ratio
- максимальную ширину и внешние отступы через className

## 7. Правила
- Не добавляйте в карточку вторую ссылку или кнопку поверх ::after: они окажутся под невидимым слоем. Если нужна кнопка — поднимите её через position:relative и z-index.
- Не заменяйте заголовок на div: в сетке карточек заголовки формируют структуру страницы.
- Не растягивайте карточку на всю ширину экрана: max-width задан намеренно, длинная строка описания читается плохо.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.

## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.

Для разработчика

npx shadcn@latest add https://vibeui.ru/r/card-001.json
https://vibeui.ru/r/card-001.json

Компонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-card-001-*. Приём с ::after у ссылки заголовка растягивает её область на всю карточку: клик работает по любому месту, а в дереве доступности остаётся одна ссылка. Обложка нарисована градиентами и не требует картинки. Внутренние отступы и кегль заголовка считаются от собственной ширины карточки через @container, поэтому карточка одинаково выглядит в узкой колонке и в широкой сетке.

Исходник компонента

Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.

import type { ComponentPropsWithoutRef, CSSProperties, ReactNode } from "react"

export type Card001Props = Omit<
  ComponentPropsWithoutRef<"article">,
  "title"
> & {
  title?: string
  description?: string
  /** Надпись над заголовком: раздел, дата, тип материала. */
  eyebrow?: string
  /** Ссылка. Если задана, кликается вся карточка, а не только заголовок. */
  href?: string
  /** Подвал: цена, автор, кнопка. Пустой подвал не рисуется. */
  footer?: ReactNode
  accent?: string
}

// Идея компонента: кликает вся карточка, но ссылка остаётся одна. Заголовок
// растягивает свою область до краёв через ::after, поэтому в списке ссылок
// не появляется по три штуки на карточку — и скринридер читает одну.
const STYLES = `
:where([data-vibeui-block="card-001"]){
--vibeui-card-001-fg:oklch(0.22 0.016 265);
--vibeui-card-001-muted:oklch(0.52 0.014 265);
--vibeui-card-001-bg:oklch(1 0 0);
--vibeui-card-001-border:oklch(0.9 0.006 265);
--vibeui-card-001-accent:oklch(0.55 0.2 262);
--vibeui-card-001-radius:0.875rem;
--vibeui-card-001-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
container-type:inline-size;
}
[data-vibeui-block="card-001"]{
position:relative;display:flex;flex-direction:column;
max-width:22rem;box-sizing:border-box;
border:1px solid var(--vibeui-card-001-border);
border-radius:var(--vibeui-card-001-radius);
background:var(--vibeui-card-001-bg);color:var(--vibeui-card-001-fg);
font-family:var(--vibeui-card-001-font);
transition:border-color .18s ease,box-shadow .18s ease,transform .18s ease;
}
[data-vibeui-block="card-001"]:hover{
border-color:color-mix(in oklab,var(--vibeui-card-001-accent) 35%,var(--vibeui-card-001-border));
box-shadow:0 8px 24px -12px oklch(0.2 0.03 265 / 30%);
transform:translateY(-2px);
}
[data-vibeui-block="card-001"]:focus-within{
border-color:var(--vibeui-card-001-accent);
box-shadow:0 0 0 3px color-mix(in oklab,var(--vibeui-card-001-accent) 20%,transparent);
}
[data-vibeui-block="card-001"] [data-part="media"]{
aspect-ratio:16 / 9;border-radius:calc(var(--vibeui-card-001-radius) - 1px) calc(var(--vibeui-card-001-radius) - 1px) 0 0;
background:
radial-gradient(120% 90% at 15% 0%,color-mix(in oklab,var(--vibeui-card-001-accent) 35%,transparent),transparent 60%),
linear-gradient(160deg,oklch(0.94 0.02 265),oklch(0.88 0.03 250));
}
[data-vibeui-block="card-001"] [data-part="body"]{
display:flex;flex-direction:column;gap:0.375rem;padding:1rem 1.125rem 1.125rem;
}
[data-vibeui-block="card-001"] [data-part="eyebrow"]{
font-size:0.6875rem;font-weight:600;letter-spacing:0.08em;text-transform:uppercase;
color:var(--vibeui-card-001-accent);
}
[data-vibeui-block="card-001"] [data-part="title"]{
margin:0;font-size:1.0625rem;font-weight:600;line-height:1.3;letter-spacing:-0.01em;
}
[data-vibeui-block="card-001"] [data-part="title"] a{
color:inherit;text-decoration:none;outline:none;
}
/* Ссылка заголовка накрывает карточку целиком: одна ссылка, вся площадь. */
[data-vibeui-block="card-001"] [data-part="title"] a::after{
content:"";position:absolute;inset:0;border-radius:inherit;
}
[data-vibeui-block="card-001"] [data-part="description"]{
margin:0;font-size:0.875rem;line-height:1.5;color:var(--vibeui-card-001-muted);
}
[data-vibeui-block="card-001"] [data-part="footer"]{
display:flex;align-items:center;gap:0.5rem;
margin-top:0.375rem;padding-top:0.75rem;
border-top:1px solid var(--vibeui-card-001-border);
font-size:0.8125rem;color:var(--vibeui-card-001-muted);
}
@container (min-width: 26rem){
[data-vibeui-block="card-001"] [data-part="body"]{padding:1.25rem 1.375rem 1.375rem}
[data-vibeui-block="card-001"] [data-part="title"]{font-size:1.1875rem}
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="card-001"] *{animation:none!important;transition:none!important}}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="card-001"]:hover{transform:none}}
`

/**
 * Карточка материала: обложка, заголовок-ссылка на всю площадь, подвал.
 * Один файл, ноль зависимостей, собственная палитра.
 */
export function Card001({
  title = "Как собрать лендинг за вечер",
  description = "Разбираем сборку страницы из готовых блоков: что отдать агенту, а что править руками.",
  eyebrow = "Практика",
  href = "#",
  footer = "8 минут чтения",
  accent,
  className,
  style,
  ...props
}: Card001Props) {
  const palette = {
    ...(accent ? { "--vibeui-card-001-accent": accent } : null),
    ...style,
  } as CSSProperties

  return (
    <>
      <style href="vibeui-card-001" precedence="medium">
        {STYLES}
      </style>
      <article
        {...props}
        data-vibeui-block="card-001"
        className={className}
        style={palette}
      >
        <div data-part="media" aria-hidden="true" />
        <div data-part="body">
          {eyebrow ? <span data-part="eyebrow">{eyebrow}</span> : null}
          <h3 data-part="title">{href ? <a href={href}>{title}</a> : title}</h3>
          {description ? <p data-part="description">{description}</p> : null}
          {footer ? <div data-part="footer">{footer}</div> : null}
        </div>
      </article>
    </>
  )
}