<!-- Generado automáticamente por scripts/generate-docs.mjs. No editar a mano. -->
<!-- Fuente: src/app/componentes/accordion/page.tsx -->

# Accordion

Agrupa secciones relacionadas de contenido que se pueden abrir y cerrar para administrar la densidad de información.

```tsx
import { Accordion, AccordionHeader, AccordionItem, AccordionPanel } from "@fluentui/react-components";

<Accordion collapsible>
  <AccordionItem value="intro">
    <AccordionHeader>What is Lexy Design?</AccordionHeader>
    <AccordionPanel>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit...</p>
      <p>Duis aute irure dolor in reprehenderit in voluptate...</p>
    </AccordionPanel>
  </AccordionItem>
  <AccordionItem value="detalle">
    <AccordionHeader>How do I get started?</AccordionHeader>
    <AccordionPanel>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit...</p>
    </AccordionPanel>
  </AccordionItem>
  <AccordionItem value="cierre">
    <AccordionHeader>Where can I learn more?</AccordionHeader>
    <AccordionPanel>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit...</p>
    </AccordionPanel>
  </AccordionItem>
</Accordion>
```

## Descripción general

Los acordeones disminuyen la carga cognitiva al permitir que las personas elijan qué secciones de contenido desean ver, similar a las preguntas en una sección de preguntas frecuentes.

Nunca pongas información requerida para la tarea actual dentro de un acordeón. Considera un tratamiento que le dé más prominencia.

## Cuándo usar

### ✓ Usa acordeones cuando

- Necesitas organizar contenido extenso en secciones escaneables
- El usuario no necesita ver toda la información al mismo tiempo
- Quieres reducir el desplazamiento vertical en la página
- Tienes secciones de preguntas frecuentes o ayuda contextual

### ✗ Evita acordeones cuando

- El contenido es breve y cabe cómodamente en la vista
- La información de una sección depende de otra sección
- El usuario necesita comparar información entre secciones
- El contenido es crítico para completar una tarea

## Comportamiento

### Cerrado por defecto

Por defecto, los elementos del acordeón están cerrados. Usa `collapsible` para que un panel abierto pueda cerrarse con otro click en su encabezado.

### Múltiples elementos abiertos

Sin `multiple`, abrir un panel cierra cualquier otro panel abierto. Con `multiple`, varios paneles pueden permanecer abiertos al mismo tiempo.

## Ejemplos

### Default

Un acordeón simple donde cada panel se puede abrir o cerrar.

```tsx
<Accordion collapsible>
  <AccordionItem value="1">
    <AccordionHeader>What is a design system?</AccordionHeader>
    <AccordionPanel>
      <div>Lorem ipsum dolor sit amet...</div>
      <div>Duis aute irure dolor...</div>
    </AccordionPanel>
  </AccordionItem>
</Accordion>
```

### Expanded

Panel abierto por defecto usando `defaultOpenItems`.

```tsx
<Accordion collapsible defaultOpenItems={["1"]}>
  <AccordionItem value="1">
    <AccordionHeader>Why use components?</AccordionHeader>
    <AccordionPanel>
      <div>Lorem ipsum dolor sit amet...</div>
      <div>Duis aute irure dolor...</div>
    </AccordionPanel>
  </AccordionItem>
</Accordion>
```

### Multiple

Permite que múltiples paneles estén abiertos simultáneamente.

```tsx
<Accordion multiple collapsible>
  <AccordionItem value="1">
    <AccordionHeader>Typography</AccordionHeader>
    <AccordionPanel>
      <div>Lorem ipsum dolor sit amet...</div>
    </AccordionPanel>
  </AccordionItem>
  <AccordionItem value="2">
    <AccordionHeader>Color</AccordionHeader>
    <AccordionPanel>
      <div>Lorem ipsum dolor sit amet...</div>
    </AccordionPanel>
  </AccordionItem>
  <AccordionItem value="3">
    <AccordionHeader>Spacing</AccordionHeader>
    <AccordionPanel>
      <div>Lorem ipsum dolor sit amet...</div>
    </AccordionPanel>
  </AccordionItem>
</Accordion>
```

### Small

Contenido más compacto con menos texto.

```tsx
<Accordion collapsible>
  <AccordionItem value="1">
    <AccordionHeader>How do I get started?</AccordionHeader>
    <AccordionPanel>
      <div>Lorem ipsum dolor sit amet...</div>
    </AccordionPanel>
  </AccordionItem>
</Accordion>
```

## Accesibilidad

Los encabezados del acordeón tienen un rol de botón que los hace perceptibles para las tecnologías de asistencia. Cuando un elemento del acordeón está abierto, sus propiedades `aria-expanded` y `active` deben establecerse en true.

### Navegación por teclado

- **Tab/Shift+Tab:** Navega entre los encabezados del acordeón
- **Enter/Space:** Expande o colapsa el panel actual
- **Flecha Arriba/Abajo:** Mueve el foco entre encabezados
- **Home/End:** Mueve el foco al primer/último encabezado

