WordPress / Documentation-Issue-Tracker

Issue Tracker for the WordPress Documentation team.
https://make.wordpress.org/docs/
Other
83 stars 41 forks source link

[HelpHub] [6.4] List View #1221

Open femkreations opened 1 year ago

femkreations commented 1 year ago

Article: https://wordpress.org/documentation/article/list-view/

Updates for 6.4

Reference

General

Good first issues

If you are looking for simpler tasks, take a look at related good first issues:

github-actions[bot] commented 1 year ago

Heads up @WordPress/docs-issues-coordinators, we have a new issue open. Time to use 'em labels.

github-actions[bot] commented 1 year ago

Heads up @femkreations - the "block editor" label was applied to this issue.

iammehedi1 commented 1 year ago

I want to work on this. @femkreations @abhansnuk

iammehedi1 commented 1 year ago

Add keyboard shortcut for duplicating blocks. https://github.com/WordPress/gutenberg/pull/53559

In this update, a convenient keyboard shortcut has been introduced for duplicating blocks within the List View, simplifying block management during navigation. With this new feature, users can swiftly duplicate the currently selected or focused block without the necessity of switching to other interfaces, such as the block settings menu or the editor canvas.

The approach adopted mirrors that of the block settings menu, adapted specifically for the List View. Common logic for determining which blocks to modify, shared between block deletion and duplication in the List View, has been consolidated.

Additionally, the existing end-to-end test has been enhanced to encompass both block deletion and duplication within the List View.

https://user-images.githubusercontent.com/14988353/260358327-aa66a9d2-ebde-4e68-b693-22a42cb9cb76.mp4

iammehedi1 commented 1 year ago

Add media previews to list view for gallery and image blocks. https://github.com/WordPress/gutenberg/pull/53381

This update introduces media previews for gallery and image blocks in the list view, improving document navigation in cases with numerous images or galleries.

Media previews are displayed for collapsed Gallery blocks, with a maximum of three images per row. Image blocks in the list view show a single image in the row.

To achieve this, a hook has been added to the list view for image retrieval, and images are displayed using background images with a cover setting.

The logic for fetching images is temporarily hard-coded to identify images within Image blocks or as children of Gallery blocks. However, there's a plan to establish a more consistent API for this in the future to ensure greater flexibility and maintain a unified list view experience.

iammehedi1 commented 1 year ago

Allow Escape key to deselect blocks if blocks are selected. https://github.com/WordPress/gutenberg/pull/48708

This update addresses the issue of users being unable to unselect blocks within the list view. The suggested fix is to allow the Escape key to unselect all blocks when a block selection is active, while keeping the list view open. If no blocks are selected, the Escape key will still close the list view as usual.

The motivation behind this change stems from a user-reported issue highlighting the need for a keyboard-based method to deselect blocks in the list view, which is currently unavailable. Given that users can open and close the list view using a keyboard shortcut, this update prioritizes using the Escape key to deselect blocks instead of closing the list view.

For reference, the keyboard shortcut for closing the list view is alt+shift+o on Windows and control+option+o on Mac.

In practical terms, when a block is selected in the list view, hitting Escape will remove the selection without closing the list view. If no blocks are selected, hitting Escape will carry out the usual action of closing the list view.

https://user-images.githubusercontent.com/14988353/222635879-f751e946-9cde-403e-9383-ea45126f09ec.mp4

nalininsbs commented 1 year ago

Confirmed update done in Slack. Submitted for 1st review.

nalininsbs commented 12 months ago

Thank you for your efforts on this @iammehedi1, and welcome as a new contributor too!

I think the content may need simplifying more as this is a document for end users rather than a dev note. My reading of the List View page is that it is at a less technical level. @femkreations @Leonardus-Nugraha @jennimckinnon could you please have a look at the content to help our new contributor make any updates and so the changes can be made by yourselves on the page? Thank you.

nalininsbs commented 12 months ago

I saw @abhansnuk raised the question on another issue. Is List View still upper case L and V? @zzap would you know if this is the case? Thank you.

zzap commented 4 weeks ago

Both should be upper case because that's the actual name of the feature, @nalininsbs and @abhansnuk .