Jamdesk Documentation logo

Tree

Datei- und Ordnerhierarchien mit interaktivem Ein-/Ausklappen und Tastaturnavigation anzeigen – ideal für die Dokumentation von Projektstrukturen.

Tree zeigt Datei- und Ordnerhierarchien mit interaktivem Ein-/Ausklappen und vollständiger Tastaturnavigation an. Die Komponente eignet sich für die Dokumentation von Projektstrukturen, die Darstellung von Verzeichnislayouts oder die Erklärung, wo Dateien in einer Codebasis abgelegt werden sollen.

Verwenden Sie Tree zum:

  • Darstellen von Projektstrukturen in Anleitungen für den Einstieg
  • Erklären der Dateiorganisation in Tutorials
  • Dokumentieren von CLI-Ausgaben, die Verzeichnisbäume anzeigen
  • Veranschaulichen, wo Dateien hinzugefügt werden in Konfigurationsanleitungen

Verwendung

<Tree>
  <TreeFolder name="src" defaultOpen>
    <TreeFile name="index.ts" />
  </TreeFolder>
</Tree>

Grundlegende Tree-Komponente

package.json
<Tree>
  <TreeFolder name="src" defaultOpen>
    <TreeFile name="index.ts" />
    <TreeFile name="config.ts" />
  </TreeFolder>
  <TreeFile name="package.json" />
</Tree>

Beispiel für eine Projektstruktur

Zeigen Sie Lesern, wie ein Projekt nach der Einrichtung aussieht:

Tree im Vergleich zu Codeblöcken

FunktionTreeCodeblock
InteraktivJa (Ein-/Ausklappen)Nein
TastaturnavigationVollständig unterstütztNein
Visuelle HierarchieSymbole + EinrückungNur Text
Am besten geeignet fürDokumentationSchnelle Inline-Referenzen

Verwenden Sie Tree für die primäre Dokumentation von Strukturen. Verwenden Sie Codeblöcke für schnelle Inline-Referenzen wie „create src/index.ts“.

Tastaturnavigation

Die Tree-Komponente unterstützt die vollständige Tastaturnavigation:

TasteAktion
Arrow DownZum nächsten Element wechseln
Arrow UpZum vorherigen Element wechseln
Arrow RightOrdner aufklappen oder zum ersten untergeordneten Element wechseln
Arrow LeftOrdner zuklappen oder zum übergeordneten Element wechseln
HomeZum ersten Element springen
EndZum letzten sichtbaren Element springen
Enter / SpaceOrdner auf- oder zuklappen
Type charactersZum passenden Element springen

Props

TreeFolder

stringrequired

Im Tree angezeigter Ordnername.

booleandefault: false

Im ausgeklappten Zustand starten.

booleandefault: true

Gibt an, ob der Ordner auf- und zugeklappt werden kann.

TreeFile

stringrequired

Im Tree angezeigter Dateiname.

Wie geht es weiter?

Komponentenübersicht

Alle verfügbaren Komponenten durchsuchen

MDX-Grundlagen

Erfahren, wie Komponenten in MDX verwendet werden