Chart"

From Documentation
 
(17 intermediate revisions by 5 users not shown)
Line 7: Line 7:
 
*JavaScript API: <javadoc directory="jsdoc">zul.wgt.Chart</javadoc>
 
*JavaScript API: <javadoc directory="jsdoc">zul.wgt.Chart</javadoc>
 
*Style Guide: N/A
 
*Style Guide: N/A
−
*[http://www.zkoss.org/product/edition.dsp JfreeChart Engine Available in ZK PE and EE only]
+
 
 +
{{ZK_PE}}
  
 
= Employment/Purpose =
 
= Employment/Purpose =
  
−
A <tt>chart</tt> is used to show a set of data as a graph. It helps users to judge things with a snapshot. To use a chart component , developers must prepare a <tt>ChartModel </tt>and a <tt>ChartEngine.</tt> Developers also set proper chart type, and the threeD (3D) attribute to draw proper chart. The model and type must match to each other; or the result is unpredictable. The 3D chart is not supported on all chart type.
+
A <code>chart</code> is used to show a set of data as a graph. It helps users to judge things with a snapshot. To use a chart component , developers must prepare a <code>ChartModel</code> and a <code>ChartEngine</code>. Developers also set proper chart type, and the threeD (3D) attribute to draw a proper chart. The model and type must match each other, or the result is unpredictable. The 3D chart is not supported on all chart types.
  
 
= Example =
 
= Example =
Line 475: Line 476:
 
     <zscript><![CDATA[
 
     <zscript><![CDATA[
 
HiLoModel hilomodel = new SimpleHiLoModel();
 
HiLoModel hilomodel = new SimpleHiLoModel();
−
long d = new Date().getTime();
+
long d = System.currentTimeMillis();
 
hilomodel.addValue(new Date(d),  new Double(45.5),  new Double(54.2), new Double(19.9), new Double(42.8), new Double(20));
 
hilomodel.addValue(new Date(d),  new Double(45.5),  new Double(54.2), new Double(19.9), new Double(42.8), new Double(20));
 
hilomodel.addValue(new Date(d+1000),  new Double(46.5),  new Double(55.2),  new Double(43.8), new Double(50.9),  new Double(32));
 
hilomodel.addValue(new Date(d+1000),  new Double(46.5),  new Double(55.2),  new Double(43.8), new Double(50.9),  new Double(32));
Line 507: Line 508:
 
     <zscript><![CDATA[
 
     <zscript><![CDATA[
 
HiLoModel hilomodel = new SimpleHiLoModel();
 
HiLoModel hilomodel = new SimpleHiLoModel();
−
long d = new Date().getTime();
+
long d = System.currentTimeMillis();
 
hilomodel.addValue(new Date(d),  new Double(45.5),  new Double(54.2), new Double(19.9), new Double(42.8), new Double(20));
 
hilomodel.addValue(new Date(d),  new Double(45.5),  new Double(54.2), new Double(19.9), new Double(42.8), new Double(20));
 
hilomodel.addValue(new Date(d+1000),  new Double(46.5),  new Double(55.2),  new Double(43.8), new Double(50.9),  new Double(32));
 
hilomodel.addValue(new Date(d+1000),  new Double(46.5),  new Double(55.2),  new Double(43.8), new Double(50.9),  new Double(32));
Line 595: Line 596:
  
 
==Gantt Chart==
 
==Gantt Chart==
−
[[Image:ZKComRef_Chart_Gantt.png]]  
+
[[Image:ZKComRef_Chart_Gantt.png]]
 +
<source lang="xml">
 +
<chart id="gantt" title="Gantt Chart" width="700" height="400"
 +
type="gantt" threeD="false" fgAlpha="128" dateFormat="yyyy/MM/dd" >
 +
    <zscript><![CDATA[
 +
import org.zkoss.zul.GanttModel.GanttTask;
 +
 +
public Date date(int year, int month, int day) {
 +
final java.util.Calendar calendar = java.util.Calendar.getInstance();
 +
calendar.set(year, month-1, day);
 +
final Date result = calendar.getTime();
 +
return result;
 +
}
 +
//series, task (task description, start, end, complete percentage)
 +
GanttModel ganttmodel = new GanttModel();
 +
ganttmodel.addValue("Scheduled", new GanttTask("Write Proposal", date(2008,4,1), date(2008,4,5), 0.0));
 +
ganttmodel.addValue("Scheduled", new GanttTask("Obtain Approval", date(2008,4,9), date(2008,4,9), 0.0));
 +
ganttmodel.addValue("Scheduled", new GanttTask("Requirements Analysis", date(2008,4,10), date(2008,5,5), 0.0));
 +
ganttmodel.addValue("Scheduled", new GanttTask("Design Phase", date(2008,5,6), date(2008,5,30), 0.0));
 +
ganttmodel.addValue("Scheduled", new GanttTask("Design Signoff", date(2008,6,2), date(2008,6,2), 0.0));
 +
ganttmodel.addValue("Scheduled", new GanttTask("Alpha Implementation", date(2008,6,3), date(2008,7,31), 0.0));
 +
ganttmodel.addValue("Scheduled", new GanttTask("Design Review", date(2008,8,1), date(2008,8,8), 0.0));
 +
ganttmodel.addValue("Scheduled", new GanttTask("Revised Design Signoff", date(2008,8,10), date(2008,8,10), 0.0));
 +
ganttmodel.addValue("Scheduled", new GanttTask("Beta Implementation", date(2008,8,12), date(2008,9,12), 0.0));
 +
ganttmodel.addValue("Scheduled", new GanttTask("Testing", date(2008,9,13), date(2008,10,31), 0.0));
 +
ganttmodel.addValue("Scheduled", new GanttTask("Final Implementation", date(2008,11,1), date(2008,11,15), 0.0));
 +
ganttmodel.addValue("Scheduled", new GanttTask("Signoff", date(2008,11,28), date(2008,11,30), 0.0));
 +
 +
ganttmodel.addValue("Actual", new GanttTask("Write Proposal", date(2008,4,1), date(2008,4,3), 0.0));
 +
ganttmodel.addValue("Actual", new GanttTask("Obtain Approval", date(2008,4,9), date(2008,4,9), 0.0));
 +
ganttmodel.addValue("Actual", new GanttTask("Requirements Analysis", date(2008,4,10), date(2008,5,15), 0.0));
 +
ganttmodel.addValue("Actual", new GanttTask("Design Phase", date(2008,5,15), date(2008,6,17), 0.0));
 +
ganttmodel.addValue("Actual", new GanttTask("Design Signoff", date(2008,6,30), date(2008,6,30), 0.0));
 +
ganttmodel.addValue("Actual", new GanttTask("Alpha Implementation", date(2008,7,1), date(2008,9,12), 0.0));
 +
ganttmodel.addValue("Actual", new GanttTask("Design Review", date(2008,9,12), date(2008,9,22), 0.0));
 +
ganttmodel.addValue("Actual", new GanttTask("Revised Design Signoff", date(2008,9,25), date(2008,9,27), 0.0));
 +
ganttmodel.addValue("Actual", new GanttTask("Beta Implementation", date(2008,8,12), date(2008,9,12), 0.0));
 +
ganttmodel.addValue("Actual", new GanttTask("Testing", date(2008,10,31), date(2008,11,17), 0.0));
 +
ganttmodel.addValue("Actual", new GanttTask("Final Implementation", date(2008,11,18), date(2008,12,5), 0.0));
 +
ganttmodel.addValue("Actual", new GanttTask("Signoff", date(2008,12,10), date(2008,12,11), 0.0));
 +
gantt.setModel(ganttmodel);
 +
    ]]></zscript>
 +
</chart>
 +
</source>
  
 
==Wind Chart==
 
==Wind Chart==
−
[[Image:ZKComRef_Chart_Wind.png]]
+
[[Image:ZKComRef_Chart_Wind.png]]
 +
<source lang="xml">
 +
<chart id="wind" title="Wind Plot" width="700" height="400"
 +
type="wind" threeD="false" fgAlpha="128" dateFormat="yyyy/MM/dd" >
 +
    <zscript><![CDATA[
 +
 +
public Date date(int year, int month, int day) {
 +
final java.util.Calendar calendar = java.util.Calendar.getInstance();
 +
calendar.set(year, month-1, day);
 +
final Date result = calendar.getTime();
 +
return result;
 +
}
 +
XYZModel windmodel = new SimpleXYZModel();
 +
//series, date, direction (0-12), force(0-12)
 +
windmodel.addValue("Wind!", new Long(date(2008, 1, 3).getTime()), new Double(0d), new Double(10.0));
 +
windmodel.addValue("Wind!", new Long(date(2008, 1, 4).getTime()), new Double(1d), new Double(8.5));
 +
windmodel.addValue("Wind!", new Long(date(2008, 1, 5).getTime()), new Double(2.0), new Double(10.0));
 +
windmodel.addValue("Wind!", new Long(date(2008, 1, 6).getTime()), new Double(3.0), new Double(10.0));
 +
windmodel.addValue("Wind!", new Long(date(2008, 1, 7).getTime()), new Double(4.0), new Double(7.0));
 +
windmodel.addValue("Wind!", new Long(date(2008, 1, 8).getTime()), new Double(5.0), new Double(10.0));
 +
windmodel.addValue("Wind!", new Long(date(2008, 1, 9).getTime()), new Double(6.0), new Double(8.0));
 +
windmodel.addValue("Wind!", new Long(date(2008, 1, 10).getTime()), new Double(7.0), new Double(11.0));
 +
windmodel.addValue("Wind!", new Long(date(2008, 1, 11).getTime()), new Double(8.0), new Double(10.0));
 +
windmodel.addValue("Wind!", new Long(date(2008, 1, 12).getTime()), new Double(9.0), new Double(11.0));
 +
windmodel.addValue("Wind!", new Long(date(2008, 1, 13).getTime()), new Double(10.0), new Double(3.0));
 +
windmodel.addValue("Wind!", new Long(date(2008, 1, 14).getTime()), new Double(11.0), new Double(9.0));
 +
windmodel.addValue("Wind!", new Long(date(2008, 1, 15).getTime()), new Double(12.0), new Double(11.0));
 +
windmodel.addValue("Wind!", new Long(date(2008, 1, 16).getTime()), new Double(0.0), new Double(0.0));
 +
wind.setModel(windmodel);
 +
    ]]></zscript>
 +
</chart>
 +
</source>
  
 
==Dial Chart==
 
==Dial Chart==
 
[[Image:ZKComRef_Chart_Dial.png]]
 
[[Image:ZKComRef_Chart_Dial.png]]
 +
<source lang="xml">
 +
<window onOK="doOK()" width="350px">
 +
<chart id="dial" title="Dial Plot" width="300" height="300" type="dial" threeD="false" fgAlpha="128">
 +
    <zscript><![CDATA[
 +
 +
import org.zkoss.zul.DialModel;
 +
    import org.zkoss.zul.DialModelScale;
 +
 +
    int val= 40;
 +
 +
DialModel dialmodel = new DialModel();
 +
DialModelScale scale = dialmodel.newScale(0.0, 100.0, -120.0, -300.0, 10.0, 4);//scale's configuration data
 +
scale.setText("Temperature");
 +
scale.newRange(80, 100, "#FF0000", 0.83, 0.89);
 +
scale.newRange(60, 80, "#FFC426", 0.83, 0.89);
 +
scale.setValue(val);
 +
 +
doOK() {
 +
val = dbx.getValue();
 +
if (val > 100) {
 +
val = 100;
 +
} else if (val < 0) {
 +
val = 0;
 +
}
 +
dbx.value = val;
 +
slx.curpos = val;
 +
scale.setValue(val);
 +
if (val > 80) {
 +
scale.setNeedleColor(scale.getRange(0).getRangeColor());
 +
} else if (val > 60) {
 +
scale.setNeedleColor(scale.getRange(1).getRangeColor());
 +
} else {
 +
scale.setNeedleColor(dialmodel.getFrameFgColor());
 +
}
 +
    }
 +
    dial.setModel(dialmodel);
 +
    ]]></zscript>
 +
</chart>
 +
<hbox>
 +
<slider id="slx" curpos="${val}" onScroll="dbx.value=self.curpos; doOK()"/>
 +
<intbox id="dbx" value="${val}" onChange="doOK()"/>
 +
</hbox>
 +
</window>
 +
</source>
  
 
= Properties =
 
= Properties =
 
== Type and Model ==
 
== Type and Model ==
  
−
{| border="1"
+
{| class='wikitable' | width="100%"
 
! <center>Type</center>
 
! <center>Type</center>
 
! <center>Model</center>
 
! <center>Model</center>
Line 612: Line 731:
  
 
|-
 
|-
−
| <center><tt>pie</tt></center>
+
| <center><code>pie</code></center>
−
| <tt>PieModel</tt>
+
| <code>PieModel</code>
−
| <center><tt>o</tt></center>
+
| <center><code>o</code></center>
  
 
|-
 
|-
−
| <center><tt>ring</tt></center>
+
| <center><code>ring</code></center>
−
| <tt>PieModel</tt>
+
| <code>PieModel</code>
−
| <center><tt>x</tt></center>
+
| <center><code>x</code></center>
  
 
|-
 
|-
−
| <center><tt>bar</tt></center>
+
| <center><code>bar</code></center>
−
| <tt>CategoryModel </tt>or<tt> XYModel</tt>
+
| <code>CategoryModel </code>or<code> XYModel</code>
−
| <center><tt>o</tt></center>
+
| <center><code>o</code></center>
  
 
|-
 
|-
−
| <center><tt>line</tt></center>
+
| <center><code>line</code></center>
−
| <tt>CategoryModel </tt>or<tt> XYModel</tt>
+
| <code>CategoryModel </code>or<code> XYModel</code>
−
| <center><tt>o</tt></center>
+
| <center><code>o</code></center>
  
 
|-
 
|-
−
| <center><tt>area</tt></center>
+
| <center><code>area</code></center>
−
| <tt>CategoryModel </tt>or<tt> XYModel</tt>
+
| <code>CategoryModel </code>or<code> XYModel</code>
−
| <center><tt>x</tt></center>
+
| <center><code>x</code></center>
  
 
|-
 
|-
−
| <center><tt>stacked_bar </tt></center>
+
| <center><code>stacked_bar </code></center>
−
| <tt>CategoryModel</tt>
+
| <code>CategoryModel</code>
−
| <center><tt>o</tt></center>
+
| <center><code>o</code></center>
  
 
|-
 
|-
−
| <center><tt>stacked_area </tt></center>
+
| <center><code>stacked_area </code></center>
−
| <tt>CategoryModel </tt>or<tt> XYModel</tt>
+
| <code>CategoryModel </code>or<code> XYModel</code>
−
| <center><tt>x</tt></center>
+
| <center><code>x</code></center>
  
 
|-
 
|-
−
| <center><tt>waterfall </tt></center>
+
| <center><code>waterfall </code></center>
−
| <tt>CategoryModel</tt>
+
| <code>CategoryModel</code>
−
| <center><tt>x</tt></center>
+
| <center><code>x</code></center>
  
 
|-
 
|-
−
| <center><tt>polar </tt></center>
+
| <center><code>polar </code></center>
−
| <tt>XYModel</tt>
+
| <code>XYModel</code>
 
| <center>x</center>
 
| <center>x</center>
  
 
|-
 
|-
−
| <center><tt>scatter </tt></center>
+
| <center><code>scatter </code></center>
−
| <tt>XYModel</tt>
+
| <code>XYModel</code>
 
| <center>x</center>
 
| <center>x</center>
  
 
|-
 
|-
−
| <center><tt>time_series </tt></center>
+
| <center><code>time_series </code></center>
−
| <tt>XYModel</tt>
+
| <code>XYModel</code>
 
| <center>x</center>
 
| <center>x</center>
  
 
|-
 
|-
−
| <center><tt>polar </tt></center>
+
| <center><code>polar </code></center>
−
| <tt>XYModel</tt>
+
| <code>XYModel</code>
 
| <center>x</center>
 
| <center>x</center>
  
 
|-
 
|-
−
| <center><tt>step_area </tt></center>
+
| <center><code>step_area </code></center>
−
| <tt>XYModel</tt>
+
| <code>XYModel</code>
 
| <center>x</center>
 
| <center>x</center>
  
 
|-
 
|-
−
| <center><tt>step </tt></center>
+
| <center><code>step </code></center>
−
| <tt>XYModel</tt>
+
| <code>XYModel</code>
 
| <center>x</center>
 
| <center>x</center>
  
 
|-
 
|-
−
| <center><tt>histogram </tt></center>
+
| <center><code>histogram </code></center>
−
| <tt>XYModel</tt>
+
| <code>XYModel</code>
 
| <center>x</center>
 
| <center>x</center>
  
 
|-
 
|-
−
| <center><tt>bubble </tt></center>
+
| <center><code>bubble </code></center>
−
| <tt>XYModel</tt>
+
| <code>XYModel</code>
 
| <center>x</center>
 
| <center>x</center>
  
 
|-
 
|-
−
| <center><tt>wind </tt></center>
+
| <center><code>wind </code></center>
−
| <tt>XYModel</tt>
+
| <code>XYModel</code>
 
| <center>x</center>
 
| <center>x</center>
  
 
|-
 
|-
−
| <center><tt>candlestick </tt></center>
+
| <center><code>candlestick </code></center>
−
| <tt>HiLoModel</tt>
+
| <code>HiLoModel</code>
 
| <center>x</center>
 
| <center>x</center>
  
 
|-
 
|-
−
| <center><tt>highlow</tt></center>
+
| <center><code>highlow</code></center>
−
| <tt>HiLoModel</tt>
+
| <code>HiLoModel</code>
 
| <center>x</center>
 
| <center>x</center>
  
 
|-
 
|-
−
| <center><tt>wafermap</tt></center>
+
| <center><code>wafermap</code></center>
−
| <tt>WaferMapModel</tt>
+
| <code>WaferMapModel</code>
 
| <center>x</center>
 
| <center>x</center>
  
 
|-
 
|-
−
| <center><tt>gantt</tt></center>
+
| <center><code>gantt</code></center>
−
| <tt>GanttModel</tt>
+
| <code>GanttModel</code>
 
| <center>x</center>
 
| <center>x</center>
  
 
|-
 
|-
−
| <center><tt>dial</tt></center>
+
| <center><code>dial</code></center>
−
| <tt>DialModel</tt>
+
| <code>DialModel</code>
 
| <center>x</center>
 
| <center>x</center>
  
 
|}
 
|}
  
−
== The onClick Event ==
+
= Clicked Area: Series, Legend =
−
Denotes user has clicked the component.
+
In an onClick listener, you can call <javadoc method="getX()">org.zkoss.zk.ui.event.MouseEvent</javadoc> and <javadoc method="getY()">org.zkoss.zk.ui.event.MouseEvent</javadoc> to get coordinates.
−
Use <javadoc method="getX()">org.zkoss.zk.ui.event.MouseEvent</javadoc> and <javadoc method="getY()">org.zkoss.zk.ui.event.MouseEvent</javadoc> method to get coordinates.
 
  
−
Use <javadoc method="getAreaComponent()">org.zkoss.zk.ui.event.MouseEvent</javadoc> method to retrieve the area component (<javadoc>org.zkoss.zul.Area</javadoc>) which user clicks on.
+
Call <javadoc method="getAreaComponent()">org.zkoss.zk.ui.event.MouseEvent</javadoc> to retrieve the area component (<javadoc>org.zkoss.zul.Area</javadoc>) which users click on.
 +
 
 +
There are several attributes you can get from the clicked Area:
 +
* <code>series</code>: series name
 +
* <code>category</code>: category name, e.g. GanttTask's description
 +
* <code>entity</code>: could be <code>DATA</code> or <code>LEGEND</code>
 +
* <code>percent</code>: percentage of complete of a gantt task
 +
* <code>start</code>: start value of a gannt task
 +
* <code>end</code>: end value of a gannt task
 
 
 
<source lang="java">
 
<source lang="java">
 
 
−
void drilldown(MouseEvent event) {
+
    @Listen("onClick = #gantt")
−
  final Component area = event.getAreaComponent();
+
    public  void drilldown(MouseEvent event) {
−
  if (area != null)
+
        final Area area = (Area)event.getAreaComponent();
−
    Messagebox.show(area.getAttribute("entity")+": "+area.getTooltiptext());
+
        if (area != null)
−
}
+
            Messagebox.show(area.getAttribute("category")+": "+area.getTooltiptext());
 +
    }
 
</source>
 
</source>
  
 
=Charts Support Setting the Font=
 
=Charts Support Setting the Font=
−
We can now specify what font we want a chart to use, this is useful when employing a foreign language within your chart. The example demonstrates setting a font and using it with a foreign language, in this case Chinese.
+
We can now specify what font we want a chart to use. This is useful when employing a foreign language within your chart. The example demonstrates setting a font and using it with a foreign language, in this case Chinese.
  
 
[[File:ZKComRef_Chart_Font_Examples.png]]
 
[[File:ZKComRef_Chart_Font_Examples.png]]
 
<source lang="xml">
 
<source lang="xml">
−
<vbox>
 
 
<zscript>
 
<zscript>
 
import java.awt.Font;
 
import java.awt.Font;
Line 765: Line 891:
 
<chart id="barchart" title="長條圖  Bar Chart" width="500" height="250" type="bar" threeD="false" fgAlpha="128"
 
<chart id="barchart" title="長條圖  Bar Chart" width="500" height="250" type="bar" threeD="false" fgAlpha="128"
 
titleFont="${tfont}" legendFont="${lfont}" xAxisFont="${lbfont}" xAxisTickFont="${lbfont}" model="${catmodel}"/>
 
titleFont="${tfont}" legendFont="${lfont}" xAxisFont="${lbfont}" xAxisTickFont="${lbfont}" model="${catmodel}"/>
−
</vbox>
 
 
</source>
 
</source>
 +
 +
 +
= Customize Chart =
 +
You can customize a chart's appearance by providing your own <code>ChartEngine</code>. It can save your effort by extending <code>JFreeChartEngine</code> and override its <code>prepareJFreeChart()</code>. Then manipulate the passed <code>JFreeChart</code> to change a chart's rendering. You also need to find related API in [http://javadox.com/org.jfree/jfreechart/1.0.19/overview-summary.html JFreeChart JavaDoc].
 +
 +
<syntaxhighlight lang='xml'>
 +
<chart engine="foo.MyJfreeChartEngine"/>
 +
</syntaxhighlight>
  
 
=Supported Events=
 
=Supported Events=
−
{| border="1" | width="100%"
 
−
! <center>Name</center>
 
−
! <center>Inherited From</center>
 
−
 
−
|-
 
−
| None
 
−
| None
 
−
|}
 
  
 
*Inherited Supported Events: [[ZK_Component_Reference/Essential_Components/Imagemap#Supported_Events | Imagemap]]
 
*Inherited Supported Events: [[ZK_Component_Reference/Essential_Components/Imagemap#Supported_Events | Imagemap]]
Line 786: Line 911:
 
=Use Cases=
 
=Use Cases=
  
−
{| border='1px' | width="100%"
+
{| class='wikitable' | width="100%"
 
! Version !! Description !! Example Location
 
! Version !! Description !! Example Location
 
|-
 
|-
Line 797: Line 922:
 
| [http://www.zkoss.org/forum/listComment/8752 http://www.zkoss.org/forum/listComment/8752]
 
| [http://www.zkoss.org/forum/listComment/8752 http://www.zkoss.org/forum/listComment/8752]
 
|}
 
|}
 +
 +
=Troubleshooting=
 +
== Linux ==
 +
Chart depends on Java Swing that might not work under some version of JVM. For the information to make it work under Linux, please refer to [[ZK Installation Guide/Setting up OS/Linux|ZK Installation Guide: Linux]].
  
 
=Version History=
 
=Version History=
 
{{LastUpdated}}
 
{{LastUpdated}}
  
−
{| border='1px' | width="100%"
+
{| class='wikitable' | width="100%"
 
! Version !! Date !! Content
 
! Version !! Date !! Content
 
|-
 
|-
Line 816: Line 945:
 
| 5.0.3
 
| 5.0.3
 
| June 2010
 
| June 2010
−
| The area sent with the click event becomes UUID of the area component. Thus, use <tt>desktop.getComponentByUuid(event.getArea())</tt>. To write a program compatible with any version of ZK:
+
| The area sent with the click event becomes UUID of the area component. Thus, use <code>desktop.getComponentByUuid(event.getArea())</code>. To write a program compatible with any version of ZK:
 
<source lang="java">
 
<source lang="java">
 
String areaid = event.getArea();
 
String areaid = event.getArea();

Latest revision as of 08:55, 1 March 2023


DocumentationZK Component ReferenceDiagrams and ReportsChart
Chart

Chart

  • Demonstration: Chart
  • Java API: Chart
  • JavaScript API: Chart
  • Style Guide: N/A
  • Available for ZK:
  • http://www.zkoss.org/product/zkhttp://www.zkoss.org/whyzk/zkeeVersion pe-ee.png

Employment/Purpose

A chart is used to show a set of data as a graph. It helps users to judge things with a snapshot. To use a chart component , developers must prepare a ChartModel and a ChartEngine. Developers also set proper chart type, and the threeD (3D) attribute to draw a proper chart. The model and type must match each other, or the result is unpredictable. The 3D chart is not supported on all chart types.

Example

Pie Chart

ZKComRef Chart.png 

<chart id="mychart" title="Pie Chart Demo" width="550" height="400"
    type="pie" threeD="true" fgAlpha="128">
    <attribute name="onClick"><![CDATA[
        Area area = event.getAreaComponent();
        if (area != null)
            alert(""+area.getAttribute("entity")+":"+area.getTooltiptext());
    ]]></attribute>
    <zscript><![CDATA[
        PieModel model = new SimplePieModel();
        model.setValue("C/C++", new Double(21.2));
        model.setValue("VB", new Double(10.2));
        model.setValue("Java", new Double(40.4));
        model.setValue("PHP", new Double(28.2));
        mychart.setModel(model);
    ]]></zscript>
</chart>

Pie Chart 3D

ZKComRef Chart Pie 3D.png 

<chart id="piechart3d" title="Pie Chart 3D" width="500" height="250"
		type="pie" threeD="true" fgAlpha="128">
    <zscript><![CDATA[
		PieModel piemodel = new SimplePieModel();
		piemodel.setValue("C/C++", new Double(12.5));
		piemodel.setValue("Java", new Double(50.2));
		piemodel.setValue("VB", new Double(20.5));
		piemodel.setValue("PHP", new Double(15.5));
        piechart3d.setModel(piemodel);
    ]]></zscript>
</chart>

Ring Chart

ZKComRef Chart Ring.png 

<chart id="ringchart" title="Ring Chart" width="500" height="250"
		type="ring" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
		PieModel piemodel = new SimplePieModel();
		piemodel.setValue("C/C++", new Double(12.5));
		piemodel.setValue("Java", new Double(50.2));
		piemodel.setValue("VB", new Double(20.5));
		piemodel.setValue("PHP", new Double(15.5));
        ringchart.setModel(piemodel);
    ]]></zscript>
</chart>

Bar Chart

ZKComRef Chart Bar.png 

<chart id="barchart" title="Bar Chart" width="500" height="250"
		type="bar" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
		CategoryModel catmodel = new SimpleCategoryModel();
		catmodel.setValue("2001", "Q1", new Integer(20));
		catmodel.setValue("2001", "Q2", new Integer(35));
		catmodel.setValue("2001", "Q3", new Integer(40));
		catmodel.setValue("2001", "Q4", new Integer(55));
		catmodel.setValue("2002", "Q1", new Integer(40));
		catmodel.setValue("2002", "Q2", new Integer(60));
		catmodel.setValue("2002", "Q3", new Integer(70));
		catmodel.setValue("2002", "Q4", new Integer(90));
		barchart.setModel(catmodel);
    ]]></zscript>
</chart>

Bar Chart 3D

ZKComRef Chart Bar 3D.png 

<chart id="barchart3d" title="Bar Chart 3D" width="500" height="250"
		type="bar" threeD="true" fgAlpha="128">
    <zscript><![CDATA[
		CategoryModel catmodel = new SimpleCategoryModel();
		catmodel.setValue("2001", "Q1", new Integer(20));
		catmodel.setValue("2001", "Q2", new Integer(35));
		catmodel.setValue("2001", "Q3", new Integer(40));
		catmodel.setValue("2001", "Q4", new Integer(55));
		catmodel.setValue("2002", "Q1", new Integer(40));
		catmodel.setValue("2002", "Q2", new Integer(60));
		catmodel.setValue("2002", "Q3", new Integer(70));
		catmodel.setValue("2002", "Q4", new Integer(90));
		barchart3d.setModel(catmodel);
    ]]></zscript>
</chart>

Stacked Bar

ZKComRef Chart Stacked Bar.png 

<chart id="sbarchart" title="Stacked Bar" width="500" height="250"
		type="stacked_bar" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
		CategoryModel catmodel = new SimpleCategoryModel();
		catmodel.setValue("2001", "Q1", new Integer(20));
		catmodel.setValue("2001", "Q2", new Integer(35));
		catmodel.setValue("2001", "Q3", new Integer(40));
		catmodel.setValue("2001", "Q4", new Integer(55));
		catmodel.setValue("2002", "Q1", new Integer(40));
		catmodel.setValue("2002", "Q2", new Integer(60));
		catmodel.setValue("2002", "Q3", new Integer(70));
		catmodel.setValue("2002", "Q4", new Integer(90));
		sbarchart.setModel(catmodel);
    ]]></zscript>
</chart>

Stacked Bar 3D

ZKComRef Chart Stacked Bar 3D.png 

<chart id="sbarchart3d" title="Stacked Bar 3D" width="500"
		height="250" type="stacked_bar" threeD="true" fgAlpha="128">
    <zscript><![CDATA[
		CategoryModel catmodel = new SimpleCategoryModel();
		catmodel.setValue("2001", "Q1", new Integer(20));
		catmodel.setValue("2001", "Q2", new Integer(35));
		catmodel.setValue("2001", "Q3", new Integer(40));
		catmodel.setValue("2001", "Q4", new Integer(55));
		catmodel.setValue("2002", "Q1", new Integer(40));
		catmodel.setValue("2002", "Q2", new Integer(60));
		catmodel.setValue("2002", "Q3", new Integer(70));
		catmodel.setValue("2002", "Q4", new Integer(90));
		sbarchart3d.setModel(catmodel);
    ]]></zscript>
</chart>

Line Chart

ZKComRef Chart Line.png 

<chart id="linechart" title="Line Chart" width="500" height="250"
		type="line" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
		CategoryModel catmodel = new SimpleCategoryModel();
		catmodel.setValue("2001", "Q1", new Integer(20));
		catmodel.setValue("2001", "Q2", new Integer(35));
		catmodel.setValue("2001", "Q3", new Integer(40));
		catmodel.setValue("2001", "Q4", new Integer(55));
		catmodel.setValue("2002", "Q1", new Integer(40));
		catmodel.setValue("2002", "Q2", new Integer(60));
		catmodel.setValue("2002", "Q3", new Integer(70));
		catmodel.setValue("2002", "Q4", new Integer(90));
		linechart.setModel(catmodel);
    ]]></zscript>
</chart>

Line Chart 3D

ZKComRef Chart Line 3D.png 

<chart id="linechart3d" title="Line Chart 3D" width="500"
		height="250" type="line" threeD="true" fgAlpha="128">
    <zscript><![CDATA[
		CategoryModel catmodel = new SimpleCategoryModel();
		catmodel.setValue("2001", "Q1", new Integer(20));
		catmodel.setValue("2001", "Q2", new Integer(35));
		catmodel.setValue("2001", "Q3", new Integer(40));
		catmodel.setValue("2001", "Q4", new Integer(55));
		catmodel.setValue("2002", "Q1", new Integer(40));
		catmodel.setValue("2002", "Q2", new Integer(60));
		catmodel.setValue("2002", "Q3", new Integer(70));
		catmodel.setValue("2002", "Q4", new Integer(90));
		linechart3d.setModel(catmodel);
    ]]></zscript>
</chart>

Area Chart

ZKComRef Chart Area.png 

<chart id="areachart" title="Area Chart" width="500" height="250"
		type="area" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
		CategoryModel catmodel = new SimpleCategoryModel();
		catmodel.setValue("2001", "Q1", new Integer(20));
		catmodel.setValue("2001", "Q2", new Integer(35));
		catmodel.setValue("2001", "Q3", new Integer(40));
		catmodel.setValue("2001", "Q4", new Integer(55));
		catmodel.setValue("2002", "Q1", new Integer(40));
		catmodel.setValue("2002", "Q2", new Integer(60));
		catmodel.setValue("2002", "Q3", new Integer(70));
		catmodel.setValue("2002", "Q4", new Integer(90));
		areachart.setModel(catmodel);
    ]]></zscript>
</chart>

Stacked Area Chart

ZKComRef Chart Stacked Area.png 

<chart id="sareachart" title="Stacked Area Chart" width="500"
		height="250" type="stacked_area" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
		CategoryModel catmodel = new SimpleCategoryModel();
		catmodel.setValue("2001", "Q1", new Integer(20));
		catmodel.setValue("2001", "Q2", new Integer(35));
		catmodel.setValue("2001", "Q3", new Integer(40));
		catmodel.setValue("2001", "Q4", new Integer(55));
		catmodel.setValue("2002", "Q1", new Integer(40));
		catmodel.setValue("2002", "Q2", new Integer(60));
		catmodel.setValue("2002", "Q3", new Integer(70));
		catmodel.setValue("2002", "Q4", new Integer(90));
		sareachart.setModel(catmodel);
    ]]></zscript>
</chart>

Waterfall Chart

ZKComRef Chart Waterfall.png 

<chart id="waterfall" title="Waterfall Chart" width="500"
		height="250" type="waterfall" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
		CategoryModel catmodel = new SimpleCategoryModel();
		catmodel.setValue("2001", "Q1", new Integer(20));
		catmodel.setValue("2001", "Q2", new Integer(35));
		catmodel.setValue("2001", "Q3", new Integer(40));
		catmodel.setValue("2001", "Q4", new Integer(55));
		catmodel.setValue("2002", "Q1", new Integer(40));
		catmodel.setValue("2002", "Q2", new Integer(60));
		catmodel.setValue("2002", "Q3", new Integer(70));
		catmodel.setValue("2002", "Q4", new Integer(90));
		waterfall.setModel(catmodel);
    ]]></zscript>
</chart>

Polar Chart

ZKComRef Chart Polar.png 

<chart id="polar" title="Polar Chart" width="500" height="250"
		type="polar" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
		XYModel xymodel = new SimpleXYModel();
		xymodel.addValue("2001", new Integer(20), new Integer(120));
		xymodel.addValue("2001", new Integer(40), new Integer(135));
		xymodel.addValue("2001", new Integer(60), new Integer(140));
		xymodel.addValue("2001", new Integer(80), new Integer(160));
		
		xymodel.addValue("2002", new Integer(30), new Integer(120));
		xymodel.addValue("2002", new Integer(50), new Integer(135));
		xymodel.addValue("2002", new Integer(70), new Integer(140));
		xymodel.addValue("2002", new Integer(90), new Integer(160));
		polar.setModel(xymodel);
    ]]></zscript>
</chart>

Scatter Chart

ZKComRef Chart Scatter.png 

<chart id="scatter" title="Scatter Chart" width="500" height="250"
		type="scatter" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
		XYModel xymodel = new SimpleXYModel();
		xymodel.addValue("2001", new Integer(20), new Integer(120));
		xymodel.addValue("2001", new Integer(40), new Integer(135));
		xymodel.addValue("2001", new Integer(60), new Integer(140));
		xymodel.addValue("2001", new Integer(80), new Integer(160));
		
		xymodel.addValue("2002", new Integer(30), new Integer(120));
		xymodel.addValue("2002", new Integer(50), new Integer(135));
		xymodel.addValue("2002", new Integer(70), new Integer(140));
		xymodel.addValue("2002", new Integer(90), new Integer(160));
		scatter.setModel(xymodel);
    ]]></zscript>
</chart>

Time Series Chart

ZKComRef Chart Timeseries.png 

<chart id="timeseries" title="Time Series Chart" width="500"
		height="250" type="time_series" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
		XYModel xymodel = new SimpleXYModel();
		xymodel.addValue("2001", new Integer(20), new Integer(120));
		xymodel.addValue("2001", new Integer(40), new Integer(135));
		xymodel.addValue("2001", new Integer(60), new Integer(140));
		xymodel.addValue("2001", new Integer(80), new Integer(160));
		
		xymodel.addValue("2002", new Integer(30), new Integer(120));
		xymodel.addValue("2002", new Integer(50), new Integer(135));
		xymodel.addValue("2002", new Integer(70), new Integer(140));
		xymodel.addValue("2002", new Integer(90), new Integer(160));
		timeseries.setModel(xymodel);
    ]]></zscript>
</chart>

XY Area Chart

ZKComRef Chart XY Area.png 

<chart id="xyarea" title="XY Area Chart" width="500" height="250"
		type="area" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
		XYModel xymodel = new SimpleXYModel();
		xymodel.addValue("2001", new Integer(20), new Integer(120));
		xymodel.addValue("2001", new Integer(40), new Integer(135));
		xymodel.addValue("2001", new Integer(60), new Integer(140));
		xymodel.addValue("2001", new Integer(80), new Integer(160));
		
		xymodel.addValue("2002", new Integer(30), new Integer(120));
		xymodel.addValue("2002", new Integer(50), new Integer(135));
		xymodel.addValue("2002", new Integer(70), new Integer(140));
		xymodel.addValue("2002", new Integer(90), new Integer(160));
		xyarea.setModel(xymodel);
    ]]></zscript>
</chart>

XY Line Chart

ZKComRef Chart XY Line.png 

<chart id="xyline" title="XY Line Chart" width="500" height="250"
		type="line" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
		XYModel xymodel = new SimpleXYModel();
		xymodel.addValue("2001", new Integer(20), new Integer(120));
		xymodel.addValue("2001", new Integer(40), new Integer(135));
		xymodel.addValue("2001", new Integer(60), new Integer(140));
		xymodel.addValue("2001", new Integer(80), new Integer(160));
		
		xymodel.addValue("2002", new Integer(30), new Integer(120));
		xymodel.addValue("2002", new Integer(50), new Integer(135));
		xymodel.addValue("2002", new Integer(70), new Integer(140));
		xymodel.addValue("2002", new Integer(90), new Integer(160));
		xyline.setModel(xymodel);
    ]]></zscript>
</chart>

Step Area Chart

ZKComRef Chart Step Area.png 

<chart id="steparea" title="Step Area Chart" width="500"
		height="250" type="step_area" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
		XYModel xymodel = new SimpleXYModel();
		xymodel.addValue("2001", new Integer(20), new Integer(120));
		xymodel.addValue("2001", new Integer(40), new Integer(135));
		xymodel.addValue("2001", new Integer(60), new Integer(140));
		xymodel.addValue("2001", new Integer(80), new Integer(160));
		
		xymodel.addValue("2002", new Integer(30), new Integer(120));
		xymodel.addValue("2002", new Integer(50), new Integer(135));
		xymodel.addValue("2002", new Integer(70), new Integer(140));
		xymodel.addValue("2002", new Integer(90), new Integer(160));
		steparea.setModel(xymodel);
    ]]></zscript>
</chart>

Step Chart

ZKComRef Chart Step.png 

<chart id="step" title="Step Chart" width="500" height="250"
		type="step" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
    	 public Date time(int year, int month, int day, int hour, int minute, int second) {
			final java.util.Calendar calendar = java.util.Calendar.getInstance(TimeZone.getTimeZone("GMT"));
			calendar.set(year, month-1, day, hour, minute, second);
			final Date result = calendar.getTime();
			return result;
		}
		XYModel datemodel = new SimpleXYModel();
		datemodel.addValue("2001", new Long(time(2001, 5, 2, 1, 10, 15).getTime()), new Integer(120));
		datemodel.addValue("2001", new Long(time(2001, 5, 2, 2, 10, 15).getTime()), new Integer(135));
		datemodel.addValue("2001", new Long(time(2001, 5, 2, 3, 10, 15).getTime()), new Integer(140));
		datemodel.addValue("2001", new Long(time(2001, 5, 2, 4, 10, 15).getTime()), new Integer(160));
		
		datemodel.addValue("2002", new Long(time(2001, 5, 2, 1, 10, 20).getTime()), new Integer(125));
		datemodel.addValue("2002", new Long(time(2001, 5, 2, 2, 10, 20).getTime()), new Integer(130));
		datemodel.addValue("2002", new Long(time(2001, 5, 2, 3, 10, 20).getTime()), new Integer(120));
		datemodel.addValue("2002", new Long(time(2001, 5, 2, 4, 10, 20).getTime()), new Integer(180));
		step.setModel(datemodel);
    ]]></zscript>
</chart>

XY Stacked Area Chart

ZKComRef Chart XY Stacked Area.png 

<chart id="xystackedarea" title="XY Stacked Area Chart" width="500"
		height="250" type="stacked_area" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
		XYModel xymodel = new SimpleXYModel();
		xymodel.addValue("2001", new Integer(20), new Integer(120));
		xymodel.addValue("2001", new Integer(40), new Integer(135));
		xymodel.addValue("2001", new Integer(60), new Integer(140));
		xymodel.addValue("2001", new Integer(80), new Integer(160));
		
		xymodel.addValue("2002", new Integer(30), new Integer(120));
		xymodel.addValue("2002", new Integer(50), new Integer(135));
		xymodel.addValue("2002", new Integer(70), new Integer(140));
		xymodel.addValue("2002", new Integer(90), new Integer(160));
		xystackedarea.setModel(xymodel);
    ]]></zscript>
</chart>

XY Bar Chart

ZKComRef Chart XY Bar.png 

<chart id="xybar" title="XY Bar Chart" width="500" height="250"
		type="bar" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
		XYModel xymodel = new SimpleXYModel();
		xymodel.addValue("2001", new Integer(20), new Integer(120));
		xymodel.addValue("2001", new Integer(40), new Integer(135));
		xymodel.addValue("2001", new Integer(60), new Integer(140));
		xymodel.addValue("2001", new Integer(80), new Integer(160));
		
		xymodel.addValue("2002", new Integer(30), new Integer(120));
		xymodel.addValue("2002", new Integer(50), new Integer(135));
		xymodel.addValue("2002", new Integer(70), new Integer(140));
		xymodel.addValue("2002", new Integer(90), new Integer(160));
		xybar.setModel(xymodel);
    ]]></zscript>
</chart>

Histogram Chart

ZKComRef Chart Histogram.png 

<chart id="histogram" title="Histogram Chart" width="500"
		height="250" type="histogram" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
		XYModel xymodel = new SimpleXYModel();
		xymodel.addValue("2001", new Integer(20), new Integer(120));
		xymodel.addValue("2001", new Integer(40), new Integer(135));
		xymodel.addValue("2001", new Integer(60), new Integer(140));
		xymodel.addValue("2001", new Integer(80), new Integer(160));
		
		xymodel.addValue("2002", new Integer(30), new Integer(120));
		xymodel.addValue("2002", new Integer(50), new Integer(135));
		xymodel.addValue("2002", new Integer(70), new Integer(140));
		xymodel.addValue("2002", new Integer(90), new Integer(160));
		histogram.setModel(xymodel);
    ]]></zscript>
</chart>

Candlestick Chart

ZKComRef Chart Candlestick.png 

<chart id="candlestick" title="Candlestick Chart" width="500"
		height="250" type="candlestick" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
		HiLoModel hilomodel = new SimpleHiLoModel();
		long d = System.currentTimeMillis();
		hilomodel.addValue(new Date(d),  new Double(45.5),  new Double(54.2), new Double(19.9), new Double(42.8), new Double(20));
		hilomodel.addValue(new Date(d+1000),  new Double(46.5),  new Double(55.2),  new Double(43.8), new Double(50.9),   new Double(32));
		hilomodel.addValue(new Date(d+2000),  new Double(47.5),  new Double(56.2),  new Double(44.8), new Double(51.9),   new Double(33));
		hilomodel.addValue(new Date(d+3000),  new Double(48.5),  new Double(57.2),  new Double(45.8), new Double(52.9),   new Double(34));
		hilomodel.addValue(new Date(d+4000),  new Double(49.5),  new Double(58.2),  new Double(46.8), new Double(53.9),   new Double(35));
		hilomodel.addValue(new Date(d+5000),  new Double(50.5),  new Double(59.2),  new Double(47.8), new Double(54.9),   new Double(36));
		hilomodel.addValue(new Date(d+6000),  new Double(51.5),  new Double(60.2),  new Double(48.8), new Double(55.9),   new Double(37));
		hilomodel.addValue(new Date(d+7000),  new Double(52.5),  new Double(61.2),  new Double(49.8), new Double(56.9),   new Double(38));
		hilomodel.addValue(new Date(d+8000),  new Double(53.5),  new Double(62.2),  new Double(50.8), new Double(57.9),   new Double(39));
		hilomodel.addValue(new Date(d+9000),  new Double(54.5),  new Double(63.2),  new Double(51.8), new Double(58.9),   new Double(40));
		hilomodel.addValue(new Date(d+10000),  new Double(55.5),  new Double(64.2),  new Double(52.8), new Double(59.9),   new Double(41));
		hilomodel.addValue(new Date(d+11000),  new Double(56.5),  new Double(65.2),  new Double(53.8), new Double(60.9),   new Double(42));
		hilomodel.addValue(new Date(d+12000),  new Double(57.5),  new Double(66.2),  new Double(54.8), new Double(61.9),   new Double(43));
		hilomodel.addValue(new Date(d+13000),  new Double(58.5),  new Double(67.2),  new Double(55.8), new Double(62.9),   new Double(44));
		hilomodel.addValue(new Date(d+14000),  new Double(59.5),  new Double(68.2),  new Double(56.8), new Double(63.9),   new Double(45));
		hilomodel.addValue(new Date(d+15000),  new Double(60.5),  new Double(69.2),  new Double(57.8), new Double(64.9),   new Double(46));
		hilomodel.addValue(new Date(d+16000),  new Double(61.5),  new Double(70.2),  new Double(58.8), new Double(65.9),   new Double(47));
		hilomodel.addValue(new Date(d+17000),  new Double(62.5),  new Double(71.2),  new Double(59.8), new Double(66.9),   new Double(48));
		hilomodel.addValue(new Date(d+18000),  new Double(63.5),  new Double(72.2),  new Double(60.8), new Double(67.9),   new Double(49));
		candlestick.setModel(hilomodel);
    ]]></zscript>
</chart>

High Low Chart

ZKComRef Chart Highlow.png 

<chart id="highlow" title="High Low Chart" width="500" height="250"
		type="highlow" threeD="false" fgAlpha="128" dateFormat="yyyy/MM/dd">
    <zscript><![CDATA[
		HiLoModel hilomodel = new SimpleHiLoModel();
		long d = System.currentTimeMillis();
		hilomodel.addValue(new Date(d),  new Double(45.5),  new Double(54.2), new Double(19.9), new Double(42.8), new Double(20));
		hilomodel.addValue(new Date(d+1000),  new Double(46.5),  new Double(55.2),  new Double(43.8), new Double(50.9),   new Double(32));
		hilomodel.addValue(new Date(d+2000),  new Double(47.5),  new Double(56.2),  new Double(44.8), new Double(51.9),   new Double(33));
		hilomodel.addValue(new Date(d+3000),  new Double(48.5),  new Double(57.2),  new Double(45.8), new Double(52.9),   new Double(34));
		hilomodel.addValue(new Date(d+4000),  new Double(49.5),  new Double(58.2),  new Double(46.8), new Double(53.9),   new Double(35));
		hilomodel.addValue(new Date(d+5000),  new Double(50.5),  new Double(59.2),  new Double(47.8), new Double(54.9),   new Double(36));
		hilomodel.addValue(new Date(d+6000),  new Double(51.5),  new Double(60.2),  new Double(48.8), new Double(55.9),   new Double(37));
		hilomodel.addValue(new Date(d+7000),  new Double(52.5),  new Double(61.2),  new Double(49.8), new Double(56.9),   new Double(38));
		hilomodel.addValue(new Date(d+8000),  new Double(53.5),  new Double(62.2),  new Double(50.8), new Double(57.9),   new Double(39));
		hilomodel.addValue(new Date(d+9000),  new Double(54.5),  new Double(63.2),  new Double(51.8), new Double(58.9),   new Double(40));
		hilomodel.addValue(new Date(d+10000),  new Double(55.5),  new Double(64.2),  new Double(52.8), new Double(59.9),   new Double(41));
		hilomodel.addValue(new Date(d+11000),  new Double(56.5),  new Double(65.2),  new Double(53.8), new Double(60.9),   new Double(42));
		hilomodel.addValue(new Date(d+12000),  new Double(57.5),  new Double(66.2),  new Double(54.8), new Double(61.9),   new Double(43));
		hilomodel.addValue(new Date(d+13000),  new Double(58.5),  new Double(67.2),  new Double(55.8), new Double(62.9),   new Double(44));
		hilomodel.addValue(new Date(d+14000),  new Double(59.5),  new Double(68.2),  new Double(56.8), new Double(63.9),   new Double(45));
		hilomodel.addValue(new Date(d+15000),  new Double(60.5),  new Double(69.2),  new Double(57.8), new Double(64.9),   new Double(46));
		hilomodel.addValue(new Date(d+16000),  new Double(61.5),  new Double(70.2),  new Double(58.8), new Double(65.9),   new Double(47));
		hilomodel.addValue(new Date(d+17000),  new Double(62.5),  new Double(71.2),  new Double(59.8), new Double(66.9),   new Double(48));
		hilomodel.addValue(new Date(d+18000),  new Double(63.5),  new Double(72.2),  new Double(60.8), new Double(67.9),   new Double(49));
		highlow.setModel(hilomodel);
    ]]></zscript>
</chart>

Bubble Chart

ZKComRef Chart Bubble.png 

<chart id="bubble" title="Bubble Chart" width="500" height="250"
		type="bubble" threeD="false" fgAlpha="128">
    <zscript><![CDATA[	
		XYZModel xyzmodel = new SimpleXYZModel();
		xyzmodel.addValue("2001", new Integer(20), new Integer(120), new Integer(8));
		xyzmodel.addValue("2001", new Integer(40), new Integer(135), new Integer(10));
		xyzmodel.addValue("2001", new Integer(60), new Integer(140), new Integer(6));
		xyzmodel.addValue("2001", new Integer(80), new Integer(160), new Integer(12));
		
		xyzmodel.addValue("2002", new Integer(30), new Integer(120), new Integer(4));
		xyzmodel.addValue("2002", new Integer(50), new Integer(135), new Integer(5));
		xyzmodel.addValue("2002", new Integer(70), new Integer(140), new Integer(3));
		xyzmodel.addValue("2002", new Integer(90), new Integer(160), new Integer(6));
		bubble.setModel(xyzmodel);
    ]]></zscript>
</chart>

Horizontal Bubble Chart

ZKComRef Chart HBubble.png 

<chart id="hbubble" title="Horizontal Bubble Chart" width="500"
		height="250" type="bubble" threeD="false" fgAlpha="128" orient="horizontal">
    <zscript><![CDATA[	
		XYZModel xyzmodel = new SimpleXYZModel();
		xyzmodel.addValue("2001", new Integer(20), new Integer(120), new Integer(8));
		xyzmodel.addValue("2001", new Integer(40), new Integer(135), new Integer(10));
		xyzmodel.addValue("2001", new Integer(60), new Integer(140), new Integer(6));
		xyzmodel.addValue("2001", new Integer(80), new Integer(160), new Integer(12));
		
		xyzmodel.addValue("2002", new Integer(30), new Integer(120), new Integer(4));
		xyzmodel.addValue("2002", new Integer(50), new Integer(135), new Integer(5));
		xyzmodel.addValue("2002", new Integer(70), new Integer(140), new Integer(3));
		xyzmodel.addValue("2002", new Integer(90), new Integer(160), new Integer(6));
		hbubble.setModel(xyzmodel);
    ]]></zscript>
</chart>

Wafer Map Chart

ZKComRef Chart Wafer Map.png 

<chart id="wafermap" title="Wafer Map Chart" width="500"
		height="400" type="wafermap" threeD="false" fgAlpha="128">
    <zscript><![CDATA[	
		final int xdim = 30;
		final int ydim = 20;
		final Random random = new Random();
		WaferMapModel wafermodel = new WaferMapModel(xdim, ydim);
		for (int x = 0; x < xdim; x++) {
			for (int y = 0; y < ydim; y++) {
				wafermodel.addValue(random.nextInt(5), x, y);
			}
		}
		wafermap.setModel(wafermodel);
    ]]></zscript>
</chart>

Gantt Chart

ZKComRef Chart Gantt.png 

<chart id="gantt" title="Gantt Chart" width="700" height="400"
		type="gantt" threeD="false" fgAlpha="128" dateFormat="yyyy/MM/dd" >
    <zscript><![CDATA[	
		import org.zkoss.zul.GanttModel.GanttTask;
		
		public Date date(int year, int month, int day) {
			final java.util.Calendar calendar = java.util.Calendar.getInstance();
			calendar.set(year, month-1, day);
			final Date result = calendar.getTime();
			return result;
		}
		//series, task (task description, start, end, complete percentage)
		GanttModel ganttmodel = new GanttModel();
		ganttmodel.addValue("Scheduled", new GanttTask("Write Proposal", date(2008,4,1), date(2008,4,5), 0.0));
		ganttmodel.addValue("Scheduled", new GanttTask("Obtain Approval", date(2008,4,9), date(2008,4,9), 0.0));
		ganttmodel.addValue("Scheduled", new GanttTask("Requirements Analysis", date(2008,4,10), date(2008,5,5), 0.0));
		ganttmodel.addValue("Scheduled", new GanttTask("Design Phase", date(2008,5,6), date(2008,5,30), 0.0));
		ganttmodel.addValue("Scheduled", new GanttTask("Design Signoff", date(2008,6,2), date(2008,6,2), 0.0));
		ganttmodel.addValue("Scheduled", new GanttTask("Alpha Implementation", date(2008,6,3), date(2008,7,31), 0.0));
		ganttmodel.addValue("Scheduled", new GanttTask("Design Review", date(2008,8,1), date(2008,8,8), 0.0));
		ganttmodel.addValue("Scheduled", new GanttTask("Revised Design Signoff", date(2008,8,10), date(2008,8,10), 0.0));
		ganttmodel.addValue("Scheduled", new GanttTask("Beta Implementation", date(2008,8,12), date(2008,9,12), 0.0));
		ganttmodel.addValue("Scheduled", new GanttTask("Testing", date(2008,9,13), date(2008,10,31), 0.0));
		ganttmodel.addValue("Scheduled", new GanttTask("Final Implementation", date(2008,11,1), date(2008,11,15), 0.0));
		ganttmodel.addValue("Scheduled", new GanttTask("Signoff", date(2008,11,28), date(2008,11,30), 0.0));
		
		ganttmodel.addValue("Actual", new GanttTask("Write Proposal", date(2008,4,1), date(2008,4,3), 0.0));
		ganttmodel.addValue("Actual", new GanttTask("Obtain Approval", date(2008,4,9), date(2008,4,9), 0.0));
		ganttmodel.addValue("Actual", new GanttTask("Requirements Analysis", date(2008,4,10), date(2008,5,15), 0.0));
		ganttmodel.addValue("Actual", new GanttTask("Design Phase", date(2008,5,15), date(2008,6,17), 0.0));
		ganttmodel.addValue("Actual", new GanttTask("Design Signoff", date(2008,6,30), date(2008,6,30), 0.0));
		ganttmodel.addValue("Actual", new GanttTask("Alpha Implementation", date(2008,7,1), date(2008,9,12), 0.0));
		ganttmodel.addValue("Actual", new GanttTask("Design Review", date(2008,9,12), date(2008,9,22), 0.0));
		ganttmodel.addValue("Actual", new GanttTask("Revised Design Signoff", date(2008,9,25), date(2008,9,27), 0.0));
		ganttmodel.addValue("Actual", new GanttTask("Beta Implementation", date(2008,8,12), date(2008,9,12), 0.0));
		ganttmodel.addValue("Actual", new GanttTask("Testing", date(2008,10,31), date(2008,11,17), 0.0));
		ganttmodel.addValue("Actual", new GanttTask("Final Implementation", date(2008,11,18), date(2008,12,5), 0.0));
		ganttmodel.addValue("Actual", new GanttTask("Signoff", date(2008,12,10), date(2008,12,11), 0.0));
		gantt.setModel(ganttmodel);
    ]]></zscript>
</chart>

Wind Chart

ZKComRef Chart Wind.png 

<chart id="wind" title="Wind Plot" width="700" height="400"
		type="wind" threeD="false" fgAlpha="128" dateFormat="yyyy/MM/dd" >
    <zscript><![CDATA[
		
		public Date date(int year, int month, int day) {
			final java.util.Calendar calendar = java.util.Calendar.getInstance();
			calendar.set(year, month-1, day);
			final Date result = calendar.getTime();
			return result;
		}
		XYZModel windmodel = new SimpleXYZModel();
		//series, date, direction (0-12), force(0-12)
		windmodel.addValue("Wind!", new Long(date(2008, 1, 3).getTime()), new Double(0d), new Double(10.0));
		windmodel.addValue("Wind!", new Long(date(2008, 1, 4).getTime()), new Double(1d), new Double(8.5));
		windmodel.addValue("Wind!", new Long(date(2008, 1, 5).getTime()), new Double(2.0), new Double(10.0));
		windmodel.addValue("Wind!", new Long(date(2008, 1, 6).getTime()), new Double(3.0), new Double(10.0));
		windmodel.addValue("Wind!", new Long(date(2008, 1, 7).getTime()), new Double(4.0), new Double(7.0));
		windmodel.addValue("Wind!", new Long(date(2008, 1, 8).getTime()), new Double(5.0), new Double(10.0));
		windmodel.addValue("Wind!", new Long(date(2008, 1, 9).getTime()), new Double(6.0), new Double(8.0));
		windmodel.addValue("Wind!", new Long(date(2008, 1, 10).getTime()), new Double(7.0), new Double(11.0));
		windmodel.addValue("Wind!", new Long(date(2008, 1, 11).getTime()), new Double(8.0), new Double(10.0));
		windmodel.addValue("Wind!", new Long(date(2008, 1, 12).getTime()), new Double(9.0), new Double(11.0));
		windmodel.addValue("Wind!", new Long(date(2008, 1, 13).getTime()), new Double(10.0), new Double(3.0));
		windmodel.addValue("Wind!", new Long(date(2008, 1, 14).getTime()), new Double(11.0), new Double(9.0));
		windmodel.addValue("Wind!", new Long(date(2008, 1, 15).getTime()), new Double(12.0), new Double(11.0));
		windmodel.addValue("Wind!", new Long(date(2008, 1, 16).getTime()), new Double(0.0), new Double(0.0));
		wind.setModel(windmodel);
    ]]></zscript>
</chart>

Dial Chart

ZKComRef Chart Dial.png 

<window onOK="doOK()" width="350px">
	<chart id="dial" title="Dial Plot" width="300" height="300" type="dial" threeD="false" fgAlpha="128">
    <zscript><![CDATA[
		
		import org.zkoss.zul.DialModel;
	    import org.zkoss.zul.DialModelScale;
	
	    int val= 40;
	
		DialModel dialmodel = new DialModel();
		DialModelScale scale = dialmodel.newScale(0.0, 100.0, -120.0, -300.0, 10.0, 4);//scale's configuration data
		scale.setText("Temperature");
		scale.newRange(80, 100, "#FF0000", 0.83, 0.89);
		scale.newRange(60, 80, "#FFC426", 0.83, 0.89);
		scale.setValue(val);
	
		doOK() {
			val = dbx.getValue();
			if (val > 100) {
				val = 100;
			} else if (val < 0) {
				val = 0;
			}
			dbx.value = val;
			slx.curpos = val;
			scale.setValue(val);
			if (val > 80) {
				scale.setNeedleColor(scale.getRange(0).getRangeColor());
			} else if (val > 60) {
				scale.setNeedleColor(scale.getRange(1).getRangeColor());
			} else {
				scale.setNeedleColor(dialmodel.getFrameFgColor());
			}
	    }
	    dial.setModel(dialmodel);
	    ]]></zscript>
	</chart>
	<hbox>
		<slider id="slx" curpos="${val}" onScroll="dbx.value=self.curpos; doOK()"/>
		<intbox id="dbx" value="${val}" onChange="doOK()"/>
	</hbox>
</window>

Properties

Type and Model

Type
Model
3D
pie
 PieModel
o
ring
 PieModel
x
bar
 CategoryModel or XYModel
o
line
 CategoryModel or XYModel
o
area
 CategoryModel or XYModel
x
stacked_bar
CategoryModel
o
stacked_area
CategoryModel or XYModel
x
waterfall
CategoryModel
x
polar
XYModel
x
scatter
XYModel
x
time_series
XYModel
x
polar
XYModel
x
step_area
XYModel
x
step
XYModel
x
histogram
XYModel
x
bubble
XYModel
x
wind
XYModel
x
candlestick
HiLoModel
x
highlow
 HiLoModel
x
wafermap
 WaferMapModel
x
gantt
 GanttModel
x
dial
 DialModel
x

Clicked Area: Series, Legend

In an onClick listener, you can call MouseEvent.getX() and MouseEvent.getY() to get coordinates.

Call MouseEvent.getAreaComponent() to retrieve the area component (Area) which users click on.

There are several attributes you can get from the clicked Area:

  • series: series name
  • category: category name, e.g. GanttTask's description
  • entity: could be DATA or LEGEND
  • percent: percentage of complete of a gantt task
  • start: start value of a gannt task
  • end: end value of a gannt task
	
    @Listen("onClick = #gantt")
    public  void drilldown(MouseEvent event) {
        final Area area = (Area)event.getAreaComponent();
        if (area != null)
            Messagebox.show(area.getAttribute("category")+": "+area.getTooltiptext());
    }

Charts Support Setting the Font

We can now specify what font we want a chart to use. This is useful when employing a foreign language within your chart. The example demonstrates setting a font and using it with a foreign language, in this case Chinese.

ZKComRef Chart Font Examples.png 

	<zscript>
		import java.awt.Font;
		String fontname = "Dialog";
		Font tfont = new Font(fontname, Font.BOLD, 16); //for title
		Font lfont = new Font(fontname, Font.PLAIN, 10); //for legend
		Font lbfont = new Font(fontname, Font.PLAIN, 12); //for label


		CategoryModel catmodel = new SimpleCategoryModel();
		catmodel.setValue("2001", "第一季", new Integer(20));
		catmodel.setValue("2001", "第二季", new Integer(35));
		catmodel.setValue("2001", "第三季", new Integer(40));
		catmodel.setValue("2001", "第四季", new Integer(55));
		catmodel.setValue("2002", "第一季", new Integer(40));
		catmodel.setValue("2002", "第二季", new Integer(60));
		catmodel.setValue("2002", "第三季", new Integer(70));
		catmodel.setValue("2002", "第四季", new Integer(90));
	</zscript>

	<chart id="barchart" title="長條圖  Bar Chart" width="500" height="250" type="bar" threeD="false" fgAlpha="128"
	titleFont="${tfont}" legendFont="${lfont}" xAxisFont="${lbfont}" xAxisTickFont="${lbfont}" model="${catmodel}"/>


Customize Chart

You can customize a chart's appearance by providing your own ChartEngine. It can save your effort by extending JFreeChartEngine and override its prepareJFreeChart(). Then manipulate the passed JFreeChart to change a chart's rendering. You also need to find related API in JFreeChart JavaDoc. 

<chart engine="foo.MyJfreeChartEngine"/>

Supported Events

Supported Children

*NONE

Use Cases

Version Description Example Location
5.0 Make a Chart fill 100% width in parent panel http://www.zkoss.org/forum/listComment/10761
5.0 Dual axis in Chart http://www.zkoss.org/forum/listComment/8752

Troubleshooting

Linux

Chart depends on Java Swing that might not work under some version of JVM. For the information to make it work under Linux, please refer to ZK Installation Guide: Linux.

Version History

Last Update : 2023/03/01


Version Date Content
5.0.4 August 2010 MouseEvent introduced a new method, MouseEvent.getAreaComponent(), which simplifies the retrieval of the area component. 
Area area = (Area)event.getAreaComponent(); //must be Area or null when used with chart
if (area != null)
  ...
5.0.3 June 2010 The area sent with the click event becomes UUID of the area component. Thus, use desktop.getComponentByUuid(event.getArea()). To write a program compatible with any version of ZK: 
String areaid = event.getArea();
if (areaid != null) {
  Area area = desktop.getComponentByUuidIfAny(areaid);
  if (area == null)
    area = chart.getFellow(areaid); //fall back to older version
...



Last Update : 2023/03/01

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.


Retrieved from "https://www.zkoss.org/_w/index.php?title=ZK_Component_Reference/Diagrams_and_Reports/Chart&oldid=55511"