Vista
Crea documentazione che si adatta alla scelta di framework o lingua del lettore. Intere sezioni cambiano in base alla selezione dell'utente.
Le viste cambiano intere sezioni di una pagina per adattarsi al framework o alla lingua scelti dal lettore. Le schede mostrano le opzioni affiancate. Le viste nascondono completamente il contenuto non selezionato. Usale quando intere sezioni differiscono tra i vari framework.
Usa le Viste quando:
- Intere sezioni della pagina differiscono per framework (non solo frammenti di codice)
- I tutorial hanno passaggi diversi per tecnologie diverse
- Le guide introduttive differiscono per 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
Una pagina con componenti View funziona così:
- Un selettore a tendina appare in cima al contenuto
- I lettori passano da una vista all'altra con la tendina
- È visibile solo il contenuto della vista selezionata
View, Tabs e CodeGroup a confronto
| Componente | Ideale per | Ambito |
|---|---|---|
| View | Intere sezioni che differiscono per framework | Cambio di contenuto a livello di pagina |
| Tabs | Confronti rapidi, gestori di pacchetti | Cambio di contenuto in linea |
| CodeGroup | Stessa operazione in più linguaggi | Solo blocchi di codice |
Scenari di esempio:
- "Installa con npm vs yarn" → Tabs (differenza minima)
- "JavaScript fetch vs Python requests" → CodeGroup (confronto di codice)
- "Tutorial React vs tutorial Vue" → View (intera sezione diversa)
Props
stringrequiredIl titolo visualizzato nel selettore a tendina. Deve essere univoco all'interno della pagina.
stringUn'icona Font Awesome, 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.
