girafe_class: Add, remove or toggle CSS classes on girafe elements

In ggiraph: Make 'ggplot2' Graphics Interactive

Add, remove or toggle CSS classes on girafe elements

Description

These functions allow programmatic manipulation of CSS classes on SVG elements within a girafe output in Shiny applications. Elements are targeted by their data-id, key-id, or theme-id attributes.

Usage

girafe_class_add(
  session,
  id,
  class,
  data_id = NULL,
  key_id = NULL,
  theme_id = NULL
)

girafe_class_remove(
  session,
  id,
  class,
  data_id = NULL,
  key_id = NULL,
  theme_id = NULL
)

girafe_class_toggle(
  session,
  id,
  class,
  data_id = NULL,
  key_id = NULL,
  theme_id = NULL
)

Arguments

session	The Shiny session object.
id	The output id of the girafe element (the outputId used in girafeOutput()).
class	A non-empty character string of CSS class names to add, remove, or toggle.
data_id	A character vector of data-id values identifying the target elements.
key_id	A character vector of key-id values identifying the target elements.
theme_id	A character vector of theme-id values identifying the target elements.

Details

At least one of data_id, key_id, or theme_id must be provided.

These functions send a custom message to the JavaScript side, which applies the CSS class operation to all matching SVG elements within the girafe root node.

Examples

## Not run: 
# In a Shiny server function:
girafe_class_add(session, "plot", "highlighted", data_id = "some_id")
girafe_class_remove(session, "plot", "highlighted", data_id = "some_id")
girafe_class_toggle(session, "plot", "highlighted", data_id = "some_id")

## End(Not run)

ggiraph documentation built on Feb. 17, 2026, 9:07 a.m.