📖 Descrição do Arquivo
O arquivo Accordion.jsx
define um componente de Acordeão reutilizável utilizando o Radix UI e o ícone de seta do lucide-react
. Ele permite a criação de um painel expansível que pode ser utilizado para mostrar ou esconder conteúdo. Esse tipo de componente é comum em interfaces que requerem economizar espaço ou agrupar informações relacionadas.
🔧 Componente de Acordeão
Este componente usa o Radix UI para criar um comportamento de acordeão, onde apenas um painel pode estar expandido por vez. A estrutura é composta por três principais componentes:
Accordion
: O componente raiz que envolve todos os itens do acordeão.AccordionItem
: Define os itens individuais dentro do acordeão.AccordionTrigger
: O gatilho para abrir e fechar o conteúdo do item.AccordionContent
: O conteúdo que é mostrado ou ocultado quando o item é expandido ou recolhido.
⚙️ Explicação do Código
"use client"
import * as React from "react"
import * as AccordionPrimitive from "@radix-ui/react-accordion"
import { ChevronDown } from "lucide-react"
import { cn } from "@/lib/utils"
- Importações: Começamos importando o React, o módulo necessário do Radix UI (
@radix-ui/react-accordion
) e o íconeChevronDown
delucide-react
. A funçãocn
é usada para concatenar classes de forma condicional.
🧑💻 Componentes
1. Accordion
const Accordion = AccordionPrimitive.Root
Accordion
: Este é o componente raiz, importado diretamente do Radix UI. Ele envolve os itens do acordeão, proporcionando o comportamento de expansão.
2. AccordionItem
const AccordionItem = React.forwardRef(({ className, ...props }, ref) => (
<AccordionPrimitive.Item ref={ref} className={cn("border-b", className)} {...props} />
))
AccordionItem.displayName = "AccordionItem"
AccordionItem
: Cada item do acordeão é encapsulado por este componente. Ele usaforwardRef
para poder ser referenciado diretamente, e o estiloborder-b
é aplicado para dar uma linha de separação entre os itens. A classe condicionalclassName
permite personalizar ainda mais o estilo.
3. AccordionTrigger
const AccordionTrigger = React.forwardRef(({ className, children, ...props }, ref) => (
<AccordionPrimitive.Header className="flex">
<AccordionPrimitive.Trigger
ref={ref}
className={cn(
"flex flex-1 items-center justify-between py-4 font-medium transition-all hover:underline [&[data-state=open]>svg]:rotate-180",
className
)}
{...props}>
{children}
<ChevronDown className="h-4 w-4 shrink-0 transition-transform duration-200" />
</AccordionPrimitive.Trigger>
</AccordionPrimitive.Header>
))
AccordionTrigger.displayName = AccordionPrimitive.Trigger.displayName
AccordionTrigger
: O gatilho de cada item do acordeão, geralmente um título ou cabeçalho. Ele usaforwardRef
para permitir o acesso ao componente diretamente. A classe CSShover:underline
aplica um sublinhado quando o mouse passa sobre o gatilho, e a seta (ChevronDown
) gira quando o estado do acordeão está aberto.
4. AccordionContent
const AccordionContent = React.forwardRef(({ className, children, ...props }, ref) => (
<AccordionPrimitive.Content
ref={ref}
className="overflow-hidden text-sm transition-all data-[state=closed]:animate-accordion-up data-[state=open]:animate-accordion-down"
{...props}>
<div className={cn("pb-4 pt-0", className)}>{children}</div>
</AccordionPrimitive.Content>
))
AccordionContent
: Define o conteúdo que será exibido ou ocultado. O conteúdo possui uma animação de transição, que faz o painel se expandir ou recolher suavemente. A classeoverflow-hidden
garante que o conteúdo extra não seja exibido quando o painel estiver fechado.
🧑💻 Código Completo
"use client"
import * as React from "react"
import * as AccordionPrimitive from "@radix-ui/react-accordion"
import { ChevronDown } from "lucide-react"
import { cn } from "@/lib/utils"
const Accordion = AccordionPrimitive.Root
const AccordionItem = React.forwardRef(({ className, ...props }, ref) => (
<AccordionPrimitive.Item ref={ref} className={cn("border-b", className)} {...props} />
))
AccordionItem.displayName = "AccordionItem"
const AccordionTrigger = React.forwardRef(({ className, children, ...props }, ref) => (
<AccordionPrimitive.Header className="flex">
<AccordionPrimitive.Trigger
ref={ref}
className={cn(
"flex flex-1 items-center justify-between py-4 font-medium transition-all hover:underline [&[data-state=open]>svg]:rotate-180",
className
)}
{...props}>
{children}
<ChevronDown className="h-4 w-4 shrink-0 transition-transform duration-200" />
</AccordionPrimitive.Trigger>
</AccordionPrimitive.Header>
))
AccordionTrigger.displayName = AccordionPrimitive.Trigger.displayName
const AccordionContent = React.forwardRef(({ className, children, ...props }, ref) => (
<AccordionPrimitive.Content
ref={ref}
className="overflow-hidden text-sm transition-all data-[state=closed]:animate-accordion-up data-[state=open]:animate-accordion-down"
{...props}>
<div className={cn("pb-4 pt-0", className)}>{children}</div>
</AccordionPrimitive.Content>
))
AccordionContent.displayName = AccordionPrimitive.Content.displayName
export { Accordion, AccordionItem, AccordionTrigger, AccordionContent }