From 34fa94f034378da8f64256f9ba306b6b093f2227 Mon Sep 17 00:00:00 2001 From: Bruno Lesieur Date: Mon, 19 Jun 2017 17:18:14 +0200 Subject: [PATCH 1/4] Traduction de plugins.md Signed-off-by: Bruno Lesieur --- src/v2/guide/plugins.md | 52 ++++++++++++++++++++--------------------- 1 file changed, 26 insertions(+), 26 deletions(-) diff --git a/src/v2/guide/plugins.md b/src/v2/guide/plugins.md index 955156c4ae..f248f64c22 100644 --- a/src/v2/guide/plugins.md +++ b/src/v2/guide/plugins.md @@ -1,81 +1,81 @@ --- -title: Plugins (En) +title: Plugins type: guide order: 18 --- -## Writing a Plugin +## Écrie un plugin -

**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/vuejs.org).**

Plugins usually add global-level functionality to Vue. There is no strictly defined scope for a plugin - there are typically several types of plugins you can write:

+Les plugins sont habituellement ajouté au niveau des fonctionnalités globales de Vue. Il y a un cadre strictement défini pour un plugin, et il y a divers types de plugins que vous pouvez écrire : -1. Add some global methods or properties. e.g. [vue-custom-element](https://github.com/karol-f/vue-custom-element) +1. Ajouter plusieurs méthodes globales ou propriétés. Par ex. [vue-custom-element](https://github.com/karol-f/vue-custom-element) -2. Add one or more global assets: directives/filters/transitions etc. e.g. [vue-touch](https://github.com/vuejs/vue-touch) +2. Ajouter une ou plusieurs ensemble de fonctionnalités : directives/filters/transitions, etc. Par ex. [vue-touch](https://github.com/vuejs/vue-touch) -3. Add some component options by global mixin. e.g. [vuex](https://github.com/vuejs/vuex) +3. Ajouter plusieurs options de composant avec un mixin global. Par ex. [vuex](https://github.com/vuejs/vuex) -4. Add some Vue instance methods by attaching them to Vue.prototype. +4. Ajouter plusieurs méthodes d'instance de Vue attachées au prototype de Vue. -5. A library that provides an API of its own, while at the same time injecting some combination of the above. e.g. [vue-router](https://github.com/vuejs/vue-router) +5. Une bibliothèque fournissant sa propre API, qui inject en même temps plusieurs des éléments précédemment cités. Par ex. [vue-router](https://github.com/vuejs/vue-router) -A Vue.js plugin should expose an `install` method. The method will be called with the `Vue` constructor as the first argument, along with possible options: +Un plugin Vue.js doit exposer une méthode `install`. Cette méthode va être appelée avec le constructeur de `Vue` en tant que premier argument, avec les options possibles suivantes : ``` js MyPlugin.install = function (Vue, options) { - // 1. add global method or property + // 1. ajouter une méthode globale ou une propriété Vue.myGlobalMethod = function () { - // something logic ... + // de la logique de code... } - // 2. add a global asset + // 2. ajouter des fonctionnalités Vue.directive('my-directive', { bind (el, binding, vnode, oldVnode) { - // something logic ... + // de la logique de code... } ... }) - // 3. inject some component options + // 3. injecter des options de composant Vue.mixin({ created: function () { - // something logic ... + // de la logique de code... } ... }) - // 4. add an instance method + // 4. ajouter des méthodes d'instance Vue.prototype.$myMethod = function (options) { - // something logic ... + // de la logique de code... } } ``` -## Using a Plugin +## Utiliser un plugin -Use plugins by calling the `Vue.use()` global method: +Utiliser un plugin en appelant la méthode globale `Vue.use()` : ``` js -// calls `MyPlugin.install(Vue)` +// appeler `MyPlugin.install(Vue)` Vue.use(MyPlugin) ``` -You can optionally pass in some options: +Vous pouvez optionnellement passer plusieurs options : ``` js Vue.use(MyPlugin, { someOption: true }) ``` -`Vue.use` automatically prevents you from using the same plugin more than once, so calling it multiple times on the same plugin will install the plugin only once. +`Vue.use` va automatiquement vous empécher d'utiliser plusieurs fois le même plugin, ainsi appeler de multiple fois le même plugin ne l'installera qu'une fois. -Some plugins provided by Vue.js official plugins such as `vue-router` automatically calls `Vue.use()` if `Vue` is available as a global variable. However in a module environment such as CommonJS, you always need to call `Vue.use()` explicitly: +Plusieurs plugins fournient officiellement par Vue.js comme `vue-router` appel `Vue.use()` si `Vue` est disponible en tant que variable globale. Cependant, dans un environnement par module comme avec CommonJS, vous devrez toujours manuellement appeler `Vue.use()` : ``` js -// When using CommonJS via Browserify or webpack +// En utilisant CommonJS depuis Browserify ou webpack var Vue = require('vue') var VueRouter = require('vue-router') -// Don't forget to call this +// N'oubliez pas de l'appeler Vue.use(VueRouter) ``` -Checkout [awesome-vue](https://github.com/vuejs/awesome-vue#components--libraries) for a huge collection of community-contributed plugins and libraries. +Consultez [awesome-vue](https://github.com/vuejs/awesome-vue#components--libraries) pour une large collection de plugin et bibliothèque fournis par la contribution de la communauté. From 4fa0f8ddca05214f05166675e908a2e5d18e8ce1 Mon Sep 17 00:00:00 2001 From: Bruno Lesieur Date: Mon, 19 Jun 2017 17:20:22 +0200 Subject: [PATCH 2/4] Meilleure consitance pour la liste Signed-off-by: Bruno Lesieur --- src/v2/guide/plugins.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/v2/guide/plugins.md b/src/v2/guide/plugins.md index f248f64c22..6c1ebd4425 100644 --- a/src/v2/guide/plugins.md +++ b/src/v2/guide/plugins.md @@ -6,17 +6,17 @@ order: 18 ## Écrie un plugin -Les plugins sont habituellement ajouté au niveau des fonctionnalités globales de Vue. Il y a un cadre strictement défini pour un plugin, et il y a divers types de plugins que vous pouvez écrire : +Les plugins sont habituellement ajoutés au niveau des fonctionnalités globales de Vue. Il y a un cadre strictement défini pour un plugin, et il y a divers types de plugins que vous pouvez écrire pour : 1. Ajouter plusieurs méthodes globales ou propriétés. Par ex. [vue-custom-element](https://github.com/karol-f/vue-custom-element) -2. Ajouter une ou plusieurs ensemble de fonctionnalités : directives/filters/transitions, etc. Par ex. [vue-touch](https://github.com/vuejs/vue-touch) +2. Ajouter une ou plusieurs fonctionnalités : directives/filters/transitions, etc. Par ex. [vue-touch](https://github.com/vuejs/vue-touch) 3. Ajouter plusieurs options de composant avec un mixin global. Par ex. [vuex](https://github.com/vuejs/vuex) 4. Ajouter plusieurs méthodes d'instance de Vue attachées au prototype de Vue. -5. Une bibliothèque fournissant sa propre API, qui inject en même temps plusieurs des éléments précédemment cités. Par ex. [vue-router](https://github.com/vuejs/vue-router) +5. Fournir une bibliothèque avec sa propre API, qui inject en même temps plusieurs des éléments précédemment cités. Par ex. [vue-router](https://github.com/vuejs/vue-router) Un plugin Vue.js doit exposer une méthode `install`. Cette méthode va être appelée avec le constructeur de `Vue` en tant que premier argument, avec les options possibles suivantes : From 0f6d2b1ba70118cd3da6069c6ed6b402f87b45ee Mon Sep 17 00:00:00 2001 From: Bruno Lesieur Date: Thu, 22 Jun 2017 12:04:46 +0200 Subject: [PATCH 3/4] =?UTF-8?q?Modifications=20apr=C3=A8s=20review=20de=20?= =?UTF-8?q?@kokal?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Bruno Lesieur --- src/v2/guide/plugins.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/src/v2/guide/plugins.md b/src/v2/guide/plugins.md index 6c1ebd4425..6c4f7e638b 100644 --- a/src/v2/guide/plugins.md +++ b/src/v2/guide/plugins.md @@ -4,7 +4,7 @@ type: guide order: 18 --- -## Écrie un plugin +## Écrire un plugin Les plugins sont habituellement ajoutés au niveau des fonctionnalités globales de Vue. Il y a un cadre strictement défini pour un plugin, et il y a divers types de plugins que vous pouvez écrire pour : @@ -16,7 +16,7 @@ Les plugins sont habituellement ajoutés au niveau des fonctionnalités globales 4. Ajouter plusieurs méthodes d'instance de Vue attachées au prototype de Vue. -5. Fournir une bibliothèque avec sa propre API, qui inject en même temps plusieurs des éléments précédemment cités. Par ex. [vue-router](https://github.com/vuejs/vue-router) +5. Fournir une bibliothèque avec sa propre API, qui injecte en même temps certains des éléments précédemment cités. Par ex. [vue-router](https://github.com/vuejs/vue-router) Un plugin Vue.js doit exposer une méthode `install`. Cette méthode va être appelée avec le constructeur de `Vue` en tant que premier argument, avec les options possibles suivantes : @@ -55,11 +55,11 @@ MyPlugin.install = function (Vue, options) { Utiliser un plugin en appelant la méthode globale `Vue.use()` : ``` js -// appeler `MyPlugin.install(Vue)` +// appel `MyPlugin.install(Vue)` Vue.use(MyPlugin) ``` -Vous pouvez optionnellement passer plusieurs options : +Vous pouvez optionnellement passer certaines options : ``` js Vue.use(MyPlugin, { someOption: true }) @@ -67,7 +67,7 @@ Vue.use(MyPlugin, { someOption: true }) `Vue.use` va automatiquement vous empécher d'utiliser plusieurs fois le même plugin, ainsi appeler de multiple fois le même plugin ne l'installera qu'une fois. -Plusieurs plugins fournient officiellement par Vue.js comme `vue-router` appel `Vue.use()` si `Vue` est disponible en tant que variable globale. Cependant, dans un environnement par module comme avec CommonJS, vous devrez toujours manuellement appeler `Vue.use()` : +Certains plugins fournis officiellement par Vue.js comme `vue-router` appelle `Vue.use()` si `Vue` est disponible en tant que variable globale. Cependant, dans un environnement par module comme avec CommonJS, vous devrez toujours manuellement appeler `Vue.use()` : ``` js // En utilisant CommonJS depuis Browserify ou webpack From e5a2147e93022d4a4b135da76dd55d7ba9bcb334 Mon Sep 17 00:00:00 2001 From: Bruno Lesieur Date: Thu, 22 Jun 2017 14:02:28 +0200 Subject: [PATCH 4/4] Ajout des retours de @forresst Signed-off-by: Bruno Lesieur --- src/v2/guide/plugins.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/src/v2/guide/plugins.md b/src/v2/guide/plugins.md index 6c4f7e638b..88eb59a771 100644 --- a/src/v2/guide/plugins.md +++ b/src/v2/guide/plugins.md @@ -6,19 +6,19 @@ order: 18 ## Écrire un plugin -Les plugins sont habituellement ajoutés au niveau des fonctionnalités globales de Vue. Il y a un cadre strictement défini pour un plugin, et il y a divers types de plugins que vous pouvez écrire pour : +Les plugins sont habituellement ajoutés au niveau des fonctionnalités globales de Vue. Il y a un cadre strictement défini pour un plugin et il y a divers types de plugins que vous pouvez écrire pour : 1. Ajouter plusieurs méthodes globales ou propriétés. Par ex. [vue-custom-element](https://github.com/karol-f/vue-custom-element) -2. Ajouter une ou plusieurs fonctionnalités : directives/filters/transitions, etc. Par ex. [vue-touch](https://github.com/vuejs/vue-touch) +2. Ajouter une ou plusieurs ressource global : directives, filters, transitions, etc. Par ex. [vue-touch](https://github.com/vuejs/vue-touch) 3. Ajouter plusieurs options de composant avec un mixin global. Par ex. [vuex](https://github.com/vuejs/vuex) -4. Ajouter plusieurs méthodes d'instance de Vue attachées au prototype de Vue. +4. Ajouter des méthodes d'instance de Vue en les reliant au prototype de Vue. -5. Fournir une bibliothèque avec sa propre API, qui injecte en même temps certains des éléments précédemment cités. Par ex. [vue-router](https://github.com/vuejs/vue-router) +5. Fournir une bibliothèque avec sa propre API, qui injecte en même temps certains éléments précédemment cités. Par ex. [vue-router](https://github.com/vuejs/vue-router) -Un plugin Vue.js doit exposer une méthode `install`. Cette méthode va être appelée avec le constructeur de `Vue` en tant que premier argument, avec les options possibles suivantes : +Un plugin Vue.js doit exposer une méthode `install`. Cette méthode sera appelée avec le constructeur de `Vue` en tant que premier argument, avec les options possibles suivantes : ``` js MyPlugin.install = function (Vue, options) { @@ -27,7 +27,7 @@ MyPlugin.install = function (Vue, options) { // de la logique de code... } - // 2. ajouter des fonctionnalités + // 2. ajouter une ressource global Vue.directive('my-directive', { bind (el, binding, vnode, oldVnode) { // de la logique de code... @@ -43,7 +43,7 @@ MyPlugin.install = function (Vue, options) { ... }) - // 4. ajouter des méthodes d'instance + // 4. ajouter une méthode d'instance Vue.prototype.$myMethod = function (options) { // de la logique de code... } @@ -65,9 +65,9 @@ Vous pouvez optionnellement passer certaines options : Vue.use(MyPlugin, { someOption: true }) ``` -`Vue.use` va automatiquement vous empécher d'utiliser plusieurs fois le même plugin, ainsi appeler de multiple fois le même plugin ne l'installera qu'une fois. +`Vue.use` empêchera automatiquement l'utilisation du même plugin plusieurs fois. Ainsi appeler de multiple fois le même plugin ne l'installera qu'une fois. -Certains plugins fournis officiellement par Vue.js comme `vue-router` appelle `Vue.use()` si `Vue` est disponible en tant que variable globale. Cependant, dans un environnement par module comme avec CommonJS, vous devrez toujours manuellement appeler `Vue.use()` : +Certains plugins fournis officiellement par Vue.js comme `vue-router` appelle automatiquement `Vue.use()` si `Vue` est disponible en tant que variable globale. Cependant, dans un environnement modulaire comme avec CommonJS, vous devrez toujours manuellement appeler `Vue.use()` : ``` js // En utilisant CommonJS depuis Browserify ou webpack