提示:本教程存在过时问题,更详细教程请阅读 小蓝书Typst 中文社区导航 FAQ
注意:该中文文档为社区驱动的非官网文档,可能存在错译、漏译或过时等问题,请以官网文档 Documentation 为准,如发现错漏,也欢迎 您的贡献镜像)。Typst 非官方中文交流 QQ 群:793548390
Warning: the Chinese document is a community-driven non-official document, there may be mistranslation, omission or outdated problems, please refer to the official website documentation.
Typst 中文文档

circle 元素
元素函数可以通过 set 和 show 规则进行样式自定义。

A circle with optional content.

Example

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

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

参数
参数是函数的输入,它们在函数名称后面的括号中传入。

radius
length
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

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

默认:0pt

width
auto relative
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

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.

默认:auto

height
auto relative
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

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.

默认:auto

fill
none color gradient pattern
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

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

默认:none

stroke
none auto length color gradient stroke pattern dictionary
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

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

默认:auto

inset
relative dictionary
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

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

默认:5pt

outset
relative dictionary
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

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

默认:0pt

body
none content
位置参数
位置参数按顺序传入,不带名称。
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

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

默认:none