Files
mintlify[bot] 384ee2150b Documentation quality check: fill gaps in recently updated pages (#6685)
* docs: fill gaps in recently updated pages

* docs: translate gap-fill edits to es, fr, zh

* Apply suggestions from code review

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-07-21 10:12:18 -07:00

182 lines
5.6 KiB
Plaintext

---
title: "Árbol"
description: "Usa el componente de árbol para mostrar estructuras jerárquicas de archivos y carpetas con nodos plegables y resaltado de sintaxis para los nombres de ruta."
keywords: ["árbol", "árbol de archivos", "estructura de carpetas", "navegación jerárquica", "sistema de archivos"]
boost: 3
---
Utiliza componentes de árbol para mostrar estructuras jerárquicas como sistemas de archivos, directorios de proyectos o contenido anidado. El componente de árbol ofrece compatibilidad con navegación mediante teclado y funciones de accesibilidad.
Puedes crear árboles con una lista de Markdown o con los componentes `Tree.Folder` y `Tree.File`. `<Tree>` y `<FileTree>` son alias, por lo que cualquiera de las etiquetas funciona con cualquiera de las sintaxis.
Usa la sintaxis de lista de Markdown para árboles rápidos y estáticos en los que cada carpeta puede expandirse de forma predeterminada. Usa la sintaxis de componente cuando necesites controlar el estado de apertura de cada carpeta con `defaultOpen`, marcar carpetas como no interactivas con `openable`, o mezclar archivos y carpetas a una profundidad arbitraria.
<div id="markdown-list-syntax">
## Sintaxis de lista de Markdown
</div>
Escribe una lista de Markdown anidada dentro de `<FileTree>` (o `<Tree>`) para describir una estructura de carpetas. Añade una barra al final para indicar una carpeta o anida elementos debajo de ella. Las carpetas que contienen elementos anidados se expanden de forma predeterminada.
<FileTree>
- docs/
- index.mdx
- guides/
- configuration.mdx
- docs.config.ts
</FileTree>
````mdx File tree example
<FileTree>
- docs/
- index.mdx
- guides/
- configuration.mdx
- docs.config.ts
</FileTree>
````
Deja una línea en blanco después de la etiqueta de apertura y antes de la de cierre para que la lista se procese como Markdown. El formato en línea como `` `código` ``, `**negrita**` o `_cursiva_` se elimina de los nombres, así que úsalos solo cuando se muestren correctamente en tu compilación.
<div id="basic-tree">
## Árbol básico
</div>
<Tree>
<Tree.Folder name="app" defaultOpen>
<Tree.File name="layout.tsx" />
<Tree.File name="page.tsx" />
<Tree.File name="global.css" />
</Tree.Folder>
<Tree.Folder name="lib">
<Tree.File name="utils.ts" />
<Tree.File name="db.ts" />
</Tree.Folder>
<Tree.File name="package.json" />
<Tree.File name="tsconfig.json" />
</Tree>
```mdx Tree example
<Tree>
<Tree.Folder name="app" defaultOpen>
<Tree.File name="layout.tsx" />
<Tree.File name="page.tsx" />
<Tree.File name="global.css" />
</Tree.Folder>
<Tree.Folder name="lib">
<Tree.File name="utils.ts" />
<Tree.File name="db.ts" />
</Tree.Folder>
<Tree.File name="package.json" />
<Tree.File name="tsconfig.json" />
</Tree>
```
<div id="nested-folders">
## Carpetas anidadas
</div>
Crea estructuras de carpetas muy profundas anidando componentes `Tree.Folder` unos dentro de otros.
<Tree>
<Tree.Folder name="app" defaultOpen>
<Tree.File name="layout.tsx" />
<Tree.File name="page.tsx" />
<Tree.Folder name="api" defaultOpen>
<Tree.Folder name="auth">
<Tree.File name="route.ts" />
</Tree.Folder>
<Tree.File name="route.ts" />
</Tree.Folder>
<Tree.Folder name="components">
<Tree.File name="button.tsx" />
<Tree.File name="dialog.tsx" />
<Tree.File name="tabs.tsx" />
</Tree.Folder>
</Tree.Folder>
<Tree.File name="package.json" />
</Tree>
```mdx Nested folders example
<Tree>
<Tree.Folder name="app" defaultOpen>
<Tree.File name="layout.tsx" />
<Tree.File name="page.tsx" />
<Tree.Folder name="api" defaultOpen>
<Tree.Folder name="auth">
<Tree.File name="route.ts" />
</Tree.Folder>
<Tree.File name="route.ts" />
</Tree.Folder>
<Tree.Folder name="components">
<Tree.File name="button.tsx" />
<Tree.File name="dialog.tsx" />
<Tree.File name="tabs.tsx" />
</Tree.Folder>
</Tree.Folder>
<Tree.File name="package.json" />
</Tree>
```
<div id="keyboard-navigation">
## Navegación con el teclado
</div>
El componente de árbol admite la navegación con el teclado.
- **Teclas de flecha**: Navega hacia arriba y hacia abajo por los elementos visibles.
- **Flecha derecha**: Expande una carpeta cerrada o se desplaza al primer elemento hijo de una carpeta abierta.
- **Flecha izquierda**: Contrae una carpeta abierta o se desplaza a la carpeta padre.
- **Inicio (Home)**: Salta al primer elemento del árbol.
- **Fin (End)**: Salta al último elemento visible del árbol.
- **Enter/Espacio**: Alterna el estado de la carpeta entre abierta y cerrada.
- **\***: Expande todas las carpetas del mismo nivel en el nivel actual.
- **Búsqueda incremental**: Escribe caracteres para saltar a los elementos que comienzan con esos caracteres.
<div id="properties">
## Propiedades
</div>
<div id="treefolder">
### Tree.Folder
</div>
<ResponseField name="name" type="string" required>
El nombre de la carpeta que se muestra en el árbol.
</ResponseField>
<ResponseField name="defaultOpen" type="boolean" default="false">
Indica si la carpeta se expande de forma predeterminada.
</ResponseField>
<ResponseField name="openable" type="boolean" default="true">
Indica si los usuarios pueden abrir y cerrar la carpeta. Configúralo en false para carpetas no interactivas.
</ResponseField>
<div id="treefile">
### Tree.File
</div>
<ResponseField name="name" type="string" required>
El nombre del archivo que se muestra en el árbol.
</ResponseField>
`Tree.File` solo acepta la prop `name`.