There are several events which are raised at different points in the lifecycle of a chart.
This event is raised whenever a chart is first created.
This is raised any time that the data range used to render the chart from is changed, e.g. by using the range selection handle or
by making changes in the Data tab of the configuration sidebar. This event contains a
cellRange object that gives you
information about the range, allowing you to recreate the chart.
Formatting changes made by users through the Format Panel will raise the
This is raised when a chart is destroyed.
Example: Chart Events
The following example demonstrates when the described events occur by writing to the console whenever they are triggered. Try the following:
- Create a chart from selection, for example, select a few cells in the "Month" and "Sunshine" columns and right-click to "Chart Range" as a "Line" chart. Notice that a "Created chart with ID id-xxxxxxxxxxxxx" message has been logged to the console.
- Shrink or expand the selection by a few cells to see the "Changed range selection of chart with ID id-xxxxxxxxxxxx" logged.
- Click the hamburger icon inside the chart dialog to show chart settings and switch to a column chart. Notice that a "Changed options of chart with ID id-xxxxxxxxxxxxx" message has been logged to the console.
- Close the chart dialog to see the "Destroyed chart with ID id-xxxxxxxxxxx" message logged.
Accessing Chart Instance
Charts in the grid are produced by the ag-Charts library, which is integrated directly into the grid for your convenience. In some advanced use cases, you may wish to access the chart instance that is produced by ag-Charts, in order to interact with the chart directly.
The chart instance can be found inside the
ChartModel, which is provided in the
The example below shows how the chart instance can be used, creating a subtitle and updating it dynamically as you change the range selection.
To learn about series events refer to the standalone charting library documentation.
Continue to the next section to learn about the: Chart Container.