{"route":"/en-US-v0.14.1/reference/introspection/locate/","title":"Locate","description":"Documentation for the `locate` function.","part":null,"outline":[{"id":"summary","name":"Summary","children":[]},{"id":"examples","name":"Examples","children":[]},{"id":"parameters","name":"Parameters","children":[{"id":"parameters-selector","name":"selector","children":[]}]}],"body":{"kind":"func","content":{"path":[],"name":"locate","title":"Locate","keywords":[],"oneliner":"Determines the location of an element in the document.","element":false,"contextual":true,"deprecationMessage":null,"deprecationUntil":null,"details":[{"kind":"html","content":"

Determines the location of an element in the document.

\n

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

\n

Examples

\n

Locating a specific element:

\n
#context [\n  Introduction is at: \\\n  #locate(<intro>).position()\n]\n\n= Introduction <intro>\n
\"Preview\"
"}],"self":false,"params":[{"name":"selector","details":[{"kind":"html","content":"

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

\n

Especially useful in combination with

\n"}],"types":["label","selector","location","function"],"strings":[],"default":null,"positional":true,"named":false,"required":true,"variadic":false,"settable":false}],"returns":["location"],"scope":[]}}}