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

Inserts horizontal spacing into a paragraph.

\n

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

\n

Example

\n
First #h(1cm) Second \\\nFirst #h(30%) Second\n
\"Preview\"
\n

Fractional spacing

\n

With fractional spacing, you can align things within a line without forcing\na paragraph break (like align would). Each fractionally sized element\ngets space based on the ratio of its fraction to the sum of all fractions.

\n
First #h(1fr) Second \\\nFirst #h(1fr) Second #h(1fr) Third \\\nFirst #h(2fr) Second #h(1fr) Third\n
\"Preview\"
\n

Mathematical Spacing

\n

In mathematical formulas, you can additionally use these\nconstants to add spacing between elements: thin (1/6 em), med (2/9 em),\nthick (5/18 em), quad (1 em), wide (2 em).

","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 paragraph.\nMoreover, from multiple adjacent weak spacings all but the largest one\ncollapse.

\n

Weak spacing in markup also causes all adjacent markup spaces to be\nremoved, regardless of the amount of spacing inserted. To force a space\nnext to weak spacing, you can explicitly write #" " (for a normal\nspace) or ~ (for a non-breaking space). The latter can be useful to\ncreate a construct that always attaches to the preceding word with one\nnon-breaking space, independently of whether a markup space existed in\nfront or not.

","example":"
#h(1cm, weak: true)\nWe identified a group of _weak_\nspecimens that fail to manifest\nin most cases. However, when\n#h(8pt, weak: true) supported\n#h(8pt, weak: true) on both sides,\nthey do show up.\n\nFurther #h(0pt, weak: true) more,\neven the smallest of them swallow\nadjacent markup spaces.\n
\"Preview\"
","types":["bool"],"strings":[],"default":"false","positional":false,"named":true,"required":false,"variadic":false,"settable":true}],"returns":["content"],"scope":[]}}}