cfchartseries

Used with the cfchart tag. This tag defines the style in which chart data displays: bar, line, pie, and so on.

Data output tags, Extensibility tags

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

cfchart, cfchartdata

ColdFusion MX 6.1: Changed interpolation behavior: the tag now interpolates data points on line charts with multiple series.

ColdFusion MX: Added this tag.

Attribute Req/Opt Default Description

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

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

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.

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:

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

View comments on LiveDocs