Events
The plug-in exposes six events that can be bound using Oracle APEX dynamic actions.
Events Data
The table below describes each property of the event data. Each event has access to event data using this.data. Chart Report Deleted, Chart Report Downloaded and Chart Report Saved events expose one extra property.
| Property | Description |
|---|---|
| this.data.button | A jQuery reference to the button that triggers a dynamic action implementing the plug-in. |
| this.data.chart | A jQuery reference to the JET chart DOM element (having class .oj-chart). |
| this.data.current | The name of the current chart report. If none is selected then property current equals undefined. |
| this.data.region | Result of the apex.region function executed in the context of dynamic action's affected elements (region). |
| this.data.regionId | A static or dynamic id of the APEX region containing the JET chart. |
| this.data.reports | An array of objects describing the end-users saved chart reports. Each chart report has 2 properties: name and settings. |
| this.data.uniqueId | The unique jQuery id that is used to identify all DOM elements created by the plug-in. The plug-in elements have the data-id attribute with a value set to a unique id. |
| this.data.deleted | The name of the deleted report. Available only for event Chart Report Deleted |
| this.data.base64 | A base64 string of the downloaded png image. Available only for event Chart Report Downloaded |
| this.data.saved | The name of the saved report. Available only for event Chart Report Saved |
Chart Plug-in Ready
If the dynamic action implementing the plug-in has the Fire On Initialization attribute set to Yes then the event is triggered after page loads and the chart is rendered. Otherwise, the plug-in fires the event after the end-user clicks on the button triggering the dynamic action implementing the plug-in. The event is triggered once.
Chart Report Changed
The event is triggered each time the plug-in chart report is selected. The event is also triggered along with save and delete functionality of the plug-in. If chart customization is saved as the Primary report then the event is also triggered on plug-in initialization.
Chart Report Deleted
The event is triggered when the plug-in saved chart report is deleted.
Chart Report Downloaded
The event is triggered when end-users download the image of the JET chart.
Chart Report Reset
The event is triggered when the plug-in restores the initial settings of the JET chart defined by the application developer.
Chart Report Saved
The event is triggered when the end-user saves the plug-in chart report.