インストール

モジュールをインストールします 

  1. npm install @wordpress/babel-preset-default --save-dev

注意: このパッケージは、長期サポートステータスのあるNode.jsバージョンを必要とします（アクティブLTSまたはメンテナンスLTSリリースを確認）。古いバージョンとは互換性がありません。

使用法

Babelを構成する方法はいくつかあります。詳細については、Babelの構成ドキュメントを参照してください。このプリセットを使用するには、Babel構成のpresetsオプションで@wordpress/babel-preset-defaultを参照するだけです。

例えば、.babelrcを使用する場合: 

  1. {
  2.    "presets": [ "@wordpress/babel-preset-default" ]
  3. }

構成の拡張

このプリセットは意見に基づいた構成です。この構成を追加または変更したい場合は、Babel構成を拡張して、このプリセットを通じて含まれるプラグインやプリセットを上書きすることができます。このプリセットを通じてデフォルトで有効になっている特定のプラグインを確認するには、構成の実装に慣れておくと良いでしょう。

例えば、WordPressの安定性要件に達していない新しい言語機能提案を使用したい場合は、それらをBabel構成に追加のプラグインとして追加できます: 

  1. {
  2.    "presets": [ "@wordpress/babel-preset-default" ],
  3.    "plugins": [ "@babel/plugin-proposal-class-properties" ]
  4. }

ポリフィル

ECMAScriptの機能をポリフィルするための補完的なbuild/polyfill.js（圧縮版 – build/polyfill.min.js）ファイルが利用可能で、WordPressプロジェクトによってサポートされているbrowsers supportedで不足している機能をポリフィルします（#31279）。これは、非推奨の@babel/polyfillパッケージのドロップイン置き換えであり、core-jsプロジェクトにも基づいています。

使用される機能がポリフィルを必要とする場合、これを含める必要があります。コンパイルされたコードの先頭に追加するか、<script>の前に含めることができます。

TC39提案

ステージ4ではない提案を使用する必要がある場合、このポリフィルは自動的にそれらをインポートしません。core-jsのような別のポリフィルから個別にインポートする必要があります。

このパッケージへの貢献

これはGutenbergプロジェクトの一部である個別のパッケージです。このプロジェクトはモノレポとして整理されています。特定の目的を持つ複数の自己完結型ソフトウェアパッケージで構成されています。このモノレポ内のパッケージはnpmに公開され、WordPressや他のソフトウェアプロジェクトで使用されています。

このパッケージやGutenberg全体への貢献について詳しく知りたい場合は、プロジェクトの主要な貢献者ガイドをお読みください。