{"route":"/en-US-v0.13.1/reference/layout/v/","title":"Spacing (V)","description":"Documentation for the `v` function.","part":null,"outline":[{"id":"summary","name":"Summary","children":[]},{"id":"example","name":"Example","children":[]},{"id":"parameters","name":"Parameters","children":[{"id":"parameters-amount","name":"amount","children":[]},{"id":"parameters-weak","name":"weak","children":[]}]}],"body":{"kind":"func","content":{"path":[],"name":"v","title":"Spacing (V)","keywords":[],"oneliner":"Inserts vertical spacing into a flow of blocks.","element":true,"contextual":false,"deprecation":null,"details":"

Inserts vertical spacing into a flow of blocks.

\n

The spacing can be absolute, relative, or fractional. In the last case,\nthe remaining space on the page is distributed among all fractional spacings\naccording to their relative fractions.

\n

Example

\n
#grid(\n  rows: 3cm,\n  columns: 6,\n  gutter: 1fr,\n  [A #parbreak() B],\n  [A #v(0pt) B],\n  [A #v(10pt) B],\n  [A #v(0pt, weak: true) B],\n  [A #v(40%, weak: true) B],\n  [A #v(1fr) B],\n)\n
\"Preview\"
","example":null,"self":false,"params":[{"name":"amount","details":"

How much spacing to insert.

","example":null,"types":["relative","fraction"],"strings":[],"default":null,"positional":true,"named":false,"required":true,"variadic":false,"settable":false},{"name":"weak","details":"

If true, the spacing collapses at the start or end of a flow.\nMoreover, from multiple adjacent weak spacings all but the largest one\ncollapse. Weak spacings will always collapse adjacent paragraph spacing,\neven if the paragraph spacing is larger.

","example":"
The following theorem is\nfoundational to the field:\n#v(4pt, weak: true)\n$ x^2 + y^2 = r^2 $\n#v(4pt, weak: true)\nThe proof is simple:\n
\"Preview\"
","types":["bool"],"strings":[],"default":"false","positional":false,"named":true,"required":false,"variadic":false,"settable":true}],"returns":["content"],"scope":[]}}}