% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/labels.R
\name{labs}
\alias{labs}
\title{Set plot and axis labels}
\usage{
labs(
  title = NULL,
  subtitle = NULL,
  caption = NULL,
  tag = NULL,
  x = NULL,
  y = NULL,
  color = NULL,
  size = NULL,
  fill = NULL
)
}
\arguments{
\item{title}{Plot title, drawn above the panel.}

\item{subtitle}{Subtitle, drawn under the title in a lighter style.}

\item{caption}{Caption, drawn bottom-right (source notes, methods).}

\item{tag}{Panel tag (e.g. \code{"A"}), drawn top-left — for multi-panel
figures in publications.}

\item{x, y}{Axis titles; override the deparsed \code{aes()} expression.}

\item{color, size, fill}{Legend titles for the matching aesthetic.}
}
\value{
A \link{Labels} object to add to a plot with \code{+}.
}
\description{
Every argument is optional; only the ones you supply are changed, so
\code{labs()} can be added repeatedly to build up a title block.
}
\examples{
ggnext(cars, aes(speed, dist)) +
  geom_point() +
  labs(
    title = "Stopping distance rises with speed",
    subtitle = "1920s road tests, 50 observations",
    x = "Speed (mph)",
    y = "Stopping distance (ft)",
    caption = "Source: datasets::cars"
  )
}
