From 61b8435903762e65d4824b8aa16def316eb092c5 Mon Sep 17 00:00:00 2001 From: etimberg Date: Mon, 3 Jul 2017 18:00:03 -0400 Subject: [PATCH] Add a note on how to use getElementAtEvent in a click handler --- docs/developers/api.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/developers/api.md b/docs/developers/api.md index 2875375ed50..a5a0a513396 100644 --- a/docs/developers/api.md +++ b/docs/developers/api.md @@ -128,6 +128,19 @@ myLineChart.getElementAtEvent(e); // => returns the first element at the event point. ``` +To get an item that was clicked on, `getElementAtEvent` can be used. + +```javascript +function clickHandler(evt) { + var item = myChart.getElementAtEvent(evt)[0]; + + if (item) { + var label = myChart.data.labels[firstPoint._index]; + var value = myChart.data.datasets[firstPoint._datasetIndex].data[firstPoint._index]; + } +} +``` + ## .getElementsAtEvent(e) Looks for the element under the event point, then returns all elements at the same data index. This is used internally for 'label' mode highlighting.