WordPressグローバルを介してパッケージを使用する

JavaScriptパッケージはWordPressに登録されたスクリプトとして利用可能で、wpグローバル変数を使用してアクセスできます。

ブロックエディターモジュールからPlainTextコンポーネントを使用したい場合、まずスクリプトをエンキューするときにwp-block-editorを依存関係として指定します:

  1. wp_enqueue_script(
  2. 'my-custom-block',
  3. plugins_url( $block_path, __FILE__ ),
  4. array( 'react', 'wp-blocks', 'wp-block-editor', 'wp-i18n' )
  5. );

依存関係が宣言された後、グローバルwpを使用してJavaScriptコード内でモジュールにアクセスできます:

  1. const { PlainText } = wp.blockEditor;

npmを介してパッケージを使用する

すべてのパッケージは、コードにバンドルしたい場合に npm でも利用可能です。

同じPlainTextの例を使用して、npmでブロックエディターモジュールをインストールします:

  1. npm install @wordpress/block-editor --save

インストール後、コード内でコンポーネントにアクセスできます:

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

特定の主要なWordPressバージョンからJavaScriptコードをテストする

特定のWordPress主要バージョンで使用される個々のWordPressパッケージのバージョンを迅速にインストールする方法があります。これはnpm配布タグを使用します(WordPress 5.8.xの例):

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

単一のコマンドでプロジェクト内のすべての既存のWordPressパッケージを更新することも可能です:

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

5.7.x以降のすべての主要なWordPressバージョンがサポートされています(例: wp-5.7またはwp-6.0)。各個別のdist-tagは常にその主要バージョンラインの最新のバグ修正リリースを指します。