نافذة منبثقة
لوحة عائمة مرتبطة بآلية تشغيل لأدوات اختيار التاريخ، والمرشحات، والنماذج المضمنة — مع تصميم «النيوبروتاليستي» الذي يتميز بالحدود والظلال.
import { Button } from "@/components/ui/button"
import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"يعرض النافذة المنبثقة محتوىً غنيًّا في لوحة عائمة مثبتة عند نقطة التشغيل — تُفتح بالنقر، وتُغلق بالنقر خارجها أو بالضغط على Esc. وهي مبنية على مكون Base UI Popover ومصممة وفقًا لأسلوب «النيوبروتالية»: حدود سميكة، وظلال حادة، وخط عريض.
استخدمه عندما:
- النماذج المضمنة — إعادة تسمية عنصر، أو تعيين الأبعاد، أو تعديل إعداد واحد دون فتح مربع حوار كامل.
- أدوات اختيار التاريخ واللون — ربط التقويم أو شبكة عينات الألوان مباشرةً بحقل الإدخال الخاص بها.
- شريط الأدوات وفلاتر الجداول — تجميع خانات الاختيار والنطاقات خلف مشغل مدمج.
التثبيت#
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/popover.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/popover.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/popover.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/popover.json
ثبّت التبعيات التالية:
pnpm add @base-ui/reactnpm install @base-ui/reactyarn add @base-ui/reactbun add @base-ui/react
انسخ والصق الكود التالي في مشروعك.
"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 {
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أمثلة#
أساسي#
نافذة منبثقة بسيطة تحتوي على رأس وعنوان ووصف.
import { Button } from "@/components/ui/button"
import {
Popover,محاذاة#
استخدم الخاصية align على PopoverContent للتحكّم في المحاذاة الأفقية.
import { Button } from "@/components/ui/button"
import {
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 {إمكانية الوصول#
يتبع النافذة المنبثقة WAI-ARIA Dialog pattern في شكلها غير النمطي: يحمل المشغل aria-haspopup="dialog" و aria-expanded و aria-controls، ويتم عرض اللوحة على أنها role="dialog" — ينتقل التركيز إليها عند الفتح ويعود إلى المشغل عند الإغلاق.
تفاعلات لوحة المفاتيح:
| المفتاح | الإجراء |
|---|---|
Space / Enter | فتح أو إغلاق النافذة المنبثقة من الزر المشغل |
Tab / Shift + Tab | نقل التركيز عبر العناصر القابلة للتركيز في اللوحة |
Esc | إغلاق النافذة المنبثقة وإعادة التركيز إلى المشغل |
مرجع API#
راجع وثائق Base UI Popover.