text

textNode

Freestanding text at (x, y) — a mark that is nothing but its label. It carries annotations belonging to the plot rather than to any one mark: a region's name, a caption inside the frame, a worked value.

Writing with it:Framing a readable graph

#Attributes

On any plane

labelRequiredImplicit
rich-text
The text itself — rich, so $maths$ and inline formatting render.Can be written as shorthand: text:value
sizeAnimatable
number
Text size.
Default20
colourAnimatable
neutralredorangeyellowgreentealbluepurplepinkgreywhiteblack
Also written: colorColour.
Defaultneutral
anchor
string
How the text sits on its point: middle centres it, start and end put its left or right edge there.
Defaultmiddle
hiddenAnimatable
boolean
Declared but not drawn. Animatable — hidden: true !cue.to{false}(at: 2) reveals it — and a hidden element still frames the plot, so the axes do not jump when it appears.
Defaultfalse
lock
boolean
Also written: lockedKeeps the reader from editing this element on an editable: graph.
Defaultfalse
layerAnimatable
parametised-number
Paint order among the marks: a higher layer is drawn later, on top; equal or omitted, the marks stack in document order (later on top). Written z: before the argand plane took that letter for its coordinate.
Only withxplane
xAnimatable
parametised-number
X coordinate of the anchor.
Only withxyplane
xAnimatable
parametised-number
X coordinate of the anchor.
yAnimatable
parametised-number
Y coordinate of the anchor.
Only withargandplane
zAnimatable
complex-expression
On the argand plane, the position as one complex number — a complex expression: 3 + 2i, (3 + 2i)^2, sqrt(13) * e^(i * a), with i the unit and parameters read as complex. Instead of re/im.
reAnimatable
parametised-number
On the argand plane, the real part of the position, a number; with im. z: gives both at once.
imAnimatable
parametised-number
On the argand plane, the imaginary part of the position, a number; with re. z: gives both at once.
Only withpolarplane
rAnimatable
parametised-number
On the polar plane, the distance from the origin; with theta.
thetaAnimatable
parametised-number
On the polar plane, the angle anticlockwise from the right, in radians — 60deg writes it in degrees; with r. On a categorical theta (theta format:), a name.

#Allowed in

canvas.graph { }cue { }cue.draw { }cue.trace { }cue.highlight { }cue.spotlight { }

#Examples

text(label: local maximum; x: 2; y: 4.5)
text(label: $R^2 = 0.97$; x: 8; y: 1; anchor: start)