Avatar
Country Flag Avatar
Аватар с флагом страны в углу: флаг нарисован градиентами, а не эмодзи, и страна продублирована словом.
- avatar
- country
- flag
- locale
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/avatar-024
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «avatar-024» (Country Flag Avatar) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/avatar-024.json
Registry item: https://vibeui.ru/r/avatar-024.json
Ставится в: components/vibeui/avatar-024.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Аватар с флагом страны в углу: флаг нарисован градиентами, а не эмодзи, и страна продублирована словом.
Аватар с флагом страны в углу: четыре флага нарисованы градиентами, страна названа словом рядом с городом. Ноль зависимостей, один файл, клиентского JS нет.
## 3. Как использовать
import { Avatar024 } from "@/components/vibeui/avatar-024"
<Avatar024 name="Люси Мартен" country="fr" city="Лион" />
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-avatar-024-* и не подменять её токенами вашей темы
- флаги на градиентах вместо эмодзи: в Windows эмодзи-флаг рисуется двумя буквами кода
- прямоугольную форму флажка — круглый значок в углу занят присутствием
- страну словом в подписи: полоски флага угадываются не всеми
- обводку флажка цветом карточки и тонкий внутренний контур — белые полосы иначе теряются
- собственную светлую подложку карточки: без неё тёмный текст пропадает на тёмном фоне
## 6. Можно менять
- имя и страну через country
- город через city
- набор стран — новый флаг это одно правило с градиентом и строка в словаре
- размер портрета и флажка в переменных
## 7. Правила
- Флагов четыре: fr, de, it и jp. Пятый добавляется правилом для data-country и строкой в словаре.
- Флаг страны не равен гражданству и не равен языку: не подписывайте им локаль интерфейса.
- Градиентные флаги упрощены до полос: для точной геральдики нужен SVG, и это другой компонент.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/avatar-024.jsonhttps://vibeui.ru/r/avatar-024.jsonКомпонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-avatar-024-*. Серверный: хуков нет. Флаги нарисованы линейными и радиальными градиентами: эмодзи-флаги в Windows рисуются двумя буквами, и «FR» вместо полотнища ломает всю затею, а картинки потянули бы за собой сеть. Флажок прямоугольный и отделён обводкой цвета карточки — круглый значок в углу занят присутствием, и путать эти смыслы нельзя. Страна названа словом в строке под именем.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
import type { ComponentPropsWithoutRef, CSSProperties } from "react"
export type Avatar024Props = Omit<
ComponentPropsWithoutRef<"div">,
"children"
> & {
name?: string
country?: "fr" | "de" | "it" | "jp"
city?: string
}
// Идея компонента: аватар с флагом страны в углу. Флаг нарисован градиентами,
// а не эмодзи: эмодзи-флаги на Windows рисуются двумя буквами, и «FR» вместо
// полотнища ломает всю затею. Флажок прямоугольный — круглый значок в углу
// уже занят присутствием, и путать эти смыслы нельзя. Страна продублирована
// словом в строке под именем: полоски без подписи угадываются не всеми.
const STYLES = `
:where([data-vibeui-block="avatar-024"]){
--vibeui-avatar-024-size:2.75rem;
--vibeui-avatar-024-flag:1.375rem;
--vibeui-avatar-024-bg:oklch(1 0 0);
--vibeui-avatar-024-fg:oklch(0.24 0.014 265);
--vibeui-avatar-024-muted:oklch(0.55 0.014 265);
--vibeui-avatar-024-border:oklch(0.91 0.006 265);
--vibeui-avatar-024-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
/* Своя светлая подложка: тёмный текст обязан читаться на любом фоне. */
[data-vibeui-block="avatar-024"]{
display:flex;align-items:center;gap:0.75rem;
box-sizing:border-box;width:100%;max-width:18rem;padding:0.5rem 0.75rem;
background:var(--vibeui-avatar-024-bg);
border:1px solid var(--vibeui-avatar-024-border);border-radius:0.75rem;
font-family:var(--vibeui-avatar-024-font);color:var(--vibeui-avatar-024-fg);
}
[data-vibeui-block="avatar-024"] *{box-sizing:border-box}
[data-vibeui-block="avatar-024"] [data-part="slot"]{position:relative;flex:none}
[data-vibeui-block="avatar-024"] [data-part="face"]{
display:grid;place-items:center;
width:var(--vibeui-avatar-024-size);height:var(--vibeui-avatar-024-size);
border-radius:9999px;
background:oklch(0.9 0.06 var(--vibeui-avatar-024-hue,265));
color:oklch(0.36 0.12 var(--vibeui-avatar-024-hue,265));
font-size:calc(var(--vibeui-avatar-024-size) * 0.34);font-weight:700;line-height:1;
}
/* Прямоугольник, а не кружок: круглый значок в углу занят присутствием. */
[data-vibeui-block="avatar-024"] [data-part="flag"]{
position:absolute;right:-0.25rem;bottom:-0.125rem;
width:var(--vibeui-avatar-024-flag);
height:calc(var(--vibeui-avatar-024-flag) * 0.67);
border-radius:0.1875rem;overflow:hidden;
box-shadow:0 0 0 0.125rem var(--vibeui-avatar-024-bg),inset 0 0 0 1px oklch(0.2 0 0 / 18%);
}
[data-vibeui-block="avatar-024"][data-country="fr"] [data-part="flag"]{background:linear-gradient(90deg,#0055a4 0 33.34%,#ffffff 33.34% 66.67%,#ef4135 66.67%)}
[data-vibeui-block="avatar-024"][data-country="de"] [data-part="flag"]{background:linear-gradient(180deg,#000000 0 33.34%,#dd0000 33.34% 66.67%,#ffce00 66.67%)}
[data-vibeui-block="avatar-024"][data-country="it"] [data-part="flag"]{background:linear-gradient(90deg,#008c45 0 33.34%,#f4f5f0 33.34% 66.67%,#cd212a 66.67%)}
[data-vibeui-block="avatar-024"][data-country="jp"] [data-part="flag"]{background:radial-gradient(circle at 50% 50%,#bc002d 0 32%,#ffffff 32%)}
[data-vibeui-block="avatar-024"] [data-part="text"]{display:flex;flex-direction:column;gap:0.0625rem;min-width:0}
[data-vibeui-block="avatar-024"] [data-part="name"]{
font-size:0.875rem;font-weight:650;
overflow:hidden;text-overflow:ellipsis;white-space:nowrap;
}
[data-vibeui-block="avatar-024"] [data-part="place"]{
font-size:0.75rem;color:var(--vibeui-avatar-024-muted);
overflow:hidden;text-overflow:ellipsis;white-space:nowrap;
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="avatar-024"] *{animation:none!important;transition:none!important}}
`
const COUNTRY_LABEL = {
fr: "Франция",
de: "Германия",
it: "Италия",
jp: "Япония",
} as const
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("")
}
/**
* Аватар с флагом страны в углу: флаг нарисован градиентом, страна названа словом.
* Один файл, ноль зависимостей, собственная палитра.
*/
export function Avatar024({
name = "Люси Мартен",
country = "fr",
city = "Лион",
className,
style,
...props
}: Avatar024Props) {
const palette = {
"--vibeui-avatar-024-hue": hue(name),
...style,
} as CSSProperties
return (
<>
<style href="vibeui-avatar-024" precedence="medium">
{STYLES}
</style>
<div
{...props}
data-vibeui-block="avatar-024"
data-country={country}
className={className}
style={palette}
>
<span data-part="slot">
<span data-part="face" aria-hidden="true">
{initials(name)}
</span>
<span data-part="flag" aria-hidden="true" />
</span>
<span data-part="text">
<span data-part="name">{name}</span>
{/* Страна словом: полоски флага угадываются не всеми. */}
<span data-part="place">
{city}, {COUNTRY_LABEL[country]}
</span>
</span>
</div>
</>
)
}