• 
• 
• 参考手册
• 
• 可视化 [⚠️ need proofread]
• 
• Rectangle

转到官方文档（英文）

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.
]

参数

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

width

auto or relative

可用set规则

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

默认值：auto

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

height

auto or relative or fraction

可用set规则

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

默认值：auto

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

fill

none or color or gradient or tiling

可用set规则

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

默认值：none

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.

展开示例

#rect(fill: blue)

stroke

none or auto or length or color or gradient or stroke or tiling or dictionary

可用set规则

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

默认值：auto

How to stroke the rectangle. This can be:

• none to disable stroking

• auto for a stroke of 1pt + black if and only if no fill is given.

• Any kind of stroke

• A dictionary describing the stroke for each side individually. 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 left and right stroke.
  • y: The top and bottom stroke.
  • rest: The stroke on all sides except those for which the dictionary explicitly sets a size.

  All keys are optional; omitted keys will use their previously set value, or the default stroke if never set.

展开示例

#stack(
  dir: ltr,
  spacing: 1fr,
  rect(stroke: red),
  rect(stroke: 2pt),
  rect(stroke: 2pt + red),
)

radius

relative or 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:

• 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.

展开示例

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

inset

relative or dictionary

可用set规则

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

默认值：0% + 5pt

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

outset

relative or dictionary

可用set规则

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

默认值：(:)

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

body

none or content

位置参数

位置参数按顺序传入，不带参数名。

可用set规则

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

默认值：none

The content to place into the rectangle.

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

转到官方文档（英文）

Polygon上一页

Square下一页