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
<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
| Funktion | Tree | Codeblock |
|---|---|---|
| Interaktiv | Ja (Ein-/Ausklappen) | Nein |
| Tastaturnavigation | Vollständig unterstützt | Nein |
| Visuelle Hierarchie | Symbole + Einrückung | Nur Text |
| Am besten geeignet für | Dokumentation | Schnelle 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:
| Taste | Aktion |
|---|---|
Arrow Down | Zum nächsten Element wechseln |
Arrow Up | Zum vorherigen Element wechseln |
Arrow Right | Ordner aufklappen oder zum ersten untergeordneten Element wechseln |
Arrow Left | Ordner zuklappen oder zum übergeordneten Element wechseln |
Home | Zum ersten Element springen |
End | Zum letzten sichtbaren Element springen |
Enter / Space | Ordner auf- oder zuklappen |
| Type characters | Zum passenden Element springen |
Props
TreeFolder
stringrequiredIm Tree angezeigter Ordnername.
booleandefault: falseIm ausgeklappten Zustand starten.
booleandefault: trueGibt an, ob der Ordner auf- und zugeklappt werden kann.
TreeFile
stringrequiredIm Tree angezeigter Dateiname.
