Struct scraper::element_ref::ElementRef

pub struct ElementRef<'a> { /* fields omitted */ }

Wrapper around a reference to an element node.

This wrapper implements the Element trait from the selectors crate, which allows it to be matched against CSS selectors.

Methods

impl<'a> ElementRef<'a>

pub fn wrap(node: NodeRef<'a, Node>) -> Option<Self>

Wraps a NodeRef only if it references a Node::Element.

pub fn value(&self) -> &'a Element

Returns the Element referenced by self.

Important traits for Select<'a, 'b>

impl<'a, 'b> Iterator for Select<'a, 'b> type Item = ElementRef<'a>;

pub fn select<'b>(&self, selector: &'b Selector) -> Select<'a, 'b>

Returns an iterator over descendent elements matching a selector.

pub fn html(&self) -> String

Returns the HTML of this element.

pub fn inner_html(&self) -> String

Returns the inner HTML of this element.

Important traits for Text<'a>

impl<'a> Iterator for Text<'a> type Item = &'a str;

pub fn text(&self) -> Text<'a>

Returns an iterator over descendent text nodes.

Methods from Deref<Target = NodeRef<'a, Node>>

Important traits for &'a mut R

impl<'a, R> Read for &'a mut R where
    R: Read + ?Sized, impl<'a, W> Write for &'a mut W where
    W: Write + ?Sized, impl<'a, I> Iterator for &'a mut I where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;

pub fn value(&self) -> &'a T

Returns the value of this node.

pub fn parent(&self) -> Option<NodeRef<'a, T>>

Returns the parent of this node.

pub fn prev_sibling(&self) -> Option<NodeRef<'a, T>>

Returns the previous sibling of this node.

pub fn next_sibling(&self) -> Option<NodeRef<'a, T>>

Returns the next sibling of this node.

pub fn first_child(&self) -> Option<NodeRef<'a, T>>

Returns the first child of this node.

pub fn last_child(&self) -> Option<NodeRef<'a, T>>

Returns the last child of this node.

pub fn has_siblings(&self) -> bool

Returns true if this node has siblings.

pub fn has_children(&self) -> bool

Returns true if this node has children.

Important traits for Ancestors<'a, T>

impl<'a, T> Iterator for Ancestors<'a, T> where
    T: 'a,  type Item = NodeRef<'a, T>;

pub fn ancestors(&self) -> Ancestors<'a, T>

Returns an iterator over ancestors.

Important traits for PrevSiblings<'a, T>

impl<'a, T> Iterator for PrevSiblings<'a, T> where
    T: 'a,  type Item = NodeRef<'a, T>;

pub fn prev_siblings(&self) -> PrevSiblings<'a, T>

Returns an iterator over previous siblings.

Important traits for NextSiblings<'a, T>

impl<'a, T> Iterator for NextSiblings<'a, T> where
    T: 'a,  type Item = NodeRef<'a, T>;

pub fn next_siblings(&self) -> NextSiblings<'a, T>

Returns an iterator over next siblings.

Important traits for FirstChildren<'a, T>

impl<'a, T> Iterator for FirstChildren<'a, T> where
    T: 'a,  type Item = NodeRef<'a, T>;

pub fn first_children(&self) -> FirstChildren<'a, T>

Returns an iterator over first children.

Important traits for LastChildren<'a, T>

impl<'a, T> Iterator for LastChildren<'a, T> where
    T: 'a,  type Item = NodeRef<'a, T>;

pub fn last_children(&self) -> LastChildren<'a, T>

Returns an iterator over last children.

Important traits for Children<'a, T>

impl<'a, T> Iterator for Children<'a, T> where
    T: 'a,  type Item = NodeRef<'a, T>;

pub fn children(&self) -> Children<'a, T>

Returns an iterator over children.

Important traits for Traverse<'a, T>

impl<'a, T> Iterator for Traverse<'a, T> where
    T: 'a,  type Item = Edge<'a, T>;

pub fn traverse(&self) -> Traverse<'a, T>

Returns an iterator which traverses the subtree starting at this node.

Important traits for Descendants<'a, T>

impl<'a, T> Iterator for Descendants<'a, T> where
    T: 'a,  type Item = NodeRef<'a, T>;

pub fn descendants(&self) -> Descendants<'a, T>

Returns an iterator over this node and its descendants.

Trait Implementations

impl<'a> Element for ElementRef<'a>

Note: will never match against non-tree-structure pseudo-classes.

type Impl = Simple

fn parent_element(&self) -> Option<Self>

fn first_child_element(&self) -> Option<Self>

Skips non-element nodes

fn last_child_element(&self) -> Option<Self>

Skips non-element nodes

fn prev_sibling_element(&self) -> Option<Self>

Skips non-element nodes

fn next_sibling_element(&self) -> Option<Self>

Skips non-element nodes

fn is_html_element_in_html_document(&self) -> bool

fn get_local_name(&self) -> &LocalName

fn get_namespace(&self) -> &Namespace

Empty string for no namespace

fn match_non_ts_pseudo_class<F>(     &self,     _pc: &NonTSPseudoClass,     _context: &mut MatchingContext<Self::Impl>,     _visited_handling: VisitedHandlingMode,     _flags_setter: &mut F ) -> bool

fn has_class(&self, name: &LocalName, case_sensitivity: CaseSensitivity) -> bool

fn is_empty(&self) -> bool

Returns whether this element matches :empty.

fn is_root(&self) -> bool

Returns whether this element matches :root, i.e. whether it is the root element of a document.

fn attr_matches(     &self,     ns: &NamespaceConstraint<&Namespace>,     local_name: &LocalName,     operation: &AttrSelectorOperation<&String> ) -> bool

fn match_pseudo_element(     &self,     _pe: &PseudoElement,     _context: &mut MatchingContext<Self::Impl> ) -> bool

fn is_link(&self) -> bool

Whether this element is a link.

fn opaque(&self) -> OpaqueElement

Converts self into an opaque representation.

fn has_id(&self, id: &LocalName, case_sensitivity: CaseSensitivity) -> bool

fn pseudo_element_originating_element(&self) -> Option<Self>

The parent of a given pseudo-element, after matching a pseudo-element selector.

fn assigned_slot(&self) -> Option<Self>

Returns the assigned element this element is assigned to.

fn ignores_nth_child_selectors(&self) -> bool

Returns whether this element should ignore matching nth child selector.

fn blocks_ancestor_combinators(&self) -> bool

Return true if we want to stop lookup ancestor of the current element while matching complex selectors with descendant/child combinator.

impl<'a> Serialize for ElementRef<'a>

fn serialize<S: Serializer>(     &self,     serializer: &mut S,     traversal_scope: TraversalScope ) -> Result<(), Error>

Take the serializer and call its methods to serialize this type. The type will dictate which methods are called and with what parameters.

impl<'a> Debug for ElementRef<'a>

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl<'a> Clone for ElementRef<'a>

fn clone(&self) -> ElementRef<'a>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Copy for ElementRef<'a>

impl<'a> PartialEq for ElementRef<'a>

fn eq(&self, other: &ElementRef<'a>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &ElementRef<'a>) -> bool

This method tests for !=.

impl<'a> Eq for ElementRef<'a>

impl<'a> Deref for ElementRef<'a>

type Target = NodeRef<'a, Node>

The resulting type after dereferencing.

fn deref(&self) -> &NodeRef<'a, Node>

Dereferences the value.