Skip to content

Toutes les traductions de la documentation pour la v2.6 #185

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 27 commits into from
Mar 16, 2019
Merged
Show file tree
Hide file tree
Changes from 26 commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
7fab745
Translate all new documentation
MachinisteWeb Mar 11, 2019
8c1907b
vue to Vue
MachinisteWeb Mar 11, 2019
70cfd4e
Translate themes.md
MachinisteWeb Mar 11, 2019
e852e52
Update src/v2/api/index.md
darenju Mar 12, 2019
c8e8310
Update src/v2/api/index.md
darenju Mar 12, 2019
98854eb
Update src/v2/api/index.md
darenju Mar 12, 2019
6e1b3ab
Update src/v2/api/index.md
darenju Mar 12, 2019
a8ea6ec
Update src/v2/api/index.md
darenju Mar 12, 2019
1a3c3f6
Update src/v2/api/index.md
darenju Mar 12, 2019
76ffc40
Update src/v2/guide/syntax.md
darenju Mar 12, 2019
15dcad9
best traduction
MachinisteWeb Mar 12, 2019
79ec030
Merge branch 'todo-march' of https://github.com/vuejs-fr/vuejs.org in…
MachinisteWeb Mar 12, 2019
e5542d3
Update src/v2/guide/syntax.md
darenju Mar 12, 2019
bb79adf
Update src/v2/guide/syntax.md
darenju Mar 12, 2019
ed5a1c6
Update src/v2/guide/syntax.md
darenju Mar 12, 2019
5e7edab
Update src/v2/guide/syntax.md
darenju Mar 12, 2019
e5b99d7
Update src/v2/api/index.md
darenju Mar 12, 2019
9e64603
Update src/v2/examples/themes.md
darenju Mar 12, 2019
cffc831
Update src/v2/guide/components-slots.md
darenju Mar 12, 2019
8ee16df
Apply suggestions from code review
MachinisteWeb Mar 12, 2019
125050d
typo
MachinisteWeb Mar 12, 2019
0fb9903
Update src/v2/guide/components-slots.md
darenju Mar 12, 2019
2ca9d9a
Apply suggestions from code review
darenju Mar 12, 2019
c4960db
fix typo
MachinisteWeb Mar 12, 2019
d399f2e
Merge branch 'todo-march' of https://github.com/vuejs-fr/vuejs.org in…
MachinisteWeb Mar 12, 2019
02a6e2a
fix typo
MachinisteWeb Mar 12, 2019
0ae90c5
typo fix
MachinisteWeb Mar 16, 2019
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
104 changes: 52 additions & 52 deletions src/v2/api/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ type: api

> En 2.4.0+ ce hook capture également les erreurs lancées depuis un gestionnaire d'évènement Vue personnalisé.

> $todo In 2.6.0+, this hook also captures errors thrown inside `v-on` DOM listeners. In addition, if any of the covered hooks or handlers returns a Promise chain (e.g. async functions), the error from that Promise chain will also be handled.
> En 2.6.0+, ce hook capture également les erreurs lancées depuis les écouteurs de DOM `v-on`. De plus, si les hooks couverts ou gestionnaires retournent une chaine de Promesse (par exemple les fonctions async), l'erreur sera également remontée depuis cette Promesse.

> [Sentry](https://sentry.io) et [Bugsnag](https://docs.bugsnag.com/platforms/browsers/vue/) fournissent une intégration officielle utilisant cette option.

Expand Down Expand Up @@ -404,18 +404,18 @@ type: api

- **Voir aussi :** [Fonctions de rendu](../guide/render-function.html)

### $todo Vue.observable( object )
### Vue.observable( object )

> New in 2.6.0+
> Nouveau en 2.6.0+

- **Arguments:**
- **Arguments :**
- `{Object} object`

- **Usage:**
- **Utilisation :**

Make an object reactive. Internally, Vue uses this on the object returned by the `data` function.
Rend un objet réactif. En interne, Vue l'utilise sur l'objet retourné par la fonction `data`.

The returned object can be used directly inside [render functions](../guide/render-function.html) and [computed properties](../guide/computed.html), and will trigger appropriate updates when mutated. It can also be used as a minimal, cross-component state store for simple scenarios:
L'objet retourné peut être directement utilisé à l'intérieur des [fonctions de rendu](../guide/render-function.html) ainsi que des [propriétés calculées](../guide/computed.html). Il déclenchera les mises à jour appropriées lors de mutations. Il peut également être utilisé comme un store minimal inter-composant dans des scénarios basiques :

``` js
const state = Vue.observable({ count: 0 })
Expand All @@ -424,14 +424,14 @@ type: api
render(h) {
return h('button', {
on: { click: () => { state.count++ }}
}, `count is: ${state.count}`)
}, `le compteur est : ${state.count}`)
}
}
```

<p class="tip">In Vue 2.x, `Vue.observable` directly mutates the object passed to it, so that it is equivalent to the object returned, as [demonstrated here](../guide/instance.html#Data-and-Methods). In Vue 3.x, a reactive proxy will be returned instead, leaving the original object non-reactive if mutated directly. Therefore, for future compatibility, we recommend always working with the object returned by `Vue.observable`, rather than the object originally passed to it.</p>
<p class="tip">Dans Vue 2.x, `Vue.observable` mute directement l'objet qui lui est transmis, de sorte qu'il soit équivalent à l'objet renvoyé, comme [démontré ici](../guide/instance.html#Donnees-et-methodes). Dans Vue 3.x, un proxy réactif sera retourné à la place, laissant l'objet original non réactif s'il est muté directement. Cependant, pour de future compatibilité, nous recommandons toujours de travailler avec l'objet retourné par `Vue.observable`, au lieu de l'objet originel.</p>

- **See also:** [Reactivity in Depth](../guide/reactivity.html)
- **Voir aussi :** [Réactivité dans le détail](../guide/reactivity.html)

### Vue.version

Expand Down Expand Up @@ -509,14 +509,14 @@ type: api

Une liste ou un objet décrivant les attributs exposés par le composant afin de passer des données depuis le composant parent. Ce paramètre a une syntaxe simple basée sur un tableau (`Array`) et une syntaxe alternative basée sur un objet (`Object`) qui permet une configuration avancée telle qu'une vérification de typage, des contrôles de validation personnalisés et des valeurs par défaut.

$todo With Object-based syntax, you can use following options:
- **type:** can be one of the following native constructors: `String`, `Number`, `Boolean`, `Array`, `Object`, `Date`, `Function`, `Symbol`, any custom constructor function or an array of those. Will check if a prop has a given type, and will throw a warning if it doesn't. [More information](../guide/components-props.html#Prop-Types) on prop types.
Avec la syntaxe objet, vous pouvez passer les options suivantes :
- Le **type** peut être l'un des constructeurs natifs suivants : `String`, `Number`, `Boolean`, `Array`, `Object`, `Date`, `Function`, `Symbol` ainsi que n'importe quelle fonction de construction ou tableau de ces types. Les types des props seront vérifiés. Un avertissement sera fourni si une prop n'est pas du bon type. [Plus d'information](../guide/components-props.html#Types-des-props) sur les types des props.
- **default:** `any`
Specifies a default value for the prop. If the prop is not passed, this value will be used instead. Object or array defaults must be returned from a factory function.
Spécifie la valeur par défaut de la prop. Si la prop n'est pas passée, cette valeur sera utilisée à la place. Les objets ou tableaux par défaut doivent être retournés depuis une fonction de fabrique.
- **required:** `Boolean`
Defines if the prop is required. In a non-production environment, a console warning will be thrown if this value is truthy and the prop is not passed.
Définie si la prop est requise. Dans un environnement autre que de production, un avertissement sera affiché dans la console si cette valeur est évaluée à vrai et que la prop n'est pas passée.
- **validator:** `Function`
Custom validator function that takes the prop value as the sole argument. In a non-production environment, a console warning will be thrown if this function returns a falsy value (i.e. the validation fails). You can read more about prop validation [here](../guide/components-props.html#Prop-Validation).
Une fonction de validation personnalisée qui prend la valeur de prop comme seul argument. Dans un environnement autre que de production, un avertissement sera affiché dans la console si cette fonction retourne une valeur évaluée à faux. (c.-à-d. que la validation a échoué). Vous pouvez en lire plus à propos de la validation des props [ici](../guide/components-props.html#Validation-des-props).

- **Exemple :**

Expand Down Expand Up @@ -1441,11 +1441,11 @@ type: api

Accéder à `vm.$scopedSlots` est surtout utile lors de l'écriture d'un composant avec une [fonction de rendu](../guide/render-function.html).

**$todo Note:** since 2.6.0+, there are two notable changes to this property:
**Note :** depuis la 2.6.0+, il y a deux changements notables pour cette propriété :

1. Scoped slot functions are now guaranteed to return an array of VNodes, unless the return value is invalid, in which case the function will return `undefined`.
1. Les fonctions de slot avec portée garantissent de retourner un tableau de VNodes, sauf si la valeur de retour est invalide, auquel cas la fonction retournera `undefined`.

2. All `$slots` are now also exposed on `$scopedSlots` as functions. If you work with render functions, it is now recommended to always access slots via `$scopedSlots`, whether they currently use a scope or not. This will not only make future refactors to add a scope simpler, but also ease your eventual migration to Vue 3, where all slots will be functions.
2. Tous les `$slots` sont maintenant exposés via `$scopedSlots` en tant que fonctions. Si vous travaillez avec des fonctions de rendu, il est maintenant recommandé de toujours accéder aux slots via `$scopedSlots`, si elles utilisent actuellement une portée ou non. Cela ne va pas seulement permettre d'ajouter des scopes simplement lors de futures refactorisations, mais également de faciliter votre éventuelle migration vers Vue 3, où tous les slots seront des fonctions.

- **Voir aussi :**
- [Composant `<slot>`](#slot-1)
Expand Down Expand Up @@ -2022,7 +2022,7 @@ type: api
</div>
```

$todo In 2.6+, `v-for` can also work on values that implement the [Iterable Protocol](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#The_iterable_protocol), including native `Map` and `Set`. However, it should be noted that Vue 2.x currently does not support reactivity on `Map` and `Set` values, so cannot automatically detect changes.
En 2.6+, `v-for` peut également travailler sur des valeurs qui implémentent le [protocole Iterable](https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Les_protocoles_iteration#The_iterable_protocol), incluant les natifs `Map` et `Set`. Cependant, il est a noter que Vue 2.x ne supporte pour le moment pas la réactivité sur les valeurs de `Map` et `Set` et ne pourra pas automatiquement détecter les changements.

<p class="tip">Quand utilisé conjointement avec v-if, v-for a une plus grande priorité que v-if. Consultez le <a href="../guide/list.html#v-for-with-v-if">guide de rendu de listes</a> pour plus de détails.</p>

Expand Down Expand Up @@ -2069,7 +2069,7 @@ type: api
<!-- nom de méthode -->
<button v-on:click="faireCeci"></button>

<!-- $todo dynamic event (2.6.0+) -->
<!-- évènement dynamique (2.6.0+) -->
<button v-on:[event]="doThis"></button>

<!-- ligne d'instruction -->
Expand All @@ -2078,7 +2078,7 @@ type: api
<!-- notation abrégée -->
<button @click="faireCeci"></button>

<!-- $todo shorthand dynamic event (2.6.0+) -->
<!-- notation abrégée d'un évènement dynamique (2.6.0+) -->
<button @[event]="doThis"></button>

<!-- stoppe la propagation -->
Expand Down Expand Up @@ -2151,13 +2151,13 @@ type: api
<!-- lie un attribut -->
<img v-bind:src="imageSrc">

<!-- $todo dynamic attribute name (2.6.0+) -->
<!-- nom d'attribut dynamique (2.6.0+) -->
<button v-bind:[key]="value"></button>

<!-- notation abrégée -->
<img :src="imageSrc">

<!-- $todo shorthand dynamic attribute name (2.6.0+) -->
<!-- notation abrégée d'un nom d'attribut dynamique (2.6.0+) -->
<button :[key]="value"></button>

<!-- avec de la concaténation de chaines de caractères -->
Expand Down Expand Up @@ -2224,39 +2224,39 @@ type: api
- [Liaisons sur les champs de formulaire](../guide/forms.html)
- [Composants - Composants de champ de formulaire utilisant les évènements personnalisés](../guide/components.html#Composants-de-champ-de-formulaire-utilisant-les-evenements-personnalises)

### $todo v-slot
### v-slot

- **Shorthand:** `#`
- **Notation abrégée :** `#`

- **Expects:** JavaScript expression that is valid in a function argument position (supports destructuring in [supported environments](../guide/components-slots.html#Slot-Props-Destructuring)). Optional - only needed if expecting props to be passed to the slot.
- **Attend comme valeur :** Une expression JavaScript qui est valide a une position d'argument dans une fonction (supporte la décomposition dans les [environments la supportant](../guide/components-slots.html#Décomposition-de-props-de-slot)). Optionnel - seulement nécessaire si le passage des props est attendu par le slot.

- **Argument:** slot name (optional, defaults to `default`)
- **Argument :** nom du slot (optionel, `default` par défaut)

- **Limited to:**
- **Limité à :**
- `<template>`
- [components](../guide/components-slots.html#Abbreviated-Syntax-for-Lone-Default-Slots) (for a lone default slot with props)
- [composants](../guide/components-slots.html#Syntaxe-abrégée-pour-les-slots-par-défault-uniques) (pour les slot par défaut avec props)

- **Usage:**
- **Utilisation :**

Denote named slots or slots that expect to receive props.
Indiquez les slots nommés ou slots qui attendent de recevoir des props.

- **Example:**
- **Exemple :**

```html
<!-- Named slots -->
<!-- Slots nommés -->
<base-layout>
<template v-slot:header>
Header content
Contenu d'en-tête
</template>

Default slot content
Contenu par défaut de slot

<template v-slot:footer>
Footer content
Contenu de pied de page
</template>
</base-layout>

<!-- Named slot that receives props -->
<!-- Slot nommé recevant des props -->
<infinite-scroll>
<template v-slot:item="slotProps">
<div class="item">
Expand All @@ -2265,16 +2265,16 @@ type: api
</template>
</infinite-scroll>

<!-- Default slot that receive props, with destructuring -->
<!-- Slot par défaut recevant des props, avec décomposition -->
<mouse-position v-slot="{ x, y }">
Mouse position: {{ x }}, {{ y }}
</mouse-position>
```

For more details, see the links below.
Pour plus de détails, voir les liens ci-dessous.

- **See also:**
- [Components - Slots](../guide/components-slots.html)
- **Voir aussi :**
- [Composants - Slots](../guide/components-slots.html)
- [RFC-0001](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0001-new-slot-syntax.md)

### v-pre
Expand Down Expand Up @@ -2421,15 +2421,15 @@ type: api
- [Composants dynamiques](../guide/components.html#Composants-dynamiques)
- [Limitations de l’analyse d’un template à partir du DOM](../guide/components.html#Limitations-de-l’analyse-d’un-template-a-partir-du-DOM)

### $todo slot <sup style="color:#c92222">deprecated</sup>
### slot <sup style="color:#c92222">déprécié</sup>

**Prefer [v-slot](#v-slot) in 2.6.0+.**
**Préférez [v-slot](#v-slot) en 2.6.0+.**

- **Expects:** `string`
- **Attend comme valeur :** `string`

Used on content inserted into child components to indicate which named slot the content belongs to.
Utilisez sur un contenu inséré dans un composant enfant pour indiquer à quel slot nommé le contenu appartient.

- **See also:** [Named Slots with `slot`](../guide/components.html#Named-Slots-with-slot)
- **Voir aussi :** [Slots nommés avec `slot`](../guide/components.html#Slots-nommés-avec-slot)

### slot-scope <sup style="color:#c92222">déprécié</sup>

Expand All @@ -2445,15 +2445,15 @@ type: api

- **Voir aussi :** [Slots avec portée with `slot-scope`](../guide/components.html#Slots-avec-portee)

### $todo scope <sup style="color:#c92222">removed</sup>
### scope <sup style="color:#c92222">supprimé</sup>

**Replaced by [slot-scope](#slot-scope) in 2.5.0+. Prefer [v-slot](#v-slot) in 2.6.0+.**
**Remplacé par [slot-scope](#slot-scope) dans la 2.5.0+. Préférez [v-slot](#v-slot) dans la 2.6.0+.**

Used to denote a `<template>` element as a scoped slot.
Utilisé pour indiquer un élément `<template>` en tant que slot avec portée.

- **Usage:**
- **utilisation :**

Same as [`slot-scope`](#slot-scope) except that `scope` can only be used on `<template>` elements.
Identique à [`slot-scope`](#slot-scope) à l'exception que `scope` peut uniquement être utilisé sur des éléments `<template>` elements.

## Composants intégrés par défaut

Expand Down Expand Up @@ -2674,4 +2674,4 @@ Used to denote a `<template>` element as a scoped slot.

## Rendu côté serveur

- Veuillez vous référer à la [documentation du package vue-server-renderer](https://github.com/vuejs/vue/tree/dev/packages/vue-server-renderer).
- Veuillez vous référer à la [documentation du package vue-server-renderer](https://github.com/vuejs/vue/tree/dev/packages/vue-server-renderer).
8 changes: 3 additions & 5 deletions src/v2/examples/themes.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,10 @@
---
title: Themes
title: Thèmes
type: examples
is_new: true
order: 13
---
<p>Cette page est en cours de traduction. Pour nous aider, vous pouvez participer sur <a href="https://github.com/vuejs-fr/vuejs.org" target="_blank">le dépôt GitHub dédié de Vuejs-FR</a>.</p><p>

> With the examples below built by our partners from [Creative Tim](https://creative-tim.com?affiliate_id=116187) you can see how a real world application is built, the technology stack behind it and how most of the concepts you've learned so far apply in a real world application.
> Avec les exemples ci-dessous construits par nos partenaires de chez [Creative Tim](https://creative-tim.com?affiliate_id=116187) vous pouvez voir comment une réelle application est construite, la technologie utilisée derrière et quels sont les concepts principaux à apprendre pour réaliser une vraie application.

{% raw %}
<div id="themes-example" class="themes-grid">
Expand All @@ -22,7 +20,7 @@ order: 13
<div class="see-more-container">
<a :href="`https://www.creative-tim.com/bootstrap-themes/vuejs-themes?affiliate_id=${affiliateId}`"
class="button white see-more-link">
See More Themes
Voir plus de thèmes
</a>
</div>
</div>
Expand Down
4 changes: 2 additions & 2 deletions src/v2/guide/components-edge-cases.md
Original file line number Diff line number Diff line change
Expand Up @@ -331,7 +331,7 @@ Quand l'attribut spécial `inline-template` est présent sur un composant enfant
</my-component>
```

$todo Your inline template needs to be defined inside the DOM element to which Vue is attached.
Votre template inline a besoin d'être défini à l'intérieur de l'élément du DOM pour être attaché à Vue.

<p class="tip">Cependant, <code>inline-template</code> rend la portée de vos templates plus difficile à appréhender. Une bonne pratique est de préférer la définition de templates à l'intérieur du composant en utilisant l'option <code>template</code> ou dans un élément <code>&lt;template&gt;</code> dans un fichier <code>.vue</code>.</p>

Expand All @@ -351,7 +351,7 @@ Vue.component('hello-world', {
})
```

$todo Your x-template needs to be defined outside the DOM element to which Vue is attached.
Votre x-template a besoin d'être défini à l'extérieur de l'élément du DOM pour être attaché à Vue.

<p class="tip">Ce type de templates peut être utile pour des démos avec de gros templates ou dans des applications extrêmements petites, mais sinon il doit être évité, car ils séparent les templates du reste de la définition du composant.</p>

Expand Down
Loading