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.