Jamdesk Documentation logo

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

Per gli esempi di codice che differiscono in base al linguaggio, usa CodeGroup. Per le procedure con differenze minori, usa Tabs. Usa le viste quando intere sezioni del contenuto dipendono dal framework.

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:

  1. Nella parte superiore del contenuto viene visualizzato un selettore a discesa
  2. Gli utenti possono passare da una vista all'altra usando il selettore a discesa
  3. È visibile solo il contenuto della vista selezionata

View, Tabs e CodeGroup a confronto

ComponenteIdeale perAmbito
ViewIntere sezioni che differiscono in base al frameworkCambio del contenuto dell'intera pagina
TabsConfronti rapidi, gestori di pacchettiCambio del contenuto in linea
CodeGroupLa stessa operazione in più linguaggiSolo 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

stringrequired

Il titolo visualizzato nel selettore a discesa. Deve essere univoco all'interno della pagina.

string

Un'icona Font Awesome, un'icona Lucide, un URL di un'icona o un percorso relativo a un'icona.

stringdefault: solid

Solo per le icone Font Awesome. Opzioni: regular, solid, light, thin, sharp-solid, duotone, brands.

E adesso?

Panoramica dei componenti

Sfoglia tutti i componenti disponibili

Nozioni di base su MDX

Scopri come usare i componenti in MDX