WordPress 7.2前に確認、同梱@wordpress/*のCSSクラス名衝突の修正
WordPress 7.2の開発者ノートが公開。同梱した@wordpress/*パッケージのCSSモジュールでクラス名が衝突する問題と、更新が必要なバージョンを整理します。
WordPress 7.2の開発者向けノートとして、2026年11月16日にMake WordPress Coreで「バンドルした@wordpress/*パッケージと@wordpress/buildを更新して、CSSモジュールのクラス名の衝突を解消する」という投稿が公開されました。プラグインに@wordpress/*パッケージを同梱している開発者は、7.2のリリース前に、該当パッケージを更新して再リリースするよう求められています。WordPressのCSSモジュールのクラス名衝突の原因と、対応が必要な範囲を整理します。
衝突の原因はクラス名が「ファイルパスとクラス名だけ」で決まっていたこと
投稿(著者はLena Morita氏、タグは7.2・dev-notes・dev-notes-7-2)によると、原因は、パッケージをコンパイルする@wordpress/buildのバグでした。クラス名は、それを定義するCSSが変わるたびに変わる設計でした。ところが実際には、クラス名がファイルパスとクラス名だけに依存していたため、CSSの中身が違っても同じ名前になってしまいました。
その結果、同じページに「WordPress本体のコピー」と「プラグインに同梱されたコピー」のようにスタイルの異なる2つのコピーが読み込まれると、片方のスタイルがもう片方のコンポーネントに当たってしまいます。投稿では具体例として、ホバーしたすべてのタブにフォーカスリングが表示される不具合が挙げられ、Gutenbergのプルリクエスト#85896が紹介されています。この問題は、これらのパッケージの、修正前に公開されたすべてのバージョンに影響するとされています。
7.2からは「CSSが同じときだけ」同じクラス名になる
修正の内容は、クラス名が、定義するCSSが変わるたびに変わるようになった、というものです(Gutenbergのプルリクエスト#85900)。クラス名が共有されるのは、CSSが完全に同一の場合だけです。WordPress 7.2に同梱されるパッケージは新しい方式でビルドされるので、プラグインが同梱している古いコピーとは衝突しなくなります。
ただし、投稿は限界も書いています。7.2より前にビルドされた2つのコピー同士は、これからも衝突する可能性があります。たとえば、同じサイトにある2つのプラグインが、それぞれ異なる古い@wordpress/uiを同梱している場合です。古いコピーを同梱したプラグインが2つ以上ある場合は、どちらかが更新しない限り衝突が残ります。
更新すべきパッケージと最低バージョン
投稿には、修正を含む最初のバージョンが一覧になっています。
| パッケージ | 修正を含む最初のバージョン |
|---|---|
| @wordpress/ui | 0.26.0 |
| @wordpress/dataviews | 22.0.0 |
| @wordpress/admin-ui | 3.1.0 |
| @wordpress/grid | 0.11.0 |
| @wordpress/components | 44.0.0 |
@wordpress/componentsについては、プラグインがwp-componentsスクリプト経由で読み込む場合、WordPress 7.2が修正版を提供するため、プラグイン側でパッケージを更新する必要はありません(筆者補足:7.2未満のサイトでは本体側の古いコピーが使われます)。自分のビルドにバンドルしている場合は、上の表のバージョン以上に更新します。また、@wordpress/buildでCSSモジュールをコンパイルしているプラグインは、@wordpress/buildを0.27.0以上に更新して再ビルドする必要があります。
自分のプラグインが対象かを調べる手順
投稿に具体的なコマンドは載っていませんが、一般的な確認の流れは次のとおりです。ここは筆者の補足です。
- package.jsonのdependenciesとdevDependencies(間接的な依存を含む)に、上の表のパッケージや@wordpress/buildが入っているかを確認する。
- 入っていれば、ロックファイルで実際に入っているバージョンを調べ、表の最低バージョン未満なら更新する(npmなら「npm ls パッケージ名」で、間接依存も含めて確認できます)。
- 更新したら再ビルドし、新しいバージョンのプラグイン・テーマとして配布する。
wp-componentsなどのWordPress本体のスクリプトだけを使っているなら、作業は不要なケースがほとんどだと考えられますが、同梱しているかどうかはビルド設定で確かめるのが確実です。
期限は7.2の正式リリース前、予定日は12月8日
投稿が示している期限は「before WordPress 7.2」で、投稿自体に具体的な日付はありません。ただし、Beta 5の告知(2026年11月10日)には、7.2の正式リリース予定日が2026年12月8日と書かれています。7.2は現在ベータ版の段階で、リリース直前に慌てないよう、今のうちに依存パッケージを見直しておくほうが安全です。WordPress 6.3以降の古いバージョンにも対応しているプラグインへの影響については、コメント欄で質問が出ていますが、本文にもコメント欄にも回答はありません(11月17日時点)。互換性の範囲を広く取っているプラグインは、この点が未確定だと理解しておく必要があります。
CSSの衝突は管理画面の小さな崩れとして現れる
ここからは筆者の見方です。CSSのクラス名が衝突する不具合は、PHPのエラーのようにログにも残らないぶん、気づきにくい種類のバグです。ホバーしたときだけ意図しない枠が出る、といった細かい崩れは、テストで見落とされがちです。しかも、原因は自分のコードではなく、同じ画面に載っている別のプラグインのバンドルである可能性があります。
プラグインを複数入れた環境では、「どの更新が効いたのか」が分かりにくくなります。7.2以降に管理画面の崩れが報告されたときは、本体ではなく、古い@wordpress/*を同梱した別のプラグインとの組み合わせを疑ってみてください。再現できないときは、プラグインを1つずつ無効にして切り分けるのが近道です。
PR エックスサーバー
WordPressを、速く・止まらずに運営したい方へ
サーバー選びを間違えると、表示が遅い・サイトが止まるリスクがあります
こんなお悩みはありませんか?
- どのレンタルサーバーを選べばよいか分からない
- 表示が遅い・サイトが落ちるのが心配
- WordPressの設定やセキュリティに自信がない
サーバーは、あとから乗り換えると、データの移行やドメインの設定に手間がかかります。表示が遅い、突然止まるといったトラブルは、訪問者が離れる原因にもなります。最初に、稼働率の保証や実績を確認して選ぶのが安全です。
エックスサーバーなら、WordPressの運営に強いレンタルサーバーを、迷わず選べます。国内でWordPressを利用して運用されているサイトの集計(Dataprovider.com調べ、2025年6月)で、国内シェアNo.1と公式サイトに記載されています。
選ばれるポイント
- WordPressサイトの国内シェアNo.1。実績で選びたいときの安心材料(Dataprovider.com調べ、2025年6月)
- サイトが止まりにくい。月間稼働率99.99%以上を保証し、下回ると月額費用の一部を返金
- 攻撃に強い。WordPressを狙った攻撃の99%以上を未然に防ぐ機能(2024年9月15日〜11月15日の当社調べ)
- ドメイン代を節約できる。独自ドメインが永久無料(対象ドメイン・契約期間などの条件あり)
- テーマ選びも安心。人気テーマ「Cocoon」の開発・提供元が運営
- 10日間の無料お試しで、契約前に操作や表示の速さを確かめられる
10日間の無料お試しで、契約前に試せます
10日間無料でお試し
広告(アフィリエイト)を含みます。特長は2026年11月8日時点の公式サイトの記載で、数値・順位は各調査・調べの時点のものです。料金・条件は公式サイトでご確認ください。
出典(参考にした公式情報)
- Make WordPress Core「Update bundled @wordpress/* packages and @wordpress/build to fix CSS module class name collisions」(2026年11月16日)
- WordPress.org News「WordPress 7.2 Beta 5」(2026年11月10日)
2026年11月17日時点の情報です。
本記事は情報提供を目的としています。WordPress本体やテーマ・プラグインのバージョンによって動作が異なる場合があるため、本番環境に反映する前に、必ずテスト環境で動作を確認してください。