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' )
);
依存関係が宣言された後、グローバルwp
を使用してJavaScriptコード内でモジュールにアクセスできます:
const { PlainText } = wp.blockEditor;
npmを介してパッケージを使用する
すべてのパッケージは、コードにバンドルしたい場合に npm でも利用可能です。
同じPlainText
の例を使用して、npmでブロックエディターモジュールをインストールします:
npm install @wordpress/block-editor --save
インストール後、コード内でコンポーネントにアクセスできます:
import { PlainText } from '@wordpress/block-editor';
特定の主要なWordPressバージョンからJavaScriptコードをテストする
特定のWordPress主要バージョンで使用される個々のWordPressパッケージのバージョンを迅速にインストールする方法があります。これはnpm配布タグを使用します(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
)。各個別のdist-tagは常にその主要バージョンラインの最新のバグ修正リリースを指します。