CFCHART | |||||||||||||||||||||||||||||||||||
Description
Generates and displays a chart. |
|||||||||||||||||||||||||||||||||||
Category
Data output tags, Extensibility tags | |||||||||||||||||||||||||||||||||||
Syntax<cfchart format = "flash, jpg, png" chartHeight = "integer number of pixels" chartWidth = "integer number of pixels" scaleFrom = "integer minimum value" scaleTo = "integer maximum value" showXGridlines = "yes" or "no" showYGridlines = "yes" or "no" gridlines = "integer number of lines" seriesPlacement = "default, cluster, stacked, percent" foregroundColor = "Hex value or Web color" dataBackgroundColor = "Hex value or Web color" borderBackgroundColor = "Hex value or Web color" showBorder = "yes" or "no" font = "font name" fontSize = "integer font size" fontBold = "yes" or "no" fontItalic = "yes" or "no" labelFormat = "number, currency, percent, date" xAxisTitle = "title text" yAxisTitle = "title text" sortXAxis = "yes/no" show3D = "yes" or "no" xOffset = "number between -1 and 1" yOffset = "number between -1 and 1" rotated = "yes/no" showLegend = "yes/no" tipStyle = "MouseDown, MouseOver, Off" tipBGColor = "hex value or web color" showMarkers = "yes" or "no" markerSize = "integer number of pixels" pieSliceStyle = "solid, sliced" url = "onClick destination page" name = "String" </cfchart> | |||||||||||||||||||||||||||||||||||
See also
cfchartdata, cfchartseries |
|||||||||||||||||||||||||||||||||||
History
New in ColdFusion MX: This tag is new.
|
|||||||||||||||||||||||||||||||||||
Usage
The cfchart tag defines a "container" in which a graph displays: its height, width, background color, labels, and so on. The cfchartseries tag defines the style in which data displays: bar, line, pie, and so on. The cfchartdata tag defines a data point. Data is passed to the cfchartseries tag in the following ways:
For the font attribute value "ArialUnicodeMS", the following rules apply:
The color attributes accept the following W3C HTML 4 named color value or hex values:
For all other color values, you must enter the hex value. For more color names that are supported by popular browsers, see: http://www.w3.org/TR/css3-color Flash does not conform fully to UNIX X11 naming conventions. You can specify whether charts are cached in memory, the number of charts to cache, and the number of chart requests that ColdFusion can process concurrently. To set these options: in the ColdFusion Administrator, select Server Settings > Charting. |
FORMAT | |
Default value: "flash"
File format in which to save graph.
|
CHARTHEIGHT | |
Default value: "240"
Chart height; integer number of pixels |
CHARTWIDTH | |
Default value: "320"
Chart width; integer number of pixels |
SCALEFROM | |
Default value: "Determined by data"
Y-axis minimum value; integer. |
SCALETO | |
Default value: "Determined by data"
Y-axis maximum value; integer |
SHOWXGRIDLINES | |
Default value: "no"
|
SHOWYGRIDLINES | |
Default value: "yes"
|
GRIDLINES | |
Default value: "3 (top, bottom, and zero)"
Number of grid lines to display on value axis, including axis; positive integer. 0: hide gridlines |
SERIESPLACEMENT | |
Default value: "default "
Applies to charts that have more than one data series. Relative positions of series.
|
FOREGROUNDCOLOR | |
Default value: "black"
Color of text, gridlines, and labels. Hex value or supported named color; see name list in the Usage section. For a hex value, use the form "##xxxxxx", where x = 0-9 or A-F; use two pound signs or none. |
DATABACKGROUNDCOLOR | |
Default value: "white"
Color of area around chart data. Hex value or supported named color; see name list in the Usage section. For a hex value, use the form "##xxxxxx", where x = 0-9 or A-F; use two pound signs or none. |
BORDERBACKGROUNDCOLOR | |
Default value: "white"
Color of area between data background and border, around labels and around legend. Hex value or supported named color; see name list in the Usage section. For a hex value, use the form "##xxxxxx", where x = 0-9 or A-F; use two pound signs or none. |
SHOWBORDER | |
Default value: "no"
|
FONT | |
Default value: "arial "
Name of text font
|
FONTSIZE | |
Default value: "11"
Font size; integer |
FONTBOLD | |
Default value: "no"
|
FONTITALIC | |
Default value: "no"
|
LABELFORMAT | |
Default value: "number"
Format for Y-axis labels.
|
XAXISTITLE | |
text; X-axis title |
YAXISTITLE | |
text; Y-axis title |
SORTXAXIS | |
Default value: " no"
|
SHOW3D | |
Default value: "no"
|
XOFFSET | |
Default value: "0.1"
Applies if show3D="yes". Number of units by which to display the chart as angled, horizontally.
|
YOFFSET | |
Default value: "0.1 "
Applies if show3D="yes". Number of units by which to display the chart as angled, vertically.
|
ROTATED | |
Default value: "no"
|
SHOWLEGEND | |
Default value: "yes"
|
TIPSTYLE | |
Default value: "mouseOver"
Determines the action that opens a popup window to display information about the current chart element.
|
TIPBGCOLOR | |
Default value: "white"
Applies only to Flash format graph file. Hex value or supported named color; see name list in the Usage section. For a hex value, use the form "##xxxxxx", where x = 0-9 or A-F; use two pound signs or none. |
SHOWMARKERS | |
Default value: "yes "
Applies to chartseries type attribute values line, curve and scatter.
|
MARKERSIZE | |
Default value: "(Automatic)"
Size of data point marker. in pixels. Integer. |
PIESLICESTYLE | |
Default value: "sliced"
Applies to chartseries type attribute value pie.
|
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.
For example: "somepage.cfm?item=$ITEMLABEL$&series=$SERIESLABEL$&value=$VALUE$"
|
NAME | |
Page variable name. String. Outputs ISO-8859-1 encoded binary graph data and sets it as a variable in the page. Suppresses chart display. Used primarily by Flash Gateway users. |