From f2a706048e0f1b08aee465f762eabc4c68441ce7 Mon Sep 17 00:00:00 2001 From: Hugo Alliaume Date: Wed, 24 May 2017 07:49:13 +0200 Subject: [PATCH 1/4] Traduction de `api/router-link.md` --- docs/en/SUMMARY.md | 2 +- docs/en/api/router-link.md | 108 ++++++++++++++++++------------------- 2 files changed, 55 insertions(+), 55 deletions(-) diff --git a/docs/en/SUMMARY.md b/docs/en/SUMMARY.md index b318f5244..ea7e580db 100644 --- a/docs/en/SUMMARY.md +++ b/docs/en/SUMMARY.md @@ -23,7 +23,7 @@ - [Scroll Behavior (En)](advanced/scroll-behavior.md) - [Lazy Loading (En)](advanced/lazy-loading.md) - Réference de l'API - - [router-link (En)](api/router-link.md) + - [router-link](api/router-link.md) - [router-view (En)](api/router-view.md) - [The Route Object (En)](api/route-object.md) - [Router Constructor Options (En)](api/options.md) diff --git a/docs/en/api/router-link.md b/docs/en/api/router-link.md index 38d469906..0ed3fc4f6 100644 --- a/docs/en/api/router-link.md +++ b/docs/en/api/router-link.md @@ -1,54 +1,54 @@ -# `` (En)

*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).* +# `` -`` is the component for enabling user navigation in a router-enabled app. The target location is specified with the `to` prop. It renders as an `` tag with correct `href` by default, but can be configured with the `tag` prop. In addition, the link automatically gets an active CSS class when the target route is active. +`` est le composant pour activer la navigation utilisateur dans une application où le routeur est activé. La localisation cible est spécifiée grâce à la prop `to`. Il est rendu en tant que tag `` avec le `href` correct par défaut, mais peut être configuré grâce à la prop `tag`. De plus, le lien se vera attribuer une classe CSS active lorsque la route cible est active. -`` is preferred over hard-coded `` for the following reasons: +`` est préféré par rapport au `` hard-codé pour les raisons suivantes : -- It works the same way in both HTML5 history mode and hash mode, so if you ever decide to switch mode, or when the router falls back to hash mode in IE9, nothing needs to be changed. +- Cela fonctionne de la même manière qu'on soit dans le mode historique HTML5 ou le mode hash, donc si vous avez décidé de changer de mode, ou alors que le routeur se replie sur le mode hash pour IE9, rien n'a besoin d'être changé. -- In HTML5 history mode, `router-link` will intercept the click event so that the browser doesn't try to reload the page. +- Dans le mode historique HTML5, `router-link` interceptera l'événement du clic, comme ça le navigateur n'essaiera pas de rafraîchir la page. -- When you are using the `base` option in HTML5 history mode, you don't need to include it in `to` prop's URLs. +- En utilisant l'option `base` dans le mode historique HTML5, vous n'avez pas besoin de l'inclure dans les props `to` des URLs. ### Props - **to** - - type: `string | Location` + - type : `string | Location` - - required - - Denotes the target route of the link. When clicked, the value of the `to` prop will be passed to `router.push()` internally, so the value can be either a string or a location descriptor object. + - requis + Désigne la route cible du lien. Lorsqu'il est cliqué, la valeur de la prop `to` va être passé de manière interne à `router.push`, donc la valeur peut soit être une chaîne de caractères, ou alors un objet décrivant une localisation. + ``` html - - Home - - Home + + Accueil + + Accueil - - Home + + Accueil - - Home + + Accueil - - Home + + Accueil - - User + + Utilisateur - - Register + + S'enregistrer ``` - **replace** - - type: `boolean` + - type : `boolean` - - default: `false` + - défaut : `false` - Setting `replace` prop will call `router.replace()` instead of `router.push()` when clicked, so the navigation will not leave a history record. + Configurer la prop `replace` appellera `router.replace()` au lieu de `router.push()` lors du clic, comme ça, la navigation ne laissera pas un enregistrement dans l'historique. ``` html @@ -56,78 +56,78 @@ - **append** - - type: `boolean` - - - default: `false` + - type : `boolean` - Setting `append` prop always appends the relative path to the current path. For example, assuming we are navigating from `/a` to a relative link `b`, without `append` we will end up at `/b`, but with `append` we will end up at `/a/b`. + - défaut : `false` + Configurer la propriété `append` suffixe toujours le chemin relatif au chemin courant. Par exemple, assumons que nous naviguons de `/a` à un lien relatif `b`, sans `append` on finira sur `/b`, mais avec `append` on finira sur `/a/b`. + ``` html ``` - **tag** - - type: `string` + - type : `string` - - default: `"a"` + - défaut : `"a"` - Sometimes we want `` to render as another tag, e.g `
  • `. Then we can use `tag` prop to specify which tag to render to, and it will still listen to click events for navigation. + Parfois, on veut que `` soit rendu avec un tag différent, ex : `
  • `. On peut alors utiliser la prop `tag` pour modifier le tag qui sera rendu, et il écoutera toujours aux événements de clic pour la navigation ``` html foo - +
  • foo
    • ``` - **active-class** - - type: `string` + - type : `string` - - default: `"router-link-active"` + - défaut : `"router-link-active"` - Configure the active CSS class applied when the link is active. Note the default value can also be configured globally via the `linkActiveClass` router constructor option. + Configure la classe CSS active qui sera appliquée lorsque le lien sera actif. Notez que la valeur par défaut peut aussi être configurée de manière globale via l'option `linkActiveClass` du constructeur du routeur. - **exact** - - type: `boolean` + - type : `boolean` - - default: `false` + - défaut : `false` - The default active class matching behavior is **inclusive match**. For example, `` will get this class applied as long as the current path starts with `/a/` or is `/a`. + Le comportement par défaut de la correspondance de classe active est une **correspondance inclusive**. Par exemple, `` vera cette classe appliquée tant que le chemin courant commencera par `/a/` ou `/a`. - One consequence of this is that `` will be active for every route! To force the link into "exact match mode", use the `exact` prop: + Une conséquence de cela est que `` sera actif pour toutes les routes ! Pour forcer le lien dans un "mode correspondance exacte", utilisez la prop `exact`. ``` html - + ``` - - Checkout more examples explaining active link class [live](https://jsfiddle.net/8xrk1n9f/). + + Allez voir les exemples expliquant la classe active pour les liens [ici](https://jsfiddle.net/8xrk1n9f/). - **event** > 2.1.0+ - - type: `string | Array` + - type : `string | Array` - - default: `'click'` + - défaut : `'click'` - Specify the event(s) that can trigger the link navigation. + Spécifie les événement(s) que peuvent lancer la navigation de lien. - **exact-active-class** > 2.5.0+ - - type: `string` + - type : `string` - - default: `"router-link-exact-active"` + - défaut : `"router-link-exact-active"` - Configure the active CSS class applied when the link is active with exact match. Note the default value can also be configured globally via the `linkExactActiveClass` router constructor option. + Configure la classe CSS active qui sera appliquée lorsqu'un lien sera actif avec une correspondance exact. Notez que la valeur par défaut peut aussi être configurée de manière globale via l'option `linkExactActiveClass` du constructeur du routeur. -### Applying Active Class to Outer Element +### Appliquer la classe active à l'élément extérieur -Sometimes we may want the active class to be applied to an outer element rather than the `` tag itself, in that case, you can render that outer element using `` and wrap the raw `` tag inside: +Parfois, on voudrait que la classe active soit appliquer à un élément extérieur au lieu de l'élément `` lui-même, dans ce cas, vous pouvez faire le rendu de cet élément extérieur en utilisant `` et en entourant le tag `` : ``` html @@ -135,4 +135,4 @@ Sometimes we may want the active class to be applied to an outer element rather ``` -In this case the `` will be the actual link (and will get the correct `href`), but the active class will be applied to the outer `
  • `. +Dans ce cas, `` sera le lien actuel (et récupérera le bon `href`), mais la classe active sera appliquée à l'élément extérieur `
  • `. From ab3555731254de4cf3c5618c05734ffb0ae24e78 Mon Sep 17 00:00:00 2001 From: Hugo Alliaume Date: Sat, 27 May 2017 17:03:31 +0200 Subject: [PATCH 2/4] =?UTF-8?q?Modifications=20suite=20=C3=A0=20la=201?= =?UTF-8?q?=C3=A8re=20review=20de=20Haeresis?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/en/api/router-link.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/en/api/router-link.md b/docs/en/api/router-link.md index 0ed3fc4f6..9d7eb8080 100644 --- a/docs/en/api/router-link.md +++ b/docs/en/api/router-link.md @@ -6,7 +6,7 @@ - Cela fonctionne de la même manière qu'on soit dans le mode historique HTML5 ou le mode hash, donc si vous avez décidé de changer de mode, ou alors que le routeur se replie sur le mode hash pour IE9, rien n'a besoin d'être changé. -- Dans le mode historique HTML5, `router-link` interceptera l'événement du clic, comme ça le navigateur n'essaiera pas de rafraîchir la page. +- Dans le mode historique HTML5, `router-link` interceptera l'évènement du clic, comme ça le navigateur n'essaiera pas de rafraîchir la page. - En utilisant l'option `base` dans le mode historique HTML5, vous n'avez pas besoin de l'inclure dans les props `to` des URLs. @@ -18,7 +18,7 @@ - requis - Désigne la route cible du lien. Lorsqu'il est cliqué, la valeur de la prop `to` va être passé de manière interne à `router.push`, donc la valeur peut soit être une chaîne de caractères, ou alors un objet décrivant une localisation. + Désigne la route cible du lien. Lorsqu'il est cliqué, la valeur de la prop `to` va être passée de manière interne à `router.push`, donc la valeur peut soit être une chaîne de caractères, ou alors un objet décrivant une localisation. ``` html @@ -26,10 +26,10 @@ Accueil - + Accueil - + Accueil @@ -38,7 +38,7 @@ Utilisateur - + S'enregistrer ``` @@ -72,7 +72,7 @@ - défaut : `"a"` - Parfois, on veut que `` soit rendu avec un tag différent, ex : `
  • `. On peut alors utiliser la prop `tag` pour modifier le tag qui sera rendu, et il écoutera toujours aux événements de clic pour la navigation + Parfois, on veut que `` soit rendu avec un tag différent, ex : `
  • `. On peut alors utiliser la prop `tag` pour modifier la balise qui sera rendue, et elle écoutera toujours les évènements de clic pour la navigation ``` html foo @@ -96,10 +96,10 @@ Le comportement par défaut de la correspondance de classe active est une **correspondance inclusive**. Par exemple, `` vera cette classe appliquée tant que le chemin courant commencera par `/a/` ou `/a`. - Une conséquence de cela est que `` sera actif pour toutes les routes ! Pour forcer le lien dans un "mode correspondance exacte", utilisez la prop `exact`. + Une conséquence de cela est que `` sera actif pour toutes les routes ! Pour forcer le lien dans un « mode correspondance exacte », utilisez la prop `exact`. ``` html - + ``` @@ -113,7 +113,7 @@ - défaut : `'click'` - Spécifie les événement(s) que peuvent lancer la navigation de lien. + Spécifie les évènement(s) que peu(ven)t lancer la navigation de lien. - **exact-active-class** @@ -127,7 +127,7 @@ ### Appliquer la classe active à l'élément extérieur -Parfois, on voudrait que la classe active soit appliquer à un élément extérieur au lieu de l'élément `` lui-même, dans ce cas, vous pouvez faire le rendu de cet élément extérieur en utilisant `` et en entourant le tag `` : +Parfois, on voudrait que la classe active soit appliquée à un élément extérieur au lieu de l'élément `` lui-même, dans ce cas, vous pouvez faire le rendu de cet élément extérieur en utilisant `` et en entourant le tag `` : ``` html From 83b5188f72ed9dcebc6414e1a05ea85ea5efb5a7 Mon Sep 17 00:00:00 2001 From: Hugo Alliaume Date: Sat, 27 May 2017 20:46:10 +0200 Subject: [PATCH 3/4] =?UTF-8?q?Modifications=20suite=20=C3=A0=20la=202?= =?UTF-8?q?=C3=A8me=20review=20de=20Haeresis?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/en/api/router-link.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/en/api/router-link.md b/docs/en/api/router-link.md index 9d7eb8080..541e97dca 100644 --- a/docs/en/api/router-link.md +++ b/docs/en/api/router-link.md @@ -1,8 +1,8 @@ # `` -`` est le composant pour activer la navigation utilisateur dans une application où le routeur est activé. La localisation cible est spécifiée grâce à la prop `to`. Il est rendu en tant que tag `` avec le `href` correct par défaut, mais peut être configuré grâce à la prop `tag`. De plus, le lien se vera attribuer une classe CSS active lorsque la route cible est active. +`` est le composant pour activer la navigation utilisateur dans une application où le routeur est activé. La localisation cible est spécifiée grâce à la prop `to`. Il est rendu en tant que balise `` avec le `href` correct par défaut, mais peut être configuré grâce à la prop `tag`. De plus, le lien se vera attribuer une classe CSS active lorsque la route cible est active. -`` est préféré par rapport au `` hard-codé pour les raisons suivantes : +`` est préféré par rapport au `` en dur dans le code pour les raisons suivantes : - Cela fonctionne de la même manière qu'on soit dans le mode historique HTML5 ou le mode hash, donc si vous avez décidé de changer de mode, ou alors que le routeur se replie sur le mode hash pour IE9, rien n'a besoin d'être changé. From 1e4420ca3ee23d3f2d38bb4e1a7fa3ad2acde9fc Mon Sep 17 00:00:00 2001 From: Hugo Alliaume Date: Fri, 2 Jun 2017 08:43:36 +0200 Subject: [PATCH 4/4] =?UTF-8?q?Modification=20suite=20=C3=A0=20la=202?= =?UTF-8?q?=C3=A8me=20review=20de=20@Haeresis?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/en/api/router-link.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/api/router-link.md b/docs/en/api/router-link.md index 541e97dca..a14015caf 100644 --- a/docs/en/api/router-link.md +++ b/docs/en/api/router-link.md @@ -72,7 +72,7 @@ - défaut : `"a"` - Parfois, on veut que `` soit rendu avec un tag différent, ex : `
  • `. On peut alors utiliser la prop `tag` pour modifier la balise qui sera rendue, et elle écoutera toujours les évènements de clic pour la navigation + Parfois, on veut que `` soit rendu avec une balise différente, ex : `
  • `. On peut alors utiliser la prop `tag` pour modifier la balise qui sera rendue, et elle écoutera toujours les évènements de clic pour la navigation ``` html foo