selector
一个用于选择文档中元素的过滤器。
你可以按以下方式构建过滤器:
- 你可以使用元素函数
- 你可以过滤具有特定字段的元素函数
- 你可以使用字符串或正则表达式
- 你可以使用
<label>
- 您可以使用位置
location
- 调用选择器函数以将上述任何类型转换为选择器值,并使用以下方法进行进一步的细化
选择器用于对元素应用样式规则。 你还可以使用选择器查询文档中特定类型的元素。
此外,您可以将选择器传递给 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.
方法
方法是可用于该类型的一系列函数,可以使用 .
操作符调用它们。
方法是可用于该类型的一系列函数,可以使用
.
操作符调用它们。or
method
允许组合一系列选择器中的任意个。这用于同时选择多个组件或具有不同属性的组件。
other
要进行匹配的选择器列表。
and
method
允许组合一系列选择器中的所有选择器。这用于同时检查组件是否满足多个选择规则。
other
要进行匹配的选择器列表。
before
method
返回一个修改后的选择器,该选择器仅匹配在选择器参数的第一个匹配之前出现的元素。
value.before() ->
end
原始选择将在第一个 end
选择器匹配的位置结束。
inclusive
确定 end
本身是否应匹配。这仅在两个选择器都匹配相同类型的元素时才相关。默认为 true
。
after
method
返回一个修改后的选择器,该选择器仅匹配在选择器参数的第一个匹配之后出现的元素。
value.after() ->
start
原始选择将从 start
选择器的第一个匹配开始。
inclusive
确定 start
本身是否应匹配。这仅在两个选择器都匹配相同类型的元素时才相关。默认为 true
。