Struct perseus::SsrNode

pub struct SsrNode(_);

Rendering backend for Server Side Rendering, aka. SSR.

This API requires the following crate features to be activated: ssr

Implementations

impl SsrNode

pub fn raw_text_node(html: &str) -> SsrNode

Create a new raw text node.

Do not pass unsanitized user input to this function. When the node is rendered, no escaping will be performed which might lead to a XSS (Cross Site Scripting) attack.

Trait Implementations

impl Clone for SsrNode

fn clone(&self) -> SsrNode

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SsrNode

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

Formats the value using the given formatter.

impl GenericNode for SsrNode

type EventType = Event

Although SsrNode is intended to be used on the server-side instead of in the browser, the event type is still [web_sys::Event] because it must support the same API as DomNode. Since event handlers will never be called on the server side anyways, it’s okay to do this.

type PropertyType = JsValue

The type for set_property.

const USE_HYDRATION_CONTEXT: bool = true

Whether this rendering backend needs the hydration registry.

fn element<T>() -> SsrNodewhere
    T: SycamoreElement,

Create a new element node.

fn element_from_tag(tag: &str) -> SsrNode

Create a new element node from a tag string.

fn text_node(text: &str) -> SsrNode

Create a new text node.

fn marker_with_text(text: &str) -> SsrNode

Create a marker (dummy) node with text content. For empty marker, prefer [GenericNode::marker] instead.

fn set_attribute(&self, name: &str, value: &str)

Sets an attribute on a node.

fn remove_attribute(&self, name: &str)

Removes an attribute on a node.

fn set_class_name(&self, value: &str)

Sets the class attribute on a node. This should have the same outcome as calling set_attribute("class", value). For DomNode, this sets the className property directly which is about 2x faster (on Chrome).

fn add_class(&self, class: &str)

Add a class to the element. If multiple classes are specified, delimited by spaces, all the classes should be added. Any classes that are already present should not be added a second time.

fn remove_class(&self, class: &str)

Remove a class from the element.

fn set_property(&self, _name: &str, _value: &JsValue)

Sets a property on a node.

fn remove_property(&self, _name: &str)

Removes a property on a node.

fn append_child(&self, child: &SsrNode)

Appends a child to the node’s children.

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

Get the first child of the node.

fn insert_child_before(
    &self,
    new_node: &SsrNode,
    reference_node: Option<&SsrNode>
)

Insert a new child node to this node’s children. If reference_node is Some, the child will be inserted before the reference node. Else if None, the child will be inserted at the end.

fn remove_child(&self, child: &SsrNode)

Remove a child node from this node’s children.

fn replace_child(&self, old: &SsrNode, new: &SsrNode)

Replace a child node from this node’s children with a new child node.

fn insert_sibling_before(&self, child: &SsrNode)

Insert a new node before this node.

fn parent_node(&self) -> Option<SsrNode>

Returns the parent node, or None if detached.

fn next_sibling(&self) -> Option<SsrNode>

Returns the next sibling, or None if this node is the last sibling.

fn remove_self(&self)

Remove this node from the tree.

fn event<'a, F>(&self, _cx: BoundedScope<'a, 'a>, _name: &str, _handler: F)where
    F: 'a + FnMut(<SsrNode as GenericNode>::EventType),

Add a event handler to the event name. The event should be removed once the scope is disposed, as to prevent accessing scope variables after the scope is disposed.

fn update_inner_text(&self, text: &str)

Update inner text of the node. If the node has elements, all the elements are replaced with a new text node.

fn dangerously_set_inner_html(&self, html: &str)

Updates the inner html of the node. The html will not be parsed in non-browser environments. This means that accessing methods such as first_child will return None.

fn clone_node(&self) -> SsrNode

Create a deep clone of the node.

const CLIENT_SIDE_HYDRATION: bool = false

Whether this rendering backend hydrates nodes on the client side.

fn text_node_int(int: i32) -> Self

Create a new text node from an integer.

fn marker() -> Self

Create a marker (dummy) node. For DomNode, this is implemented by creating an empty comment node. This is used, for example, in Keyed and Indexed for scenarios where you want to push a new item to the end of the list. If the list is empty, a dummy node is needed to store the position of the component.

impl Hash for SsrNode

fn hash<H>(&self, state: &mut H)where
    H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where
    H: Hasher,
    Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Html for SsrNode

const IS_BROWSER: bool = false

A boolean indicating whether this node is rendered in a browser context.

fn to_web_sys(&self) -> Node

Convert this node into a raw [web_sys::Node].

impl PartialEq<SsrNode> for SsrNode

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

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for SsrNode