注意 / 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+后期随缘更新

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

A rectangle with optional content.

Example

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

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

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

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

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

默认值:

auto

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

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

默认值:

auto

fill
可用set规则
可用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
可用set规则
可用set规则
可用set规则设置参数,更改后续调用时的默认值。

How to stroke the rectangle. This can be:

  • none to disable stroking
  • auto for a stroke of 1pt + black if and if only if no fill is given.
  • Any kind of stroke
  • A dictionary describing the stroke for each side inidvidually. The dictionary can contain the following keys in order of precedence:
    • top: The top stroke.
    • right: The right stroke.
    • bottom: The bottom stroke.
    • left: The left stroke.
    • x: The horizontal stroke.
    • y: The vertical stroke.
    • rest: The stroke on all sides except those for which the dictionary explicitly sets a size.

默认值:

auto

展开例子
#stack(
  dir: ltr,
  spacing: 1fr,
  rect(stroke: red),
  rect(stroke: 2pt),
  rect(stroke: 2pt + red),
)
Preview

radius
可用set规则
可用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:

  • A relative length for a uniform corner radius.
  • A dictionary: With a dictionary, the stroke for each side can be set individually. The dictionary can contain the following keys in order of precedence:
    • top-left: The top-left corner radius.
    • top-right: The top-right corner radius.
    • bottom-right: The bottom-right corner radius.
    • bottom-left: The bottom-left corner radius.
    • left: The top-left and bottom-left corner radii.
    • top: The top-left and top-right corner radii.
    • right: The top-right and bottom-right corner radii.
    • bottom: The bottom-left and bottom-right corner radii.
    • rest: The radii for all corners except those for which the dictionary explicitly sets a size.

默认值:

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
可用set规则
可用set规则
可用set规则设置参数,更改后续调用时的默认值。

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

默认值:

5pt

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

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

默认值:

0pt

body
位置参数
位置参数
位置参数按顺序传入,不带参数名。
可用set规则
可用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

转到官方文档(英文)

搜索