geom_fit_text() shrinks, grows or wraps text to fit inside a defined
geom_fit_text(mapping = NULL, data = NULL, stat = "identity", position = "identity", na.rm = FALSE, show.legend = NA, inherit.aes = TRUE, padding.x = grid::unit(1, "mm"), padding.y = grid::unit(0.1, "lines"), place = "centre", min.size = 4, grow = FALSE, reflow = FALSE, width = NULL, height = NULL, formatter = NULL, ...)
|data, stat, position, na.rm, show.legend, inherit.aes, ...||
arguments as for
Amount of horizontal and vertical padding around
the text, expressed as
Where inside the box to place the text. Default is 'centre'; other options are 'topleft', 'top', 'topright', etc.
Minimum font size, in points. If provided, text that would need to be shrunk below this size to fit the box will not be drawn. Defaults to 4 pt.
A function that will be applied to the text before it is
drawn. This can be useful when using
Except where noted,
geom_fit_text() behaves more or less like
There are three ways to define the box in which you want the text to be drawn:
On a continuous axis, the limits of the box can be defined in the data using plot aesthetics: 'xmin' and 'xmax', and/or 'ymin' and 'ymax'.
Alternatively on a continuous axis, the centre of the box can be defined
in the data with the 'x' and/or 'y' aesthetic, and the width and/or height
of the box can be specified with a 'width' and/or 'height' argument. 'width'
and 'height' should be provided as
grid::unit() objects; if not, they will
be assumed to use the native axis scale.
On a discrete (categorical) axis, the width or height will be determined automatically. This can be overridden if you wish using the 'width' and 'height' arguments.
By default, the text will be drawn as if with
geom_text(), unless it is
too big for the box, in which case it will be shrunk to fit the box. With
grow = TRUE, the text will be made to fill the box completely whether
that requires shrinking or growing.
reflow = TRUE will cause the text to be reflowed (wrapped) to better fit
in the box. When
grow = FALSE (default), text that fits the box will be
drawn as if with
geom_text(); text that doesn't fit the box will be
reflowed until it does. If the text cannot be made to fit by reflowing
alone, it will be reflowed to match the aspect ratio of the box as closely
as possible, then be shrunk to fit the box. When
grow = TRUE, the text
will be reflowed to best match the aspect ratio of the box, then made to
fill the box completely whether that requires growing or shrinking. Existing
line breaks in the text will be respected when reflowing.
(xmin AND xmax) OR x (required)
(ymin AND ymax) OR y (required)
ggplot2::ggplot(ggplot2::presidential, ggplot2::aes(ymin = start, ymax = end, label = name, x = party)) + geom_fit_text(grow = TRUE)