Documentation

locateContextual
Question mark

Determines the location of an element in the document.

Takes a selector that must match exactly one element and returns that element's location. This location can, in particular, be used to retrieve the physical page number and position (page, x, y) for that element.

Examples

Locating a specific element:

#context [
  Introduction is at: \
  #locate(<intro>).position()
]

= Introduction <intro>
Preview

Compatibility

In Typst 0.10 and lower, the locate function took a closure that made the current location in the document available (like here does now). Compatibility with the old way will remain for a while to give package authors time to upgrade. To that effect, locate detects whether it received a selector or a user-defined function and adjusts its semantics accordingly. This behaviour will be removed in the future.

Parameters
Question mark

selector
label or selector or location or function
RequiredPositional
Question mark

A selector that should match exactly one element. This element will be located.

Especially useful in combination with