Expandable
Expandable crea un sencillo interruptor mostrar/ocultar para contenido que los lectores pueden querer ver pero que no es esencial para el flujo principal.
Usa Expandable para guardar respuestas API detalladas, pasos de solución de problemas o detalles complementarios que de otro modo interrumpirían el flujo de lectura. Se renderiza como una única divulgación clicable — más ligera que Accordion, que está diseñado para secciones agrupadas y navegables.
Usa Expandable cuando:
- Detalles complementarios interrumpirían la narrativa principal
- Información opcional beneficia a algunos lectores pero no a todos
- Contenido extenso (como respuestas API completas) debe estar contraído por defecto
Uso básico
<Expandable title="Show more details">
These details are hidden by default and revealed when clicked.
</Expandable>Abierto por defecto
Comenzar expandido:
Esta sección comienza visible.
<Expandable title="Expanded by default" defaultOpen>
This section starts visible.
</Expandable>Casos de uso comunes
Detalles de respuesta API
Contrae respuestas detalladas que de otro modo interrumpirían el flujo de la documentación:
Pasos de solución de problemas
Props
Texto del encabezado de la sección.
Comenzar expandido.
Expandable vs Accordion
| Característica | Expandable | Accordion |
|---|---|---|
| Propósito | Ocultar contenido complementario | Organizar secciones de igual importancia |
| Iconos | No | Sí |
| Descripciones | No | Sí (soporte de subtítulos) |
| Agrupación | Independiente | Se puede agrupar con AccordionGroup |
| Mejor para | Detalles opcionales, ejemplos largos | Preguntas frecuentes, listas de características, navegación |
Regla general: Si el contenido es "bueno tener", usa Expandable. Si los usuarios necesitan elegir entre secciones, usa Accordion.