rectElementElement functions can be customized with set and show rules.
set and show rules.A rectangle with optional content.
Example
// Without content.
#rect(width: 35%, height: 30pt)
// With content.
#rect[
Automatically sized \
to fit the content.
]
ParametersParameters are the inputs to a function. They are specified in parentheses after the function name.
widthSettableSettable parameters can be customized for all following uses of the function with a set rule.
set rule.The rectangle's width, relative to its parent container.
Default: auto
heightSettableSettable parameters can be customized for all following uses of the function with a set rule.
set rule.The rectangle's height, relative to its parent container.
Default: 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.
Default: none
#rect(fill: blue)
stroke
How to stroke the rectangle. This can be:
noneto disable strokingautofor a stroke of1pt + blackif and if only if no fill is given.- Any kind of stroke that can also be used for lines.
- 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.
Default: auto
#stack(
dir: ltr,
spacing: 1fr,
rect(stroke: red),
rect(stroke: 2pt),
rect(stroke: 2pt + red),
)
radiusSettableSettable parameters can be customized for all following uses of the function with a set rule.
set rule.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.
Default: 0pt
#set rect(stroke: 4pt)
#rect(
radius: (
left: 5pt,
top-right: 20pt,
bottom-right: 10pt,
),
stroke: (
left: red,
top: yellow,
right: green,
bottom: blue,
),
)
insetSettableSettable parameters can be customized for all following uses of the function with a set rule.
set rule.How much to pad the rectangle's content.
Note: When the rectangle contains text, its exact size depends on the current text edges.
Default: 5pt
#rect(inset: 0pt)[Tight]
outsetSettableSettable parameters can be customized for all following uses of the function with a set rule.
set rule.How much to expand the rectangle's size without affecting the layout. See the box's documentation for more details.
Default: 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.
Default: none