WordPressでブロックウィジェットのカスタムHTMLが見えなくなる原因と対処法

Cocoonカスタマイズ集
この記事は約3分で読めます。
記事内に広告が含まれています。

はじめに

WordPressのブロックウィジェットで「カスタムHTML」ブロックにHTMLを入力すると、編集画面上でブロックが見えなくなることがあります。

例えば、画面にテキストとして表示する内容がないHTMLを登録した場合に発生します。

このような場合でも、リスト表示を開けば「カスタムHTML」ブロックが一覧に残っているため、そこから選択して確認できます。
また、編集画面に目印を表示する方法もあります。

この記事では、「カスタムHTML」ブロックが見えなくなる現象と、その原因、対処方法について紹介します。

現象

現象

ブロックウィジェットの編集画面で「カスタムHTML」ブロックを追加し、次のようなHTMLを入力すると、ブロックが見えなくなることがあります(図1参照)。

<div class="blog-parts"><div>
<script src="https://example.com/"></script>

この例のように、HTML要素やスクリプトの読み込みだけで構成され、画面上にテキストが表示されない場合に発生します。

実際に、以下でもウィジェット管理画面でブロックが見えなくなるという報告があります。

原因

WordPress 7.0から、「カスタムHTML」ブロックは入力したHTMLをプレビュー表示する仕組みに変更されました。

しかし、入力内容に画面上で表示するテキストや要素がない場合、プレビュー領域に表示するものがなく、ブロックが見えなくなることがあります。

その結果、プレビュー領域の高さが0になり、カスタムHTMLブロック自体が見えなくなることがあります。

この問題は以下でも不具合として報告されています。

対策

リスト表示から確認する

「カスタムHTML」ブロックが見えなくなった場合は、リスト表示から選択します(図1参照)。

  1. ブロックウィジェットの編集画面で、画面上部のリスト表示を開く
  2. 一覧からカスタムHTMLブロックを探す
  3. 該当するブロックを選択する
  4. ブロックの内容を確認・編集する

リスト表示には、編集画面上で見えなくなったカスタムHTMLブロックも表示されます。
ブロック自体が消えたわけではないため、一覧から選択すれば内容を確認できます。

編集画面に目印を表示する

リスト表示からブロックを選択する方法に加えて、編集画面に目印を表示する方法もあります。

完成イメージ

実装手順

以下のコードをfunctions.phpに追加します。

add_action('enqueue_block_editor_assets', function () {
  ob_start();
  ?>
  .wp-block-html {
    background-color: #f5f5f5;
    border: 1px dashed #999;
    padding: 12px;

    &::before {
      content: "カスタムHTML";
      text-align: center;
      display: block;
    }
  }
  <?php
  wp_add_inline_style('wp-admin', ob_get_clean());
});

まとめ

WordPressのブロックウィジェットでは、カスタムHTMLブロックに入力した内容によって、編集画面上でブロックが見えなくなることがあります。

その場合は、リスト表示から該当ブロックを選択すれば内容を確認できます。
また、「カスタムHTML」ブロックを編集画面だけに目印を表示する方法もあります。

タイトルとURLをコピーしました