Add a Html::to_web_sys method (#490)

Add a Html::to_web_sys method

BREAKING: This is technically a breaking change but is minor enough that it doesn't warrant a major release.

packages/sycamore-web/src/dom_node.rs

@@ -353,6 +353,10 @@ impl GenericNode for DomNode {
 
 impl Html for DomNode {
     const IS_BROWSER: bool = true;
+
+    fn to_web_sys(&self) -> web_sys::Node {
+        self.inner_element()
+    }
 }
 
 /// Render a [`View`] into the DOM.

packages/sycamore-web/src/hydrate_node.rs

@@ -276,6 +276,10 @@ impl GenericNode for HydrateNode {
 
 impl Html for HydrateNode {
     const IS_BROWSER: bool = true;
+
+    fn to_web_sys(&self) -> web_sys::Node {
+        self.inner_element()
+    }
 }
 
 /// Render a [`View`] under a `parent` node by reusing existing nodes (client side

packages/sycamore-web/src/lib.rs

@@ -37,6 +37,12 @@ pub trait Html: GenericNode<EventType = Event, PropertyType = JsValue> {
     /// A value of `false` does not necessarily mean that it is not being rendered in WASM or even
     /// in the browser. It only means that it does not create DOM nodes.
     const IS_BROWSER: bool;
+
+    /// Convert this node into a raw [`web_sys::Node`].
+    ///
+    /// For certain backends, this is not possible (e.g. [`SsrNode`]). In that case, calling this
+    /// will panic at runtime.
+    fn to_web_sys(&self) -> web_sys::Node;
 }
 
 /// Create a generic `Html` node from a `web_sys::Node`.

packages/sycamore-web/src/ssr_node.rs

@@ -351,6 +351,10 @@ impl GenericNode for SsrNode {
 
 impl Html for SsrNode {
     const IS_BROWSER: bool = false;
+
+    fn to_web_sys(&self) -> web_sys::Node {
+        panic!("SsrNode cannot be converted into web_sys::Node");
+    }
 }
 
 /// Write the [`SsrNode`] to a string buffer.