Pannello
Usa Panel per fissare contenuti personalizzati, come avvisi o riferimenti rapidi, nella barra laterale, mantenendoli visibili mentre i lettori scorrono.
Panel consente di visualizzare contenuti personalizzati nella barra laterale destra invece del Table of Contents predefinito. Il contenuto rimane visibile mentre i lettori scorrono la pagina. Usalo per informazioni che devono essere sempre visibili: riferimenti rapidi, avvisi importanti o link all'assistenza.
Usa Panel quando:
- Le informazioni critiche non devono scomparire durante lo scorrimento
- Il materiale di consultazione rapida completa il contenuto principale
- Gli inviti all'azione persistenti devono rimanere visibili (link all'assistenza, chiavi API)
Questa nota viene visualizzata nel pannello della barra laterale!
Scorri verso il basso per vedere che il pannello rimane visibile.
Utilizzo di base
Racchiudi qualsiasi contenuto in Panel per visualizzarlo nella barra laterale destra:
<Panel>
<Info>This content appears in the sidebar!</Info>
</Panel>
Casi d'uso comuni
I pannelli sono ideali per avvisi fissati, schede di consultazione rapida e link all'assistenza:
<Panel>
<Warning>
API rate limits: 100 requests/minute
</Warning>
<Card title="Quick Reference" icon="list">
**Methods:** GET, POST, PUT, DELETE
**Auth:** Bearer token required
</Card>
<Card title="Need Help?" icon="circle-question" href="https://example.com/support">
Contact our support team
</Card>
</Panel>
Quando NON usare Panel
- Pagine brevi: il Table of Contents aiuta gli utenti a navigare; sostituiscilo solo quando hai contenuti più preziosi
- Documentazione standard: per la maggior parte delle pagine, il ToC predefinito funziona meglio
- Utenti mobili: il contenuto di Panel è nascosto sugli schermi più piccoli, quindi assicurati che le informazioni critiche siano presenti anche nel contenuto principale
Comportamento
- Viene visualizzato nella barra laterale destra su desktop (1280px+), nascosto sugli schermi più piccoli
- Un solo Panel per pagina; sostituisce interamente il Table of Contents
- Supporta qualsiasi componente: Callout, Card, CodeGroup, Accordion e così via
