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

New in ColdFusion MX: This tag is new.

 
Usage

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
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.