Skip to content

Commit a5fdc82

Browse files
committed
Merge remote-tracking branch 'upstream/master'
# Conflicts: # src/v2/api/index.md # src/v2/guide/class-and-style.md # src/v2/guide/components.md # src/v2/guide/conditional.md # src/v2/guide/events.md # src/v2/guide/render-function.md # src/v2/guide/syntax.md # src/v2/guide/transitions.md # src/v2/guide/typescript.md Signed-off-by: Bruno Lesieur <bruno.lesieur@gmail.com>
2 parents 25e69b6 + 8c328da commit a5fdc82

File tree

10 files changed

+69
-45
lines changed

10 files changed

+69
-45
lines changed

src/v2/api/index.md

Lines changed: 27 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -80,15 +80,15 @@ type: api (En)
8080

8181
Définit un gestionnaire pour les erreurs non interceptées pendant le rendu d'un composant et les appels aux observateurs. Ce gestionnaire sera appelé avec comme arguments l'erreur et l'instance de Vue associée.
8282

83-
> En 2.2.0, ce hook capture également les erreurs dans les hooks du cycle de vie des composants. De plus, quand ce hook est `undefined`, les erreurs capturées seront loguées avec `console.error` plutôt qu'avoir un crash de l'application.
83+
> En 2.2.0+, ce hook capture également les erreurs dans les hooks du cycle de vie des composants. De plus, quand ce hook est `undefined`, les erreurs capturées seront loguées avec `console.error` plutôt qu'avoir un crash de l'application.
8484
85-
> In 2.4.0 this hook also captures errors thrown inside Vue custom event handlers.
85+
> In 2.4.0+ this hook also captures errors thrown inside Vue custom event handlers.
8686
8787
> [Sentry](https://sentry.io), un service de traçage d'erreur, fournit une [intégration officielle](https://sentry.io/for/vue/) utilisant cette option.
8888
8989
### warnHandler
9090

91-
> New in 2.4.0
91+
> New in 2.4.0+
9292
9393
- **Type:** `Function`
9494

@@ -148,19 +148,19 @@ type: api (En)
148148

149149
### performance
150150

151-
> Nouveau en 2.2.0
151+
> Nouveau dans la 2.2.0+
152152
153153
- **Type :** `boolean`
154154

155-
- **Par défaut :** `false` (à partir de la 2.2.3)
155+
- **Par défaut :** `false` (à partir de la 2.2.3+)
156156

157157
- **Utilisation :**
158158

159159
Assignez ceci à `true` pour activer le suivi des performances pour l'initialisation, la compilation, le rendu et la mise à jour des composants dans la timeline des outils développeur des navigateurs. Fonctionne uniquement en mode développement et dans les navigateurs supportant l'API [performance.mark](https://developer.mozilla.org/en-US/docs/Web/API/Performance/mark).
160160

161161
### productionTip
162162

163-
> Nouveau en 2.2.0
163+
> Nouveau dans la 2.2.0+
164164
165165
- **Type :** `boolean`
166166

@@ -230,7 +230,7 @@ type: api (En)
230230
})
231231
```
232232

233-
> Nouveauté de la 2.1.0: retourne une Promise si aucune fonction de callback n'est fournie et si Promise est supporté par l'environnement d'exécution.
233+
> Nouveauté de la 2.1.0+ : retourne une Promise si aucune fonction de callback n'est fournie et si Promise est supporté par l'environnement d'exécution.
234234
235235
- **Voir aussi :** [File de mise à jour asynchrone](../guide/reactivity.html#Async-Update-Queue)
236236

@@ -678,7 +678,7 @@ if (version === 2) {
678678

679679
### renderError
680680

681-
> Nouveau en 2.2.0
681+
> Nouveau en 2.2.0+
682682
683683
- **Type :** `(createElement: () => VNode, error: Error) => VNode`
684684

@@ -705,9 +705,7 @@ if (version === 2) {
705705
- [Fonctions de Rendu](../guide/render-function)
706706

707707

708-
## Options / Hooks du cycle de vie
709-
710-
Tous les hooks du cycle de vie ont automatiquement leur contexte `this` rattaché à l'instance, afin que vous puissiez accéder aux données, propriétés calculées et méthodes. Cela signifie que __vous ne devriez pas utiliser une fonction fléchée pour définir une méthode du cycle de vie__ (p. ex. `created: () => this.fetchTodos()`). La raison est que les fonctions fléchées utilisent le contexte parent, donc `this` ne sera pas l'instance de Vue comme vous pouvez vous y attendre et `this.fetchTodos` sera `undefined`.
708+
<p class="tip">Tous les hooks du cycle de vie ont automatiquement leur contexte `this` rattaché à l'instance, afin que vous puissiez accéder aux données, propriétés calculées et méthodes. Cela signifie que __vous ne devriez pas utiliser une fonction fléchée pour définir une méthode du cycle de vie__ (p. ex. `created: () => this.fetchTodos()`). La raison est que les fonctions fléchées utilisent le contexte parent, donc `this` ne sera pas l'instance de Vue comme vous pouvez vous y attendre et `this.fetchTodos` sera `undefined`.</p>
711709

712710
### beforeCreate
713711

@@ -930,7 +928,7 @@ Tous les hooks du cycle de vie ont automatiquement leur contexte `this` rattach
930928
931929
### provide / inject
932930
933-
> Nouveau en 2.2.0
931+
> Nouveau dans la 2.2.0+
934932
935933
- **Type :**
936934
- **provide :** `Object | () => Object`
@@ -985,7 +983,7 @@ Tous les hooks du cycle de vie ont automatiquement leur contexte `this` rattach
985983
}
986984
```
987985
988-
> Les deux prochains exemples fonctionnent seulement avec Vue > 2.2.1. En dessous de cette version, les valeurs injectées étaient résolues après l'initialisation des `props` et de `data`.
986+
> Les deux prochains exemples fonctionnent seulement avec Vue 2.2.1+. En dessous de cette version, les valeurs injectées étaient résolues après l'initialisation des `props` et de `data`.
989987
990988
En utilisant une valeur injectée comme valeur par défaut pour une prop :
991989
```js
@@ -1034,6 +1032,8 @@ Tous les hooks du cycle de vie ont automatiquement leur contexte `this` rattach
10341032
10351033
- **Default:** `{% raw %}["{{", "}}"]{% endraw %}`
10361034
1035+
- **Restrictions :** Cette option n'est disponible que dans la version complète du build, avec la compilation dans le navigateur.
1036+
10371037
- **Détails :**
10381038
10391039
Change les délimiteurs d'interpolation de texte. **Cette option est uniquement disponible en version complète.**
@@ -1105,7 +1105,7 @@ Tous les hooks du cycle de vie ont automatiquement leur contexte `this` rattach
11051105
11061106
### inheritAttrs
11071107
1108-
> New in 2.4.0
1108+
> New in 2.4.0+
11091109
11101110
- **Type:** `boolean`
11111111
@@ -1115,14 +1115,18 @@ Tous les hooks du cycle de vie ont automatiquement leur contexte `this` rattach
11151115
11161116
By default, parent scope attribute bindings that are not recognized as props will "fallthrough" and be applied to the root element of the child component as normal HTML attributes. When authoring a component that wraps a target element or another component, this may not always be the desired behavior. By setting `inheritAttrs` to `false`, this default behavior can be disabled. The attributes are available via the `$attrs` instance property (also new in 2.4) and can be explicitly bound to a non-root element using `v-bind`.
11171117
1118+
Note: this option does **not** affect `class` and `style` bindings.
1119+
11181120
### comments
11191121
1120-
> New in 2.4.0
1122+
> New in 2.4.0+
11211123
11221124
- **Type:** `boolean`
11231125
11241126
- **Default:** `false`
11251127
1128+
- **Restrictions:** This option is only available in the full build, with in-browser compilation.
1129+
11261130
- **Details:**
11271131
11281132
When set to `true`, will preserve and render HTML comments found in templates. The default behavior is discarding them.
@@ -1141,7 +1145,7 @@ Tous les hooks du cycle de vie ont automatiquement leur contexte `this` rattach
11411145
11421146
### vm.$props
11431147
1144-
> Nouveau en 2.2.0
1148+
> Nouveau dans la 2.2.0+
11451149
11461150
- **Type :** `Object`
11471151
@@ -1260,7 +1264,7 @@ Tous les hooks du cycle de vie ont automatiquement leur contexte `this` rattach
12601264
12611265
### vm.$scopedSlots
12621266
1263-
> Nouveauté en 2.1.0
1267+
> Nouveauté en 2.1.0+
12641268
12651269
- **Type :** `{ [name: string]: props => VNode | Array<VNode> }`
12661270
@@ -1311,7 +1315,7 @@ Tous les hooks du cycle de vie ont automatiquement leur contexte `this` rattach
13111315
13121316
- **Details:**
13131317
1314-
Contains parent-scope attribute bindings that are not recognized (and extracted) as props. When a component doesn't have any declared props, this essentially contains all parent-scope bindings except for `class` and `style`, and can be passed down to an inner component via `v-bind="$attrs"` - useful when creating higher-order components.
1318+
Contains parent-scope attribute bindings (except for `class` and `style`) that are not recognized (and extracted) as props. When a component doesn't have any declared props, this essentially contains all parent-scope bindings (except for `class` and `style`), and can be passed down to an inner component via `v-bind="$attrs"` - useful when creating higher-order components.
13151319
13161320
### vm.$listeners
13171321
@@ -1530,7 +1534,7 @@ Tous les hooks du cycle de vie ont automatiquement leur contexte `this` rattach
15301534
15311535
Reporte l'éxécution de la fonction `callback` au prochain cycle de mise à jour du DOM. Utilisez ceci immédiatement après avoir changé des données pour attendre la mise à jour du DOM. C'est la même chose que la fonction globale `Vue.nextTick`, sauf que le contexte `this` dans la fonction `callback` est automatiquement lié à l'instance appelant cette méthode.
15321536
1533-
> Nouveau en 2.1.0: retourne une Promise si aucun callback n'est fourni et si les Promise sont supportés dans l'environnement d'exécution.
1537+
> Nouveau en 2.1.0+ : retourne une Promise si aucun callback n'est fourni et si les Promise sont supportés dans l'environnement d'exécution.
15341538
15351539
- **Exemple :**
15361540
@@ -1656,7 +1660,7 @@ Tous les hooks du cycle de vie ont automatiquement leur contexte `this` rattach
16561660
16571661
### v-else-if
16581662
1659-
> New in 2.1.0
1663+
> New in 2.1.0+
16601664
16611665
- **Expects:** `any`
16621666
@@ -1746,7 +1750,7 @@ Tous les hooks du cycle de vie ont automatiquement leur contexte `this` rattach
17461750

17471751
Attaches an event listener to the element. The event type is denoted by the argument. The expression can either be a method name or an inline statement, or simply omitted when there are modifiers present.
17481752

1749-
Starting in `2.4.0`, `v-on` also supports binding to an object of event/listener pairs without an argument. Note when using the object syntax, it does not support any modifiers.
1753+
Starting in 2.4.0+, `v-on` also supports binding to an object of event/listener pairs without an argument. Note when using the object syntax, it does not support any modifiers.
17501754

17511755
When used on a normal element, it listens to **native DOM events** only. When used on a custom element component, it also listens to **custom events** emitted on that child component.
17521756

@@ -2188,7 +2192,7 @@ Tous les hooks du cycle de vie ont automatiquement leur contexte `this` rattach
21882192
21892193
When a component is toggled inside `<keep-alive>`, its `activated` and `deactivated` lifecycle hooks will be invoked accordingly.
21902194
2191-
> In 2.2.0 and above, `activated` and `deactivated` will fire for all nested components inside a `<keep-alive>` tree.
2195+
> In 2.2.0+ and above, `activated` and `deactivated` will fire for all nested components inside a `<keep-alive>` tree.
21922196
21932197
Primarily used with preserve component state or avoid re-rendering.
21942198
@@ -2217,7 +2221,7 @@ Tous les hooks du cycle de vie ont automatiquement leur contexte `this` rattach
22172221
22182222
- **`include` and `exclude`**
22192223
2220-
> New in 2.1.0
2224+
> New in 2.1.0+
22212225
22222226
The `include` and `exclude` props allow components to be conditionally cached. Both props can be a comma-delimited string, a RegExp or an Array:
22232227

src/v2/guide/class-and-style.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -197,7 +197,7 @@ Quand vous utilisez une propriété CSS qui nécessite un [préfixe vendeur](htt
197197

198198
> 2.3.0+
199199
200-
Introduit avec la 2.3, vous pouvez fournir de multiples valeurs de préfixes à une propriété style, par exemple :
200+
Introduit dans la 2.3.0+, vous pouvez fournir de multiples valeurs de préfixes à une propriété style, par exemple :
201201

202202
``` html
203203
<div v-bind:style="{ display: ['-webkit-box', '-ms-flexbox', 'flex'] }">

src/v2/guide/components.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -581,7 +581,7 @@ Dans certains cas, nous pourrions avoir besoin d'une « liaison bidirectionnell
581581

582582
C'est pour cela que nous avions retiré le modificateur `.sync` dans la version 2.0. Cependant, nous trouvons tout de même qu'il existe des cas où celle-ci est très utile, nottament pour les composants réutilisables. Ce dont nous avions besoin était **de rendre le code d'un enfant qui affecte l'état d'un parent plus cohérent et explicite.**
583583

584-
Dans la 2.3 nous réintroduisons donc le modificateur `.sync` pour les props, mais cette fois, ce n'est qu'un sucre syntaxique pour étendre automatiquement un écouteur `v-on` additionnel :
584+
Dans la 2.3.0+ nous réintroduisons donc le modificateur `.sync` pour les props, mais cette fois, ce n'est qu'un sucre syntaxique pour étendre automatiquement un écouteur `v-on` additionnel :
585585

586586
Ce qui suit
587587

@@ -723,7 +723,7 @@ L'implémentation ci-dessus est plutôt naïve cependant. Par exemple, les utili
723723

724724
### Personnalisation de composant avec `v-model`
725725

726-
> Nouveau dans la 2.2.0
726+
> Nouveau dans la 2.2.0+
727727
728728
Par défaut, `v-model` sur un composant utilise `value` en tant que prop et peuvent vouloir utiliser `input` en tant qu'événement, mais plusieurs types de champ comme les cases à cocher et les boutons radio pourraient utiliser `value` pour un usage différent. Utiliser l'option `model` permet d'éviter les conflits dans ce genre de situations :
729729

@@ -935,7 +935,7 @@ L'API de distribution de contenu est un mécanisme vraiment utile lors de la con
935935

936936
### Slots avec portée
937937

938-
> Nouveau dans la 2.1.0
938+
> Nouveau dans la 2.1.0+
939939
940940
Un slot avec portée est un type de slot spécial qui fonctionne comme un template réutilisable (auquel on peut passer des données) au lieu d'éléments déjà rendus.
941941

@@ -1145,9 +1145,9 @@ new Vue({
11451145

11461146
### Composants asynchrones avancés
11471147

1148-
> Nouveau en 2.3.0
1148+
> Nouveau dans la 2.3.0+
11491149
1150-
Introduit avec la 2.3, le générateur de composant asynchrone peut aussi retourner un objet au format suivant :
1150+
Introduit dans la 2.3.0+, le générateur de composant asynchrone peut aussi retourner un objet au format suivant :
11511151

11521152
``` js
11531153
const AsyncComp = () => ({

src/v2/guide/conditional.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ Un élément `v-else` doit immédiatement suivre un élément `v-if` ou un élé
5757

5858
### `v-else-if`
5959

60-
> Nouveau dans la 2.1.0
60+
> Nouveau dans la 2.1.0+
6161
6262
Le `v-else-if`, comme le nom le suggère, sert comme une « structure sinon si » pour `v-if`. Il peut également être enchaîné plusieurs fois :
6363

src/v2/guide/events.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -196,7 +196,7 @@ Pour résoudre ce problème, Vue propose des modificateurs d'évènements pour `
196196

197197
<p class="tip">L'ordre a de l'importance quand vous utilisez des modificateurs car le code est généré dans le même ordre. Aussi utiliser `@click.prevent.self` va empécher **tous les clicks** alors que `@click.self.prevent` va uniquement empécher le click sur l'élément lui-même.</p>
198198

199-
> Nouveau dans la 2.1.4
199+
> Nouveau dans la 2.1.4+
200200
201201
``` html
202202
<!-- l'évènement « click » sera déclenché au moins une fois -->
@@ -270,7 +270,7 @@ Par exemple :
270270

271271
### Modificateurs de boutons de la souris
272272

273-
> Nouveau dans la 2.2.0
273+
> Nouveau dans la 2.2.0+
274274
275275
- `.left`
276276
- `.right`

src/v2/guide/render-function.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -468,7 +468,7 @@ Vue.component('my-component', {
468468
})
469469
```
470470

471-
> Note : dans les versions <= 2.3.0, l'option `props` est requise si vous souhaitez accepter des props dans un composant fonctionnel. Dans les versions 2.3.0+ vous pouvez omettre l'option `props` et tous les attributs trouvés dans le nœud composant seront implicitement extraits comme des props.
471+
> Note : dans les versions avant 2.3.0, l'option `props` est requise si vous souhaitez accepter des props dans un composant fonctionnel. Dans les versions 2.3.0+ vous pouvez omettre l'option `props` et tous les attributs trouvés dans le nœud composant seront implicitement extraits comme des props.
472472
473473
Tout ce dont le composant a besoin est passé dans l'objet `context`, qui est un objet contenant :
474474

src/v2/guide/syntax.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -130,7 +130,7 @@ Vue.js permet de définir des filtres qui peuvent être utilisés pour appliquer
130130
<div v-bind:id="rawId | formatId"></div>
131131
```
132132

133-
<p class="tip">Les filtres de Vue 2.x peuvent être seulement utilisés à l'intérieur des interpolations de moustaches et des expressions de `v-bind` (ces dernières étant supportées depuis la 2.1.0) car les filtres ont été conçus à la base dans le but de transformer du texte. Pour des cas plus complexes de transformation de données dans d'autres directives, vous devriez utiliser les [propriétés calculées](computed.html) à la place.</p>
133+
<p class="tip">Les filtres de Vue 2.x peuvent être seulement utilisés à l'intérieur des interpolations de moustaches et des expressions de `v-bind` (ces dernières étant supportées depuis la 2.1.0+) car les filtres ont été conçus à la base dans le but de transformer du texte. Pour des cas plus complexes de transformation de données dans d'autres directives, vous devriez utiliser les [propriétés calculées](computed.html) à la place.</p>
134134

135135
La fonction de filtre reçoit toujours la valeur de l'expression comme premier argument.
136136

src/v2/guide/team.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -200,6 +200,7 @@ order: 31
200200
'Chongqing, China': [29.431586, 106.912251],
201201
'Denver, CO, USA': [39.739236, -104.990251],
202202
'Dubna, Russia': [56.732020, 37.166897],
203+
'East Lansing, MI, USA': [42.736979, -84.483865],
203204
'Hangzhou, China': [30.274084, 120.155070],
204205
'Jersey City, NJ, USA': [40.728157, -74.558716],
205206
'Kingston, Jamaica': [18.017874, -76.809904],
@@ -526,13 +527,32 @@ order: 31
526527
title: 'Issue Annihilator',
527528
city: 'Chongqing, China',
528529
languages: ['zh', 'en'],
530+
github: 'gebilaoxiong',
529531
work: {
530532
org: 'zbj.com',
531533
orgUrl: 'http://www.zbj.com/'
532534
},
533535
reposOfficial: [
534536
'vue'
535537
]
538+
},
539+
{
540+
name: 'Andrew Tomaka',
541+
title: 'The Server Server',
542+
city: 'East Lansing, MI, USA',
543+
languages: ['en'],
544+
github: 'atomaka',
545+
twitter: 'atomaka',
546+
reposOfficial: [
547+
'vuejs/*'
548+
],
549+
work: {
550+
org: 'Michigan State University',
551+
orgUrl: 'https://msu.edu/'
552+
},
553+
links: [
554+
'https://atomaka.com/'
555+
]
536556
}
537557
]))
538558

0 commit comments

Comments
 (0)