Element Details: Chart.XY
 Back


Available in: Logi Info Source code name: Chart.XYDeprecated in 12.2

Creates a grid-type chart, such as a line chart, area chart, or bar chart.

Element Group:Charts, Gauges and GIS Maps



ATTRIBUTES

Click attribute Name to drill down for more information.

NamePossible ValuesDescription
AltText
UserDefined
The Alternate Text is displayed when the browser options have images turned off. The text is also used by browsers that convert text to speech or braille output.
AreaGradientColor
UserDefined
Sets the gradient color for the Area charts. This is the end Color for gradient effect. Enter a color by name, decimal RGB value, or hex RGB value. Prefix hex values with the pound sign, like #112233. e.g. If you want a gradient effect of green to light green, set the area color to green and the area gradient color to light green. Animated Charts have a default white gradient. For a single series chart, you can set this to a color which will be applied as the gradient. For multi series, white is the only gradient option. For no gradient on a multi-series chart, set this to any value.
BackgroundColor
UserDefined
Transparent
Sets the background color of the element. Enter a color by name, decimal RGB value, or hex RGB value. Prefix hex values with the pound sign, like #112233.
BarColorDataColumn
UserDefined
Set this to a column containing color values returned from the DataLayer. The corresponding bar is set to that color value. Only used by Static Bar Charts.
BarShading
TopLight
TopGlare
RightLight
RightGlare
LeftLight
LeftGlare
BottomLight
BottomGlare
Use this attribute to add Glass and soft Lighting Effect to bars in Static Bar Charts. The user can select the direction (left, right, top, bottom) and the style (Glare for Glass and Light for soft Lighting) to set the effect.
BarShape
TriangleRight
TriangleLeft
TriangleInverted
Triangle
Star6
Star5
Star4
Star3
Square
Pentagon
Hexagon
Circle
For Bar charts, sets the shape of the bars. Shaped bars look best when the 3-dimensional attribute is used.
BarWidth
UserDefined
Sets the width of bars for bar charts. By default, bar widths are determined automatically. This applies to only single bars. When the extra bar is set to SideBySide, this attribute takes no effect.
BorderBottom
UserDefined
The border is the distance between the edge of the chart's image, and the chart itself. The value is in pixels. Use a border to leave room for labels or a legend.
BorderColor
UserDefined
Transparent
Sets the color of border lines. Enter a color by name, decimal RGB value, or hex RGB value. Prefix hex values with the pound sign, like #112233.
BorderLeft
UserDefined
The border is the distance between the edge of the chart's image, and the chart itself. The value is in pixels. Use a border to leave room for labels or a legend.
BorderRight
UserDefined
The border is the distance between the edge of the chart's image, and the chart itself. The value is in pixels. Use a border to leave room for labels or a legend.
BorderTop
UserDefined
The border is the distance between the edge of the chart's image, and the chart itself. The value is in pixels. Use a border to leave room for labels or a legend.
ChartBackgroundColor
Transparent
Sets the background color of the chart plot area. You may specify "Transparent". Enter a color by name, decimal RGB value, or hex RGB value. Prefix hex values with the pound sign, like #112233. For grid-style charts, alternate between two colors by supplying both, separated by a comma. For example: Red,Blue For a metallic look in charts, add "Metallic" to the color. For example: RedMetallic,BlueMetallic
ChartBackgroundGradientColor
UserDefined
Sets the background gradient color of the chart plot area. This is the end Color for gradient effect. Enter a color by name, decimal RGB value, or hex RGB value. Prefix hex values with the pound sign, like #112233. e.g. If you want a gradient effect of green to light green, set the chart background color to green and the background gradient color to light green.
ChartDataColumn
UserDefined
(Required) Set this to a column returned from the DataLayer. It represents the data value for each item charted. These are listed across the y-axis.
ChartHeight
UserDefined
(Required) The height of the chart image, in pixels.
ChartLabelColumn
UserDefined
Set this to a column returned from the DataLayer. It represents the name of each item, or data value, charted. For charts with x and y axes, these are listed across the x-axis.
ChartLabelColumnDataType
Text
Number
Date
Auto
Use this attribute to set DataType on the Chart Label Column X-axis. Set this to Text if you want the Date Labels on the X-axis to be treated as plain text instead. For example, if X-axis value appears as "12-03", set the attribute to "Text" to preserve that value.
ChartOrientation
Vertical
Horizontal
Allows swapping of the X and Y coordinates. The default value is Vertical, meaning data points are plotted on the Y-axis and labels are listed across the X-axis.
ChartSymbol
SymbolX
SymbolTriangle
SymbolSquare
SymbolSolidSphere
SymbolGlassSphere2
SymbolGlassSphere
SymbolDiamond
SymbolCross
SymbolCircle
A symbol that identifies each data point on the chart. For XY charts, this can be used only for the Line and Spline charts to identify data points. When using a Crosstab Filter under the Chart's DataLayer, use comma-separated symbol values to assign different symbol values for each crosstab.
ChartSymbolEdgeColor
UserDefined
The color of the outside edge of the symbols. For Area charts, this is the color of the outside edge of the area chart layer, while for bar charts it is the edge color of each bar in the layer. Animated Bar Charts with Bar Style = Rounded Edge will ignore this attribute. Enter a color by name, decimal RGB value, or hex RGB value. Prefix hex values with the pound sign, like #112233.
ChartSymbolSize
UserDefined
The size, in pixels, of a chart symbol. You can make a scatter into a bubble chart. Instead of a specific number, specify a numeric column returned with the data. The default is 4.
ChartTitle
UserDefined
The title of the chart. It appears at the top of the chart image. You can use CDML tags directly in the chart title string to specify different font colors, size etc. Expected tag format is <*font=fontname,color=hexcolorname,size=fontsize*> or simply <*color=hexcolorname*> for just changing the color of the text after the tag. e.g. <*font=Verdana,color=000000,size=12*>Text Part 1 <*color=999999*> Text Part 2 or <*color=000000*>Text Part 1<*color=999999*>Text Part 2<*color=4c4c4c*>Text Part 3.
ChartWidth
UserDefined
(Required) The width of the chart, usually in pixels. For ChartCanvas charts, the value may be a percentage, by specifying the value like "50%".
Color
UserDefined
Sets the element's color. Enter a color by name, decimal RGB value, or hex RGB value. Prefix hex values with the pound sign, like #112233. For bar charts, each bar can be a different color by entering multiple colors, each separated by a comma. When using a Crosstab Filter under the Chart's DataLayer, use comma-separated colors and a Legend element so each crosstab set can be identified.
D3
UserDefined
False
2
15
Indicates if the chart, or chart layer, is displayed in a 3-dimensional format. Set the value to False or 0 for a flat appearance. For animated charts, the value can be True or False. For other elements, the value is in pixels, so the larger the value, the thicker the 3-D effect.
ExtraBarOptions
Stacked
SideBySide
Set Extra Bar Options to "Side By Side" to display the extra bars side-by-side. Otherwise, they are stacked. You can set Extra Bar Options in the Chart element, or the Extra Data Column element(s). When set for the Chart, the value becomes the default in the Extra Data Columns.
GridHorizontalColor
Transparent
Sets the color of a chart's horizontal grid marks. The default value is black for static charts and grey for animated charts. For Polar Charts, this attribute sets the color of the chart's angular grid marks. Enter a color by name, decimal RGB value or hex RGB value. Prefix hex values with the pound sign, like #112233.
GridVerticalColor
Transparent
Sets the color of a chart's vertical grid marks. The default value is Transparent. For Polar Charts, this attribute sets the color of the chart's radial grid marks. Enter a color by name, decimal RGB value, or hex RGB value. Prefix hex values with the pound sign, like #112233. In the animated scatter plot, the color will only be applied and vertical lines shown when "No. Vertical Lines" attribute is set. The default value for animated scatter plots is grey.
ID
UserDefined
The ID attribute is a pervasive attribute that uniquely identifies an element within a definition file. The ID needs to be a unique value within the definition.
LegendLabel
UserDefined
Indicates text that will be shown for this layer inside the chart legend.
LineColorDataColumn
UserDefined
Set this to a column returned from the DataLayer. It represents the Color Change for the Line at each item, or data value. Only used by Static Line Charts.
LineStyle
SolidLine
LargeDashLine
LargeDashDotLine
DoubleDashLine
DotSpaceDotLine
DotLine
DotDashLine
DashLine
The style of the chart's line. This is used to change the pattern on the line. It can be set to dots, dashes or a combination of the two.
LineStyleDataColumn
UserDefined
Set this to a column returned from the DataLayer. It represents the Line Style change at each item, or data value. Only used by Static Line Charts.
LineWidth
UserDefined
The width of the line, in pixels.
MaxLabelLength
UserDefined
The maximum number of characters that will be displayed for a label before the text is trimmed and the remainder replaced with an ellipsis (...).
OuterBorderColor
UserDefined
Transparent
Use this attribute to set the Outer Border Color of the chart canvas. Enter a color by name, decimal RGB value, or hex RGB value. Prefix hex values with the pound sign, like #112233.
RoundedBorder
UserDefined
Use this attribute to set a chart with rounded frame borders. Select a value in pixels, to set the radii of the 4 corners of the chart frame border.
SecurityRightID
UserDefined
When entered, access to this element can be controlled with Logi security. Supply the ID of a right defined in the applications settings’ Security element. Only users that have a right in the SecurityRightID will be able to see the element. Note that when rights come from RightFromRole elements under Security/UserRights, and this element's SecurityRightID does NOT match any of the Right IDs defined in the Settings definition, then the user DOES have access. But when Right IDs are instead derived from RightsFromDataLayer or RightsFromRoles elements, and the user DOES NOT have a matching Right, then the user DOES NOT have access. You can enter multiple right IDs, separated by commas. In this case, the user sees the element if he has any one of the Rights.
ShowDataValues
True
False
Indicates if the values of each data point should be shown on the chart. For TrendLines, displays the line's slope value.
ShowWaitIcon
True
False
Some charts can take significant time to run on the server and display in the browser. The wait icon shows a spinning image informing the user that chart content is coming. To not show the wait icon, set ShowWaitIcon="False". The default is "True".
StackedBarLabels
Individual
Aggregate
Set Stacked Bar Labels to "Individual" to display individual values in each bar, instead of the single aggregate value at the top of the stack. The individual values will appear inside each bar, and will not be displayed for some bars, if there is not enough room to render the text. Default value is Aggregate.
Tooltip
UserDefined
Text that appears when the user hovers the pointer over the image or text.
Transparency
UserDefined
7
15
0
Indicates a level of transparency of the element. The lowest value of 0 indicates that the element is opaque, with no transparency. The other end of the scale, 15, indicates a completely transparent element. Use medium-level transparency to allow different chart layers to show through each other.
WallpaperImage
UserDefined
Specifies an image used to wallpaper the chart image's background.
XAxisTitle
UserDefined
The title text that will appear along the chart's data axis.
XYChartType
Spline
Line
Bar
Area
(Required) The type of grid chart; bar, line, splined line, or area.
YAxisTitle
UserDefined
The title text that will appear along the chart's label axis.



PARENT ELEMENTS

Click element to drill down for more information.



CHILD ELEMENTS

Click element to drill down for more information.

Action.Dial Phone
Action.Draft Email
Action.Draft Text Message
Action.Exit
Action.Export CSV
Action.Export Native Excel
Action.Export Native Word
Action.Export PDF
Action.Export Word Or Excel
Action.Export XML
Action.Google Spreadsheet
Action.Javascript
Action.Link
Action.Map Location
Action.Process
Action.Refresh Element
Action.Report
Action.Show Element
Action.Template
Action.Widget
Auto Sizer
Chart Title Font
Data Font
Data Scale
Data Title Font
DataLayer.Cached
DataLayer.CSV
DataLayer.Definition List
DataLayer.Directory
DataLayer.Excel
DataLayer.Fixed Format File
DataLayer.Google App
DataLayer.Google Spreadsheet
DataLayer.JSON
DataLayer.LDAP
DataLayer.Linked
DataLayer.Mongo Find
DataLayer.Mongo Map Reduce
DataLayer.Mongo Run Command
DataLayer.Plugin
DataLayer.REST
DataLayer.SP
DataLayer.SQL
DataLayer.Static
DataLayer.Twitter
DataLayer.Web Feed
DataLayer.Web Scraper
DataLayer.Web Service
DataLayer.XML
Extra Data Column
Extra Grid Layer
Format Data
Group Drillthrough
Hover Highlight
Label Font
Label Scale
Label Title Font
Legend
Lowess Curve Line
Marks
Quicktip
Resizer
Secondary Data Axis
Trend Line
Zero Rows Message
Zoom Chart


 Back to top


 Chart Debug