Reset zoom level on component unmount by Infinite-Null · Pull Request #69087 · WordPress/gutenberg

Infinite-Null · 2025-02-07T07:00:23Z

What?

Reset zoom level when editor component unmounts to prevent stale zoom states.

Why?

The zoom state and button remained active after responsive changes, causing inconsistency between the visual zoom effect and the button state. This led to a confusing user experience in which the zoom button appeared pressed, but no zoom effect was visible.

How?

Added a cleanup effect in the ZoomOutToggle component that calls resetZoomLevel when the component unmounts. This ensures the zoom state is properly reset between editor sessions and responsive changes.

Testing Instructions

Open the WordPress site editor
Click the zoom-out button
Resize browser window to a smaller width
Resize browser window back to larger width
Verify the zoom state and button are in sync

Screencast

Screen.Recording.2025-02-07.at.12.27.40.PM.mov

github-actions · 2025-02-07T07:00:38Z

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: Infinite-Null <ankitkumarshah@git.wordpress.org>
Co-authored-by: Mamaduka <mamaduka@git.wordpress.org>
Co-authored-by: t-hamano <wildworks@git.wordpress.org>
Co-authored-by: annezazu <annezazu@git.wordpress.org>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

Mamaduka · 2025-02-07T08:35:24Z

Do you know what part of the code disables zoomout mode for smaller screens?

Controlling a global state-based component's mounted state is tricky and usually causes more bugs. This bug probably has a different root cause; I suggest finding it and fixing the issue there.

Infinite-Null · 2025-02-07T09:10:44Z

Sure @Mamaduka, I’ll check what disables zoom-out on smaller screens and find the root cause.

Infinite-Null · 2025-02-12T05:34:10Z

Hi @Mamaduka,
I was able to find the root cause and updated my PR. While doing research I found an issue:

The useLayoutEffect hook is triggered when the viewport width is at or above 782px. However, the condition:

const isMediumOrBigger = window.matchMedia('(min-width: 782px)').matches;

does not return false when the viewport width gradually decreases to exactly 782px. This is because the (min-width: 782px) media query does not include 782px itself it applies only to widths greater than 782px.

As a result, when resizing the viewport slowly, the condition remains true even at 782px. However, when the viewport is resized quickly, bypassing the 782px threshold, the condition updates correctly and evaluates to false as expected.

A fix to this would be to change code like:

const isMediumOrBigger = window.matchMedia('(min-width: 783px)').matches;

Or

const isMediumOrBigger = window.width>=782;

Screencast:

Screen.Recording.2025-02-12.at.10.53.59.AM.mov

Should I open an issue about this also I am quite not sure which solution would be better.
I would love to hear your thoughts.

Mamaduka

Thanks for investigating this, @Infinite-Null!

I left a a couple of of notes, but unfortunately, I don't have time to test the proposed solution properly.

Pinging @WordPress/gutenberg-core in case someone has time to have a look.

Mamaduka · 2025-02-12T09:31:59Z

 	} = useDispatch( editorStore );
 	const { get: getPreference } = useSelect( preferencesStore );
 	const registry = useRegistry();
+	const { resetZoomLevel } = unlock( useDispatch( blockEditorStore ) );


The useDispatch( blockEditorStore ) is also defined above. Let's move and combine them in single call.

Mamaduka · 2025-02-12T09:32:50Z

 	const { get: getPreference } = useSelect( preferencesStore );
 	const registry = useRegistry();
+	const { resetZoomLevel } = unlock( useDispatch( blockEditorStore ) );
+	const { isZoomOut } = unlock( select( blockEditorStore ) );


The components shouldn't use global select it doesn't react to store changes.

Suggested change

const { isZoomOut } = unlock( select( blockEditorStore ) );

const { isZoomOut } = unlock( useSelect( blockEditorStore ) );

Infinite-Null · 2025-02-14T05:39:50Z

Hi @Mamaduka,
I have made the necessary changes please take a look at it at your convenience. Thank You!

t-hamano · 2025-02-17T12:21:16Z

Open the WordPress block editor

Click the zoom out button to activate zoom

Resize the browser window to a smaller width

Resize the browser window back to larger width

Observe that the zoom visual effect is lost but the button remains in a "pressed" state

I'm trying to reproduce this issue on the trunk branch (ce2a651), but for some reason I can't reproduce it.

Observe that the zoom visual effect is lost

Returning it to a wider width will restore the zoom out canvas correctly 🤔 Can you still reproduce this issue in your environment?

8d267d3f50f3ea45b90a09fe75b904b3.mp4

Infinite-Null · 2025-02-17T12:44:05Z

@t-hamano, Thank you for looking into the issue:
The issue is happening in the site editor. Here is a screencast:

Site Editor:

Screen.Recording.2025-02-17.at.6.08.07.PM.mov

Block Editor:

Screen.Recording.2025-02-17.at.6.08.41.PM.mov

Sorry for adding the following to the testing instructions:

1. Open the WordPress block editor

I have correctly updated the testing instructions in the PR description now!

t-hamano · 2025-02-17T15:43:38Z

After looking into this issue in detail, I found that this issue first occurred in #67481. This means that I believe that the useScaleCanvas hook is directly related to this issue.

Try changing the browser width with the zoom out mode enabled.

You should see that the value indicated by trigger here is different between the post editor and the site editor.

I haven't looked into it in detail yet, but I think that the fundamental solution would be to fix the useScaleCanvas() hook so that it works consistently and in the same way regardless of the editor.

Infinite-Null · 2025-02-18T09:41:35Z

Hi @t-hamano,
I further investigated the issue and found that the problem lies in how the Site Editor behaves differently from the Block Editor when crossing the 782px threshold.

As far as I understood, The trigger variable in this useEffect hook determines whether the effect should take effect or not. It helps ensure that the logic only runs when the isZoomedOut state actually changes.

In the Site Editor, when we resize the browser window to 782px breakpoint, the component unmounts and remounts. This doesn't happen in the Block Editor.

When looking at the useScaleCanvas() hook:

useEffect( () => {
		const trigger =
			iframeDocument && previousIsZoomedOut.current !== isZoomedOut;

		previousIsZoomedOut.current = isZoomedOut;

		if ( ! trigger ) {
			return;
		}

The logic in this hook is actually correct, but here's what happens:

When the Site Editor unmounts, all refs are reset
When it remounts:
- previousIsZoomedOut.current initializes to false
- Initially, trigger evaluates to undefined because iframeDocument isn't loaded yet
- previousIsZoomedOut.current is updated to match the zoom-out state here (which is true in this case) even though the trigger check fails
On subsequent renders:
- Both previousIsZoomedOut.current and isZoomedOut are true
- This makes previousIsZoomedOut.current !== isZoomedOut evaluate to false
- trigger becomes false because the values are the same
The effect has an early return when trigger is falsy (both when undefined initially and false later)
This prevents the animation and state synchronization logic from running

I am unable to find what is causing this mount and unmount in case of Site Editor.

Screencast:

If `trigger` is true in case of `Site Editor` which is correct:

Screen.Recording.2025-02-18.at.1.30.47.PM.mov

Mount and Un-Mount behaviour in block and site editor:

Screen.Recording.2025-02-18.at.1.36.05.PM.mov

Note: I have explicitly set trigger to true for debugging that's why issue seems to be fixed in the video.

Potential solution:

const trigger = iframeDocument &&
			( previousIsZoomedOut.current !== isZoomedOut ||
				( previousIsZoomedOut.current === true &&
					isZoomedOut === true ) );

We can add a check if both previousIsZoomedOut.current and isZoomedOut is true then also trigger the effect. But I am unsure of this solution.

Infinite-Null · 2025-02-18T13:58:01Z

I found the reason for the mounting and unmounting of the site editor. It is because if this particular condition . Rather than making changes for mounting and unmounting of site editor, I think adding condition would be the ideal choice here:

const trigger = iframeDocument &&
			( previousIsZoomedOut.current !== isZoomedOut ||
				( previousIsZoomedOut.current === true &&
					isZoomedOut === true ) );

I would really appreciate your opinion and help on this @t-hamano.

t-hamano · 2025-08-19T03:39:04Z

@Infinite-Null sorry for the late reply.

In my testing, the problem seems to be resolved in the latest Gutenberg. After resizing the browser width from a smaller width to a larger width, the zoom effect persists.

Can you also check on your side?

352506f103b41aa90253041d14bb7d24.mp4

Infinite-Null · 2026-05-20T15:53:27Z

Hi @t-hamano, I revisited this issue and was able to reproduce it successfully. I’ve attached a screencast for reference.

Steps to reproduce:

Go to Appearance → Editor → Templates and open any template.
Enable Zoom Out.
Resize the browser window to a smaller size, then resize it back to normal.

Screen.Recording.2026-05-20.at.9.11.07.PM.mov

FYI: I have also resolved the merge conflict for the PR.

t-hamano · 2026-05-21T09:28:57Z

@Infinite-Null Thanks, I was able to reproduce the issue in the site editor as well. My investigation suggests that the site editor uses different Editor instances for mobile and desktop use, and there's a bug in the logic of useScaleCanvas. Therefore, adding a new effect might not be the ideal approach. I believe we should maintain the zoom-out mode, similar to the post editor.

Wouldn't this change simply solve the problem?

diff --git a/packages/block-editor/src/components/iframe/use-scale-canvas.js b/packages/block-editor/src/components/iframe/use-scale-canvas.js
index 63b03e48924..01bb4e67831 100644
--- a/packages/block-editor/src/components/iframe/use-scale-canvas.js
+++ b/packages/block-editor/src/components/iframe/use-scale-canvas.js
@@ -312,8 +312,14 @@ export function useScaleCanvas( {
         * changes due to the container resizing.
         */
        useEffect( () => {
-               const trigger =
-                       iframeDocument && previousIsZoomedOut.current !== isZoomedOut;
+               // Wait for the iframe document so a zoom out state that is already
+               // active on mount (e.g. when the canvas is remounted on a viewport
+               // change) is still detected as a transition.
+               if ( ! iframeDocument ) {
+                       return;
+               }
+
+               const trigger = previousIsZoomedOut.current !== isZoomedOut;
 
                previousIsZoomedOut.current = isZoomedOut;

…in useAdaptEditorToCanvas

Infinite-Null · 2026-05-21T14:18:39Z

Hi @t-hamano, Thanks for the suggestion! I've applied the fix, and it correctly handles the case where the zoom-out state is already active on mount.

Here's a screencast:

Screen.Recording.2026-05-21.at.7.45.12.PM.mov

Please take a look when you get a chance!

t-hamano

LGTM! I believe this is the ideal approach.

Reset zoom level on component unmount

73e9e6f

Mamaduka added [Type] Bug An existing feature does not function as intended [Feature] Zoom Out labels Feb 7, 2025

Reset zoom level when viewport changes to desktop

f3b5029

Mamaduka reviewed Feb 12, 2025

View reviewed changes

Improve block editor store hooks organization

e8ce907

Infinite-Null requested a review from Mamaduka February 14, 2025 06:03

Infinite-Null added 2 commits May 20, 2026 21:20

Merge branch 'trunk' into fix/reset-zoom-unmount

d04935a

Fix: import comment

761ffb2

github-actions Bot added the [Package] Edit Site /packages/edit-site label May 20, 2026

Merge branch 'trunk' into fix/reset-zoom-unmount

6fe5791

Infinite-Null mentioned this pull request May 20, 2026

Zoom state and button remain active after responsive changes #69086

Closed

6 tasks

Infinite-Null added 2 commits May 21, 2026 19:32

Merge branch 'trunk' into fix/reset-zoom-unmount

46b8777

Fix zoom handling in useScaleCanvas and remove unused resetZoomLevel …

0f05233

…in useAdaptEditorToCanvas

Infinite-Null requested a review from ellatrix as a code owner May 21, 2026 14:14

github-actions Bot added [Package] Block editor /packages/block-editor and removed [Package] Edit Site /packages/edit-site labels May 21, 2026

t-hamano approved these changes May 23, 2026

View reviewed changes

t-hamano merged commit 63bcc8b into WordPress:trunk May 23, 2026
41 checks passed

github-actions Bot added this to the Gutenberg 23.3 milestone May 23, 2026

	const { isZoomOut } = unlock( select( blockEditorStore ) );
	const { isZoomOut } = unlock( useSelect( blockEditorStore ) );

Conversation

Infinite-Null commented Feb 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What?

Why?

How?

Testing Instructions

Screencast

Uh oh!

github-actions Bot commented Feb 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Mamaduka commented Feb 7, 2025

Uh oh!

Infinite-Null commented Feb 7, 2025

Uh oh!

Infinite-Null commented Feb 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Screencast:

Uh oh!

Mamaduka left a comment

Choose a reason for hiding this comment

Uh oh!

Mamaduka Feb 12, 2025

Choose a reason for hiding this comment

Uh oh!

Mamaduka Feb 12, 2025

Choose a reason for hiding this comment

Uh oh!

Infinite-Null commented Feb 14, 2025

Uh oh!

t-hamano commented Feb 17, 2025

Uh oh!

Infinite-Null commented Feb 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Site Editor:

Block Editor:

Uh oh!

t-hamano commented Feb 17, 2025

Uh oh!

Infinite-Null commented Feb 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Screencast:

If trigger is true in case of Site Editor which is correct:

Mount and Un-Mount behaviour in block and site editor:

Potential solution:

Uh oh!

Infinite-Null commented Feb 18, 2025

Uh oh!

t-hamano commented Aug 19, 2025

Uh oh!

Infinite-Null commented May 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

t-hamano commented May 21, 2026

Uh oh!

Infinite-Null commented May 21, 2026

Uh oh!

t-hamano left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Infinite-Null commented Feb 7, 2025 •

edited

Loading

github-actions Bot commented Feb 7, 2025 •

edited

Loading

Infinite-Null commented Feb 12, 2025 •

edited

Loading

Infinite-Null commented Feb 17, 2025 •

edited

Loading

Infinite-Null commented Feb 18, 2025 •

edited

Loading

If `trigger` is true in case of `Site Editor` which is correct:

Infinite-Null commented May 20, 2026 •

edited

Loading