Skip to content

🇫🇷 [Translation WIP] Official French Translation from Vuejs-FR #1520

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
Jun 19, 2017
Merged
Show file tree
Hide file tree
Changes from 7 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 19 additions & 10 deletions docs/fr/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,25 +8,34 @@
- Essentiel
- [Pour commencer](essentials/getting-started.md)
- [Dynamic Route Matching (En)](essentials/dynamic-matching.md)
- [Nested Routes (En)](essentials/nested-routes.md)
- [Programmatic Navigation (En)](essentials/navigation.md)
- [Named Routes (En)](essentials/named-routes.md)
- [Named Views (En)](essentials/named-views.md)
- [Redirect and Alias (En)](essentials/redirect-and-alias.md)
- [Navigation programmatique](essentials/navigation.md)
- [Routes imbriquées](essentials/nested-routes.md)
- [Routes nommées](essentials/named-routes.md)
- [Vues nommées](essentials/named-views.md)
- [Redirection et alias](essentials/redirect-and-alias.md)
- [Passing Props to Route Components (En)](essentials/passing-props.md)
- [HTML5 History Mode (En)](essentials/history-mode.md)
- 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)
- [Comportement du défilement](advanced/scroll-behavior.md)
- [Le chargement à la volée](advanced/lazy-loading.md)
- Réference de l'API
- [Options de construction du routeur](api/options.md)
- [routes](api/options.md#routes)
- [mode](api/options.md#mode)
- [base](api/options.md#base)
- [linkActiveClass](api/options.md#linkactiveclass)
- [linkExactActiveClass](api/options.md#linkexactactiveclass)
- [scrollBehavior](api/options.md#scrollbehavior)
- [parseQuery / stringifyQuery](api/options.md#parsequery--stringifyquery)
- [fallback](api/options.md#fallback)
- [L'instance du routeur](api/router-instance.md)
- [Propriétés](api/router-instance.md#propriétés)
- [Méthodes](api/router-instance.md#méthodes)
- [L'objet Route](api/route-object.md)
- [Injections de composant](api/component-injections.md)
- [router-link](api/router-link.md)
- [router-view](api/router-view.md)
- [L'objet Route](api/route-object.md)
- [Options de construction du routeur](api/options.md)
- [L'Instance du routeur](api/router-instance.md)
- [Injections de composant](api/component-injections.md)
5 changes: 3 additions & 2 deletions docs/fr/advanced/scroll-behavior.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,11 +20,11 @@ La fonction `scrollBehavior` reçoit les objets de route `to` et `from`. Le troi
La fonction peut retourner un objet décrivant la position du défilement. L'objet peut être de la forme :

- `{ x: number, y: number }`
- `{ selector: String }`
- `{ selector: string, offset? : { x: number, y: number }}` (offset seulement supporté pour les versions 2.6.0+)

Si une valeur équivalente à `false` ou un objet vide est retourné, aucun défilement ne sera produit.

Par exemple :
Par exemple :

``` js
scrollBehavior (to, from, savedPosition) {
Expand Down Expand Up @@ -53,6 +53,7 @@ scrollBehavior (to, from, savedPosition) {
if (to.hash) {
return {
selector: to.hash
// , offset: { x: 0, y: 10 }
}
}
}
Expand Down
14 changes: 14 additions & 0 deletions docs/fr/api/options.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,10 @@
children?: Array<RouteConfig>; // pour les routes imbriquées
beforeEnter?: (to: Route, from: Route, next: Function) => void;
meta?: any;

// 2.6.0+
caseSensitive?: boolean; // use case sensitive match? (default: false)
pathToRegexpOptions?: Object; // path-to-regexp options for compiling regex
}
```

Expand Down Expand Up @@ -86,3 +90,13 @@
- type : `Function`

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.

### fallback

> 2.6.0+

- type : `boolean`

Contrôle comment le routeur devrait passer en mode `hash` quand le navigateur ne supporte pas `history.pushState`. Par défaut à `true`.

Passer cette valeur à `false` va essentiellement faire que la navigation via `router-link` va réclamer un rechargement de page dans IE9. Ceci est utile quand l'application est rendu côté serveur et à besoin de fonctionner dans IE9, car le mode hash ne fonctionne pas avec du SSR.
2 changes: 2 additions & 0 deletions docs/fr/api/router-instance.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,8 @@
}
```

- `current` is the current Route by default (most of the time you don't need to change this)
- `append` allows you to append the path to the `current` route (as with [`router-link`](https://router.vuejs.org/en/api/router-link.html#props))

- **router.addRoutes(routes)**

Expand Down
28 changes: 28 additions & 0 deletions docs/fr/essentials/history-mode.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,34 @@ location / {

For Node.js/Express, consider using [connect-history-api-fallback middleware](https://github.com/bripkens/connect-history-api-fallback).

#### Internet Information Services (IIS)
```
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<system.webServer>
<rewrite>
<rules>
<rule name="Handle History Mode and custom 404/500" stopProcessing="true">
<match url="(.*)" />
<conditions logicalGrouping="MatchAll">
<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
</conditions>
<action type="Rewrite" url="index.html" />
</rule>
</rules>
</rewrite>
<httpErrors>
<remove statusCode="404" subStatusCode="-1" />
<remove statusCode="500" subStatusCode="-1" />
<error statusCode="404" path="/survey/notfound" responseMode="ExecuteURL" />
<error statusCode="500" path="/survey/error" responseMode="ExecuteURL" />
</httpErrors>
<modules runAllManagedModulesForAllRequests="true"/>
</system.webServer>
</configuration>
```

## Caveat

There is a caveat to this: Your server will no longer report 404 errors as all not-found paths now serve up your `index.html` file. To get around the issue, you should implement a catch-all route within your Vue app to show a 404 page:
Expand Down
17 changes: 8 additions & 9 deletions docs/fr/essentials/named-routes.md
Original file line number Diff line number Diff line change
@@ -1,32 +1,31 @@
# Named Routes (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).*
# Routes nommées

Sometimes it is more convenient to identify a route with a name, especially when linking to a route or performing navigations. You can give a route a name in the `routes` options while creating the Router instance:
Parfois il est plus pratique d'identifer une route avec un nom, tout particulièrement quand on souhaite attacher cette route ou exécuter des actions de navigation. Vous pouvez donner un nom à une route dans les options `routes` pendant la création de l'instance du routeur :

``` js
const router = new VueRouter({
routes: [
{
path: '/user/:userId',
path: '/utilisateur/:userId',
name: 'user',
component: User
}
]
})
```

To link to a named route, you can pass an object to the `router-link`
component's `to` prop:
Pour attacher une route nommée, vous pouvez passer un objet à la prop `to` du composant `router-link` :

``` html
<router-link :to="{ name: 'user', params: { userId: 123 }}">User</router-link>
<router-link :to="{ name: 'user', params: { userId: 123 }}">Utilisateur</router-link>
```

This is the exact same object used programatically with `router.push()`:
C'est exactement le même objet à utiliser programmatiquement avec `router.push()` :

``` js
router.push({ name: 'user', params: { userId: 123 }})
```

In both cases, the router will navigate to the path `/user/123`.
Dans les deux cas, le routeur va naviguer vers le chemin `/utilisateur/123`.

Full example [here](https://github.com/vuejs/vue-router/blob/dev/examples/named-routes/app.js).
Un exemple complet se trouve [ici](https://github.com/vuejs/vue-router/blob/dev/examples/named-routes/app.js).
10 changes: 4 additions & 6 deletions docs/fr/essentials/named-views.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,14 @@
# Named Views (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).*
# Vues nommées

Sometimes you need to display multiple views at the same time instead of nesting them, e.g. creating a layout with a `sidebar` view and a `main` view. This is where named views came in handy. Instead of having one single outlet in your view, you can have multiple and give each of them a name. A `router-view` without a name will be given `default` as its name.
Parfois vous avez besoin d'afficher différentes vues en même temps plutôt que de les imbriquer, c.-à-d. créer un affichage avec une vue `sidebar` et une vue `main` par exemple. C'est ici que les routes nommées entre en jeu. Au lieu d'avoir une seule balise de vue, vous pouvez en avoir une multitude et donner à chacune d'entre elle un nom. Un `router-view` sans nom aura comme nom par défaut : `default`.

``` html
<router-view class="view one"></router-view>
<router-view class="view two" name="a"></router-view>
<router-view class="view three" name="b"></router-view>
```

A view is rendered by using a component, therefore multiple views require multiple components for the same route. Make sure to use the `components` (with
an s) option:
Une vue est rendue en utilisant un composant, donc de multiples vues nécessites de multiples composants pour une même route. Assurez-vous d'utiliser l'option `components` (avec un s) :

``` js
const router = new VueRouter({
Expand All @@ -26,5 +25,4 @@ const router = new VueRouter({
})
```

A working demo of this example can be found
[here](https://jsfiddle.net/posva/6du90epg/).
Une démo de cet exemple peut-être trouvée ici : [ici](https://jsfiddle.net/posva/6du90epg/).
48 changes: 24 additions & 24 deletions docs/fr/essentials/navigation.md
Original file line number Diff line number Diff line change
@@ -1,71 +1,71 @@
# Programmatic Navigation (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).*
# Navigation programmatique

Aside from using `<router-link>` to create anchor tags for declarative navigation, we can do this programmatically using the router's instance methods.
En complément du l'utilisation de `<router-link>` pour créer des balises ancres pour la navigation déclarative, nous pouvons le faire de manière programmatique en utilisant les méthodes de l'instance du routeur.

#### `router.push(location, onComplete?, onAbort?)`

**Note: Inside of a Vue instance, you have access to the router instance as `$router`. You can therefore call `this.$router.push`.**
** Note : Dans une instance Vue, vous pouvez accéder à l'instance du routeur via `$router`. Vous pouvez donc appeler `this.$router.push`.**

To navigate to a different URL, use `router.push`. This method pushes a new entry into the history stack, so when the user clicks the browser back button they will be taken to the previous URL.
Pour naviguer vers une URL différente, utilisez `router.push`. Cette méthode ajoute une nouvelle entrée dans la pile de l'historique. Ainsi quand un utilisateur clique sur le bouton retour de son navigateur, il retournera à l'URL précédente.

This is the method called internally when you click a `<router-link>`, so clicking `<router-link :to="...">` is the equivalent of calling `router.push(...)`.
Cette méthode est appelée en interne quand vous cliquez sur `<router-link>`, donc cliquer sur `<router-link :to="...">` est équivalent à appeler `router.push(...)`.

| Declarative | Programmatic |
| Declarative | Programmatique |
|-------------|--------------|
| `<router-link :to="...">` | `router.push(...)` |

The argument can be a string path, or a location descriptor object. Examples:
L'argument peut être une chaîne de caractère représentant un chemin, ou un objet de description de destination. Des exemples :

``` js
// literal string path
// chaîne de caractère représentant un chemin
router.push('home')

// object
// objet
router.push({ path: 'home' })

// named route
// route nommée
router.push({ name: 'user', params: { userId: 123 }})

// with query, resulting in /register?plan=private
// avec une requête « query » résultant de `/register?plan=private`
router.push({ path: 'register', query: { plan: 'private' }})
```

In 2.2.0+, optionally provide `onComplete` and `onAbort` callbacks to `router.push` or `router.replace` as the 2nd and 3rd arguments. These callbacks will be called when the navigation either successfully completed (after all async hooks are resolved), or aborted (navigated to the same route, or to a different route before current navigation has finished), respectively.
Dans la version 2.2.0+, vous pouvez optionnellement fournir les fonctions de rappel `onComplete` et `onAbort` à `router.push` ou `router.replace` en tant que deuxième et troisième arguments. Ces fonctions de rappel seront appelées quand la navigation sera respectivement ; complétée avec succès (après la résolution de tous les hooks asynchrones), ou arrêtée (navigation vers la même route ou vers une route différente avant que la navigation courante ne soit achevée).

#### `router.replace(location, onComplete?, onAbort?)`

It acts like `router.push`, the only difference is that it navigates without pushing a new history entry, as its name suggests - it replaces the current entry.
Il agit comme `router.push`. La seule différence est que la navigation se fait sans ajouter de nouvelle entrée dans la pile de l'historique. Comme son nom l'indique, il remplace l'entrée courante.

| Declarative | Programmatic |
| Declarative | Programmatique |
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Déclarative?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Merci.

On a eu qu'un reviewer après traduction sur ses fichiers pour le moment. Hésite pas !

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

C'est déjà très bien 😆
Les trad sont de bonne qualité, du coup je lis en diagonale, s'il y a des erreurs, les gens pourront faire des PR 🙂

|-------------|--------------|
| `<router-link :to="..." replace>` | `router.replace(...)` |


#### `router.go(n)`

This method takes a single integer as parameter that indicates by how many steps to go forwards or go backwards in the history stack, similar to `window.history.go(n)`.
Cette méthode prend un seul nombre en tant que paramètre. Celui-ci indique de combien d'entrée vers l'avant ou vers l'arrière il faut naviguer dans la pile de l'historique, de la même manière qu'avec `window.history.go(n)`.

Examples
Des exemples

``` js
// go forward by one record, the same as history.forward()
// avancer d'une entrée, identique à `history.forward()`
router.go(1)

// go back by one record, the same as history.back()
// retourner d'une entrée en arrière, identique à `history.back()`
router.go(-1)

// go forward by 3 records
// avancer de trois entrées
router.go(3)

// fails silently if there aren't that many records.
// échoue silencieusement s'il n'y a pas assez d'entrées.
router.go(-100)
router.go(100)
```

#### History Manipulation
#### Manipulation de l'historique

You may have noticed that `router.push`, `router.replace` and `router.go` are counterparts of [`window.history.pushState`, `window.history.replaceState` and `window.history.go`](https://developer.mozilla.org/en-US/docs/Web/API/History), and they do imitate the `window.history` APIs.
Vous avez peut être remarqué que `router.push`, `router.replace` et `router.go` sont des équivalent de [`window.history.pushState`, `window.history.replaceState` et `window.history.go`](https://developer.mozilla.org/fr-FR/docs/Web/API/History), et qu'ils imitent les APIs de `window.history`.

Therefore, if you are already familiar with [Browser History APIs](https://developer.mozilla.org/en-US/docs/Web/API/History_API), manipulating history will be super easy with vue-router.
Donc, si vous utilisez déjà l'[API History des navigateurs](https://developer.mozilla.org/fr-FR/docs/Web/API/History_API), manipuler l'historique sera très simple avec vue-router.

It is worth mentioning that vue-router navigation methods (`push`, `replace`, `go`) work consistently in all router modes (`history`, `hash` and `abstract`).
Il n'est pas nécessaire de préciser que les méthodes de navigation (`push`, `replace`, `go`) fonctionnent de la même manière dans tous les modes de routage (`history`, `hash` and `abstract`).
Loading