codec-abc c25d834fce Add a note telling how to bypass the recursion limit of the html! macro. (#94)
* Add a note telling how to bypass the recursion limit of the html! macro.

* Update src/concepts/html/README.md

Co-authored-by: Teymour Aldridge <42674621+teymour-aldridge@users.noreply.github.com>

* Update src/concepts/html/README.md

Co-authored-by: Teymour Aldridge <42674621+teymour-aldridge@users.noreply.github.com>
Co-authored-by: Justin Starry <justin.m.starry@gmail.com>
2020-07-10 16:53:44 +08:00
..

description
The procedural macro for generating HTML and SVG

Using html!

The html! macro allows you to write HTML and SVG code declaratively. It is similar to JSX a Javascript extension which allows you to write HTML code inside of Javascript.

Important notes

  1. The html! macro only accepts one root html node you can counteract this by [using fragments or iterators](lists.md)
  2. An empty html! {} invocation is valid and will not render anything
  3. Literals must always be quoted and wrapped in braces: html! { "Hello, World" } {% hint style="info" %} The html! macro can reach easily the default recursion limit of the compiler. It is advised to bump its value if you encouter compilation errors. Use an attribute like #![recursion_limit="1024"] to bypass the problem. See the official documentation and this Stack Overflow question for details. {% endhint %}

{% page-ref page="lists.md" %}

{% page-ref page="elements.md" %}

{% page-ref page="literals-and-expressions.md" %}

{% page-ref page="components.md" %}