CFCHARTSERIES  
Description
Used with the cfchart tag. This tag defines the style in which chart data displays: bar, line, pie, and so on.
 
Category
Data output tags, Extensibility tags
 
Syntax
<cfchartseries 
   type="type"
   query="queryName"
   itemColumn="queryColumn"
   valueColumn="queryColumn"
   seriesLabel="Label Text"
   seriesColor="Hex value or Web color" 
   paintStyle="plain, raise, shade, light"
   markerStyle="style"
   colorlist = "list">
</cfchartseries>
 
See also
cfchart, cfchartdata
 
History
ColdFusion MX 6.1: Changed interpolation behavior: the tag now interpolates data points on line charts with multiple series.
ColdFusion MX: Added this tag.
 
Usage
If a chart has multiple line series, ColdFusion interpolates missing data points in the common X axis range. For example, if one series has data points at 0, 10, and 20 on the X axis and a second series has data points at 0, 20, and 30, ColdFusion calculates and displays a data point for X=10 on the second series line, but it does not calculate an X=30 value for the first series.
For a pie chart, ColdFusion sets pie slice colors as follows:
  • If the seriesColor attribute is omitted, ColdFusion automatically colors the slices
  • If the seriesColor attribute is specified, ColdFusion automatically colors the slices after the first one, starting with the specified color for the first slice
  • If the colorList attribute is specified, ColdFusion colors the slices after the first one, according to the list

ColdFusion Generates an error if you use more than 16 chartseries tags in one cfchart tag.

TYPE  
  Required
 

Sets the chart display style:

  • bar
  • line
  • pyramid
  • area
  • cone
  • curve
  • cylinder
  • step
  • scatter
  • pie
QUERY  
  Optional
 

Name of ColdFusion query from which to get data.

ITEMCOLUMN  
  Required if query attribute is specified
 

Name of a column in the query specified in the query attribute; contains the item label for a data point to graph.

VALUECOLUMN  
  Required if query attribute is specified
 

Name of a column in the query specified in the query attribute; contains data values to graph.

SERIESLABEL  
  Optional
 

Text of data series label

SERIESCOLOR  
  Optional
 

Color of the main element (such as the bars) of a chart. For a pie chart, the color of the first slice.

Hex value or supported named color; see name list in the cfchart Usage section.

For a hex value, use the form "##xxxxxx", where x = 0-9 or A-F; use two pound signs or none.

PAINTSTYLE  
  Optional
 
Default value: "plain"

Sets the paint display style of the data series.

  • plain: solid color
  • raise: the appearance of a button
  • shade: gradient fill, darker at the edges
  • light: a lighter shade of color; gradient fill
MARKERSTYLE  
  Optional
 
Default value: "rectangle"

Applies to chartseries type attribute values line, curve and scatter, and show3D attribute value no.

Sets the icon that marks a data point:

  • rectangle
  • triangle
  • diamond
  • circle
  • letter
  • mcross
  • snow
  • rcross
COLORLIST  
  Optional
 

Applies if chartseries type attribute = "pie". Sets pie slice colors.

Comma-delimited list of hex values or supported, named web colors; see name list in the cfchart Usage section.

For a hex value, use the form "##xxxxxx", where x = 0-9 or A-F; use two pound signs or none.