Struct svgdom::Document

pub struct Document {
    pub root: Node,
}

Container of Nodes.

Fields

root: Node

Root node.

Methods

impl Document

fn new() -> Document

Constructs a new Document.

fn from_data(data: &[u8]) -> Result<Document, Error>

Constructs a new Document from the data using a default ParseOptions.

fn from_data_with_opt(data: &[u8],
                      opt: &ParseOptions)
                      -> Result<Document, Error>

Constructs a new Document from the data using a supplied ParseOptions.

fn create_element<'a, T>(&self, tag_name: T) -> Node where TagNameRef<'a>: From<T>

Constructs a new Node with Element type.

Constructed node do belong to this document, but not added to it tree structure.

Panics

Panics if a string tag name is empty.

fn create_node(&self, node_type: NodeType, text: &str) -> Node

Constructs a new Node using the supplied NodeType.

Constructed node do belong to this document, but not added to it tree structure.

This method should be used for any non-element nodes.

fn root(&self) -> Node

Returns the root Node.

fn first_child(&self) -> Option<Node>

Returns the first child of the root Node.

Panics

Panics if the root node is currently mutability borrowed.

fn svg_element(&self) -> Option<Node>

Returns the first child with svg tag name of the root Node.

In most of the cases result of this method and first_element_child() will be the same, but an additional check may be helpful.

Panics

Panics if the root node is currently mutability borrowed.

Examples

use svgdom::{Document, ElementId};

let doc = Document::from_data(b"<!--comment--><svg/>").unwrap();

assert_eq!(doc.svg_element().unwrap().is_tag_name(ElementId::Svg), true);

fn append(&self, new_child: &Node) -> Node

Appends a new child to root node, after existing children, and returns it.

Panics

Panics if the node, the new child, or one of their adjoining nodes is currently borrowed.

Examples

use svgdom::{Document, ElementId};

let doc = Document::new();
doc.append(&doc.create_element(ElementId::Svg));

assert_eq!(doc.to_string(), "<svg/>\n");

fn descendants(&self) -> Descendants

Returns an iterator over descendants.

fn children(&self) -> Children

Returns an iterator to this node's children elements.

Panics

Panics if the node is currently mutability borrowed.

fn drain<P>(&self, f: P) -> usize where P: Fn(&Node) -> bool

Removes only the children nodes specified by the predicate.

The root node ignored.

Trait Implementations

impl Default for Document

fn default() -> Self

Returns the "default value" for a type.

impl WriteBuffer for Document

fn write_buf_opt(&self, opt: &WriteOptions, buf: &mut Vec<u8>)

Writes data to the Vec<u8> buffer using specified WriteOptions.

fn write_buf(&self, buf: &mut Vec<u8>)

Writes data to the Vec<u8> buffer using default WriteOptions.

impl Display for Document

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

Formats the value using the given formatter.

impl WriteToString for Document

fn to_string_with_opt(&self, opt: &WriteOptions) -> String

Writes data to the String using specified WriteOptions.