类型
为了给文档设置样式,你需要使用不同类型的值:长度用于指定元素的大小,颜色用于文本和形状等。 Typst 将这些值划分为明确定义的类型,并告诉你在哪里期望这种类型的值。
除了用于数字值的非常基本的类型和编程语言中常见的类型之外,Typst 还提供了一种特殊的类型用于 内容 。 该类型的值可以包含你可以输入到文档中的任何内容:文本、标题和形状等元素以及样式信息。
在 Typst 的某些地方,会使用专门的数据类型。在此仅列出部分类型,其他类型会在相关地方进行解释。
Types
none
一个表示没有值的空值。auto
一个表示智能默认值的值。boolean
可以是 `{true}` 或 `{false}`。integer
一个整数。float
一个浮点数。length
一个尺寸或距离,可能使用上下文单位表示。angle
描述旋转的角度。ratio
一个整数的比率。relative length
一个相对于某个已知长度的长度。fraction
定义布局中剩余空间的分配方式。color
一个特定颜色空间中的颜色。datetime
日期、时间或两者的组合的表示。可以通过使用 [`datetime`]($func/datetime) 函数来指定自定义日期时间,symbol
Unicode 符号。string
一串 Unicode 代码点(codepoints)。content
一段文件内容。array
一个值的序列。dictionary
这是一个从字符串键到值的映射。function
参数值到返回值的映射。arguments
在函数中捕获参数。selector
一个用于选择文档中元素的过滤器。module
一个评估模块,可以是内置模块,也可以是来自文件的结果。