Crate accessibility_scraper

Source
Expand description

HTML parsing and querying with CSS selectors.

accessibility_scraper is on Crates.io and GitHub.

Scraper provides an interface to Servo’s fast_html5ever and selectors crates, for browser-grade parsing and querying.

§Examples

§Parsing a document

use accessibility_scraper::Html;

let html = r#"
    <!DOCTYPE html>
    <meta charset="utf-8">
    <title>Hello, world!</title>
    <h1 class="foo">Hello, <i>world!</i></h1>
"#;

let document = Html::parse_document(html);

§Parsing a fragment

use accessibility_scraper::Html;
let fragment = Html::parse_fragment("<h1>Hello, <i>world!</i></h1>");

§Parsing a selector

use accessibility_scraper::Selector;
let selector = Selector::parse("h1.foo").unwrap();

§Selecting elements

use accessibility_scraper::{Html, Selector};

let html = r#"
    <ul>
        <li>Foo</li>
        <li>Bar</li>
        <li>Baz</li>
    </ul>
"#;

let fragment = Html::parse_fragment(html);
let selector = Selector::parse("li").unwrap();

for element in fragment.select(&selector) {
    assert_eq!("li", element.value().name());
}

§Selecting descendent elements

use accessibility_scraper::{Html, Selector};

let html = r#"
    <ul>
        <li>Foo</li>
        <li>Bar</li>
        <li>Baz</li>
    </ul>
"#;

let fragment = Html::parse_fragment(html);
let ul_selector = Selector::parse("ul").unwrap();
let li_selector = Selector::parse("li").unwrap();

let ul = fragment.select(&ul_selector).next().unwrap();
for element in ul.select(&li_selector) {
    assert_eq!("li", element.value().name());
}

§Accessing element attributes

use accessibility_scraper::{Html, Selector};

let fragment = Html::parse_fragment(r#"<input name="foo" value="bar">"#);
let selector = Selector::parse(r#"input[name="foo"]"#).unwrap();

let input = fragment.select(&selector).next().unwrap();
assert_eq!(Some("bar"), input.value().attr("value"));

§Serializing HTML and inner HTML

use accessibility_scraper::{Html, Selector};

let fragment = Html::parse_fragment("<h1>Hello, <i>world!</i></h1>");
let selector = Selector::parse("h1").unwrap();

let h1 = fragment.select(&selector).next().unwrap();

assert_eq!("<h1>Hello, <i>world!</i></h1>", h1.html());
assert_eq!("Hello, <i>world!</i>", h1.inner_html());

§Accessing descendent text

use accessibility_scraper::{Html, Selector};

let fragment = Html::parse_fragment("<h1>Hello, <i>world!</i></h1>");
let selector = Selector::parse("h1").unwrap();

let h1 = fragment.select(&selector).next().unwrap();
let text = h1.text().collect::<Vec<_>>();

assert_eq!(vec!["Hello, ", "world!"], text);

Re-exports§

pub extern crate fast_html5ever;
pub use crate::element_ref::ElementRef;
pub use crate::html::Html;
pub use crate::node::Node;
pub use crate::selector::Selector;
pub use cssparser;
pub use ego_tree;
pub use selectors;
pub use tendril;

Modules§

element_ref
Element references.
error
Custom error types for diagnostics Includes re-exported error types from dependencies
html
HTML documents and fragments.
node
HTML nodes.
selector
CSS selectors.

Type Aliases§

StrTendril
Primary string tendril type.