place
Element
Element functions can be customized with set
and show
rules.
set
and show
rules.Places content at an absolute position.
Placed content will not affect the position of other content. Place is always relative to its parent container and will be in the foreground of all other content in the container. Page margins will be respected.
Example
#set page(height: 60pt)
Hello, world!
#place(
top + right,
square(
width: 20pt,
stroke: 2pt + blue
),
)
Parameters
Parameters are the inputs to a function. They are specified in parentheses after the function name.
alignment
Relative to which position in the parent container to place the content.
- If
float
isfalse
, then this can be any alignment other thanauto
. - If
float
istrue
, then this must beauto
,top
, orbottom
.
When an axis of the page is auto
sized, all alignments relative to
that axis will be ignored, instead, the item will be placed in the
origin of the axis.
Default:start
float
Settable
Settable parameters can be customized for all following uses of the function with a set
rule.
set
rule.Whether the placed element has floating layout.
Floating elements are positioned at the top or bottom of the page, displacing in-flow content.
Default:false
View example
#set page(height: 150pt)
#let note(where, body) = place(
center + where,
float: true,
clearance: 6pt,
rect(body),
)
#lorem(10)
#note(bottom)[Bottom 1]
#note(bottom)[Bottom 2]
#lorem(40)
#note(top)[Top]
#lorem(10)
clearance
Settable
Settable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The amount of clearance the placed element has in a floating layout.
Default:1.5em
dx
Settable
Settable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The horizontal displacement of the placed content.
Default:0pt
View example
#set page(height: 100pt)
#for i in range(16) {
let amount = i * 4pt
place(center, dx: amount - 32pt, dy: amount)[A]
}
This does not affect the layout of in-flow content.
In other words, the placed content is treated as if it
were wrapped in a move
element.
dy
Settable
Settable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The vertical displacement of the placed content.
This does not affect the layout of in-flow content.
In other words, the placed content is treated as if it
were wrapped in a move
element.
Default:0pt
body
The content to place.