wp_get_block_default_classname()


WordPressの関数wp_get_block_default_classname()は、ブロックのデフォルトCSSクラス名を生成するために使用されます。

構文

wp_get_block_default_classname( string $block_name );
  • $block_name (string) — ブロックの名前（例: ‘core/paragraph’）

例1: 基本的なブロッククラス名の取得

コアの段落ブロックのデフォルトクラス名を取得します。

echo wp_get_block_default_classname( 'core/paragraph' );

例2: カスタムブロックのクラス名生成

カスタムブロック’my-plugin/custom-block’のクラス名を生成します。

$class = wp_get_block_default_classname( 'my-plugin/custom-block' );

例3: 動的にブロック名を指定

変数を使用してブロッククラス名を取得します。

$block = 'core/image'; echo wp_get_block_default_classname( $block );

例4: HTML要素にクラスを追加

生成したクラス名をdiv要素に適用します。

<div class="<?php echo wp_get_block_default_classname( 'core/heading' ); ?>">

例5: 条件付きでクラス名を取得

ブロックが存在する場合のみクラス名を取得します。

if( block_exists( 'core/list' ) ) { echo wp_get_block_default_classname( 'core/list' ); }

例6: 複数ブロックのクラス名を一括取得

複数のブロッククラス名を配列で処理します。

$blocks = ['core/gallery', 'core/quote']; foreach( $blocks as $block ) { echo wp_get_block_default_classname( $block ); }

例7: ショートコード内での利用

ショートコード内でブロッククラス名を使用します。

add_shortcode( 'block_class', function( $atts ) { return wp_get_block_default_classname( $atts['name'] ); } );

注意点

  • ブロック名は正しい形式（’namespace/block-name’）で指定する必要があります
  • この関数はWordPress 5.6以降で利用可能です
  • 生成されるクラス名は常に’wp-block-‘プレフィックスを含みます

関連機能：