注意 / Info
本站经 Typst GmbH 许可,提供 Typst v0.10.0+后期随缘更新 官方文档的翻译,由中文社区维护。建议与官方文档一同阅读,因为可能存在错译、漏译或过时信息。如有意改进翻译内容或网站本身,可在GitHub上提出 Issue、发起 Pull Requests。此外,也欢迎加入「Typst 非官方中文交流群」(QQ 793548390)
This site provides a Chinese translation of the Typst v0.10.0+后期随缘更新 documentation maintained by the “Typst Chinese Community” with permission from Typst GmbH. We recommend using this alongside the official documentation. We welcome contributions through Issues and Pull Requests on our GitHub repository for both translation improvements and website enhancements. Feel free to join our QQ chat group “Typst 非官方中文交流群” (793548390).
Typst文档简体中文版
v0.10.0+后期随缘更新

block
元素
元素
元素函数可用setshow规则自定义样式。

A block-level container.

Such a container can be used to separate content, size it, and give it a background or border.

Examples

With a block, you can give a background to content while still allowing it to break across multiple pages.

#set page(height: 100pt)
#block(
  fill: luma(230),
  inset: 8pt,
  radius: 4pt,
  lorem(30),
)
Preview

Blocks are also useful to force elements that would otherwise be inline to become block-level, especially when writing show rules.

#show heading: it => it.body
= Blockless
More text.

#show heading: it => block(it.body)
= Blocky
More text.
Preview

参数
参数
参数是传给函数的输入,写在函数名后的括号中。

width
可用set规则
可用set规则
可用set规则设置参数,更改后续调用时的默认值。

The block's width.

默认值:

auto

展开例子
#set align(center)
#block(
  width: 60%,
  inset: 8pt,
  fill: silver,
  lorem(10),
)
Preview

height
可用set规则
可用set规则
可用set规则设置参数,更改后续调用时的默认值。

The block's height. When the height is larger than the remaining space on a page and breakable is true, the block will continue on the next page with the remaining height.

默认值:

auto

展开例子
#set page(height: 80pt)
#set align(center)
#block(
  width: 80%,
  height: 150%,
  fill: aqua,
)
Preview

breakable
可用set规则
可用set规则
可用set规则设置参数,更改后续调用时的默认值。

Whether the block can be broken and continue on the next page.

默认值:

true

展开例子
#set page(height: 80pt)
The following block will
jump to its own page.
#block(
  breakable: false,
  lorem(15),
)
Preview

fill
可用set规则
可用set规则
可用set规则设置参数,更改后续调用时的默认值。

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

默认值:

none

stroke
可用set规则
可用set规则
可用set规则设置参数,更改后续调用时的默认值。

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

默认值:

none

radius
可用set规则
可用set规则
可用set规则设置参数,更改后续调用时的默认值。

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

默认值:

0pt

inset
可用set规则
可用set规则
可用set规则设置参数,更改后续调用时的默认值。

How much to pad the block's content. See the box's documentation for more details.

默认值:

0pt

outset
可用set规则
可用set规则
可用set规则设置参数,更改后续调用时的默认值。

How much to expand the block's size without affecting the layout. See the box's documentation for more details.

默认值:

0pt

spacing
可用set规则
可用set规则
可用set规则设置参数,更改后续调用时的默认值。

The spacing around this block. This is shorthand to set above and below to the same value.

默认值:

1.2em

展开例子
#set align(center)
#show math.equation: set block(above: 8pt, below: 16pt)

This sum of $x$ and $y$:
$ x + y = z $
A second paragraph.
Preview

above
可用set规则
可用set规则
可用set规则设置参数,更改后续调用时的默认值。

The spacing between this block and its predecessor. Takes precedence over spacing. Can be used in combination with a show rule to adjust the spacing around arbitrary block-level elements.

默认值:

1.2em

below
可用set规则
可用set规则
可用set规则设置参数,更改后续调用时的默认值。

The spacing between this block and its successor. Takes precedence over spacing.

默认值:

1.2em

clip
可用set规则
可用set规则
可用set规则设置参数,更改后续调用时的默认值。

Whether to clip the content inside the block.

默认值:

false

body
位置参数
位置参数
位置参数按顺序传入,不带参数名。
可用set规则
可用set规则
可用set规则设置参数,更改后续调用时的默认值。

The contents of the block.

默认值:

none

转到官方文档(英文)

搜索