VibeUI

Feedback

Glossary Card

Словарная статья у сокращения в тексте: расшифровка, раздел, определение и смежные термины — это справочник, а не короткая реплика.

  • hovercard
  • glossary
  • term
  • definition

Превью

1440pxHost theme

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

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

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

Статику мы раздаём через CDNContent Delivery NetworkинфраструктураСеть серверов, раздающих статические файлы из точки, ближайшей к посетителю. Сокращает задержку и снимает нагрузку с основного сервера.см. также: TTFB, кеш на краю, прогрев, поэтому первая загрузка идёт из ближайшего города.

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

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

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

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

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

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

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

Карточка термина глоссария: расшифровка, раздел, определение и смежные слова. Ноль зависимостей, один файл, клиентского JS нет.

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

<Hovercard005
  term="CDN"
  full="Content Delivery Network"
  category="инфраструктура"
  related={["TTFB", "прогрев"]}
/>

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

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

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

## 5. Сохранить как установлено
- локальную палитру --vibeui-hovercard-005-* и не подменять её токенами вашей темы
- сокращение строчным элементом: ссылка или кнопка в середине абзаца рвёт набор
- tabIndex=0 вместе с aria-describedby — иначе статья недоступна с клавиатуры
- расшифровку первой строкой: без неё сокращение остаётся сокращением
- раскрытие по фокусу, привязанное к обёртке слова, а не к абзацу
- собственную светлую подложку абзаца: без неё тёмный текст пропадает на тёмном фоне

## 6. Можно менять
- сокращение через term и расшифровку через full
- определение через definition и раздел через category
- список смежных слов через related
- акцент через переменную --vibeui-hovercard-005-accent

## 7. Правила
- Смежные термины показаны текстом, а не ссылками: до ссылки в карточке не довести курсор.
- Определение длиннее четырёх строк лучше вынести в справку и оставить в карточке первую фразу.
- Пустой массив related убирает нижнюю строку вместе с разделителем.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.

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

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

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

Компонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-hovercard-005-*. Серверный: раскрытие держится на :hover и :focus-visible самого сокращения внутри обёртки. Сокращение остаётся строчным элементом с tabIndex=0 — не ссылка и не кнопка, поэтому набор текста не рвётся. Карточка помечена ролью tooltip и связана через aria-describedby. Левая грань окрашена акцентом: это признак словарной статьи, а не уведомления.

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

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

import type { ComponentPropsWithoutRef, CSSProperties } from "react"

export type Hovercard005Props = Omit<
  ComponentPropsWithoutRef<"div">,
  "children"
> & {
  /** Сокращение, набранное в тексте. */
  term?: string
  /** Полная расшифровка сокращения. */
  full?: string
  definition?: string
  category?: string
  /** Смежные термины: подсказка ведёт к соседним статьям словаря. */
  related?: string[]
}

// Идея компонента: словарная статья у сокращения в тексте. От подсказки она
// отличается структурой: расшифровка, раздел, определение и смежные термины —
// это карточка справочника, а не короткая реплика.
const STYLES = `
:where([data-vibeui-block="hovercard-005"]){
--vibeui-hovercard-005-bg:oklch(0.995 0.004 90);
--vibeui-hovercard-005-fg:oklch(0.24 0.014 265);
--vibeui-hovercard-005-muted:oklch(0.52 0.014 265);
--vibeui-hovercard-005-border:oklch(0.89 0.01 90);
--vibeui-hovercard-005-accent:oklch(0.48 0.13 45);
--vibeui-hovercard-005-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="hovercard-005"]{
width:100%;max-width:28rem;box-sizing:border-box;
padding:1rem 1.125rem;
border:1px solid var(--vibeui-hovercard-005-border);border-radius:0.875rem;
background:var(--vibeui-hovercard-005-bg);
font-family:var(--vibeui-hovercard-005-font);color:var(--vibeui-hovercard-005-fg);
}
[data-vibeui-block="hovercard-005"] [data-part="line"]{margin:0;font-size:0.875rem;line-height:1.7}
/* Статья цепляется к сокращению в строке, а не к абзацу целиком. */
[data-vibeui-block="hovercard-005"] [data-part="host"]{position:relative;display:inline-block}
/* Сокращение в тексте: пунктир снизу и курсор help, ссылки здесь нет. */
[data-vibeui-block="hovercard-005"] [data-part="term"]{
cursor:help;font-weight:650;color:var(--vibeui-hovercard-005-accent);
text-decoration:underline dotted currentColor;text-underline-offset:0.22em;
border-radius:0.1875rem;
}
[data-vibeui-block="hovercard-005"] [data-part="term"]:focus-visible{outline:2px solid var(--vibeui-hovercard-005-accent);outline-offset:2px}
[data-vibeui-block="hovercard-005"] [data-part="card"]{
position:absolute;left:0;top:calc(100% + 0.5rem);z-index:20;
display:flex;flex-direction:column;gap:0.375rem;
width:19rem;box-sizing:border-box;padding:0.875rem;
border:1px solid var(--vibeui-hovercard-005-border);
border-left:3px solid var(--vibeui-hovercard-005-accent);
border-radius:0.75rem;
background:var(--vibeui-hovercard-005-bg);
box-shadow:0 22px 46px -28px oklch(0.25 0.03 60 / 55%);
opacity:0;visibility:hidden;translate:0 -0.25rem;
transition:opacity .15s ease,translate .15s ease,visibility .15s;
}
[data-vibeui-block="hovercard-005"] [data-part="host"]:hover [data-part="card"],
[data-vibeui-block="hovercard-005"] [data-part="host"]:focus-within [data-part="card"]{opacity:1;visibility:visible;translate:0 0}
[data-vibeui-block="hovercard-005"] [data-part="head"]{display:flex;align-items:baseline;gap:0.5rem;flex-wrap:wrap}
[data-vibeui-block="hovercard-005"] [data-part="full"]{font-size:0.875rem;font-weight:680;line-height:1.3}
[data-vibeui-block="hovercard-005"] [data-part="category"]{
flex:none;padding:0.0625rem 0.4375rem;border-radius:0.375rem;
background:color-mix(in oklab,var(--vibeui-hovercard-005-accent) 12%,transparent);
color:var(--vibeui-hovercard-005-accent);
font-size:0.625rem;font-weight:700;letter-spacing:0.04em;text-transform:uppercase;
}
[data-vibeui-block="hovercard-005"] [data-part="definition"]{display:block;margin:0;font-size:0.8125rem;line-height:1.5;color:var(--vibeui-hovercard-005-muted)}
[data-vibeui-block="hovercard-005"] [data-part="related"]{
display:flex;align-items:baseline;gap:0.375rem;flex-wrap:wrap;
padding-top:0.375rem;border-top:1px dashed var(--vibeui-hovercard-005-border);
font-size:0.75rem;color:var(--vibeui-hovercard-005-muted);
}
[data-vibeui-block="hovercard-005"] [data-part="related"] b{color:var(--vibeui-hovercard-005-fg);font-weight:640}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="hovercard-005"] *{animation:none!important;transition:none!important}}
`

const DEFAULT_RELATED = ["TTFB", "кеш на краю", "прогрев"]

/**
 * Карточка термина глоссария: расшифровка, раздел, определение и смежные слова.
 * Один файл, ноль зависимостей, собственная палитра.
 */
export function Hovercard005({
  term = "CDN",
  full = "Content Delivery Network",
  definition = "Сеть серверов, раздающих статические файлы из точки, ближайшей к посетителю. Сокращает задержку и снимает нагрузку с основного сервера.",
  category = "инфраструктура",
  related = DEFAULT_RELATED,
  className,
  style,
  ...props
}: Hovercard005Props) {
  return (
    <>
      <style href="vibeui-hovercard-005" precedence="medium">
        {STYLES}
      </style>
      <div
        {...props}
        data-vibeui-block="hovercard-005"
        className={className}
        style={style as CSSProperties}
      >
        <p data-part="line">
          Статику мы раздаём через{" "}
          <span data-part="host">
            <span
              data-part="term"
              tabIndex={0}
              aria-describedby="vibeui-hovercard-005-card"
            >
              {term}
            </span>
            <span
              data-part="card"
              id="vibeui-hovercard-005-card"
              role="tooltip"
            >
              <span data-part="head">
                <span data-part="full">{full}</span>
                {category ? <span data-part="category">{category}</span> : null}
              </span>
              <span data-part="definition">{definition}</span>
              {related.length > 0 ? (
                <span data-part="related">
                  см. также: <b>{related.join(", ")}</b>
                </span>
              ) : null}
            </span>
          </span>
          , поэтому первая загрузка идёт из ближайшего города.
        </p>
      </div>
    </>
  )
}