yewstack · cecton · Jun 24, 2022 · Mar 3, 2022 · Mar 31, 2022 · Mar 31, 2022
diff --git a/Cargo.toml b/Cargo.toml
@@ -36,6 +36,7 @@ members = [
   "examples/web_worker_fib",
   "examples/ssr_router",
   "examples/suspense",
+  "examples/immutable",
 
   # Tools
   "tools/benchmark-struct",

diff --git a/examples/README.md b/examples/README.md
@@ -38,6 +38,7 @@ As an example, check out the TodoMVC example here: <https://examples.yew.rs/todo
 | [function_todomvc](function_todomvc)               | F  | Implementation of [TodoMVC](http://todomvc.com/) using function components and hooks.                                              |
 | [futures](futures)                                 | S  | Demonstrates how you can use futures and async code with Yew. Features a Markdown renderer.                                        |
 | [game_of_life](game_of_life)                       | S  | Implementation of [Conway's Game of Life](https://en.wikipedia.org/wiki/Conway%27s_Game_of_Life)                                   |
+| [immutable](immutable)                             | SF | Using immutable types in components.                                                                                               |
 | [inner_html](inner_html)                           | S  | Embeds an external document as raw HTML by manually managing the element                                                           |
 | [js_callback](js_callback)                         | F  | Interacts with JavaScript code                                                                                                     |
 | [keyed_list](keyed_list)                           | S  | Demonstrates how to use keys to improve the performance of lists                                                                   |

diff --git a/examples/immutable/Cargo.toml b/examples/immutable/Cargo.toml
@@ -0,0 +1,12 @@
+[package]
+name = "immutable"
+version = "0.1.0"
+edition = "2021"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[dependencies]
+implicit-clone = { version = "0.2", features = ["map"] }
+wasm-bindgen = "0.2"
+web-sys = "0.3"
+yew = { path = "../../packages/yew", features = ["csr"] }
diff --git a/examples/immutable/README.md b/examples/immutable/README.md
@@ -0,0 +1,5 @@
+# Immutable Example
+
+[![Demo](https://img.shields.io/website?label=demo&url=https%3A%2F%2Fexamples.yew.rs%2Fimmutable)](https://examples.yew.rs/immutable)
+
+This is a technical demonstration for how to use immutables types in Yew.
diff --git a/examples/immutable/index.html b/examples/immutable/index.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+  <meta charset="utf-8" />
+  <title>Yew • Immutable</title>
+  <link data-trunk rel="scss" href="index.scss"/>
+  <link href="https://fonts.googleapis.com/css2?family=Roboto:wght@900&display=swap" rel="stylesheet">
+</head>
+
+<body></body>
+
+</html>
diff --git a/examples/immutable/index.scss b/examples/immutable/index.scss
@@ -0,0 +1,11 @@
+$font-stack:    Roboto, sans-serif;
+$primary-color: #f5f5f5;
+
+body {
+    font: 100% $font-stack;
+    color: black;
+    background-color: $primary-color;
+    margin: 0 auto;
+    min-width: 230px;
+    max-width: 550px;
+}
diff --git a/examples/immutable/src/array.rs b/examples/immutable/src/array.rs
@@ -0,0 +1,54 @@
+use implicit_clone::unsync::*;
+use wasm_bindgen::{JsCast, UnwrapThrowExt};
+use web_sys::{HtmlInputElement, KeyboardEvent};
+use yew::prelude::*;
+
+#[derive(Properties, PartialEq)]
+struct FolksViewProps {
+    folks: IArray<IString>,
+}
+
+#[function_component(FolksView)]
+fn folks_view(props: &FolksViewProps) -> Html {
+    html! {
+        <>
+        <p>{"Hello to:"}</p>
+        <ul>
+        { for props.folks.iter().map(|s| html!(<li>{s}</li>)) }
+        </ul>
+        </>
+    }
+}
+
+#[function_component(ArrayExample)]
+pub fn array_example() -> Html {
+    let folks = use_state(IArray::<IString>::default);
+    let onkeyup = {
+        let folks = folks.clone();
+        Callback::from(move |e: KeyboardEvent| {
+            if e.key() == "Enter" {
+                let event: Event = e.dyn_into().unwrap_throw();
+                let event_target = event.target().unwrap_throw();
+                let target: HtmlInputElement = event_target.dyn_into().unwrap_throw();
+                let name = target.value();
+                target.set_value("");
+
+                folks.set(
+                    folks
+                        .iter()
+                        .chain(std::iter::once(IString::from(name)))
+                        .collect(),
+                );
+            }
+        })
+    };
+
+    html! {
+        <>
+        <h2>{"Input"}</h2>
+        <input {onkeyup} />
+        <h2>{"Output"}</h2>
+        <FolksView folks={&*folks} />
+        </>
+    }
+}
diff --git a/examples/immutable/src/main.rs b/examples/immutable/src/main.rs
@@ -0,0 +1,29 @@
+mod array;
+mod map;
+mod string;
+
+use yew::prelude::*;
+
+use self::array::*;
+use self::map::*;
+use self::string::*;
+
+#[function_component]
+fn App() -> Html {
+    html! {
+        <>
+            <h1>{ "IString Example" }</h1>
+            <StringExample />
+            <hr/>
+            <h1>{ "IArray Example" }</h1>
+            <ArrayExample />
+            <hr/>
+            <h1>{ "IMap Example" }</h1>
+            <MapExample />
+        </>
+    }
+}
+
+fn main() {
+    yew::Renderer::<App>::new().render();
+}
diff --git a/examples/immutable/src/map.rs b/examples/immutable/src/map.rs
@@ -0,0 +1,83 @@
+use implicit_clone::unsync::*;
+use wasm_bindgen::{JsCast, UnwrapThrowExt};
+use web_sys::{HtmlInputElement, KeyboardEvent};
+use yew::prelude::*;
+
+#[derive(Properties, PartialEq)]
+struct DisplayProps {
+    values: IMap<u32, IString>,
+}
+
+#[function_component]
+fn Display(props: &DisplayProps) -> Html {
+    html! {
+        <>
+        <p>{"Hello to:"}</p>
+        <ul>
+        { for props.values.iter().map(|(i, s)| html!(<li>{i}{" => "}{s}</li>)) }
+        </ul>
+        </>
+    }
+}
+
+pub struct MapExample {
+    values: IMap<u32, IString>,
+}
+
+pub enum MapExampleMessage {
+    AddName(String),
+    Noop,
+}
+
+impl Component for MapExample {
+    type Message = MapExampleMessage;
+    type Properties = ();
+
+    fn create(_ctx: &Context<Self>) -> Self {
+        Self {
+            values: Default::default(),
+        }
+    }
+
+    fn update(&mut self, _: &Context<Self>, msg: Self::Message) -> bool {
+        match msg {
+            MapExampleMessage::AddName(name) => {
+                self.values = self
+                    .values
+                    .iter()
+                    .chain(std::iter::once((
+                        self.values.len() as u32,
+                        IString::from(name),
+                    )))
+                    .collect();
+                true
+            }
+            MapExampleMessage::Noop => false,
+        }
+    }
+
+    fn view(&self, ctx: &Context<Self>) -> Html {
+        let link = ctx.link();
+        let onkeyup = link.callback(|e: KeyboardEvent| {
+            if e.key() == "Enter" {
+                let event: Event = e.dyn_into().unwrap_throw();
+                let event_target = event.target().unwrap_throw();
+                let target: HtmlInputElement = event_target.dyn_into().unwrap_throw();
+                let value = target.value();
+                target.set_value("");
+                MapExampleMessage::AddName(value)
+            } else {
+                MapExampleMessage::Noop
+            }
+        });
+
+        html! {
+            <>
+            <h2>{"Input"}</h2>
+            <input {onkeyup} />
+            <h2>{"Output"}</h2>
+            <Display values={&self.values} />
+            </>
+        }
+    }
+}
diff --git a/examples/immutable/src/string.rs b/examples/immutable/src/string.rs
@@ -0,0 +1,63 @@
+use implicit_clone::unsync::*;
+use wasm_bindgen::{JsCast, UnwrapThrowExt};
+use web_sys::{HtmlInputElement, InputEvent};
+use yew::prelude::*;
+
+#[derive(Properties, PartialEq)]
+struct DisplayProps {
+    name: IString,
+}
+
+#[function_component]
+fn Display(props: &DisplayProps) -> Html {
+    html! {
+        <p>{"Hello "}{&props.name}{"!"}</p>
+    }
+}
+
+pub struct StringExample {
+    name: IString,
+}
+
+pub enum StringExampleMessage {
+    UpdateName(String),
+}
+
+impl Component for StringExample {
+    type Message = StringExampleMessage;
+    type Properties = ();
+
+    fn create(_ctx: &Context<Self>) -> Self {
+        Self {
+            name: "World".into(),
+        }
+    }
+
+    fn update(&mut self, _: &Context<Self>, msg: Self::Message) -> bool {
+        match msg {
+            StringExampleMessage::UpdateName(name) => {
+                self.name = name.into();
+                true
+            }
+        }
+    }
+
+    fn view(&self, ctx: &Context<Self>) -> Html {
+        let link = ctx.link();
+        let oninput = link.callback(|e: InputEvent| {
+            let event: Event = e.dyn_into().unwrap_throw();
+            let event_target = event.target().unwrap_throw();
+            let target: HtmlInputElement = event_target.dyn_into().unwrap_throw();
+            StringExampleMessage::UpdateName(target.value())
+        });
+
+        html! {
+            <>
+            <h2>{"Input"}</h2>
+            <input value={&self.name} {oninput} />
+            <h2>{"Output"}</h2>
+            <Display name={&self.name} />
+            </>
+        }
+    }
+}
diff --git a/packages/yew-macro/tests/html_macro/component-fail.stderr b/packages/yew-macro/tests/html_macro/component-fail.stderr
@@ -345,11 +345,11 @@ error[E0277]: the trait bound `{integer}: IntoPropValue<String>` is not satisfie
    |                                 ^ the trait `IntoPropValue<String>` is not implemented for `{integer}`
    |
    = help: the following implementations were found:
-             <&'static str as IntoPropValue<AttrValue>>
+             <&'static [(K, V)] as IntoPropValue<implicit_clone::unsync::IMap<K, V>>>
+             <&'static [T] as IntoPropValue<implicit_clone::unsync::IArray<T>>>
              <&'static str as IntoPropValue<Classes>>
-             <&'static str as IntoPropValue<Option<AttrValue>>>
              <&'static str as IntoPropValue<Option<String>>>
-           and 18 others
+           and 22 others
 
 error[E0277]: the trait bound `{integer}: IntoPropValue<String>` is not satisfied
   --> tests/html_macro/component-fail.rs:79:34
@@ -358,11 +358,11 @@ error[E0277]: the trait bound `{integer}: IntoPropValue<String>` is not satisfie
    |                                  ^ the trait `IntoPropValue<String>` is not implemented for `{integer}`
    |
    = help: the following implementations were found:
-             <&'static str as IntoPropValue<AttrValue>>
+             <&'static [(K, V)] as IntoPropValue<implicit_clone::unsync::IMap<K, V>>>
+             <&'static [T] as IntoPropValue<implicit_clone::unsync::IArray<T>>>
              <&'static str as IntoPropValue<Classes>>
-             <&'static str as IntoPropValue<Option<AttrValue>>>
              <&'static str as IntoPropValue<Option<String>>>
-           and 18 others
+           and 22 others
 
 error[E0308]: mismatched types
   --> tests/html_macro/component-fail.rs:80:31