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
The rectangle's width, relative to its parent container.
默认:auto
height
The rectangle's height, relative to its parent container.
默认:auto
fill
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)
stroke
How to stroke the rectangle. This can be:
none
to disable strokingauto
for a stroke of1pt + 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),
)
radius
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,
),
)
inset
How much to pad the rectangle's content. See the box's documentation for more details.
默认:5pt
outset
How much to expand the rectangle's size without affecting the layout. See the box's documentation for more details.
默认:0pt
body
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