vue-chartjs
# vue-chartjs <img align="right" width="150" height="150" alt="vue-chartjs logo" src="https://raw.githubusercontent.com/apertureless/vue-chartjs/main/assets/vue-chartjs.png"> **vue-chartjs** is a wrapper for [Chart.js](https://github.com/chartjs/Chart.js) in Vue. You can easily create reuseable chart components. Supports Chart.js v4. [](https://badge.fury.io/js/vue-chartjs) [](https://codecov.io/gh/apertureless/vue-chartjs) [](https://github.com/apertureless/vue-chartjs/actions) [](http://packagequality.com/#?package=vue-chartjs) [](https://www.npmjs.com/package/vue-chartjs) [](https://gitter.im/vue-chartjs/Lobby) [](https://github.com/apertureless/vue-chartjs/blob/master/LICENSE.txt) [](https://cdnjs.com/libraries/vue-chartjs) [](https://snyk.io/test/github/apertureless/vue-chartjs) [](https://www.paypal.me/apertureless/50eur) [](https://ko-fi.com/C0C1WP7C) <br /> <a href="#quickstart">QuickStart</a> <span> β’ </span> <a href="#docs">Docs</a> <span> β’ </span> <a href="https://stackoverflow.com/questions/tagged/vue-chartjs">Stack Overflow</a> <br /> <hr /> ## Quickstart Install this library with peer dependencies: ```bash pnpm add vue-chartjs chart.js # or yarn add vue-chartjs chart.js # or npm i vue-chartjs chart.js ``` Then, import and use individual components: ```vue <template> <Bar :data="data" :options="options" /> </template> <script lang="ts"> import { Chart as ChartJS, Title, Tooltip, Legend, BarElement, CategoryScale, LinearScale } from 'chart.js' import { Bar } from 'vue-chartjs' ChartJS.register(CategoryScale, LinearScale, BarElement, Title, Tooltip, Legend) export default { name: 'App', components: { Bar }, data() { return { data: { labels: ['January', 'February', 'March'], datasets: [{ data: [40, 20, 12] }] }, options: { responsive: true } } } } </script> ``` <hr /> Need an API to fetch data? Consider [Cube](https://cube.dev/?ref=eco-vue-chartjs), an open-source API for data apps. <br /> [](https://cube.dev/?ref=eco-vue-chartjs) ## Docs - [Reactivity](https://vue-chartjs.org/guide/#updating-charts) - [Access to Chart instance](https://vue-chartjs.org/guide/#access-to-chart-instance) - [Accessibility](https://vue-chartjs.org/guide/#accessibility) - [Migration from v4 to v5](https://vue-chartjs.org/migration-guides/#migration-from-v4-to-v5/) - [Migration from vue-chart-3](https://vue-chartjs.org/migration-guides/#migration-from-vue-chart-3/) - [API](https://vue-chartjs.org/api/) - [Examples](https://vue-chartjs.org/examples/) ## Build Setup ``` bash # install dependencies pnpm install # build for production with minification pnpm build # run unit tests pnpm test:unit # run all tests pnpm test ``` ## Contributing 1. Fork it ( https://github.com/apertureless/vue-chartjs/fork ) 2. Create your feature branch (`git checkout -b my-new-feature`) 3. Commit your changes (`git commit -am 'Add some feature'`) 4. Push to the branch (`git push origin my-new-feature`) 5. Create a new Pull Request ## License This software is distributed under [MIT license](LICENSE.txt). <a href="https://www.buymeacoffee.com/xcqjaytbl" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/purple_img.png" alt="Buy Me A Coffee" style="height: auto !important;width: auto !important;" ></a>