wp_apply_generated_classname_support()


WordPressの関数wp_apply_generated_classname_support()は、生成されたクラス名を要素に適用するための機能を提供します。

構文

wp_apply_generated_classname_support( string $type, array $args = array() );

引数の説明:

  • $type (string) — クラス名を適用する要素のタイプ（例: ‘block’, ‘widget’）
  • $args (array) — 追加の設定パラメータ

例1: ブロックにクラス名を適用

基本的なブロック要素に生成されたクラス名を適用します。

wp_apply_generated_classname_support( 'block', array( 'name' => 'core/paragraph' ) );

例2: ウィジェットにカスタムクラスを追加

ウィジェット要素に生成されたクラス名を適用します。

wp_apply_generated_classname_support( 'widget', array( 'class' => 'custom-widget' ) );

例3: カスタム要素タイプのサポートを追加

新しい要素タイプにクラス名サポートを追加します。

wp_apply_generated_classname_support( 'custom-type', array( 'prefix' => 'my-prefix' ) );

例4: 複数の引数を指定して使用

複数の引数を指定してクラス名を生成します。

wp_apply_generated_classname_support( 'block', array( 'name' => 'core/heading', 'attributes' => array( 'level' => 2 ) ) );

例5: フィルターフックとの組み合わせ

フィルターフックと組み合わせてクラス名をカスタマイズします。

add_filter( 'generate_classname', function( $classname ) { return $classname . '-modified'; } );

例6: テーマ内での利用

テーマのfunctions.phpで使用する例。

add_action( 'after_setup_theme', function() { wp_apply_generated_classname_support( 'theme-element' ); } );

例7: プラグイン開発での利用

プラグイン開発でクラス名サポートを追加する例。

register_activation_hook( __FILE__, function() { wp_apply_generated_classname_support( 'plugin-component' ); } );

注意点

  • この関数はWordPressの最新バージョンでのみ利用可能です
  • 無効な要素タイプを指定するとエラーが発生する可能性があります
  • クラス名の生成ルールはWordPressのコア実装に依存します

関連機能：