Enum Node 

pub enum Node {
    Element(Element),
    Text(String),
    Raw(String),
    Comment(String),
    Fragment(Vec<Node>),
}

A node in the HTML tree.

Examples

use winged_rust::prelude::*;
let node = Node::from(div().text("hi"));
assert_eq!(node.render(), "<div>hi</div>");

Variants

Element(Element)

An element with a tag name, attributes and children.

Text(String)

Escaped text. The escaping already happened — see crate::core::escape.

Raw(String)

Verbatim markup, never escaped. For imported snippets: an SVG, an embed code.

Unlike Node::Fragment, this is an opaque string, so pretty printing can only indent the whole blob. Reach for a fragment when you want the children indented.

Comment(String)

An HTML comment. New in the Rust port — Winged-Swift has no comment node.

The content has -- neutralised so the comment cannot be closed early.

Fragment(Vec<Node>)

A transparent group that renders its children with no wrapper element.

Use it to return several nodes from one expression — a map of cards, the body of an if, a group of <meta> tags — without introducing an extra <div>.

Implementations

impl Node

pub fn text(content: impl AsRef<str>) -> Self

Creates a text node, escaping the content.

pub fn raw(content: impl Into<String>) -> Self

Creates a raw markup node. The content is not escaped.

pub fn comment(content: impl AsRef<str>) -> Self

Creates a comment node.

Any -- in the content is replaced with - -, so the comment cannot terminate early and inject markup.

Examples

use winged_rust::prelude::*;
assert_eq!(Node::comment("a -- b").render(), "<!-- a - - b -->");

pub fn fragment(children: impl IntoIterator<Item = Node>) -> Self

Creates a transparent group of nodes.

pub fn is_empty(&self) -> bool

Whether this node renders to nothing.

The pretty-print writer arrives at the same answer without calling this: it lets a child write straight into the output and rolls the separator back if the child wrote nothing, which is what stops an empty fragment — the body of a false if — from leaving a blank line behind.

Trait Implementations

impl Clone for Node

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Node

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

Formats the value using the given formatter.

impl Eq for Node

impl From<&str> for Node

fn from(text: &str) -> Self

Converts to this type from the input type.

impl From<Element> for Node

fn from(element: Element) -> Self

Converts to this type from the input type.

impl From<String> for Node

fn from(text: String) -> Self

Converts to this type from the input type.

impl PartialEq for Node

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Render for Node

fn write_into(&self, out: &mut String, options: &RenderOptions, depth: usize)

Writes this node and its subtree into an existing buffer.

fn render(&self) -> String

Renders as a single line of markup.

fn render_pretty(&self) -> String

Renders with indentation and line breaks.

fn render_with(&self, options: &RenderOptions) -> String

Renders with the given options.

impl StructuralPartialEq for Node