yew/website/docs/concepts/html/literals-and-expressions.mdx
Matt 90b4e55ebc
Docusaurus Overhaul (#2275)
* change suffixes from md to mdx
fix broken links for English locale
tree shake and update docusaurus
add docusaurus ideal image plugin
use svg and themed image
delete unused static asset

* move localized landing page

* change GitLocalize project page

* nit pick

* remove ignore to have the block checked
2021-12-20 12:10:45 +02:00

68 lines
1.3 KiB
Plaintext

---
title: "Literals and Expressions"
---
## Literals
If expressions resolve to types that implement `Display`, they will be converted to strings and inserted into the DOM as a [Text](https://developer.mozilla.org/en-US/docs/Web/API/Text) node.
All display text must be enclosed by `{}` blocks because text is handled as an expression. This is
the largest deviation from normal HTML syntax that Yew makes.
```rust
use yew::html;
let text = "lorem ipsum";
html!{
<>
<div>{text}</div>
<div>{"dolor sit"}</div>
<span>{42}</span>
</>
};
```
## Expressions
You can insert expressions in your HTML using `{}` blocks, as long as they resolve to `Html`
```rust
use yew::html;
let show_link = true;
html! {
<div>
{
if show_link {
html! {
<a href="https://example.com">{"Link"}</a>
}
} else {
html! {}
}
}
</div>
};
```
It often makes sense to extract these expressions into functions or closures to optimize for readability:
```rust
use yew::{html, Html};
let show_link = true;
let maybe_display_link = move || -> Html {
if show_link {
html! {
<a href="https://example.com">{"Link"}</a>
}
} else {
html! {}
}
};
html! {
<div>{maybe_display_link()}</div>
};
```