theme
Use theme() to modify individual components of a theme, allowing you to control the appearance of all non-data components of the plot.
All parameters responsible for styling of lines, rectangles (often called "background") and texts accept:
string "blank" or the result of the
elementBlank()function.the result of
elementLine(),elementRect()orelementText()respectively.
Settings passed via more specific parameters override settings passed via less specific parameters. For example, parameter axisLineX is more specific than parameter axisLine.
Examples
Parameters
default="e" ("e", "pow"). Format for numeric labels in scientific notation. e for "e" notation (e.g. 1e+6); pow for "power" notation (e.g. 1x10^6). This will enable superscript formatting for the exponent.
All line elements.
All rectangle elements.
All text elements.
All line elements: plot, axes, legends.
All axis elements: lines, ticks, texts, titles.
Option to place axis (lines, tick-marks and labels) over the data layers.
Option to place X-axis (lines, tick-marks and labels) over the data layers.
Option to place Y-axis (lines, tick-marks and labels) over the data layers.
Labels of axes.
Labels of axes.
Labels of axes.
Tick labels along axes.
Tick labels along axes.
Tick labels along axes.
Tick marks along axes.
Tick marks along axes.
Tick marks along axes.
Length of tick marks.
Length of tick marks.
Length of tick marks.
Lines along axes.
Lines along axes.
Lines along axes.
Background of legend.
Legend item labels.
Title of legend.
Background of plotting area.
Border around plotting area.
Option to place border around plotting area over the data layers.
Grid lines.
Grid lines.
Grid lines.
Grid lines.
Grid lines.
Grid lines.
Grid lines.
Option to place major grid lines and minor grid lines over the data layers.
Option to place X-axis major grid lines and minor grid lines over the data layers.
Option to place Y-axis major grid lines and minor grid lines over the data layers.
Inset for a panel. The inset behaves like a padding for coordPolar(transofrmBkgr = false) otherwise it behaves like a margin around the panel. The inset may be specified using a number or a list of numbers:
a number or list of one number - the same inset it applied to all four sides;
a list of two numbers - the first inset applies to the top and bottom, the second - to the left and right;
a list of three numbers - the first margin applies to the top, the second - to the right and left, the third - to the bottom;
a list of four numbers - the insets are applied to the top, right, bottom and left in that order. It is acceptable to use
nullfor any side; in this case, the default value for the plot inset side will be used.
Background of the entire plot.
Plot title.
Plot subtitle.
Plot caption.
Plot message (e.g. sampling messages). Set an elementBlank() to show nothing. Set an elementText() to show sampling messages (elementText() options don't affect a message text).
Margin around entire plot. Margins around the text. The margin may be specified using a number or a list of numbers:
a number or list of one number - the same margin it applied to all four sides;
a list of two numbers - the first margin applies to the top and bottom, the second - to the left and right;
a list of three numbers - the first margin applies to the top, the second - to the right and left, the third - to the bottom;
a list of four numbers - the margins are applied to the top, right, bottom and left in that order. It is acceptable to use
nullfor any side; in this case, the default side value for the plot margin side will be used.
Inset for a plotting area, including the axes with their labels, but without titles. The inset may be specified using a number or a list of numbers:
a number or list of one number - the same inset it applied to all four sides;
a list of two numbers - the first inset applies to the top and bottom, the second - to the left and right;
a list of three numbers - the first inset applies to the top, the second - to the right and left, the third - to the bottom;
a list of four numbers - the insets are applied to the top, right, bottom and left in that order.
It is acceptable to use None for any side; in this case, the default value for the plot inset side will be used.
Background of facet labels.
Facet labels.
Axes tooltips.
Axes tooltips.
Axes tooltips.
Text in axes tooltips.
Text in axes tooltips.
Text in axes tooltips.
General tooltip.
Text in general tooltip.
Tooltip title text.
Annotation text. Annotations are currently supported for pie and bar charts. Set elementText() to specify annotation text parameters: font family and face, text size, text color (relevant for a pie chart - for those annotations that are outside the pie).
Geometry colors.
Constructors
Properties
Functions
Specifies the anchor point for positioning legend inside plot. Justification (0, 0) corresponds to the left, lower corner of the legend. Justification (1, 1) corresponds to the right, upper corner of the legend.
Specifies the legend position relative to the plot drawing area. Position (0, 0) corresponds to the left, lower corner of the plot. Position (1, 1) corresponds to the right, upper corner of the plot.