Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/peopledoc/django-chartjs
Django Class Based Views to generate Ajax charts js parameters.
https://github.com/peopledoc/django-chartjs
approved-public ghec-mig-migrated
Last synced: 13 days ago
JSON representation
Django Class Based Views to generate Ajax charts js parameters.
- Host: GitHub
- URL: https://github.com/peopledoc/django-chartjs
- Owner: peopledoc
- License: other
- Created: 2013-06-11T09:21:40.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2024-04-11T11:51:18.000Z (7 months ago)
- Last Synced: 2024-08-09T23:01:51.988Z (3 months ago)
- Topics: approved-public, ghec-mig-migrated
- Language: JavaScript
- Homepage:
- Size: 621 KB
- Stars: 404
- Watchers: 34
- Forks: 112
- Open Issues: 5
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGELOG.rst
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Authors: AUTHORS
Awesome Lists containing this project
- awesome - django-chartjs
README
Django Chartjs
##############
Django Chartjs lets you manage charts in your Django application.
.. image:: https://travis-ci.org/peopledoc/django-chartjs.svg?branch=master
:target: https://travis-ci.org/peopledoc/django-chartjs
.. image:: https://coveralls.io/repos/peopledoc/django-chartjs/badge.png?branch=master&style=flat
:target: https://coveralls.io/r/peopledoc/django-chartjs?branch=master
.. image:: https://img.shields.io/pypi/v/django-chartjs.svg
:target: https://pypi.python.org/pypi/django-chartjs/
This is compatible with Chart.js and Highcharts JS libraries.
Using a set of predefined Class Based Views you are able to get
started after writing just your SQL query.
* Authors: Rémy Hubscher and `contributors
`_
* Licence: BSD
* Compatibility: Django 1.10, 2.2 and 3.0, python3.6 up to python3.8
* Project URL: https://github.com/peopledoc/django-chartjs
Getting Started
===============
Install django-chartjs::
pip install django-chartjs
Add it to your ``INSTALLED_APPS`` settings::
INSTALLED_APPS = (
'...',
'chartjs',
)
Using it
========
A simple Line Chart example.
1. Create the HTML file
+++++++++++++++++++++++
.. code-block:: html
{% load static %}
django-chartjs line chart demo
Some Line Charts loaded in Ajax!
$.get('{% url "line_chart_json" %}', function(data) {
var ctx = $("#myChart").get(0).getContext("2d");
new Chart(ctx, {
type: 'line', data: data
});
});
2. Create the view with labels and data definition
++++++++++++++++++++++++++++++++++++++++++++++++++
.. code-block:: python
from django.views.generic import TemplateView
from chartjs.views.lines import BaseLineChartView
class LineChartJSONView(BaseLineChartView):
def get_labels(self):
"""Return 7 labels for the x-axis."""
return ["January", "February", "March", "April", "May", "June", "July"]
def get_providers(self):
"""Return names of datasets."""
return ["Central", "Eastside", "Westside"]
def get_data(self):
"""Return 3 datasets to plot."""
return [[75, 44, 92, 11, 44, 95, 35],
[41, 92, 18, 3, 73, 87, 92],
[87, 21, 94, 3, 90, 13, 65]]
line_chart = TemplateView.as_view(template_name='line_chart.html')
line_chart_json = LineChartJSONView.as_view()
3. Update urls.py with the new urls for TemplateView and AJAX call 'line_chart_json' as in chart.html
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
.. code-block:: python
from .views import line_chart, line_chart_json
urlpatterns = [
'...',
path('chart', line_chart, name='line_chart'),
path('chartJSON', line_chart_json, name='line_chart_json'),
]
4. Get a Chart.js Line Chart
++++++++++++++++++++++++++++
.. image:: https://raw.github.com/peopledoc/django-chartjs/master/docs/_static/django-chartjs.png
It is that simple!
For other examples including a HighCharts line chart, don't hesitate to look at the demo project.
Also, feel free to contribute your demo!