55 lines
1.7 KiB
Markdown
55 lines
1.7 KiB
Markdown
|
# 包引用指南
|
||
|
|
|
||
|
|
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`）。每个分发标签始终指向对应主版本线的最新错误修复版本。
|