Add example of event to data values (#7925)

diff --git a/docs/docs/general/interactions/events.md b/docs/docs/general/interactions/events.md
index b7a6cb1674e54cc6a04903188be5c6e592f8f302..499826792ecdd843169358cd0905d387409df348 100644 (file)
--- a/docs/docs/general/interactions/events.md
+++ b/docs/docs/general/interactions/events.md
@@ -22,3 +22,23 @@ var chart = new Chart(ctx, {
     }
 });
 ```
+
+## Converting Events to Data Values
+
+A common occurrence is taking an event, such as a click, and finding the data coordinates on the chart where the event occurred. Chart.js provides helpers that make this a straightforward process.
+
+```javascript
+const chart = new Chart(ctx, {
+    type: 'line',
+    data: data,
+    options: {
+        onClick: (e) => {
+            const canvasPosition = Chart.helpers.getRelativePosition(e);
+
+            // Substitute the appropriate scale IDs
+            const dataX = chart.scales.x.getValueForPixel(canvasPosition.x);
+            const dataY = chart.scales.y.getValueForPixel(canvasPosition.y);
+        }
+    }
+});
+```
\ No newline at end of file