fix: correct migration guide clone pattern and update changelog (#4068)

Madoshakalaka · web-flow · commit 32fcd328bf01 · 2026-03-10T23:23:48.000+09:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,19 +4,24 @@
 
 bumping from 0.22 should require no code changes for most users.
 
-### 🛠 Fixes
+### 🚨 Breaking changes
 
-- No more broken child re-renders while setting parent's states. [[@Siyuan Yan](https://github.com/Madoshakalaka), [#4060](https://github.com/yewstack/yew/pull/4060)]
-- Ergonomics: Bare `None`s are now allowed for `Option<T>` props in the `html!` macro. [[@Siyuan Yan](https://github.com/Madoshakalaka), [#4021](https://github.com/yewstack/yew/pull/4021)]
+- Performance: use_reducer now skips re-rendering for the same Rc. [[@Pascal Sommer](https://github.com/Pascal-So), [#3945](https://github.com/yewstack/yew/pull/3945)]
+    NOTE: Whether this is breaking is arguable. It merely breaks the promise that a dispatch will always cause a re-render. For code that wishes to force re-render, [use_force_update](https://docs.rs/yew/latest/yew/functional/fn.use_force_update.html) helps. Please refer to [the migration guide](https://yew.rs/docs/next/migration-guides/yew/from-0_22_0-to-0_23_0) for details.
 
 ### ⚡️ Features
 
-- `&str` and `String` can now be used for prop types of `Option<Html>`. [[@Cashew](https://github.com/Casheeew), [#4020](https://github.com/yewstack/yew/pull/4020)]
+- `&str` and `String` can now be used for props of type `Option<Html>`. [[@Cashew](https://github.com/Casheeew), [#4020](https://github.com/yewstack/yew/pull/4020)]
+- Added a `scheduler::flush` function to reliably finish rendering. Useful in testing as a replacement for timeouts. [[@Siyuan Yan](https://github.com/Madoshakalaka), [#4044](https://github.com/yewstack/yew/pull/4044)]
 
-### 🚨 Breaking changes
+### 🛠 Fixes
 
-- Performance: use_reducer now skips re-rendering for the same Rc. [[@Pascal Sommer](https://github.com/Pascal-So), [#3945](https://github.com/yewstack/yew/pull/3945)]
-    NOTE: Whether this is breaking is arguable. It merely breaks the promise that a dispatch will always cause a re-render. For code that wishes to force re-render, [use_force_update](https://docs.rs/yew/latest/yew/functional/fn.use_force_update.html) helps.
+- No more broken child re-renders while setting parents' states. [[@Siyuan Yan](https://github.com/Madoshakalaka), [#4060](https://github.com/yewstack/yew/pull/4060)]
+- Ergonomics: Bare `None`s are now allowed for `Option<T>` props in the `html!` macro. [[@Siyuan Yan](https://github.com/Madoshakalaka), [#4021](https://github.com/yewstack/yew/pull/4021)]
+
+### ⚙️ Improvements
+
+- Yew's scheduler now yields to the main thread from time to time. This fix will make the web page more responsive and reduce warnings about long tasks in the console. [[@Siyuan Yan](https://github.com/Madoshakalaka), [#4033](https://github.com/yewstack/yew/pull/4033)]
 
 ## ✨ yew-router **0.20.0** *(2026-03-10)*
 
diff --git a/website/docs/migration-guides/yew/from-0_22_0-to-0_23_0.mdx b/website/docs/migration-guides/yew/from-0_22_0-to-0_23_0.mdx
@@ -15,9 +15,6 @@ If your reducer has a code path that returns `self` unchanged and you relied on
   <TabItem value="before" label="Before" default>
 
 ```rust ,ignore
-use std::rc::Rc;
-use yew::prelude::*;
-
 pub enum Action {
     Increment,
     ForceRefresh,
@@ -50,8 +47,15 @@ pub fn App() -> Html {
     html! {
         <div>
             <p>{ state.count }</p>
-            <button onclick={move |_| state.dispatch(Action::Increment)}>{ "+1" }</button>
-            <button onclick={move |_| state.dispatch(Action::ForceRefresh)}>{ "Refresh" }</button>
+            <button onclick={
+                let state = state.clone();
+                move |_| state.dispatch(Action::Increment)
+            }>
+                { "+1" }
+            </button>
+            <button onclick={move |_| state.dispatch(Action::ForceRefresh)}>
+                { "Refresh" }
+            </button>
         </div>
     }
 }
@@ -61,9 +65,6 @@ pub fn App() -> Html {
   <TabItem value="after" label="After">
 
 ```rust ,ignore
-use std::rc::Rc;
-use yew::prelude::*;
-
 pub enum Action {
     Increment,
 }
diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/current/migration-guides/yew/from-0_22_0-to-0_23_0.mdx b/website/i18n/ja/docusaurus-plugin-content-docs/current/migration-guides/yew/from-0_22_0-to-0_23_0.mdx
@@ -15,9 +15,6 @@ import TabItem from '@theme/TabItem'
   <TabItem value="before" label="変更前" default>
 
 ```rust ,ignore
-use std::rc::Rc;
-use yew::prelude::*;
-
 pub enum Action {
     Increment,
     ForceRefresh,
@@ -50,8 +47,15 @@ pub fn App() -> Html {
     html! {
         <div>
             <p>{ state.count }</p>
-            <button onclick={move |_| state.dispatch(Action::Increment)}>{ "+1" }</button>
-            <button onclick={move |_| state.dispatch(Action::ForceRefresh)}>{ "リフレッシュ" }</button>
+            <button onclick={
+                let state = state.clone();
+                move |_| state.dispatch(Action::Increment)
+            }>
+                { "+1" }
+            </button>
+            <button onclick={move |_| state.dispatch(Action::ForceRefresh)}>
+                { "リフレッシュ" }
+            </button>
         </div>
     }
 }
@@ -61,9 +65,6 @@ pub fn App() -> Html {
   <TabItem value="after" label="変更後">
 
 ```rust ,ignore
-use std::rc::Rc;
-use yew::prelude::*;
-
 pub enum Action {
     Increment,
 }
diff --git a/website/i18n/ja/docusaurus-plugin-content-docs/version-0.23/migration-guides/yew/from-0_22_0-to-0_23_0.mdx b/website/i18n/ja/docusaurus-plugin-content-docs/version-0.23/migration-guides/yew/from-0_22_0-to-0_23_0.mdx
@@ -15,9 +15,6 @@ import TabItem from '@theme/TabItem'
   <TabItem value="before" label="変更前" default>
 
 ```rust ,ignore
-use std::rc::Rc;
-use yew::prelude::*;
-
 pub enum Action {
     Increment,
     ForceRefresh,
@@ -50,8 +47,15 @@ pub fn App() -> Html {
     html! {
         <div>
             <p>{ state.count }</p>
-            <button onclick={move |_| state.dispatch(Action::Increment)}>{ "+1" }</button>
-            <button onclick={move |_| state.dispatch(Action::ForceRefresh)}>{ "リフレッシュ" }</button>
+            <button onclick={
+                let state = state.clone();
+                move |_| state.dispatch(Action::Increment)
+            }>
+                { "+1" }
+            </button>
+            <button onclick={move |_| state.dispatch(Action::ForceRefresh)}>
+                { "リフレッシュ" }
+            </button>
         </div>
     }
 }
@@ -61,9 +65,6 @@ pub fn App() -> Html {
   <TabItem value="after" label="変更後">
 
 ```rust ,ignore
-use std::rc::Rc;
-use yew::prelude::*;
-
 pub enum Action {
     Increment,
 }
diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/migration-guides/yew/from-0_22_0-to-0_23_0.mdx b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/migration-guides/yew/from-0_22_0-to-0_23_0.mdx
@@ -15,9 +15,6 @@ import TabItem from '@theme/TabItem'
   <TabItem value="before" label="之前" default>
 
 ```rust ,ignore
-use std::rc::Rc;
-use yew::prelude::*;
-
 pub enum Action {
     Increment,
     ForceRefresh,
@@ -50,8 +47,15 @@ pub fn App() -> Html {
     html! {
         <div>
             <p>{ state.count }</p>
-            <button onclick={move |_| state.dispatch(Action::Increment)}>{ "+1" }</button>
-            <button onclick={move |_| state.dispatch(Action::ForceRefresh)}>{ "刷新" }</button>
+            <button onclick={
+                let state = state.clone();
+                move |_| state.dispatch(Action::Increment)
+            }>
+                { "+1" }
+            </button>
+            <button onclick={move |_| state.dispatch(Action::ForceRefresh)}>
+                { "刷新" }
+            </button>
         </div>
     }
 }
@@ -61,9 +65,6 @@ pub fn App() -> Html {
   <TabItem value="after" label="之后">
 
 ```rust ,ignore
-use std::rc::Rc;
-use yew::prelude::*;
-
 pub enum Action {
     Increment,
 }
diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/version-0.23/migration-guides/yew/from-0_22_0-to-0_23_0.mdx b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/version-0.23/migration-guides/yew/from-0_22_0-to-0_23_0.mdx
@@ -15,9 +15,6 @@ import TabItem from '@theme/TabItem'
   <TabItem value="before" label="之前" default>
 
 ```rust ,ignore
-use std::rc::Rc;
-use yew::prelude::*;
-
 pub enum Action {
     Increment,
     ForceRefresh,
@@ -50,8 +47,15 @@ pub fn App() -> Html {
     html! {
         <div>
             <p>{ state.count }</p>
-            <button onclick={move |_| state.dispatch(Action::Increment)}>{ "+1" }</button>
-            <button onclick={move |_| state.dispatch(Action::ForceRefresh)}>{ "刷新" }</button>
+            <button onclick={
+                let state = state.clone();
+                move |_| state.dispatch(Action::Increment)
+            }>
+                { "+1" }
+            </button>
+            <button onclick={move |_| state.dispatch(Action::ForceRefresh)}>
+                { "刷新" }
+            </button>
         </div>
     }
 }
@@ -61,9 +65,6 @@ pub fn App() -> Html {
   <TabItem value="after" label="之后">
 
 ```rust ,ignore
-use std::rc::Rc;
-use yew::prelude::*;
-
 pub enum Action {
     Increment,
 }
diff --git a/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/migration-guides/yew/from-0_22_0-to-0_23_0.mdx b/website/i18n/zh-Hant/docusaurus-plugin-content-docs/current/migration-guides/yew/from-0_22_0-to-0_23_0.mdx
@@ -15,9 +15,6 @@ import TabItem from '@theme/TabItem'
   <TabItem value="before" label="之前" default>
 
 ```rust ,ignore
-use std::rc::Rc;
-use yew::prelude::*;
-
 pub enum Action {
     Increment,
     ForceRefresh,
@@ -50,8 +47,15 @@ pub fn App() -> Html {
     html! {
         <div>
             <p>{ state.count }</p>
-            <button onclick={move |_| state.dispatch(Action::Increment)}>{ "+1" }</button>
-            <button onclick={move |_| state.dispatch(Action::ForceRefresh)}>{ "重新整理" }</button>
+            <button onclick={
+                let state = state.clone();
+                move |_| state.dispatch(Action::Increment)
+            }>
+                { "+1" }
+            </button>
+            <button onclick={move |_| state.dispatch(Action::ForceRefresh)}>
+                { "重新整理" }
+            </button>
         </div>
     }
 }
@@ -61,9 +65,6 @@ pub fn App() -> Html {
   <TabItem value="after" label="之後">
 
 ```rust ,ignore
-use std::rc::Rc;
-use yew::prelude::*;
-
 pub enum Action {
     Increment,
 }
diff --git a/website/i18n/zh-Hant/docusaurus-plugin-content-docs/version-0.23/migration-guides/yew/from-0_22_0-to-0_23_0.mdx b/website/i18n/zh-Hant/docusaurus-plugin-content-docs/version-0.23/migration-guides/yew/from-0_22_0-to-0_23_0.mdx
@@ -15,9 +15,6 @@ import TabItem from '@theme/TabItem'
   <TabItem value="before" label="之前" default>
 
 ```rust ,ignore
-use std::rc::Rc;
-use yew::prelude::*;
-
 pub enum Action {
     Increment,
     ForceRefresh,
@@ -50,8 +47,15 @@ pub fn App() -> Html {
     html! {
         <div>
             <p>{ state.count }</p>
-            <button onclick={move |_| state.dispatch(Action::Increment)}>{ "+1" }</button>
-            <button onclick={move |_| state.dispatch(Action::ForceRefresh)}>{ "重新整理" }</button>
+            <button onclick={
+                let state = state.clone();
+                move |_| state.dispatch(Action::Increment)
+            }>
+                { "+1" }
+            </button>
+            <button onclick={move |_| state.dispatch(Action::ForceRefresh)}>
+                { "重新整理" }
+            </button>
         </div>
     }
 }
@@ -61,9 +65,6 @@ pub fn App() -> Html {
   <TabItem value="after" label="之後">
 
 ```rust ,ignore
-use std::rc::Rc;
-use yew::prelude::*;
-
 pub enum Action {
     Increment,
 }
diff --git a/website/versioned_docs/version-0.23/migration-guides/yew/from-0_22_0-to-0_23_0.mdx b/website/versioned_docs/version-0.23/migration-guides/yew/from-0_22_0-to-0_23_0.mdx
@@ -15,9 +15,6 @@ If your reducer has a code path that returns `self` unchanged and you relied on
   <TabItem value="before" label="Before" default>
 
 ```rust ,ignore
-use std::rc::Rc;
-use yew::prelude::*;
-
 pub enum Action {
     Increment,
     ForceRefresh,
@@ -50,8 +47,15 @@ pub fn App() -> Html {
     html! {
         <div>
             <p>{ state.count }</p>
-            <button onclick={move |_| state.dispatch(Action::Increment)}>{ "+1" }</button>
-            <button onclick={move |_| state.dispatch(Action::ForceRefresh)}>{ "Refresh" }</button>
+            <button onclick={
+                let state = state.clone();
+                move |_| state.dispatch(Action::Increment)
+            }>
+                { "+1" }
+            </button>
+            <button onclick={move |_| state.dispatch(Action::ForceRefresh)}>
+                { "Refresh" }
+            </button>
         </div>
     }
 }
@@ -61,9 +65,6 @@ pub fn App() -> Html {
   <TabItem value="after" label="After">
 
 ```rust ,ignore
-use std::rc::Rc;
-use yew::prelude::*;
-
 pub enum Action {
     Increment,
 }
