html_editor 0.7.0

Pure and simple HTML parser and editor.
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
76
77
78
79
80
81
82

[![crate-badge]][crate-link]
[![downloads-badge]][crate-link]
![License](https://img.shields.io/crates/l/html_editor)
[![check-badge]][check-link]

[crate-badge]: https://img.shields.io/crates/v/html_editor
[crate-link]: https://crates.io/crates/html_editor
[check-badge]: https://github.com/lomirus/html-editor/workflows/check/badge.svg
[check-link]: https://github.com/lomirus/html-editor/actions/workflows/check.yaml
[downloads-badge]: https://img.shields.io/crates/d/html_editor

# HTML Editor


Pure and simple HTML parser and editor.

## Examples


### Parse HTML segment/document


```rust
let document: Vec<Node> = parse("<!doctype html><html><head></head><body></body></html>")?;
println!("{:#?}", document);
```

Output:

```rust
[
    Doctype(
        Html,
    ),
    Element {
        name: "html",
        attrs: {},
        children: [
            Element {
                name: "head",
                attrs: {},
                children: [],
            },
            Element {
                name: "body",
                attrs: {},
                children: [],
            },
        ],
    },
]
```

You can also use `try_parse` to parse the html which contains tolerable errors

```rust
let document: Vec<Node> = try_parse("<div><span>Ipsum</div>");
```

### Query an element / elements by selector


```rust
// let html = r#"..."#
let nodes: Vec<Node> = parse(html)?;
let selector: Selector = Selector::from(".box");

let element: Option<Element> = nodes.query(&selector);
let elements: Vec<Element> = nodes.query_all(&selector);
```

### Edit the HTML


```rust
// let html = r#"..."#
let a: String = parse(html)?.trim().html();
let b: String = parse(html)?.insert_to(&selector, node).html();
let c: String = parse(html)?.remove_by(&selector).html();
let d: String = parse(html)?.replace_with(&selector, |el| Node::Comment(el.html())).html();
```

You can find more examples in the [documentation](https://docs.rs/html_editor/latest/html_editor/).

## Changelog


See in [CHANGELOG.md](CHANGELOG.md)