render_block_core_tag_cloud()


WordPressのrender_block_core_tag_cloud()関数は、タグクラウドブロックをレンダリングするために使用されます。この関数は、タグのリストを視覚的に表示するためのHTMLを生成します。

構文

render_block_core_tag_cloud( array $attributes );

引数の説明:

  • $attributes (array) — タグクラウドの表示設定を含む配列
  • ['showTagCounts'] (bool) — タグの投稿数を表示するかどうか
  • ['smallestFontSize'] (string) — 最小フォントサイズ
  • ['largestFontSize'] (string) — 最大フォントサイズ
  • ['unit'] (string) — フォントサイズの単位（px, emなど）
  • ['taxonomy'] (string) — 使用するタクソノミー（post_tag, categoryなど）

例1: 基本的なタグクラウドの表示

デフォルト設定でタグクラウドを表示します。

echo render_block_core_tag_cloud( [] );

例2: 投稿数付きで表示

各タグの投稿数を表示します。

echo render_block_core_tag_cloud( ['showTagCounts' => true] );

例3: フォントサイズの変更

タグクラウドのフォントサイズ範囲を変更します。

echo render_block_core_tag_cloud( ['smallestFontSize' => '12px', 'largestFontSize' => '24px'] );

例4: カテゴリーを表示

タグの代わりにカテゴリーを表示します。

echo render_block_core_tag_cloud( ['taxonomy' => 'category'] );

例5: em単位で表示

フォントサイズの単位をemに変更します。

echo render_block_core_tag_cloud( ['unit' => 'em'] );

例6: カスタムタクソノミーを表示

カスタムタクソノミーを使用してクラウドを表示します。

echo render_block_core_tag_cloud( ['taxonomy' => 'custom_tax'] );

例7: 最小フォントサイズのみ変更

最小フォントサイズだけを指定します。

echo render_block_core_tag_cloud( ['smallestFontSize' => '10px'] );

注意点

  • タクソノミーが存在しない場合、空の文字列が返されます
  • フォントサイズの値は正の数である必要があります
  • この関数はブロックエディター用に設計されています

関連機能：