{"route":"/en-US-v0.14.1/reference/layout/measure/","title":"Measure","description":"Documentation for the `measure` function.","part":null,"outline":[{"id":"summary","name":"Summary","children":[]},{"id":"example","name":"Example","children":[]},{"id":"parameters","name":"Parameters","children":[{"id":"parameters-width","name":"width","children":[]},{"id":"parameters-height","name":"height","children":[]},{"id":"parameters-content","name":"content","children":[]}]}],"body":{"kind":"func","content":{"path":[],"name":"measure","title":"Measure","keywords":[],"oneliner":"Measures the layouted size of content.","element":false,"contextual":true,"deprecationMessage":null,"deprecationUntil":null,"details":[{"kind":"html","content":"

Measures the layouted size of content.

\n

The measure function lets you determine the layouted size of content.\nBy default an infinite space is assumed, so the measured dimensions may\nnot necessarily match the final dimensions of the content.\nIf you want to measure in the current layout dimensions, you can combine\nmeasure and layout.

\n

Example

\n

The same content can have a different size depending on the context that\nit is placed into. In the example below, the #content is of course\nbigger when we increase the font size.

\n
#let content = [Hello!]\n#content\n#set text(14pt)\n#content\n
\"Preview\"
\n

For this reason, you can only measure when context is available.

\n
#let thing(body) = context {\n  let size = measure(body)\n  [Width of "#body" is #size.width]\n}\n\n#thing[Hey] \\\n#thing[Welcome]\n
\"Preview\"
\n

The measure function returns a dictionary with the entries width and\nheight, both of type length.

"}],"self":false,"params":[{"name":"width","details":[{"kind":"html","content":"

The width available to layout the content.

\n

Setting this to auto indicates infinite available width.

\n

Note that using the width and height parameters of this function is\ndifferent from measuring a sized block containing the content. In\nthe following example, the former will get the dimensions of the inner\ncontent instead of the dimensions of the block.

"},{"kind":"example","content":{"body":"
#context measure(lorem(100), width: 400pt)\n\n#context measure(block(lorem(100), width: 400pt))\n
\"Preview\"
","title":null}}],"types":["auto","length"],"strings":[],"default":"auto","positional":false,"named":true,"required":false,"variadic":false,"settable":false},{"name":"height","details":[{"kind":"html","content":"

The height available to layout the content.

\n

Setting this to auto indicates infinite available height.

"}],"types":["auto","length"],"strings":[],"default":"auto","positional":false,"named":true,"required":false,"variadic":false,"settable":false},{"name":"content","details":[{"kind":"html","content":"

The content whose size to measure.

"}],"types":["content"],"strings":[],"default":null,"positional":true,"named":false,"required":true,"variadic":false,"settable":false}],"returns":["dictionary"],"scope":[]}}}