search
Back to amCharts.com
Table of Contents
Scatter & bubble settings
This section contains a list of all settings available for Scatter & Bubble (XY) chart.
<settings>
These are general settings (not depending to any subsection) that apply to the entire chart.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| data_type | xml/csv | xml | The format of the data. This tells the software how to interpret the data it finds. |
| csv_separator | some symbol | ; | The character that will separate columns in a CSV file. |
| skip_rows | number | 0 | If you are using a CSV file, this setting allows you to skip the first several rows of the file (for example, if it contains metadata). |
| font | font name | Arial | The font of the text that will be displayed in the chart. Make sure to use common device font names |
| text_size | number | 11 | The size of the text that will be displayed in the chart. |
| text_color | hex color code | #000000 | The color of the text that will be displayed in the chart. More about hex color codes. |
| decimals_separator | some symbol | , | The character that will separate the whole digits from the decimal digits in a number. |
| thousands_separator | some symbol | Empty space | The character that will separate each three whole digits in a number (counting right-to-left from the decimal). |
| scientific_min | number | 0.000001 | If absolute value of your number is equal or less then scientific_min, this number will be formatted using scientific notation, for example: 0.0000023 → 2.3e-6 |
| scientific_max | number | 1000000000000000 | If absolute value of your number is equal or bigger then scientific_max, this number will be formatted using scientific notation, for example: 15000000000000000 → 1.5e16 |
| digits_after_decimal | number | 0 | If a value has less digits after the decimal separator than this number, zeroes will be added to the end. For example, if this is set to 2 and you have a value of 15.6, then the viewer will see it as 15.60. This is useful for charts showing prices, etc. |
| reload_data_interval | number, in seconds | 0 | How often the chart will reload the data. This is useful if your data is updated very often, and you want to show the change in data without reloading the page. |
| redraw | true/false | false | If your chart’s width and height is set in percent, and this is set to true, the chart will be resized proportionally when the browser window is resized. |
| add_time_stamp | true/false | false | If this is set to true, a timestamp will be added to the data file name every time data is loaded. This is useful if you are using dynamic data and the reload_data_interval setting. It is also useful if your data file changes frequently and you want the data to be reloaded every time the viewer reloads the page – otherwise the data might be cached in their browser. |
| precision | Number | 2 | How many decimal places will be shown for values which are calculated by the software (percent values). This does not affect the contents of the data file. |
| preloader_on_reload | true/false | false | If this is set to true, progress bar will be shown while data is being reloaded. |
| depth | number, in pixels | 0 | The depth of the chart (this creates a 3D effect). |
| angle | number, in degrees | 30 | The angle of the chart (this creates a 3D effect). |
| link_target | _blank, _top… | none – link opens in the same window | The target parameter of the bullet URL, if any. Use "_blank" to open the URL in a new browser window. |
| mask | true/false | true | If this is set to true, the plot area will be masked off. This means that any bubble or data label that is too big to fit in the plot area will be cropped. |
| colors | hex color codes | #FF6600, #FCD202, #B0DE09, #0D8ECF, #2A0CD0, #CD0D74, #CC0000, #00CC00, #0000CC, #DDDDDD, #999999,#333333,#990000 | These colors will be used if the graph's color is not set. |
<background>
This subsection lists the settings that control the chart's background.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| color | hex color code | #FFFFFF | The color of the chart background. You can use multiple color codes, separated with commas - this will produce a gradient. |
| alpha | number (0-100) | 0 | Background opacity. This applies to the background color. Set this to 0 if you are using a custom SWF (Flash object) or JPG image as a background. Set it to a higher number if you are using a background color. If this is set to 0, the background color defined in the HTML code snippet is used. |
| border_color | hex color code | #FFFFFF | The color of the chart's outer border. |
| border_alpha | number (0-100) | 0 | The opacity of the chart's outer border. |
| file | filename | none | The name of the SWF or JPG file that will be used as the background image. The file must be placed in the "path" folder. |
<plot_area>
This subsection determines the look of the area between the axes – the area where the chart will be drawn.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| color | hex color code | #FFFFFF | The background color of the plot area. You can use multiple color codes, separated with commas - this will produce a gradient. |
| alpha | number (0-100) | 0 | The opacity of the plot area's background. Change this from 0 to make the plot area background different from the chart background. |
| border_color | hex color code | #000000 | The color of the plot area's borders. |
| border_alpha | number (0-100) | 0 | The opacity of the plot area's borders. |
<margins>
This subsection determines the size of the plot area margins.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| left | number, in pixels | 60 | The size of the left margin. |
| top | number, in pixels | 60 | The size of the top margin. |
| right | number, in pixels | 60 | The size of the right margin. |
| bottom | number, in pixels | 80 | The size of the bottom margin. |
<grid>
This subsection lists settings that control the chart grid. Category refers to the base axis (horizontal axis for a column chart), value refers to the value axis (vertical axis for a column chart).
<x>
This subsection lists settings that control the value axis of the chart.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| color | hex color code | #000000 | The color of the grid lines. |
| alpha | number (0-100) | 15 | The opacity of the grid lines. |
| dashed | true/false | false | If this is set to true, the grid lines will not be continuous. They will look like a line of dashes (– – – –). Attention! It is strongly not recommended to use dashed gridlines if the zoom is turned on. This might cause your script run slowly or even stop the script. |
| dash_length | number, in pixels | 5 | The length of each dash. |
| approx_count | number | 10 | The approximate number of gridlines. |
<y>
This subsection lists settings that control the value axis of the chart.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| color | hex color code | #000000 | The color of the grid lines. |
| alpha | number (0-100) | 15 | The opacity of the grid lines. |
| dashed | true/false | false | If this is set to true, the grid lines will not be continuous. They will look like a line of dashes (– – – –). Attention! It is strongly not recommended to use dashed gridlines if the zoom is turned on. This might cause your script run slowly or even stop the script. |
| dash_length | number, in pixels | 5 | The length of each dash. |
| approx_count | number | 10 | The approximate number of gridlines. |
<values>
This subsection lists settings that control the way values on the axes are displayed. Category refers to the base axis (horizontal axis for a column chart), value refers to the value axis (vertical axis for a column chart).
<x>
This subsection lists settings that control x-axis values.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| enabled | true/false | true | If this is set to true, axis values will be shown. |
| type | number/date/duration | number | The formatting of the values on the axis. "date" means that your axis will display dates (you must specify date formats in <date_formats> subsection). "duration" means that your numbers will be formatted as time, for example 130 seconds can be displayed as 02:10 or as 02 min 10 s (you can setup units in <strings>). The unit of duration in data file is set in <date_formats><duration_input> |
| reverse | true/false | false | If this is set to true, the values will be reversed on the value axis – the largest value will be placed closest to the point where the category and value axes intersect. The chart will be re-plotted accordingly. |
| rotate | number (0-90) | 0 | The angle of rotation for the values. You can rotate them by 90 degrees with no additional requirements. If you want to rotate the values by 1 to 89 degrees, you must have the SWF file for that font, placed in the [path]/fonts folder. More about rotating axis values. |
| min | number | none – calculated automatically | The minimum value of the value axis. The axis will always start from this value, even if there is no data point mapped that far. |
| max | number | none – calculated automatically | The maximum value of the value axis. The axis will always end at this value, even if there is no data point mapped that far. |
| strict_min_max | true/false | false | If this is set to true, the axis will stay between Min and Max values even if there are data points beyond those values. The parts of the chart that do not fit will be cropped. If this is set to false, the Min and Max values will be extended to fit the chart. |
| frequency | Number | 1 | The ratio of shown values to value axis grid lines. 1 means a value will be shown at every grid line; 2 means a value will be shown at every second grid line, etc. The higher the number, the less values will be shown. |
| skip_first | true/false | true | If this is set to true, the first value will be skipped. |
| skip_last | true/false | false | If this is set to true, the last value will be skipped. |
| color | hex color code | Same as <text_color> in general settings | The color of the text. |
| text_size | number | Same as <text_size> in general settings | The size of the text. |
| unit | text | none | A short text indicating the units of the values. This can be something like "USD" or "km/h". |
| unit_position | left/right | right | Whether the units will be shown to the left of the value or to the right. |
| integers_only | true/false | false | If this is set to true, only whole values will be shown. Values with decimals will be hidden. |
| inside | true/false | false | If this is set to true, the values of this axis will be displayed inside the plot area. |
<y>
This subsection lists settings that control the y-axis values.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| enabled | true/false | true | If this is set to true, axis values will be shown. |
| type | number/date/duration | number | The formatting of the values on the axis. "date" means that your axis will display dates (you must specify date formats in <date_formats> subsection). "duration" means that your numbers will be formatted as time, for example 130 seconds can be displayed as 02:10 or as 02 min 10 s (you can setup units in <strings>). The unit of duration in data file is set in <date_formats><duration_input> |
| reverse | true/false | false | If this is set to true, the values will be reversed on the value axis – the largest value will be placed closest to the point where the category and value axes intersect. The chart will be re-plotted accordingly. |
| rotate | number (0-90) | 0 | The angle of rotation for the values. You can rotate them by 90 degrees with no additional requirements. If you want to rotate the values by 1 to 89 degrees, you must have the SWF file for that font, placed in the [path]/fonts folder. More about rotating axis values. |
| min | number | none – calculated automatically | The minimum value of the value axis. The axis will always start from this value, even if there is no data point mapped that far. |
| max | number | none – calculated automatically | The maximum value of the value axis. The axis will always end at this value, even if there is no data point mapped that far. |
| strict_min_max | true/false | false | If this is set to true, the axis will stay between Min and Max values even if there are data points beyond those values. The parts of the chart that do not fit will be cropped. If this is set to false, the Min and Max values will be extended to fit the chart. |
| frequency | Number | 1 | The ratio of shown values to value axis grid lines. 1 means a value will be shown at every grid line; 2 means a value will be shown at every second grid line, etc. The higher the number, the less values will be shown. |
| skip_first | true/false | true | If this is set to true, the first value will be skipped. |
| skip_last | true/false | false | If this is set to true, the last value will be skipped. |
| color | hex color code | Same as <text_color> in general settings | The color of the text. |
| text_size | number | Same as <text_size> in general settings | The size of the text. |
| unit | text | none | A short text indicating the units of the values. This can be something like "USD" or "km/h". |
| unit_position | left/right | right | Whether the units will be shown to the left of the value or to the right. |
| integers_only | true/false | false | If this is set to true, only whole values will be shown. Values with decimals will be hidden. |
| inside | true/false | false | If this is set to true, the values of this axis will be displayed inside the plot area. |
<axes>
This subsection lists settings that control the look of the actual axis lines.
<x>
This subsection lists settings that control the look of the x-axis.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| color | hex color code | #000000 | The color of the axis line. |
| alpha | number (0-100) | 100 | The opacity of the axis line. |
| width | number | 2 | The thickness of the axis line. 0 means hairline, but still visible (set 0 for an invisible axis line). |
| tick_length | number | 7 | The length of the tick extending from the axis at a grid or data point. |
| logarithmic | true/false | false | If this is set to true, the axis will use the logarithmic scale instead of the linear one. |
<y>
This subsection lists settings that control the look of the y-axis.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| color | hex color code | #000000 | The color of the axis line. |
| alpha | number (0-100) | 100 | The opacity of the axis line. |
| width | number | 2 | The thickness of the axis line. 0 means hairline, but still visible (set 0 for an invisible axis line). |
| tick_length | number | 7 | The length of the tick extending from the axis at a grid or data point. |
| logarithmic | true/false | false | If this is set to true, the axis will use the logarithmic scale instead of the linear one. |
<date_formats>
This subsection determines the format of values. It applies to axes whose type has been set to date or duration. The representations for hours, minutes and seconds are in lowercase; days, months and years are uppercase. MM means a month in numeric form (01-12), month means a month in word form.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| date_input | YYYY, MM, month, DD, hh, mm, ss, special characters | YYYY-MM-DD hh:mm:ss | The format of the date value in the data file. |
| duration_input | YYYY/MM/DD/mm/hh/ss | ss | The units of the duration value in the data file. |
| balloon | combination of YYYY, MM, month, DD, hh, mm, ss (additional letters might be used for naming) | month DD, YYYY | The format of dates as they will appear in balloons. |
| data_labels | combination of YYYY, MM, month, DD, hh, mm, ss (additional letters might be used for naming) | month DD, YYYY | The format of dates as they will appear in data labels. |
<axis_values>
This subsection lists settings that control the way dates on the axes are shown. The tag has two attributes: first determines the format of the first value on an axis, regular determines the format of the other values. Only one of these tags will be used at one time. This depends on the values shown on the axis. If the difference between grid lines is measured in seconds, the ss format will be used; if the difference is measured in minutes, the mm format will be used, etc. This is calculated automatically based on the contents of the data file.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| ss | combination of YYYY, MM, month, DD, hh, mm, ss (additional letters might be used for naming) | first="month DD, YYYY" regular="hh:mm:ss" | The format of the displayed date if the axis displays seconds. |
| mm | combination of YYYY, MM, month, DD, hh, mm, ss (additional letters might be used for naming) | first="month DD, YYYY" regular="hh:mm:ss" | The format of the displayed date if the axis displays minutes. |
| hh | combination of YYYY, MM, month, DD, hh, mm, ss (additional letters might be used for naming) | first="month DD, YYYY" regular="hh:mm:ss" | The format of the displayed date if the axis displays hours. |
| DD | combination of YYYY, MM, month, DD, hh, mm, ss (additional letters might be used for naming) | first="month DD, YYYY" regular="hh:mm:ss" | The format of the displayed date if the axis displays days. |
| MM | combination of YYYY, MM, month, DD, hh, mm, ss (additional letters might be used for naming) | first="month, YYYY" regular="month" | The format of the displayed date if the axis displays months. |
| YYYY | combination of YYYY, MM, month, DD, hh, mm, ss (additional letters might be used for naming) | first="YYYY" regular="YYYY" | The format of the displayed date if the axis displays years. |
<balloon>
This subsection lists the settings that control the balloon. The balloon is a piece of text that appears when the viewer rolls the mouse cursor over a bar or column.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| enabled | true/false | true | If this is set to true, the balloon will be displayed when rolled-over the bubble/bullet. |
| color | hex color code | none | The color of the balloon background. If not set, graph color will be used. |
| alpha | number (0-100) | 100 | The opacity of the balloon background. |
| text_color | hex color code | #FFFFFF | The color of the balloon text. |
| text_size | number | Same as <text_size> in general settings | The size of the balloon text. |
| max_width | number | 220 | The maximum width of a balloon. If there is too much text to fit in this width, the text will be wrapped. |
| corner_radius | number | 0 | Corner radius of a balloon. If bigger then 0, the balloon pointer will not be shown. |
| border_width | number | 0 | Balloon border width. |
| border_alpha | number | Same as <balloon><alpha> | Balloon border opacity. |
| border_color | hex color code | Same as <balloon><color> | Balloon border color. |
bullets
| hover_brightness | Number, from -255 to 255 | 0 | the bullet may darken/lighten when the use rolls over it. The intensity may be set here. |
| grow_time | number, in seconds | 0 | The time of animation of the bullets, in seconds. Leave 0 to appear instantly. |
| sequenced_grow | true / false | false | Whether to animate all bullets at the same time or one after another. |
| grow_effect | elastic / regular / strong | elastic | The style of animation. |
<zoom>
| enabled | true/false | true | If this is set to true, the user will be able to zoom-in the chart. |
| max_factor | number | 20 | The maximum zoom level. |
| border_color | hex color code | #BBBB00 | Color of a zoom box border. |
| border_alpha | number (0-100) | 100 | Zoom box border opacity. |
| bg_color | hex color code | #BBBB00 | Zoom box background color. |
| bg_alpha | number (0-100) | 25 | Zoom box background opacity. |
| target | true / false | true | Whether to show target when the mouse is over plot area or not. |
<scroller>
This subsection lists settings that control the chart's scroll bar.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| enabled | true/false | true | If this is set to true, the scroll bar will be displayed when the chart is zoomed in. |
| color | hex color code | #DADADA | The color of the scroll bar indicator. You can use multiple color codes, separated with commas - this will produce a gradient. |
| alpha | number (0-100) | 100 | The opacity of the scroll bar. |
| bg_color | hex color code | #F0F0F0 | The color of the scroll bar background. You can use multiple color codes, separated with commas - this will produce a gradient. |
| bg_alpha | number (0-100) | 100 | The opacity of the scroll bar background. |
| height | number, in pixels | 10 | The height of the scroll bar. |
<zoom_out_button>
This subsection lists the settings that control the zoom out button. This button appears when the viewer has zoomed in on a part of the chart; clicking it takes the viewer back to the full chart view.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| x | number, in pixels, percent, or reversed | right-aligned | The horizontal position of the zoom out button. The coordinate is counted from the left. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted from the right to left (such as !20). |
| y | Number, in pixels, percent, or reversed | top-aligned | The vertical position of the zoom out button. The coordinate is counted from the top. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted upwards from the bottom (such as !20). |
| color | hex color code | #BBBB00 | The color of the zoom out button background. |
| alpha | number (0-100) | 0 The opacity of the zoom out button background. | |
| text_color | hex color code | Same as <text_color> in general settings | The color of the zoom out button text. |
| text_color_hover | hex color code | #BBBB00 | The color of the button's text when the mouse pointer hovers over it. |
| text_size | number | Same as <text_size> in general settings | The size of the button's text. |
| text | text | Show all | The text on the button. |
<legend>
This subsection lists the settings that control the chart's legend.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| enabled | true/false | true | If this is set to true, the legend is shown on the chart. |
| x | number, in pixels, percent, or reversed | equal to <plot_area><margins><left> | The horizontal position of the legend’s left edge. The coordinate is counted from the left. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted from the right to left (such as !20). |
| y | number, in pixels, percent, or reversed | right below the plot area. | The vertical position of the legend’s top edge. The coordinate is counted from the top. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted upwards from the bottom (such as !20). If you want the legend to auto-fit the flash object, do not set this setting. |
| width | number, in pixels or percent | plot area width | The width of the legend. If the legend doesn't fit, try adjusting the margins. You can set the value in percent (such as 20%). |
| color | hex color code | #FFFFFF | The color of the legend’s background. You can use multiple color codes, separated with commas - this will produce a gradient. |
| max_columns | number | none | The maximum number of columns in the legend. (All data will be represented, but in several rows if necessary.) |
| alpha | number (0-100) | 0 | The opacity of the legend’s background. |
| border_color | hex color code | #000000 | The color of the legend’s borders. |
| border_alpha | number (0-100) | 0 | The opacity of the legend’s borders. |
| text_color | hex color code | Same as <text_color> in general settings | The color of the legend’s text. |
| text_size | number | Same as <text_size> in general settings | The size of the legend’s text. |
| spacing | number, in pixels | 10 | The space between the rows and columns of the legend. |
| margins | number, in pixels | 0 | The space between the borders and the contents of the legend. This is useful if the borders are visible, or the legend’s background color is different from the chart’s background color. |
| reverse_order | true/false | false | If this is set to true, the legend entries will be in a reversed order. |
| align | left/center/right | left | The alignment of the legend entries. |
<key>
These are the settings for the legend's key.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| size | number | 16 | The size of the key. The key is displayed in the legend next to the graph title, and is filled with the graph color. |
| border_color | hex color code | None – no border | The color of the key border. |
<help>
This subsection lists the settings that control the Help button, and the balloon that appears when the viewer rolls over it.
<button>
| Setting | Available values | Default value | Description |
|---|---|---|---|
| x | number, in pixels, percent, or reversed | right-aligned | The horizontal position of the help button. The coordinate is counted from the left. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted from the right to left (such as !20). |
| y | number, in pixels, percent, or reversed | top-aligned | The vertical position of the help button. The coordinate is counted from the top. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted upwards from the bottom (such as !20). |
| color | hex color code | #000000 | The color of the help button background. |
| alpha | number, in percent | 100 | The opacity of the help button background. |
| text_color | hex color code | #FFFFFF | The color of the help button text. |
| text_color_hover | hex color code | #BBBB00 | The color of the button's text when the mouse pointer hovers over it. |
| text_size | number | same as <text_size> in general settings | The size of the button's text. |
| text | text | ? | The text on the button. |
<balloon>
| Setting | Available values | Default value | Description |
|---|---|---|---|
| color | hex color code | #000000 | The color of the help balloon background. |
| alpha | number (0-100) | 100 | The opacity of the help balloon background. |
| width | number, in pixels | 300 | The width of the text in the balloon. |
| text_color | hex color code | #FFFFFF | The color of the help balloon text. |
| text_size | number | Same as <text_size> in general settings | The size of the button's text. |
| text | text | none | The text that will appear when the viewer's mouse pointer hovers over the button. Please note: if you want to use HTML tags, you must use the format <! [CDATA[text]]> |
<export_as_image>
This subsection lists the settings that control the function of saving the chart as an image file.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| file | filename | None – disabled | If you provide a filename, the viewer will be able to save the chart as an image. The option will be available in the right-click menu. |
| target | _blank, _top… | none – file opens in the same window | The target parameter for opening the image file in the browser. Use "_blank" to open the URL in a new browser window. |
| x | number, in pixels, percent, or reversed | left-aligned | The horizontal position of the "Collecting data" text. This text will appear while the chart is being exported. The coordinate is counted from the left. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted from the right to left (such as !20). |
| y | number, in pixels, percent, or reversed | bottom-aligned | The vertical position of the "Collecting data" text. This text will appear while the chart is being exported. The coordinate is counted from the top. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted upwards from the bottom (such as !20). |
| color | hex color code | #BBBB00 | The color of the "Collecting data" text background. |
| alpha | number (0-100) | 0 | The opacity of the "Collecting data" text background. |
| text_color | hex color code | same as <text_color> in general settings | The color of the "Collecting data" text. |
| text_size | number | same as <text_size> in general settings | The size of the "Collecting data" text. |
<error_messages>
This subsection lists the settings that control error messages in the chart.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| enabled | true/false | true | If this is set to true, the error messages will be displayed |
| x | number, in pixels, percent, or reversed | centered | The horizontal position of the error message. The coordinate is counted from the left. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted from the right to left (such as !20). |
| y | number, in pixels, percent, or reversed | centered | The vertical position of the error message. The coordinate is counted from the top. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted upwards from the bottom (such as !20). |
| color | hex color code | #BBBB00 | The color of the error message background. You can use multiple color codes, separated with commas - this will produce a gradient. |
| alpha | number (0-100) | 100 | The opacity of the error message background. |
| text_color | hex color code | #FFFFFF | The color of the error message text. |
| text_size | number | Same as <text_size> in general settings | The size of the error message text. |
<strings>
This subsection contains settings that determine the texts of various messages displayed by the chart.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| no_data | text | No data for selected period | The text that will be displayed if the data for the selected period is missing from the data file. |
| export_as_image | text | Export as image | The text of the image export option in the right-click menu. |
| collecting_data | text | Collecting data | The text that will be displayed while the chart is being exported to an image file. |
<context_menu>
This subsection contains settings for the context menu that will appear when the viewer right-clicks on your chart. See adding custom commands to right click menu for more information.
<default_items>
| Setting | Available values | Default value | Description |
|---|---|---|---|
| zoom | true/false | false | If this is set to true, the Flash player's zoom controls are included in the right-click menu. |
| true/false | true | If this is set to true, the Flash player's print controls are included in the right-click menu. |
<labels>
This subsection lists the settings of labels - free bits of text not attached to anything. You can add multiple labels, each nested inside a <label></label> tag. Use labels for naming axes, chart title, etc.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| x | number, in pixels, percent, or reversed | 0 | The horizontal position of the label. The coordinate is counted from the left. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted from the right to left (such as !20). |
| y | number, in pixels, percent, or reversed | 0 | The vertical position of the label. The coordinate is counted from the top. You can set the value in percent (such as 20%). You can also reverse the number, so it is counted upwards from the bottom (such as !20). |
| rotate | true/false | false | If this is set to true, the label is rotated by 90 degrees. |
| width | number, in pixels or percent | Fit to contents | The maximum width of the label. (If the contents exceed the width, the label will have multiple lines.) You can set the value in percent (such as 20%). |
| align | left/center/right | left | The alignment of the text in the label. |
| text_color | hex color code | As per general settings | The color of the text in the label. |
| text_size | number | Same as <text_size> in general settings | The size of the text in the label. |
| text | text | none | The text of the label. Please note: if you want to use HTML tags, you must use the format <![CDATA[text]]>. |
| ss | text | none | The unit name of seconds – will appear behind the value. |
| mm | text | : | The unit name of minutes – will appear behind the value. |
| hh | text | : | The unit name of hours – will appear behind the value. |
| DD | text | d | The unit name of days– will appear behind the value. |
<months>
This section allows you to set the names of each month. There are twelve tags in monthX format nested inside the months tag. The value of each of these tags is a month name – from January to December.
| Setting | Available values | Default value | Description |
|---|---|---|---|
| month1 | text | Jan | Name of January |
| month2 | text | Feb | Name of February |
| month3 | text | Mar | Name of March |
| month4 | text | Apr | Name of April |
| month5 | text | May | Name of May |
| month6 | text | Jun | Name of June |
| month7 | text | Jul | Name of July |
| month8 | text | Aug | Name of August |
| month9 | text | Sep | Name of September |
| month10 | text | Oct | Name of October |
| month11 | text | Nov | Name of November |
| month12 | text | Dec | Name of December |
<graphs>
This subsection lists optional settings that control the graph.
<graph>
This subsection controls one graph. You can have multiple graphs one one chart. The gid parameter of the tag must match the same parameter in the data file (if you are using XML data): <graph gid="0">
| Setting | Available values | Default value | Description |
|---|---|---|---|
| title | text | none | The title of the graph. The title is displaye din the legend. |
| color | hex color code | The color from <colors> setting | The graph color. |
| alpha | number, in percent | column/line alpha | The opacity of the graph. |
| width | number, in pixels | 0 | The width of the graph line connecting data points. 0 means hairline (still visible). Set <alpha>0</alpha> for invisible lines. |
| data_labels | text | none | The text of a data label. Tags in curly brackets { } will be replaced with the information taken from the data file. The following tags are available: {title}, {value}, {description}, {x}, {y}, {percents}. Please note: if you want to use HTML tags, you must use the format <![CDATA[text]]>. |
| balloon_text | text | none | The text in the data point balloon. Tags in curly brackets { } will be replaced with the information taken from the data file. The following tags are available: {title}, {value}, {description}, {x}, {y}, {percents}. Please note: if you want to use HTML tags, you must use the format <![CDATA[text]]>. |
| width | number | 0 | The width of the graph line. 0 means hairline, but still visible (set alpha=0 for an invisible graph line). |
| bullet | bubble /square / round / square_outlined / round_outlined / square_outline / round_outline / romb / triangle_up / triangle_down / x / filename.swf | none | The shape of the bullet that marks each line graph point. The filename.swf is the name of flash file – you can use a custom swf file as a bullet. This file must be placed in the folder specified as "path" in the HTML code snippet. Outlined bullets use the plot area color for the outline. |
| bullet_size | number | 8 | The size of the bullet. This only affects predefined bullet shapes, not custom Flash bullets. |
| bullet_max_size | number | 50 | The maximum size of a bullet (bubble). The biggest value will be represented by this bullet. |
| bullet_min_size | number | 0 | The minimun size of a bullet (bubble). |
| bullet_alpha | number (0-100) | 100 | The opacity of the bullet. |
| bullet_color | hex color code | Same as <graph><color> | The color of the bullet. This only affects predefined bullet shapes, not custom Flash bullets. |
| visible_in_legend | true/false | true | If this is set to true, the graph will be represented in the legend. |
| fill_color | hex color code | none | Sets the fill color of the graph. Note, the fill will work differently then in Line chart - it won't fill the area between graph and axis, but rather fill the shape of the graph |
| fill_alpha | number (0-100) | 100 | Sets fill opacity (if fill_color is set) |
| min_max | true/false | true | You can tell the chart that it shouldn't include graphs values when calculating min and max of the chart |
| © Antanas Marcelionis Contact and feedback: info@amcharts.com | Subscribe to amCharts news |