|
1 |
| -# The Route Object (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).* |
| 1 | +# L'objet `Route` |
2 | 2 |
|
3 |
| -A **route object** represents the state of the current active route. It contains parsed information of the current URL and the **route records** matched by the URL. |
| 3 | +Un **objet `Route`** représente l'état actuel de la route active. Il contient des informations analysées à propos de l'URL courante et **les itinéraires de route** appariés par l'URL. |
4 | 4 |
|
5 |
| -The route object is immutable. Every successful navigation will result in a fresh route object. |
| 5 | +L'objet `Route` est immutable. Chaque navigation qui se déroule avec succès résultera en un nouvel objet `Route`. |
6 | 6 |
|
7 |
| -The route object can be found in multiple places: |
| 7 | +L'objet `Route` peut être trouvé à plusieurs endroits : |
8 | 8 |
|
9 |
| -- Inside components as `this.$route` |
| 9 | +- À l'intérieur des composants en tant que `this.$route` |
10 | 10 |
|
11 |
| -- Inside `$route` watcher callbacks |
| 11 | +- À l'intérieur des fonctions de rappel des observateurs de `$route` |
12 | 12 |
|
13 |
| -- As the return value of calling `router.match(location)` |
| 13 | +- Comme valeur de retour après l'appel de `router.match(location)` |
14 | 14 |
|
15 |
| -- Inside navigation guards as the first two arguments: |
| 15 | +- À l'intérieur des fonctions de sécurisation de la navigation, dans les deux premiers paramètres de la fonction : |
16 | 16 |
|
17 | 17 | ``` js
|
18 | 18 | router.beforeEach((to, from, next) => {
|
19 |
| - // to and from are both route objects |
| 19 | + // `to` et `from` sont tous les deux des objets Route |
20 | 20 | })
|
21 | 21 | ```
|
22 | 22 |
|
23 |
| -- Inside the `scrollBehavior` function as the first two arguments: |
| 23 | +- À l'intérieur de la fonction `scrollBehavior` dans les deux premiers arguments : |
24 | 24 |
|
25 | 25 | ``` js
|
26 | 26 | const router = new VueRouter({
|
27 | 27 | scrollBehavior (to, from, savedPosition) {
|
28 |
| - // to and from are both route objects |
| 28 | + // `to` et `from` sont tous les deux des objets Route |
29 | 29 | }
|
30 | 30 | })
|
31 | 31 | ```
|
32 | 32 |
|
33 |
| -### Route Object Properties |
| 33 | +### Propriétés de l'objet `Route` |
34 | 34 |
|
35 | 35 | - **$route.path**
|
36 | 36 |
|
37 |
| - - type: `string` |
| 37 | + - type : `string` |
38 | 38 |
|
39 |
| - A string that equals the path of the current route, always resolved as an absolute path. e.g. `"/foo/bar"`. |
| 39 | + Une chaîne de caractères représentant le chemin de la route en cours, toujours résolue en tant que chemin absolu, ex : `"/foo/bar"`. |
40 | 40 |
|
41 | 41 | - **$route.params**
|
42 | 42 |
|
43 |
| - - type: `Object` |
| 43 | + - type : `Object` |
44 | 44 |
|
45 |
| - An object that contains key/value pairs of dynamic segments and star segments. If there are no params the value will be an empty object. |
| 45 | + Un objet qui contient des pairs clé/valeur de segments dynamiques et segments *star*. S'il n'y a pas de paramètres, alors la valeur sera un objet vide. |
46 | 46 |
|
47 | 47 | - **$route.query**
|
48 | 48 |
|
49 |
| - - type: `Object` |
50 |
| - |
51 |
| - An object that contains key/value pairs of the query string. For example, for a path `/foo?user=1`, we get `$route.query.user == 1`. If there is no query the value will be an empty object. |
| 49 | + - type : `Object` |
52 | 50 |
|
| 51 | + 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. |
| 52 | + |
53 | 53 | - **$route.hash**
|
54 | 54 |
|
55 |
| - - type: `string` |
| 55 | + - type : `string` |
56 | 56 |
|
57 |
| - The hash of the current route (with the `#`), if it has one. If no hash is present the value will be an empty string. |
| 57 | + Le hash de la route courante (avec le `#`), s'il y en a un. S'il n'y a pas de hash, alors la valeur sera une chaîne de caractères vide. |
58 | 58 |
|
59 | 59 | - **$route.fullPath**
|
60 | 60 |
|
61 |
| - - type: `string` |
| 61 | + - type : `string` |
62 | 62 |
|
63 |
| - The full resolved URL including query and hash. |
| 63 | + L'URL entièrement résolue, incluant la requête et le hash. |
64 | 64 |
|
65 | 65 | - **$route.matched**
|
66 | 66 |
|
67 |
| - - type: `Array<RouteRecord>` |
| 67 | + - type : `Array<RouteRecord>` |
68 | 68 |
|
69 |
| - An Array containing **route records** for all nested path segments of the current route. Route records are the copies of the objects in the `routes` configuration Array (and in `children` Arrays): |
| 69 | + Un `Array` contenant les **les itinéraires de la route** pour chaque segment de chemin imbriqué de la route courante. Les itinéraires de la route sont des copies des objets dans le tableau de configuration `routes` (et dans les tableaux `children`). |
70 | 70 |
|
71 | 71 | ``` js
|
72 | 72 | const router = new VueRouter({
|
73 | 73 | routes: [
|
74 |
| - // the following object is a route record |
| 74 | + // l'objet qui suit est un itinéraire de route |
75 | 75 | { path: '/foo', component: Foo,
|
76 | 76 | children: [
|
77 |
| - // this is also a route record |
| 77 | + // c'est aussi un itinéraire |
78 | 78 | { path: 'bar', component: Bar }
|
79 | 79 | ]
|
80 | 80 | }
|
81 | 81 | ]
|
82 | 82 | })
|
83 | 83 | ```
|
84 | 84 |
|
85 |
| - When the URL is `/foo/bar`, `$route.matched` will be an Array containing both objects (cloned), in parent to child order. |
| 85 | + Lorsque l'URL sera `/foo/bar`, `$route.matched` sera un `Array` contenant les deux objets (clonés), dans l'ordre parent à l'enfant. |
86 | 86 |
|
87 | 87 | - **$route.name**
|
88 | 88 |
|
89 |
| - The name of the current route, if it has one. (See [Named Routes](../essentials/named-routes.md)) |
| 89 | + Le nom de la route courante, si elle en a un. (Voir [Routes nommées](../essentials/named-routes.md)). |
0 commit comments