注意:该页面为保留旧有翻译而留下的,新文档并没有该页面,请注意甄别。新的文档可以在 “基础” 部分找到,不过暂未未完全翻译完毕。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 中文文档

content

一段文件内容。

这种类型是 Typst 的核心。你写的所有标记和你调用的大多数函数都产生内容值。 你可以通过在方括号中包围标记来创建一个内容值。 这也是你向函数传递内容的方式。

Type of *Hello!* is
#type([*Hello!*])
Preview

内容可以用 + 运算符添加,连接在一起,并与整数相乘。 凡是期望有内容的地方,你也可以传递一个字符串none

Representation

内容由带有字段的元素组成。 当用元素函数构造一个元素时,你提供这些字段作为参数,当你有一个内容值时,你可以用字段访问语法访问其字段。

有些字段是必须的:这些字段必须在构造元素时提供, 因此,它们总是可以通过对该类型内容的字段访问而获得。必需的字段在文档中被标明。

大多数字段是可选的:像必填字段一样,它们可以被传递给元素函数来为单个元素配置它们。 然而,这些也可以用设定的规则来配置,将它们应用于一个范围内的所有元素。 可选字段只有在它们被明确地传递给元素函数时才能使用字段访问语法,而不是由设置规则产生。

每个元素都有一个默认的外观。然而,你也可以用一个显示规则来完全定制它的外观。 显示规则被传递给元素。它可以访问元素的字段并从中产生任意的内容。

在 Web 应用程序中,你可以将鼠标悬停在一个内容变量上,准确地看到内容是由哪些元素组成的,它们有哪些字段。 或者,你可以检查 repr 函数的输出。

方法
方法是可用于该类型的一系列函数,可以使用 "." 操作符调用它们。

func method

内容的元素函数。这个函数可以用来创建这个内容中包含的元素。 它可以用于元素的设置和显示规则。 可以与全局函数相比较,以检查你是否有一个特定种类的元素。

value.func(
) -> function

has method

该内容是否有指定的字段。

value.has() -> boolean

field
string
必需参数位置参数
位置参数按顺序传入,不带名称。

搜索的字段。

at method

访问内容上的指定字段。如果字段不存在,则返回默认值;如果没有指定默认值,则返回错误。

value.at() -> any

field
string
必需参数位置参数
位置参数按顺序传入,不带名称。

要访问的字段。

default
any

如果字段不存在,要返回的默认值。

fields method

返回该内容的所有字段。

#rect(
  width: 10cm,
  height: 10cm,
).fields()
Preview
value.fields(
) ->

location method

内容的位置。这只适用于通过查询返回的内容,对于其他内容,它将以错误方式失败。 得到的位置可以用于计数器状态查询

value.location(
) -> location