greysun/django-altair

Altair widget for Django

Django altair

Django app that provide a simple template tag to render an altair chart into a django template.

Installation

Currently the django-altair is not yet on pypi. To install the library run

pip3 install .

Usage

INSTALLED_APPS = (
    ...,
    'django_altair',
)

In your view

from django.views.generic import TemplateView
from django.shortcuts import render
from vega_datasets import data

class IndexView(TemplateView):
    template_name = 'index.html'

    def get(self, request, *args, **kwargs):
        context = locals()
        source = data.cars()

        context['chart'] = alt.Chart(source).mark_circle().encode(
            x='Horsepower',
            y='Miles_per_Gallon',
            color='Origin'
        ).interactive()
        return render(request, self.template_name, context)

and in your template use

{% load django_altair %}

<div>
    {% render_chart chart %}
</div>

to render chart.

The following script-tags must be included

<script src="https://cdn.jsdelivr.net/npm//vega@3.2"></script>
<script src="https://cdn.jsdelivr.net/npm//vega-lite@2.4.1"></script>
<script src="https://cdn.jsdelivr.net/npm//vega-embed@3.0"></script>