WordPress区块类型列表，及区块名称列表的获取方法

在 WordPress 中，区块（Block）是古腾堡编辑器（Gutenberg）的核心组成部分。了解熟知区块类型及其名称对于功能开发、提升网站性能和优化有极大帮助，并且在许多WordPress功能开发中经常用到。

区块类型及名称列表

该WordPress区块类型及名称列表是通过在WordPress 6.8.3版本中精准获取名称后，再结合AI整理而来。该表整理了关于区块的名称（英文标识符）、中文名称、归类（基于功能类别，如文本、媒体、设计、导航等）和应用（描述其主要用途和场景）的信息已帮助快速查找、识别、理解和应用。注意下表格的名称列中“core/”后面的就是WordPress核心区块名称。详情如下：

区块名称列表获取方法 1：使用浏览器控制台（JavaScript）

适用于正在编辑页面或文章且已启用区块编辑器的场景。

1. 打开浏览器开发者工具（按 F12 或右键选择“检查”）。

2. 切换到 Console（控制台） 标签页。

3. 输入以下代码并执行：

wp.blocks.getBlockTypes().forEach(block => console.log(block.name));

这将输出所有已注册的区块类型名称。

注意：
– 此方法要求当前页面加载了 `wp-blocks` 脚本，通常仅在 WordPress 后台的区块编辑器中可用。
– 若控制台提示 `wp is not defined`，说明不在正确的上下文中执行。

区块名称列表获取方法 2：使用浏览器扩展工具

适用于希望可视化查看区块信息或调试区块结构的用户。

1. 安装 **React Developer Tools**（适用于 Chrome 或 Firefox）：

– 可检查区块对应的 React 组件及其属性（包括区块类型名称）。

2. 安装专为 WordPress 设计的 **Gutenberg Inspector** 等扩展（如有更新版本）：

– 提供更直接的区块信息查看功能。

操作建议：

在编辑器页面中打开开发者工具，使用 React Developer Tools 的“Components”面板浏览区块组件及其属性。

区块名称列表获取方法 3：通过 WordPress 后台直接查看

适用于不想使用代码或扩展的快速查看方式。

在 WordPress 后台新建或编辑一篇文章/页面。

切换到代码编辑器模式（右上角“选项”菜单中选择“代码编辑器”）。

观察已有的区块标记，例如：

<!-- wp:paragraph -->
<!-- wp:heading -->

这些注释标签中的名称即为区块类型名称。

注意：此方式仅能查看当前内容已使用的区块类型，而非所有注册的区块。

区块名称列表获取方法 4：通过自定义 PHP 代码输出

适用于需要在服务器端获取所有区块类型的场景（如插件开发或主题调试）。

创建一个简单的插件或在当前主题的 functions.php 中添加以下代码：

function list_registered_block_types() {
    if ( ! class_exists( 'WP_Block_Type_Registry' ) ) {
        return;
    }
    $registered_blocks = WP_Block_Type_Registry::get_instance()->get_all_registered();
    echo '<pre>';
    foreach ( $registered_blocks as $block ) {
        echo esc_html( $block->name ) . "n";
    }
    echo '</pre>';
}
// 仅限管理员查看（可选）
if ( current_user_can( 'manage_options' ) ) {
    add_action( 'wp_footer', 'list_registered_block_types' );
}

访问网站前台（或后台适当位置），代码会输出所有区块名称。

安全提示：

建议限制输出权限（如仅管理员可见），避免公开敏感信息。

生产环境中建议将输出记录到日志而非直接显示。

补充说明

区块类型的来源：
区块可能由 WordPress 核心、主题、插件注册，以上方法获取的是当前环境中所有已注册的区块。

动态上下文：
部分区块可能仅在特定条件（如启用某插件）下才被注册，结果会因页面和环境而异。

更详细的区块信息：
若需获取区块的详细属性（如标题、分类、图标等），可在控制台中使用：

wp.blocks.getBlockTypes().forEach(block => console.log(block));

或在 PHP 中打印 $registered_blocks 数组的全部内容。

REST API 方式（进阶）：
通过 WordPress REST API 的 /wp/v2/block-types 端点也可获取区块类型列表，但需处理认证和权限问题。

根据你的具体需求（如调试、开发或简单查看），选择最适合的方法即可。