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

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

A rectangle with optional content.

Example

// Without content.
#rect(width: 35%, height: 30pt)

// With content.
#rect[
  Automatically sized \
  to fit the content.
]
Preview

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

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

The rectangle's width, relative to its parent container.

默认:auto

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

The rectangle's height, relative to its parent container.

默认:auto

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

How to fill the rectangle.

When setting a fill, the default stroke disappears. To create a rectangle with both fill and stroke, you have to configure both.

默认:none

查看示例
#rect(fill: blue)
Preview

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

How to stroke the rectangle. This can be:

默认:auto

查看示例
#stack(
  dir: ltr,
  spacing: 1fr,
  rect(stroke: red),
  rect(stroke: 2pt),
  rect(stroke: 2pt + red),
)
Preview

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

How much to round the rectangle's corners, relative to the minimum of the width and height divided by two. This can be:

默认:0pt

查看示例
#set rect(stroke: 4pt)
#rect(
  radius: (
    left: 5pt,
    top-right: 20pt,
    bottom-right: 10pt,
  ),
  stroke: (
    left: red,
    top: yellow,
    right: green,
    bottom: blue,
  ),
)
Preview

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

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

默认:5pt

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

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

默认:0pt

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

The content to place into the rectangle.

When this is omitted, the rectangle takes on a default size of at most 45pt by 30pt.

默认:none