Avatar
Avatar Editor
Аватар с меню правки на HTML popover: Escape и клик мимо закрывают меню сами, удаление отделено чертой и названо действием.
- avatar
- upload
- popover
- menu
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/avatar-015
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «avatar-015» (Avatar Editor) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/avatar-015.json
Registry item: https://vibeui.ru/r/avatar-015.json
Ставится в: components/vibeui/avatar-015.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Аватар с меню правки на HTML popover: Escape и клик мимо закрывают меню сами, удаление отделено чертой и названо действием.
Аватар с меню правки: нативный popover, доступная подпись с именем, удаление отделено и названо действием. Ноль зависимостей, один файл.
## 3. Как использовать
import { Avatar015 } from "@/components/vibeui/avatar-015"
<Avatar015
name="Анна Реброва"
hint="PNG или JPG до 2 МБ, квадрат от 200 пикселей"
editLabel="Загрузить фото"
removeLabel="Удалить фото"
/>
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-avatar-015-* и не подменять её токенами вашей темы
- нативный popover: закрытие по Escape и клику мимо не переписывать на свои обработчики
- имя в доступной подписи кнопки — «изменить фото» в списке карточек бесполезно
- отделённый чертой пункт удаления и слово «удалить» вместо «сбросить»
- подсказку о формате и размере рядом, а не в тексте ошибки после загрузки
- фокус-стили на кнопке и пунктах меню
- собственную светлую подложку карточки: без неё тёмный текст пропадает на тёмном фоне
## 6. Можно менять
- имя и подсказку о формате
- подписи пунктов editLabel и removeLabel
- акцентный цвет через accent
- размер портрета в переменной
## 7. Правила
- Загрузка не реализована: компонент показывает выбор действия, файл принимает вызывающий код.
- Меню открывается по кнопке, а не по клику в портрет: клик в портрет обычно открывает просмотр.
- Пункт удаления не спрашивает подтверждения: если фото невосстановимо, добавьте диалог снаружи.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/avatar-015.jsonhttps://vibeui.ru/r/avatar-015.jsonКомпонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-avatar-015-*. Клиентский: "use client", useState и useRef держат выбранное действие и ссылку на popover. Меню — нативный HTML popover с popovertarget: закрытие по Escape и клику мимо достаётся от браузера, а не пишется руками. Позиционирование сделано CSS anchor positioning под @supports (anchor-name: --a) с обычным абсолютным запасным вариантом. Кнопка правки уменьшена и сдвинута в угол, её доступная подпись называет имя — в списке карточек «изменить фото» без имени бесполезно.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
"use client"
import { useRef, useState } from "react"
import type { ComponentPropsWithoutRef, CSSProperties } from "react"
export type Avatar015Props = Omit<
ComponentPropsWithoutRef<"div">,
"children"
> & {
name?: string
hint?: string
editLabel?: string
removeLabel?: string
accent?: string
}
// Идея компонента: аватар с меню правки. Меню — HTML popover, поэтому закрытие
// по Escape и клику мимо достаётся от браузера. Кнопка правки лежит поверх
// портрета, но не закрывает лицо: она сдвинута в угол и уменьшена, а её
// доступная подпись называет имя — в списке из пяти карточек «изменить фото»
// без имени бесполезно. Удаление отделено чертой и названо действием, а не
// «сбросить»: человек должен понимать, что вернётся заглушка.
const STYLES = `
:where([data-vibeui-block="avatar-015"]){
--vibeui-avatar-015-size:4.5rem;
--vibeui-avatar-015-bg:oklch(1 0 0);
--vibeui-avatar-015-fg:oklch(0.24 0.014 265);
--vibeui-avatar-015-muted:oklch(0.55 0.014 265);
--vibeui-avatar-015-border:oklch(0.9 0.006 265);
--vibeui-avatar-015-hover:oklch(0.55 0.02 265 / 9%);
--vibeui-avatar-015-accent:oklch(0.55 0.2 262);
--vibeui-avatar-015-danger:oklch(0.56 0.19 25);
--vibeui-avatar-015-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
/* Своя светлая подложка: тёмный текст обязан читаться на любом фоне. */
[data-vibeui-block="avatar-015"]{
display:inline-flex;align-items:center;gap:0.875rem;
box-sizing:border-box;padding:0.875rem 1.125rem 0.875rem 0.875rem;
background:var(--vibeui-avatar-015-bg);
border:1px solid var(--vibeui-avatar-015-border);border-radius:1rem;
font-family:var(--vibeui-avatar-015-font);color:var(--vibeui-avatar-015-fg);
}
[data-vibeui-block="avatar-015"] *{box-sizing:border-box}
[data-vibeui-block="avatar-015"] [data-part="slot"]{position:relative;flex:none}
[data-vibeui-block="avatar-015"] [data-part="face"]{
display:grid;place-items:center;
width:var(--vibeui-avatar-015-size);height:var(--vibeui-avatar-015-size);
border-radius:9999px;
background:oklch(0.9 0.07 var(--vibeui-avatar-015-hue,265));
color:oklch(0.35 0.13 var(--vibeui-avatar-015-hue,265));
font-size:calc(var(--vibeui-avatar-015-size) * 0.32);font-weight:700;
}
/* Кнопка в углу и мелкая: правка не должна закрывать лицо. */
[data-vibeui-block="avatar-015"] [data-part="edit"]{
position:absolute;right:-0.125rem;bottom:-0.125rem;
appearance:none;cursor:pointer;
width:1.75rem;height:1.75rem;border-radius:9999px;
border:2px solid var(--vibeui-avatar-015-bg);
background:var(--vibeui-avatar-015-accent);color:oklch(1 0 0);
font:inherit;font-size:0.75rem;line-height:1;
}
[data-vibeui-block="avatar-015"] [data-part="edit"]:focus-visible{outline:2px solid var(--vibeui-avatar-015-accent);outline-offset:2px}
[data-vibeui-block="avatar-015"] [data-part="menu"]{
position:fixed;margin:0;padding:0.25rem;min-width:11rem;
border:1px solid var(--vibeui-avatar-015-border);border-radius:0.625rem;
background:var(--vibeui-avatar-015-bg);color:var(--vibeui-avatar-015-fg);
box-shadow:0 16px 36px -18px oklch(0.2 0.03 265 / 45%);
font-family:var(--vibeui-avatar-015-font);
}
/* Якорь привязывает меню к кнопке; без поддержки оно встанет по центру экрана. */
@supports (anchor-name: --a){
[data-vibeui-block="avatar-015"] [data-part="edit"]{anchor-name:--vibeui-avatar-015-anchor}
[data-vibeui-block="avatar-015"] [data-part="menu"]{
position-anchor:--vibeui-avatar-015-anchor;
position-area:bottom span-right;margin-top:0.375rem;
position-try-fallbacks:flip-block,flip-inline;
}
}
[data-vibeui-block="avatar-015"] [data-part="item"]{
display:flex;align-items:center;width:100%;
min-height:2rem;padding:0 0.5rem;border-radius:0.4375rem;
appearance:none;border:0;background:none;cursor:pointer;
font:inherit;font-size:0.8125rem;color:inherit;text-align:left;
}
[data-vibeui-block="avatar-015"] [data-part="item"]:hover{background:var(--vibeui-avatar-015-hover)}
[data-vibeui-block="avatar-015"] [data-part="item"]:focus-visible{outline:2px solid var(--vibeui-avatar-015-accent);outline-offset:-2px}
/* Удаление отделено чертой: соседство с правкой стоит промаха. */
[data-vibeui-block="avatar-015"] [data-danger="true"]{
margin-top:0.25rem;padding-top:0.625rem;min-height:2.375rem;
border-top:1px solid var(--vibeui-avatar-015-border);border-radius:0 0 0.4375rem 0.4375rem;
color:var(--vibeui-avatar-015-danger);
}
[data-vibeui-block="avatar-015"] [data-part="text"]{display:flex;flex-direction:column;gap:0.125rem;min-width:0}
[data-vibeui-block="avatar-015"] [data-part="name"]{font-size:0.9375rem;font-weight:650}
[data-vibeui-block="avatar-015"] [data-part="hint"]{font-size:0.75rem;line-height:1.4;color:var(--vibeui-avatar-015-muted)}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="avatar-015"] *{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("")
}
/**
* Аватар с меню правки на HTML popover: закрытие и якорь от браузера.
* Один файл, ноль зависимостей, собственная палитра.
*/
export function Avatar015({
name = "Анна Реброва",
hint = "PNG или JPG до 2 МБ, квадрат от 200 пикселей",
editLabel = "Загрузить фото",
removeLabel = "Удалить фото",
accent,
className,
style,
...props
}: Avatar015Props) {
const menu = useRef<HTMLDivElement>(null)
const [removed, setRemoved] = useState(false)
const palette = {
"--vibeui-avatar-015-hue": hue(name),
...(accent ? { "--vibeui-avatar-015-accent": accent } : null),
...style,
} as CSSProperties
return (
<>
<style href="vibeui-avatar-015" precedence="medium">
{STYLES}
</style>
<div
{...props}
data-vibeui-block="avatar-015"
className={className}
style={palette}
>
<span data-part="slot">
<span data-part="face" aria-hidden="true">
{initials(name)}
</span>
<button
type="button"
data-part="edit"
popoverTarget="vibeui-avatar-015-menu"
aria-label={`Изменить фото: ${name}`}
>
✎
</button>
<div
id="vibeui-avatar-015-menu"
data-part="menu"
popover="auto"
role="menu"
ref={menu}
>
<button type="button" data-part="item" role="menuitem">
{editLabel}
</button>
<button type="button" data-part="item" role="menuitem">
Сделать снимок
</button>
<button
type="button"
data-part="item"
data-danger="true"
role="menuitem"
onClick={() => {
setRemoved(true)
menu.current?.hidePopover()
}}
>
{removeLabel}
</button>
</div>
</span>
<span data-part="text">
<span data-part="name">{name}</span>
<span data-part="hint">
{removed ? "Фото удалено, показаны инициалы" : hint}
</span>
</span>
</div>
</>
)
}