This is a patch release fixing a few bugs and a broken unit test.
facet_grid2() and family (#56).Facets have largely been refactored. Accordingly, the vignette has been updated to reflect the latest changes.
The previously existing facet_wrap2() now has the trim_blank option to force nrow and ncol argument if these exceed the number of rows or columns needed to place all the panels. Thanks to @coolbutuseless for letting me steal the idea from the {facetious} package. The facet_wrap2() function was already used to offer more options over axis drawing.
In addition, the cousin facet_grid2() makes an entrance. It offers the same axis drawing extensions as facet_wrap2(), but for the grid layout. Moreover, it allows for independent scales across rows and columns, which is a constraint in ggplot2::facet_grid().
Besides facet_nested_wrap() inheriting from facet_wrap2(), which was already the case, now facet_nested() also inherits from facet_grid2() to make use of the extended axis drawing options. Also, the nest_line argument now takes a element_line() or element_blank() to draw the indicator instead of the logical(1) argument it took previously. The bleed argument has been moved from the nested facet to the new strip_nested() function (see below).
New in the family of facets is now facet_manual(): a facet that can take a user specified design for a layout and populate the panels accordingly.
The facet functions in ggh4x now have strip arguments, which can be used with new strip_*() functions that control how the strips are drawn. For now, they come in the following three variants:
strip_vanilla() which draws normal strips, but allows you to control whether labels should be clipped and has the size argument that can let strips on different layers have different sizes. This can be convenient when the strip labels have very different sizes.strip_themed() does all of the above, but also let’s you assign element_text() and element_rect() to different strips, allowing you to have greater control of their styling. These elements can be assigned independently for the horizontal and vertical strips and can be applied to single strips or layers of strips.strip_nested() again does all of the above, but also merges the strips with the same labels if they are next to one another. This means that the core functionality of facet_nested() and facet_nested() wrap has been moved and is now powered by the strip argument. They can still be convenient to draw nesting indicators.strip.text = element_blank. Requires ggplot2 >3.3.0, or the dev version at time of writing. (#35)guide_axis_manual().facetted_pos_scales through formulas (#25).NEWS.md file to track changes to the package.