Viste
Crea documentazione che si adatta al framework o alla scelta linguistica del lettore. Intere sezioni cambiano in base alla selezione.
Le viste consentono di creare documentazione che si adatta al framework o alla scelta linguistica del lettore. A differenza delle Tabs (che mostrano più opzioni affiancate), le viste nascondono completamente i contenuti non selezionati. Questo mantiene la pagina più ordinata quando intere sezioni differiscono tra i framework.
Usa le viste quando:
- Intere sezioni della pagina differiscono in base al framework, non solo gli snippet di codice
- I tutorial hanno passaggi diversi per tecnologie diverse
- Le guide introduttive variano significativamente in base alla piattaforma
Utilizzo di base
Crea viste per linguaggi diversi:
<View title="JavaScript" icon="js">
This content is only visible when JavaScript is selected.
```javascript
console.log("Hello from JavaScript!");
```
</View>
<View title="Python" icon="python">
This content is only visible when Python is selected.
```python
print("Hello from Python!")
```
</View>
Come funziona
Quando aggiungi componenti View a una pagina:
- Nella parte superiore del contenuto viene visualizzato un selettore a discesa
- Gli utenti possono passare da una vista all'altra usando il selettore a discesa
- È visibile solo il contenuto della vista selezionata
View, Tabs e CodeGroup a confronto
| Componente | Ideale per | Ambito |
|---|---|---|
| View | Intere sezioni che differiscono in base al framework | Cambio del contenuto dell'intera pagina |
| Tabs | Confronti rapidi, gestori di pacchetti | Cambio del contenuto in linea |
| CodeGroup | La stessa operazione in più linguaggi | Solo blocchi di codice |
Esempi:
- "Installazione con npm o yarn" → Tabs (differenza minima)
- "fetch in JavaScript o requests in Python" → CodeGroup (confronto tra codice)
- "Tutorial per React o Vue" → View (l'intera sezione differisce)
Props
stringrequiredIl titolo visualizzato nel selettore a discesa. Deve essere univoco all'interno della pagina.
stringUn'icona Font Awesome, un'icona Lucide, un URL di un'icona o un percorso relativo a un'icona.
stringdefault: solidSolo per le icone Font Awesome. Opzioni: regular, solid, light, thin, sharp-solid, duotone, brands.
