کاستومایز
Pop Menuمنو و ناوبری
منوی پاپآپ
یه دکمهٔ گردِ کوچیک که با کلیک باز میشه و به یه منوی کامل تبدیل میشه؛ نشانگرِ پسزمینه با حرکتِ فنری بین گزینهها جابهجا میشه و «خروج» منو رو میبنده.
وابستگیها
نوع تعامل
دکمهٔ گرد رو بزن: قاب با فنر باز میشه، آیتمها پلکانی میان و نشانگرِ فنری میره سراغ گزینهٔ فعال. با هاور روی هر گزینه، نشانگر دنبالش میره. گزینهٔ خطر («خروج») قرمزه و با انتخابش منو بسته میشه. Escape یا کلیک بیرون هم میبنده؛ Enter و Space هم باز میکنن و هم گزینه رو انتخاب میکنن.
پراپها
گزینههایی که میتونی به کامپوننت بدی؛ ستارهدارها اجباریاند.
itemsPopMenuItem[]گزینههای منو؛ هر آیتم `{ id, label, icon, danger }` دارد و جداکننده فقط `{ id, divider: true }`. ندی؟ همین منوی فارسیِ خودِ کامپوننت میآد.
openbooleanباز بودنِ کنترلشده. اگه نمیدی، کامپوننت خودش وضعیت رو نگه میداره.
defaultOpenbooleanپیشفرض: falseحالتِ اولیه در حالتِ کنترلنشده.
onOpenChange(open: boolean) => voidبا هر باز یا بسته شدن صدا زده میشه.
activeIdstringگزینهٔ فعالِ کنترلشده — جای نشانگرِ فنری رو تعیین میکنه.
defaultActiveIdstringپیشفرض: اولین گزینهٔ غیرِجداکنندهگزینهٔ فعالِ اول در حالتِ کنترلنشده.
نصب
۱. این آدرس رو یکبار توی components.json بذار تا shadcn مخزن فارسیفای رو بشناسه.
{
"registries": {
"@farsify": "https://farsifyui.ir/r/{name}.json"
}
}۲. بعد با دستور زیر کامپوننت رو نصب کن.
npx shadcn@latest add @farsify/pop-menuپیشنیاز: Tailwind CSS v4 و صفحهٔ راستبهچپ dir="rtl".
نمونه
"use client";
import { useState } from "react";
import { PopMenu } from "@/components/farsify/pop-menu";
export function AccountMenu() {
return <PopMenu />;
}
// کنترلشده — باز/بسته و گزینهٔ فعال را خودت نگه میداری
export function ControlledMenu() {
const [open, setOpen] = useState(false);
const [active, setActive] = useState("profile");
return (
<PopMenu
open={open}
onOpenChange={setOpen}
activeId={active}
onSelect={setActive}
/>
);
}
// عریضتر با فنرِ نرمتر
<PopMenu width={244} stiffness={300} damping={40} />
// آیتمِ خطر — قرمز میشود و با انتخاب، منو را میبندد
<PopMenu
items={[
{ id: "rename", label: "تغییر نام" },
{ id: "remove", label: "حذف", danger: true },
]}
/>نکتهها
- آیکنها هر گرهای میتونن باشن؛ svg ساده با viewBox ۲۴ کافیه — خودِ کامپوننت هیچ وابستگیِ آیکنی نداره.
- `danger` فقط قرمز نمیکنه؛ با انتخابش منو هم بسته میشه — برای هر کنشِ یکطرفه مثل خروج و حذف مناسبه.
- با `className="absolute ..."` دکمه رو لنگر کن و منو مثل popover از همون نقطه باز میشه؛ در پیشنمایشِ سایت هم همین کار شده.
همخانوادهها
کامپوننتهای دیگری از همان دسته که با این یکی جور درمیآیند.
مجوز
کد بعد از نصب مال خودته؛ هر تغییری خواستی بده و توی پروژهی خودت نگهش دار. برای پروژههای شخصی و تجاری آزاده، حتی اگه کدت بسته باشه. فقط اسم و لینک فارسیفای رو یه جا توی پروژه نگه دار.