{"route":"/en-US-v0.14.1/reference/text/overline/","title":"Overline","description":"Documentation for the `overline` function.","part":null,"outline":[{"id":"summary","name":"Summary","children":[]},{"id":"example","name":"Example","children":[]},{"id":"parameters","name":"Parameters","children":[{"id":"parameters-stroke","name":"stroke","children":[]},{"id":"parameters-offset","name":"offset","children":[]},{"id":"parameters-extent","name":"extent","children":[]},{"id":"parameters-evade","name":"evade","children":[]},{"id":"parameters-background","name":"background","children":[]},{"id":"parameters-body","name":"body","children":[]}]}],"body":{"kind":"func","content":{"path":[],"name":"overline","title":"Overline","keywords":[],"oneliner":"Adds a line over text.","element":true,"contextual":false,"deprecationMessage":null,"deprecationUntil":null,"details":[{"kind":"html","content":"<p>Adds a line over text.</p>\n<h2 id=\"example\">Example</h2>\n<div class=\"previewed-code\"><pre><code><span class=\"typ-func\">#</span><span class=\"typ-func\">overline</span><span class=\"typ-punct\">[</span>A line over text.<span class=\"typ-punct\">]</span>\n</code></pre><div class=\"preview\"><img src=\"/en-US-v0.14.1/assets/50989a8ae293089193aedd0105c6c64.png\" alt=\"Preview\"></div></div>"}],"self":false,"params":[{"name":"stroke","details":[{"kind":"html","content":"<p>How to <a href=\"/en-US-v0.14.1/reference/visualize/stroke/\" title=\"stroke\">stroke</a> the line.</p>\n<p>If set to <code><span class=\"typ-key\">auto</span></code>, takes on the text's color and a thickness defined in\nthe current font.</p>"},{"kind":"example","content":{"body":"<div class=\"previewed-code\"><pre><code><span class=\"typ-key\">#</span><span class=\"typ-key\">set</span> <span class=\"typ-func\">text</span><span class=\"typ-punct\">(</span>fill<span class=\"typ-punct\">:</span> olive<span class=\"typ-punct\">)</span>\n<span class=\"typ-func\">#</span><span class=\"typ-func\">overline</span><span class=\"typ-punct\">(</span>\n  stroke<span class=\"typ-punct\">:</span> green<span class=\"typ-punct\">.</span><span class=\"typ-func\">darken</span><span class=\"typ-punct\">(</span><span class=\"typ-num\">20%</span><span class=\"typ-punct\">)</span><span class=\"typ-punct\">,</span>\n  offset<span class=\"typ-punct\">:</span> <span class=\"typ-op\">-</span><span class=\"typ-num\">12pt</span><span class=\"typ-punct\">,</span>\n  <span class=\"typ-punct\">[</span>The Forest Theme<span class=\"typ-punct\">]</span><span class=\"typ-punct\">,</span>\n<span class=\"typ-punct\">)</span>\n</code></pre><div class=\"preview\"><img src=\"/en-US-v0.14.1/assets/8d710067177d3459c2b6071b0d597321.png\" alt=\"Preview\"></div></div>","title":null}}],"types":["auto","length","color","gradient","stroke","tiling","dictionary"],"strings":[],"default":"<code><span class=\"typ-key\">auto</span></code>","positional":false,"named":true,"required":false,"variadic":false,"settable":true},{"name":"offset","details":[{"kind":"html","content":"<p>The position of the line relative to the baseline. Read from the font\ntables if <code><span class=\"typ-key\">auto</span></code>.</p>"},{"kind":"example","content":{"body":"<div class=\"previewed-code\"><pre><code><span class=\"typ-func\">#</span><span class=\"typ-func\">overline</span><span class=\"typ-punct\">(</span>offset<span class=\"typ-punct\">:</span> <span class=\"typ-op\">-</span><span class=\"typ-num\">1.2em</span><span class=\"typ-punct\">)</span><span class=\"typ-punct\">[</span>\n  The Tale Of A Faraway Line II\n<span class=\"typ-punct\">]</span>\n</code></pre><div class=\"preview\"><img src=\"/en-US-v0.14.1/assets/1404884c3853de7e6a5eda657a4d3ae.png\" alt=\"Preview\"></div></div>","title":null}}],"types":["auto","length"],"strings":[],"default":"<code><span class=\"typ-key\">auto</span></code>","positional":false,"named":true,"required":false,"variadic":false,"settable":true},{"name":"extent","details":[{"kind":"html","content":"<p>The amount by which to extend the line beyond (or within if negative)\nthe content.</p>"},{"kind":"example","content":{"body":"<div class=\"previewed-code\"><pre><code><span class=\"typ-key\">#</span><span class=\"typ-key\">set</span> <span class=\"typ-func\">overline</span><span class=\"typ-punct\">(</span>extent<span class=\"typ-punct\">:</span> <span class=\"typ-num\">4pt</span><span class=\"typ-punct\">)</span>\n<span class=\"typ-key\">#</span><span class=\"typ-key\">set</span> <span class=\"typ-func\">underline</span><span class=\"typ-punct\">(</span>extent<span class=\"typ-punct\">:</span> <span class=\"typ-num\">4pt</span><span class=\"typ-punct\">)</span>\n<span class=\"typ-func\">#</span><span class=\"typ-func\">overline</span><span class=\"typ-punct\">(</span><span class=\"typ-func\">underline</span><span class=\"typ-punct\">[</span>Typography Today<span class=\"typ-punct\">]</span><span class=\"typ-punct\">)</span>\n</code></pre><div class=\"preview\"><img src=\"/en-US-v0.14.1/assets/d7574586783bdfe3cf728b98d641aec4.png\" alt=\"Preview\"></div></div>","title":null}}],"types":["length"],"strings":[],"default":"<code><span class=\"typ-num\">0pt</span></code>","positional":false,"named":true,"required":false,"variadic":false,"settable":true},{"name":"evade","details":[{"kind":"html","content":"<p>Whether the line skips sections in which it would collide with the\nglyphs.</p>"},{"kind":"example","content":{"body":"<div class=\"previewed-code\"><pre><code><span class=\"typ-func\">#</span><span class=\"typ-func\">overline</span><span class=\"typ-punct\">(</span>\n  evade<span class=\"typ-punct\">:</span> <span class=\"typ-key\">false</span><span class=\"typ-punct\">,</span>\n  offset<span class=\"typ-punct\">:</span> <span class=\"typ-op\">-</span><span class=\"typ-num\">7.5pt</span><span class=\"typ-punct\">,</span>\n  stroke<span class=\"typ-punct\">:</span> <span class=\"typ-num\">1pt</span><span class=\"typ-punct\">,</span>\n  extent<span class=\"typ-punct\">:</span> <span class=\"typ-num\">3pt</span><span class=\"typ-punct\">,</span>\n  <span class=\"typ-punct\">[</span>Temple<span class=\"typ-punct\">]</span><span class=\"typ-punct\">,</span>\n<span class=\"typ-punct\">)</span>\n</code></pre><div class=\"preview\"><img src=\"/en-US-v0.14.1/assets/e2dca96fc9f5aedf3819c18ac04be640.png\" alt=\"Preview\"></div></div>","title":null}}],"types":["bool"],"strings":[],"default":"<code><span class=\"typ-key\">true</span></code>","positional":false,"named":true,"required":false,"variadic":false,"settable":true},{"name":"background","details":[{"kind":"html","content":"<p>Whether the line is placed behind the content it overlines.</p>"},{"kind":"example","content":{"body":"<div class=\"previewed-code\"><pre><code><span class=\"typ-key\">#</span><span class=\"typ-key\">set</span> <span class=\"typ-func\">overline</span><span class=\"typ-punct\">(</span>stroke<span class=\"typ-punct\">:</span> <span class=\"typ-punct\">(</span>thickness<span class=\"typ-punct\">:</span> <span class=\"typ-num\">1em</span><span class=\"typ-punct\">,</span> paint<span class=\"typ-punct\">:</span> maroon<span class=\"typ-punct\">,</span> cap<span class=\"typ-punct\">:</span> <span class=\"typ-str\">&quot;round&quot;</span><span class=\"typ-punct\">)</span><span class=\"typ-punct\">)</span>\n<span class=\"typ-func\">#</span><span class=\"typ-func\">overline</span><span class=\"typ-punct\">(</span>background<span class=\"typ-punct\">:</span> <span class=\"typ-key\">true</span><span class=\"typ-punct\">)</span><span class=\"typ-punct\">[</span>This is stylized.<span class=\"typ-punct\">]</span> <span class=\"typ-escape\">\\</span>\n<span class=\"typ-func\">#</span><span class=\"typ-func\">overline</span><span class=\"typ-punct\">(</span>background<span class=\"typ-punct\">:</span> <span class=\"typ-key\">false</span><span class=\"typ-punct\">)</span><span class=\"typ-punct\">[</span>This is partially hidden.<span class=\"typ-punct\">]</span>\n</code></pre><div class=\"preview\"><img src=\"/en-US-v0.14.1/assets/275a85d06ae4812de1068593a2fad9fc.png\" alt=\"Preview\"></div></div>","title":null}}],"types":["bool"],"strings":[],"default":"<code><span class=\"typ-key\">false</span></code>","positional":false,"named":true,"required":false,"variadic":false,"settable":true},{"name":"body","details":[{"kind":"html","content":"<p>The content to add a line over.</p>"}],"types":["content"],"strings":[],"default":null,"positional":true,"named":false,"required":true,"variadic":false,"settable":false}],"returns":["content"],"scope":[]}}}