Feedback

Info Popover

Всплывающая карточка на HTML popover: в неё можно попасть мышью и Tab, поэтому она не закрывается по уходу курсора.

popover
explain
no-js
anchor

Превью

1440pxHost theme

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

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

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

Как считается охват

Берём уникальных посетителей за семь дней и вычитаем ботов по списку известных агентов.

Кнопка

Заголовок

Действие

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

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

# Установка и размещение «popover-001» (Info Popover) из VibeUI

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

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

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

## 2. Что это
Всплывающая карточка на HTML popover: в неё можно попасть мышью и Tab, поэтому она не закрывается по уходу курсора.

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

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

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

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

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

## 5. Сохранить как установлено
- локальную палитру --vibeui-popover-001-* и не подменять её токенами вашей темы
- открытие по нажатию, а не по наведению: в карточку с кнопкой надо попасть курсором
- popover вместо своего состояния: Escape, клик вне и верхний слой достаются даром
- запасное правило в @supports для браузеров без anchor positioning
- ограничение ширины: пояснение шире 18rem читается тяжело
- aria-label на карточке — у неё есть имя, а не только текст

## 6. Можно менять
- label, title и text
- actionLabel — действие внутри карточки
- акцент через проп accent
- ширину карточки

## 7. Правила
- Для короткой подписи к иконке нужна подсказка (tooltip-001), а не эта карточка.
- Не кладите внутрь форму: попап с полями лучше делать диалогом.
- Карточка не переворачивается у края экрана: при необходимости добавьте position-try.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.

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

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

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

https://vibeui.ru/r/popover-001.json

Компонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-popover-001-*. Серверный компонент: открытие и закрытие держит HTML popover, позиция — anchor positioning с запасным правилом в @supports. Внутри карточки живут заголовок, текст и кнопка, поэтому нужен именно popover, а не подсказка.

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

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

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

export type Popover001Props = Omit<
  ComponentPropsWithoutRef<"div">,
  "children" | "title"
> & {
  label?: string
  title?: string
  text?: string
  actionLabel?: string
  accent?: string
}

// Идея компонента: всплывающая карточка с текстом и действием на HTML
// popover. Она отличается от подсказки тем, что в неё можно попасть мышью и
// с клавиатуры: внутри живут ссылки и кнопки. Поэтому она не закрывается по
// уходу курсора — только по Escape, клику вне или действию.
const STYLES = `
:where([data-vibeui-block="popover-001"]){
--vibeui-popover-001-bg:oklch(1 0 0);
--vibeui-popover-001-fg:oklch(0.24 0.014 265);
--vibeui-popover-001-muted:oklch(0.56 0.014 265);
--vibeui-popover-001-border:oklch(0.9 0.006 265);
--vibeui-popover-001-hover:oklch(0.96 0.004 265);
--vibeui-popover-001-accent:oklch(0.55 0.17 265);
--vibeui-popover-001-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="popover-001"]{
display:inline-block;font-family:var(--vibeui-popover-001-font);color:var(--vibeui-popover-001-fg);
}
[data-vibeui-block="popover-001"] [data-part="trigger"]{
appearance:none;cursor:pointer;
display:inline-flex;align-items:center;gap:0.375rem;
height:2.25rem;padding:0 0.875rem;
border:1px solid var(--vibeui-popover-001-border);border-radius:0.625rem;
background:var(--vibeui-popover-001-bg);color:inherit;
font:inherit;font-size:0.8125rem;font-weight:600;
anchor-name:--vibeui-popover-001-anchor;
}
[data-vibeui-block="popover-001"] [data-part="trigger"]:hover{background:var(--vibeui-popover-001-hover)}
[data-vibeui-block="popover-001"] [data-part="trigger"]:focus-visible{outline:2px solid var(--vibeui-popover-001-accent);outline-offset:2px}
/* Карточка на popover: слой, Escape и клик вне достаются от браузера. */
[data-vibeui-block="popover-001"] [popover]{
position:fixed;margin:0;padding:0.875rem;
width:min(18rem,100vw - 2rem);box-sizing:border-box;
border:1px solid var(--vibeui-popover-001-border);border-radius:0.875rem;
background:var(--vibeui-popover-001-bg);color:inherit;
box-shadow:0 20px 44px -24px oklch(0.2 0.02 265 / 55%);
position-anchor:--vibeui-popover-001-anchor;
top:anchor(bottom);left:anchor(left);margin-top:0.5rem;
}
@supports not (anchor-name: --a){
[data-vibeui-block="popover-001"]{position:relative}
[data-vibeui-block="popover-001"] [popover]{position:absolute;top:calc(100% + 0.5rem);left:0;inset:auto}
}
[data-vibeui-block="popover-001"] [data-part="title"]{margin:0 0 0.25rem;font-size:0.875rem;font-weight:650}
[data-vibeui-block="popover-001"] [data-part="text"]{margin:0 0 0.625rem;font-size:0.8125rem;line-height:1.45;color:var(--vibeui-popover-001-muted)}
[data-vibeui-block="popover-001"] [data-part="action"]{
appearance:none;cursor:pointer;
height:2rem;padding:0 0.75rem;border:0;border-radius:0.5rem;
background:var(--vibeui-popover-001-accent);color:oklch(0.99 0.01 265);
font:inherit;font-size:0.8125rem;font-weight:650;
}
[data-vibeui-block="popover-001"] [data-part="action"]:focus-visible{outline:2px solid var(--vibeui-popover-001-accent);outline-offset:2px}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="popover-001"] *{animation:none!important;transition:none!important}}
`

/**
 * Всплывающая карточка на HTML popover: внутрь можно попасть мышью и Tab.
 * Один файл, ноль зависимостей, собственная палитра.
 */
export function Popover001({
  label = "Что это значит",
  title = "Как считается охват",
  text = "Берём уникальных посетителей за семь дней и вычитаем ботов по списку известных агентов.",
  actionLabel = "Открыть методику",
  accent,
  className,
  style,
  ...props
}: Popover001Props) {
  const id = useId().replace(/:/g, "")
  const palette = {
    ...(accent ? { "--vibeui-popover-001-accent": accent } : null),
    ...style,
  } as CSSProperties

  return (
    <>
      <style href="vibeui-popover-001" precedence="medium">
        {STYLES}
      </style>
      <div
        {...props}
        data-vibeui-block="popover-001"
        className={className}
        style={palette}
      >
        <button type="button" data-part="trigger" popoverTarget={`${id}-card`}>
          {label}
        </button>
        <div id={`${id}-card`} popover="auto" aria-label={title}>
          <h3 data-part="title">{title}</h3>
          <p data-part="text">{text}</p>
          <button type="button" data-part="action">
            {actionLabel}
          </button>
        </div>
      </div>
    </>
  )
}