Skip to content

Commit 5520807

Browse files
Toutes les traductions de la documentation pour la v2.6 (#185)
* Translate all new documentation Signed-off-by: Haeresis <[email protected]> * vue to Vue Signed-off-by: Haeresis <[email protected]> * Translate themes.md Signed-off-by: Haeresis <[email protected]> * Update src/v2/api/index.md Co-Authored-By: Haeresis <[email protected]> * Update src/v2/api/index.md Co-Authored-By: Haeresis <[email protected]> * Update src/v2/api/index.md Co-Authored-By: Haeresis <[email protected]> * Update src/v2/api/index.md Co-Authored-By: Haeresis <[email protected]> * Update src/v2/api/index.md Co-Authored-By: Haeresis <[email protected]> * Update src/v2/api/index.md Co-Authored-By: Haeresis <[email protected]> * Update src/v2/guide/syntax.md Co-Authored-By: Haeresis <[email protected]> * best traduction Signed-off-by: Haeresis <[email protected]> * Update src/v2/guide/syntax.md Co-Authored-By: Haeresis <[email protected]> * Update src/v2/guide/syntax.md Co-Authored-By: Haeresis <[email protected]> * Update src/v2/guide/syntax.md Co-Authored-By: Haeresis <[email protected]> * Update src/v2/guide/syntax.md Co-Authored-By: Haeresis <[email protected]> * Update src/v2/api/index.md Co-Authored-By: Haeresis <[email protected]> * Update src/v2/examples/themes.md Co-Authored-By: Haeresis <[email protected]> * Update src/v2/guide/components-slots.md Co-Authored-By: Haeresis <[email protected]> * Apply suggestions from code review typos Co-Authored-By: Haeresis <[email protected]> * typo Signed-off-by: Haeresis <[email protected]> * Update src/v2/guide/components-slots.md Co-Authored-By: Haeresis <[email protected]> * Apply suggestions from code review typo fix Co-Authored-By: Haeresis <[email protected]> * fix typo Signed-off-by: Haeresis <[email protected]> * fix typo Signed-off-by: Haeresis <[email protected]> * typo fix Signed-off-by: Haeresis <[email protected]>
1 parent ca63190 commit 5520807

11 files changed

+141
-144
lines changed

src/v2/api/index.md

+55-55
Large diffs are not rendered by default.

src/v2/examples/themes.md

+3-5
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,10 @@
11
---
2-
title: Themes
2+
title: Thèmes
33
type: examples
44
is_new: true
55
order: 13
66
---
7-
<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>
8-
9-
> 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.
7+
> 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.
108
119
{% raw %}
1210
<div id="themes-example" class="themes-grid">
@@ -22,7 +20,7 @@ order: 13
2220
<div class="see-more-container">
2321
<a :href="`https://www.creative-tim.com/bootstrap-themes/vuejs-themes?affiliate_id=${affiliateId}`"
2422
class="button white see-more-link">
25-
See More Themes
23+
Voir plus de thèmes
2624
</a>
2725
</div>
2826
</div>

src/v2/guide/components-edge-cases.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -331,7 +331,7 @@ Quand l'attribut spécial `inline-template` est présent sur un composant enfant
331331
</my-component>
332332
```
333333

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

336336
<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>
337337

@@ -351,7 +351,7 @@ Vue.component('hello-world', {
351351
})
352352
```
353353

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

356356
<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>
357357

src/v2/guide/components-slots.md

+51-52
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@ order: 104
66

77
> Cette page suppose que vous avez déjà lu les principes de base des [composants](components.html). Lisez-les en premier si les composants sont quelque chose de nouveau pour vous.
88
9-
> $todo In 2.6.0, we introduced a new unified syntax (the `v-slot` directive) for named and scoped slots. It replaces the `slot` and `slot-scope` attributes, which are now deprecated, but have _not_ been removed and are still documented [here](#Deprecated-Syntax). The rationale for introducing the new syntax is described in this [RFC](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0001-new-slot-syntax.md).
9+
> En 2.6.0, nous introduisons une nouvelle syntaxe unifiée (la directive `v-slot`) pour nommer vos slots avec portée. Il remplace les attributs `slot` et `slot-scope` qui sont à présent dépréciés mais _non_ retirés et toujours documentés [ici](#Syntaxe-dépréciée). La raison à l'introduction de la nouvelle syntaxe est décrite dans cette [RFC](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0001-new-slot-syntax.md).
1010
11-
## Les contenu de slot
11+
## Les contenus de slot
1212

1313
Vue implémente une API de distribution de contenu inspirée du [brouillon de spécification des WebComponents](https://github.com/w3c/webcomponents/blob/gh-pages/proposals/Slots-Proposal.md) utilisant l'élément `<slot>` comme zone de distribution de contenu.
1414

@@ -53,84 +53,83 @@ Ou encore faire appel à d'autres composants :
5353

5454
Si `<navigation-link>` ne contient **pas** d'élément `<slot>`, n'importe quel contenu fourni entre la balise d'ouverture et de fermeture sera ignoré.
5555

56-
## $todo Compilation Scope
56+
## Portée de compilation
5757

58-
When you want to use data inside a slot, such as in:
58+
Quand vous voulez utiliser des données à l'intérieur d'un slot, comme ici :
5959

6060
``` html
6161
<navigation-link url="/profile">
62-
Logged in as {{ user.name }}
62+
Se connnecter en tant que {{ user.name }}
6363
</navigation-link>
6464
```
6565

66-
That slot has access to the same instance properties (i.e. the same "scope") as the rest of the template. The slot does **not** have access to `<navigation-link>`'s scope. For example, trying to access `url` would not work:
66+
Le slot a accès à la même propriété d'instance (c.-à-d. la même « portée ») que le reste du template. Le slot n'a **pas** accès à la portée de `<navigation-link>`. Par exemple, essayer d'accéder à `url` ne fonctionnera pas :
6767

6868
``` html
6969
<navigation-link url="/profile">
70-
Clicking here will send you to: {{ url }}
70+
Cliquer ici vous amènera à : {{ url }}
7171
<!--
72-
The `url` will be undefined, because this content is passed
73-
_to_ <navigation-link>, rather than defined _inside_ the
74-
<navigation-link> component.
72+
Ici `url` sera `undefined` car le contenu est passé
73+
_à l'intérieur de_ <navigation-link>, au lieu d'être défini _entre_ le composant <navigation-link>.
7574
-->
7675
</navigation-link>
7776
```
7877

79-
As a rule, remember that:
78+
Souvenez-vous de cette règle :
8079

81-
> Everything in the parent template is compiled in parent scope; everything in the child template is compiled in the child scope.
80+
> Tout ce qui est dans le template parent est compilé dans la portée parente, tout ce qui est dans le template enfant est compilé dans la portée enfant.
8281
83-
## Fallback Content
82+
## Contenu par défaut
8483

85-
There are cases when it's useful to specify fallback (i.e. default) content for a slot, to be rendered only when no content is provided. For example, in a `<submit-button>` component:
84+
Il y a des cas où il est utile de spécifier un contenu par défaut pour un slot qui sera rendu uniquement si aucun contenu n'est fourni. Par exemple, dans le composant `<submit-button>` :
8685

8786
```html
8887
<button type="submit">
8988
<slot></slot>
9089
</button>
9190
```
9291

93-
We might want the text "Submit" to be rendered inside the `<button>` most of the time. To make "Submit" the fallback content, we can place it in between the `<slot>` tags:
92+
Nous pourrions vouloir que le texte « Envoyer » soit rendu à l'intérieur de `<button>` la plupart du temps. Pour faire de « Envoyer » le contenu par défaut, nous pouvons le placer à l'intérieur des balises `<slot>` :
9493

9594
```html
9695
<button type="submit">
97-
<slot>Submit</slot>
96+
<slot>Envoyer</slot>
9897
</button>
9998
```
10099

101-
Now when we use `<submit-button>` in a parent component, providing no content for the slot:
100+
Maintenant quand nous utilisons `<submit-button>` dans le composant parent, nous ne fournissons aucun contenu pour le slot :
102101

103102
```html
104103
<submit-button></submit-button>
105104
```
106105

107-
will render the fallback content, "Submit":
106+
ce qui fera le rendu du contenu par défaut « Envoyer » :
108107

109108
```html
110109
<button type="submit">
111-
Submit
110+
Envoyer
112111
</button>
113112
```
114113

115-
But if we provide content:
114+
Cependant, si nous fournissons le contenu :
116115

117116
```html
118117
<submit-button>
119-
Save
118+
Sauver
120119
</submit-button>
121120
```
122121

123-
Then the provided content will be rendered instead:
122+
Le contenu fourni sera rendu à la place :
124123

125124
```html
126125
<button type="submit">
127-
Save
126+
Sauver
128127
</button>
129128
```
130129

131130
## Les slots nommés
132131

133-
> $todo Updated in 2.6.0+. [See here](#Deprecated-Syntax) for the deprecated syntax using the `slot` attribute.
132+
> Mis à jour dans la 2.6.0+. [Voir ici](#Syntaxe-dépréciée) pour la syntaxe dépréciée en utilisant l'attribut `slot`.
134133
135134
Dans certains cas, il peut être intéressant d'avoir plusieurs éléments `<slot>`. Dans un exemple hypothétique, voici le template d'un composant `<base-layout>` :
136135

@@ -166,7 +165,7 @@ Dans le cas suivant, l'élément `<slot>` à un l'attribut spécial `name` , qui
166165

167166
Un `<slot>` sans `name` obtient implicitement le nom "default".
168167

169-
$todo To provide content to named slots, we can use the `v-slot` directive on a `<template>`, providing the name of the slot as `v-slot`'s argument:
168+
Pour fournir du contenu à des slots nommés, nous pouvons utiliser la directive `v-slot` sur un `<template>`, fournissant le nom du slot en tant qu'argument de `v-slot` :
170169

171170
```html
172171
<base-layout>
@@ -183,9 +182,9 @@ $todo To provide content to named slots, we can use the `v-slot` directive on a
183182
</base-layout>
184183
```
185184

186-
$todo Now everything inside the `<template>` elements will be passed to the corresponding slots. Any content not wrapped in a `<template>` using `v-slot` is assumed to be for the default slot.
185+
Maintenant, tout a l'intérieur des éléments `<template>` sera passé aux slots correspondants. Tout contenu non inclu dans un `<template>` utilisant `v-slot` est considéré comme étant destiné au slot par défaut `default`.
187186

188-
However, you can still wrap default slot content in a `<template>` if you wish to be explicit:
187+
Cependant, vous pouvez toujours entourer le contenu du slot par défaut dans un `<template>` si vous désirez que cela soit plus explicite :
189188

190189
```html
191190
<base-layout>
@@ -204,7 +203,7 @@ However, you can still wrap default slot content in a `<template>` if you wish t
204203
</base-layout>
205204
```
206205

207-
$todo Either way, the rendered HTML will be:
206+
Dans tous les cas, le rendu HTML sera :
208207

209208
``` html
210209
<div class="container">
@@ -221,31 +220,31 @@ $todo Either way, the rendered HTML will be:
221220
</div>
222221
```
223222

224-
$todo Note that **`v-slot` can only be added to a `<template>`** (with [one exception](#Abbreviated-Syntax-for-Lone-Default-Slots)), unlike the deprecated [`slot` attribute](#Deprecated-Syntax).
223+
Notez que **`v-slot` ne peut seulement être ajouté à un `<template>`** (avec [une exception](#Abbreviated-Syntax-for-Lone-Default-Slots)) contrairement aux [attributs de `slot`](#Syntax-dépréciée) dépréciés.
225224

226-
## Scoped Slots
225+
## Slots avec portée
227226

228-
> Updated in 2.6.0+. [See here](#Deprecated-Syntax) for the deprecated syntax using the `slot-scope` attribute.
227+
> Mis à jour dans la 2.6.0+. [Voir ici](#Syntaxe-dépréciée) pour la syntaxe dépréciée en utilisant l'attribut `slot-scope`.
229228
230-
Sometimes, it's useful for slot content to have access to data only available in the child component. For example, imagine a `<current-user>` component with the following template:
229+
Parfois, il est utile pour les contenus de slot d'avoir accès aux données uniquement disponibles dans le composant enfant. Par exemple, imaginez un composant `<current-user>` avec le template suivant :
231230

232231
```html
233232
<span>
234233
<slot>{{ user.lastName }}</slot>
235234
</span>
236235
```
237236

238-
We might want to replace this fallback content to display the user's first name, instead of last, like this:
237+
Nous souhaiterions remplacer le contenu par défaut pour afficher le nom de famille de l'utilisateur à la place de son prénom comme ceci :
239238

240239
``` html
241240
<current-user>
242241
{{ user.firstName }}
243242
</current-user>
244243
```
245244

246-
That won't work, however, because only the `<current-user>` component has access to the `user` and the content we're providing is rendered in the parent.
245+
Ce qui ne fonctionnera pas puisque le composant `<current-user>` n'a pas accès à `user` ni au contenu que nous avons fourni lors du rendu du parent.
247246

248-
To make `user` available to the slot content in the parent, we can bind `user` as an attribute to the `<slot>` element:
247+
Pour rendre `user` disponible dans le contenu du slot dans le parent, nous pouvons lier `user` comme un attribut de l'élément `<slot>` :
249248

250249
``` html
251250
<span>
@@ -255,7 +254,7 @@ To make `user` available to the slot content in the parent, we can bind `user` a
255254
</span>
256255
```
257256

258-
Attributes bound to a `<slot>` element are called **slot props**. Now, in the parent scope, we can use `v-slot` with a value to define a name for the slot props we've been provided:
257+
Les attributs liés à l'élément `<slot>` sont appelés des **props de slot**. Maintenant, dans la portée parente, nous pouvons utiliser `v-slot` avec une valeur pour définir un nom pour les props de slot qui nous ont été fournies :
259258

260259
``` html
261260
<current-user>
@@ -265,39 +264,39 @@ Attributes bound to a `<slot>` element are called **slot props**. Now, in the pa
265264
</current-user>
266265
```
267266

268-
In this example, we've chosen to name the object containing all our slot props `slotProps`, but you can use any name you like.
267+
Dans cet exemple, nous avons choisi de nommer l'objet contenant tous nos props de slot `slotProps` mais vous pouvez choisir n'importe quel nom.
269268

270-
### Abbreviated Syntax for Lone Default Slots
269+
### Syntaxe abrégée pour les slots par défaut uniques
271270

272-
In cases like above, when _only_ the default slot is provided content, the component's tags can be used as the slot's template. This allows us to use `v-slot` directly on the component:
271+
Dans les cas comme au-dessus, quand _uniquement_ le slot par défaut a un contenu fourni, la balise du composant peut utiliser le template de slot. Cela nous permet d'utiliser `v-slot` directement sur le composant :
273272

274273
``` html
275274
<current-user v-slot:default="slotProps">
276275
{{ slotProps.user.firstName }}
277276
</current-user>
278277
```
279278

280-
This can be shortened even further. Just as non-specified content is assumed to be for the default slot, `v-slot` without an argument is assumed to refer to the default slot:
279+
Cela peut même être raccourci encore plus. Comme un contenu non spécifié est considéré comme étant destiné au slot par défaut, `v-slot` sans un argument est considéré comme faisant référence au slot par défaut :
281280

282281
``` html
283282
<current-user v-slot="slotProps">
284283
{{ slotProps.user.firstName }}
285284
</current-user>
286285
```
287286

288-
Note that the abbreviated syntax for default slot **cannot** be mixed with named slots, as it would lead to scope ambiguity:
287+
Notez que la syntaxe abrégée pour le slot par défaut **ne** peut **pas** être mélangée avec les slots nommées, ce qui mènerait à une ambigüité de portée :
289288

290289
``` html
291-
<!-- INVALID, will result in warning -->
290+
<!-- INVALIDE, résultera en un avertissement -->
292291
<current-user v-slot="slotProps">
293292
{{ slotProps.user.firstName }}
294293
<template v-slot:other="otherSlotProps">
295-
slotProps is NOT available here
294+
`slotProps` n'est PAS disponible ici
296295
</template>
297296
</current-user>
298297
```
299298

300-
Whenever there are multiple slots, use the full `<template>` based syntax for _all_ slots:
299+
À chaque fois qu'il y a de multiples slots, utilisez la syntaxe complète pour le `<template>` pour _tous_ les slots :
301300

302301
``` html
303302
<current-user>
@@ -311,43 +310,43 @@ Whenever there are multiple slots, use the full `<template>` based syntax for _a
311310
</current-user>
312311
```
313312

314-
### Destructuring Slot Props
313+
### Décomposition de props de slot
315314

316-
Internally, scoped slots work by wrapping your slot content in a function passed a single argument:
315+
En interne, les slots avec portée fonctionnent en entourant votre contenu de slot dans une fonction avec un seul argument :
317316

318317
```js
319318
function (slotProps) {
320-
// ... slot content ...
319+
// ... contenu du slot ...
321320
}
322321
```
323322

324-
That means the value of `v-slot` can actually accept any valid JavaScript expression that can appear in the argument position of a function definition. So in supported environments ([single-file components](single-file-components.html) or [modern browsers](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment#Browser_compatibility)), you can also use [ES2015 destructuring](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment#Object_destructuring) to pull out specific slot props, like so:
323+
Cela signifie que la valeur de `v-slot` peut accepter n'importe quelle expression JavaScript valide pouvant apparaitre à la position d'un argument lors de la définition d'une fonction. Également, pour les environnements qui le supportent ([composants monofichier](single-file-components.html) ou les [navigateurs modernes](https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Op%C3%A9rateurs)), vous pouvez utiliser la [décomposition ES2015](https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Op%C3%A9rateurs/Affecter_par_d%C3%A9composition#Object_destructuring) pour définir une collection de props de slot comme suit :
325324

326325
``` html
327326
<current-user v-slot="{ user }">
328327
{{ user.firstName }}
329328
</current-user>
330329
```
331330

332-
This can make the template much cleaner, especially when the slot provides many props. It also opens other possibilities, such as renaming props, e.g. `user` to `person`:
331+
Cela rend les templates vraiment propres, en particulier quand un slot fournit divers props. Cela agrandit les possibilités, comme le renommage de props, par ex. `user` à `person`:
333332

334333
``` html
335334
<current-user v-slot="{ user: person }">
336335
{{ person.firstName }}
337336
</current-user>
338337
```
339338

340-
You can even define fallbacks, to be used in case a slot prop is undefined:
339+
Vous pouvez même définir des valeurs par défaut à utiliser dans le cas où les props de slot sont `undefined` :
341340

342341
``` html
343342
<current-user v-slot="{ user = { firstName: 'Guest' } }">
344343
{{ user.firstName }}
345344
</current-user>
346345
```
347346

348-
## Dynamic Slot Names
347+
## Noms de slot dynamiques
349348

350-
> New in 2.6.0+
349+
> Nouveau dans la 2.6.0+
351350
352351
[Dynamic directive arguments](syntax.html#Dynamic-Arguments) also work on `v-slot`, allowing the definition of dynamic slot names:
353352

src/v2/guide/forms.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -10,12 +10,12 @@ Vous pouvez utiliser la directive `v-model` pour créer une liaison de données
1010

1111
<p class="tip">`v-model` ne prend pas en compte la valeur initiale des attributs `value`, `checked` ou `selected` fournis par un champ. Elle traitera toujours les données de l'instance de vue comme la source de vérité. Vous devez déclarer la valeur initiale dans votre JavaScript, dans l'option `data` de votre composant.</p>
1212

13-
$todo `v-model` internally uses different properties and emits different events for different input elements:
14-
- text and textarea elements use `value` property and `input` event;
15-
- checkboxes and radiobuttons use `checked` property and `change` event;
16-
- select fields use `value` as a prop and `change` as an event.
13+
`v-model` utilise en interne différentes propriétés et émetteurs d'évènement pour différents éléments de saisie :
14+
- Les éléments `text` et `textarea` utilisent la propriété `value` et évènement `input`;
15+
- Les éléments `checkboxes` et `radiobuttons` utilisent la propriété `checked` et l'évènement `change`;
16+
- Les éléments `select` utilisent `value` comme une prop et `change` comme un évènement.
1717

18-
<p class="tip" id="vmodel-ime-tip">Pour les langues qui requièrent une [méthode de saisie (IME)](https://fr.wikipedia.org/wiki/M%C3%A9thode_d%27entr%C3%A9e) (chinois, japonais, coréen, etc.), vous remarquerez que `v-model` ne sera pas mise à jour durant l'exécution de la méthode de saisie. $todo If you want to cater for these updates as well, use `input` event instead.</p>
18+
<p class="tip" id="vmodel-ime-tip">Pour les langues qui requièrent une [méthode de saisie (IME)](https://fr.wikipedia.org/wiki/M%C3%A9thode_d%27entr%C3%A9e) (chinois, japonais, coréen, etc.), vous remarquerez que `v-model` ne sera pas mise à jour durant l'exécution de la méthode de saisie. Si vous souhaitez également prendre en compte ces mises à jour, utilisez plutôt l'évènement `input`.</p>
1919

2020
### Texte
2121

0 commit comments

Comments
 (0)