When it comes to charting on the web, there are two main heavy-hitters: D3.js and Chart.js. But sometimes you don’t need a 500 pound gorilla. Sometimes you just want simple SVG charts that do exactly what you expect. That’s where Frappe Charts fits in. It’s a tiny, vanilla JS library that provides full-featured, animated, interactive SVG charts. And with a simple component wrapper, you can use it with Vue.js!
Getting Started
Start off by installing vue2-frappe. (I’m assuming you’ve already got a Vue.js project up and running.)
$ npm install --save vue2-frappeNext, enable the plugin. (All it does is register the component.)
import Vue from 'vue';import VueFrappe from 'vue2-frappe';import App from './App.vue';Vue.use(VueFrappe);new Vue({ el: '#app', render: h = h(App)});Making Charts
vue2-frappe is a simple wrapper for Frappe Charts that simply provides the configuration options to frappe as component properties. You you can directly use Frappe Chart’s documentation by changing top-level option keys into Vue.js property bindings.
App.vue
template div h2Chart: Benedict's Weight/h2 !-- id - Every chart must have an id. -- !-- title - The title displayed on the chart -- !-- type - The type of chart: line, bar, percent, pie, or axis-mixed. -- !-- labels - Names for each value on the x-axis. -- !-- height- Optional: How tall the chart should be. -- !-- colors - Separate colors for each dataset. -- !-- lineOptions - Additional options for how to display line charts. See docs. -- !-- datasets - An array of objects containing names and values for each data set. -- vue-frappe type="line" :labels="['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']" :height="650" :colors="['#008F68', '#FAE042']" :lineOptions="{regionFill: 1}" :datasets="[ {name: '2017', values: benedictsWeight2017}, {name: '2018', values: benedictsWeight2018} ]" /vue-frappe pConclusion: Benedict needs to go on a diet./p /div/templatescriptexport default { name: 'app', data() { return { benedictsWeight2017: [480, 485, 491, 489, 485, 490, 497, 510, 512, 521, 530, 545], benedictsWeight2018: [540, 575, 570, 555, 572, 580, 585, 587, 588, 590, 592, 590] } }}/scriptThe above should result in a chart like the one below:
And that’s just the beginning. Frappe Charts supports a variety of other types of charts – pie charts, bar charts, percentage charts, heatmaps, and advanced line and mixed charts. Take a look at their documentation!