• 
• 
• Reference
• 
• Visualize
• 
• Rectangle

rectElement

Element functions can be customized with 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.
]

Parameters

Parameters are the inputs to a function. They are specified in parentheses after the function name.

width

auto or relative

Settable

Settable parameters can be customized for all following uses of the function with a set rule.

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

Default: auto

height

auto or relative or fraction

Settable

Settable parameters can be customized for all following uses of the function with a set rule.

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

Default: auto

fill

none or color or gradient or pattern

Settable

Settable parameters can be customized for all following uses of the function with a set rule.

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

View example

#rect(fill: blue)

stroke

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

Settable

Settable parameters can be customized for all following uses of the function with a set rule.

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 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 horizontal stroke.
  • y: The vertical stroke.
  • rest: The stroke on all sides except those for which the dictionary explicitly sets a size.

Default: auto

View example

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

radius

relative or dictionary

Settable

Settable parameters can be customized for all following uses of the function with a 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: (:)

View example

#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

Settable

Settable parameters can be customized for all following uses of the function with a set rule.

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

Default: 0% + 5pt

outset

relative or dictionary

Settable

Settable parameters can be customized for all following uses of the function with a set rule.

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

Default: (:)

body

none or content

Positional

Positional parameters are specified in order, without names.

Settable

Settable parameters can be customized for all following uses of the function with a set rule.

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

PolygonPrevious page

SquareNext page