Changelog
Source:NEWS.md
g6R 0.5.0
Potential breaking changes
Due to the new data validation for nodes, edges and combos, some existing code might break if the data provided to g6R functions is not valid. See the corresponding documentation section. If you had to pass custom data you can do it in the data slot.
New features and fixes
- New
g6_update_layout()proxy function to order the layout re-execution and optionally update its parameters. - New
input[["<graph_ID>-mouse_position"]]: any click/right click or drag release event captures the mouse position.input[["<graph_ID>-mouse_position"]]contains the x and y coordinates of the mouse relative to the canvas. This is useful to add a node where the mouse was clicked, a context menu was triggered or the create edge was released on the canvas without a specific target. - Elements selected via
brush_select()have a custom input handler. This may give:
Notice the extra attribute, which allows to make a difference between click_select() and brush_select() events.
- Get correct element type on click: it was possible that whenclicking a combo it appeared under
input$<graph_ID>-selected_nodeinstead ofinput$<graph_ID>-selected_combo. This is now fixed. -
create_edge()behavior improved: when creating an edge and it is release on the canvas, the edge isn’t cancelled and data are available. We added atargetTypeproperty which allows to know where the edge was dragged. - Added new elements API:
g6_node(),g6_edge(),g6_combo()to create nodes, edges and combos respectively. We suggest to use them instead of passing lists or dataframes to g6 as they provide safety checks. We also addedg6_nodes(),g6_edges()andg6_combos()which are internally used by some proxy functions likeg6_add_nodes()to provide more flexibility. - New
options("g6R.mode)that can bedevorprod(default). Indevmode, Shiny notifications are displayed in the UI whenever a JavaScript error happens (they are still available in the JS console). -
g6_focus_elements(),g6_hide_elements()andg6_show_elements()gain more specific siblings:g6_focus_nodes(),g6_focus_edges(),g6_focus_combos(),g6_hide_nodes(),g6_hide_edges(),g6_hide_combos(),g6_show_nodes(),g6_show_edges(),g6_show_combos(). -
brush_select(),lasso_select()andcreate_edge()gain anoutputIdparameter which allows to manually pass the Shiny output ID of the graph instance. This is useful when the graph is initialised outside the shiny render function and the ID cannot be automatically inferred withshiny::getCurrentOutputInfo(). This allows to set input values from the callback function with the right namespace and graph ID. You must typically passsession$ns("graphid")to ensure this also works in modules. - Improvements to
brush_select(): now it correctly returns the list of selected nodes, edges and combos, available viainput$<graph_ID>-selected_node,input$<graph_ID>-selected_edgeandinput$<graph_ID>-selected_combo, thanks to the internal IDs refactoring. After a brush select operation, you can now shift click (depending on theclick_select()multiple selection trigger settings you set, it might be another key) to add/remove elements to/from the current selection. -
lasso_select()also gets the same quality of life improvements. - Fix: when selecting (simple select not multiselect) an edge/node/combo, if another type of element was selected, the corresponding input is reset. This avoids to accidentally delete a previously selected element when another type of element is selected.
- Fix: state never get set on first render.
- Fix #23: graph has to be re-rendered after dynamic plugin addition so that new elements like
hullare drawn. - Fix #22: internal typo in JS function when an error was caught in the graph.
- Add
input$<graph_ID>-contextmenuto extract the type and id of element which was clicked in the context menu. This can be listened to from the Shiny server function. - Fix layout and behavior issues in some examples:
drag_element_forceonly works whenanimationis TRUE. Also addedautoFit = TRUEwherever required (manual layout vignette).