Add an axis to the chart after render time.
Add an axis to the chart after render time. Note that this method should never be used when adding data synchronously at chart render time, as it adds expense to the calculations and rendering. When adding data at the same time as the chart is initiated, add the axis as a configuration option instead.
This method is inherited from Highcharts as a map is a cartesian series with hidden X and Y axes. In Highmaps it is less relevant.
Set a new credits label for the chart.
Set a new credits label for the chart.
A configuration object for the credits as defined at credits.
5.0.0
Add a series to the chart after render time.
Add a series to the chart after render time. Using this method is discouraged when adding data synchronously at chart render time, as it adds expense to the calculations and rendering. When adding data at the same time as the chart is initialized, add the series as a configuration option instead. With multiple axes, the offset is dynamically adjusted
The series options, as documented under plotOptions.series and under the plotOptions for each series type.
Add a series to the chart as drilldown from a specific point in the parent series.
Add a series to the chart as drilldown from a specific point in the parent series. This method is used for async drilldown, when clicking a point in a series should result in loading and displaying a more high-resolution series, for instance when zooming in from a world map to countries with regions. When not async, the setup is simpler using the drilldown.series options structure.
The existing Point object from which the drilldown will start.
A reference to the containing HTML element, dynamically inserted into the element given in chart.renderTo
.
A reference to the containing HTML element, dynamically inserted into the element given in chart.renderTo
.
The chart's credits label.
The chart's credits label. The label has an update
method that allows setting new options as per the credits option set.
5.0.0
Removes the chart and purges memory.
Removes the chart and purges memory. This method should be called before writing a new chart into the same container. It is called internally on window unload to prevent leaks. It is also called internally before adding another chart to the same container.
When the chart is drilled down to a child series, calling chart.drillUp()
will drill up to the parent series.
When the chart is drilled down to a child series, calling chart.drillUp()
will drill up to the parent series.
Exporting module required.
Exporting module required. Submit an SVG version of the chart to a server along with some parameters for conversion.
For live demos, see Highcharts API for exportChart, which shares the same feature set.
Exporting options. Out of the exporting options, the following options can be given as parameters to the exportChart method. All options default to the values given in the exporting config options.
filename
: the filename for the export without extension,
url
: the URL for the server module to do the conversion,
width
: the width of the PNG or JPEG image generated on the server,
type
: the MIME type of the converted image,
sourceWidth
: the width of the source (in-page) chart,
sourceHeight
: the height of the source chart.
Export the chart to a PNG or SVG without sending it to a server.
Export the chart to a PNG or SVG without sending it to a server. Requires modules/exporting.js
and modules/offline-exporting.js
.
Get chart values from latitude/longitude.
Get chart values from latitude/longitude. Returns an object with x
and y
values.
An object containing the properties lat
and lon
with numeric values.
1.1.0
Calculate latitude/longitude values for a point.
Calculate latitude/longitude values for a point. Returns an object with the numeric properties lat
and lon
.
A point object, or any object containing the properties x
and y
with numeric values.
1.1.0
Get an axis, series or point by its id
as given in the configuration options.
Get an axis, series or point by its id
as given in the configuration options. Returns undefined
if no item is found.
The id of the axis, series or point to get.
Exporting module required.
Exporting module required. Get an SVG string representing the chart. For live demo, see the same option in Highcharts, which shares this feature set.
Chart options to add to the exported chart in addition to the options given for the original chart. For example if series.lineWidth should be greater in the exported chart than in the original, or the chart should have a different background color, this is added here.
Returns an array of all currently selected points in the chart.
Returns an array of all currently selected points in the chart. Points can be selected either programmatically by the Point.select() method or by clicking when allowPointSelect is enabled.
Returns an array of all currently selected series in the chart.
Returns an array of all currently selected series in the chart. Series can be selected either programmatically by the Series.select() method or by checking the checkbox next to the legend item if series.showCheckBox is true.
Hide the loading screen.
Hide the loading screen. Options for the loading screen are defined at options.loading.
Zoom in or out of the map.
Zoom in or out of the map. See also Point.zoomTo.
How much to zoom the map. Values less than 1 zooms in. 0.5 zooms in to half the current view. 2 zooms to twice the current view. If omitted, the zoom is reset.
The options structure for the chart.
Exporting module required.
Exporting module required. Clears away other elements in the page and prints the chart as it is displayed. By default, when the exporting module is enabled, a button at the upper left calls this method. See demo at the Highcharts API.
Redraw the chart after changes have been done to the data or axis extremes.
Redraw the chart after changes have been done to the data or axis extremes. All methods for updating axes, series or points have a parameter for redrawing the chart. This is true
by default. But in many cases you want to do more than one operation on the chart before redrawing, for example add a number of points. In those cases it is a waste of resources to redraw the chart for each new point added. So you add the points and call chart.redraw()
after.
Defaults to true. When true, the update will be animated with default animation options. The animation can also be a configuration object with properties duration
and easing
.
Reflows the chart to its container.
Reflows the chart to its container. By default, the chart reflows automatically to its container following a window.resize
event, as per the chart.reflow option. However, there are no reliable events for div resize, so if the container is resized without a window resize event, this must be called explicitly.
An array of all the chart's series.
Resize the chart to a given width and height.
Resize the chart to a given width and height. In order to set the width only, the height argument can be skipped. To set the height only, pass undefined
for the width.
The new pixel width of the chart. Since v4.2.6, the argument can be undefined
in order to preserve the current value (when setting height only), or null
to adapt to the width of the containing element.
Set a new title or subtitle for the chart.
Set a new title or subtitle for the chart.
A configuration object for the new title as defined at #title.
Dim the chart's plot area and show a loading label text.
Dim the chart's plot area and show a loading label text. Options for the loading screen are defined at options.loading. A custom text can be given as a parameter for loading.
The chart title.
The chart title. The title has an update
method that points back to Chart.setTitle.
5.0.0
Get point from latLon using specified transform definition.
Get point from latLon using specified transform definition.
An object containing the properties lat
and lon
with numeric values.
1.1.0
Get latLon from point using specified transform definition.
Get latLon from point using specified transform definition. The method returns an object with the numeric properties lat
and lon
.
A point object, or any object containing the properties x
and y
with numeric values.
1.1.0
A generic function to update any element of the chart.
A generic function to update any element of the chart. Elements can be enabled and disabled, moved, re-styled, re-formatted etc.
A special case is configuration objects that take arrays, for example xAxis, yAxis or series. For these collections, an id
option is used to map the new option set to an existing object. If an existing object of the same id
is not found, the corresponding item is updated. So for example, running chart.update
with a series item without an id, will cause the existing chart's series with the same index in the series array to be updated.
See also the responsive option set. Switching between responsive.rules basically runs chart.update
under the hood.
A configuration object for the new chart options as defined in the options section of the API.
5.0.0
An array of the chart's x axes.
An array of the chart's x axes. A map has hidden X and Y axes by default. If only one x axis, it is referenced by chart.xAxis[0]
.
An array of the chart's y axes.
An array of the chart's y axes. A map has hidden X and Y axes by default. If only one y axis, it is referenced by chart.yAxis[0]
.
JavaScript name:
Chart