VibeUI

Feedback

Hover Card

Карточка человека у упоминания: раскрывается по наведению и по фокусу, внутри только текст — до кнопок курсор не довести.

  • hover card
  • mention
  • profile
  • no-js

Превью

1440pxHost theme

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

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

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

@mashaМария Гурова
@mashaВедёт каталог и дизайн-систему, собирает интерфейсы без лишних слов.24 компонентов3 года в команде
Показать полную инструкцию

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

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

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

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

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

## 2. Что это
Карточка человека у упоминания: раскрывается по наведению и по фокусу, внутри только текст — до кнопок курсор не довести.

Карточка профиля у упоминания: инициалы, имя, описание и пара цифр. Раскрывается по наведению и по фокусу, без клиентского кода. Ноль зависимостей, один файл.

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

<Hovercard001 name="Мария Гурова" handle="@masha" />

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

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

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

## 5. Сохранить как установлено
- локальную палитру --vibeui-hovercard-001-* и не подменять её токенами вашей темы
- раскрытие по :focus-within: с клавиатуры карточку иначе не увидеть
- отсутствие кнопок внутри — довести курсор через зазор невозможно без ловли мыши
- aria-describedby, связывающий упоминание и карточку
- оттенок аватара из имени: один человек всегда одного цвета
- видимость через visibility, а не display: иначе перехода не будет

## 6. Можно менять
- name, handle и about
- массив stats
- акцент через проп accent
- ширину карточки

## 7. Правила
- На телефоне наведения нет: карточка появится только при фокусе, поэтому дублируйте данные на странице профиля.
- Задержки перед показом нет: при плотном тексте карточка будет мигать, добавьте её при необходимости.
- Карточка не переворачивается у края экрана: рядом с правой границей она может обрезаться.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.

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

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

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

Компонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-hovercard-001-*. Серверный: хуков нет, кроме useId для связи через aria-describedby. Раскрытие идёт на :hover и :focus-within, поэтому клавиатура видит карточку. Внутри нет интерактивных элементов: карточка объявлена role="tooltip".

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

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

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

export type Hovercard001Props = Omit<
  ComponentPropsWithoutRef<"span">,
  "children"
> & {
  name?: string
  handle?: string
  about?: string
  stats?: { label: string; value: string }[]
  accent?: string
}

// Идея компонента: карточка человека рядом с упоминанием. Она раскрывается по
// наведению и по фокусу — иначе с клавиатуры её не увидеть вовсе. Карточка
// только показывает: ни ссылок, ни кнопок внутри, потому что довести до них
// курсор через зазор невозможно без задержек и ловли мыши.
const STYLES = `
:where([data-vibeui-block="hovercard-001"]){
--vibeui-hovercard-001-bg:oklch(1 0 0);
--vibeui-hovercard-001-fg:oklch(0.22 0.014 265);
--vibeui-hovercard-001-muted:oklch(0.56 0.014 265);
--vibeui-hovercard-001-border:oklch(0.9 0.006 265);
--vibeui-hovercard-001-hue:250;
--vibeui-hovercard-001-accent:oklch(0.55 0.17 265);
--vibeui-hovercard-001-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="hovercard-001"]{
position:relative;display:inline-block;
font-family:var(--vibeui-hovercard-001-font);color:var(--vibeui-hovercard-001-fg);
}
[data-vibeui-block="hovercard-001"] [data-part="mention"]{
color:var(--vibeui-hovercard-001-accent);font-weight:650;text-decoration:none;
border-radius:0.25rem;
}
[data-vibeui-block="hovercard-001"] [data-part="mention"]:focus-visible{outline:2px solid var(--vibeui-hovercard-001-accent);outline-offset:2px}
/* Раскрытие и по фокусу: с клавиатуры карточку иначе не увидеть. */
[data-vibeui-block="hovercard-001"] [data-part="card"]{
position:absolute;left:0;top:calc(100% + 0.5rem);z-index:20;
display:flex;flex-direction:column;gap:0.5rem;
width:15rem;box-sizing:border-box;padding:0.75rem;
border:1px solid var(--vibeui-hovercard-001-border);border-radius:0.875rem;
background:var(--vibeui-hovercard-001-bg);
box-shadow:0 20px 44px -26px oklch(0.2 0.02 265 / 55%);
opacity:0;visibility:hidden;translate:0 -0.25rem;
transition:opacity .14s ease,translate .14s ease,visibility .14s;
}
[data-vibeui-block="hovercard-001"]:hover [data-part="card"],
[data-vibeui-block="hovercard-001"]:focus-within [data-part="card"]{
opacity:1;visibility:visible;translate:0 0;
}
[data-vibeui-block="hovercard-001"] [data-part="head"]{display:flex;align-items:center;gap:0.5rem}
[data-vibeui-block="hovercard-001"] [data-part="face"]{
display:flex;align-items:center;justify-content:center;flex:none;
width:2.25rem;height:2.25rem;border-radius:9999px;
background:oklch(0.92 0.05 var(--vibeui-hovercard-001-hue));
color:oklch(0.38 0.09 var(--vibeui-hovercard-001-hue));
font-size:0.75rem;font-weight:700;
}
[data-vibeui-block="hovercard-001"] [data-part="name"]{font-size:0.875rem;font-weight:650;line-height:1.2}
[data-vibeui-block="hovercard-001"] [data-part="handle"]{font-size:0.75rem;color:var(--vibeui-hovercard-001-muted)}
[data-vibeui-block="hovercard-001"] [data-part="about"]{margin:0;font-size:0.8125rem;line-height:1.4;color:var(--vibeui-hovercard-001-muted)}
[data-vibeui-block="hovercard-001"] [data-part="stats"]{display:flex;gap:0.75rem;font-size:0.75rem;color:var(--vibeui-hovercard-001-muted)}
[data-vibeui-block="hovercard-001"] [data-part="stats"] b{color:var(--vibeui-hovercard-001-fg);font-weight:650;font-variant-numeric:tabular-nums}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="hovercard-001"] *{animation:none!important;transition:none!important}}
`

const DEFAULT_STATS = [
  { label: "компонентов", value: "24" },
  { label: "в команде", value: "3 года" },
]

function hue(name: string) {
  let hash = 2166136261

  for (const symbol of name) {
    hash ^= symbol.codePointAt(0)!
    hash = Math.imul(hash, 16777619)
  }

  return ((hash >>> 0) % 12) * 30
}

function initials(name: string) {
  return name
    .split(" ")
    .slice(0, 2)
    .map((part) => part[0]?.toUpperCase() ?? "")
    .join("")
}

/**
 * Карточка человека у упоминания: раскрывается по наведению и по фокусу.
 * Один файл, ноль зависимостей, собственная палитра.
 */
export function Hovercard001({
  name = "Мария Гурова",
  handle = "@masha",
  about = "Ведёт каталог и дизайн-систему, собирает интерфейсы без лишних слов.",
  stats = DEFAULT_STATS,
  accent,
  className,
  style,
  ...props
}: Hovercard001Props) {
  const id = useId()
  const palette = {
    "--vibeui-hovercard-001-hue": hue(name),
    ...(accent ? { "--vibeui-hovercard-001-accent": accent } : null),
    ...style,
  } as CSSProperties

  return (
    <>
      <style href="vibeui-hovercard-001" precedence="medium">
        {STYLES}
      </style>
      <span
        {...props}
        data-vibeui-block="hovercard-001"
        className={className}
        style={palette}
      >
        <a data-part="mention" href="#" aria-describedby={`${id}-card`}>
          {handle}
        </a>
        <span data-part="card" id={`${id}-card`} role="tooltip">
          <span data-part="head">
            <span data-part="face" aria-hidden="true">
              {initials(name)}
            </span>
            <span>
              <span data-part="name">{name}</span>
              <br />
              <span data-part="handle">{handle}</span>
            </span>
          </span>
          <span data-part="about">{about}</span>
          <span data-part="stats">
            {stats.map((stat) => (
              <span key={stat.label}>
                <b>{stat.value}</b> {stat.label}
              </span>
            ))}
          </span>
        </span>
      </span>
    </>
  )
}