wp_render_block_style_variation_class_name()


WordPressの関数wp_render_block_style_variation_class_name()は、特定のブロックのスタイル変異に対応するクラス名を生成するために使用されます。

構文

wp_render_block_style_variation_class_name( string $block_name, string $style_variation = '' );

引数の説明:

  • $block_name (string) — 対象のブロックの名前。例えば「core/paragraph」など。
  • $style_variation (string) — スタイル変異の名前（オプション）。スタイルのバリエーションを指定する。

例 1: ブロック名によるクラス名の取得

指定したブロック名に基づいて、スタイルの変異に関するクラス名を取得します。

<?php echo wp_render_block_style_variation_class_name( 'core/paragraph' ); ?>

例 2: スタイル変異を指定してクラス名を取得

特定のスタイル変異を持つブロックに対して、クラス名を生成します。

<?php echo wp_render_block_style_variation_class_name( 'core/paragraph', 'bold' ); ?>

例 3: 空のスタイル変異を渡す

スタイル変異を指定せず、デフォルトのクラス名を取得します。

<?php echo wp_render_block_style_variation_class_name( 'core/paragraph', '' ); ?>

例 4: カスタムブロック名を使用してクラス名を取得

独自のカスタムブロック名を指定してクラス名を取得することもできます。

<?php echo wp_render_block_style_variation_class_name( 'my-plugin/custom-block' ); ?>

例 5: 複数のスタイル変異を使用したクラス名の取得

スタイル変異を複数指定し、カスタムスタイルに対応するクラス名を取得する例です。

<?php echo wp_render_block_style_variation_class_name( 'core/paragraph', 'italic' ); ?>
<?php echo wp_render_block_style_variation_class_name( 'core/paragraph', 'underline' ); ?>

注意事項

  • $block_nameと$style_variationの引数は、正しいブロック名とスタイル変異の名前を使用することが重要です。
  • カスタムブロックを使用する場合、事前にブロックのスタイルと変異を適切に登録しておく必要があります。
  • スタイル変異が指定されていない場合、デフォルトのクラス名が使用されます。

関連機能：