提示:本教程存在过时问题,更详细教程请阅读 小蓝书Typst 中文社区导航 FAQ
注意:该中文文档为社区驱动的非官网文档,可能存在错译、漏译或过时等问题,请以官网文档 Documentation 为准,如发现错漏,也欢迎 您的贡献镜像)。Typst 非官方中文交流 QQ 群:793548390
Warning: the Chinese document is a community-driven non-official document, there may be mistranslation, omission or outdated problems, please refer to the official website documentation.
Typst 中文文档

place 元素
元素函数可以通过 set 和 show 规则进行样式自定义。

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
  ),
)
Preview

参数
参数是函数的输入,它们在函数名称后面的括号中传入。

alignment
auto alignment
位置参数
位置参数按顺序传入,不带名称。
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

Relative to which position in the parent container to place the content.

Cannot be auto if float is false and must be either auto, top, or bottom if float is true.

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.

默认:start

float
bool
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

Whether the placed element has floating layout.

Floating elements are positioned at the top or bottom of the page, displacing in-flow content.

默认:false

查看示例
#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)
Preview

clearance
length
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

The amount of clearance the placed element has in a floating layout.

默认:1.5em

dx
relative
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

The horizontal displacement of the placed content.

默认:0pt

查看示例
#set page(height: 100pt)
#for i in range(16) {
  let amount = i * 4pt
  place(center, dx: amount - 32pt, dy: amount)[A]
}
Preview

dy
relative
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

The vertical displacement of the placed content.

默认:0pt

body
content
必需参数位置参数
位置参数按顺序传入,不带名称。

The content to place.