Documentation

circleElement
🌐 Circle Function – Typst DocumentationTypstGitHubDiscordMastodonBlueskyLinkedInTypstQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion mark - typst.app

A circle with optional content.

Example

// Without content.
#circle(radius: 25pt)

// With content.
#circle[
  #set align(center + horizon)
  Automatically \
  sized to fit.
]
Preview

Parameters
🌐 Circle Function – Typst DocumentationTypstGitHubDiscordMastodonBlueskyLinkedInTypstQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion mark - typst.app

radius
length
Settable
🌐 Circle Function – Typst DocumentationTypstGitHubDiscordMastodonBlueskyLinkedInTypstQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion mark - typst.app

The circle's radius. This is mutually exclusive with width and height.

Default: 0pt

width
auto or relative
Settable
🌐 Circle Function – Typst DocumentationTypstGitHubDiscordMastodonBlueskyLinkedInTypstQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion mark - typst.app

The circle's width. This is mutually exclusive with radius and height.

In contrast to radius, this can be relative to the parent container's width.

Default: auto

height
auto or relative or fraction
Settable
🌐 Circle Function – Typst DocumentationTypstGitHubDiscordMastodonBlueskyLinkedInTypstQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion mark - typst.app

The circle's height. This is mutually exclusive with radius and width.

In contrast to radius, this can be relative to the parent container's height.

Default: auto

fill
none or color or gradient or tiling
Settable
🌐 Circle Function – Typst DocumentationTypstGitHubDiscordMastodonBlueskyLinkedInTypstQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion mark - typst.app

How to fill the circle. See the rectangle's documentation for more details.

Default: none

stroke
none or auto or length or color or gradient or stroke or tiling or dictionary
Settable
🌐 Circle Function – Typst DocumentationTypstGitHubDiscordMastodonBlueskyLinkedInTypstQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion mark - typst.app

How to stroke the circle. See the rectangle's documentation for more details.

Default: auto

inset
relative or dictionary
Settable
🌐 Circle Function – Typst DocumentationTypstGitHubDiscordMastodonBlueskyLinkedInTypstQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion mark - typst.app

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

Default: 0% + 5pt

outset
relative or dictionary
Settable
🌐 Circle Function – Typst DocumentationTypstGitHubDiscordMastodonBlueskyLinkedInTypstQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion mark - typst.app

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

Default: (:)

body
none or content
Positional
🌐 Circle Function – Typst DocumentationTypstGitHubDiscordMastodonBlueskyLinkedInTypstQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion mark - typst.app
Settable
🌐 Circle Function – Typst DocumentationTypstGitHubDiscordMastodonBlueskyLinkedInTypstQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion markQuestion mark - typst.app

The content to place into the circle. The circle expands to fit this content, keeping the 1-1 aspect ratio.

Default: none