Transform Page list to navigation block

[benazeer-ben]

What?

Fixes #44458

Why?

Currently Page list block has no transform option for navigation block.

How?

Added navigation block transform to Page list block.

Testing Instructions

• Go to WP admin dashboard.
• Edit/create any post/page.
• Create a Page List Block
• Try to transform it to a navigation block.

Screenshots or screencast

Screenshare.-.2025-02-10.5_17_58.PM.mp4

[github-actions]

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: benazeer-ben <[email protected]>
Co-authored-by: t-hamano <[email protected]>
Co-authored-by: carolinan <[email protected]>

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

[carolinan]

I like this a lot.
I was expecting the page list block to be placed inside the navigation block, and not individual pages.
But I don't feel strongly about it.

[carolinan]

When a page has no title, the page list block displays the text "(no title)" but the transformed list block has the link to the page without a link text. It is not apparent that there is a page link there unless I open the code editor.
The navigation block shows "Add label".

[t-hamano]

Thanks for the PR!

Both transformations are complex, so I recommend splitting this PR first.

The transformation to the List block is probably easier.

The transformation to the Navigation block is quite complex. When transforming from the Page List block to the Navigation block, we would expect to create one new navigation. But this PR creates two new navigations in draft status:

cfe120064d05b026cf8cb195b319fb66.mp4

Perhaps simply running createBlock is not enough.

As of now, I'm still not sure what the best approach is, but I would recommend clarifying the specs for the Navigation block and getting feedback from contributors who know more about it before writing any code.

[benazeer-ben]

@t-hamano Thanks for the review! Splitting the PR makes sense, and I'll start by focusing on the transformation to the List block first.

For the Navigation block issue, I see the problem with multiple draft navigations being created. I'll investigate why createBlock is behaving this way and whether additional handling is needed.

Let me know if you have any specific suggestions or references that might help! 🚀

More suggestions are welcome from other contributors too.

[benazeer-ben]

Hi @carolinan , @t-hamano

As per the above comments, I have split it into separate PRs—one for navigation and another for the list.

This is the PR for transform to navigation block. I have updated description also.

Now, I will work on the above mentioned issues for navigation transform.

[benazeer-ben]

Hi @t-hamano

Thanks for your review and suggestion!

When I transform to navigation, only one menu is being created if I am not mistaken. I’m attaching a reference for clarity.

Could you provide more details on how we should proceed with the navigation transformation?

I’d also appreciate any additional suggestions from others.

Screenshare.-.2025-02-10.6_35_54.PM.mp4

[t-hamano]

Could you provide more details on how we should proceed with the navigation transformation?

Strangely, in my environment, multiple menus are created.

Another problem is that after converting a page list to a navigation block, a new navigation is created every time I click the Undo button.