[dojo-contributors] Chart Markup Proposal
bookstack at gmail.com
Fri Aug 31 13:47:18 EDT 2007
These are my two cent when I worked towards integrating dojox.gfx3d into chart:
Chart is more complicated than my expectation, I took two desktop
applications as the examples: Excel, the programming language in
business world, and SigmaPlot, a commercial plot utility commonly used
If we would like to take 3D chart into account, the Z-axis is added
for values, and X-axis, Y-axis for series, otherwise, X-axis holds
series, Y-axis stands for the value. The chart is composed in the
Title: title of the chart, x-axis, y-axis, z-axis
more attributes: font, rotation, pos
Axis: x, y, z
more attributes: line style and direction.
Tick: major tick, minor tick of x, y, z
more attributes: linear, logarithm
Wall: aka the background of the 2D chart
more attributes: color
more attributes: color, line style, consider a oscilloscope
Series: series holds the real data, for pie chart, one value is one series.
fillStyle, used later for lighting;
name: used for legend, if it is missing, the default naming
scheme is S0, S1...
Data marker: mark the value of the series
Advanced users may request to put two non-relevant series in one chart
with two Z-axis, for example, running time and speed up (God bless
Personally I prefer KISS, the chart just exposes minimum but complete
attributes to the users, and the default implementation fits for most
of normal users. if the users want more control, write the code.
The minimum set of description of a chart is:
type: which chart type are you using?
title: chart title, x, y, z titles
width, height: dimension of the chart, (including the legend, axes)
bindings: the series with name attribute.
onUpdate. -- update functionality
The chart itself would figure out the range of x, y, z, tick, use
auto-generated fillStyle, default lighting source to render the chart,
use the series names and fillStyles to render legend.
No idea about the zoom/pan, since I am not quite sure about the
requirement so far.
More information about the dojo-contributors