add Plotly.deleteActiveShape command

[archmoj]

Resolves #6678.
@tamidodo Using this dist/plotly.min.js, you could call Plotly.deleteActiveShape(gd) to erase the active shape on the gd.

cc: @plotly/plotly_js

From dash:

clientside_callback(
    """
    function eraseShape(_, graph_id) {
        Plotly.deleteActiveShape(graph_id)
        return dash_clientside.no_update
    }
    """
    Output('my-graph', 'id'),
    Input('erase-button', 'n_clicks'),
    State('my-graph', 'id'),
    prevent_initial_call=True
)

[alexcjohnson]

If we do this we should add lib.getgraphDiv to the function (or make the exported function a wrapper that adds this), so in Dash you'd do something like:

clientside_callback(
    """
    function eraseShape(_, graph_id) {
        Plotly.eraseActiveShape(graph_id)
        return dash_clientside.no_update
    }
    """
    Output('my-graph', 'id'),
    Input('erase-button', 'n_clicks'),
    State('my-graph', 'id'),
    prevent_initial_call=True
)

rather than needing Plotly.eraseActiveShape(document.getElementById(graph_id))
(note this code won't work with pattern-matching IDs but that's a broader issue...)

[alexcjohnson]

💃 LGTM, @tamidodo does this work for your purposes?

[tamidodo]

That's great, thank you all so much!