diff --git a/components/tree.mdx b/components/tree.mdx
index db4e6dbff..d0ece98fb 100644
--- a/components/tree.mdx
+++ b/components/tree.mdx
@@ -115,6 +115,48 @@ Create deeply nested structures by nesting `Tree.Folder` components within each
```
+## Highlight the active path
+
+Add the `highlight` property to `Tree.File` or `Tree.Folder` to mark the current item. Use it to draw attention to a file or folder you reference in nearby prose, such as the file a reader should open next.
+
+Highlighting a folder also tints its descendants, so the active path stands out.
+
+
+
+
+
+
+
+
+
+
+
+
+```mdx Highlighted tree example
+
+
+
+
+
+
+
+
+
+
+```
+
+### Customize the highlight color
+
+The `--tree-highlight` CSS variable defines the highlight color. Set it on the `Tree` root component to override the color for that tree.
+
+```mdx Custom highlight color
+
+
+
+
+
+```
+
## Keyboard navigation
The tree component supports keyboard navigation.
@@ -144,8 +186,16 @@ The tree component supports keyboard navigation.
Whether users can open and close the folder. Set to false for non-interactive folders.
+
+ Whether to highlight the folder as the active item. Emphasizes the active path by tinting descendants.
+
+
### Tree.File
The name of the file displayed in the tree.
+
+
+ Whether to highlight the file as the active item.
+
diff --git a/es/components/tree.mdx b/es/components/tree.mdx
index 5005049ee..9def8b297 100644
--- a/es/components/tree.mdx
+++ b/es/components/tree.mdx
@@ -136,6 +136,54 @@ Crea estructuras de carpetas muy profundas anidando componentes `Tree.Folder` un
```
+
+ ## Resaltar la ruta activa
+
+
+Añade la prop `highlight` a `Tree.File` o `Tree.Folder` para marcar el elemento actual. Úsala para destacar un archivo o una carpeta a los que se hace referencia en el texto cercano, como el archivo que la persona lectora debería abrir a continuación.
+
+Resaltar una carpeta también tiñe a sus descendientes, de modo que la ruta activa se distingue incluso cuando la carpeta está expandida.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+```mdx Highlighted tree example
+
+
+
+
+
+
+
+
+
+
+```
+
+### Personalizar el color de resaltado
+
+El color de resaltado se expone mediante la variable CSS `--tree-highlight`. Establécela en el componente raíz `Tree` para sobrescribir el color de ese árbol.
+
+```mdx Color de resaltado personalizado
+
+
+
+
+
+```
+
+
## Navegación con el teclado
@@ -171,6 +219,10 @@ El componente de árbol admite la navegación con el teclado.
Indica si los usuarios pueden abrir y cerrar la carpeta. Configúralo en false para carpetas no interactivas.
+
+ Indica si la carpeta se resalta como el elemento activo. Los descendientes también se tiñen para reforzar la ruta activa.
+
+
### Tree.File
@@ -179,4 +231,6 @@ El componente de árbol admite la navegación con el teclado.
El nombre del archivo que se muestra en el árbol.
-`Tree.File` solo acepta la prop `name`.
\ No newline at end of file
+
+ Indica si el archivo se resalta como el elemento activo.
+
\ No newline at end of file
diff --git a/fr/components/tree.mdx b/fr/components/tree.mdx
index 48f8282e1..7cf89d578 100644
--- a/fr/components/tree.mdx
+++ b/fr/components/tree.mdx
@@ -136,6 +136,54 @@ Créez des structures profondément imbriquées en imbriquant des composants `Tr
```
+
+ ## Mettre en évidence le chemin actif
+
+
+Ajoutez la prop `highlight` à `Tree.File` ou `Tree.Folder` pour marquer l’élément actuel. Utilisez-la pour attirer l’attention sur un fichier ou un dossier auquel vous faites référence dans le texte voisin, comme le fichier que le lecteur doit ouvrir ensuite.
+
+Mettre en évidence un dossier teinte également ses descendants, afin que le chemin actif se distingue même lorsque le dossier est développé.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+```mdx Highlighted tree example
+
+
+
+
+
+
+
+
+
+
+```
+
+### Personnaliser la couleur de mise en évidence
+
+La couleur de mise en évidence est exposée via la variable CSS `--tree-highlight`. Définissez-la sur le composant racine `Tree` pour redéfinir la couleur de cette arborescence.
+
+```mdx Couleur de mise en évidence personnalisée
+
+
+
+
+
+```
+
+
## Navigation au clavier
@@ -171,6 +219,10 @@ Le composant d’arborescence prend en charge la navigation au clavier.
Indique si les utilisateurs peuvent ouvrir et fermer le dossier. Réglez cette valeur sur false pour les dossiers non interactifs.
+
+ Indique si le dossier est mis en évidence comme élément actif. Les descendants sont également teintés pour renforcer le chemin actif.
+
+
### Tree.File
@@ -179,4 +231,6 @@ Le composant d’arborescence prend en charge la navigation au clavier.
Le nom du fichier affiché dans l'arborescence.
-`Tree.File` n'accepte que la prop `name`.
\ No newline at end of file
+
+ Indique si le fichier est mis en évidence comme élément actif.
+
\ No newline at end of file
diff --git a/zh/components/tree.mdx b/zh/components/tree.mdx
index 7a466a772..fb04d75b6 100644
--- a/zh/components/tree.mdx
+++ b/zh/components/tree.mdx
@@ -136,6 +136,54 @@ boost: 3
```
+
+ ## 突出显示当前路径
+
+
+在 `Tree.File` 或 `Tree.Folder` 上添加 `highlight` prop 以标记当前条目。当你在附近正文中引用某个文件或文件夹(例如读者接下来应打开的文件)时,使用它来吸引注意。
+
+突出显示某个文件夹时也会为其后代着色,即使文件夹处于展开状态,当前路径仍然清晰可辨。
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+```mdx Highlighted tree example
+
+
+
+
+
+
+
+
+
+
+```
+
+### 自定义高亮颜色
+
+高亮颜色通过 `--tree-highlight` CSS 变量暴露。在 `Tree` 根组件上设置该变量以覆盖该目录树的颜色。
+
+```mdx 自定义高亮颜色
+
+
+
+
+
+```
+
+
## 键盘导航
@@ -171,6 +219,10 @@ Tree 组件支持键盘导航。
用户是否可以展开和收起该文件夹。对于不可交互的文件夹,将其设置为 false。
+
+ 文件夹是否作为当前条目突出显示。其后代也会被着色以强化当前路径。
+
+
### Tree.File
@@ -179,4 +231,6 @@ Tree 组件支持键盘导航。
在树状视图中显示的文件名。
-`Tree.File` 仅接受 `name` prop。
\ No newline at end of file
+
+ 文件是否作为当前条目突出显示。
+
\ No newline at end of file