Title: Poppable &#8211; The Easy Way to Add a Video Modal
Author: Engramium
Published: <strong>2021 年 2 月 1 日</strong>
Last modified: 2026 年 1 月 19 日

---

搜索插件

![](https://s.w.org/plugins/geopattern-icon/poppable.svg)

# Poppable – The Easy Way to Add a Video Modal

 作者：[Engramium](https://profiles.wordpress.org/engramium/)

[下载](https://downloads.wordpress.org/plugin/poppable.1.0.0.zip)

 * [详情](https://cn.wordpress.org/plugins/poppable/#description)
 * [评价](https://cn.wordpress.org/plugins/poppable/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/poppable/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/poppable/#developers)

 [支持](https://wordpress.org/support/plugin/poppable/)

## 描述

Poppable is a lightweight Gutenberg block that lets you display YouTube videos in
a sleek modal popup. Simply add the block, paste your YouTube URL, and connect it
to any trigger element on your page.

**Key Features:**

 * **Trigger from Any Element** – Assign a trigger ID to any element (button, image,
   text) and clicking it opens the video modal
 * **Multiple YouTube URL Formats** – Supports youtube.com/watch?v=, youtu.be/, 
   and youtube.com/embed/ formats
 * **Autoplay Support** – Optionally start playing the video automatically when 
   the modal opens
 * **Customizable Modal Width** – Set the content width using px, %, vw, or any 
   CSS unit
 * **Multiple Close Options:**
    - Close button (X) in the corner
    - Click outside to close
    - Press ESC key to close
 * **Responsive Design** – Videos maintain 16:9 aspect ratio on all screen sizes
 * **Body Scroll Lock** – Page scrolling is disabled when the modal is open for 
   a focused viewing experience
 * **Lightweight** – No jQuery dependencies, built with vanilla JavaScript

**Development & Source Code:**
 Poppable is open-source and developed publicly on
GitHub.

GitHub repository: https://github.com/Engramium/poppable

### How to Use

 1. Add the **Poppable** block anywhere on your page (it will be hidden on the frontend).
 2. In the block settings panel, enter your **YouTube Video URL**.
 3. Set a unique **Trigger ID** (e.g., `poppable-video-modal`).
 4. Add the same trigger ID as a CSS class to any element you want to use as the trigger(
    e.g., a button with class `poppable-video-modal`).
 5. Configure your preferred close options and modal width.
 6. Save and preview your page!

## 区块

该插件提供了 1 个区块.

 *   Poppable Display YouTube videos in a poppable modal.

## 安装

 1. Upload the plugin files to the `/wp-content/plugins/poppable` directory, or install
    the plugin through the WordPress plugins screen directly.
 2. Activate the plugin through the ‘Plugins’ screen in WordPress.
 3. In the block editor, search for “Poppable” and add the block to your page.

## 常见问题

### How do I trigger the modal?

Add the trigger ID you set in the block settings as a CSS class to any element. 
For example, if your trigger ID is `my-video-trigger`, add the class `my-video-trigger`
to a button or image.

### Can I have multiple video modals on one page?

Yes! Add multiple Poppable blocks with different trigger IDs, then assign each trigger
ID to different elements on your page.

### What YouTube URL formats are supported?

Poppable supports all common YouTube URL formats:
 * `https://www.youtube.com/watch?
v=VIDEO_ID` * `https://youtu.be/VIDEO_ID` * `https://www.youtube.com/embed/VIDEO_ID`

### Does the video stop when I close the modal?

Yes, the video automatically stops and resets when the modal is closed.

## 评价

此插件暂无评价。

## 贡献者及开发者

「Poppable – The Easy Way to Add a Video Modal」是开源软件。 以下人员对此插件做出
了贡献。

贡献者

 *   [ Engramium ](https://profiles.wordpress.org/engramium/)

[帮助将「Poppable – The Easy Way to Add a Video Modal」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/poppable)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/poppable/)，查看[SVN仓库](https://plugins.svn.wordpress.org/poppable/)，
或通过[RSS](https://plugins.trac.wordpress.org/log/poppable/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/poppable/)。

## 更新日志

#### 1.0.0

 * Converted to YouTube Video Popup Block

#### 0.1

 * Initial public release

## 额外信息

 *  版本 **1.0.0**
 *  最后更新：**4 月前**
 *  活跃安装数量 **不到10**
 *  WordPress 版本 ** 6.7 或更高版本 **
 *  已测试的最高版本为 **6.9.4**
 *  PHP 版本 ** 7.4 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/poppable/)
 * 标签
 * [lightbox](https://cn.wordpress.org/plugins/tags/lightbox/)[play button](https://cn.wordpress.org/plugins/tags/play-button/)
   [popup](https://cn.wordpress.org/plugins/tags/popup/)[video block](https://cn.wordpress.org/plugins/tags/video-block/)
 *  [高级视图](https://cn.wordpress.org/plugins/poppable/advanced/)

## 评级

尚未提交反馈。

[Your review](https://wordpress.org/support/plugin/poppable/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/poppable/reviews/)

## 贡献者

 *   [ Engramium ](https://profiles.wordpress.org/engramium/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/poppable/)