{"route":"/en-US-v0.14.1/reference/html/elem/","title":"Elem","description":"Documentation for the `elem` function.","part":null,"outline":[{"id":"summary","name":"Summary","children":[]},{"id":"parameters","name":"Parameters","children":[{"id":"parameters-tag","name":"tag","children":[]},{"id":"parameters-attrs","name":"attrs","children":[]},{"id":"parameters-body","name":"body","children":[]}]}],"body":{"kind":"func","content":{"path":["html"],"name":"elem","title":"Elem","keywords":[],"oneliner":"An HTML element that can contain Typst content.","element":true,"contextual":false,"deprecationMessage":null,"deprecationUntil":null,"details":[{"kind":"html","content":"

An HTML element that can contain Typst content.

\n

Typst's HTML export automatically generates the appropriate tags for most\nelements. However, sometimes, it is desirable to retain more control. For\nexample, when using Typst to generate your blog, you could use this function\nto wrap each article in an <article> tag.

\n

Typst is aware of what is valid HTML. A tag and its attributes must form\nsyntactically valid HTML. Some tags, like meta do not accept content.\nHence, you must not provide a body for them. We may add more checks in the\nfuture, so be sure that you are generating valid HTML when using this\nfunction.

\n

Normally, Typst will generate html, head, and body tags for you. If\nyou instead create them with this function, Typst will omit its own tags.

\n
#html.elem("div", attrs: (style: "background: aqua"))[\n  A div with _Typst content_ inside!\n]\n
"}],"self":false,"params":[{"name":"tag","details":[{"kind":"html","content":"

The element's tag.

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

The element's HTML attributes.

"}],"types":["dictionary"],"strings":[],"default":"(:)","positional":false,"named":true,"required":false,"variadic":false,"settable":true},{"name":"body","details":[{"kind":"html","content":"

The contents of the HTML element.

\n

The body can be arbitrary Typst content.

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