پرش به محتوا

آکاردئون

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

import {
  Accordion,
  AccordionContent,

آکاردئون محتوای مرتبط را در بخش‌های قابل‌گسترش و روی‌هم‌چیدهٔ عمودی گروه‌بندی می‌کند — یک عنوان برای هر بخش، یک کلیک برای نمایش. بر پایهٔ Base UI Accordion ساخته شده و با دستور پخت نئوبروتالیستی استایل شده: حاشیه‌های ضخیم، سایه‌های سخت و تایپوگرافی پررنگ.

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

  • پرسش‌های متداول — کلاسیک‌ترین کاربرد. باز بودن فقط یک سؤال در هر لحظه، پاسخ‌ها را قابل‌اسکن نگه می‌دارد.
  • تنظیمات و فیلترها — گروه‌های کم‌استفاده را جمع کنید بدون آن‌که پنهان شوند.
  • صفحات پربار محتوا — جزئیات محصول، اطلاعات ارسال، changelogها.

نصب

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

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

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

کد زیر را کپی کنید و در پروژهٔ خود بچسبانید.

components/ui/accordion.tsx
"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 را متناسب با ساختار پروژهٔ خود به‌روزرسانی کنید.

استفاده

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

نمونه‌ها

پایه

یک accordion پایه که در هر لحظه یک آیتم را نشان می‌دهد. آیتم اول به‌صورت پیش‌فرض باز است.

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"

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

آکاردئون از الگوی WAI-ARIA Accordion پیروی می‌کند: تریگرها دکمه‌های واقعی‌اند که با aria-expanded و aria-controls سیم‌کشی شده‌اند تا صفحه‌خوان‌ها هر بخش و وضعیت آن را اعلام کنند.

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

کلیدعمل
Tab / Shift + Tabجابه‌جایی فوکوس بین تریگرها و خارج از آن‌ها
Space / Enterباز/بسته کردن بخش فوکوس‌شده
ArrowDown / ArrowUpانتقال فوکوس به تریگر بعدی / قبلی
Home / Endپرش به اولین / آخرین تریگر

مرجع API

برای اطلاعات بیشتر، مستندات Base UI را ببینید.