Avatar

Profile Menu

Аватар в шапке, который сам открывает меню профиля: нативный popover, шапка с почтой и отделённый выход — без единой строки состояния.

  • avatar
  • menu
  • popover
  • account

Превью

1440pxHost theme

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

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

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

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

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

# Установка и размещение «avatar-028» (Profile Menu) из VibeUI

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

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

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

## 2. Что это
Аватар в шапке, который сам открывает меню профиля: нативный popover, шапка с почтой и отделённый выход — без единой строки состояния.

Аватар-кнопка с меню профиля: нативный popover, шапка с именем и почтой, отделённый выход. Компонент серверный, состояния нет. Ноль зависимостей, один файл.

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

<Avatar028
  name="Анна Реброва"
  email="anna@vibeui.dev"
  items={["Профиль", "Настройки", "Оформление"]}
  signOutLabel="Выйти"
/>

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

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

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

## 5. Сохранить как установлено
- локальную палитру --vibeui-avatar-028-* и не подменять её токенами вашей темы
- нативный popover: Escape, клик мимо и верхний слой не переписывать на свои обработчики
- шапку меню с почтой — под несколькими аккаунтами это единственный способ понять, кто вошёл
- отделённый чертой выход: соседство с настройками стоит случайного выхода из системы
- имя в доступной подписи кнопки — «меню профиля» в шапке без имени бесполезно
- видимый фокус на кнопке и пунктах: меню обязано проходиться с клавиатуры

## 6. Можно менять
- имя и почту через email
- набор пунктов через items
- подпись выхода через signOutLabel
- размер аватара в переменной size

## 7. Правила
- Идентификатор popover прописан строкой: два таких аватара на странице требуют разных id.
- Пункты меню ничего не делают: обработчики и ссылки навешивает вызывающий код.
- Выход не спрашивает подтверждения: если у вас есть несохранённые черновики, добавьте диалог снаружи.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.

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

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

npx shadcn@latest add https://vibeui.ru/r/avatar-028.json
https://vibeui.ru/r/avatar-028.json

Компонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-avatar-028-*. Серверный: состояния нет вовсе — открытие и закрытие делает нативный HTML popover через popovertarget, а Escape, клик мимо и верхний слой достаются от браузера. Позиционирование сделано CSS anchor positioning под @supports (anchor-name: --a) с запасным фиксированным вариантом. В шапке меню повторены имя и почта: в продуктах с несколькими аккаунтами это единственное место, где видно, под кем ты сидишь. Выход отделён чертой и покрашен в опасный цвет.

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

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

import type { ComponentPropsWithoutRef, CSSProperties } from "react"

export type Avatar028Props = Omit<
  ComponentPropsWithoutRef<"div">,
  "children"
> & {
  name?: string
  email?: string
  items?: string[]
  signOutLabel?: string
}

// Идея компонента: аватар в шапке, который сам открывает меню профиля. Меню —
// нативный HTML popover, поэтому Escape, клик мимо и верхний слой достаются от
// браузера, а компонент остаётся серверным: состояния здесь нет вовсе.
// В шапке меню повторены имя и почта — в продуктах с несколькими аккаунтами
// это единственное место, где видно, под кем ты сидишь. Выход отделён чертой:
// соседство с «настройками» стоит случайного выхода из системы.
const STYLES = `
:where([data-vibeui-block="avatar-028"]){
--vibeui-avatar-028-size:2.25rem;
--vibeui-avatar-028-bg:oklch(1 0 0);
--vibeui-avatar-028-fg:oklch(0.24 0.014 265);
--vibeui-avatar-028-muted:oklch(0.55 0.014 265);
--vibeui-avatar-028-border:oklch(0.91 0.006 265);
--vibeui-avatar-028-hover:oklch(0.55 0.02 265 / 9%);
--vibeui-avatar-028-accent:oklch(0.55 0.2 262);
--vibeui-avatar-028-danger:oklch(0.56 0.19 25);
--vibeui-avatar-028-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="avatar-028"]{
display:inline-block;font-family:var(--vibeui-avatar-028-font);
}
[data-vibeui-block="avatar-028"] *{box-sizing:border-box}
[data-vibeui-block="avatar-028"] [data-part="trigger"]{
display:grid;place-items:center;
appearance:none;cursor:pointer;padding:0;
width:var(--vibeui-avatar-028-size);height:var(--vibeui-avatar-028-size);
border:0;border-radius:9999px;
background:oklch(0.9 0.06 var(--vibeui-avatar-028-hue,265));
color:oklch(0.36 0.12 var(--vibeui-avatar-028-hue,265));
font:inherit;font-size:calc(var(--vibeui-avatar-028-size) * 0.36);font-weight:700;line-height:1;
}
[data-vibeui-block="avatar-028"] [data-part="trigger"]:hover{box-shadow:0 0 0 0.1875rem oklch(0.55 0.02 265 / 16%)}
[data-vibeui-block="avatar-028"] [data-part="trigger"]:focus-visible{outline:2px solid var(--vibeui-avatar-028-accent);outline-offset:2px}
[data-vibeui-block="avatar-028"] [data-part="menu"]{
position:fixed;margin:0;padding:0.3125rem;min-width:14rem;
border:1px solid var(--vibeui-avatar-028-border);border-radius:0.75rem;
background:var(--vibeui-avatar-028-bg);color:var(--vibeui-avatar-028-fg);
box-shadow:0 18px 40px -20px oklch(0.2 0.03 265 / 45%);
font-family:var(--vibeui-avatar-028-font);
}
/* Якорь привязывает меню к аватару; без поддержки оно встанет по центру. */
@supports (anchor-name: --a){
[data-vibeui-block="avatar-028"] [data-part="trigger"]{anchor-name:--vibeui-avatar-028-anchor}
[data-vibeui-block="avatar-028"] [data-part="menu"]{
position-anchor:--vibeui-avatar-028-anchor;
position-area:bottom span-left;margin-top:0.375rem;
position-try-fallbacks:flip-block,flip-inline;
}
}
/* Шапка меню: под каким аккаунтом ты сидишь, видно только здесь. */
[data-vibeui-block="avatar-028"] [data-part="head"]{
display:flex;flex-direction:column;gap:0.0625rem;
padding:0.5rem 0.5rem 0.625rem;margin-bottom:0.25rem;
border-bottom:1px solid var(--vibeui-avatar-028-border);
}
[data-vibeui-block="avatar-028"] [data-part="head-name"]{
font-size:0.875rem;font-weight:650;
overflow:hidden;text-overflow:ellipsis;white-space:nowrap;
}
[data-vibeui-block="avatar-028"] [data-part="head-mail"]{
font-size:0.75rem;color:var(--vibeui-avatar-028-muted);
overflow:hidden;text-overflow:ellipsis;white-space:nowrap;
}
[data-vibeui-block="avatar-028"] [data-part="item"]{
display:flex;align-items:center;width:100%;
min-height:2.125rem;padding:0 0.5rem;border-radius:0.5rem;
appearance:none;border:0;background:none;cursor:pointer;
font:inherit;font-size:0.8125rem;color:inherit;text-align:left;
}
[data-vibeui-block="avatar-028"] [data-part="item"]:hover{background:var(--vibeui-avatar-028-hover)}
[data-vibeui-block="avatar-028"] [data-part="item"]:focus-visible{outline:2px solid var(--vibeui-avatar-028-accent);outline-offset:-2px}
/* Выход отделён: соседство с настройками стоит случайного выхода. */
[data-vibeui-block="avatar-028"] [data-danger="true"]{
margin-top:0.3125rem;padding-top:0.625rem;min-height:2.375rem;
border-top:1px solid var(--vibeui-avatar-028-border);border-radius:0 0 0.5rem 0.5rem;
color:var(--vibeui-avatar-028-danger);
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="avatar-028"] *{animation:none!important;transition:none!important}}
`

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.charAt(0).toUpperCase())
    .join("")
}

/**
 * Аватар-кнопка с меню профиля на нативном popover: состояния нет, компонент серверный.
 * Один файл, ноль зависимостей, собственная палитра.
 */
export function Avatar028({
  name = "Анна Реброва",
  email = "anna@vibeui.dev",
  items = ["Профиль", "Настройки", "Оформление"],
  signOutLabel = "Выйти",
  className,
  style,
  ...props
}: Avatar028Props) {
  const palette = {
    "--vibeui-avatar-028-hue": hue(name),
    ...style,
  } as CSSProperties

  return (
    <>
      <style href="vibeui-avatar-028" precedence="medium">
        {STYLES}
      </style>
      <div
        {...props}
        data-vibeui-block="avatar-028"
        className={className}
        style={palette}
      >
        <button
          type="button"
          data-part="trigger"
          popoverTarget="vibeui-avatar-028-menu"
          aria-haspopup="menu"
          aria-label={`Меню профиля: ${name}`}
        >
          <span aria-hidden="true">{initials(name)}</span>
        </button>
        <div
          id="vibeui-avatar-028-menu"
          data-part="menu"
          popover="auto"
          role="menu"
        >
          <div data-part="head">
            <span data-part="head-name">{name}</span>
            <span data-part="head-mail">{email}</span>
          </div>
          {items.map((item) => (
            <button key={item} type="button" data-part="item" role="menuitem">
              {item}
            </button>
          ))}
          <button
            type="button"
            data-part="item"
            data-danger="true"
            role="menuitem"
          >
            {signOutLabel}
          </button>
        </div>
      </div>
    </>
  )
}