پرش به محتوا

پاپ‌اور

یک پنل شناور متصل به ماشه‌ای برای انتخابگرهای تاریخ، فیلترها و فرم‌های درون‌خطی — با جلوه‌ی نئوبروتالیستی حاشیه‌ها و سایه‌ها.

import { Button } from "@/components/ui/button"
import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"

Popover محتوای غنی را در پنلی شناور مهارشده به تریگرش نشان می‌دهد — با کلیک باز می‌شود، با کلیک بیرون یا فشردن Esc بسته می‌شود. بر پایهٔ Base UI Popover ساخته شده و با دستور پخت نئوبروتالیستی استایل شده: حاشیه‌های ضخیم، سایه‌های سخت و تایپوگرافی پررنگ.

برای این موارد از آن استفاده کنید:

  • فرم درون‌خطی — rename یک آیتم، تنظیم ابعاد، یا یک تنظیم کوچک بدون باز کردن دیالوگ کامل.
  • انتخابگر تاریخ و رنگ — تقویم یا شبکهٔ swatch را مستقیم به input مهار کنید.
  • فیلتر نوار ابزار و جدول — چک‌باکس و بازه را پشت تریگر فشرده روی هم بچینید.

نصب

pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/popover.json
npx shadcn@latest add https://neobrutalism.com/r/base/popover.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/popover.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/popover.json

وابستگی‌های زیر را نصب کنید:

pnpm add @base-ui/react
npm install @base-ui/react
yarn add @base-ui/react
bun add @base-ui/react

کد زیر را کپی کرده و در پروژهٔ خود جای‌گذاری کنید.

components/ui/popover.tsx
"use client"

import * as React from "react"
import { Popover as PopoverPrimitive } from "radix-ui"

import { cn } from "@/lib/utils"

function Popover({
  ...props
}: React.ComponentProps<typeof PopoverPrimitive.Root>) {
  return <PopoverPrimitive.Root data-slot="popover" {...props} />
}

function PopoverTrigger({
  ...props
}: React.ComponentProps<typeof PopoverPrimitive.Trigger>) {
  return <PopoverPrimitive.Trigger data-slot="popover-trigger" {...props} />
}

function PopoverContent({
  className,
  align = "center",
  sideOffset = 4,
  ...props
}: React.ComponentProps<typeof PopoverPrimitive.Content>) {
  return (
    <PopoverPrimitive.Portal>
      <PopoverPrimitive.Content
        data-slot="popover-content"
        align={align}
        sideOffset={sideOffset}
        className={cn(
          "z-50 flex w-72 origin-(--radix-popover-content-transform-origin) flex-col gap-2.5 rounded border-2 bg-popover p-2.5 text-sm text-popover-foreground shadow-md outline-hidden duration-100 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95",
          className
        )}
        {...props}
      />
    </PopoverPrimitive.Portal>
  )
}

function PopoverAnchor({
  ...props
}: React.ComponentProps<typeof PopoverPrimitive.Anchor>) {
  return <PopoverPrimitive.Anchor data-slot="popover-anchor" {...props} />
}

function PopoverHeader({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="popover-header"
      className={cn("flex flex-col gap-0.5 text-sm", className)}
      {...props}
    />
  )
}

function PopoverTitle({ className, ...props }: React.ComponentProps<"h2">) {
  return (
    <div
      data-slot="popover-title"
      className={cn("font-medium", className)}
      {...props}
    />
  )
}

function PopoverDescription({
  className,
  ...props
}: React.ComponentProps<"p">) {
  return (
    <p
      data-slot="popover-description"
      className={cn("text-muted-foreground", className)}
      {...props}
    />
  )
}

export {
  Popover,
  PopoverAnchor,
  PopoverContent,
  PopoverDescription,
  PopoverHeader,
  PopoverTitle,
  PopoverTrigger,
}

مسیرهای import را مطابق با پیکربندی پروژهٔ خود به‌روزرسانی کنید.

استفاده

import {
  Popover,
  PopoverContent,
  PopoverDescription,
  PopoverHeader,
  PopoverTitle,
  PopoverTrigger,
} from "@/components/ui/popover"
<Popover>
  <PopoverTrigger render={<Button variant="outline" />}>
    Open Popover
  </PopoverTrigger>
  <PopoverContent>
    <PopoverHeader>
      <PopoverTitle>Title</PopoverTitle>
      <PopoverDescription>Description text here.</PopoverDescription>
    </PopoverHeader>
  </PopoverContent>
</Popover>

ترکیب

برای ساخت یک Popover، از ترکیب زیر استفاده کنید:

Popover
├── PopoverTrigger
└── PopoverContent

نمونه‌ها

پایه

یک popover ساده با سرصفحه، عنوان و توضیح.

import { Button } from "@/components/ui/button"
import {
  Popover,

هم‌ترازی

برای کنترل هم‌ترازی افقی، از ویژگی align روی PopoverContent استفاده کنید.

import { Button } from "@/components/ui/button"
import {
  Popover,

همراه با فرم

یک popover با فیلدهای فرم در داخل آن.

import { Button } from "@/components/ui/button"
import { Field, FieldGroup, FieldLabel } from "@/components/ui/field"
import { Input } from "@/components/ui/input"

RTL

برای فعال‌سازی پشتیبانی RTL در Neobrutalism، راهنمای پیکربندی RTL را ببینید.

"use client"

import {

دسترسی‌پذیری

Popover از الگوی WAI-ARIA Dialog در شکل non-modal پیروی می‌کند: تریگر aria-haspopup="dialog"، aria-expanded و aria-controls دارد و پنل به‌صورت role="dialog" رندر می‌شود — فوکوس هنگام باز شدن وارد می‌شود و هنگام بستن به تریگر برمی‌گردد.

تعاملات صفحه‌کلید:

کلیدعمل
Space / Enterباز یا بستن popover از تریگر
Tab / Shift + Tabحرکت فوکوس در عناصر focusable پنل
Escبستن popover و بازگرداندن فوکوس به تریگر

مرجع API

مستندات Base UI Popover را ببینید.