From 35d669e5bbb7d68f0402add21a95ce4a9f4f4cdd Mon Sep 17 00:00:00 2001
From: Pavel <69010336+Ludar-Pavel@users.noreply.github.com>
Date: Sat, 22 Aug 2020 12:25:28 -0400
Subject: [PATCH] Document .getElementsAtXAxis(e) (#7718)

Preventing pain for people with a specific use case.
---
 docs/docs/developers/api.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/docs/developers/api.md b/docs/docs/developers/api.md
index 5e875146e..d5dcb6e35 100644
--- a/docs/docs/developers/api.md
+++ b/docs/docs/developers/api.md
@@ -128,6 +128,19 @@ canvas.onclick = function(evt) {
 
 This functionality may be useful for implementing DOM based tooltips, or triggering custom behaviour in your application.
 
+## .getElementsAtXAxis(e)
+
+Returns all elements at the data index the event point is located at. This is similar to `getElementsAtEvent(event)`, but the event point does not have to intersect one of the elements.
+
+Calling `getElementsAtXAxis(event)` on your Chart instance passing an argument of an event, or jQuery event, will return the point elements that are at that the same position of that event.
+
+```javascript
+canvas.onclick = function(evt) {
+    var activePoints = myLineChart.getElementsAtXAxis(evt);
+    // => activePoints is an array of points on the canvas that are at the same X axis as the click event.
+};
+```
+
 ## .getDatasetAtEvent(e)
 
 Looks for the element under the event point, then returns all elements from that dataset. This is used internally for 'dataset' mode highlighting.