Labeled

Labeled[expr,lbl]

displays expr labeled with lbl.

Labeled[expr,lbl,pos]

places lbl at a position specified by pos.

Labeled[expr,{lbl₁,lbl₂,…},{pos₁,…}]

places the lbl_i at positions pos_i.

Labeled[expr,{lbl₁,lbl₂,lbl₃,lbl₄},All]

places the lbl_i at the bottom, left, top, and right, respectively.

Details and Options

Labeled can be used with graphics or any other expression.
Possible forms for the pos_i are:
side centered on the specified side

{side,align} on the specified side with the specified alignment
Possible forms for side include Bottom, Left, Top, Right.
Possible forms for align include Center, Left, Right, Bottom, Top.
In charting functions such as BarChart and PieChart, certain additional special positions such as Above and "RadialCenter" are supported.
Labeled[expr,lbls,All] is equivalent to Labeled[expr,lbls,{Bottom,Left,Top,Right}].
The effective default for pos is normally Bottom.
Labeled[expr,…] does not affect linewrapping of expr.
The following options can be given:

Alignment	{Center,Baseline}	horizontal and vertical alignment of elements
Background	None	what background colors to use
BaselinePosition	Automatic	what to align with a surrounding text baseline
BaseStyle	{}	base style specifications for the labeled expression
ContentSize	Automatic	the absolute size for the content area
Frame	None	whether to draw a frame
FrameMargins	0	margins to leave inside the frame
FrameStyle	Automatic	styles to use for frames
ImageMargins	0	margins to add outside the display area
LabelStyle	{}	style specifications for labels
RotateLabel	False	whether to rotate left and right labels
RoundingRadius	0	radius for rounded corners
Spacings	Automatic	horizontal and vertical label spacings

The settings for BaseStyle and LabelStyle are appended to the default styles typically given by the "Labeled" and "LabeledLabel" styles in the current stylesheet.

Examples

open allclose all

Basic Examples (2)

Create a label:

Label on the left:

Label on the left and top:

Scope (5)

Label a graphic:

Label a slider:

Use a checkbox as a label:

Control the placement of labels:

Put the label at the bottom, aligned left:

Put the label on the right, aligned at the top:

Use graphics as labels:

Options (18)

Alignment (1)

Adjust the alignment of the labeled expression:

Background (1)

Change the overall background color:

BaselinePosition (1)

Align with surrounding text:

ContentSize (1)

Specify the overall size:

Editable (2)

By default, editing of labels and expressions is allowed:

Disallow editing:

Frame (1)

Frame only the expression, not the label:

FrameMargins (2)

Add space within the frame:

FrameMargins also increases the area to which Background applies:

FrameStyle (1)

Change the color of the frame:

ImageMargins (1)

Add margins around the labeled expression:

Specify different margins for each side:

LabelStyle (2)

Style the label:

Use Directive to specify compound styles:

RotateLabel (1)

Rotate vertical labels:

RoundingRadius (1)

Round the corners of the frame:

Spacings (3)

Add horizontal spacing between the expression and the label:

Specify vertical spacing:

Use both vertical and horizontal spacing:

Applications (2)

Label images with checkboxes, potentially for later processing:

Create an active label:

Neat Examples (2)

Top

	side	centered on the specified side
	{side,align}	on the specified side with the specified alignment