{"route":"/en-US-v0.14.1/reference/layout/ratio/","title":"Ratio","description":"Documentation for the Ratio type.","part":null,"outline":[{"id":"summary","name":"Summary","children":[]},{"id":"scripting","name":"Scripting","children":[]}],"body":{"kind":"type","content":{"name":"ratio","title":"Ratio","keywords":[],"oneliner":"A ratio of a whole.","details":"

A ratio of a whole.

\n

A ratio is written as a number, followed by a percent sign. Ratios most\noften appear as part of a relative length, to specify the size\nof some layout element relative to the page or some container.

\n
#rect(width: 25%)\n
\"Preview\"
\n

However, they can also describe any other property that is relative to some\nbase, e.g. an amount of horizontal scaling or the\nheight of parentheses relative to the height of the content\nthey enclose.

\n

Scripting

\n

Within your own code, you can use ratios as you like. You can multiply them\nwith various other types as shown below:

\n\n\n\n\n\n\n\n\n
Multiply byExampleResult
ratio27% * 10%2.7%
length27% * 100pt27pt
relative27% * (10% + 100pt)2.7% + 27pt
angle27% * 100deg27deg
int27% * 254%
float27% * 0.3703710%
fraction27% * 3fr0.81fr
\n

When ratios are displayed in the document, they are rounded to two\nsignificant digits for readability.

","constructor":null,"scope":[]}}}