外掛說明

A simple yet robust solution for creating modals within the WordPress block editor.

🚀 View Demo

Features

Fully customizable using the native block editor style controls
Trigger modal on click for any element via CSS selector
Trigger modal on page load after X milliseconds
- Set cookie to not show modal again on page load until X minutes have elapsed
- Option for user interaction within modal triggers cookie to be set
Custom modal width
Optional close button
API enabled
Only 2kb gzipped
Accessibility enabled
Use modals within the query loop block

Attribution

The Light Modal block uses a modified version of the Micromodal library.

螢幕擷圖

Block editor modal settings
Show Modal block control enabled under the Advanced panel for various blocks
Native block styling enabled for modals
Custom panel reveals all modals enabled on page
Modal in list view

適用於區塊編輯器

這個外掛提供 1 個可供 Gutenberg/區塊編輯器使用的區塊。

Light Modal Block Lightweight, customizable modal block for the WordPress block editor

安裝方式

Upload the plugin files to the /wp-content/plugins/light-modal-block directory, or install the plugin through the WordPress plugins screen directly.
Activate the plugin through the ‘Plugins’ screen in WordPress

常見問題集

How can I programatically open or close a modal?

Each modal is given a unique ID, which can be found inside the inspector controls of the block settings. It will look something like: Mk6I8L4haJB

To open a modal:

window.lightModalBlocks.get('modal-id-here').showModal(true);

To close a modal:

window.lightModalBlocks.get('modal-id-here').closeModal();

How can I prevent focusing on the first focusable element when the modal opens?

Paste the following code in your child themes functions.php file or similar:

/**
* Prevents the light modal block from focusing on a specific element when it opens.
*
* @return void
*/
add_action(
    'wp_enqueue_scripts',
    function () {
        wp_add_inline_script(
            'cloudcatch-light-modal-block-view-script',
            'window.lmbFocusableElements = "";',
            'before'
        );
    }
);

How can I prevent scrolling when a modal is open?

The class lmb-open is added to the <body> of the page when a modal is open. You can use the following CSS to prevent scrolling

.lmb-open {
    overflow: hidden;
}

使用者評論

darkonelson 2026 年 2 月 27 日

It does everything it needs to and is easy to define. I recommend.

espointpolish 2025 年 11 月 7 日

Beautiful plugin and amazing support! Thank you.

Caio Ferreira 2025 年 9 月 2 日

Love this! So lightweight and works perfectly with Gutenberg/GenerateBlocks. Thanks and keep up the good work!

stlpl 2025 年 8 月 22 日

It’s a simple and elegant solution without unnecessary frills.

Radical Dreamer 2025 年 7 月 30 日

It is so useful~! it solves too many scenarios: pop-forms, subscriptions, menu, additional info, and the list goes on…

tamnik 2025 年 5 月 5 日

A small suggestion, if you add additional options, like height, a custom additional classes for each separate popup__wrapper – justify /align content and even breaking points, this plugin could be used for much more like Floating Search or Mobile Navigation etc.

閱讀全部 12 則使用者評論

參與者及開發者

以下人員參與了開源軟體〈Light Modal Block〉的開發相關工作。

將〈Light Modal Block〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣？

任何人均可瀏覽程式碼、查看 SVN 存放庫，或透過 RSS 訂閱開發記錄。

變更記錄

1.9.0

Enhancement: When selecting edit modal from the plugin sidebar, automatically open the modal block settings
Enhancement: Improve performance of useModals() hook via leveraging getBlocksByName()

1.8.0

Fix: Show modal on page load no longer requiring delay input
Enhancement: Control over autoplaying of videos and audio when a modal opens as well as pausing when it closes

1.7.1

Fix: Unnecessary block editor scripts being enqueued on frontend

1.7.0

Enhancement: Improve acessibility of modal triggers for the Button block

1.6.0

Enhancement: Add event listeners for modal ready, open and close

1.5.0

Enhancement: Add body class .lmb-open when a modal is currently open on the page
Enhancement: Add ability to set cookie on timed modals when user interacts with content in the modal
Enhancement: Close icon / close background color controls
Enhancement: Add ability to change/remove focusable elements when a modal is opened
Chore: Update block to block version 3
Chore: Update minimum WordPress version support to 6.6

1.4.0

Enhancement: Support for modals within a query loop block

1.3.2

Fix: Unique modal ID not generating when duplicating block

1.3.1

Fix: When editing a pattern with a modal block, open modal by default

1.3.0

Enhancement: Add support for drop shadows

1.2.1

Fix: Modal blocks not showing in sidebar or advanced controls if a nested block

1.2.0

Enhancement: Add typography style controls

1.1.1

Fix: Block editor toolbar crash

1.1.0

Fix: Add backdrop color control
Enhancement: Set cookie to not display modal again until X minutes have elapsed
Enhancement: API to programatically open and close modal

1.0.1

Fix: Update CSS styling

1.0.0

Initial release

A simple and lightweight plugin

So much better than everything else I’ve tried

Lightweight using with blocks

A great addition to the block editor

This should be a default gutenberg block

The plugin is great, simple and easy to use.