Using the attributes of the cfchart and cfchartseries tags

File type

format

Whether to send the chart to the user as a JPEG, PNG, or SWF file. The SWF file is the default format.

All

Size

chartWidth
chartHeight

The width and height, in pixels, of the chart. This size defines the entire chart area, including the legend and background area around the chart.

The default height is 240 pixels; the default width is 320 pixels.

All

Color

foregroundColor
dataBackgroundColor
backgroundColor

The colors used for foreground and background objects.

The default foreground color is black; the default background colors are white.

You can specify 16 color names, use any valid HTML color format, or specify an 8-digit hexadecimal value to specify the RGB value and transparency. If you use numeric format, you must use double number signs; for example, blue or ##FF33CC. To specify the color and transparency, use the format ##xxFF33CC, where xx indicates the transparency. Opaque is indicated by the value FF; transparent is indicated by the value 00. For the complete list of colors, see Configuring and Administering ColdFusion MX.

All

Labels

font
fontSize
fontBold
frontItalic
labelFormat
xAxisTitle
yAxisTitle

The font attribute specifies the font for all text. The default value is Arial. If you are using a double-byte character set on UNIX, or using a double-byte character set in Windows with a file type of Flash, you must specify ArialUnicodeMs as the font.

Note: If a chart attempts to use a font that is not installed on the ColdFusion server, it uses a different font that is available. Also, if you do not specify the font, characters that are not ASCII, such as Japanese, Chinese, Korean and so on, may not display properly.

The fontSize specifies an Integer font size used for all text. The default value is 11.

The fontBold attribute specifies to display all text as bold. The default value is no.

The fontItalic attribute specifies to display all text as italic. The default value is no.

The labelFormat attribute specifies the format of the y-axis labels, number, currency, percent, or date. The default value is number.

The xAxisTitle and yAxisTitle attributes specify the title for each axis.

All

Border

showBorder

Use the showBorder attribute to draw a border around the chart. The border color is specified by the foregroundColor attribute. The default value is no.

All

Grid lines

showXGridlines
showYGridlines
gridLines

Use the showXGridlines and showYGridlines attributes to display
x-axis and y-axis grid lines. The default value No for x-axis gridlines, and Yes for y-axis gridlines.

The gridLines attribute specifies the total number of grid lines on the value axis, including the axis itself. The value of each grid line appears along the value axis. The cfchart tag displays horizontal grid lines only. A value of 0 (the default) means no grid lines.

Area
Bar
Cone
Curve
Cylinder
Horizontalbar
Line
Pyramid
Scatter
Step

Slice style

pieSliceStyle

Displays the pie chart as solid or sliced. The default value is sliced.

Pie

Markers

showMarkers
markerSize

The showMarkers attribute displays markers at the data points for two dimensional line, curve, and scatter charts. The default value is yes.

The markerSize attribute specifies an integer number of pixels for the marker size. ColdFusion determines the default value.

All

Value axis

scaleFrom
scaleTo

The minimum and maximum points on the data axis.

By default, the minimum is 0 or the lowest negative chart data value, and the maximum is the largest data value.

Note: If you specify a scaleFrom or scaleTo attribute that would result in cropping the chart, cfchart uses a value that shows the entire chart without cropping.

Area
Bar
Cone
Curve
Cylinder
Horizontalbar
Line
Pyramid
Scatter
Step

Axis type

XAxisType
sortXAxis

Whether the x-axis corresponds to a numeric scale or identifies different categories, and how to sort the items on the axis.

If the XAxisType attribute value is scale, the x-axis is numeric. All cfchartdata item attribute values must be numeric, and the axis is automatically sorted numerically. The scale value lets you create graphs of numeric relationships, such as population against age.

If the attribute value is category (the default), the axis indicates the data category.

The sortXAxis attribute determines the order of items when you specify the cfchartdata item attribute, whose values are treated as text. By default, the items are displayed in the order in which they are entered in the first chart series.

Area
Bar
Cone
Curve
Cylinder
Horizontalbar
Line
Pyramid
Scatter
Step

3D appearance

show3D
xOffset
yOffset

The show3D attribute displays the chart in three dimensions. The default value is No.

The xOffset and yOffset attributes specify the amount to which the chart should be rotated on a horizontal axis (xOffset) or vertical axis (yOffset). The value 0 is flat (no rotation), -1 and 1 are for a full 90 degree rotation left
(-1) or right (1). The default value is 1.

All

Multiple series

showLegend
seriesPlacement

The showLegend attribute lets you display the chart's legend when the chart contains more than one series of data. The default value is Yes.

The seriesPlacement attribute specifies the location of each series relative to the others. By default, ColdFusion determines the best placement based on the graph type of each series.

All

Tips

tipStyle
tipBGColor

The tipStyle attribute lets you display a small pop-up window that shows information about the chart element pointed to by the mouse pointer. Options are none, mousedown, or mouseover. The default value is mouseover.

The tipBGColor attribute specifies the background color of the tip window for Flash format only. The default value is white.

All

Multiple series

seriesLabel
seriesColor

The seriesLabel attribute specifies the text that displays for the series label.

The seriesColor attribute specifies a single color of the bar, line, pyramid, and so on. For pie charts, this is the first slice's color. Subsequent slices are automatically colored based on the specified initial color, or use the colorList attribute.

All

Paint

paintStyle

Specifies the way color is applied to a data series. You can specify solid color, buttonized look, linear gradient fill with a light center and darker outer edge, and gradient fill on lighter version of color. The default value is solid.

All

Data point colors

colorList

A comma-separated list of colors to use for each data point for bar, pyramid, area, horizontalbar, cone, cylinder, step, and pie charts.

You can specify 16 color names, use any valid HTML color format, or specify an 8-digit hexadecimal value to specify the RGB value and transparency. If you use numeric format, you must use double number signs; for example, blue or ##FF33CC. To specify the color and transparency, use the format ##xxFF33CC, where xx indicates the transparency. Opaque is indicated by the value FF; transparent is indicated by the value 00. For the complete list of colors, see Configuring and Administering ColdFusion MX.

If you specify fewer colors than data points, the colors repeat. If you specify more colors than data points, the extra colors are not used.

Pie

Data markers

markerStyle

Specifies the shape used to mark the data point. Shapes include circle, diamond, letterx, mcross, rcross, rectangle, snow, and triangle. Supported for two-dimensional charts. The default value is rectangle.

Curve
Line
Scatter

Labels

dataLabelStyle

Specifies the way in which the color is applied to the item in the series Styles include None, Value, Rowlabel, Columnlabel, and Pattern.

All