by Alan Kang (@alankang)
DViz is a declarative data visualization library written in Javascript.
See live example on tumblr.
I coined the term declarative data visualization to describe a way of embedding visual representations such as sparklines or conventional statistical charts into HTML document without using the hand-written scripts or graph drawing tools.
All you need to do is writing a plain HTML document. DViz then automatically detects data elements embedded in the document and turns them into cognitively efficient visualizations on the fly.
Paste following code into the <head> element of your HTML:
<link rel="stylesheet" href="http://akngs.github.com/dviz/css/dviz.css" />
<script type="text/javascript" src="http://code.jquery.com/jquery-1.8.0.min.js"></script>
<script type="text/javascript" src="http://twitter.github.com/bootstrap/assets/js/bootstrap.min.js"></script>
<script type="text/javascript" src="http://akngs.github.com/dviz/js/dviz.js"></script>
<script type="text/javascript">$(function() {dviz.run();});</script>
Or you can add ?autorun=true parameter instead of direct call to dviz.run:
<link rel="stylesheet" href="http://akngs.github.com/dviz/css/dviz.css" />
<script type="text/javascript" src="http://code.jquery.com/jquery-1.8.0.min.js"></script>
<script type="text/javascript" src="http://twitter.github.com/bootstrap/assets/js/bootstrap.min.js"></script>
<script type="text/javascript" src="http://akngs.github.com/dviz/js/dviz.js?autorun=true"></script>
And add dviz-content class to somewhere in the <body> tag. DViz will scan and process all elements in there:
<div class="dviz-content"> ... </div>
Now you can do some magic. Add following code into dviz-content area:
<p>Here goes sparkline: <code>1,3,6,3,5,2,4 (@sparkline)</p>
It will replace the <code> element into a sparkline.
Or you can draw a bar chart:
<pre>
<code>
Name, A, B
Apple, 1323, 1232
Orange, 3563, 2452
Banana, 1356, 3222
</code>
</pre>
<p><code>(@bar)</code></p>
DViz currently supports following declarations:
- scatter (scatter plot)
- scattermatrix (scatter plot matrix)
- bar (horizontal bar chart)
- line (line chart)
- column (vertical bar chart)
- area (area chart)
- steppedarea (stepped area chart)
- sparkline (sparkline)
- table (table chart)
- graph (force-directed graph)
See following examples:
- jQuery (required)
- twitter-bootstrap (required)
- D3 (optional to render sparkline)
- Google Visualization API (optional to render core charts)
You can explicitly load optional javascript files using script tags, but you
can also let DViz to load them when they are needed.
DViz supports all major modern browsers including:
- Safari (and Mobile Safari)
- Chrome
- Firefox
- Opera
- Internet Explorer 9+
Licensed under the MIT license.