From f7255758a21d9ddf9082076c6e8a104c296c4164 Mon Sep 17 00:00:00 2001 From: Laura Date: Tue, 26 Feb 2019 11:27:31 -0500 Subject: [PATCH 1/5] :book: First translation faq-internals --- content/docs/faq-internals.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/content/docs/faq-internals.md b/content/docs/faq-internals.md index da7f96be0..ecaf5e9b9 100644 --- a/content/docs/faq-internals.md +++ b/content/docs/faq-internals.md @@ -1,23 +1,25 @@ --- id: faq-internals -title: Virtual DOM and Internals +title: DOM virtuel et fonctionnalités permalink: docs/faq-internals.html layout: docs category: FAQ --- -### What is the Virtual DOM? {#what-is-the-virtual-dom} +### Qu'est ce que le DOM virtuel ? {#what-is-the-virtual-dom} -The virtual DOM (VDOM) is a programming concept where an ideal, or "virtual", representation of a UI is kept in memory and synced with the "real" DOM by a library such as ReactDOM. This process is called [reconciliation](/docs/reconciliation.html). +Le DOM virtuel (VDOM) est un concept de programmation dans lequel une représentation idéale, ou "virtuelle", d'une interface utilisateur est conservée en mémoire et synchronisée avec le DOM "réel" par une bibliothèque telle que ReactDOM. Ce processus s'appelle [réconciliation](/docs/reconciliation.html). -This approach enables the declarative API of React: You tell React what state you want the UI to be in, and it makes sure the DOM matches that state. This abstracts out the attribute manipulation, event handling, and manual DOM updating that you would otherwise have to use to build your app. +Cette approche active l'API déclarative de React: vous indiquez à React dans quel état vous souhaitez que l'interface utilisateur se trouve, et il s'assure que le DOM correspond à cet état. Cela extrait la manipulation des attributs, la gestion des événements et la mise à jour manuelle du DOM que sinon vous auriez dû utiliser pour créer votre application. -Since "virtual DOM" is more of a pattern than a specific technology, people sometimes say it to mean different things. In React world, the term "virtual DOM" is usually associated with [React elements](/docs/rendering-elements.html) since they are the objects representing the user interface. React, however, also uses internal objects called "fibers" to hold additional information about the component tree. They may also be considered a part of "virtual DOM" implementation in React. +Puisque le "DOM virtuel" est plus un modèle qu'une technologie spécifique, on l'employe parfois pour désigner différentes choses. Dans le monde React, le terme "DOM virtuel" est généralement associé aux [éléments React](/docs/rendering-elements.html) car il s'agit des objets représentant l'interface utilisateur. Cependant, React utilise également des objets internes appelés "fibres" pour contenir des informations supplémentaires sur l’arbre des composants. Ils peuvent également être considérés comme faisant partie de l'implémentation du "DOM virtuel" dans React. -### Is the Shadow DOM the same as the Virtual DOM? {#is-the-shadow-dom-the-same-as-the-virtual-dom} +### Est-ce que le DOM fantôme est le même que le DOM virtuel ? {#is-the-shadow-dom-the-same-as-the-virtual-dom} No, they are different. The Shadow DOM is a browser technology designed primarily for scoping variables and CSS in web components. The virtual DOM is a concept implemented by libraries in JavaScript on top of browser APIs. -### What is "React Fiber"? {#what-is-react-fiber} +Non, ils sont différents. Le DOM fantôme est une technologie du navigateur conçue principalement pour parcourir les variables et le CSS des composants Web. Le DOM virtuel est un concept implémenté par les bibliothèques en JavaScript en plus des API de navigateur. -Fiber is the new reconciliation engine in React 16. Its main goal is to enable incremental rendering of the virtual DOM. [Read more](https://github.com/acdlite/react-fiber-architecture). +### Qu'est ce que "React Fiber"? {#what-is-react-fiber} + +Fiber est le nouveau moteur de réconcialiation de React 16. Son objectif principal est de permettre le rendu incrémentiel du DOM virtuel. [En savoir plus](https://github.com/acdlite/react-fiber-architecture). From 06e61fa96e9ad5ace0f8e4b495b844b8ac0259d0 Mon Sep 17 00:00:00 2001 From: Laura Date: Tue, 26 Feb 2019 11:40:58 -0500 Subject: [PATCH 2/5] :ambulance: small corrections --- content/docs/faq-internals.md | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/content/docs/faq-internals.md b/content/docs/faq-internals.md index ecaf5e9b9..8ed1a3f52 100644 --- a/content/docs/faq-internals.md +++ b/content/docs/faq-internals.md @@ -6,20 +6,18 @@ layout: docs category: FAQ --- -### Qu'est ce que le DOM virtuel ? {#what-is-the-virtual-dom} +### Qu'est-ce que le DOM virtuel ? {#what-is-the-virtual-dom} Le DOM virtuel (VDOM) est un concept de programmation dans lequel une représentation idéale, ou "virtuelle", d'une interface utilisateur est conservée en mémoire et synchronisée avec le DOM "réel" par une bibliothèque telle que ReactDOM. Ce processus s'appelle [réconciliation](/docs/reconciliation.html). -Cette approche active l'API déclarative de React: vous indiquez à React dans quel état vous souhaitez que l'interface utilisateur se trouve, et il s'assure que le DOM correspond à cet état. Cela extrait la manipulation des attributs, la gestion des événements et la mise à jour manuelle du DOM que sinon vous auriez dû utiliser pour créer votre application. +Cette approche active l'API déclarative de React : vous indiquez à React dans quel état, vous souhaitez que l'interface utilisateur se trouve, et il s'assure que le DOM correspond à cet état. Cela extrait la manipulation des attributs, la gestion des événements et la mise à jour manuelle du DOM que sinon vous auriez dû utiliser pour créer votre application. -Puisque le "DOM virtuel" est plus un modèle qu'une technologie spécifique, on l'employe parfois pour désigner différentes choses. Dans le monde React, le terme "DOM virtuel" est généralement associé aux [éléments React](/docs/rendering-elements.html) car il s'agit des objets représentant l'interface utilisateur. Cependant, React utilise également des objets internes appelés "fibres" pour contenir des informations supplémentaires sur l’arbre des composants. Ils peuvent également être considérés comme faisant partie de l'implémentation du "DOM virtuel" dans React. +Puisque le "DOM virtuel" est plus un modèle qu'une technologie spécifique, on l'emploie parfois pour désigner différentes choses. Dans le monde React, le terme "DOM virtuel" est généralement associé aux [éléments React](/docs/rendering-elements.html), car il s'agit des objets représentant l'interface utilisateur. Cependant, React utilise également des objets internes appelés "fibres" pour contenir des informations supplémentaires sur l’arbre des composants. Ils peuvent également être considérés comme faisant partie de l'implémentation du "DOM virtuel" dans React. ### Est-ce que le DOM fantôme est le même que le DOM virtuel ? {#is-the-shadow-dom-the-same-as-the-virtual-dom} -No, they are different. The Shadow DOM is a browser technology designed primarily for scoping variables and CSS in web components. The virtual DOM is a concept implemented by libraries in JavaScript on top of browser APIs. - Non, ils sont différents. Le DOM fantôme est une technologie du navigateur conçue principalement pour parcourir les variables et le CSS des composants Web. Le DOM virtuel est un concept implémenté par les bibliothèques en JavaScript en plus des API de navigateur. -### Qu'est ce que "React Fiber"? {#what-is-react-fiber} +### Qu'est-ce que "React Fiber"? {#what-is-react-fiber} -Fiber est le nouveau moteur de réconcialiation de React 16. Son objectif principal est de permettre le rendu incrémentiel du DOM virtuel. [En savoir plus](https://github.com/acdlite/react-fiber-architecture). +Fiber est le nouveau moteur de réconciliation de React 16. Son objectif principal est de permettre le rendu incrémentiel du DOM virtuel. [En savoir plus](https://github.com/acdlite/react-fiber-architecture). From 99c4f5dee7579d88b04d47b6d78c2d867a495e5a Mon Sep 17 00:00:00 2001 From: Jeremie Patonnier Date: Fri, 8 Mar 2019 09:53:13 -0500 Subject: [PATCH 3/5] Apply suggestions from code review Co-Authored-By: lbelavoir --- content/docs/faq-internals.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/docs/faq-internals.md b/content/docs/faq-internals.md index 8ed1a3f52..412521101 100644 --- a/content/docs/faq-internals.md +++ b/content/docs/faq-internals.md @@ -10,13 +10,13 @@ category: FAQ Le DOM virtuel (VDOM) est un concept de programmation dans lequel une représentation idéale, ou "virtuelle", d'une interface utilisateur est conservée en mémoire et synchronisée avec le DOM "réel" par une bibliothèque telle que ReactDOM. Ce processus s'appelle [réconciliation](/docs/reconciliation.html). -Cette approche active l'API déclarative de React : vous indiquez à React dans quel état, vous souhaitez que l'interface utilisateur se trouve, et il s'assure que le DOM correspond à cet état. Cela extrait la manipulation des attributs, la gestion des événements et la mise à jour manuelle du DOM que sinon vous auriez dû utiliser pour créer votre application. +Cette approche active l'API déclarative de React : vous indiquez à React dans quel état, vous souhaitez que l'interface utilisateur se trouve, et il s'assure que le DOM correspond à cet état. Ça permet de faire abstraction de la manipulation des attributs, de la gestion des événements et de la mise à jour manuelle du DOM que vous auriez dû faire normalement pour créer votre application. -Puisque le "DOM virtuel" est plus un modèle qu'une technologie spécifique, on l'emploie parfois pour désigner différentes choses. Dans le monde React, le terme "DOM virtuel" est généralement associé aux [éléments React](/docs/rendering-elements.html), car il s'agit des objets représentant l'interface utilisateur. Cependant, React utilise également des objets internes appelés "fibres" pour contenir des informations supplémentaires sur l’arbre des composants. Ils peuvent également être considérés comme faisant partie de l'implémentation du "DOM virtuel" dans React. +Puisque le « DOM virtuel » est plus un modèle qu'une technologie spécifique, on l'emploie parfois pour désigner différentes choses. Dans le monde React, le terme « DOM virtuel » est généralement associé aux [éléments React](/docs/rendering-elements.html), car il s'agit des objets représentant l'interface utilisateur. Cependant, React utilise également des objets internes appelés « fibres » (_fibers_ en anglais, NdT) pour contenir des informations supplémentaires sur l’arbre des composants. Ils peuvent également être considérés comme faisant partie de l'implémentation du « DOM virtuel » dans React. -### Est-ce que le DOM fantôme est le même que le DOM virtuel ? {#is-the-shadow-dom-the-same-as-the-virtual-dom} +### Est-ce que le Shadow DOM est identique au DOM virtuel ? {#is-the-shadow-dom-the-same-as-the-virtual-dom} -Non, ils sont différents. Le DOM fantôme est une technologie du navigateur conçue principalement pour parcourir les variables et le CSS des composants Web. Le DOM virtuel est un concept implémenté par les bibliothèques en JavaScript en plus des API de navigateur. +Non, ils sont différents. Le Shadow DOM est une technologie du navigateur conçue principalement pour parcourir les variables et le CSS des composants Web. Le DOM virtuel est un concept implémenté par les bibliothèques en JavaScript en plus des API des navigateurs. ### Qu'est-ce que "React Fiber"? {#what-is-react-fiber} From cd37b8ea77e09afe18edc054e57d7d5d04713a54 Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Mon, 11 Mar 2019 22:38:21 -0400 Subject: [PATCH 4/5] Apply suggestions from code review Co-Authored-By: lbelavoir --- content/docs/faq-internals.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/content/docs/faq-internals.md b/content/docs/faq-internals.md index 412521101..2102f8ead 100644 --- a/content/docs/faq-internals.md +++ b/content/docs/faq-internals.md @@ -1,6 +1,6 @@ --- id: faq-internals -title: DOM virtuel et fonctionnalités +title: DOM virtuel et autres détails permalink: docs/faq-internals.html layout: docs category: FAQ @@ -8,16 +8,16 @@ category: FAQ ### Qu'est-ce que le DOM virtuel ? {#what-is-the-virtual-dom} -Le DOM virtuel (VDOM) est un concept de programmation dans lequel une représentation idéale, ou "virtuelle", d'une interface utilisateur est conservée en mémoire et synchronisée avec le DOM "réel" par une bibliothèque telle que ReactDOM. Ce processus s'appelle [réconciliation](/docs/reconciliation.html). +Le DOM virtuel (VDOM) est un concept de programmation dans lequel une représentation idéale, ou « virtuelle », d'une interface utilisateur (UI) est conservée en mémoire et synchronisée avec le DOM « réel » par une bibliothèque telle que ReactDOM. Ce processus s'appelle [réconciliation](/docs/reconciliation.html). -Cette approche active l'API déclarative de React : vous indiquez à React dans quel état, vous souhaitez que l'interface utilisateur se trouve, et il s'assure que le DOM correspond à cet état. Ça permet de faire abstraction de la manipulation des attributs, de la gestion des événements et de la mise à jour manuelle du DOM que vous auriez dû faire normalement pour créer votre application. +Cette approche rend possible l'API déclarative de React : vous indiquez à React dans quel état, vous souhaitez que l'UI se trouve, et il s'assure que le DOM correspond à cet état. Ça permet de faire abstraction de la manipulation des attributs, de la gestion des événements et de la mise à jour manuelle du DOM que vous auriez dû faire normalement pour créer votre application. -Puisque le « DOM virtuel » est plus un modèle qu'une technologie spécifique, on l'emploie parfois pour désigner différentes choses. Dans le monde React, le terme « DOM virtuel » est généralement associé aux [éléments React](/docs/rendering-elements.html), car il s'agit des objets représentant l'interface utilisateur. Cependant, React utilise également des objets internes appelés « fibres » (_fibers_ en anglais, NdT) pour contenir des informations supplémentaires sur l’arbre des composants. Ils peuvent également être considérés comme faisant partie de l'implémentation du « DOM virtuel » dans React. +Puisque le « DOM virtuel » est plus un modèle qu'une technologie spécifique, on l'emploie parfois pour désigner différentes choses. Dans le monde React, le terme « DOM virtuel » est généralement associé aux [éléments React](/docs/rendering-elements.html), car il s'agit des objets représentant l'interface utilisateur. Cependant, React utilise également des objets internes appelés « fibres » _(fibers, NdT)_ pour conserver des informations supplémentaires sur l’arbre des composants. Ils peuvent également être considérés comme faisant partie de l'implémentation du « DOM virtuel » dans React. ### Est-ce que le Shadow DOM est identique au DOM virtuel ? {#is-the-shadow-dom-the-same-as-the-virtual-dom} -Non, ils sont différents. Le Shadow DOM est une technologie du navigateur conçue principalement pour parcourir les variables et le CSS des composants Web. Le DOM virtuel est un concept implémenté par les bibliothèques en JavaScript en plus des API des navigateurs. +Non, ils sont différents. Le Shadow DOM est une technologie du navigateur conçue principalement pour limiter la portée des variables et du CSS dans les Web Components. Le DOM virtuel est un concept implémenté par les bibliothèques en JavaScript en plus des API des navigateurs. -### Qu'est-ce que "React Fiber"? {#what-is-react-fiber} +### Qu'est-ce que « React Fiber » ? {#what-is-react-fiber} Fiber est le nouveau moteur de réconciliation de React 16. Son objectif principal est de permettre le rendu incrémentiel du DOM virtuel. [En savoir plus](https://github.com/acdlite/react-fiber-architecture). From fad4e149fb0b4691062c5d295bf404091a5b41fe Mon Sep 17 00:00:00 2001 From: Christophe Porteneuve Date: Tue, 12 Mar 2019 16:01:01 +0100 Subject: [PATCH 5/5] Final tweaks --- content/docs/faq-internals.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/faq-internals.md b/content/docs/faq-internals.md index 2102f8ead..1c6ca4f5a 100644 --- a/content/docs/faq-internals.md +++ b/content/docs/faq-internals.md @@ -10,7 +10,7 @@ category: FAQ Le DOM virtuel (VDOM) est un concept de programmation dans lequel une représentation idéale, ou « virtuelle », d'une interface utilisateur (UI) est conservée en mémoire et synchronisée avec le DOM « réel » par une bibliothèque telle que ReactDOM. Ce processus s'appelle [réconciliation](/docs/reconciliation.html). -Cette approche rend possible l'API déclarative de React : vous indiquez à React dans quel état, vous souhaitez que l'UI se trouve, et il s'assure que le DOM correspond à cet état. Ça permet de faire abstraction de la manipulation des attributs, de la gestion des événements et de la mise à jour manuelle du DOM que vous auriez dû faire normalement pour créer votre application. +Cette approche rend possible l'API déclarative de React : vous indiquez à React dans quel état vous souhaitez que l'UI se trouve, et il s'assure que le DOM correspond à cet état. Ça permet de faire abstraction de la manipulation des attributs, de la gestion des événements et de la mise à jour manuelle du DOM que vous auriez normalement dû faire vous-mêmes pour créer votre application. Puisque le « DOM virtuel » est plus un modèle qu'une technologie spécifique, on l'emploie parfois pour désigner différentes choses. Dans le monde React, le terme « DOM virtuel » est généralement associé aux [éléments React](/docs/rendering-elements.html), car il s'agit des objets représentant l'interface utilisateur. Cependant, React utilise également des objets internes appelés « fibres » _(fibers, NdT)_ pour conserver des informations supplémentaires sur l’arbre des composants. Ils peuvent également être considérés comme faisant partie de l'implémentation du « DOM virtuel » dans React.