({{, (RefLink[CellFrameLabels, paclet:ref/CellFrameLabels])
is an option that specifies the labels associated with the frame around a cell.}})

OpenersNotesSection(Spacer1)Details

(RefLink[CellFrameLabels, paclet:ref/CellFrameLabels])->{{left,right},{bottom,top}} specifies the labels to the left, right, bottom, and top of the cell frame, respectively. If (RefLink[None, paclet:ref/None]) is given for a value, then no label will be shown.

Cell frame labels can be specified as strings or raw cell expressions.

(RefLink[CellFrameLabels, paclet:ref/CellFrameLabels])->(RefLink[None, paclet:ref/None]) is equivalent to giving a value of {{(RefLink[None, paclet:ref/None]),(RefLink[None, paclet:ref/None])},{(RefLink[None, paclet:ref/None]),(RefLink[None, paclet:ref/None])}}.

A cell frame label will display even if there is no cell frame. If the cell has no frame but a specified background color, the labels will appear outside of the cell's background rectangle.

The margin between the label and the cell's frame or background color is determined by (RefLink[CellFrameLabelMargins, paclet:ref/CellFrameLabelMargins]).

Cell frame labels are displayed using a style inherited from their parent cell.

OpenersPrimaryExamplesSection(Spacer1)Examples  (7)

OpenersExampleSection0(Spacer1)Basic Examples  (2)

Display cell frame labels:

CellPrint[TextCell[StringJoin[Table["abcd ",{20}]],"Text",CellFrame->True,CellMargins->{{200,200},{10,10}},CellFrameLabels->{{"left","right"},{"bottom","top"}}]]

abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd

Specify a label as a (RefLink[Cell, paclet:ref/Cell]) expression:

CellPrint[TextCell[StringJoin[Table["abcd ",{20}]],"Text",CellFrame->True,CellMargins->{{200,200},{10,10}},CellFrameLabels->{{Cell["123","Input",Brown],None},{None,None}}]]

abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd

OpenersExampleSection1(Spacer1)Scope  (3)

Display a cell frame label without a cell frame:

CellPrint[TextCell[StringJoin[Table["abcd ",{20}]],"Text",CellMargins->{{200,200},{10,10}},CellFrameLabels->{{"left","right"},{"bottom","top"}}]]

abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd

Cell frame labels use the same cell style as their parent cell:

CellPrint[TextCell[StringJoin[Table["abcd ",{20}]],"Text",CellMargins->{{200,200},{10,10}},FontColor->#,CellFrameLabels->{{"left","right"},{"bottom","top"}}]]& /@ {Red,Blue};

abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd

abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd

Display cell frame labels for a cell with a background color and no frame:

CellPrint[TextCell[StringJoin[Table["abcd ",{20}]],"Text",CellMargins->{{200,200},{10,10}},Background->LightGreen,CellFrameLabels->{{"left","right"},{"bottom","top"}}]]

abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd

OpenersExampleSection2(Spacer1)Generalizations & Extensions  (1)

To use a (RefLink[TextCell, paclet:ref/TextCell]) or (RefLink[ExpressionCell, paclet:ref/ExpressionCell]) expression, apply (RefLink[ToBoxes, paclet:ref/ToBoxes]):

CellPrint[TextCell[StringJoin[Table["abcd ",{20}]],"Text",CellFrame->True,CellFrameLabels->{{ToBoxes[ExpressionCell[Graphics[Disk[],ImageSize->20]]],None},{None,None}}]]

abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd

OpenersExampleSection4(Spacer1)Properties & Relations  (1)

Cell frame labels display within cell margins:

CellPrint[TextCell[StringJoin[Table["abcd ",{20}]],"Text",CellMargins->{{200,200},{10,10}},CellFrameLabels->{{"left","right"},{None,None}}]]

abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd

A bigger cell label forces the cell contents into a smaller area:

CellPrint[TextCell[StringJoin[Table["abcd ",{20}]],"Text",CellMargins->{{200,200},{10,10}},CellFrameLabels->{{"leftleftleft","rightrightright"},{None,None}}]]

abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd

Similarly, a larger (RefLink[CellFrameLabelMargins, paclet:ref/CellFrameLabelMargins]) compresses the cell contents area:

CellPrint[TextCell[StringJoin[Table["abcd ",{20}]],"Text",CellMargins->{{200,200},{10,10}},CellFrameLabels->{{"left","right"},{None,None}},CellFrameLabelMargins->50]]

abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd abcd

({{DocumentationFooterIconsRelatedFunction.png, ({{See Also}, {(RefLink[CellFrame, paclet:ref/CellFrame])  ▪  (RefLink[CellFrameMargins, paclet:ref/CellFrameMargins])  ▪  (RefLink[CellFrameLabelMargins, paclet:ref/CellFrameLabelMargins])}})}})

({{DocumentationFooterIconsRelatedGuide.png, ({{Related Guides}, {▪(RefLinkPlain[Stylesheets, paclet:guide/Stylesheets])}, {▪(RefLinkPlain[Cell Styling Options, paclet:guide/CellStylingOptions])}})}})