Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/SauravKanchan/svelte-chartjs
svelte wrapper for chart.js
https://github.com/SauravKanchan/svelte-chartjs
Last synced: about 14 hours ago
JSON representation
svelte wrapper for chart.js
- Host: GitHub
- URL: https://github.com/SauravKanchan/svelte-chartjs
- Owner: SauravKanchan
- License: mit
- Created: 2020-05-21T17:07:08.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-10-21T00:46:22.000Z (24 days ago)
- Last Synced: 2024-11-08T20:58:41.547Z (5 days ago)
- Language: TypeScript
- Homepage: https://saurav.tech/mdbsvelte/?path=/story/charts--examples
- Size: 1.36 MB
- Stars: 304
- Watchers: 7
- Forks: 40
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome - svelte-chartjs
README
# svelte-chartjs
Svelte wrapper for [chart.js](https://www.chartjs.org/) Open for PRs and contributions!
[](https://badge.fury.io/js/svelte-chartjs)
[](https://app.fossa.com/projects/git%2Bgithub.com%2FSauravKanchan%2Fsvelte-chartjs?ref=badge_shield)
Install
•
Usage
•
Migration guide
•
Examples
•
Slack
•
Stack Overflow
## Install
Install this library with peer dependencies:
```bash
pnpm add svelte-chartjs chart.js
# or
yarn add svelte-chartjs chart.js
# or
npm i svelte-chartjs chart.js
```
Need an API to fetch data? Consider [Cube](https://cube.dev/?ref=eco-svelte-chartjs), an open-source API for data apps.
[](https://cube.dev/?ref=eco-svelte-chartjs)
## Usage
```svelte
import { Line } from 'svelte-chartjs'
```
### Custom Size
In order for Chart.js to obey the custom size you need to set `maintainAspectRatio` to false, example:
```svelte
```
## Migration from v1 to v2
With v2, this library introduces a number of breaking changes. In order to improve performance, offer new features, and improve maintainability, it was necessary to break backwards compatibility, but we aimed to do so only when worth the benefit.
### Change component import path
v1:
```javascript
import Line from 'svelte-chartjs/src/Line.svelte'
```
v2:
```javascript
import { Line } from 'svelte-chartjs'
```
### Tree-shaking
v2 of this library, [just like Chart.js v3](https://www.chartjs.org/docs/latest/getting-started/v3-migration.html#setup-and-installation), is tree-shakable. It means that you need to import and register the controllers, elements, scales, and plugins you want to use.
For a list of all the available items to import, see [Chart.js docs](https://www.chartjs.org/docs/latest/getting-started/integration.html#bundlers-webpack-rollup-etc).
v1:
```javascript
import Line from 'svelte-chartjs/src/Line.svelte'
```
v2 — lazy way:
```javascript
import { Line } from 'svelte-chartjs'
import 'chart.js/auto';
```
v2 — tree-shakable way:
```javascript
import { Line } from 'svelte-chartjs'
import { Chart as ChartJS, Title, Tooltip, Legend, LineElement, LinearScale, PointElement, CategoryScale } from 'chart.js';
ChartJS.register(Title, Tooltip, Legend, LineElement, LinearScale, PointElement, CategoryScale);
```
Using the "lazy way" is okay to simplify the migration, but please consider using the tree-shakable way to decrease the bundle size.
Please note that typed chart components register their controllers by default, so you don't need to register them by yourself. For example, when using the Pie component, you don't need to register PieController explicitly.
```javascript
import { Pie } from 'svelte-chartjs';
import { Chart as ChartJS, Title, Tooltip, Legend, ArcElement, CategoryScale } from 'chart.js'
ChartJS.register(Title, Tooltip, Legend, ArcElement, CategoryScale)
```
## Examples
- [Bar Chart](https://codesandbox.io/s/github/SauravKanchan/svelte-chartjs/tree/master/sandboxes/bar)
- [Bubble Chart](https://codesandbox.io/s/github/SauravKanchan/svelte-chartjs/tree/master/sandboxes/bubble)
- [Doughnut Chart](https://codesandbox.io/s/github/SauravKanchan/svelte-chartjs/tree/master/sandboxes/doughnut)
- [Line Chart](https://codesandbox.io/s/github/SauravKanchan/svelte-chartjs/tree/master/sandboxes/line)
- [Pie Chart](https://codesandbox.io/s/github/SauravKanchan/svelte-chartjs/tree/master/sandboxes/pie)
- [PolarArea Chart](https://codesandbox.io/s/github/SauravKanchan/svelte-chartjs/tree/master/sandboxes/polar)
- [Radar Chart](https://codesandbox.io/s/github/SauravKanchan/svelte-chartjs/tree/master/sandboxes/radar)
- [Scatter Chart](https://codesandbox.io/s/github/SauravKanchan/svelte-chartjs/tree/master/sandboxes/scatter)
- [ChartJS instance](https://codesandbox.io/s/github/SauravKanchan/svelte-chartjs/tree/master/sandboxes/ref)
- [Events handling](https://codesandbox.io/s/github/SauravKanchan/svelte-chartjs/tree/master/sandboxes/events)
## Docs for v1
Full Documentation and demo for v1 [here](https://saurav.tech/mdbsvelte/?path=/story/charts--installation)
## License
[](https://app.fossa.com/projects/git%2Bgithub.com%2FSauravKanchan%2Fsvelte-chartjs?ref=badge_large)