אקורדיון
סט של קטעים הניתנים להרחבה, המסודרים זה מעל זה, עבור שאלות נפוצות, הגדרות ודפים עתירי תוכן — עם עיצוב ניאו-ברוטליסטי הכולל מסגרות וצללים.
import {
Accordion,
AccordionContent,ה-accordion מקבץ תוכן קשור למקטעים אנכיים שניתנים לפתיחה — כותרת אחת לכל מקטע, לחיצה אחת לחשיפה. נבנה על גבי הפרימיטיב Base UI Accordion ומעוצב לפי המתכון הנאו-ברוטליסטי: מסגרות עבות, צללים חדים וטיפוגרפיה מודגשת.
השתמשו בו כש:
- שאלות נפוצות — הקלאסיקה. שאלה אחת פתוחה בכל פעם שומרת על תשובות קריאות.
- הגדרות ומסננים — מקפלים קבוצות שמשתמשים בהן לעיתים רחוקות בלי להסתיר אותן.
- עמודים עמוסי תוכן — פרטי מוצר, מידע משלוחים, changelogs.
התקנה#
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/accordion.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/accordion.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/accordion.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/accordion.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 { ChevronDownIcon } from "lucide-react"
import { Accordion as AccordionPrimitive } from "radix-ui"
import { cn } from "@/lib/utils"
// Smooth, premium easing for the open/close — fast out of the gate, gentle
// settle. Shared by the panel height and the chevron so they move in lockstep.
const EASE = "ease-[cubic-bezier(0.32,0.72,0,1)]"
function Accordion({
className,
...props
}: React.ComponentProps<typeof AccordionPrimitive.Root>) {
return (
<AccordionPrimitive.Root
data-slot="accordion"
className={cn("flex w-full flex-col gap-3", className)}
{...props}
/>
)
}
function AccordionItem({
className,
...props
}: React.ComponentProps<typeof AccordionPrimitive.Item>) {
return (
<AccordionPrimitive.Item
data-slot="accordion-item"
className={cn(
"overflow-hidden rounded border-2 bg-background text-foreground shadow-md transition-shadow duration-200 hover:shadow-sm data-[state=open]:shadow-sm",
className
)}
{...props}
/>
)
}
function AccordionTrigger({
className,
children,
...props
}: React.ComponentProps<typeof AccordionPrimitive.Trigger>) {
return (
<AccordionPrimitive.Header data-slot="accordion-header" className="flex">
<AccordionPrimitive.Trigger
data-slot="accordion-trigger"
className={cn(
"flex flex-1 cursor-pointer items-center justify-between gap-4 px-4 py-3 text-left font-head transition-colors hover:bg-muted/50 data-[state=open]:bg-muted/40 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary [&[data-state=open]>svg]:rotate-180",
className
)}
{...props}
>
{children}
<ChevronDownIcon
aria-hidden
data-slot="accordion-trigger-icon"
className={cn(
"h-4 w-4 shrink-0 text-muted-foreground transition-transform duration-300",
EASE
)}
/>
</AccordionPrimitive.Trigger>
</AccordionPrimitive.Header>
)
}
function AccordionContent({
className,
children,
...props
}: React.ComponentProps<typeof AccordionPrimitive.Content>) {
return (
<AccordionPrimitive.Content
data-slot="accordion-content"
// Radix publishes the measured height as `--radix-accordion-content-height`
// and toggles `data-state`. The accordion-down/up keyframes (in
// shadcn-tailwind.css) interpolate height between that var and 0 for a real
// slide open/close — the Base UI variant achieves the same via transitions.
className="group/panel overflow-hidden bg-card font-body text-sm text-muted-foreground data-[state=open]:animate-accordion-down data-[state=closed]:animate-accordion-up"
{...props}
>
<div
className={cn(
"px-4 pt-2 pb-4 transition-[opacity,transform] duration-300 ease-out",
// Fade + nudge the content as the panel opens/closes, synced to the slide.
"group-data-[state=closed]/panel:-translate-y-1 group-data-[state=closed]/panel:opacity-0",
"[&_a]:underline [&_a]:underline-offset-3 [&_a]:hover:text-foreground [&_p:not(:last-child)]:mb-4",
className
)}
>
{children}
</div>
</AccordionPrimitive.Content>
)
}
export { Accordion, AccordionItem, AccordionTrigger, AccordionContent }
עדכנו את נתיבי הייבוא כך שיתאימו למבנה הפרויקט שלכם.
שימוש#
import {
Accordion,
AccordionContent,
AccordionItem,
AccordionTrigger,
} from "@/components/ui/accordion"<Accordion defaultValue={["item-1"]}>
<AccordionItem value="item-1">
<AccordionTrigger>Is it accessible?</AccordionTrigger>
<AccordionContent>
Yes. It adheres to the WAI-ARIA design pattern.
</AccordionContent>
</AccordionItem>
</Accordion>קומפוזיציה#
השתמשו בקומפוזיציה הבאה כדי לבנות Accordion:
Accordion
├── AccordionItem
│ ├── AccordionTrigger
│ └── AccordionContent
└── AccordionItem
├── AccordionTrigger
└── AccordionContentדוגמאות#
בסיסי#
אקורדיון בסיסי שמציג פריט אחד בכל פעם. הפריט הראשון פתוח כברירת מחדל.
import {
Accordion,
AccordionContent,מרובה#
השתמשו במאפיין multiple כדי לאפשר לכמה פריטים להיות פתוחים בו-זמנית.
import {
Accordion,
AccordionContent,מושבת#
השתמשו במאפיין disabled על AccordionItem כדי להשבית פריטים בודדים.
import {
Accordion,
AccordionContent,מסגרות#
הוסיפו border ל-Accordion ו-border-b last:border-b-0 ל-AccordionItem כדי להוסיף מסגרות לפריטים.
import {
Accordion,
AccordionContent,כרטיס#
עטפו את ה-Accordion ברכיב Card.
import {
Accordion,
AccordionContent,RTL#
כדי להפעיל RTL ב-Neobrutalism, עיינו במדריך ההגדרה של RTL.
"use client"
import * as React from "react"נגישות#
ה-accordion עוקב אחרי דפוס Accordion של WAI-ARIA: הטריגרים הם כפתורים אמיתיים מחווטים עם aria-expanded ו-aria-controls, כך שקוראי מסך מכריזים על כל מקטע ועל מצבו.
אינטראקציות מקלדת:
| מקש | פעולה |
|---|---|
Tab / Shift + Tab | מעבירים את המוקד בין טריגרים והחוצה |
Space / Enter | מחליפים את המקטע שבפוקוס |
ArrowDown / ArrowUp | מעבירים מוקד לטריגר הבא / הקודם |
Home / End | קופצים לטריגר הראשון / האחרון |
תיעוד ה-API#
למידע נוסף, עיינו בתיעוד של Base UI.