Espandibile
Expandable crea un semplice controllo per mostrare o nascondere contenuti non essenziali al flusso principale.
Usa Expandable per nascondere risposte API dettagliate, procedure di risoluzione dei problemi o informazioni supplementari che interromperebbero il flusso di lettura. Viene visualizzato come un singolo elemento espandibile cliccabile. È più leggero di Accordion, progettato per sezioni raggruppate e navigabili.
Usa Expandable quando:
- I dettagli supplementari interromperebbero la narrazione principale
- Le informazioni facoltative sono utili solo per alcuni lettori
- I contenuti lunghi (come le risposte API complete) devono essere compressi per impostazione predefinita
Utilizzo di base
<Expandable title="Show more details">
These details are hidden by default and revealed when clicked.
</Expandable>Aperto per impostazione predefinita
Inizia espanso:
Questa sezione è visibile all'apertura.
<Expandable title="Expanded by default" defaultOpen>
This section starts visible.
</Expandable>Casi d'uso comuni
Dettagli della risposta API
Comprimi le risposte dettagliate che interromperebbero altrimenti il flusso della documentazione:
Procedura di risoluzione dei problemi
Proprietà
Testo dell'intestazione della sezione.
Avvia la sezione espansa.
Expandable e Accordion
| Funzionalità | Expandable | Accordion |
|---|---|---|
| Scopo | Nascondere contenuti supplementari | Organizzare sezioni di pari importanza |
| Icone | No | Sì |
| Descrizioni | No | Sì (supporto per sottotitoli) |
| Raggruppamento | Autonomo | Può essere raggruppato con AccordionGroup |
| Ideale per | Dettagli facoltativi, esempi lunghi | Domande frequenti, elenchi di funzionalità, navigazione |
Regola generale: se il contenuto è "utile ma non indispensabile", usa Expandable. Se gli utenti devono scegliere tra più sezioni, usa Accordion.