Skip to content

Commit 3451769

Browse files
committed
French translation for README.md
1 parent 7e5bf7d commit 3451769

File tree

1 file changed

+290
-0
lines changed

1 file changed

+290
-0
lines changed

docs/fr-fr/README.md

Lines changed: 290 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,290 @@
1+
<div align="center">
2+
<img width="256" heigth="256" src="../assets/vue-chartjs.png" alt="vue-chartjs logo">
3+
</div>
4+
5+
[![npm version](https://badge.fury.io/js/vue-chartjs.svg)](https://badge.fury.io/js/vue-chartjs)
6+
[![codecov](https://codecov.io/gh/apertureless/vue-chartjs/branch/master/graph/badge.svg)](https://codecov.io/gh/apertureless/vue-chartjs)
7+
[![Build Status](https://travis-ci.org/apertureless/vue-chartjs.svg?branch=master)](https://travis-ci.org/apertureless/vue-chartjs)
8+
[![Package Quality](http://npm.packagequality.com/shield/vue-chartjs.svg)](http://packagequality.com/#?package=vue-chartjs)
9+
[![npm](https://img.shields.io/npm/dm/vue-chartjs.svg)](https://www.npmjs.com/package/vue-chartjs)
10+
[![Gitter chat](https://img.shields.io/gitter/room/TechnologyAdvice/Stardust.svg)](https://gitter.im/vue-chartjs/Lobby)
11+
[![license](https://img.shields.io/github/license/mashape/apistatus.svg)](https://github.com/apertureless/vue-chartjs/blob/master/LICENSE.txt)
12+
[![CDNJS version](https://img.shields.io/cdnjs/v/vue-chartjs.svg)](https://cdnjs.com/libraries/vue-chartjs)
13+
14+
# vue-chartjs
15+
16+
**vue-chartjs** est un wrapper vue pour [Chart.js](https://github.com/chartjs/Chart.js). Vous pouvez facilement créer des composants graphiques réutilisables.
17+
18+
## Demo & Docs
19+
20+
- 📺 [Demo](http://demo.vue-chartjs.org/)
21+
- 📖 [Docs](http://www.vue-chartjs.org/)
22+
23+
### Compatibilité
24+
25+
- v1 later `@legacy`
26+
- Vue.js 1.x
27+
- v2 later
28+
- Vue.js 2.x
29+
30+
Après la sortie de la version finale de vue.js 2, vous obtiendrez la version 2 par défaut lorsque vous installerez vue-chartjs avec npm.
31+
Plus besoin du marqueur @next désormais. Si vous souhaitez la v1, vous devrez indiquer explicitement la version, ou utiliser le marqieur legacy.
32+
Si vous cherchez la v1, rendez-vous sur cette [branche](https://github.com/apertureless/vue-chartjs/tree/release/1.x).
33+
34+
## Installation
35+
36+
Lancez simplement la commande `yarn add vue-chartjs chart.js`
37+
38+
Ou si vous souhaitez l'utiliser directement dans votre navigateur, ajoutez
39+
40+
```html
41+
<script src="https://unpkg.com/vue-chartjs/dist/vue-chartjs.full.min.js"></script>
42+
```
43+
à vos scripts. Voir sur [Codepen](https://codepen.io/apertureless/pen/vxWbqB?editors=1010)
44+
45+
## Explication sur les différents builds
46+
47+
Il y a trois builds différents. Tout dépend
48+
There are three different entry points. Tout dépend de la configuration que vous utilisez. Les dépendances sont soit intégrées au build, soit requises en tant que peerDependency :
49+
50+
- Browser
51+
- Browserify / Webpack 1
52+
- Webpack 2
53+
54+
55+
| Build | Chart.js | Vue.js |
56+
|---|---|---|
57+
| vue-chartjs.full.js | Intégré | Intégré |
58+
| vue-chartjs.full.min.js | Intégré | Intégré |
59+
| vue-chartjs.js | peerDependency | peerDependency |
60+
| vue-chartjs.min.js | peerDependency | peerDependency |
61+
| es/index* | peerDependency | peerDependency |
62+
63+
### Browser
64+
65+
Vous pouvez utiliser `vue-chartjs` directement depuis votre navigateur sans aucun pré-requis. Comme par exemple sur ce [codepen](https://codepen.io/apertureless/pen/vxWbqB?editors=1010). Dans une telle situation, veuillez utiliser `vue-chartjs.full.min.js`, qui est la version compressée. Elle intègre Vue.js et Chart.js, et est bundlée à un module UMD. Donc ce fichier se suffit à lui-même.
66+
67+
68+
### Browserify / Webpack 1
69+
70+
Si vous utilisez Gulp, Browserify ou Webpack 1, vous devrez prendre `vue-chartjs.js`, qui est __transpilé__ et __bundlé__ comme module UMD.
71+
72+
Toutefois, Vue.js et Chart.js sont des `peerDependencies`, vous devrez donc les installer séparemment. Dans la plupart des projets, `Vue.js` sera de toute façon déjà installé. De cette manière, vous pouvez utiliserdes versions différentes de Vue.js et Chart.js dans un même package.
73+
74+
### Webpack 2
75+
76+
Si vous utilisez Webpack 2, `jsnext:main` / `module` sera automatiquement sélectionné. `es/index.js`est une version es __transpilée__ des sources, et n'est pas __bundlée__ à un module. Ainsi, rien ne devrait bloquer l'élimination de code mort. Comme dans la version bundlée précédente, `Vue.js` et `Chart.js` sont des `peerDependencies` et doivent être installés.
77+
78+
79+
## Comment faire
80+
81+
Vous devez importer l'objet graphe de base et l'étendre. Cette opération permet d'offrir beaucoup plus de flexibilité lorsque plusieurs sources de données sont utilisées. Vous pouvez passer les données via props ou vue-resource.
82+
83+
Vous pouvez choisir d'importer le package dans son intégralité, ou chaque composant individuellement.
84+
85+
```javascript
86+
import VueCharts from 'vue-chartjs'
87+
import { Bar, Line } from 'vue-chartjs'
88+
```
89+
90+
Créez simplement votre composant.
91+
92+
```javascript
93+
// GraphiqueCommits.js
94+
import { Bar } from 'vue-chartjs'
95+
96+
export default Bar.extend({
97+
mounted () {
98+
// Surcharge de la méthode render avec les données.
99+
this.renderChart({
100+
labels: ['Janvier', 'Février', 'Mars', 'Avril', 'Mai', 'Juin', 'Juillet', 'Août', 'Septembre', 'Octobre', 'Novembre', 'Décembre'],
101+
datasets: [
102+
{
103+
label: 'Commits GitHub',
104+
backgroundColor: '#f87979',
105+
data: [40, 20, 12, 39, 10, 40, 39, 80, 40, 20, 12, 11]
106+
}
107+
]
108+
})
109+
}
110+
})
111+
```
112+
113+
Il ne vous reste qu'à importer et utiliser votre propre composant comme un composant vue classique.
114+
115+
```javascript
116+
import GraphiqueCommits from 'chemin/vers/composant/GraphiqueCommits'
117+
```
118+
119+
## Autre exemple avec options
120+
121+
Vous pouvez surcharger les options par défaut du graphique. Indiquez simplement un objet options en tant que second paramètre de la méthode render.
122+
123+
```javascript
124+
// RevenuMensuel.js
125+
import { Line } from 'vue-chartjs'
126+
127+
export default Line.extend({
128+
props: ['data', 'options'],
129+
mounted () {
130+
this.renderChart(this.data, this.options)
131+
}
132+
})
133+
```
134+
135+
Utilisez-le dans votre application Vue :
136+
137+
```javascript
138+
import RevenuMensuel from 'chemin/vers/composant/RevenuMensuel'
139+
140+
<template>
141+
<revenu-mensuel :data={....} />
142+
</template>
143+
144+
<script>
145+
export default {
146+
components: { RevenuMensuel },
147+
....
148+
}
149+
</script>
150+
```
151+
152+
## Mises à jour des données
153+
154+
Chart.js ne donne pas de mécanisme de mise à jour automatique si jamais vous deviez modifier vos jeux de données. Vous pouvez cependant implémenter le mécanisme facilement à l'aide de l'un de deux mixins inclus :
155+
156+
- `reactiveProp`
157+
- `reactiveData`
158+
159+
Tous deux sont inclus dans le module `mixins`.
160+
161+
Ces mixins crée automatiquement `chartData` en tant que prop ou donnée, ainsi qu'un watcher. Si la donnée est modifiée, le graphique sera actualisé.
162+
Veuillez cependant garder à l'esprit les limitations de vue et de javascript sur les propriétés de mutabilité des tableaux et objets. Plus d'infos [ici](http://vue-chartjs.org/#/home?id=reactive-data).
163+
164+
```javascript
165+
// RevenuMensuel.js
166+
import { Line, mixins } from 'vue-chartjs'
167+
168+
export default Line.extend({
169+
mixins: [mixins.reactiveProp],
170+
props: ['chartData', 'options'],
171+
mounted () {
172+
this.renderChart(this.chartData, this.options)
173+
}
174+
})
175+
176+
```
177+
178+
### Module Mixins
179+
Le module `mixins` est inclu dans le module`VueCharts` et tant que module séparé.
180+
Différentes manières de les importer :
181+
182+
```javascript
183+
// Importe le module en entier avec tous les diagrammes
184+
import VueCharts from 'vue-chartjs'
185+
186+
export default VueCharts.Line.extend({
187+
mixins: [VueCharts.mixins.reactiveProp],
188+
props: ['chartData', 'options'],
189+
mounted () {
190+
this.renderChart(this.chartData, this.options)
191+
}
192+
})
193+
```
194+
195+
```javascript
196+
// Importe les modules individuellement
197+
import { Line, mixins } from 'vue-chartjs'
198+
199+
export default Line.extend({
200+
mixins: [mixins.reactiveProp],
201+
props: ['chartData', 'options'],
202+
mounted () {
203+
this.renderChart(this.chartData, this.options)
204+
}
205+
})
206+
```
207+
208+
```javascript
209+
// Importe les modules individuellement, avec assignation
210+
import { Line, mixins } from 'vue-chartjs'
211+
const { reactiveProp } = mixins
212+
213+
export default Line.extend({
214+
mixins: [reactiveProp],
215+
props: ['chartData', 'options'],
216+
mounted () {
217+
this.renderChart(this.chartData, this.options)
218+
}
219+
})
220+
```
221+
222+
## Diagrammes disponibles
223+
224+
### Colonnes
225+
226+
![Colonnes](../assets/bar.png)
227+
228+
### Ligne
229+
230+
![Ligne](../assets/line.png)
231+
232+
### Beignet
233+
234+
![Beignet](../assets/doughnut.png)
235+
236+
### Circulaire
237+
238+
![Circulaire](../assets/pie.png)
239+
240+
### Radar
241+
242+
![Radar](../assets/radar.png)
243+
244+
### Polaire
245+
246+
![Plaire](../assets/polar.png)
247+
248+
### Bulles
249+
250+
![Bulles](../assets/bubble.png)
251+
252+
### Nuages de points
253+
254+
![Nuage de points](../assets/scatter.png)
255+
256+
## Installation
257+
258+
``` bash
259+
# installation des dépendances
260+
npm install
261+
262+
# sert sur localhost:8080 avec rechargement auto
263+
npm run dev
264+
265+
# build production avec compression
266+
npm run build
267+
268+
# exécution des tests unitaires
269+
npm run unit
270+
271+
# exécution des tests e2e
272+
npm run e2e
273+
274+
# exécution de tous les tests
275+
npm test
276+
```
277+
278+
Pour une explication détaillée du fonctionnement, vous pouvez lire le [guide](http://vuejs-templates.github.io/webpack/) ainsi que la [documentation pour vue-loader](http://vuejs.github.io/vue-loader).
279+
280+
## Contribution
281+
282+
1. Forkez ( https://github.com/apertureless/vue-chartjs/fork )
283+
2. Créez la branche pour votre fonctionnalité (`git checkout -b my-new-feature`)
284+
3. Commitez vos modifications (`git commit -am 'Add some feature'`)
285+
4. Pushez sur la branche (`git push origin my-new-feature`)
286+
5. Créez une nouvelle Pull Request
287+
288+
## Licence
289+
290+
Ce logiciel est distribué sous [licence MIT](LICENSE.txt).

0 commit comments

Comments
 (0)