html5ever_ext 0.21.2

This is set of unofficial extensions to the html5ever crate's RcDom and Node structs, including a ***minifying HTML5 serializer*** and support for ***CSS matching**.
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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

// This file is part of css-purify. It is subject to the license terms in the COPYRIGHT file found in the top-level directory of this distribution and at https://raw.githubusercontent.com/lemonrock/css-purify/master/COPYRIGHT. No part of predicator, including this file, may be copied, modified, propagated, or distributed except according to the terms contained in the COPYRIGHT file.
// Copyright © 2017 The developers of css-purify. See the COPYRIGHT file in the top-level directory of this distribution and at https://raw.githubusercontent.com/lemonrock/css-purify/master/COPYRIGHT.


/// This trait adds methods for finding DOM nodes matching a CSS selector
pub trait Selectable
{
	/// Recursively find element nodes that match this selector.
	/// Return true from MatchUser to abort early.
	/// The result of this function is true if MatchUser aborted early, or false otherwise.
	#[inline]
	fn find_all_matching_child_nodes_depth_first_including_this_one<MatchUser: FnMut(&Rc<Node>) -> bool>(&self, selector: &OurSelector, match_user: &mut MatchUser) -> bool;
	
	/// Returns whether this element matches this selector.
	/// For the RcDom and &'a [RcDom], is currently always false.
	#[inline]
	fn matches(&self, selector: &OurSelector) -> bool;
}

impl<'a> Selectable for &'a [RcDom]
{
	#[inline]
	fn find_all_matching_child_nodes_depth_first_including_this_one<MatchUser: FnMut(&Rc<Node>) -> bool>(&self, selector: &OurSelector, match_user: &mut MatchUser) -> bool
	{
		for rc_dom in self.iter()
		{
			if rc_dom.find_all_matching_child_nodes_depth_first_including_this_one(selector, match_user)
			{
				return true;
			}
		}
		false
	}
	
	#[inline]
	fn matches(&self, selector: &OurSelector) -> bool
	{
		for rc_dom in self.iter()
		{
			if rc_dom.matches(selector)
			{
				return true;
			}
		}
		false
	}
}

impl Selectable for RcDom
{
	#[inline]
	fn find_all_matching_child_nodes_depth_first_including_this_one<MatchUser: FnMut(&Rc<Node>) -> bool>(&self, selector: &OurSelector, match_user: &mut MatchUser) -> bool
	{
		self.document.find_all_matching_child_nodes_depth_first_including_this_one(selector, match_user)
	}
	
	#[inline]
	fn matches(&self, selector: &OurSelector) -> bool
	{
		self.document.matches(selector)
	}
}

impl<'a> Selectable for Rc<Node>
{
	#[inline]
	fn find_all_matching_child_nodes_depth_first_including_this_one<MatchUser: FnMut(&Rc<Node>) -> bool>(&self, selector: &OurSelector, match_user: &mut MatchUser) -> bool
	{
		if self.matches(selector)
		{
			let should_finish = match_user(self);
			if should_finish
			{
				return true;
			}
		}
		
		for child in self.children.borrow().iter()
		{
			if child.find_all_matching_child_nodes_depth_first_including_this_one(selector, match_user)
			{
				return true;
			}
		}
		false
	}
	
	#[inline]
	fn matches(&self, selector: &OurSelector) -> bool
	{
		match self.data
		{
			NodeData::Element { .. } => matches(selector, &ElementNode
			{
				node: self.clone(),
			}),
			
			_ => false,
		}
	}
}