DOCSP-15047 Click event for data tables (#458)

* DOCSP-15047 Click event for data tables

* DOCSP-15047 updates for feedback

* DOCSP-15047 updates for reviewer feedback

Author: kanchana-mongodb

source/handle-click-events.txt

@@ -58,9 +58,9 @@ Payload
 -------
 
 You can use the click event payload to construct a custom filter that 
-you can apply on another chart or charts in your application. The 
-syntax of the payload object for the callback function looks similar to 
-the following: 
+you can apply on other charts in your application. The syntax of the 
+payload object for the callback function looks similar to the 
+following: 
 
 .. code-block:: sh 
    :copyable: false 
@@ -79,6 +79,8 @@ payload:
 
       chart.addEventListener("click", (payload) => {
         "chartId": "xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
+        "chartTitle": "This is my chart's title", 
+        "chartDescription": "This is my chart's description",
         "event": { // information about the mouse event. For example:
           "type": "click", // event type 
 
@@ -175,6 +177,18 @@ contains:
 - The ``value`` of the clicked element
 - The lower bound for numeric or date binning only
 
+For :ref:`data tables <data-table-ref>`, the Charts Embedding 
+JavaScript SDK click event handler captures click events for the 
+following elements: 
+
+- Chart title 
+- Fields that represent the channel data for the clicked element: 
+  
+  - ``groups`` field, which contains all Groups channels including 
+    label and value
+  - ``cell`` field, which contains the column header label and value of 
+    the clicked cell
+
 .. _click-event-payload-selection-filter:
 
 ``selectionFilter`` Element
@@ -226,6 +240,18 @@ contains information about the clicked target including:
 - The role of mark, such as ``mark``, ``legend``, ``axis-label``, etc.
 - The fill color of the mark
 
+For :ref:`data tables <data-table-ref>`, the Charts Embedding 
+JavaScript SDK click event handler payload captures the following: 
+
+- Mark type, which is ``text`` 
+- Mark role, such as ``group-cell``, ``value-cell``, 
+  ``dynamic-value-cell``, ``row-total-cell``,  
+  ``column-total-cell``, ``header-column-total-cell``, and
+  ``grand-total-cell``
+
+The Charts Embedding JavaScript SDK click event handler does not 
+capture click events on column headers.
+
 .. _click-event-egs:
 
 Examples