Skip to contents

Changelog

Source: NEWS.md

ggiraph 0.9.6

CRAN release: 2026-02-21

Issues

  • Fix documentation and examples so that R CMD check run ok when _R_CHECK_DEPENDS_ONLY_: true

ggiraph 0.9.5

CRAN release: 2026-02-17

Feature

  • New functions girafe_class_add(), girafe_class_remove() and girafe_class_toggle() allow programmatic manipulation of CSS classes on girafe SVG elements from Shiny. Elements are targeted by data_id, key_id or theme_id (#321).
  • opts_hover() and opts_selection() gain a new linked parameter. When linked = TRUE, hover and selection states are shared between geometry elements (data-id) and legend/guide elements (key-id): hovering or clicking a legend key highlights or selects the corresponding geometries, and vice versa (#330).

Changes

  • Mouse events replaced by Pointer Events for touch device support. Hover and tooltips now work on mobile via tap; the lasso selection tool is disabled on touch devices (#300).

Issues

  • fix linked hover state not clearing when cursor leaves a legend key without re-entering the panel area (#330).
  • fix label_interactive broken by the new V4 ggplot2 (#348)
  • fix interactive labels in binned guides when scale breaks fall outside limits (#338)

ggiraph 0.9.4

CRAN release: 2026-02-04

  • toolbar gains new button “fullscreen”.
  • internals: lasso local replace d3-lasso and ggiraph is using the latest version of d3.js.

ggiraph 0.9.3

CRAN release: 2026-01-19

Change

  • reorder arguments of girafe() with argument ggobj in first position. IT DOES NOT makes ggplot objects pipe-able with girafe() (unless you add parenthesis around your ggplot code).

Feature

  • options passed to girafe() are now merged with defaults from set_girafe_defaults() instead of replacing them entirely. This allows setting global styles while overriding specific parameters per plot (#328).

Issues

  • tooltip position is now reset to (0,0) when it disappears, fixing potential layout issues in flexdashboard and similar containers. (#323)
  • single quotes in attribute values (e.g. “Côte d’Ivoire”) are now automatically escaped instead of raising an error (#329).
  • fix “Unknown or uninitialised column: subgroup” warning when using geom_segment_interactive() or geom_path_interactive() with coord_polar() (#344).

ggiraph 0.9.2

CRAN release: 2025-10-07

Feature

  • add interactive version of ggbeeswarm::geom_quasirandom, see geom_quasirandom_interactive().
  • add default_on parameter to opts_zoom() to automatically activate pan/zoom mode when plot is rendered.
  • improve opts_toolbar() documentation and examples to better demonstrate the hidden parameter for customizing which toolbar buttons are displayed.
  • add examples with correct management of fonts (using register_liberationsans()).
  • add check_fonts_registered and check_fonts_dependencies arguments to girafe() to validate that fonts used in plots are properly registered and available in HTML dependencies.

Issues

internals

  • refresh the process that bundle the javascript file thanks to package ‘packer’.
  • id is now defined with an simple internal function copied from shinyWidgets::genId

changes

ggiraph 0.9.1

CRAN release: 2025-09-16

Issues

  • adapt codes for ggplot2 4.0.0. There are lot of changes in ggplot2 4.0.0 and we hope we did not miss anything…
  • fix regexpr pattern used in facet_wrap_interactive() that was causing issues when there were more than 9 levels.

ggiraph 0.9.0

CRAN release: 2025-08-18

Issues

  • fix usage of requireNamespace in the example for R >= 4.5.1.
  • change few codes for compatibility with ‘ggplot2’ 4.0.0.

ggiraph 0.8.13

CRAN release: 2025-03-28

Issues

  • Use png from the system via pkg-config, thanks to Tomas Kalibera:

This patch switches to using png from the system, when available via ‘pkg-config’ or otherwise using hard-coded library dependencies. It makes the package work with png from ‘Rtools42-45’. Behavior with previous versions of R is not affected, as this uses the ‘.ucrt’ version of Makevars. Using libraries from the system/Rtools when available is required by the CRAN repository policy. Also, it silences a warning […] about using non-allowed external symbols.

ggiraph 0.8.12

CRAN release: 2025-01-08

Issues

  • enable build in Alpine linux, thanks to Sebastian Meyer.
  • geom_line_interactive() now correctly assigns data_id and tooltip values

Changes

ggiraph 0.8.10

CRAN release: 2024-05-17

Changes

  • girafeOutput() argument height now defaults to NULL. Set height to “500px” to recover previous disposition.

Issues

  • fixed size is now defined within style in inches, the size is now as expected.

Feature

  • support trailing commas everywhere
  • girafe toolbar can now be fixed instead of floating. This feature can be defined with opts_toolbar(fixed = TRUE).

ggiraph 0.8.9

CRAN release: 2024-02-24

Changes

  • adapt guides to ggplot ‘3.5.0’
  • deprecate ggiraph
  • A font check is now done with theme settings (only when argument ggobj is used)

Issues

  • When bg is set to ‘transparent’, it’s been transformed to almost transparent ‘#ffffff01’.
  • Enable screen-readers to read items - set svg role to ‘graphics-document’

ggiraph 0.8.8

CRAN release: 2023-12-09

Issues

  • Fix issue with interactive points when shapes with lines are used (#252).
  • correct Rf_error("... (%S)", note); to Rf_error("... (%s)", note);

ggiraph 0.8.7

CRAN release: 2023-03-17

Changes

Issues

  • grid makeContext for CRAN check
  • drop cpp11 requirement

ggiraph 0.8.6

CRAN release: 2023-01-22

features

Issues

  • Fix missing inclusion of in src/raster.cpp.

ggiraph 0.8.5

CRAN release: 2022-12-03

Issues

  • Make girafe_options() more robust to changes in htmlwidgets::sizingPolicy()

ggiraph 0.8.4

CRAN release: 2022-11-15

Enhancement

  • Added tooltips argument to opts_toolbar for internationalization purposes
  • Added hidden argument to opts_toolbar for hiding buttons/button groups
  • Added zoom by rectangle feature and zoom related improvements
  • New feature: hover nearest element on mouse movement
  • Improved javascript performance (mouse event handling)
  • Added interactive parameters for outlier points in geom_boxplot_interactive
  • Added accessibility elements to the SVG output (title, desc, role)
  • Added opts_selection_inv for inverted selection effect
  • Added set_girafe_defaults(), girafe_defaults() and init_girafe_defaults() to set some default girafe options automatically. Also in R Markdown, svg default width and height are set to knitr chunk options fig.width and fig.height.

Issues

  • fix: issue with incorrect font used on png export
  • fix: issue with broken interactivity on discrete guides
  • fix: issue with geom_segment_interactive and polar coords
  • fix: set fill/stroke color to svg elements even if opacity is zero.
  • fix: hover styles should take priority over selection styles.
  • doc: updated documentation links
  • test: updated some tests to check for required packages
  • test: updated github actions

Changes

ggiraph 0.8.3

CRAN release: 2022-08-19

Issues

  • fix: update Rd content to produce valid HTML5 (for CRAN manuals now using HTML5 format).

ggiraph 0.8.2

CRAN release: 2022-02-22

Issues

  • fix linetype when line size is less than 1 (#216).
  • fix a length-1 issue in inst/tinytest/test-fonts.R

ggiraph 0.8.1

CRAN release: 2021-12-15

Issues

  • skip test test-zz-dom.R when ‘PhantomJS’ is not installed
  • skip tests test-interactive_text_grob.R and test-fonts.R when no font is detected on the system.

ggiraph 0.8.0

CRAN release: 2021-12-08

Enhancement

  • Updated DSVG device version to 14
  • Added support for clipping paths, masks, gradients and patterns
  • Implemented new version of internal DSVG device
  • Refactored cpp code, to smaller files per context
  • Added tests for tinytest & improved coverage
  • New geom functions: geom_violin_interactive, geom_label_repel_interactive, geom_text_repel_interactive, geom_contour_filled_interactive, geom_hex_interactive, geom_spoke_interactive, geom_curve_interactive, geom_count_interactive, geom_bin_2d_interactive, geom_density_2d_filled_interactive.
  • New grob functions: interactive_curve_grob.
  • New scale functions: scale_alpha_binned_interactive.
  • Added outputArgs argument to renderGirafe, for controlling svg dimensions in rmarkdown
  • Demote to warning the error case of setting svg attributes because of mismatched id’s.
  • Added support for custom interactive parameters via extra_interactive_params argument
  • Miscellaneous refactorings & improvements to internal code

Changes

  • Updated tinyxml2 to version 9.0.0
  • Switched to tinytest for testing
  • Updated dependency for ggplot2 to version 3.3.5.
  • Updated libs for Windows build (thanks to Jeroen Ooms)

Issues

  • Fixed interactive_text_grob when check.overlap = TRUE
  • Fixed interactive_points_grob interactive attributes when shapes with lines are used
  • Fixed issues for geom_errorbar_interactive
  • Fixed some typos in documentation
  • Handle NA’s in GeomInteractiveTile

ggiraph 0.7.10

CRAN release: 2021-05-19

Enhancement

  • Make sure that parameters for panel_draw|group are the same as in ggplot2
  • Updated labeller_interactive so that its usage is more intuitive
  • Updated geoms and utils from latest ggplot2

Issues

  • drop configure script and mimic svglite way of integrating libpng

ggiraph 0.7.9

CRAN release: 2021-05-12

Enhancement

  • New function geom_dotplot_interactive.
  • New function labeller_interactive to make strip labels interactive.

Changes

  • Improved tooltip positioning and added ‘placement’ parameter
  • Added ‘tooltip_fill’ interactive attribute
  • move font management from gdtools to systemfonts, also libpng is now required as gdtools/cairo is not used anymore. It comes also with functions validated_fonts() and also match_family() and font_family_exists() that have been copied from package gdtools.
  • Updated some geometries from latest ggplot2

Issues

  • Fixed issue with tooltip fill color in geom_label_interactive
  • Fixed tooltip issues (scaling and markup decoding) in xaringan
  • Fixed issue with tooltip css missing zindex and pointer-events

ggiraph 0.7.8

CRAN release: 2020-07-01

Changes

  • update for changes in the R graphics engine (thanks to Dr Paul Murrell)

Issues

  • set max size in shiny to shinyOutput size

ggiraph 0.7.7

Enhancement

  • Updated geoms to ggplot2 v3.3.0
  • Added new scales and guides from ggplot2 v3.3.0

ggiraph 0.7.5

Enhancement

  • Using tinyxml2 for creating the svg doc

ggiraph 0.7.1

Enhancement

  • Refactoring of ggiraphjs, with separate modules for each action context
  • Added shiny messaging for hovered elements
  • Added opts_hover_inv for inverted hover effect
  • Added parameter for exported png filename and set png quality to 1

Bug fixes

  • misc fixes in interactive geom internals

Documentation

  • Added a complete shiny example (gender) for selection/hover options/tricks

ggiraph 0.7.0

CRAN release: 2019-10-31

Enhancement

  • refactoring of internals
  • new function girafe_css() to define individual css properties per type of elements
  • ability to add interactivity to panel as usual but also theme and scales now
  • Upgrade geoms to ggplot2 v3.2.0 (thanks for this huge work kindly made by Panagiotis Skintzos)

ggiraph 0.6.2

Enhancement

  • tooltip will always be displayed inside the SVG area (for small devices)
  • Upgrade geoms to ggplot2 v3.2.0 (thanks for this huge work kindly made by Panagiotis Skintzos)

Bug fixes

  • Handle html entities in tooltip
  • fix some differences of rendering between ggplot2 pure graphs and girafe output (#125)

ggiraph 0.6.1

CRAN release: 2019-04-09

Enhancement

  • new annotate_interactive function.

Changes

  • improving sizing with shiny.

ggiraph 0.6.0

CRAN release: 2018-11-01

Changes

  • The package is no more importing rvg and now need a compiler to install the package from source. The dsvg function will be then removed from rvg.

ggiraph 0.5.0

CRAN release: 2018-09-27

Changes

  • the package offers now new functions girafe() and girafe_options() to be used instead of function ggiraph(). It is more convenient to use when customization is needed.

Enhancement

  • add a ‘download as png’ button
  • usage of d3 version 5.7.0

Bug fixes

  • responsive behaviour when rendered in IE <= 12 is now fixed

ggiraph 0.4.4

CRAN release: 2018-07-15

Enhancement

  • new functions geom_sf_interactive

ggiraph 0.4.3

CRAN release: 2018-06-10

Enhancement

  • new functions geom_hline_interactive and geom_vline_interactive implemented by Eric Book.
  • all element with the same data_id are highlighted when mouse is over one of these elements.
  • ggproto GeomInteractive are exported.

ggiraph 0.4.2

CRAN release: 2017-12-19

Changes

  • ggiraph has a new argument dep_dir that controls the location of the output files.
  • deprecation of argument use_widget_size and flexdashboard. I hope this is the last mention to theses in the NEWS file.

ggiraph 0.4.1

CRAN release: 2017-09-05

Changes

  • argument flexdashboard and width are no more deprecated…
  • ggiraph gains a new argument use_widget_size that force usage of htmlwidget size and block the responsive behavior.

ggiraph 0.4.0

CRAN release: 2017-06-24

Enhancement

  • lasso selection has been implemented in Shiny context
  • a toolbar for zooming and selecting elements has been implemented.

Changes

  • zoom is disabled by default and can be activated via a button in the toolbar. It prevents scrooling issue (mouse over a zoomable svg steals scroll ability within the document).
  • ggiraph arguments flexdashboard and width are now deprecated and have no effects

ggiraph 0.3.3

CRAN release: 2017-03-24

Enhancement

  • widget sizing has been improved and ggiraph function gains new argument flexdashboard to make sure the graph fits available room.

Bug fixes

  • warnings did occur because some default_aes of ggproto were missing
  • slow zoom pan effect is now solved

ggiraph 0.3.2

CRAN release: 2016-11-04

New features

  • new geometry: geom_tile_interactive

Bug fixes

  • fix for element selection: svg elements with same id were not all selected but the only element that was clicked
  • fix css issues that occured when several ggiraph were on the same page and their tooltip did not share the same css attributes.

Enhancement

  • link to the online documentation.
  • usage of d3.js V4

ggiraph 0.3.1

CRAN release: 2016-07-01

New features

  • size management has been improved
  • there are 3 new geometries: geom_boxplot_interactive, geom_line_interactive and geom_bar_interactive.

Bug fixes

  • addCustomMessageHandler has to be called once to avoid a javascript exception
  • fix display issue in RStudio viewer for Windows

ggiraph 0.3.0

CRAN release: 2016-05-04

Enhancement

  • Allow zooming & panning to be turned off
  • clicked elements can now be tracked from shiny

ggiraph 0.2.0

CRAN release: 2016-03-03

Enhancement

  • Migration to d3.js
  • Update to htmlwidgets 0.6