# 包引用指南

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

## 通过 WordPress 全局变量使用包

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

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

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

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

```js
const { PlainText } = wp.blockEditor;
```

## 通过 npm 使用包

如果您希望将包代码打包到项目中，所有包均已发布在 [npm](https://www.npmjs.com/org/wordpress) 平台。

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

```bash
npm install @wordpress/block-editor --save
```

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

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

## 测试特定主版本 WordPress 的 JavaScript 代码

通过 [npm 分发标签](https://docs.npmjs.com/cli/v8/commands/npm-dist-tag) 可快速安装与指定 WordPress 主版本对应的包版本（以 WordPress `5.8.x` 为例）：

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

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

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

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