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

selector

一个用于选择文档中元素的过滤器。

你可以按以下方式构建过滤器:

选择器用于对元素应用样式规则。 你还可以使用选择器查询文档中特定类型的元素。

此外,您可以将选择器传递给 Typst 的几个内置函数,以配置它们的行为。 其中一个示例是大纲 outline,它可以用于更改大纲中列出的元素。

可以使用下面展示的方法组合多个选择器。但是,目前并不是所有类型的选择器在所有位置都受支持。

Example

#locate(loc => query(
  heading.where(level: 1)
    .or(heading.where(level: 2)),
  loc,
))

= This will be found
== So will this
=== But this will not.
Preview

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

or method

允许组合一系列选择器中的任意个。这用于同时选择多个组件或具有不同属性的组件。

value.or() ->

other
selector
必需参数可变参数
可变参数可以多次传入。

要进行匹配的选择器列表。

and method

允许组合一系列选择器中的所有选择器。这用于同时检查组件是否满足多个选择规则。

value.and() ->

other
selector
必需参数可变参数
可变参数可以多次传入。

要进行匹配的选择器列表。

before method

返回一个修改后的选择器,该选择器仅匹配在选择器参数的第一个匹配之前出现的元素。

value.before() ->

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

原始选择将在第一个 end 选择器匹配的位置结束。

inclusive

确定 end 本身是否应匹配。这仅在两个选择器都匹配相同类型的元素时才相关。默认为 true

after method

返回一个修改后的选择器,该选择器仅匹配在选择器参数的第一个匹配之后出现的元素。

value.after() ->

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

原始选择将从 start 选择器的第一个匹配开始。

inclusive

确定 start 本身是否应匹配。这仅在两个选择器都匹配相同类型的元素时才相关。默认为 true