Merge branch 'working' into api/router-link.md

Author: Kocal

.eslintrc

@@ -1,10 +1,10 @@
 {
   "root": true,
-  "parser": "babel-eslint",
-  "extends": "vue",
-  "plugins": ["flow-vars"],
-  "rules": {
-    "flow-vars/define-flow-type": 1,
-    "flow-vars/use-flow-type": 1
-  }
+  "plugins": [
+    "flowtype"
+  ],
+  "extends": [
+    "plugin:vue-libs/recommended",
+    "plugin:flowtype/recommended"
+  ]
 }

docs/en/SUMMARY.md

@@ -18,14 +18,15 @@
 - Avancé
   - [Navigation Guards (En)](advanced/navigation-guards.md)
   - [Route Meta Fields (En)](advanced/meta.md)
+  - [Transitions (En)](advanced/transitions.md)
+  - [La récupération de données](advanced/data-fetching.md)
   - [Les transitions](advanced/transitions.md)
-  - [Data Fetching (En)](advanced/data-fetching.md)
   - [Comportement du défilement](advanced/scroll-behavior.md)
   - [Lazy Loading (En)](advanced/lazy-loading.md)
 - Réference de l'API
   - [router-link](api/router-link.md)
   - [router-view](api/router-view.md)
   - [L'objet Route](api/route-object.md)
-  - [Router Constructor Options (En)](api/options.md)
-  - [Router Instance (En)](api/router-instance.md)
-  - [Component Injections (En)](api/component-injections.md)
+  - [Options de construction du routeur](api/options.md)
+  - [L'Instance du routeur](api/router-instance.md)
+  - [Injections de composant](api/component-injections.md)

docs/en/advanced/data-fetching.md

@@ -1,24 +1,24 @@
-# Data Fetching (En) <br><br> *Cette page est en cours de traduction française. Revenez une autre fois pour lire une traduction achevée ou [participez à la traduction française ici](https://github.com/vuejs-fr/vue-router).*
+# La récupération de données
 
-Sometimes you need to fetch data from the server when a route is activated. For example, before rendering a user profile, you need to fetch the user's data from the server. We can achieve this in two different ways:
+Parfois vous avez besoin de récupérer des données depuis le serveur lorsqu'une route est activée. Par exemple, avant de faire le rendu d'un profil utilisateur, vous avez besoin de récupérer les données de l'utilisateur depuis le serveur. Nous pouvons y parvenir de deux façons différentes :
 
-- **Fetching After Navigation**: perform the navigation first, and fetch data in the incoming component's lifecycle hook. Display a loading state while data is being fetched.
+- **Récupération de donnée après la navigation** : effectue la navigation en premier, et récupère les données dans le hook entrant du cycle de vie d'un composant. Affiche un état de chargement pendant que les données sont en train d'être récupérées.
 
-- **Fetching Before Navigation**: Fetch data before navigation in the route enter guard, and perform the navigation after data has been fetched.
+- **Récupération de donnée avant la navigation** : récupère les données avant la navigation dans la fonction de sécurisation d'entrée de la route, et effectue la navigation après que les données aient été récupérées.
 
-Technically, both are valid choices - it ultimately depends on the user experience you are aiming for.
+Techniquement, les deux choix sont valides. Cela dépend de l'expérience utilisateur que vous souhaitez apporter.
 
-## Fetching After Navigation
+## Récupération de données après la navigation
 
-When using this approach, we navigate and render the incoming component immediately, and fetch data in the component's `created` hook. It gives us the opportunity to display a loading state while the data is being fetched over the network, and we can also handle loading differently for each view.
+En utilisant cette approche, nous naviguons et faisons immédiatement le rendu du composant et récupérons les données via le hook `created` du composant. Cela nous donne l'opportunité d'afficher un état de chargement pendant que les données sont récupérées à travers le réseau, et nous pouvons aussi gérer le chargement différemment pour chaque vue.
 
-Let's assume we have a `Post` component that needs to fetch the data for a post based on `$route.params.id`:
+Assumons que nous ayons un composant `Post` qui a besoin de récupérer des données pour un billet identifié par `$route.params.id` :
 
 ``` html
 <template>
   <div class="post">
     <div class="loading" v-if="loading">
-      Loading...
+      Chargement...
     </div>
 
     <div v-if="error" class="error">
@@ -43,19 +43,19 @@ export default {
     }
   },
   created () {
-    // fetch the data when the view is created and the data is
-    // already being observed
+    // récupérer les données lorsque la vue est créée et
+    // que les données sont déjà observées
     this.fetchData()
   },
   watch: {
-    // call again the method if the route changes
+    // appeler encore la méthode si la route change
     '$route': 'fetchData'
   },
   methods: {
     fetchData () {
       this.error = this.post = null
       this.loading = true
-      // replace getPost with your data fetching util / API wrapper
+      // remplacer `getPost` par une fonction de récupération de données
       getPost(this.$route.params.id, (err, post) => {
         this.loading = false
         if (err) {
@@ -69,10 +69,9 @@ export default {
 }
 ```
 
-## Fetching Before Navigation
+## Récupération de données avant la navigation
 
-With this approach we fetch the data before actually navigating to the new
-route. We can perform the data fetching in the `beforeRouteEnter` guard in the incoming component, and only call `next` when the fetch is complete:
+Avec cette approche, nous récupérerons les données avant de naviguer vers la nouvelle route. Nous pouvons effectuer la récupération de données dans la fonction de sécurisation `beforeRouteEnter` du composant à venir, et seulement appeler `next` lorsque la récupération est terminée :
 
 ``` js
 export default {
@@ -87,8 +86,8 @@ export default {
       next(vm => vm.setData(err, post))
     })
   },
-  // when route changes and this component is already rendered,
-  // the logic will be slightly different.
+  // quand la route change et que ce composant est déjà rendu,
+  // la logique est un peu différente
   beforeRouteUpdate (to, from, next) {
     this.post = null
     getPost(to.params.id, (err, post) => {
@@ -108,4 +107,4 @@ export default {
 }
 ```
 
-The user will stay on the previous view while the resource is being fetched for the incoming view. It is therefore recommended to display a progress bar or some kind of indicator while the data is being fetched. If the data fetch fails, it's also necessary to display some kind of global warning message.
+L'utilisateur va rester sur la vue précédente pendant que la ressource est en train d'être récupérée pour la vue à venir. Il est cependant recommandé d'afficher une barre de progression ou un autre type d'indicateur pendant que les données sont en train d'être récupérées. Si la récupération échoue, il est aussi recommandé d'afficher une sorte de message d'erreur global.

docs/en/advanced/lazy-loading.md

@@ -2,14 +2,14 @@
 
 When building apps with a bundler, the JavaScript bundle can become quite large, and thus affect the page load time. It would be more efficient if we can split each route's components into a separate chunk, and only load them when the route is visited.
 
-Combining Vue's [async component feature](http://vuejs.org/guide/components.html#Async-Components) and Webpack's [code splitting feature](https://webpack.js.org/guides/code-splitting-require/), it's trivially easy to
+Combining Vue's [async component feature](http://vuejs.org/guide/components.html#Async-Components) and webpack's [code splitting feature](https://webpack.js.org/guides/code-splitting-require/), it's trivially easy to
 lazy-load route components.
 
 All we need to do is define our route components as async components:
 
 ``` js
 const Foo = resolve => {
-  // require.ensure is Webpack's special syntax for a code-split point.
+  // `require.ensure` is webpack's special syntax for a code-split point.
   require.ensure(['./Foo.vue'], () => {
     resolve(require('./Foo.vue'))
   })
@@ -42,4 +42,4 @@ const Bar = r => require.ensure([], () => r(require('./Bar.vue')), 'group-foo')
 const Baz = r => require.ensure([], () => r(require('./Baz.vue')), 'group-foo')
 ```
 
-Webpack will group any async module with the same chunk name into the same async chunk - this also means we don't need to explicitly list dependencies for `require.ensure` anymore (thus passing an empty array).
+webpack will group any async module with the same chunk name into the same async chunk - this also means we don't need to explicitly list dependencies for `require.ensure` anymore (thus passing an empty array).

docs/en/advanced/navigation-guards.md

@@ -72,7 +72,7 @@ const router = new VueRouter({
 
 These guards have the exact same signature as global before guards.
 
-### In-Component Guards
+### Sécurisation intra-composants
 
 Finally, you can directly define route navigation guards inside route components (the ones passed to the router configuration) with the following options:
 

docs/en/api/component-injections.md

@@ -1,21 +1,21 @@
-# Component Injections (En) <br><br> *Cette page est en cours de traduction française. Revenez une autre fois pour lire une traduction achevée ou [participez à la traduction française ici](https://github.com/vuejs-fr/vue-router).*
+# Injections de composant
 
-### Injected Properties
+### Propriétés injectées
 
-These properties are injected into every child component by passing the router instance to the root instance as the `router` option.
+Ces propriétés sont injectées dans chacun des composants enfants, en passant l'instance du routeur à l'application racine de Vue en tant qu'option `router`.
 
 - #### $router
 
-  The router instance.
+  L'instance du routeur.
 
 - #### $route
 
-  The current active [Route](route-object.md). This property is read-only and its properties are immutable, but it can be watched.
+ La [Route](route-object.md) actuellement active. C'est une propriété en lecture seule et ses propriétés sont immutables, mais elles restent malgré tout observables.
 
-### Enabled Options
+### Options activées
 
 - **beforeRouteEnter**
-- **beforeRouteUpdate** (added in 2.2)
+- **beforeRouteUpdate** (ajouté en 2.2)
 - **beforeRouteLeave**
 
-  See [In Component Guards](../advanced/navigation-guards.md#incomponent-guards).
+  Voir la [Sécurisation intra-composants](../advanced/navigation-guards.md#securisation-intra-composants).

docs/en/api/options.md

@@ -1,73 +1,73 @@
-# Router Construction Options (En) <br><br> *Cette page est en cours de traduction française. Revenez une autre fois pour lire une traduction achevée ou [participez à la traduction française ici](https://github.com/vuejs-fr/vue-router).*
+# Options de construction du routeur
 
 ### routes
 
 - type: `Array<RouteConfig>`
 
-  Type declaration for `RouteConfig`:
+  Déclaration de type pour `RouteConfig` :
 
   ``` js
   declare type RouteConfig = {
     path: string;
     component?: Component;
-    name?: string; // for named routes
-    components?: { [name: string]: Component }; // for named views
+    name?: string; // pour les routes nommées
+    components?: { [name: string]: Component }; // pour les vues nommées
     redirect?: string | Location | Function;
     props?: boolean | string | Function;
     alias?: string | Array<string>;
-    children?: Array<RouteConfig>; // for nested routes
+    children?: Array<RouteConfig>; // pour les routes imbriquées
     beforeEnter?: (to: Route, from: Route, next: Function) => void;
     meta?: any;
   }
   ```
 
 ### mode
 
-- type: `string`
+- type : `string`
 
-- default: `"hash" (in browser) | "abstract" (in Node.js)`
+- défaut : `"hash" (dans le navigateur) | "abstract" (en Node.js)`
 
-- available values: `"hash" | "history" | "abstract"`
+- valeurs disponibles : `"hash" | "history" | "abstract"`
 
-  Configure the router mode.
+  Configure le mode du routeur.
 
-  - `hash`: uses the URL hash for routing. Works in all Vue-supported browsers, including those that do not support HTML5 History API.
+  - `hash` : utilise le hash de l'URL pour le routage. Fonctionne dans tous les navigateurs supportés par Vue, ainsi que ceux qui ne supportent pas l'API History d'HTML5.
 
-  - `history`: requires HTML5 History API and server config. See [HTML5 History Mode](../essentials/history-mode.md).
+  - `history` : nécessite l'API History d'HTML 5 et la configuration du serveur. Voir [Mode historique de HTML5](../essentials/history-mode.md).
 
-  - `abstract`: works in all JavaScript environments, e.g. server-side with Node.js. **The router will automatically be forced into this mode if no browser API is present.**
+  - `abstract` : fonctionne dans tous les environnements JavaScript, ex. côté serveur avec Node.js. **Le routeur sera automatiquement forcé d'utiliser ce mode si aucune API navigateur n'est présente.**
 
 ### base
 
-- type: `string`
+- type : `string`
 
-- default: `"/"`
+- défaut : `"/"`
 
-  The base URL of the app. For example, if the entire single page application is served under `/app/`, then `base` should use the value `"/app/"`.
+  L'URL de base de l'application. Par exemple, si l'application monopage entière est distribuée sous `/app/`, alors `base` doit utiliser la valeur `"/app/"`.
 
 ### linkActiveClass
 
-- type: `string`
+- type : `string`
 
-- default: `"router-link-active"`
+- défaut : `"router-link-active"`
 
-  Globally configure `<router-link>` default active class. Also see [router-link](router-link.md).
+  Configure de manière globale la classe active par défaut de `<router-link>`. Voir aussi [router-link](router-link.md).
 
 ### linkExactActiveClass
 
 > 2.5.0+
 
-- type: `string`
+- type : `string`
 
-- default: `"router-link-exact-active"`
+- default : `"router-link-exact-active"`
 
-  Globally configure `<router-link>` default active class for exact matches. Also see [router-link](router-link.md).
+  Configure de manière globale la classe active par défaut de `<router-link>` lors d'une correspondance exact. Voir aussi [router-link](router-link.md).
 
 ### scrollBehavior
 
-- type: `Function`
+- type : `Function`
 
-  Signature:
+  Signature :
 
   ```
   (
@@ -77,12 +77,12 @@
   ) => { x: number, y: number } | { selector: string } | ?{}
   ```
 
-  For more details see [Scroll Behavior](../advanced/scroll-behavior.md).
+  Pour plus de détails, voir [Comportement du Scroll](../advanced/scroll-behavior.md).
 
 ### parseQuery / stringifyQuery
 
 > 2.4.0+
 
-- type: `Function`
+- type : `Function`
 
-  Provide custom query string parse / stringify functions. Overrides the default.
+  Permet de spécifier des fonctions personnalisées pour formater en objet ou en chaîne de caractères la requête. Surcharge les fonctions par défaut.

docs/en/api/route-object.md

@@ -49,7 +49,7 @@ L'objet `Route` peut être trouvé à plusieurs endroits :
   - type : `Object`
 
     Un objet qui contient des pairs clé/valeur de la requête au format d'une chaîne de caractères. Par exemple, pour un chemin `/foo?user=1`, on aura `$route.query.user == 1`. S'il n'y a pas de requête, alors la valeur sera un objet vide.
-    
+
 - **$route.hash**
 
   - type : `string`