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

Provides the current location in the document.

\n

You can think of here as a low-level building block that directly extracts\nthe current location from the active context. Some other functions use it\ninternally: For instance, counter.get() is equivalent to\ncounter.at(here()).

\n

Within show rules on locatable elements, here()\nwill match the location of the shown element.

\n

If you want to display the current page number, refer to the documentation\nof the counter type. While here can be used to determine the physical\npage number, typically you want the logical page number that may, for\ninstance, have been reset after a preface.

\n

Examples

\n

Determining the current position in the document in combination with the\nposition method:

\n
#context [\n  I am located at\n  #here().position()\n]\n
\"Preview\"
\n

Running a query for elements before the current position:

\n
= Introduction\n= Background\n\nThere are\n#context query(\n  selector(heading).before(here())\n).len()\nheadings before me.\n\n= Conclusion\n
\"Preview\"
\n

Refer to the selector type for more details on before/after selectors.

"}],"self":false,"params":[],"returns":["location"],"scope":[]}}}