Skip to content

Commit c666f1a

Browse files
committed
copy(ui-as-a-tree): first full translation
1 parent 6baa29d commit c666f1a

1 file changed

Lines changed: 20 additions & 20 deletions

File tree

src/content/learn/understanding-your-ui-as-a-tree.md

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -256,43 +256,43 @@ Même si les arbres de rendu peuvent varier d'un rendu à l'autre, ces arbres re
256256

257257
Il est utile de bien identifier ces catégories de composants pour comprendre le flux de données et les performances de votre appli.
258258

259-
## The Module Dependency Tree {/*the-module-dependency-tree*/}
259+
## L'arbre de dépendances de modules {/*the-module-dependency-tree*/}
260260

261-
Another relationship in a React app that can be modeled with a tree are an app's module dependencies. As we [break up our components](/learn/importing-and-exporting-components#exporting-and-importing-a-component) and logic into separate files, we create [JS modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) where we may export components, functions, or constants.
261+
Les arbres peuvent modéliser un autre type de relations dans une appli React : les dépendances entre modules de l'appli. Lorsque nous [découpons nos composants](/learn/importing-and-exporting-components#exporting-and-importing-a-component) et leur logique en fichiers distincts, nou créons des [modules JS](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) d'où nous pouvons exporter des composants, des fonctions ou encore des constantes.
262262

263-
Each node in a module dependency tree is a module and each branch represents an `import` statement in that module.
263+
Chaque nœud dans un arbre de dépendances de modules représente un module, et chaque branche représente une instruction `import` dans ce module.
264264

265-
If we take the previous Inspirations app, we can build a module dependency tree, or dependency tree for short.
265+
Si nous reprenons l'appli d'Inspirations précédente, nous pouvons construire un arbre de dépendances de modules (ou « arbre de dépendances », pour faire plus court).
266266

267-
<Diagram name="module_dependency_tree" height={250} width={658} alt="A tree graph with seven nodes. Each node is labelled with a module name. The top level node of the tree is labelled 'App.js'. There are three arrows pointing to the modules 'InspirationGenerator.js', 'FancyText.js' and 'Copyright.js' and the arrows are labelled with 'imports'. From the 'InspirationGenerator.js' node, there are three arrows that extend to three modules: 'FancyText.js', 'Color.js', and 'inspirations.js'. The arrows are labelled with 'imports'.">
267+
<Diagram name="module_dependency_tree" height={250} width={658} alt="Un graphe d’arbre avec sept nœuds. Chaque nœud est libellé par un nom de module. Le nœud racine de l’arbre est libellé 'App.js', avec trois flèches qui en partent vers les modules 'InspirationGenerator.js', 'FancyText.js' et 'Copyright.js'. Les flèches portent le descripteur de relation « importe ». Le nœud 'InspirationGenerator.js' a aussi trois flèches qui en partent pour aller vers les modules 'FancyText.js', 'Color.js' et 'inspirations.js', toutes trois porteuses du descripteur « importe ».">
268268

269-
The module dependency tree for the Inspirations app.
269+
L'arbre de dépendances de modules pour l'appli Inspirations.
270270

271271
</Diagram>
272272

273-
The root node of the tree is the root module, also known as the entrypoint file. It often is the module that contains the root component.
273+
Le nœud racine de l'arbre constitue le module racine, également appelé point d'entrée. C'est souvent lui qui contient le composant racine.
274274

275-
Comparing to the render tree of the same app, there are similar structures but some notable differences:
275+
Si on compare avec l'arbre de rendu pour la même appli, on trouve des similitudes aussi bien que des différences significatives :
276276

277-
* The nodes that make-up the tree represent modules, not components.
278-
* Non-component modules, like `inspirations.js`, are also represented in this tree. The render tree only encapsulates components.
279-
* `Copyright.js` appears under `App.js` but in the render tree, `Copyright`, the component, appears as a child of `InspirationGenerator`. This is because `InspirationGenerator` accepts JSX as [children props](/learn/passing-props-to-a-component#passing-jsx-as-children), so it renders `Copyright` as a child component but does not import the module.
277+
* Les nœuds qui constituent l'arbre représentent des modules, pas des composants.
278+
* Les modules sans composants, tels que `inspirations.js`, sont également visibles dans cet arbre. L'arbre de rendu ne représente que les composants.
279+
* `Copyright.js` apparaît sous `App.js` alors que dans l'arbre de rendu, le composant `Copyright` est un enfant de `InspirationGenerator`. C'est parce qu'`InspirationGenerator` accepte du JSX comme [prop `children`](/learn/passing-props-to-a-component#passing-jsx-as-children), de sorte qu'il fait le rendu du composant enfant `Copyright` sans en importer le module.
280280

281-
Dependency trees are useful to determine what modules are necessary to run your React app. When building a React app for production, there is typically a build step that will bundle all the necessary JavaScript to ship to the client. The tool responsible for this is called a [bundler](https://developer.mozilla.org/en-US/docs/Learn/Tools_and_testing/Understanding_client-side_tools/Overview#the_modern_tooling_ecosystem), and bundlers will use the dependency tree to determine what modules should be included.
281+
Les arbres de dépendances sont utiles pour déterminer de quels modules votre appli React a besoin. Lorsque vous faites le *build* d'une appli React en mode production, vous utilisez généralement un outil dédié pour cela. Ce type d'outil est appelé [*bundler*](https://developer.mozilla.org/en-US/docs/Learn/Tools_and_testing/Understanding_client-side_tools/Overview#the_modern_tooling_ecosystem), et les *bundlers* se basent sur l'arbre de dépendances pour déterminer quels modules inclure.
282282

283-
As your app grows, often the bundle size does too. Large bundle sizes are expensive for a client to download and run. Large bundle sizes can delay the time for your UI to get drawn. Getting a sense of your app's dependency tree may help with debugging these issues.
283+
Au fil de la croissance de votre appli, la taille du *bundle* croît aussi. Les *bundles* massifs sont coûteux à télécharger et à exécuter pour le client. Ils peuvent retarder l'affichage de votre UI. Avoir une bonne perception de l'arbre de dépendances de votre appli peut vous aider à déboguer ce type de problèmes.
284284

285285
[comment]: <> (perhaps we should also deep dive on conditional imports)
286286

287287
<Recap>
288288

289-
* Trees are a common way to represent the relationship between entities. They are often used to model UI.
290-
* Render trees represent the nested relationship between React components across a single render.
291-
* With conditional rendering, the render tree may change across different renders. With different prop values, components may render different children components.
292-
* Render trees help identify what the top-level and leaf components are. Top-level components affect the rendering performance of all components beneath them and leaf components are often re-rendered frequently. Identifying them is useful for understanding and debugging rendering performance.
293-
* Dependency trees represent the module dependencies in a React app.
294-
* Dependency trees are used by build tools to bundle the necessary code to ship an app.
295-
* Dependency trees are useful for debugging large bundle sizes that slow time to paint and expose opportunities for optimizing what code is bundled.
289+
* Les arbres sont couramment utilisés pour représenter les relations entre des entités. On les utilise notamment pour modéliser les UI.
290+
* Les arbres de rendus représent les relations d'imbrication entre les composants React au sein d'un unique rendu.
291+
* Le recours au rendu conditionnel peut faire varier l'arbre de rendu d'un rendu à l'autre. Selon les valeurs des props reçues, les composants peuvent afficher divers composants enfants.
292+
* Les arbres de rendu aident à repérer les composants racine et feuilles. Les composants situés haut dans l'arbre peuvent impacter la performance de rendu de tous ceux situés en-dessous d'eux, et les composants feuilles refont fréquemment leur rendu. En les identifiant, on facilite la compréhension et le débogage de la performance de rendu.
293+
* Les arbres de dépendances représentent les dépendances entre modules d'une appli React.
294+
* Les arbres de dépendances sont utilisés par les outils de *build* pour inclure le code nécessaire au déploiement d'une appli.
295+
* Les arbres de dépendances aident à comprendre les raisons de bundles massifs, qui ralentissent l'affichage, et à percevoir des opportunités d'optimisation des éléments de code à inclure.
296296

297297
</Recap>
298298

0 commit comments

Comments
 (0)