wp_register_custom_classname_support()


WordPressの関数wp_register_custom_classname_support()は、カスタムクラス名のサポートを登録するために使用されます。主にブロックエディタでカスタムCSSクラスを追加できるようにします。

構文

wp_register_custom_classname_support( string $block_type, array $args = array() );

引数の説明:

  • $block_type (string) — ブロックタイプの名前（例: ‘core/paragraph’）
  • $args (array) — 追加の引数（オプション）

例1: 基本的な使用法

段落ブロックにカスタムクラスサポートを追加します。

wp_register_custom_classname_support( 'core/paragraph' );

例2: 複数のブロックに適用

複数のブロックタイプにカスタムクラスを登録します。

wp_register_custom_classname_support( 'core/heading' ); wp_register_custom_classname_support( 'core/image' );

例3: カスタムブロックでの使用

カスタムブロックにクラスサポートを追加します。

wp_register_custom_classname_support( 'my-plugin/custom-block' );

例4: 追加引数の使用

追加の引数を指定して登録します。

wp_register_custom_classname_support( 'core/group', array( 'custom' => true ) );

例5: テーマ内での登録

テーマのfunctions.phpで使用します。

add_action( 'after_setup_theme', function() { wp_register_custom_classname_support( 'core/columns' ); } );

例6: プラグイン内での登録

プラグイン初期化時に登録します。

register_activation_hook( __FILE__, function() { wp_register_custom_classname_support( 'core/button' ); } );

例7: 条件付き登録

特定の条件下でのみ登録します。

if ( function_exists( 'wp_register_custom_classname_support' ) { wp_register_custom_classname_support( 'core/cover' ); }

注意点:

  • この関数はWordPress 5.6以降で利用可能です
  • ブロックエディタが有効な場合のみ機能します
  • 登録はinitフック以降で行う必要があります

関連機能：