el 0.1.1

Write and manipulate HTML elements as data
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

# el

`el` is a no-dependencies Rust library for writing, modifying, and safely
rendering HTML elements as simple data structures. It is inspired by [hiccup]
and named after a small helper function I once wrote in JS.

[hiccup]: https://github.com/weavejester/hiccup

## Show me a simple example

```rs
use el::{Attr, Render, html::*};

let page: String = html((
    head((
        meta(Attr::new("charset", "utf-8")),
        meta((
            Attr::new("name", "viewport"),
            Attr::new("content", "width=device-width, initial-scale=1"),
        )),
        title("Example page"),
    )),
    body((
        h1((Attr::id("heading"), "Example page")),
        p(("This is an example for a ", em("simple"), " web page.")),
    )),
))
.into_document()
.render_to_string()
.unwrap();
```

## What now?

See the top-level crate documentation for more info.

## But what about that small helper function?

Here it is in full, for posteriority:

```js
function el(name, attributes, ...children) {
  const element = document.createElement(name);
  for (const [name, value] of Object.entries(attributes))
    element.setAttribute(name, value);
  element.append(...children);
  return element;
}
```

Use it like so:

```js
const page = el("html", {},
  el("head", {},
    el("meta", { charset: "utf-8" }),
    el("meta", {
        name: "viewport",
        content: "width=device-width, initial-scale=1",
    }),
    el("title", {}, "Example page")
  ),
  el("body", {},
    el("h1", { id: "heading" }, "Example page"),
    el("p", {}, "This is an example for a ", el("em", {}, "simple"), " web page."),
  ),
);
```

## License

This entire project is dual-licensed under the [Apache 2.0] and [MIT] licenses.

[Apache 2.0]: LICENSE-APACHE
[MIT]: LICENSE-MIT