Académique Documents
Professionnel Documents
Culture Documents
###############################################
Since version 3.4.3, change log moved to: http://www.amcharts.com/javascript-cha
rts/changelog/
#### 3.4.2 #####################################################################
###############################################
Bug fix: if pie slice had no label, the external method rollOverSlice(index) was
not working
Bug fix: x switch of the legend position adjusted
Bug fix: when autoWrap for category axis was set to true, in some cases axis tit
le was cut.
markPeriodChange was set to true in CategoryAxesSettings.
#### 3.4.1 #####################################################################
###############################################
"patterns" theme added.
themes were updated a bit.
labels of angular gauge axis adjusted.
when scrolling serial/stock charts with mousewheel (chart.mouseWheelScrollEnable
d must be set to true), if user press shift
button, the chart will zoom-in or zoom-out;
adjustment property added to ChartCursor. Default value is 0, if you set it to 1, the balloon will show near previous, if
you set it to 1 - near next data point.
#### 3.4.0 #####################################################################
###############################################
# link to amCharts.com site in a free version was made less noticable - it us
es chart's font color and font size and you
can adjust it's position using creditsPosition property of AmChart. Possibl
e values are: top-left, top-right, bottom-right
and bottom-left. This will help you to achieve better layout of a chart.
# we fixed typo in chart cursors property - it was showNextAvalable and now i
s showNextAvailable. The old one won't work.
# since now you can scroll serial and stock charts with mouse wheel. To enabl
e this, set
chart.mouseWheelScrollEnabled = true (default is false)
# "moved" event added to chart cursor. It is dispatched every time the mouse
is moved. The event object has the following
properties: x, y (coordinates of the cursor), target (reference to cursor),
chart, zooming.
# axisX and axisY properties added to AxisBase. They are read-only and return
s x and y positions of the axis.
# unit and unitPosition (with possible values left and right) added to GaugeA
xis class.
# autoWrap property added to CategoryAxis, with default value false. If you s
et it to true, the axis labels will be
wrapped if they won't fit in the allocated space.
# minHorizontalGap (default 75) and minVerticalGap (35) properties added to A
xisBase. They are used to calculate the
number of gridLines when autoGridCount is true. You can modify these values
to have more or less grid lines.
#### 3.3.6 #####################################################################
###############################################
# Bug fix - charts with legend could fail if there was a google analytics scr
ipt in the page.
# stepDirection property added to AmGraph. If you set it to "left", step line
graph will draw the step to the left of the
date/category.
# markPeriodChange property added to ChartScrollbarSettings
#### 3.3.5 #####################################################################
###############################################
# Bug fix - 3D pie chart was not rendered in IE8 and older (since 3.3.4 versi
on only)
# Candlestick graphs can display patterns
# Old listeners are removed automatically if the same listener was added, thi
s helps to avoid duplicate calls of event
handlers
# \n in labelText of AmGraph is now properly displayed as new line.
# PeriodSelector sometimes could select plus one period when period button wa
s pushed (only since 3.3.0)
#### 3.3.4 #####################################################################
###############################################
# export as image script fixed - bullets of charts with scrollbars were not e
xported.
# dataContext property added to SerialDataItem. It holds reference to origina
l data object and might be used when using
labelFunction to format custom balloon text and in some other cases.
# XY chart can display bullets with patterns (if valueField is set).
#### 3.3.3 #####################################################################
###############################################
# hideBalloonTime property added to AmChart class, default value is 150 (mill
iseconds). It sets time after which balloon is
hidden if user rolls-out of the object. Increasing the time might help to p
revent balloon flickering while moving the
using JSON config. If you do it in old way (JSON config is supported since
v 3.2.0), you should pass theme object for
each new object you build, for example: var graph = new AmCharts.AmGraph(Am
Charts.themes.light);
We will be adding more themes soon. Check _usingThemes.html file in samples
folder to see themes in action.
# patterns property added to AmSlicedChart and AmCoordinateChart - instead of
setting a pattern for a slice/graph, you can
pass array of patterns using this property.
# you can now control zoom-out buttons with the following new properties of A
mRectangularChart:
zoomOutButtonImageSize
zoomOutButtonImage
zoomOutButtonColor
zoomOutButtonAlpha
zoomOutButtonRollOverAlpha
zoomOutButtonPadding
# some minor bugs fixed
#### 3.2.0 #####################################################################
###############################################
# AmCharts.makeChart(divID, chartConfig); method added. divID is id of a div
where your chart should appear. chartConfig is
JSON object with chart configuration. Check examples with _JSON_ prefix in
samples folder to see this in action.
# type property added to AmChart class. It is required to specify type to one
of the following, when creating charts from
JSON config: serial, xy, radar, pie, gauge, map, stock
# a possibility to export charts as image/pdf/svg added for all modern browse
rs except IE9 (IE10 is supported). The
exporting doesn't require any server side software and is made using js lib
raries only. Check samples with
_exporting_ prefix to see this in action. Exporting to SVG doesn't work ver
y properly with stock chart or charts with
legend (will offer saving multiple files).
# You can set any legend items via legend.data property, for example:
legend.data = [{title:"first", color:"#CC0000", value:50}, {title:"second",
color:"#00CC00", value:100}];
This allows creating any legend items you want. Call chart.legend.validateN
ow(); if you change legend's data at run time.
# AmAngularGauge supports legend now
# bug fix - if a chart with scrollbar was rotated after the chart is created,
the scrollbar's graph was shifted to a wrong
position.
# bug fix - column graph type wasn't displayed in chart scrollbar (since 3.1.
0)
# hand-drawn style
if you set chart.handDrawn = true, the lines of a chart will be distorted a
nd will produce hand-drawn effect.
You can also modify chart.handDrawScatter (default value is 2) and chart.ha
ndDrawThickness (default value 1) values for
more scattered view.
# offsetY and offsetX properties added to AmBalloon. Specifies the distance f
rom the mouse position to balloon's pointer.
You might want to increase distance when using hand drawn style.
# Some minor problems fixed
#### 3.0.1 #####################################################################
###############################################
Some very minor bugs which usually pop right after big release fixed.
#### 3.0.0 #####################################################################
###############################################
**** Several files ****
# As not all users require all type of charts, we spilt the js file into seve
ral files - one main amcharts.js file, plus
a separate js file for each chart type. This means you can include only the
charts you need. If you are worried about
number of requests, you can simply copy/paste the source of the charts you
use to the main file.
**** Upgrading / 100% backwards compatibility ****
# Although we changed some default values in order to improve usability of th
e charts, the only thing you should worry
about when upgrading from v2 to v3 is the feature mention above
you should
include two or more js files in order your
charts to work. If you don t like the changed defaults, you can always set th
em to the previous values in your chart
setup.
**** New chart types ****
# Funnel / Pyramid chart.
Check funnelChart.html and pyramidChart.html examples. As this chart type h
as a lot of in common
with pie chart, we created one base class for these chart types - AmSlicedC
hart. AmPieChart and AmFunnelChart now extend
this class. Visit our online class reference for properties and methods of
AmFunnelChart.
# Angular Gauge
Supports multiple axes and multiple arrows. Check the following examples: a
ngularGauge.html,
angularGaugeWithTwoAxes.html, clock.html, clockWithTwoFaces.html. Visit our
online class reference for properties and
methods of classes used by this chart type.
*** New chart types made with new possibilities of Serial/XY charts ***
We added lots of new features to our charts and with these features you can
create new chart types, like:
# Horizontal or vertical bullet chart - bulletChart.html
# Waterfall chart - waterFallChart.html
# Step chart without risers - lineStepNoRisers.html
# Error chart (both Serial and XY) - errorChart.html
*** Other new features ***
# Possibility to show minor grid for both Category and Value axis. minorGrid
Enabled (default value false) and
minorGridAlpha (default 0.07) properties added to AxisBase class.
Example: lineWithScrollAndZoom.html
# Possibility to change line graphs' line/fill color on any data point to cr
eate highlighted sections of the graph.
To achieve this, you should set lineColorField and/or fillColorsField for
your graph and have a field in your data
which would contain color values at a point where you want the graph to ch
ange it's color.
Example: lineWithChangingColor.html
# Possibility to switch line from solid to dashed. Columns can also have das
hed outline. To achieve this, you should set
dashLengthField for your graph and have a field in your data which would c
ontain dashLength value at a point where you
want the graph to change from solid to dashed or vice versa.
Example: lineWithDifferentBulletSizes.html and columnAndLineMix.html
# Date strings in data now supported. Even if your chart parses dates, you c
an pass them as strings in your data
all you
need to do is to set data date format and the chart will parse dates to da
te objects. This means that now data for
date-based chart can be in legit JSON format. dataDateFormat property adde
d to AmSerialChart and AmStockChart.
Example: lineWithChangingColor.html, lineWithTrendLines.html and some more
.
# When moving chart cursor over the chart, hovered bullets can change their
size. If a graph has bullets and you added
ChartCursor to the chart, bullets will become bigger when char cursor is o
ver them. graphBulletSize property with
default value 1.7 added to ChartCursor. If you want to disable this featur
e, set the value to 1.
Example: lineWithLogarithmicValueAxis.html, lineWithScrollAndZoom.html and
some more.
# Legend can now
legend can show sum,
or high values
egendPeriodValueText
achieve this. The tags should be made out of two parts - the name of a fie
ld (value / open / close / high / low) and the
value of the period you want to be show - open / close / high / low / sum
/ average / count. For example: [[value.sum]]
means that sum of all data points of value field in the selected period w
ill be displayed.
Example: area100PercentStacked.html and areaStacked.html
To achieve the same with stock chart, we added periodValueTextRegular and
periodValueTextComparing proprties to
StockLegend. To show percent period values, you should add "percent." pref
ix for your tag, for example:
[[percents.value.close]] means that last percent value of a period will be
displayed.
Example: stockMultiplePanels.html and stockMultipleDataSets.html
# Legend markers can now mirror graph s settings, displaying a line and a real
bullet as in the graph itself.
useGraphSettings property with default value false was added to AmLegend.
Note, we also removed "line" and "dashedLine"
marker types because of this - use the useGraphSettings feature in case yo
u need lines as markers in the legend.
Example: lineWithDifferentBulletSizes.html and lineWithMultipleValueAxes.h
tml
# Legend now supports custom markers (images). customMarker property was add
ed to AmGraph. You should set path to the image
which should be displayed in the legend.
# Diamond bullet type added. Set graph.bullet = "diamond" to use it.
# Dynamic bullet size based on value axis / Error chart.
Error chart is a regular serial or XY chart with bullet type
X" or "errorY". The graph should know which axis
should be used to determine the size of this bullet - that's
lletAxis property should be set. Besides that,
you should also set graph.errorField. You can also use other
with this feature too. For example, if you set
bulletAxis for XY chart, the size of a bullet will change as
chart.
Example: errorChart.html
set to "error
when graph.bu
bullet types
you zoom the
# You can specify custom column width for each graph individually. columnWid
th property added to AmGraph. Note, you set
relative width here (0 - 1), not width in pixels.
Example: bulletChart.html
# Columns can be overlaid on other columns, without making axis as stacked.
clustered property added to AmGraph. In case you
want to place graph's columns in front of other columns, set it to false.
Example: bulletChart.html
# Resize grips were made bigger to make life easier for users on touch devic
es.
# Balloons can now display any HTML and CSS inside them. This means you can
add images, format text or display just about
any HTML/CSS content. Because of this new feature, we removed textShadow p
roperty of AmBalloon in this version.
Example: areaStacked.html, barStacked.html and many other.
# Balloon now can animate from point to point and also fade out when user mo
ves away from the chart. animationDuration and
fadeOutDuration properties added to AmBalloon, with default values 0.3. an
imationDuration property was also added to
ChartCursor, so that the cursor line would also animate to its position.
Example: any chart with balloon.
# Balloon now can display shadow. shadowColor (default #000000) and shadowAl
pha (default 0.4) added to AmBalloon.
Example: any chart with balloon.
# Some default
rderColor to true,
pointerWidth
Example: any
********************************************************************************
***********************************************
********************************************************************************
***********************************************
********************************************************************************
***********************************************
2.11.3
With IE8 and older, in some cases not all category axis labels were shown.
Stock chart problem with dates as timestamsp in the data fixed.
2.11.2
"drawn" event added to AmChart. Fired every time chart is drawn - on zoom, hide
graph, etc.
bug fixed - in some cases last grid items of category axis were not drawn.
compareGraphBalloonFunction added to StockGraph.
"drawn" event added to AmStockChart. Fired every time chart is drawn - on zoom,
hide graph, etc.
bug fixed - graphs which are not compared were not displayed when data sets were
compared.
2.11.1
Bug fixed: if chart.usePrefixes was set to true, numbers near value axis grid co
uld be rounded and duplicated.
This bug only occured in v 2.11.0.
2.11.0
Bug fixed:
FireFox 3.6 failed to show all columns of a graph.
NumberFormatter was ignored if usePrefixes was set to true.
Features added:
baloonFunction added to AmGraph. If you set some function, the graph will call i
t and pass graphDataItem and graph object to it
this function should return a string which will be displayed in a balloon.
Custom fields now supported in labels/balloons/legend of Pie and Radar chart.
Guide.above property added, the guide will be placed above the graphs if set to
true (default is false).
compareFromStart added to StockGraph, default value false. If you set it to true
, when data sets are compared, the graphs will
use first value as a base value instead of using the first value of selected per
iod.
2.10.8
Bug with stacked step charts fixed.
categoryBalloonFunction property added to ChartCursor. It allows formatting any
category balloon text you want.
The categoryBalloonFunction should return a string which will be displayed in a
balloon. When categoryBalloonFunction
is called, category value (or date) is passed as an argument.
2.10.7
Bugs related to new behavior of CategoryAxis fixed.
CategoryAxis.centerLabelOnFullPeriod property added, with default value true. Th
is setting works only when
parseDates is set to true and equalSpacing is set to false. In case you set it t
o false,
labels will never be centered between grid lines.
2.10.5
CategoryAxis labeling, when parseDates is true was improved.
CategoryAxis.markPeriodChange property added, with default value set to true. If
you set it to false,
the start of longer periods won't use a different date format and won't be bold.
Bug with compared graphs and milliseconds fixed.
If events were hidden with hideStockEvents() method, they used to appear again i
f chart was zoomed. Fixed this bug.
2.10.4
charts can be rendered in "rtl" (right-to-left) mode. You have to set AmCharts.r
tl = true in order this mode to be enabled.
categoryAxis.minPeriod now supports intervals like 15mm, 10ss (previously only e
qual intervals like ss, mm were supported).
some minor bugs fixed.
2.10.3
******
labelFunction added to AxisBase. You can use it to format both Value and Categor
y axis labels. If this function
is set for ValueAxis, it is called and these parameters are passed: labelFunctio
n(value, valueText, valueAxis);
Where value is numeric value, valueText is formatted string and valueAxis is a r
eference to valueAxis object.
If this function is set for CategoryAxis, then it is called with the following p
arameters passed:
if dates are not parsed:
labelFunction(valueText, serialDataItem, categoryAxis)
if dates are parsed:
labelFunction(valueText, date, categoryAxis)
******
fontSize property added to Guide.
position property added to Guide.
******
useMarkerColorForValues property added to AmLegend.
******
rightClickSlice event added to AmPieChart.
******
Some minor bugs fixed.
2.9.3
AxisBase.minGap property added. It allows to set the minimum size of interval be
tween
grid lines, works only for horizontal axis and when autoGridCount is set to true
.
Some minor bugs fixed.
2.9.2
Problem with lines not visible on XP+IE8 fixed.
2.9.1
Stock chart related updates:
If user changes date in period selector, the new date is applied right when he c
licks away from the
input field.
"rendered" event added to AmStockChart. Fired each time the chart is rebuild.
Updates related to other chart types:
'selected' event of ChartCursor was added. It is fired when selectWithoutZooming
is set to true and
you can set a customly created div element as a container of your legend. To do
this,
you should pass id or reference of the div in this method:
chart.addLegend(legend, divID);
FIXES:
balloon could be wrongly positioned in marginTop style was added directly to <ht
ml> element.
chart.animateAgain(); worked only if validateNow() method was called after.
in some specific cases scrollbar could act icorrectly on IE8/IE7.
if minPeriod was set to month and the chart was zoomed-in from outside, one mont
h
was added to the specified period.
2.8.3
When panEventsEnabled was set to true, balloons over bullets were not shown.
Text in balloons was not properly vertically aligned if verticalSpacing was set
to some different than default value.
Balloon wasn't positioned properly if chart was in a scrollable div.
Init event wasn't fired by AmPieChart.
Stock chart's scrollbar was showing more by one period than it was actually sele
cted.
2.8.2
You can use time stamp values instead of Date objects for Stock chart since this
version.
AmStockChart.clear() method added. In case you want to destroy the chart, call
this method.
Step line's corners sometimes were not perfect (one extra pixel could be added
in the end of horizontal line)
You couldn't change panEventsEnabled of AmChart class after the chart was
initialized.
You couldn't chane legend's position after the chart was initialized.
Step line chart was not correctly filled if Value axis was of some stacked type.
Some other minor bugs fixed.
2.8.1
hideXScrollbar and hideYScrollbar properties added to AmXYChart. This will
allow you to show one scrollbar only.
hideOutOfScopePeriods property added to PeriodSelector, with default
value true. This will hide period buttons which periods are longer than data
available.
rea.
Some bugs fixed.
2.7.1
categoryAxesSettings.boldPeriodBeginning was ignored when equalSpacing
was set to true.
Stock events that are attached to axis were not stacked.
StockEvent.urlTarget was ignored.
Predefined period buttons were not marked as selected if a period was longer whe
n
available data.
2.7.0
textAlign property added to AmBalloon. Possible values are left/middle/right,
default is "middle".
behindColumns property added to AmGraph. If set to true, line graph will be
displayed behind column graphs.
"init" event added to AmChart. Event is fired right after the chart is initializ
ed
for the very first time.
totalText property added to ValueAxis. Usage example:
valueAxis.totalText = "total: [[total]]"
It works only if the chart has column graphs and stackType is set to "regular" o
r "100%".
showEntries property added to AmLegend. It might be used by StockChart - in case
you want
legend as it displayes title of the chart but don't want legend entries to be vi
sible.
A bug with separate data provider set to graph fixed.
If data set doesn't have field of comparing graph mapped, the legend won't displ
ay
entry for this data set at all.
2.6.13
FIXES:
When viewing a page with a chart from iOS browser, console logged some errors
gradientOrientation was ignored by area charts
plotAreaGradientAngle property added to AmRectangularChart, can accept 0, 90,
180 and 270 values.
2.6.12
FIXES:
Pie chart data labels were hidden behind other slices if labelRadius < 0
If chart was in a div with scrollbar, cursor was displayed in wrong position aft
er
scrolling with FF.
//////
// 2.5.0
////////////////////////////////////////////////////////////
//////
////////////////////////////////////////////////////////////////////////////////
//////
Since v 2.5 we no longer distribute our old flash chart in this package, we hope
this
will help to avoid a lot of misunderstandings. If you still want to use flash ch
art,
download it in a separate package from www.amcharts.com/download/
AmCharts.ready() method added so you don't need to use window.onload anymore. Yo
u can
use amCharts.ready as many times in one page as you want.
precision property added to ValueAxis.
if chart.usePrefixes is set, prefixes will be used both in balloons adn legend,
not only
by valueAxis as before.
default value of autoGridCount property of AxisBase changed to true
default value of textClickEnabled of AmLegend changed to false
default value of hideResizeGrips of ChartScrollbar changed to false
////////////////////////////////////////////////////////////////////////////////
//////
////////////////////////////////////////////////////////////////////////////////
//////
2.1.9
Some minor bugs fixed.
2.1.8
Some minor bugs fixed.
2.1.7
FIXES:
if chartCursor.pan was set to true, mouse pointer didn't change back when off th
e area.
in some cases balloon flashed in a wrong position (IE only) for a second.
Rollover balloons used to overlap when all of the datapoints were very near the
top of
the plot area.
Sometimes lines became blurry after window was resized.
v 16 of Chrome used to display warning about deprecated layerX and layerY proper
ties.
Some other minor bugs fixed.
FEATURES:
boldPeriodBeginning property with default value true added to CoordinateAxis.
You can disable bolding of the beginning of a period (like year/month/etc) using
it.
2.1.6
Some minor bugs fixed.
2.1.5
Some minor bugs fixed.
2.1.4
Some minor bugs fixed.
2.1.3
Some minor bugs fixed.
2.1.2
Raphael.js updated to 2.0.1, some related issues in amCharts fixed.
2.1.1
version property added to AmStockChart. Indicates current version of the chart
script.
FIXES:
It was impossible to drag chart scrollbar if the mouse was over text in scrollba
r.
Chart cursor stayed visible sometimes even mouse wasn't over the chart.
NEW FEATURES
equalWidths with default value "false" was added to LegendSettings. It allows
to save some space in the legend.