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
use std::{cell::RefCell, future::Future};
use crate::prelude::Render;
pub trait GenericNode: std::fmt::Debug + Clone + PartialEq + std::cmp::Eq + 'static {
/// Create a new element node.
fn element(tag: &str) -> Self;
/// Create a new text node.
fn text_node(text: &str) -> Self;
/// Create a new fragment (list of nodes). A fragment is not necessarily wrapped around by an element.
fn fragment() -> 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.
fn marker() -> Self;
/// Sets an attribute on a node.
fn set_attribute(&self, name: &str, value: &str);
/// Appends a child to the node's children.
fn append_child(&self, child: &Self);
/// 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 insert_child_before(&self, new_node: &Self, reference_node: Option<&Self>);
/// Remove a child node from this node's children.
fn remove_child(&self, child: &Self);
/// Replace a child node from this node's children with a new child node.
fn replace_child(&self, old: &Self, new: &Self);
/// Insert a new node before this node.
fn insert_sibling_before(&self, child: &Self);
/// Returns the parent node, or `None` if detached.
fn parent_node(&self) -> Option<Self>;
/// Returns the next sibling, or `None` if this node is the last sibling.
fn next_sibling(&self) -> Option<Self>;
/// Remove this node from the tree.
fn remove_self(&self);
/// Update inner text of the node. If the node has elements, all the elements are replaced with a new text node.
fn update_inner_text(&self, text: &str);
/// Replace all the children in a node with a new node
fn replace_children_with(&self, node: &Self);
fn effect(&self, future: impl Future<Output = ()> + 'static);
fn children(&self) -> RefCell<Vec<Self>>;
fn append_render(&self, render: impl Render<Self> + 'static) {
Box::new(render).render_into(self).unwrap();
}
}
pub trait EventListener {
type Handler;
fn event(&self, name: &str, handler: Self::Handler);
}
/// Allows you to acquire a node during template processing
pub trait NodeReference {
type Target;
fn try_get(&self) -> Option<Self::Target>;
fn set(&self, node: Self::Target);
}