render_block_core_query_no_results()


WordPressのrender_block_core_query_no_results()関数は、クエリブロックで結果が見つからない場合に表示されるコンテンツをレンダリングするために使用されます。この関数は、カスタムメッセージやデフォルトの「結果なし」メッセージを表示するために活用できます。

構文

render_block_core_query_no_results( array $attributes );
  • $attributes(array) — クエリブロックの属性を指定します。例えば、カスタムメッセージやスタイル設定を含みます。

例1: デフォルトの「結果なし」メッセージを表示

この例では、クエリ結果がない場合にデフォルトのメッセージを表示します。

echo render_block_core_query_no_results( array() );

例2: カスタムメッセージを設定

クエリ結果がない場合に表示するカスタムメッセージを設定します。

echo render_block_core_query_no_results( array( 'message' => '該当する結果が見つかりませんでした。' ) );

例3: カスタムクラスを追加

クエリ結果がない場合に表示するメッセージにカスタムクラスを追加します。

echo render_block_core_query_no_results( array( 'className' => 'custom-no-results' ) );

例4: カスタムスタイルを適用

クエリ結果がない場合に表示するメッセージにカスタムスタイルを適用します。

echo render_block_core_query_no_results( array( 'style' => array( 'color' => '#ff0000' ) ) );

例5: カスタムHTMLを挿入

クエリ結果がない場合に表示するメッセージにカスタムHTMLを挿入します。

echo render_block_core_query_no_results( array( 'content' => '<p>カスタムHTMLコンテンツ</p>' ) );

例6: カスタムアイコンを表示

クエリ結果がない場合に表示するメッセージにカスタムアイコンを追加します。

echo render_block_core_query_no_results( array( 'icon' => 'dashicons-warning' ) );

例7: カスタムボタンを追加

クエリ結果がない場合に表示するメッセージにカスタムボタンを追加します。

echo render_block_core_query_no_results( array( 'buttonText' => 'ホームに戻る', 'buttonLink' => home_url() ) );

注意点

  • この関数は、クエリブロック内でのみ使用されます。
  • カスタムメッセージやスタイルを適用する際は、適切なHTMLやCSSの知識が必要です。
  • カスタムコンテンツを追加する場合は、セキュリティに注意してください。

関連機能：