Skip to content
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.

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

List View: Add a rootClientId prop #49475

Merged
merged 7 commits into from
Apr 6, 2023
Merged

Conversation

scruffian
Copy link
Contributor

@scruffian scruffian commented Mar 30, 2023

What?

This adds a rootClientId prop to the list view component, so that it can display a subset of blocks from the canvas.

Why?

This functionality is required by the OffCanvasEditor. If we add it to the List View then we are one step closer to removing the OffCanvasEditor.

It's not enough just to provide blocks, as the appender needs to know the clientId of the parent block to which it will add the new block.

How?

Adds a new prop called rootClientId.

I have also added some code to force the list view to only show the contents of the first block in the canvas. This should be removed before merging, it's just here to demonstrate that it works.

Testing Instructions

  1. Open the site editor
  2. Open the list view
  3. Confirm that you only see the inner blocks of the first block

@scruffian scruffian added the [Feature] List View Menu item in the top toolbar to select blocks from a list of links. label Mar 30, 2023
@scruffian scruffian requested a review from talldan March 30, 2023 11:39
@scruffian scruffian self-assigned this Mar 30, 2023
@github-actions
Copy link

github-actions bot commented Mar 30, 2023

Size Change: +3.6 kB (0%)

Total Size: 1.35 MB

Filename Size Change
build/block-editor/index.min.js 203 kB +2.21 kB (+1%)
build/block-editor/style-rtl.css 14.6 kB +121 B (+1%)
build/block-editor/style.css 14.6 kB +119 B (+1%)
build/block-library/blocks/columns/style-rtl.css 409 B +3 B (+1%)
build/block-library/blocks/columns/style.css 409 B +3 B (+1%)
build/block-library/blocks/cover/editor-rtl.css 649 B +37 B (+6%) 🔍
build/block-library/blocks/cover/editor.css 651 B +38 B (+6%) 🔍
build/block-library/blocks/cover/style-rtl.css 1.61 kB +15 B (+1%)
build/block-library/blocks/cover/style.css 1.6 kB +15 B (+1%)
build/block-library/blocks/file/style-rtl.css 269 B +4 B (+2%)
build/block-library/blocks/file/style.css 270 B +5 B (+2%)
build/block-library/blocks/post-excerpt/style-rtl.css 141 B +7 B (+5%) 🔍
build/block-library/blocks/post-excerpt/style.css 141 B +7 B (+5%) 🔍
build/block-library/blocks/pullquote/style-rtl.css 335 B +9 B (+3%)
build/block-library/blocks/pullquote/style.css 335 B +10 B (+3%)
build/block-library/blocks/spacer/editor-rtl.css 359 B +27 B (+8%) 🔍
build/block-library/blocks/spacer/editor.css 359 B +27 B (+8%) 🔍
build/block-library/common-rtl.css 1.12 kB +3 B (0%)
build/block-library/common.css 1.12 kB +3 B (0%)
build/block-library/editor-rtl.css 11.7 kB +21 B (0%)
build/block-library/editor.css 11.7 kB +25 B (0%)
build/block-library/index.min.js 203 kB +820 B (0%)
build/block-library/style-rtl.css 12.8 kB +33 B (0%)
build/block-library/style.css 12.8 kB +31 B (0%)
build/blocks/index.min.js 51.1 kB -4 B (0%)
build/components/index.min.js 208 kB -13 B (0%)
build/components/style-rtl.css 11.7 kB +2 B (0%)
build/components/style.css 11.7 kB +2 B (0%)
build/customize-widgets/index.min.js 12.2 kB -5 B (0%)
build/edit-post/index.min.js 34.9 kB -29 B (0%)
build/edit-post/style-rtl.css 7.59 kB -5 B (0%)
build/edit-post/style.css 7.58 kB -4 B (0%)
build/edit-site/index.min.js 63.3 kB +53 B (0%)
build/edit-site/style-rtl.css 10.1 kB -2 B (0%)
build/edit-widgets/index.min.js 17.3 kB -6 B (0%)
build/editor/index.min.js 45.9 kB +19 B (0%)
ℹ️ View Unchanged
Filename Size
build/a11y/index.min.js 993 B
build/annotations/index.min.js 2.78 kB
build/api-fetch/index.min.js 2.27 kB
build/autop/index.min.js 2.15 kB
build/blob/index.min.js 483 B
build/block-directory/index.min.js 7.2 kB
build/block-directory/style-rtl.css 1.04 kB
build/block-directory/style.css 1.04 kB
build/block-editor/content-rtl.css 4.11 kB
build/block-editor/content.css 4.1 kB
build/block-editor/default-editor-styles-rtl.css 403 B
build/block-editor/default-editor-styles.css 403 B
build/block-library/blocks/archives/editor-rtl.css 61 B
build/block-library/blocks/archives/editor.css 60 B
build/block-library/blocks/archives/style-rtl.css 90 B
build/block-library/blocks/archives/style.css 90 B
build/block-library/blocks/audio/editor-rtl.css 150 B
build/block-library/blocks/audio/editor.css 150 B
build/block-library/blocks/audio/style-rtl.css 122 B
build/block-library/blocks/audio/style.css 122 B
build/block-library/blocks/audio/theme-rtl.css 138 B
build/block-library/blocks/audio/theme.css 138 B
build/block-library/blocks/avatar/editor-rtl.css 116 B
build/block-library/blocks/avatar/editor.css 116 B
build/block-library/blocks/avatar/style-rtl.css 91 B
build/block-library/blocks/avatar/style.css 91 B
build/block-library/blocks/block/editor-rtl.css 305 B
build/block-library/blocks/block/editor.css 305 B
build/block-library/blocks/button/editor-rtl.css 587 B
build/block-library/blocks/button/editor.css 587 B
build/block-library/blocks/button/style-rtl.css 628 B
build/block-library/blocks/button/style.css 627 B
build/block-library/blocks/buttons/editor-rtl.css 337 B
build/block-library/blocks/buttons/editor.css 337 B
build/block-library/blocks/buttons/style-rtl.css 332 B
build/block-library/blocks/buttons/style.css 332 B
build/block-library/blocks/calendar/style-rtl.css 239 B
build/block-library/blocks/calendar/style.css 239 B
build/block-library/blocks/categories/editor-rtl.css 113 B
build/block-library/blocks/categories/editor.css 112 B
build/block-library/blocks/categories/style-rtl.css 124 B
build/block-library/blocks/categories/style.css 124 B
build/block-library/blocks/code/editor-rtl.css 53 B
build/block-library/blocks/code/editor.css 53 B
build/block-library/blocks/code/style-rtl.css 121 B
build/block-library/blocks/code/style.css 121 B
build/block-library/blocks/code/theme-rtl.css 124 B
build/block-library/blocks/code/theme.css 124 B
build/block-library/blocks/columns/editor-rtl.css 108 B
build/block-library/blocks/columns/editor.css 108 B
build/block-library/blocks/comment-author-avatar/editor-rtl.css 125 B
build/block-library/blocks/comment-author-avatar/editor.css 125 B
build/block-library/blocks/comment-content/style-rtl.css 92 B
build/block-library/blocks/comment-content/style.css 92 B
build/block-library/blocks/comment-template/style-rtl.css 199 B
build/block-library/blocks/comment-template/style.css 198 B
build/block-library/blocks/comments-pagination-numbers/editor-rtl.css 123 B
build/block-library/blocks/comments-pagination-numbers/editor.css 121 B
build/block-library/blocks/comments-pagination/editor-rtl.css 222 B
build/block-library/blocks/comments-pagination/editor.css 209 B
build/block-library/blocks/comments-pagination/style-rtl.css 235 B
build/block-library/blocks/comments-pagination/style.css 231 B
build/block-library/blocks/comments-title/editor-rtl.css 75 B
build/block-library/blocks/comments-title/editor.css 75 B
build/block-library/blocks/comments/editor-rtl.css 840 B
build/block-library/blocks/comments/editor.css 839 B
build/block-library/blocks/comments/style-rtl.css 637 B
build/block-library/blocks/comments/style.css 636 B
build/block-library/blocks/embed/editor-rtl.css 293 B
build/block-library/blocks/embed/editor.css 293 B
build/block-library/blocks/embed/style-rtl.css 410 B
build/block-library/blocks/embed/style.css 410 B
build/block-library/blocks/embed/theme-rtl.css 138 B
build/block-library/blocks/embed/theme.css 138 B
build/block-library/blocks/file/editor-rtl.css 300 B
build/block-library/blocks/file/editor.css 300 B
build/block-library/blocks/file/view.min.js 353 B
build/block-library/blocks/freeform/editor-rtl.css 2.44 kB
build/block-library/blocks/freeform/editor.css 2.44 kB
build/block-library/blocks/gallery/editor-rtl.css 984 B
build/block-library/blocks/gallery/editor.css 988 B
build/block-library/blocks/gallery/style-rtl.css 1.55 kB
build/block-library/blocks/gallery/style.css 1.55 kB
build/block-library/blocks/gallery/theme-rtl.css 122 B
build/block-library/blocks/gallery/theme.css 122 B
build/block-library/blocks/group/editor-rtl.css 654 B
build/block-library/blocks/group/editor.css 654 B
build/block-library/blocks/group/style-rtl.css 57 B
build/block-library/blocks/group/style.css 57 B
build/block-library/blocks/group/theme-rtl.css 78 B
build/block-library/blocks/group/theme.css 78 B
build/block-library/blocks/heading/style-rtl.css 76 B
build/block-library/blocks/heading/style.css 76 B
build/block-library/blocks/html/editor-rtl.css 332 B
build/block-library/blocks/html/editor.css 333 B
build/block-library/blocks/image/editor-rtl.css 830 B
build/block-library/blocks/image/editor.css 829 B
build/block-library/blocks/image/style-rtl.css 652 B
build/block-library/blocks/image/style.css 652 B
build/block-library/blocks/image/theme-rtl.css 137 B
build/block-library/blocks/image/theme.css 137 B
build/block-library/blocks/latest-comments/style-rtl.css 357 B
build/block-library/blocks/latest-comments/style.css 357 B
build/block-library/blocks/latest-posts/editor-rtl.css 213 B
build/block-library/blocks/latest-posts/editor.css 212 B
build/block-library/blocks/latest-posts/style-rtl.css 478 B
build/block-library/blocks/latest-posts/style.css 478 B
build/block-library/blocks/list/style-rtl.css 88 B
build/block-library/blocks/list/style.css 88 B
build/block-library/blocks/media-text/editor-rtl.css 266 B
build/block-library/blocks/media-text/editor.css 263 B
build/block-library/blocks/media-text/style-rtl.css 507 B
build/block-library/blocks/media-text/style.css 505 B
build/block-library/blocks/more/editor-rtl.css 431 B
build/block-library/blocks/more/editor.css 431 B
build/block-library/blocks/navigation-link/editor-rtl.css 716 B
build/block-library/blocks/navigation-link/editor.css 715 B
build/block-library/blocks/navigation-link/style-rtl.css 115 B
build/block-library/blocks/navigation-link/style.css 115 B
build/block-library/blocks/navigation-submenu/editor-rtl.css 299 B
build/block-library/blocks/navigation-submenu/editor.css 299 B
build/block-library/blocks/navigation/editor-rtl.css 2.13 kB
build/block-library/blocks/navigation/editor.css 2.14 kB
build/block-library/blocks/navigation/style-rtl.css 2.22 kB
build/block-library/blocks/navigation/style.css 2.21 kB
build/block-library/blocks/navigation/view-modal.min.js 2.81 kB
build/block-library/blocks/navigation/view.min.js 447 B
build/block-library/blocks/nextpage/editor-rtl.css 395 B
build/block-library/blocks/nextpage/editor.css 395 B
build/block-library/blocks/page-list/editor-rtl.css 401 B
build/block-library/blocks/page-list/editor.css 401 B
build/block-library/blocks/page-list/style-rtl.css 175 B
build/block-library/blocks/page-list/style.css 175 B
build/block-library/blocks/paragraph/editor-rtl.css 174 B
build/block-library/blocks/paragraph/editor.css 174 B
build/block-library/blocks/paragraph/style-rtl.css 279 B
build/block-library/blocks/paragraph/style.css 281 B
build/block-library/blocks/post-author/style-rtl.css 175 B
build/block-library/blocks/post-author/style.css 176 B
build/block-library/blocks/post-comments-form/editor-rtl.css 96 B
build/block-library/blocks/post-comments-form/editor.css 96 B
build/block-library/blocks/post-comments-form/style-rtl.css 501 B
build/block-library/blocks/post-comments-form/style.css 501 B
build/block-library/blocks/post-date/style-rtl.css 61 B
build/block-library/blocks/post-date/style.css 61 B
build/block-library/blocks/post-excerpt/editor-rtl.css 71 B
build/block-library/blocks/post-excerpt/editor.css 71 B
build/block-library/blocks/post-featured-image/editor-rtl.css 588 B
build/block-library/blocks/post-featured-image/editor.css 586 B
build/block-library/blocks/post-featured-image/style-rtl.css 322 B
build/block-library/blocks/post-featured-image/style.css 322 B
build/block-library/blocks/post-navigation-link/style-rtl.css 153 B
build/block-library/blocks/post-navigation-link/style.css 153 B
build/block-library/blocks/post-template/editor-rtl.css 99 B
build/block-library/blocks/post-template/editor.css 98 B
build/block-library/blocks/post-template/style-rtl.css 281 B
build/block-library/blocks/post-template/style.css 281 B
build/block-library/blocks/post-terms/style-rtl.css 96 B
build/block-library/blocks/post-terms/style.css 96 B
build/block-library/blocks/post-time-to-read/style-rtl.css 69 B
build/block-library/blocks/post-time-to-read/style.css 69 B
build/block-library/blocks/post-title/style-rtl.css 100 B
build/block-library/blocks/post-title/style.css 100 B
build/block-library/blocks/preformatted/style-rtl.css 103 B
build/block-library/blocks/preformatted/style.css 103 B
build/block-library/blocks/pullquote/editor-rtl.css 135 B
build/block-library/blocks/pullquote/editor.css 135 B
build/block-library/blocks/pullquote/theme-rtl.css 167 B
build/block-library/blocks/pullquote/theme.css 167 B
build/block-library/blocks/query-pagination-numbers/editor-rtl.css 122 B
build/block-library/blocks/query-pagination-numbers/editor.css 121 B
build/block-library/blocks/query-pagination/editor-rtl.css 221 B
build/block-library/blocks/query-pagination/editor.css 211 B
build/block-library/blocks/query-pagination/style-rtl.css 288 B
build/block-library/blocks/query-pagination/style.css 284 B
build/block-library/blocks/query-title/style-rtl.css 63 B
build/block-library/blocks/query-title/style.css 63 B
build/block-library/blocks/query/editor-rtl.css 463 B
build/block-library/blocks/query/editor.css 463 B
build/block-library/blocks/quote/style-rtl.css 222 B
build/block-library/blocks/quote/style.css 222 B
build/block-library/blocks/quote/theme-rtl.css 223 B
build/block-library/blocks/quote/theme.css 226 B
build/block-library/blocks/read-more/style-rtl.css 132 B
build/block-library/blocks/read-more/style.css 132 B
build/block-library/blocks/rss/editor-rtl.css 149 B
build/block-library/blocks/rss/editor.css 149 B
build/block-library/blocks/rss/style-rtl.css 289 B
build/block-library/blocks/rss/style.css 288 B
build/block-library/blocks/search/editor-rtl.css 165 B
build/block-library/blocks/search/editor.css 165 B
build/block-library/blocks/search/style-rtl.css 408 B
build/block-library/blocks/search/style.css 406 B
build/block-library/blocks/search/theme-rtl.css 114 B
build/block-library/blocks/search/theme.css 114 B
build/block-library/blocks/separator/editor-rtl.css 146 B
build/block-library/blocks/separator/editor.css 146 B
build/block-library/blocks/separator/style-rtl.css 234 B
build/block-library/blocks/separator/style.css 234 B
build/block-library/blocks/separator/theme-rtl.css 194 B
build/block-library/blocks/separator/theme.css 194 B
build/block-library/blocks/shortcode/editor-rtl.css 474 B
build/block-library/blocks/shortcode/editor.css 474 B
build/block-library/blocks/site-logo/editor-rtl.css 489 B
build/block-library/blocks/site-logo/editor.css 489 B
build/block-library/blocks/site-logo/style-rtl.css 203 B
build/block-library/blocks/site-logo/style.css 203 B
build/block-library/blocks/site-tagline/editor-rtl.css 86 B
build/block-library/blocks/site-tagline/editor.css 86 B
build/block-library/blocks/site-title/editor-rtl.css 116 B
build/block-library/blocks/site-title/editor.css 116 B
build/block-library/blocks/site-title/style-rtl.css 57 B
build/block-library/blocks/site-title/style.css 57 B
build/block-library/blocks/social-link/editor-rtl.css 184 B
build/block-library/blocks/social-link/editor.css 184 B
build/block-library/blocks/social-links/editor-rtl.css 674 B
build/block-library/blocks/social-links/editor.css 673 B
build/block-library/blocks/social-links/style-rtl.css 1.4 kB
build/block-library/blocks/social-links/style.css 1.39 kB
build/block-library/blocks/spacer/style-rtl.css 48 B
build/block-library/blocks/spacer/style.css 48 B
build/block-library/blocks/table/editor-rtl.css 433 B
build/block-library/blocks/table/editor.css 433 B
build/block-library/blocks/table/style-rtl.css 651 B
build/block-library/blocks/table/style.css 650 B
build/block-library/blocks/table/theme-rtl.css 157 B
build/block-library/blocks/table/theme.css 157 B
build/block-library/blocks/tag-cloud/style-rtl.css 251 B
build/block-library/blocks/tag-cloud/style.css 253 B
build/block-library/blocks/template-part/editor-rtl.css 404 B
build/block-library/blocks/template-part/editor.css 404 B
build/block-library/blocks/template-part/theme-rtl.css 101 B
build/block-library/blocks/template-part/theme.css 101 B
build/block-library/blocks/text-columns/editor-rtl.css 95 B
build/block-library/blocks/text-columns/editor.css 95 B
build/block-library/blocks/text-columns/style-rtl.css 166 B
build/block-library/blocks/text-columns/style.css 166 B
build/block-library/blocks/verse/style-rtl.css 99 B
build/block-library/blocks/verse/style.css 99 B
build/block-library/blocks/video/editor-rtl.css 552 B
build/block-library/blocks/video/editor.css 555 B
build/block-library/blocks/video/style-rtl.css 179 B
build/block-library/blocks/video/style.css 179 B
build/block-library/blocks/video/theme-rtl.css 139 B
build/block-library/blocks/video/theme.css 139 B
build/block-library/classic-rtl.css 179 B
build/block-library/classic.css 179 B
build/block-library/editor-elements-rtl.css 75 B
build/block-library/editor-elements.css 75 B
build/block-library/elements-rtl.css 54 B
build/block-library/elements.css 54 B
build/block-library/reset-rtl.css 478 B
build/block-library/reset.css 478 B
build/block-library/theme-rtl.css 698 B
build/block-library/theme.css 703 B
build/block-serialization-default-parser/index.min.js 1.13 kB
build/block-serialization-spec-parser/index.min.js 2.83 kB
build/compose/index.min.js 12.4 kB
build/core-data/index.min.js 16.3 kB
build/customize-widgets/style-rtl.css 1.41 kB
build/customize-widgets/style.css 1.41 kB
build/data-controls/index.min.js 663 B
build/data/index.min.js 8.68 kB
build/date/index.min.js 40.4 kB
build/deprecated/index.min.js 518 B
build/dom-ready/index.min.js 336 B
build/dom/index.min.js 4.72 kB
build/edit-post/classic-rtl.css 571 B
build/edit-post/classic.css 571 B
build/edit-site/style.css 10.1 kB
build/edit-widgets/style-rtl.css 4.56 kB
build/edit-widgets/style.css 4.56 kB
build/editor/style-rtl.css 3.49 kB
build/editor/style.css 3.48 kB
build/element/index.min.js 4.95 kB
build/escape-html/index.min.js 548 B
build/format-library/index.min.js 7.26 kB
build/format-library/style-rtl.css 557 B
build/format-library/style.css 556 B
build/hooks/index.min.js 1.66 kB
build/html-entities/index.min.js 454 B
build/i18n/index.min.js 3.79 kB
build/is-shallow-equal/index.min.js 535 B
build/keyboard-shortcuts/index.min.js 1.79 kB
build/keycodes/index.min.js 1.94 kB
build/list-reusable-blocks/index.min.js 2.14 kB
build/list-reusable-blocks/style-rtl.css 865 B
build/list-reusable-blocks/style.css 865 B
build/media-utils/index.min.js 2.99 kB
build/notices/index.min.js 977 B
build/plugins/index.min.js 1.94 kB
build/preferences-persistence/index.min.js 2.23 kB
build/preferences/index.min.js 1.35 kB
build/primitives/index.min.js 960 B
build/priority-queue/index.min.js 1.52 kB
build/private-apis/index.min.js 937 B
build/react-i18n/index.min.js 702 B
build/react-refresh-entry/index.min.js 8.44 kB
build/react-refresh-runtime/index.min.js 7.31 kB
build/redux-routine/index.min.js 2.75 kB
build/reusable-blocks/index.min.js 2.26 kB
build/reusable-blocks/style-rtl.css 265 B
build/reusable-blocks/style.css 265 B
build/rich-text/index.min.js 11.1 kB
build/server-side-render/index.min.js 2.09 kB
build/shortcode/index.min.js 1.52 kB
build/style-engine/index.min.js 1.55 kB
build/token-list/index.min.js 650 B
build/url/index.min.js 3.74 kB
build/vendors/inert-polyfill.min.js 2.48 kB
build/vendors/react-dom.min.js 41.8 kB
build/vendors/react.min.js 4.02 kB
build/viewport/index.min.js 1.09 kB
build/warning/index.min.js 280 B
build/widgets/index.min.js 7.3 kB
build/widgets/style-rtl.css 1.18 kB
build/widgets/style.css 1.18 kB
build/wordcount/index.min.js 1.06 kB

compressed-size-action

@draganescu
Copy link
Contributor

Because we can pass blocks any block can render any list of blocks into a list view, so we can't assume that the parent of the root of the block list is the root where the appender should append. But then again that means the prop is not rootClientId it is appenderRootClientId so the appender knows where to append.

Also there is a showAppender condition in ListViewBranch that should take appenderRootClientId into account and not show it if is null.

@github-actions
Copy link

github-actions bot commented Mar 30, 2023

Flaky tests detected in 3332b43.
Some tests passed with failed attempts. The failures may not be related to this commit but are still reported for visibility. See the documentation for more information.

🔍 Workflow run URL: https://github.com/WordPress/gutenberg/actions/runs/4624780477
📝 Reported issues:

@scruffian
Copy link
Contributor Author

The rootClientId is also used to determine what blocks to show if blocks isn't used.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All of the changes in this file must be reverted before merge

Copy link
Contributor

@andrewserong andrewserong left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I really like this idea, and it's testing nicely for me! We might also want to update the Readme for the component, just to clarify that the list view will show all the block in the editor or all blocks in a tree based on a rootClientId, allowing interfaces for working with one part of the block tree. E.g. around here:

The ListView component provides an overview of the hierarchical structure of all blocks in the editor. The blocks are presented vertically one below the other.

Not a blocker for this PR, but one issue I'm hoping to look into is with dealing with drag-and-dropping on container blocks, and being able to drop at any level of the hierarchy (this issue: #33678). When this PR lands, it's good to know that whatever logic we might introduce there needs to be aware of how many levels of hierarchy are visible within the list view, and not just check the real block hierarchy. But that sounds fine to me 👍

Were there any issues that needed to be resolved with the appender? This code change looks good to me, and I see that the rootClientId is passed down to ListViewBranch so it sounds like the appender should respect it correctly?

Consider this comment a cautious LGTM from me! 😄

@scruffian
Copy link
Contributor Author

Were there any issues that needed to be resolved with the appender? This code change looks good to me, and I see that the rootClientId is passed down to ListViewBranch so it sounds like the appender should respect it correctly?

Yeah you can see it working in #49417

@talldan
Copy link
Contributor

talldan commented Mar 31, 2023

I see what @draganescu is saying. You can get into some interesting situations with the API:

  • rootClientId and showAppender are specified - it should work as expected.
  • blocks, showAppender and rootClientId are specified - it should work as expected, as long as the rootClientId is correct.
  • blocks and showAppender is specified, but no rootClientId - the appender won't work, but I think will still be visible.

I think this is why I prefer the idea of deprecating/removing the blocks prop.

If we want to stick with this approach though, it should be documented clearly.

@scruffian
Copy link
Contributor Author

Makes sense, I'll deprecate blocks. I can't see a situation where we'd ever want a list of blocks that isn't derived from a parent.

@scruffian
Copy link
Contributor Author

I have tried to deprecate the blocks prop. I have also updated the signature of useListViewClientIds. I think this is ok as it's not exported.

Co-authored-by: Daniel Richards <daniel.richards@automattic.com>
Copy link
Contributor

@andrewserong andrewserong left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is still testing well for me, and I like the idea of deprecating the blocks prop 👍

packages/block-editor/src/components/list-view/index.js Outdated Show resolved Hide resolved
Co-authored-by: Andrew Serong <14988353+andrewserong@users.noreply.github.com>
Copy link
Contributor

@talldan talldan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me too, just some linter things to sort out from applying the suggestions.

Copy link
Contributor

@andrewserong andrewserong left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, looks like the last thing to do before merging is removing the changes to list-view-sidebar.js?

@andrewserong andrewserong added the [Type] Enhancement A suggestion for improvement. label Apr 6, 2023
@talldan talldan merged commit 274cde3 into trunk Apr 6, 2023
@talldan talldan deleted the add/root-client-id-to-list-view branch April 6, 2023 04:27
@github-actions github-actions bot added this to the Gutenberg 15.6 milestone Apr 6, 2023
@bph bph added the Needs Dev Note Requires a developer note for a major WordPress release cycle label Apr 11, 2023
@getdave
Copy link
Contributor

getdave commented May 23, 2023

I can't see a situation where we'd ever want a list of blocks that isn't derived from a parent.

What about in the Navigation in the Browse Mode sidebar where we want to display the blocks that are part of a Navigation Menu without any relationship to a Navigation block.

#50847

@talldan
Copy link
Contributor

talldan commented May 23, 2023

Why do you need to remove the 'ghost'? Isn't that going to cause a lot of issues?

@getdave
Copy link
Contributor

getdave commented May 23, 2023

Yeh I was just wondering whether it's worth any effort. It just stuck out to me as a bit of a hack and I thought why can't we just use an entity block editor, but it turns out it's far from simple.

My main concern was coupling Navigation to requiring a Navigation block. For example, what happens if the user deregisters the block in order that they can provide their users with a custom block to handle navigation. Now a key part of the editor interface doesn't work because the block isn't there. Edge case sure, but possible nonetheless.

I'm trying to work out what the block provides other than entity saving flow.

@talldan
Copy link
Contributor

talldan commented May 23, 2023

My main concern was coupling Navigation to requiring a Navigation block. For example, what happens if the user deregisters the block in order that they can provide their users with a custom block to handle navigation. Now a key part of the editor interface doesn't work because the block isn't there. Edge case sure, but possible nonetheless.

That's a very good point 😄

Possibly the browse mode navigation menu also shouldn't be available.

I'm trying to work out what the block provides other than entity saving flow.

I think the main things are the inner blocks settings, that require the block edit to render (allowed blocks is the main one).

@getdave
Copy link
Contributor

getdave commented May 23, 2023

Ah thanks for that context. Right so basically it's critical to allow the whole thing to work 😅 I suppose the block is central so maybe it's ok? I'm not sure...

I wonder whether we could make use of this "wrapper" Nav block in the preview canvas, as we will need to have a wrapper Nav block for focus mode for Navigation Menus.

@talldan
Copy link
Contributor

talldan commented May 23, 2023

I think you're right that it is coupling that ideally wouldn't be there, but not an easy one to solve.

The other thing that List View for browse mode needs is its own instance of a block editor store. This store will have an isolated tree of the blocks in a menu, and so the rootClientId prop would work even without the ghost navigation block.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
[Feature] List View Menu item in the top toolbar to select blocks from a list of links. Needs Dev Note Requires a developer note for a major WordPress release cycle [Type] Enhancement A suggestion for improvement.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants