From d9435bb1bfd9772e734b59f19d89f80c9fcdd7ed Mon Sep 17 00:00:00 2001
From: Mathieu DARTIGUES <mathieu@dartic.fr>
Date: Thu, 2 Nov 2017 23:31:22 +0100
Subject: [PATCH 1/5] Guide: dom-events.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Première traduction
---
 docs/en/guides/dom-events.md | 117 ++++++++++++++++++-----------------
 1 file changed, 59 insertions(+), 58 deletions(-)

diff --git a/docs/en/guides/dom-events.md b/docs/en/guides/dom-events.md
index 83d9e8ad7..a9c1b8f41 100644
--- a/docs/en/guides/dom-events.md
+++ b/docs/en/guides/dom-events.md
@@ -1,8 +1,9 @@
-# Testing Key, Mouse and other DOM events
+# Tester le clavier, la souris et les autres événements DOM
 
-## Trigger events
+## Déclencheur d'événements
 
-The `Wrapper` expose a `trigger` method. It can be used to trigger DOM events.
+
+Le `Wrapper` expose une méthode `trigger` method. Elle peut être utilisée pour déclencher des événements du DOM.
 
 ```js
 const wrapper = mount(MyButton)
@@ -10,7 +11,7 @@ const wrapper = mount(MyButton)
 wrapper.trigger('click')
 ```
 
-You should be aware, that find returns a wrapper as well. Assuming `MyComponent` contains a button, the following code clicks the button.
+Vous devez être au courant que la méthode find retourne un wrapper aussi. Partant du principe que `MyComponent` contient un bouton, le code suivant clique sur le bouton.
 
 ```js
 const wrapper = mount(MyComponent)
@@ -20,9 +21,9 @@ wrapper.find('button').trigger('click')
 
 ## Options
 
-The trigger method takes an optional `options` object. The properties in the `options` object are added to the Event.
+La méthode trigger prend en paramètre optionnel l'objet `options`. Les propriétés de l'objet `options` sont ajoutées à l'événement Event.
 
-You can run preventDefault on the event by passing `preventDefault: true` in `options`.
+Vous pouvez utiliser preventDefault sur l'événement en passant `preventDefault: true` dans le paramètre `options`.
 
 ```js
 const wrapper = mount(MyButton)
@@ -31,31 +32,31 @@ wrapper.trigger('click', {preventDefault: true})
 ```
 
 
-## Mouse Click Example
+## Exemple de clic de souris
 
-**Component under test**
+**Componsant à tester**
 
 ```js
 <template>
 <div>
-  <button class="yes" @click="callYes">Yes</button>
-  <button class="no" @click="callNo">No</button>
+  <button class="oui" @click="callOui">Oui</button>
+  <button class="non" @click="callNon">Non</button>
 </div>
 </template>
 <script>
 export default {
-  name: 'YesNoComponent',
+  name: 'OuiNonComponent',
   props: {
     callMe: {
       type: Function
     }
   },
   methods: {
-    callYes() {
-      this.callMe('yes')
+    callOui() {
+      this.callMe('oui')
     },
-    callNo() {
-      this.callMe('no')
+    callNon() {
+      this.callMe('non')
     }
   }
 }
@@ -66,34 +67,34 @@ export default {
 **Test**
 
 ```js
-import YesNoComponent from '@/components/YesNoComponent'
+import OuiNonComponent from '@/components/OuiNonComponent'
 import { mount } from 'vue-test-utils'
 import sinon from 'sinon'
 
-describe('Click event', () => {
-  it('Click on yes button calls our method with argument "yes"', () => {
+describe('Evenement click', () => {
+  it('Cliquer sur le bouton oui appelle notre méthode avec l argument "oui"', () => {
     const spy = sinon.spy()
-    const wrapper = mount(YesNoComponent, {
+    const wrapper = mount(OuiNonComponent, {
       propsData: {
         callMe: spy
       }
     })
-    wrapper.find('button.yes').trigger('click')
+    wrapper.find('button.oui').trigger('click')
 
-    spy.should.have.been.calledWith('yes')
+    spy.should.have.been.calledWith('oui')
   })
 })
 ```
 
-## Keyboard Example
+## Example de test clavier
 
-**Component under test**
+**Composant à tester**
 
-This component allows to increment/decrement the quantity using various keys.
+Ce composant permet d'incrémenter/décrémenter la quantité en utilisant différentes touches.
 
 ```js
 <template>
-<input type="text" @keydown.prevent="onKeydown" v-model="quantity" />
+<input type="text" @keydown.prevent="onKeydown" v-model="quantite" />
 </template>
 <script>
 const KEY_DOWN = 40
@@ -104,36 +105,36 @@ const CHAR_A = 65
 export default {
   data() {
     return {
-      quantity: 0
+      quantite: 0
     }
   },
   methods: {
-    increment() {
-      this.quantity += 1
+    incrementer() {
+      this.quantite += 1
     },
-    decrement() {
-      this.quantity -= 1
+    decrementer() {
+      this.quantite -= 1
     },
-    clear() {
-      this.quantity = 0
+    nettoyer() {
+      this.quantite = 0
     },
     onKeydown(e) {
       if (e.keyCode === ESCAPE) {
-        this.clear()
+        this.nettoyer()
       }
       if (e.keyCode === KEY_DOWN) {
-        this.decrement()
+        this.decrementer()
       }
       if (e.keyCode === KEY_UP) {
-        this.increment()
+        this.incrementer()
       }
       if (e.which === CHAR_A) {
-        this.quantity = 13
+        this.quantite = 13
       }
     }
   },
   watch: {
-    quantity: function (newValue) {
+    quantite: function (newValue) {
       this.$emit('input', newValue)
     }
   }
@@ -145,41 +146,41 @@ export default {
 **Test**
 
 ```js
-import QuantityComponent from '@/components/QuantityComponent'
+import QuantiteComponent from '@/components/QuantiteComponent'
 import { mount } from 'vue-test-utils'
 
-describe('Key event tests', () => {
-  it('Quantity is zero by default', () => {
-    const wrapper = mount(QuantityComponent)
-    expect(wrapper.vm.quantity).to.equal(0)
+describe('Tests événement clavier', () => {
+  it('La quantité est zéro par défaut', () => {
+    const wrapper = mount(QuantiteComponent)
+    expect(wrapper.vm.quantite).to.equal(0)
   })
 
-  it('Cursor up sets quantity to 1', () => {
-    const wrapper = mount(QuantityComponent)
+  it('La flèche du haut positionne la quantité à 1', () => {
+    const wrapper = mount(QuantiteComponent)
     wrapper.trigger('keydown.up')
-    expect(wrapper.vm.quantity).to.equal(1)
+    expect(wrapper.vm.quantite).to.equal(1)
   })
 
-  it('Cursor down reduce quantity by 1', () => {
-    const wrapper = mount(QuantityComponent)
-    wrapper.vm.quantity = 5
+  it('La flèche du bas réduit la quantité de 1', () => {
+    const wrapper = mount(QuantiteComponent)
+    wrapper.vm.quantite = 5
     wrapper.trigger('keydown.down')
-    expect(wrapper.vm.quantity).to.equal(4)
+    expect(wrapper.vm.quantite).to.equal(4)
   })
 
-  it('Escape sets quantity to 0', () => {
-    const wrapper = mount(QuantityComponent)
-    wrapper.vm.quantity = 5
+  it('La touche Echap positionne la quantité à 0', () => {
+    const wrapper = mount(QuantiteComponent)
+    wrapper.vm.quantite = 5
     wrapper.trigger('keydown.esc')
-    expect(wrapper.vm.quantity).to.equal(0)
+    expect(wrapper.vm.quantite).to.equal(0)
   })
 
-  it('Magic character "a" sets quantity to 13', () => {
-    const wrapper = mount(QuantityComponent)
+  it('Le caractère magique "a" positionne la quantité à 13', () => {
+    const wrapper = mount(QuantiteComponent)
     wrapper.trigger('keydown', {
       which: 65
     })
-    expect(wrapper.vm.quantity).to.equal(13)
+    expect(wrapper.vm.quantite).to.equal(13)
   })
 })
 
@@ -187,10 +188,10 @@ describe('Key event tests', () => {
 
 **Limitations**
 
-A key name after the dot `keydown.up` is translated to a `keyCode`. This is supported for the following names:
+Un nom de touche après le point `keydown.up` est traduit vers un `keyCode`. Cela est supporté pour les noms suivant:
 
 * enter, tab, delete, esc, space, up, down, left, right
 
 ## Important
 
-vue-test-utils triggers event synchronously. Consequently, `vue.nextTick` is not required.
+vue-test-utils déclenche les événements de façon synchrone. Par conséquent, `vue.nextTick` n'est pas requis.

From befc38d1dffca517bb084f9382f6eac100400ba2 Mon Sep 17 00:00:00 2001
From: Mathieu DARTIGUES <mathieu@dartic.fr>
Date: Thu, 2 Nov 2017 23:37:25 +0100
Subject: [PATCH 2/5] Update README.md

---
 docs/en/guides/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/guides/README.md b/docs/en/guides/README.md
index b927e5e36..aaf0328fb 100644
--- a/docs/en/guides/README.md
+++ b/docs/en/guides/README.md
@@ -2,7 +2,7 @@
 
 * [Commencer](./getting-started.md)
 * [Astuces](./common-tips.md)
-* [Mouse, Key and other DOM Events (EN)](guides/dom-events.md)
+* [Mouse, Key and other DOM Events (EN)](./dom-events.md)
 * [Choisir un lanceur de tests](./choosing-a-test-runner.md)
 * [Utiliser avec Jest](./using-with-jest.md)
 * [Tester des composants monofichiers avec Jest](./testing-SFCs-with-jest.md)

From f1b13ae956b3493b00af5d4fa5d57c136cece88a Mon Sep 17 00:00:00 2001
From: Mathieu DARTIGUES <mathieu@dartic.fr>
Date: Sun, 5 Nov 2017 18:33:50 +0100
Subject: [PATCH 3/5] Update dom-events.md

---
 docs/en/guides/dom-events.md | 100 +++++++++++++++++------------------
 1 file changed, 50 insertions(+), 50 deletions(-)

diff --git a/docs/en/guides/dom-events.md b/docs/en/guides/dom-events.md
index a9c1b8f41..67a773a2d 100644
--- a/docs/en/guides/dom-events.md
+++ b/docs/en/guides/dom-events.md
@@ -1,9 +1,9 @@
-# Tester le clavier, la souris et les autres événements DOM
+# Tester le clavier, la souris et les autres évènements DOM
 
-## Déclencheur d'événements
+## Déclencheur d'évènements
 
 
-Le `Wrapper` expose une méthode `trigger` method. Elle peut être utilisée pour déclencher des événements du DOM.
+Le `Wrapper` expose une méthode `trigger`. Elle peut être utilisée pour déclencher des évènements du DOM.
 
 ```js
 const wrapper = mount(MyButton)
@@ -11,7 +11,7 @@ const wrapper = mount(MyButton)
 wrapper.trigger('click')
 ```
 
-Vous devez être au courant que la méthode find retourne un wrapper aussi. Partant du principe que `MyComponent` contient un bouton, le code suivant clique sur le bouton.
+Vous devez être au courant que la méthode `find` retourne un wrapper aussi. Partant du principe que `MyComponent` contient un bouton, le code suivant clique sur le bouton.
 
 ```js
 const wrapper = mount(MyComponent)
@@ -21,9 +21,9 @@ wrapper.find('button').trigger('click')
 
 ## Options
 
-La méthode trigger prend en paramètre optionnel l'objet `options`. Les propriétés de l'objet `options` sont ajoutées à l'événement Event.
+La méthode `trigger` prend en paramètre optionnel l'objet `options`. Les propriétés de l'objet `options` sont ajoutées à l'évènement.
 
-Vous pouvez utiliser preventDefault sur l'événement en passant `preventDefault: true` dans le paramètre `options`.
+Vous pouvez utiliser `preventDefault` sur l'évènement en passant `preventDefault: true` dans le paramètre `options`.
 
 ```js
 const wrapper = mount(MyButton)
@@ -39,24 +39,24 @@ wrapper.trigger('click', {preventDefault: true})
 ```js
 <template>
 <div>
-  <button class="oui" @click="callOui">Oui</button>
-  <button class="non" @click="callNon">Non</button>
+  <button class="yes" @click="callYes">Oui</button>
+  <button class="no" @click="callNo">Non</button>
 </div>
 </template>
 <script>
 export default {
-  name: 'OuiNonComponent',
+  name: 'YesNoComponent',
   props: {
     callMe: {
       type: Function
     }
   },
   methods: {
-    callOui() {
-      this.callMe('oui')
+    callYes() {
+      this.callMe('yes')
     },
-    callNon() {
-      this.callMe('non')
+    callNo() {
+      this.callMe('no')
     }
   }
 }
@@ -67,34 +67,34 @@ export default {
 **Test**
 
 ```js
-import OuiNonComponent from '@/components/OuiNonComponent'
+import YesNoComponent from '@/components/YesNoComponent'
 import { mount } from 'vue-test-utils'
 import sinon from 'sinon'
 
-describe('Evenement click', () => {
-  it('Cliquer sur le bouton oui appelle notre méthode avec l argument "oui"', () => {
+describe('Évènement click', () => {
+  it('Cliquer sur le bouton oui appelle notre méthode avec l\'argument "yes"', () => {
     const spy = sinon.spy()
-    const wrapper = mount(OuiNonComponent, {
+    const wrapper = mount(YesNoComponent, {
       propsData: {
         callMe: spy
       }
     })
-    wrapper.find('button.oui').trigger('click')
+    wrapper.find('button.yes').trigger('click')
 
-    spy.should.have.been.calledWith('oui')
+    spy.should.have.been.calledWith('yes')
   })
 })
 ```
 
-## Example de test clavier
+## Exemple de test clavier
 
 **Composant à tester**
 
-Ce composant permet d'incrémenter/décrémenter la quantité en utilisant différentes touches.
+Ce composant permet d'incrémenter / décrémenter la quantité en utilisant différentes touches.
 
 ```js
 <template>
-<input type="text" @keydown.prevent="onKeydown" v-model="quantite" />
+<input type="text" @keydown.prevent="onKeydown" v-model="quantity" />
 </template>
 <script>
 const KEY_DOWN = 40
@@ -105,36 +105,36 @@ const CHAR_A = 65
 export default {
   data() {
     return {
-      quantite: 0
+      quantity: 0
     }
   },
   methods: {
-    incrementer() {
-      this.quantite += 1
+    increment() {
+      this.quantity += 1
     },
-    decrementer() {
-      this.quantite -= 1
+    decrement() {
+      this.quantity -= 1
     },
-    nettoyer() {
-      this.quantite = 0
+    clear() {
+      this.quantity = 0
     },
     onKeydown(e) {
       if (e.keyCode === ESCAPE) {
-        this.nettoyer()
+        this.clear()
       }
       if (e.keyCode === KEY_DOWN) {
-        this.decrementer()
+        this.decrement()
       }
       if (e.keyCode === KEY_UP) {
-        this.incrementer()
+        this.increment()
       }
       if (e.which === CHAR_A) {
-        this.quantite = 13
+        this.quantity = 13
       }
     }
   },
   watch: {
-    quantite: function (newValue) {
+    quantity: function (newValue) {
       this.$emit('input', newValue)
     }
   }
@@ -146,41 +146,41 @@ export default {
 **Test**
 
 ```js
-import QuantiteComponent from '@/components/QuantiteComponent'
+import QuantityComponent from '@/components/QuantityComponent'
 import { mount } from 'vue-test-utils'
 
 describe('Tests événement clavier', () => {
   it('La quantité est zéro par défaut', () => {
-    const wrapper = mount(QuantiteComponent)
-    expect(wrapper.vm.quantite).to.equal(0)
+    const wrapper = mount(QuantityComponent)
+    expect(wrapper.vm.quantity).to.equal(0)
   })
 
   it('La flèche du haut positionne la quantité à 1', () => {
-    const wrapper = mount(QuantiteComponent)
+    const wrapper = mount(QuantityComponent)
     wrapper.trigger('keydown.up')
-    expect(wrapper.vm.quantite).to.equal(1)
+    expect(wrapper.vm.quantity).to.equal(1)
   })
 
   it('La flèche du bas réduit la quantité de 1', () => {
-    const wrapper = mount(QuantiteComponent)
-    wrapper.vm.quantite = 5
+    const wrapper = mount(QuantityComponent)
+    wrapper.vm.quantity = 5
     wrapper.trigger('keydown.down')
-    expect(wrapper.vm.quantite).to.equal(4)
+    expect(wrapper.vm.quantity).to.equal(4)
   })
 
-  it('La touche Echap positionne la quantité à 0', () => {
-    const wrapper = mount(QuantiteComponent)
-    wrapper.vm.quantite = 5
+  it('La touche Échap positionne la quantité à 0', () => {
+    const wrapper = mount(QuantityComponent)
+    wrapper.vm.quantity = 5
     wrapper.trigger('keydown.esc')
-    expect(wrapper.vm.quantite).to.equal(0)
+    expect(wrapper.vm.quantity).to.equal(0)
   })
 
   it('Le caractère magique "a" positionne la quantité à 13', () => {
-    const wrapper = mount(QuantiteComponent)
+    const wrapper = mount(QuantityComponent)
     wrapper.trigger('keydown', {
       which: 65
     })
-    expect(wrapper.vm.quantite).to.equal(13)
+    expect(wrapper.vm.quantity).to.equal(13)
   })
 })
 
@@ -188,10 +188,10 @@ describe('Tests événement clavier', () => {
 
 **Limitations**
 
-Un nom de touche après le point `keydown.up` est traduit vers un `keyCode`. Cela est supporté pour les noms suivant:
+Un nom de touche après le point `keydown.up` est traduit vers un `keyCode`. Cela est supporté pour les noms suivant :
 
 * enter, tab, delete, esc, space, up, down, left, right
 
 ## Important
 
-vue-test-utils déclenche les événements de façon synchrone. Par conséquent, `vue.nextTick` n'est pas requis.
+vue-test-utils déclenche les évènements de façon synchrone. Par conséquent, `vue.nextTick` n'est pas requis.

From 3a7a08ee0f1557ef1f8904a3cb17ded47d8998fc Mon Sep 17 00:00:00 2001
From: Mathieu DARTIGUES <mathieu@dartic.fr>
Date: Sun, 5 Nov 2017 18:35:34 +0100
Subject: [PATCH 4/5] Update README.md

---
 docs/en/guides/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/guides/README.md b/docs/en/guides/README.md
index aaf0328fb..223989ad0 100644
--- a/docs/en/guides/README.md
+++ b/docs/en/guides/README.md
@@ -2,7 +2,7 @@
 
 * [Commencer](./getting-started.md)
 * [Astuces](./common-tips.md)
-* [Mouse, Key and other DOM Events (EN)](./dom-events.md)
+* [La souris, le clavier et les autres évènements DOM](./dom-events.md)
 * [Choisir un lanceur de tests](./choosing-a-test-runner.md)
 * [Utiliser avec Jest](./using-with-jest.md)
 * [Tester des composants monofichiers avec Jest](./testing-SFCs-with-jest.md)

From cebe2a6b1847a37f386d766c411ed064283c6166 Mon Sep 17 00:00:00 2001
From: Mathieu DARTIGUES <mathieu@dartic.fr>
Date: Mon, 6 Nov 2017 12:13:33 +0100
Subject: [PATCH 5/5] Prise en compte des remarques de @Yati & @Haeresis

---
 docs/en/guides/dom-events.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/en/guides/dom-events.md b/docs/en/guides/dom-events.md
index 67a773a2d..5baec95ce 100644
--- a/docs/en/guides/dom-events.md
+++ b/docs/en/guides/dom-events.md
@@ -11,7 +11,7 @@ const wrapper = mount(MyButton)
 wrapper.trigger('click')
 ```
 
-Vous devez être au courant que la méthode `find` retourne un wrapper aussi. Partant du principe que `MyComponent` contient un bouton, le code suivant clique sur le bouton.
+Vous devez être au courant que la méthode `find` retourne aussi un wrapper. En partant du principe que `MyComponent` contient un bouton, le code suivant clique sur le bouton.
 
 ```js
 const wrapper = mount(MyComponent)
@@ -34,7 +34,7 @@ wrapper.trigger('click', {preventDefault: true})
 
 ## Exemple de clic de souris
 
-**Componsant à tester**
+**Composant à tester**
 
 ```js
 <template>
@@ -53,10 +53,10 @@ export default {
   },
   methods: {
     callYes() {
-      this.callMe('yes')
+      this.callMe('oui')
     },
     callNo() {
-      this.callMe('no')
+      this.callMe('non')
     }
   }
 }
@@ -72,7 +72,7 @@ import { mount } from 'vue-test-utils'
 import sinon from 'sinon'
 
 describe('Évènement click', () => {
-  it('Cliquer sur le bouton oui appelle notre méthode avec l\'argument "yes"', () => {
+  it('Cliquer sur le bouton oui appelle notre méthode avec l\'argument "oui"', () => {
     const spy = sinon.spy()
     const wrapper = mount(YesNoComponent, {
       propsData: {
@@ -81,7 +81,7 @@ describe('Évènement click', () => {
     })
     wrapper.find('button.yes').trigger('click')
 
-    spy.should.have.been.calledWith('yes')
+    spy.should.have.been.calledWith('oui')
   })
 })
 ```