Skip to content

Commit 49e67d7

Browse files
Merge pull request #11 from vuejs-fr/routing
Relucture de `routing.md`
2 parents ebf50cc + 3d39f84 commit 49e67d7

File tree

1 file changed

+51
-51
lines changed

1 file changed

+51
-51
lines changed

en/guide/routing.md

+51-51
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
2-
title: Routing
3-
description: Nuxt.js use the file-system to generate the routes of your web applications, it's as simple as PHP to create routes.
2+
title: Routage
3+
description: Nuxt.js utilise le système de fichiers pour générer les routes de votre application web, c'est aussi simple qu'en PHP de créer des routes.
44
---
55

6-
> Nuxt.js generates automatically the [vue-router](https://github.com/vuejs/vue-router) configuration according to your file tree of Vue files inside the `pages` directory.
6+
> Nuxt.js génère automatiquement la configuration pour [vue-router](https://github.com/vuejs/vue-router) en fonction de votre arborescence de fichiers Vue se trouvant au sein du répertoire `pages`.
77
8-
## Basic Routes
8+
## Routes basiques
99

10-
This file tree:
10+
Cette arborescence :
1111

1212
```bash
1313
pages/
@@ -17,7 +17,7 @@ pages/
1717
--| index.vue
1818
```
1919

20-
will automatically generate:
20+
génèrera automatiquement :
2121

2222
```js
2323
router: {
@@ -41,11 +41,11 @@ router: {
4141
}
4242
```
4343

44-
## Dynamic Routes
44+
## Routes dynamiques
4545

46-
To define a dynamic route with a param, you need to define a .vue file OR a directory **prefixed by an underscore**.
46+
Pour définir une route dynamique à l'aide d'un paramètre, vous devez définir un fichier `.vue` OU un répertoire **préfixé par un souligné (`_`)**.
4747

48-
This file tree:
48+
Cette arborescence :
4949

5050
```bash
5151
pages/
@@ -57,7 +57,7 @@ pages/
5757
--| index.vue
5858
```
5959

60-
will automatically generate:
60+
génèrera automatiquement :
6161

6262
```js
6363
router: {
@@ -86,38 +86,38 @@ router: {
8686
}
8787
```
8888

89-
As you can see the route named `users-id` has the path `:id?` which makes it optional, if you want to make it required, create an `index.vue` file in the `users/_id` directory.
89+
Comme vous pouvez le voir, la route nommée `users-id` contient le chemin `:id?` ce qui le rend optionnel. Si vous voulez le rendre obligatoire, créez un fichier `index.vue` dans le dossier `users/_id`.
9090

91-
<p class="Alert Alert--info">Warning: dynamic routes are ignored by the `generate` command: [API Configuration generate](/api/configuration-generate#routes)</p>
91+
<p class="Alert Alert--info"><b>Attention :</b> les routes dynamiques sont ignorées par la commande `generate` : [ Configuration de l'API pour la génération](/api/configuration-generate#routes)</p>
9292

93-
### Validate Route Params
93+
### Validation des paramètres de route
9494

95-
Nuxt.js lets you define a validator method inside your dynamic route component.
95+
Nuxt.js vous permet de définir une méthode de validation dans votre composant de routage dynamique.
9696

97-
In this example: `pages/users/_id.vue`
97+
Par exemple : `pages/users/_id.vue`
9898

9999
```js
100100
export default {
101101
validate ({ params }) {
102-
// Must be a number
102+
// Doit être un nombre
103103
return /^\d+$/.test(params.id)
104104
}
105105
}
106106
```
107107

108-
If the validate method does not return `true`, Nuxt.js will automatically load the 404 error page.
108+
Si la méthode de validation ne renvoie pas `true`, Nuxt.js chargera automatiquement la page d'erreur 404.
109109

110-
More information about the validate method: [API Pages validate](/api/pages-validate)
110+
Plus d'informations à propos de la méthode de validation : [API pour la validation de pages](/api/pages-validate)
111111

112-
## Nested Routes
112+
## Routes imbriquées
113113

114-
Nuxt.js lets you create nested route by using the children routes of vue-router.
114+
Nuxt.js vous permet de créer des routes imbriquées en utilisant les routes enfants de vue-router.
115115

116-
To define the parent component of a nested route, you need to create a Vue file with the **same name as the directory** which contain your children views.
116+
Pour définir le composant parent d'une route imbriquée, vous devez créer un fichier Vue avec le **même nom que le répertoire** qui contient les vues enfants.
117117

118-
<p class="Alert Alert--info">Don't forget to write `<nuxt-child/>` inside the parent component (.vue file).</p>
118+
<p class="Alert Alert--info"><b>Attention :</b> n'oubliez pas d'écrire `<nuxt-child/>` au sein du composant parent (fichier <code>.vue</code>).</p>
119119

120-
This file tree:
120+
Cette arborescence :
121121

122122
```bash
123123
pages/
@@ -127,7 +127,7 @@ pages/
127127
--| users.vue
128128
```
129129

130-
will automatically generate:
130+
génèrera automatiquement :
131131

132132
```js
133133
router: {
@@ -152,11 +152,11 @@ router: {
152152
}
153153
```
154154

155-
## Dynamic Nested Routes
155+
## Routes dynamiques imbriquées
156156

157-
This scenario should not often happen, but it is possible with Nuxt.js: having dynamic children inside dynamic parents.
157+
Ce scénario ne devrait pas arriver souvent, mais il est possible avec Nuxt.js d'avoir des routes dynamiques enfants dans des routes dynamiques parentes.
158158

159-
This file tree:
159+
Cette arborescence :
160160

161161
```bash
162162
pages/
@@ -170,7 +170,7 @@ pages/
170170
--| index.vue
171171
```
172172

173-
will automatically generate:
173+
génèrera automatiquement :
174174

175175
```js
176176
router: {
@@ -213,25 +213,25 @@ router: {
213213

214214
## Transitions
215215

216-
Nuxt.js uses the [&lt;transition&gt;](http://vuejs.org/v2/guide/transitions.html#Transitioning-Single-Elements-Components) component to let you create amazing transitions/animations between your routes.
216+
Nuxt.js utilise le composant [`<transition>`](http://vuejs.org/v2/guide/transitions.html#Transitioning-Single-Elements-Components) afin de vous permettre de créer de superbes transitions / animations entre vos routes.
217217

218-
### Global Settings
218+
### Paramètres globaux
219219

220-
<p class="Alert Alert--info">Nuxt.js default transition name is `"page"`.</p>
220+
<p class="Alert Alert--nuxt-green"><b>Info :</b> dans Nuxt.js, le nom de la transition par défaut est `"page"`.</p>
221221

222-
To add a fade transition to every page of your application, we need a CSS file that is shared across all our routes, so we start by creating a file in the `assets` folder.
222+
Pour ajouter une transition de fondu à chaque page de votre application, nous avons besoin d'un fichier CSS qui est partagé sur toutes nos routes. Commençons par créer un fichier dans le dossier `assets`.
223223

224-
Our global css in `assets/main.css`:
224+
Notre CSS global dans `assets/main.css` :
225225
```css
226226
.page-enter-active, .page-leave-active {
227227
transition: opacity .5s;
228228
}
229-
.page-enter, .page-leave-to {
229+
.page-enter, .page-leave-active {
230230
opacity: 0;
231231
}
232232
```
233233

234-
We add its path in our `nuxt.config.js` file:
234+
Nous ajoutons son chemin dans notre fichier de configuration `nuxt.config.js` :
235235
```js
236236
module.exports = {
237237
css: [
@@ -240,13 +240,13 @@ module.exports = {
240240
}
241241
```
242242

243-
More information about the transition key: [API Configuration transition](/api/pages-transition)
243+
Plus d'informations à propos des transitions : [Configuration de l'API pour les transitions](/api/pages-transition)
244244

245-
### Page Settings
245+
### Paramètres des pages
246246

247-
You can also define a custom transition for only one page with the `transition` property.
247+
Vous êtes également libre de définir une transition personnalisée pour une seule page à l'aide de la propriété `transition`.
248248

249-
We add a new class in our global css in `assets/main.css`:
249+
Nous ajoutons une nouvelle classe dans notre CSS global `assets/main.css` :
250250
```css
251251
.test-enter-active, .test-leave-active {
252252
transition: opacity .5s;
@@ -256,35 +256,35 @@ We add a new class in our global css in `assets/main.css`:
256256
}
257257
```
258258

259-
then, we use the transition property to define the class name to use for this page transition:
259+
puis, nous utilisons la propriété transition pour définir le nom de la classe à utiliser pour cette transition de page :
260260
```js
261261
export default {
262262
transition: 'test'
263263
}
264264
```
265265

266-
More information about the transition property: [API Pages transition](/api/pages-transition)
266+
Plus d'informations à propos de la propriété transition : [API pour la transition de pages](/api/pages-transition)
267267

268268
## Middleware
269269

270-
> Middleware lets you define custom functions that can be run before rendering either a page or a group of pages.
270+
> Le middleware vous permet de définir une fonction personnalisée qui sera exécutée avant le rendu d'une page ou d'un groupe de pages.
271271
272-
**Every middleware should be placed in the `middleware/` directory.** The filename will be the name of the middleware (`middleware/auth.js` will be the `auth` middleware).
272+
**Tous les middlewares devraient être placés dans le répertoire `middleware/`.** Le nom du fichier étant le nom du middleware (`middleware/auth.js` deviendra le middleware `auth`).
273273

274-
A middleware receives [the context](/api/context) as first argument:
274+
Un middleware reçoit [le contexte](/api#context) comme premier argument :
275275

276276
```js
277277
export default function (context) {
278278
context.userAgent = context.isServer ? context.req.headers['user-agent'] : navigator.userAgent
279279
}
280280
```
281281

282-
The middleware will be executed in series in this order:
282+
Le middleware sera exécuté en série dans l'ordre suivant :
283283
1. `nuxt.config.js`
284-
2. Matched layouts
285-
3. Matched pages
284+
2. Mises en page correspondantes
285+
3. Pages correspondantes
286286

287-
A middleware can be asynchronous, simply return a `Promise` or use the 2nd `callback` argument:
287+
Un middleware peut être asynchrone, retourner une `Promise` ou utiliser une fonction de rappel en second argument :
288288

289289
`middleware/stats.js`
290290
```js
@@ -297,7 +297,7 @@ export default function ({ route }) {
297297
}
298298
```
299299

300-
Then, in your `nuxt.config.js`, layout or page, use the `middleware` key:
300+
Puis, dans `nuxt.config.js`, pour une mise en page ou une page, utilisez le mot-clé `middleware` :
301301

302302
`nuxt.config.js`
303303
```js
@@ -308,6 +308,6 @@ module.exports = {
308308
}
309309
```
310310

311-
The `stats` middleware will be called for every route changes.
311+
Le middleware `stats` sera appelé à chaque changement de routes.
312312

313-
To see a real-life example using the middleware, please see [example-auth0](https://github.com/nuxt/example-auth0) on GitHub.
313+
Pour voir un exemple d'usage utilisant les middlewares, consultez [example-auth0](https://github.com/nuxt/example-auth0) sur GitHub.

0 commit comments

Comments
 (0)