Lucee Tag Reference

<cfchart>

Generates and displays a chart.

Body

This tag may have a body.

Example

<cfchart
	[backgroundcolor=string]
	[categorylabelpositions=string]
	[chartheight=number]
	[chartwidth=number]
	[databackgroundcolor=string]
	[font=string]
	[fontbold=boolean]
	[fontitalic=boolean]
	[fontsize=number]
	[foregroundcolor=string]
	[format=string]
	[gridlines=number]
	[labelformat=string]
	[markersize=number]
	[name=string]
	[pieslicestyle=string]
	[scalefrom=number]
	[scaleto=number]
	[seriesplacement=string]
	[show3d=boolean]
	[showborder=any]
	[showlegend=boolean]
	[showmarkers=boolean]
	[showtooltip=boolean]
	[showxgridlines=boolean]
	[showxlabel=boolean]
	[showygridlines=boolean]
	[sortxaxis=boolean]
	[source=string]
	[style=string]
	[tipbgcolor=string]
	[tipstyle=string]
	[title=string]
	[url=string]
	[xaxistitle=string]
	[xaxistype=string]
	[xoffset=number]
	[yaxistitle=string]
	[yaxistype=string]
	[yoffset=number]>
[</cfchart>]

Attributes

The attributes for this tag are fixed. Except for the following attributes no other attributes are allowed.
Name Type Required Description
backgroundcolor string No Color of the area between the data background and the chart
border, around labels and around the legend. Hexadecimal
value or supported named color. For a hex value, use the form:
textColor = "##xxxxxx", where x = 0-9 or A-F; use two hash
signs or none. 
categorylabelpositions string No Label postion relative to axis: standard, up_45, up_90, down_45, down_90 or horizontal (standard) and vertical (down_90). Default is horizontal. 
chartheight number No Chart height; integer number of pixels 
chartwidth number No Chart width; integer number of pixels 
databackgroundcolor string No color for control. For a hex value, use the form:
textColor = "##xxxxxx", where x = 0-9 or A-F; use two hash
signs or none. 
font string No Font of data in column. 
fontbold boolean No Yes: displays grid control text in bold 
fontitalic boolean No Yes: displays grid control text in italics 
fontsize number No Size of text in column. 
foregroundcolor string No color for control. For a hex value, use the form:
textColor = "##xxxxxx", where x = 0-9 or A-F; use two hash
signs or none. 
format string No File format in which to save graph. 
gridlines number No Number of grid lines to display on value axis, including
axis; positive integer. 
labelformat string No Format for Y-axis labels. 
markersize number No Size of data point marker. in pixels. Integer. 
name string No Page variable name. String. Generates the the graph as
binary data and assigns it to the specified variable.
Suppresses chart display. You can use the name value in
the cffile tag to write the chart to a file. 
pieslicestyle string No Applies to chartseries type attribute value pie. 
scalefrom number No Y-axis minimum value; integer 
scaleto number No Y-axis max value; integer 
seriesplacement string No Applies to charts that have more than one data series.
Relative positions of series. 
show3d boolean No Display chart with three-dimensional appearance. 
showborder any No Whether to display a border around the chart or not (boolean), you can also define a color (string) instead. 
showlegend boolean No yes: if chart contains more than one data series, display
legend 
showmarkers boolean No Applies to chartseries type attribute values line, curve
and scatter.
yes: display markers at data points 
showtooltip boolean No show the tooltip or not 
showxgridlines boolean No yes: display X-axis gridlines 
showxlabel boolean No yes: shows the x-axis labels 
showygridlines boolean No yes: display Y-axis gridlines 
sortxaxis boolean No Display column labels in alphabetic order along X-axis.
Ignored if the xAxisType attribute is scale. 
source string No variable name of the source path, if set the path to the source file is returned and no image tag is written to response strea. 
style string No XML file or string to use to specify the style of the chart. 
tipbgcolor string No color for control. For a hex value, use the form:
textColor = "##xxxxxx", where x = 0-9 or A-F; use two hash
signs or none. 
tipstyle string No Determines the action that opens a popup window to display
information about the current chart element.
- mouseDown: display if the user positions the cursor at the element
and clicks the mouse. Applies only to Flash format graph files (Flash not supported).
- mouseOver: displays if the user positions the cursor at the element
- none: suppresses display 
title string No Title of the chart. 
url string No URL to open if the user clicks item in a data series; the
onClick destination page. 
xaxistitle string No text; X-axis title 
xaxistype string No - category The axis indicates the data category. Data is
sorted according to the sortXAxis attribute.
- scale The axis is numeric. All cfchartdata item attribute
values must numeric. The X axis is automatically sorted
numerically. 
xoffset number No Applies if show3D="yes". Number of units by which to
display the chart as angled, horizontally 
yaxistitle string No text; X-axis title 
yaxistype string No Currently has no effect, as Y axis is always used for data
values. Valid values are category and scale 
yoffset number No Applies if show3D="yes". Number of units by which to
display the chart as angled, horizontally.