cfchart

Overview ColdFusion Open BlueDragon Lucee

Generates and displays a chart.

Attributes

Name Required Type Default Description
10
alpha No Numeric Opacity of the graph background
10
arrows No Array Creates arrows to indicate chart data
10
aspect3d No Struct Specifies 3D angle and depth
10
background No Struct Background properties
backgroundcolor No String 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.
10
bevel No Any Indicates if bevel properties be displayed. Could be Boolean or Struct
10
border No Struct Border specifications
4
categorylabelpositions 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 No Numeric 240 Chart height; integer number of pixels
chartwidth No Numeric 320 Chart width; integer number of pixels
10
crosshair No Struct Declares properties for crosshair
databackgroundcolor No String white 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.
10
fill No Struct Fill specifications
font No String arial Font of data in column.
fontbold No Boolean false Yes: displays grid control text in bold
fontitalic No Boolean false Yes: displays grid control text in italics
fontsize No Numeric Size of text in column.
foregroundcolor No String black 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 No String flash Display format of the chart
gridlines No Numeric 10 Number of grid lines to display on value axis, including axis; positive integer.
10
height No Numeric Height of the chart in pixels. Default is 240
labelformat No String number Format for Y-axis labels.
10
labels No Array Displays custom text/images on the chart
10
legend No Struct Specifies legend style
3
legendmultiline No
markersize No Numeric Size of data point marker. in pixels. Integer.
maxcategorylabellines No The total maximum category label lines for the chart that are visible
maxcategorylabelwidthratio No Sets the maximum category label width, expressed as a percentage of (a) the category label rectangle, or (b) the length of the range axis.
name No String 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.
path No The path for the link to be seen to be coming from
pieslicestyle No String sliced Applies to chartseries type attribute value pie.
10
plot No Struct Globally customizes styling and chart series features
10
plotarea No Struct Defines characteristic of plot area
10
preview No Struct Struct that contains style attributes of the preview area, including zoom controls
10
query No Query Name of CFML query from which to get data.
10
refresh No Struct Refresh interval and feed URL etc. for the chart
10
renderer No String Canvas Speifies rendering engine
rotated No Boolean This attribute is deprecated.yes: rotate chart 90 degrees. For a horizontal bar chart,use this option.
scalefrom No Numeric Y-axis minimum value; integer
10
scales No String Specifies scales a dataset should be plotted against.
scaleto No Numeric Y-axis max value; integer
seriesplacement No String default Applies to charts that have more than one data series. Relative positions of series.
show3d No Boolean true Display chart with three-dimensional appearance.
showborder No Boolean false Whether to display a border around the chart
showlegend No Boolean true yes: if chart contains more than one data series, display legend
showmarkers No Boolean true Applies to chartseries type attribute values line, curve and scatter. yes: display markers at data points
3
showtooltip No show the tooltip or not
showxgridlines No Boolean false yes: display X-axis gridlines
3
showxlabel No yes: shows the x-axis labels
showygridlines No Boolean true yes: display Y-axis gridlines
sortxaxis No Boolean false Display column labels in alphabetic order along X-axis. Ignored if the xAxisType attribute is scale.
3
source 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 No String XML file or string to use to specify the style of the chart.
symbolsseparator No Character used to seperate list of YAXISSYMBOLS provided
tipbgcolor No String white 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 No String mouseOver 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. * mouseOver: displays if the user positions the cursor at the element * none: suppresses display
title No String Title of the chart.
10
tooltip No Struct Tooltip styles for the chart
10
type No String Tooltip styles for the chart
URL No URL URL to open if the user clicks item in a data series; the onClick destination page. You can specify variables within the URL string; ColdFusion passes current values of the variables. * $VALUE$: the value of the selected row. If none, the value is an empty string. * $ITEMLABEL$: the label of the selected item. If none, the value is an empty string. * $SERIESLABEL$: the label of the selected series. If none, the value is an empty string.
10
width No Numeric Chart width in pixels
10
xaxis No Struct Defines X Axis style
10
xaxis2 No Struct Details for the second X Axis (at the top of the chart)
xaxistitle No String text; X-axis title
xaxistype No String category * 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.
xaxisuppermargin No Used to set the x axis upper margin. Used to prevent labels from not being displayed correctly.
10
xaxisvalues No Array Declares X Axis values
xoffset No Numeric 0.1 Applies if show3D="yes". Number of units by which to display the chart as angled, horizontally
10
yaxis No Struct Defines Y Axis style
10
yaxis2 No Struct Details for the second Y Axis (to the right of the chart)
yaxissymbols No Delimited list of symbols to be used as the Y axis label
yaxistitle No String text; X-axis title
yaxistype No String category Currently has no effect, as Y axis is always used for data values. Valid values are category and scale
yaxisuppermargin No Used to set the y axis upper margin. Used to prevent labels from not being displayed correctly.
10
yaxisvalues No Array Declares Y Axis values
yoffset No Numeric 0.1 Applies if show3D="yes". Number of units by which to display the chart as angled, horizontally.
10
zoom No Struct Specifies zoom style