Skip to content

koaning/justcharts

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

justcharts

Just charts. Really.

The goal of this project is to make it incredibly easy to hack together a vegalite dashboard declaratively. The goal is that anything made in the vegalite editor can be copied into a static file with ease.

include

You can use jsDelivr to deliver the justcharts.js file via CDN. Note that you'll also need to have some vega dependencies around.

<script src="https://cdn.jsdelivr.net/npm/vega@5"></script>
<script src="https://cdn.jsdelivr.net/npm/vega-lite@5"></script>
<script src="https://cdn.jsdelivr.net/npm/vega-embed@6"></script>
<script src="https://cdn.jsdelivr.net/gh/koaning/justcharts/justcharts.js"></script>

usage

There are two main ways you can create just charts.

schema

You can create a vega based chart directly in html.

<vegachart schema-url="schemaone.json"></vegachart>

inline

Alternatively, you can also declare the vegalite-json definition inline in the vegachart component.

<vegachart style="width: 100%">
    {
        "data":{
            "url": "https://cdn.jsdelivr.net/gh/koaning/justcharts/bigmac.csv",
            "format": {
                "type": "csv"
            }
        },
        "mark": "line",
        "encoding": {
            "x": {"field": "date", "type": "temporal"},
            "y": {"field": "local_price", "type": "quantitative"},
            "color": {"field": "currency_code", "type": "nominal"}
        },
        "width": "container",
        "title": "hello there"
    }
</vegachart>

Note the "width":"container" setting. By doing this you're able to set the width/height of the chart directly from the <vegachart> html-style property. This is great for containers with relative widths.

demo

You can find a demo here.