Pop Menuمنو و ناوبری

منوی پاپ‌آپ

یه دکمهٔ گردِ کوچیک که با کلیک باز میشه و به یه منوی کامل تبدیل میشه؛ نشانگرِ پس‌زمینه با حرکتِ فنری بین گزینه‌ها جابه‌جا میشه و «خروج» منو رو می‌بنده.

پیش‌نمایش منوی پاپ‌آپ
اختصاصی فارسی‌فایطراحی و توسعه در فارسی‌فای

وابستگی‌ها

motion

نوع تعامل

دکمهٔ گرد رو بزن: قاب با فنر باز میشه، آیتم‌ها پلکانی میان و نشانگرِ فنری می‌ره سراغ گزینهٔ فعال. با هاور روی هر گزینه، نشانگر دنبالش می‌ره. گزینهٔ خطر («خروج») قرمزه و با انتخابش منو بسته میشه. Escape یا کلیک بیرون هم می‌بنده؛ Enter و Space هم باز می‌کنن و هم گزینه رو انتخاب می‌کنن.

پراپ‌ها

گزینه‌هایی که می‌تونی به کامپوننت بدی؛ ستاره‌دارها اجباری‌اند.

items
PopMenuItem[]

گزینه‌های منو؛ هر آیتم `{ id, label, icon, danger }` دارد و جداکننده فقط `{ id, divider: true }`. ندی؟ همین منوی فارسیِ خودِ کامپوننت می‌آد.

open
boolean

باز بودنِ کنترل‌شده. اگه نمی‌دی، کامپوننت خودش وضعیت رو نگه می‌داره.

defaultOpen
booleanپیش‌فرض: false

حالتِ اولیه در حالتِ کنترل‌نشده.

onOpenChange
(open: boolean) => void

با هر باز یا بسته شدن صدا زده می‌شه.

activeId
string

گزینهٔ فعالِ کنترل‌شده — جای نشانگرِ فنری رو تعیین می‌کنه.

defaultActiveId
stringپیش‌فرض: اولین گزینهٔ غیرِجداکننده

گزینهٔ فعالِ اول در حالتِ کنترل‌نشده.

نصب

۱. این آدرس رو یک‌بار توی components.json بذار تا shadcn مخزن فارسی‌فای رو بشناسه.

components.jsonjson
{
  "registries": {
    "@farsify": "https://farsifyui.ir/r/{name}.json"
  }
}

۲. بعد با دستور زیر کامپوننت رو نصب کن.

npx shadcn@latest add @farsify/pop-menu

پیش‌نیاز: Tailwind CSS v4 و صفحهٔ راست‌به‌چپ dir="rtl".

نمونه

pop-menu.tsxtsx
"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 از همون نقطه باز میشه؛ در پیش‌نمایشِ سایت هم همین کار شده.

هم‌خانواده‌ها

کامپوننت‌های دیگری از همان دسته که با این یکی جور درمی‌آیند.

مجوز

کد بعد از نصب مال خودته؛ هر تغییری خواستی بده و توی پروژه‌ی خودت نگهش دار. برای پروژه‌های شخصی و تجاری آزاده، حتی اگه کدت بسته باشه. فقط اسم و لینک فارسی‌فای رو یه جا توی پروژه نگه دار.