Metadata-Version: 2.4
Name: dash_chartjs
Version: 1.3.0
Summary: A Dash Component library for ChartJs.
Home-page: https://github.com/zenalytiks/dash-chartjs.git
Author: Waleed Malik <zenalytiks@gmail.com>
License: MIT
Classifier: Framework :: Dash
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: summary

# Dash Chartjs Component

[![Downloads](https://static.pepy.tech/badge/dash-chartjs)](https://pepy.tech/project/dash-chartjs)

Chart.js is one the most popular javascript charting library. 
Dash Chartjs Component is a Dash component library that renders [ChartJs React component](https://react-chartjs-2.js.org/) inside Dash App.

## Installation

```
pip install dash-chartjs
```

## Prop List
    
**id (str):** The ID used to identify this component in Dash callbacks.<br><br>
**type (str):** Chart.js chart type.<br><br>
**data (dict):** The data object that is passed into the Chart.js chart.<br><br>
**options (dict):** The options object that is passed into the Chart.js chart.<br><br>
**redraw (boolean):** Teardown and redraw chart on every update.<br><br>
**toolbox (boolean):** Toolbox with reset and download buttons for chart.<br><br>
**customJSFunctions (dict):** Write custom JS functions in dict format.<br><br>
**customPlugins (dict):** Write Plugins in dict format.<br><br>
**actions (dict):** List of action objects with name and handler properties. Each action will be rendered as a button below the chart.<br><br> 
**clickData (dict):** clickData returns the datasetIndex and index of data point clicked.<br><br>
**style (dict):** Defines CSS styles which will override styles previously set.<br><br>


## Basic Usage

```python
from dash import dash,html
import pandas as pd
from dash_chartjs import ChartJs

app = dash.Dash(__name__,meta_tags=[{"name": "viewport", "content": "width=device-width, initial-scale=1"}])

df = pd.read_csv('https://raw.githubusercontent.com/JetBlack101/visitors-to-georgia-ts-analysis/main/Data/VisitorsToGeorgia_2011-2019.csv')

df['Date'] = pd.to_datetime(df['Date'])

x = df['Date']
y = df['Visitors']

data = {
    'labels': x,
    'datasets': [{
        'label': 'Visitors to Georgia',
        'data': y,
        'fill':'false',
        'borderColor': 'rgb(75, 192, 192)',
        'tension': 0.1
    }]
}
options = {
    'scales': {
        'x': {
            'type':'time'
        }
    },
    'plugins':{
        'zoom':{
            'zoom':{
                'wheel':{
                    'enabled': True
                },
            'mode':'xy'
            }
        }
    } 
}


app.layout = html.Div(
    [
        ChartJs(type='line',data=data,options=options)
    ]
)

if __name__ == '__main__':
    app.run_server(debug=False)
```

## Demo

https://user-images.githubusercontent.com/31138706/192035295-0a10eb80-0881-443b-8ea8-7dfd98eb77f3.mp4

## Additional Plugins Integrated
### [chartjs-plugin-zoom](https://www.chartjs.org/chartjs-plugin-zoom/latest/)

### [chartjs-plugin-datalabels](https://chartjs-plugin-datalabels.netlify.app/)

**Example**
![datalables](https://github.com/zenalytiks/dash-chartjs/assets/31138706/f338eda9-4e0c-4128-ac72-972bbd488c6d)

### [chartjs-plugin-annotation](https://www.chartjs.org/chartjs-plugin-annotation/latest/)

**Example**
![annotations](https://github.com/zenalytiks/dash-chartjs/assets/31138706/1dec90df-69f9-4098-9b01-3f06d46248f1)

### [chartjs-chart-geo](https://www.sgratzl.com/chartjs-chart-geo/)

**Example**
![choropleth](https://user-images.githubusercontent.com/4129778/78821942-8b974700-79da-11ea-988d-142f7788ffe6.png)

### [chartjs-chart-boxplot](https://sgratzl.com/chartjs-chart-boxplot/)

**Example**
![boxplot](https://user-images.githubusercontent.com/4129778/42724341-9a6ec554-8770-11e8-99b5-626e34dafdb3.png)

### [chartjs-chart-matrix](https://chartjs-chart-matrix.pages.dev/)

**Example**
![matrix](https://github.com/user-attachments/assets/85f47936-b20b-4a5b-bcfc-ec9b49760467)

### [chartjs-chart-treemap](https://chartjs-chart-treemap.pages.dev/)

**Example**
![treemap](https://github.com/user-attachments/assets/bffcba23-9257-401f-aded-f6929dab3a45)

### [chartjs-chart-sankey](https://github.com/kurkle/chartjs-chart-sankey)

**Example**
![sankey](https://github.com/user-attachments/assets/6f094f22-d83a-41d9-bd0b-c62c6ee18046)

### [chartjs-chart-graph](https://sgratzl.com/chartjs-chart-graph/)

**Example**
![graph](https://user-images.githubusercontent.com/4129778/65398353-9bc03f80-dd84-11e9-8f14-339635c1ba4e.png)

### [chartjs-chart-pcp](https://sgratzl.com/chartjs-chart-pcp/)

**Example**
![pcp](https://user-images.githubusercontent.com/4129778/79225882-bad80900-7e5d-11ea-89cf-f59f30987882.png)





