提示:本教程存在过时问题,更详细教程请阅读 小蓝书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 中文文档

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

An inline-level container that sizes content.

All elements except inline math, text, and boxes are block-level and cannot occur inside of a paragraph. The box function can be used to integrate such elements into a paragraph. Boxes take the size of their contents by default but can also be sized explicitly.

Example

Refer to the docs
#box(
  height: 9pt,
  image("docs.svg")
)
for more information.
Preview

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

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

The width of the box.

Boxes can have fractional widths, as the example below demonstrates.

Note: Currently, only boxes and only their widths might be fractionally sized within paragraphs. Support for fractionally sized images, shapes, and more might be added in the future.

默认:auto

查看示例
Line in #box(width: 1fr, line(length: 100%)) between.
Preview

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

The height of the box.

默认:auto

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

An amount to shift the box's baseline by.

默认:0pt

查看示例
Image: #box(baseline: 40%, image("tiger.jpg", width: 2cm)).
Preview

fill
none color gradient pattern
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

The box's background color. See the rectangle's documentation for more details.

默认:none

stroke
none length color gradient stroke pattern dictionary
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

The box's border color. See the rectangle's documentation for more details.

默认:none

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

How much to round the box's corners. See the rectangle's documentation for more details.

默认:0pt

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

How much to pad the box's content.

Note: When the box contains text, its exact size depends on the current text edges.

默认:0pt

查看示例
#rect(inset: 0pt)[Tight]
Preview

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

How much to expand the box's size without affecting the layout.

This is useful to prevent padding from affecting line layout. For a generalized version of the example below, see the documentation for the raw text's block parameter.

默认:0pt

查看示例
An inline
#box(
  fill: luma(235),
  inset: (x: 3pt, y: 0pt),
  outset: (y: 3pt),
  radius: 2pt,
)[rectangle].
Preview

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

Whether to clip the content inside the box.

默认:false

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

The contents of the box.

默认:none