g6_add_nodes: Add nodes/edges/combos to a g6 graph via proxy

Description

This function adds one or more nodes/edges/combos to an existing g6 graph instance using a proxy object. This allows updating the graph without completely re-rendering it.

Usage

g6_add_nodes(graph, ...)
g6_add_edges(graph, ...)
g6_add_combos(graph, ...)
g6_add_data(graph, data)

Value

The g6_proxy object (invisibly), allowing for method chaining.

Arguments

graph: A g6_proxy object created with g6_proxy.
...: Nodes or edges or combos. You can pass a list of nodes/edges/combos, a dataframe or leverage the g6_nodes(), g6_edges() or g6_combos() helpers or pass individual elements like g6_node(), g6_edge() or g6_combo(). Elements structure must be compliant with specifications listed at https://g6.antv.antgroup.com/manual/element/overview.
data: A nested list possibly containing nodes, edges and combo data. Can also be created with the g6_data helper.

Details

This function can only be used with a g6_proxy object within a Shiny application. It will not work with regular g6 objects outside of Shiny.

If a node with the same ID already exists, it will not be added again. See https://g6.antv.antgroup.com/en/api/data#graphaddnodedata, https://g6.antv.antgroup.com/en/api/data#graphaddedgedata and https://g6.antv.antgroup.com/en/api/data#graphaddcombodata for more details.

Examples

Run this code

if (interactive()) {
  library(shiny)
  library(g6R)
  library(bslib)

  # Static data defined globally
  nodes <- data.frame(id = 1:3)
  edges <- data.frame(source = c(1, 2), target = c(2, 3))

  ui <- page_fluid(
    title = "Add Nodes Dynamically",
    g6_output("graph"),
    actionButton("add_node", "Add Node")
  )

  server <- function(input, output, session) {
    output$graph <- render_g6({
      g6(nodes = nodes, edges = edges) |> g6_layout()
    })

    next_id <- reactiveVal(max(nodes$id) + 1)

    observeEvent(input$add_node, {
      g6_add_nodes(g6_proxy("graph"), data.frame(id = next_id()))
      next_id(next_id() + 1)
    })
  }

  shinyApp(ui, server)
}