add Chart.js packages
This commit is contained in:
parent
dae35f0e05
commit
c77c48133b
23 changed files with 13374 additions and 0 deletions
79
static/js/chartjs-adapter-date-fns/README.md
Normal file
79
static/js/chartjs-adapter-date-fns/README.md
Normal file
|
@ -0,0 +1,79 @@
|
|||
# chartjs-adapter-date-fns
|
||||
|
||||
[](https://github.com/chartjs/chartjs-adapter-date-fns/releases/latest) [](https://travis-ci.org/chartjs/chartjs-adapter-date-fns) [](https://github.com/chartjs/awesome)
|
||||
|
||||
## Overview
|
||||
|
||||
This adapter allows the use of date-fns with Chart.js.
|
||||
|
||||
Requires [Chart.js](https://github.com/chartjs/Chart.js/releases) **2.8.0** or later and [date-fns](https://date-fns.org/) **2.0.0** or later.
|
||||
|
||||
**Note:** once loaded, this adapter overrides the default date-adapter provided in Chart.js (as a side-effect).
|
||||
|
||||
## Installation
|
||||
|
||||
### npm
|
||||
|
||||
```bash
|
||||
npm install date-fns chartjs-adapter-date-fns --save
|
||||
```
|
||||
|
||||
```javascript
|
||||
import { Chart } from 'chart.js';
|
||||
import 'chartjs-adapter-date-fns';
|
||||
```
|
||||
|
||||
### CDN
|
||||
|
||||
By default, `https://cdn.jsdelivr.net/npm/chartjs-adapter-date-fns` returns the latest (minified) version, however it's [highly recommended](https://www.jsdelivr.com/features) to always specify a version in order to avoid breaking changes. This can be achieved by appending `@{version}` to the url:
|
||||
|
||||
```html
|
||||
<script src="https://cdn.jsdelivr.net/npm/chart.js/dist/chart.min.js"></script>
|
||||
<script src="https://cdn.jsdelivr.net/npm/chartjs-adapter-date-fns/dist/chartjs-adapter-date-fns.bundle.min.js"></script>
|
||||
```
|
||||
|
||||
Read more about jsDeliver versioning on their [website](http://www.jsdelivr.com/).
|
||||
|
||||
## Configuration
|
||||
|
||||
### Locale support via scale options
|
||||
|
||||
date-fns requires a date-fns locale object to be tagged on to each `format()` call, which requires the locale to be explicitly set via the `adapters.date` option: [Chart.js documentation on adapters.date](https://www.chartjs.org/docs/next/axes/cartesian/time#date-adapters)
|
||||
|
||||
For example:
|
||||
|
||||
```javascript
|
||||
// import date-fns locale:
|
||||
import {de} from 'date-fns/locale';
|
||||
|
||||
|
||||
// scale options:
|
||||
{
|
||||
adapters: {
|
||||
date: {
|
||||
locale: de
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Further, read the [Chart.js documentation](https://www.chartjs.org/docs/next) for other possible date/time related options. For example, the time scale [`time.*` options](https://www.chartjs.org/docs/next/axes/cartesian/time#configuration-options) can be overridden using the [date-fns tokens](https://date-fns.org/docs/format).
|
||||
|
||||
## Development
|
||||
|
||||
You first need to install node dependencies (requires [Node.js](https://nodejs.org/)):
|
||||
|
||||
```bash
|
||||
> npm install
|
||||
```
|
||||
|
||||
The following commands will then be available from the repository root:
|
||||
|
||||
```bash
|
||||
> npm run build // build dist files
|
||||
> npm run lint // perform code linting
|
||||
```
|
||||
|
||||
## License
|
||||
|
||||
`chartjs-adapter-date-fns` is available under the [MIT license](LICENSE.md).
|
Loading…
Add table
Add a link
Reference in a new issue