Cell click callback workaround in Streamlit 1.36.0 dataframes

_streamlit_cell_click_callback.md

Below are my attempts at creating a mechanism to inform Streamlit which specific cell was selected in a dataframe/data_editor. I'm sharing my solution in hope that someone could improve it.

---

TL;DR: we create a hidden Streamlit control and programmatically interact with it from the JS side. Then, when the callback fires, we retrieve the payload and process it in the "proper" Streamlit flow.

To try it out - run working_workaround.py as a python script (not via streamlit run ...!).

---

The JS part for this approach uses a MutationObserver to detect changes to the aria-selected attribute (see observer.js). Initially I tried doing a DFS search within an on-click listener, but it turns out that when the listener is evaluated, the attribute still hasn't changed - hence the observer approach.

Notes about the different attempts:

1. This attempt showcases the JS observer.
2. This attempt contains additional components that could theoretically get the selected grid cell back into python.
3. This attempt listens for mouse events, which at a much higher frequency than click events, demonstrating that the occasional payload does get captured on the python side. Initially I though there was some race condition involved, but it turned out later that the difficulty stemmed from sharing data between threads in the same process.
4. This attempts includes fiddling with the internal Tornado server, as well as SharedMemory for ensuring data is synchronized correctly between threads. I couldn't get the post endpoint of the JSCallbackHandler to work, so I used the set_default_headers which always seems to gets evaluated. Note this solution probably has security vulnerabilities, and no mechanism to differentiate user sessions.

---

Results:

Attempt 1:

Attempt 2:

Attempt 3:

Attempt 4:

---

attempt1.py

from __future__ import annotations

import pandas as pd
import streamlit as st
from streamlit.components.v1 import html


# Create a sample dataframe
df = pd.DataFrame({
    'A': [1, 2, 3],
    'B': [4, 5, 6],
    'C': [7, 8, 9]
})

# JavaScript to add event listeners to dataframe cells and send data to Streamlit
html_contents = """
<script defer>
function setPayload(obj) {
    window.sessionStorage.setItem("payload", JSON.stringify(obj));
}

// const fake_button = window.parent.document.querySelector("[data-testid^='baseButton-secondary']");
const tbl = window.parent.document.querySelector("[data-testid^='stDataFrameResizable']");
const canvas = window.parent.document.querySelector("[data-testid^='data-grid-canvas']");

function handleTableClick(event) {
    // MutationObserver callback function
    const observerCallback = (mutationsList, observer) => {
        for (const mutation of mutationsList) {
            if (mutation.type === 'attributes' && mutation.attributeName === 'aria-selected') {
                const target = mutation.target;
                if (target.tagName === 'TD' && target.getAttribute('aria-selected') === 'true') {
                    console.log(target.id);
                    observer.disconnect(); // Stop observing once the element is found                    
                    setPayload({"action": "click", "cell_id": target.id});
                    // fake_button.click();
                }
            }
        }
    };

    // Create a MutationObserver
    const observer = new MutationObserver(observerCallback);

    // Observe changes in attributes in the subtree of the canvas element
    observer.observe(canvas, { attributes: true, subtree: true });
}

tbl.addEventListener('click', handleTableClick)

console.log("Event listeners added!");
</script>
"""

# Display the dataframe
st.data_editor(df, disabled=True)

html(html_contents)

attempt2.py

from __future__ import annotations

import json

import pandas as pd
import streamlit as st
from streamlit import session_state as ss
from loguru import logger
from streamlit.components.v1 import html
from streamlit_js_eval import streamlit_js_eval


def get_js_payload() -> dict:
    payload: str | None = streamlit_js_eval(
        js_expressions="window.sessionStorage.getItem('payload');",
        want_output=True,
        key="BAZ",
    )
    if payload is None:
        return {}

    return json.loads(payload)


def fake_click(*args, **kwargs):
    event_data: dict = {}
    with logger.catch():
        event_data: dict = get_js_payload()
    ss["PAYLOAD"] = event_data
    print(f"JS event detected: {event_data}")


# Create a sample dataframe
df = pd.DataFrame({
    'A': [1, 2, 3],
    'B': [4, 5, 6],
    'C': [7, 8, 9]
})

# JavaScript to add event listeners to dataframe cells and send data to Streamlit
html_contents = """
<script defer>
function setPayload(obj) {
    window.sessionStorage.setItem("payload", JSON.stringify(obj));
}

const fake_button = window.parent.document.querySelector("[data-testid^='baseButton-secondary']");
const tbl = window.parent.document.querySelector("[data-testid^='stDataFrameResizable']");
const canvas = window.parent.document.querySelector("[data-testid^='data-grid-canvas']");

function handleTableClick(event) {
    // MutationObserver callback function
    const observerCallback = (mutationsList, observer) => {
        for (const mutation of mutationsList) {
            if (mutation.type === 'attributes' && mutation.attributeName === 'aria-selected') {
                const target = mutation.target;
                if (target.tagName === 'TD' && target.getAttribute('aria-selected') === 'true') {
                    console.log(target.id);
                    observer.disconnect(); // Stop observing once the element is found                    
                    setPayload({"action": "click", "cell_id": target.id});
                    fake_button.click();
                }
            }
        }
    };

    // Create a MutationObserver
    const observer = new MutationObserver(observerCallback);

    // Observe changes in attributes in the subtree of the canvas element
    observer.observe(canvas, { attributes: true, subtree: true });
}

tbl.addEventListener('click', handleTableClick)

/*
tbl.onmouseover = function() {
    setPayload({"action": "enter"});
    fake_button.click();
};
tbl.onmouseout = function() {
    setPayload({"action": "leave"});
    fake_button.click();
};
*/

console.log("Event listeners added!");
</script>
"""

# Display the dataframe
st.data_editor(df, disabled=True)

# Create a fake button:
st.button("", key="FAKE_BUTTON", on_click=fake_click)
st.markdown(
    """
    <style>
    button, iframe {
        visibility: hidden;
    }
    </style>
    """,
    unsafe_allow_html=True,
)
html(html_contents)

attempt3.js

// To run, use attempt2.py and replace the script inside `html_contents` with the below:
function setPayload(obj) {
    window.sessionStorage.setItem("payload", JSON.stringify(obj));
}

const fake_button = window.parent.document.querySelector("[data-testid^='baseButton-secondary']");
const tbl = window.parent.document.querySelector("[data-testid^='stDataFrameResizable']");

tbl.onmouseover = function() {
    setPayload({"action": "enter"});
    fake_button.click();
};
tbl.onmouseout = function() {
    setPayload({"action": "leave"});
    fake_button.click();
};

console.log("Event listeners added!");

observer.js

function setPayload(obj) {
    window.sessionStorage.setItem("payload", JSON.stringify(obj));
}

const fake_button = window.parent.document.querySelector("[data-testid^='baseButton-secondary']");
const tbl = window.parent.document.querySelector("[data-testid^='stDataFrameResizable']");
const canvas = window.parent.document.querySelector("[data-testid^='data-grid-canvas']");

function handleTableClick(event) {
    // MutationObserver callback function
    const observerCallback = (mutationsList, observer) => {
        for (const mutation of mutationsList) {
            if (mutation.type === 'attributes' && mutation.attributeName === 'aria-selected') {
                const target = mutation.target;
                if (target.tagName === 'TD' && target.getAttribute('aria-selected') === 'true') {
                    console.log(target.id);
                    observer.disconnect(); // Stop observing once the element is found                    
                    setPayload({"action": "click", "cell_id": target.id});
                    // fake_button.click();
                }
            }
        }
    };

    // Create a MutationObserver
    const observer = new MutationObserver(observerCallback);

    // Observe changes in attributes in the subtree of the canvas element
    observer.observe(canvas, { attributes: true, subtree: true });
}

tbl.addEventListener('click', handleTableClick)

console.log("Event listeners added!");

working_workaround.py

import asyncio
import json
import os
import threading
from dataclasses import dataclass
from itertools import chain
from multiprocessing.shared_memory import SharedMemory
from typing import Any

import pandas as pd
import streamlit as st
from streamlit import session_state as ss
from streamlit.components.v1 import html
from streamlit.web.server import Server
from streamlit.web.server.server import start_listening
from tornado.web import RequestHandler


_JS_TO_PD_COL_OFFSET: int = -2

# Create shared memory for the payload
try:
    payload_memory = SharedMemory(name="JS_PAYLOAD", create=True, size=128)
except FileExistsError:
    payload_memory = SharedMemory(name="JS_PAYLOAD", create=False, size=128)


@dataclass
class Selection:
    """Dataclass to store the selected cell information."""
    col: int
    row: int
    sorted_by: int


def sort_df_by_selected_col(table: pd.DataFrame, js_sorted_by: int) -> pd.DataFrame:
    if js_sorted_by == 1:
        return table
    elif js_sorted_by == -1:
        return table.sort_index(axis=0, ascending=False)
    sorting_col: str = table.columns[abs(js_sorted_by) + _JS_TO_PD_COL_OFFSET]
    return table.sort_values(by=sorting_col, ascending=js_sorted_by > 0)


def _retrieve_payload() -> Selection:
    """Retrieve the payload from the shared memory and return it as a tuple."""
    payload = {}
    if payload_memory.buf[0] != 0:
        payload_bytes = bytearray(payload_memory.buf[:])
        payload_str = payload_bytes.decode('utf-8').rstrip('\x00')
        payload_length, payload = len(payload_str), json.loads(payload_str)
        payload_memory.buf[:payload_length] = bytearray(payload_length)
    if payload:
        selected_cell_info = Selection(*(
            int(val) for val in chain(payload.get('cellId').split(','), [payload.get('sortedByCol')])
        ))
        print(f"{os.getpid()}::{threading.get_ident()}: Streamlit callback received payload: {selected_cell_info}")
        return Selection(selected_cell_info.col-1, selected_cell_info.row, selected_cell_info.sorted_by)
    else:
        print(f"{os.getpid()}::{threading.get_ident()}: Streamlit callback saw no payload!")
        return Selection(-1, -1, -1)


def _interpret_payload(payload: Selection) -> tuple[Any, Any]:
    """Interpret the payload and return the selected row and column."""
    sorted_df = sort_df_by_selected_col(df, payload.sorted_by)
    selected_row = sorted_df.index[payload.row]
    selected_col = sorted_df.columns[payload.col] if payload.col >= 0 else None

    # Update a text field:
    selection_str = f", with contents: `{sorted_df.iat[payload.row, payload.col]}`" if selected_col else ""
    ss["CELL_ID"] = (
        f"Clicked on cell with index [{selected_row}, {selected_col}]"
        f" (at position [{payload.row}, {payload.col}])" 
        f"{selection_str}."
    )
    return selected_row, selected_col


def fake_click(*args, **kwargs):
    parsed_payload: Selection = _retrieve_payload()
    # ss["PAYLOAD"] = parsed_payload
    selected_row, selected_col = _interpret_payload(parsed_payload)
    # ss["SELECTION"] = selected_row, selected_col

    # Do something with selection...


# Create a sample dataframe
df = pd.DataFrame({
    'A': [1, 2, 3],
    'B': [4, 5, 6],
    'C': [7, 8, 9]
})

# JavaScript to add event listeners to dataframe cells and send data to Streamlit
html_contents = """
<script defer>
const fakeButton = window.parent.document.querySelector("[data-testid^='baseButton-secondary']");
const tbl = window.parent.document.querySelector("[data-testid^='stDataFrameResizable']");
const canvas = window.parent.document.querySelector("[data-testid^='data-grid-canvas']");
let sortedBy = 1

function sendPayload(obj) {
    payloadStr = JSON.stringify(obj);
    window.sessionStorage.setItem("payload", payloadStr);
    fetch('/js_callback', {
        method: 'POST',
        body: payloadStr,
        headers: {
            'Content-Type': 'application/json'
        }
    })
    .then(response => {
        fakeButton.click();
    });    
}

function updateColumnValue() {
    const headers = canvas.querySelectorAll('th[role="columnheader"]');
    let arrowFound = false;
    
    headers.forEach(header => {
        const textContent = header.textContent.trim();
        const colIndex = parseInt(header.getAttribute('aria-colindex'), 10);

        if (textContent.startsWith('↑')) {
            sortedBy = colIndex;
            arrowFound = true;
        } else if (textContent.startsWith('↓')) {
            sortedBy = -colIndex;
            arrowFound = true;
        }
    });
    if (!arrowFound) {
        sortedBy = 1;
    }    
    console.log(`Sorting column is now: ${sortedBy}`);
}

const sortObserver = new MutationObserver((mutations) => {
    mutations.forEach((mutation) => {
        if (mutation.type === 'characterData' || mutation.type === 'childList') {
            updateColumnValue();
        }
    });
}); 

// Observe changes in the canvas element and its subtree
sortObserver.observe(canvas, {
    characterData: true,
    childList: true,
    subtree: true
});

function handleTableClick(event) {
    // MutationObserver callback function
    const cellObserverCallback = (mutationsList, observer) => {
        for (const mutation of mutationsList) {
            if (mutation.type === 'attributes' && mutation.attributeName === 'aria-selected') {
                const target = mutation.target;
                if (target.tagName === 'TD' && target.getAttribute('aria-selected') === 'true') {
                    cellCoords = target.id.replace('glide-cell-','').replace('-',',');
                    console.log(`Detected click on cell {${cellCoords}}, sorted by column "${sortedBy}"`);
                    observer.disconnect(); // Stop observing once the element is found                    
                    sendPayload({"action": "click", "cellId": cellCoords, "sortedByCol": sortedBy});                    
                }
            }
        }
    };

    // Create a MutationObserver
    const cellObserver = new MutationObserver(cellObserverCallback);  

    // Observe changes in attributes in the subtree of the canvas element
    cellObserver.observe(canvas, { attributes: true, subtree: true });
}

tbl.addEventListener('click', handleTableClick)
console.log("Event listeners added!");
</script>
"""

# Display the dataframe
st.data_editor(df, disabled=True, key="DATAFRAME")

st.text_input(label="N/A", label_visibility="hidden", key="CELL_ID", disabled=True, help="Click on a cell...")

# Create a fake button:
st.button("", key="fakeButton", on_click=fake_click)
st.markdown(
    """
    <style>
    button, iframe {
        visibility: hidden;
    }
    </style>
    """,
    unsafe_allow_html=True,
)
html(html_contents)


class JSCallbackHandler(RequestHandler):
    def set_default_headers(self):
        # We hijack this method to store the JS payload
        try:
            payload: bytes = self.request.body
            print(f"{os.getpid()}::{threading.get_ident()}: Python received payload: {json.loads(payload)}")
        except json.JSONDecodeError:
            raise ValueError("Invalid JSON payload!")

        if payload_memory.buf[0] == 0:
            payload_memory.buf[:len(payload)] = payload
            print(f"{os.getpid()}::{threading.get_ident()}: Payload {payload} stored in shared memory")


class CustomServer(Server):
    async def start(self):
        # Override the start of the Tornado server, so we can add custom handlers
        app = self._create_app()

        # Add a new handler
        app.default_router.add_rules([
            (r"/js_callback", JSCallbackHandler),
        ])

        # Our new rules go before the rule matching everything, reverse the list
        app.default_router.rules = list(reversed(app.default_router.rules))

        start_listening(app)
        await self._runtime.start()


if __name__ == '__main__':
    # See: https://bartbroere.eu/2024/03/27/adding-custom-tornado-handlers-to-streamlit/
    import streamlit.web.bootstrap
    
    if '__streamlitmagic__' not in locals():
        # Code adapted from bootstrap.py in streamlit
        streamlit.web.bootstrap._fix_sys_path(__file__)
        streamlit.web.bootstrap._fix_tornado_crash()
        streamlit.web.bootstrap._fix_sys_argv(__file__, [])
        streamlit.web.bootstrap._fix_pydeck_mapbox_api_warning()
        streamlit.web.bootstrap._fix_pydantic_duplicate_validators_error()
        # streamlit.web.bootstrap._install_pages_watcher(__file__)  # Uncomment if on Streamlit < v1.36.0

        server = CustomServer(__file__, is_hello=False)

        async def run_server():
            await server.start()
            streamlit.web.bootstrap._on_server_start(server)
            streamlit.web.bootstrap._set_up_signal_handler(server)
            await server.stopped

        asyncio.run(run_server())

Hi @enoch-nkm, please clarify - did you use working_workaround.py or anything else? In one of the animations I demonstrate how the variable gets received and printed in the python console. Also, which OS + python version are you using?

The variable can only be not-initialized if shared memory isn't working correctly, since the frontend thread (where js runs) is usually different from the backend thread (where the click is processed in python). Variable sharing between threads doesn't happen unless it is set up correctly.

Other than that, I have some small improvements to the script related to using the right cell when the frontend table is sorted, which I plan to upload eventuall.

Hi, thanks for your reply!
I am using the working_workaround.py on Windows 10 with streamlit version 1.36.0, python version 3.11.2 on Chrome Browser.

When executing, i get this error message when i click on a cell:
KeyError: 'st.session_state has no key "PAYLOAD". Did you forget to initialize it?
File "test.py", line 35, in fake_click
row = ss["PAYLOAD"][1]

The cell coordinates do show up in the js console and the app reruns on every cell selection, when i add code that prevents the error from occuring.
The code i added to the fake_click() function:
if "PAYLOAD" not in ss:
ss["PAYLOAD"] = [0,0]

I think the problem is you're running the app using streamlit run working_workaround.py, whereas what you should be doing is python working_workaround.py - if you run using the default way, the server doesn't get replaced with the one that passes the info to python.

Also, note that the solution was originally intended for Streamlit 1.35.0, and it requires a small modification to allow it to work. Please see the updated code and try running as suggested.

This works, thank you so much!
I had to delete the -> tuple[Any, Any]: in line 64 because this gave me: TypeError: 'type' object is not subscriptable but otherwise this works when running it using python. Thanks, excellent work!

Bitte sehr! I'm happy you found it useful!

@enoch-nkm I made a better implementation and submitted a PR. It seems that the company isn't convinced that this feature is necessary. If more people upvote the issue related to this it might help them change their mind.

Regardless, if the PR doesn't get merged in the near future, I might package my own version of streamlit with the change included.

Hi @enoch-nkm , when I ran the working_workaround.py file, I got the http 405 response for /js_callback endpoint. I wonder whether you have solutions for that.

@jidalii I can upload a .whl with the implementation I included in my PR, which makes all of the above hacks unnecessary.

@Dev-iL That would be really helpful. Thank you so much!

streamlit-1.38.0.666-py2.py3-none-any.zip

streamlit-1.39.0.666-py2.py3-none-any.zip