Skip to content

Correct migration guide clone pattern and update changelog #4068

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Madoshakalaka merged 1 commit into from
Mar 10, 2026
Merged

Correct migration guide clone pattern and update changelog #4068

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 12 additions & 7 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)*

Expand Down
17 changes: 9 additions & 8 deletions website/docs/migration-guides/yew/from-0_22_0-to-0_23_0.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down Expand Up @@ -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>
}
}
Expand All @@ -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,
}
Expand Down
17 changes: 9 additions & 8 deletions ...urus-plugin-content-docs/current/migration-guides/yew/from-0_22_0-to-0_23_0.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down Expand Up @@ -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>
}
}
Expand All @@ -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,
}
Expand Down
17 changes: 9 additions & 8 deletions ...plugin-content-docs/version-0.23/migration-guides/yew/from-0_22_0-to-0_23_0.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down Expand Up @@ -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>
}
}
Expand All @@ -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,
}
Expand Down
17 changes: 9 additions & 8 deletions ...urus-plugin-content-docs/current/migration-guides/yew/from-0_22_0-to-0_23_0.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down Expand Up @@ -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>
}
}
Expand All @@ -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,
}
Expand Down
17 changes: 9 additions & 8 deletions ...plugin-content-docs/version-0.23/migration-guides/yew/from-0_22_0-to-0_23_0.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down Expand Up @@ -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>
}
}
Expand All @@ -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,
}
Expand Down
17 changes: 9 additions & 8 deletions ...urus-plugin-content-docs/current/migration-guides/yew/from-0_22_0-to-0_23_0.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down Expand Up @@ -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>
}
}
Expand All @@ -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,
}
Expand Down
17 changes: 9 additions & 8 deletions ...plugin-content-docs/version-0.23/migration-guides/yew/from-0_22_0-to-0_23_0.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down Expand Up @@ -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>
}
}
Expand All @@ -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,
}
Expand Down
17 changes: 9 additions & 8 deletions website/versioned_docs/version-0.23/migration-guides/yew/from-0_22_0-to-0_23_0.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down Expand Up @@ -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>
}
}
Expand All @@ -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,
}
Expand Down
Loading