text

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.

textNode
A downward parabola with the words local maximum written above its peak.A downward parabola with the words local maximum written above its peak.
Writing with it:
Framing a readable graph

#Attributes

On any plane
labelRequiredImplicit
The text itself — rich, so $maths$ and inline formatting render.
rich-text
Can be written as shorthand: text:value
sizeAnimatable
Text size.
number
Default20
colourAnimatable
Colour.
bluelight-bluedark-blueredlight-reddark-redorangelight-orangedark-orangeyellowlight-yellowdark-yellowteallight-tealdark-tealgreenlight-greendark-greenpinklight-pinkdark-pinkpurplelight-purpledark-purplegreylight-greydark-greyneutralhex(…)rgb(…)
Also written: color
Defaultneutral
anchor
How the text sits on its point: middle centres it, start and end put its left or right edge there.
string
Defaultmiddle
hiddenAnimatable
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.
boolean
Defaultfalse
lock
Keeps the reader from editing this element on an editable: graph.
boolean
Also written: locked
Defaultfalse
layerAnimatable
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.
parametised-number
Only withxplane
xAnimatable
X coordinate of the anchor.
axis-value
Only withxyplane
xAnimatable
X coordinate of the anchor.
axis-value
yAnimatable
Y coordinate of the anchor.
axis-value
Only withargandplane
zAnimatable
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.
complex-expression
reAnimatable
On the argand plane, the real part of the position, a number; with im. z: gives both at once.
axis-value
imAnimatable
On the argand plane, the imaginary part of the position, a number; with re. z: gives both at once.
axis-value
Only withpolarplane
rAnimatable
On the polar plane, the distance from the origin; with theta.
axis-value
thetaAnimatable
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.
axis-value

#Allowed in

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

#Examples

A downward parabola with the words local maximum written above its peak.A downward parabola with the words local maximum written above its peak.
canvas.graph{
    curve(expression: 4 - (x - 2)^2)
    text(label: local maximum; x: 2; y: 4.5)
}(
    x-domain: [0, 4]
    y-domain: [0, 5]
)
Ten readings with a fitted line, and R² = 0.97 written to the right of the last of them, starting at its anchor.Ten readings with a fitted line, and R² = 0.97 written to the right of the last of them, starting at its anchor.
canvas.graph{
    scatter#readings(x: 1, 2, 3, 4, 5, 6, 7; y: 1.1, 1.9, 3.2, 3.8, 5.1, 6.2, 6.8; colour: grey)
    fit(of: #readings; degree: 1)
    text(label: $R^2 = 0.97$; x: 8; y: 1; anchor: start)
}(
    x-domain: [0, 11]
)

Last updated