包引用指南

WordPress 为开发者提供了一系列JavaScript包和工具集。

通过 WordPress 全局变量使用包

这些 JavaScript 包在 WordPress 中作为已注册的脚本提供，可通过全局变量 wp 进行访问。

若需使用区块编辑器模块中的 PlainText 组件，首先需要在加载脚本时声明 wp-block-editor 为依赖项：

wp_enqueue_script(
	'my-custom-block',
	plugins_url( $block_path, __FILE__ ),
	array( 'react', 'wp-blocks', 'wp-block-editor', 'wp-i18n' )
);

声明依赖关系后，即可在 JavaScript 代码中通过全局变量 wp 访问该模块：

const { PlainText } = wp.blockEditor;

如果您希望将包代码打包到项目中，所有包均已发布在 npm 平台。

以相同的 PlainText 组件为例，您需要通过 npm 安装区块编辑器模块：

npm install @wordpress/block-editor --save

安装完成后，可通过以下方式在代码中访问该组件：

import { PlainText } from '@wordpress/block-editor';

通过 npm 分发标签可快速安装与指定 WordPress 主版本对应的包版本（以 WordPress 5.8.x 为例）：

npm install @wordpress/block-editor@wp-5.8

也可通过单一命令更新项目中所有已安装的 WordPress 包：

npx @wordpress/scripts packages-update --dist-tag=wp-5.8

支持从 5.7.x 起始的所有 WordPress 主版本（例如 wp-5.7 或 wp-6.0）。每个分发标签始终指向对应主版本线的最新错误修复版本。