block
元素元素元素函数可用set
和show
规则自定义样式。
set
和show
规则自定义样式。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),
)

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.

参数参数参数是传给函数的输入,写在函数名后的括号中。
width
The block's width.
默认值: auto
展开例子
#set align(center)
#block(
width: 60%,
inset: 8pt,
fill: silver,
lorem(10),
)

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

breakable
可用set规则可用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),
)

radius
可用set规则可用set规则可用set
规则设置参数,更改后续调用时的默认值。
set
规则设置参数,更改后续调用时的默认值。How much to round the block's corners. See the rectangle's documentation for more details.
默认值: 0pt
inset
可用set规则可用set规则可用set
规则设置参数,更改后续调用时的默认值。
set
规则设置参数,更改后续调用时的默认值。How much to pad the block's content. See the box's documentation for more details.
默认值: 0pt
outset
可用set规则可用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
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.

above
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
The spacing between this block and its successor. Takes precedence
over spacing
.
默认值: 1.2em
clip
可用set规则可用set规则可用set
规则设置参数,更改后续调用时的默认值。
set
规则设置参数,更改后续调用时的默认值。Whether to clip the content inside the block.
默认值: false