Passer au contenu principal
Utilisez des composants arborescents pour afficher des structures hiérarchiques comme des systèmes de fichiers, des répertoires de projet ou du contenu imbriqué. Le composant d’arborescence prend en charge la navigation au clavier et les fonctionnalités d’accessibilité. Vous pouvez créer des arborescences avec une liste Markdown ou avec les composants Tree.Folder et Tree.File. <Tree> et <FileTree> sont des alias : chaque balise fonctionne avec l’une ou l’autre des syntaxes.

​
Syntaxe de liste Markdown

Écrivez une liste Markdown imbriquée dans <FileTree> (ou <Tree>) pour décrire une structure de dossiers. Ajoutez une barre oblique à la fin pour indiquer un dossier, ou imbriquez des éléments en dessous. Les dossiers qui contiennent des éléments imbriqués sont développés par défaut.
File tree example
Laissez une ligne vide après la balise d’ouverture et avant la balise de fermeture pour que la liste soit interprétée comme du Markdown. Les mises en forme en ligne telles que `code`, **gras** ou _italique_ sont supprimées des noms ; ne les utilisez que si elles s’affichent correctement dans votre build.

​
Arborescence de base

app
layout.tsx
page.tsx
global.css
package.json
tsconfig.json
Tree example

​
Dossiers imbriqués

Créez des structures profondément imbriquées en imbriquant des composants Tree.Folder les uns dans les autres.
app
layout.tsx
page.tsx
api
route.ts
package.json
Nested folders example
Le composant d’arborescence prend en charge la navigation au clavier.
  • Flèches directionnelles : Parcourir les éléments visibles vers le haut et vers le bas.
  • Flèche droite : Développer un dossier fermé ou passer au premier élément enfant d’un dossier ouvert.
  • Flèche gauche : Réduire un dossier ouvert ou passer au dossier parent.
  • Home : Aller au premier élément de l’arborescence.
  • End : Aller au dernier élément visible de l’arborescence.
  • Entrée/Espace : Basculer l’état ouvert/fermé d’un dossier.
  • * : Développer tous les dossiers au même niveau.
  • Recherche par saisie anticipée (type-ahead) : Taper des caractères pour passer aux éléments qui commencent par ces caractères.

​
Propriétés

​
Tree.Folder

​
name
string
requis
Le nom du dossier affiché dans l’arborescence.
​
defaultOpen
boolean
défaut:"false"
Indique si le dossier s’ouvre par défaut.
​
openable
boolean
défaut:"true"
Indique si les utilisateurs peuvent ouvrir et fermer le dossier. Réglez cette valeur sur false pour les dossiers non interactifs.

​
Tree.File

​
name
string
requis
Le nom du fichier affiché dans l’arborescence.