Skip to content

Media: Add a settings dialog to the Media Library toolbar. - #12932

Draft
t-hamano wants to merge 1 commit into
WordPress:trunkfrom
t-hamano:add/media-library-settings-dialog
Draft

Media: Add a settings dialog to the Media Library toolbar.#12932
t-hamano wants to merge 1 commit into
WordPress:trunkfrom
t-hamano:add/media-library-settings-dialog

Conversation

@t-hamano

@t-hamano t-hamano commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

Overview

WordPress core does not yet seem to have an API for rendering what are known as popovers. This PR instead attempts to render a settings dialog for the media library using the HTML native dialog element.

Use of AI Tools

Note

This PR is a prototype. Almost all of the code in this PR was generated by Claude. If we find the approach taken in this PR to be reasonable, I would like to review all of the code.

Screenshots

image image image

The "Infinite Scrolling" personal option could only be reached from the user
profile screen, far from the grid it affects. This adds a toggle next to the
search field in the attachments browser toolbar that opens a modal dialog with
that option, in both the grid and the media modal.

The dialog is a native `dialog` element opened with `showModal()`, so the focus
trap, the Escape handling, the backdrop and the focus restore on close come from
the platform rather than from a hand-rolled implementation. Keyboard events are
kept from reaching the media modal, whose own Escape handler and focus manager
would otherwise fight the dialog.

Toggling the checkbox saves the preference over Ajax and applies it in place:
`wp.media.view.Attachments` can now bind and unbind its scroll handler after
creation, and `wp.media.view.AttachmentsBrowser` swaps the Load more view in and
out, so no page reload is needed. Both views now read the setting at creation
time instead of capturing it when the module loads.

The toggle is not rendered when a `media_library_infinite_scrolling` filter
callback overrides the user preference, since the control would have no effect.

Co-Authored-By: Claude <noreply@anthropic.com>
@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown

Test using WordPress Playground

The changes in this pull request can previewed and tested using a WordPress Playground instance.

WordPress Playground is an experimental project that creates a full WordPress instance entirely within the browser.

Some things to be aware of

  • All changes will be lost when closing a tab with a Playground instance.
  • All changes will be lost when refreshing the page.
  • A fresh instance is created each time the link below is clicked.
  • Every time this pull request is updated, a new ZIP file containing all changes is created. If changes are not reflected in the Playground instance,
    it's possible that the most recent build failed, or has not completed. Check the list of workflow runs to be sure.

For more details about these limitations and more, check out the Limitations page in the WordPress Playground documentation.

Test this pull request with WordPress Playground.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant