wp_render_block_style_variation_support_styles()


WordPressの関数wp_render_block_style_variation_support_styles()は、特定のブロックスタイルのバリエーションに関連するサポート用のCSSスタイルを出力するために使用されます。

構文

wp_render_block_style_variation_support_styles( string $block_name, string $style_variation );

引数の説明:

  • $block_name (string) — 対象となるブロックの名前
  • $style_variation (string) — 適用するスタイルバリエーションの名前

例1: ブロックスタイルのバリエーションCSSを出力する

指定したブロックに対して、スタイルのバリエーションを反映するCSSを出力します。

<?php wp_render_block_style_variation_support_styles( 'core/button', 'outline' ); ?>

例2: カスタムブロックのスタイルバリエーションCSSを出力する

カスタムブロックにスタイルバリエーションを適用する場合、以下のように使用します。

<?php wp_render_block_style_variation_support_styles( 'my-plugin/my-block', 'highlight' ); ?>

例3: 複数のブロックスタイルバリエーションを出力する

複数のブロックスタイルバリエーションを同時に出力する例です。

<?php 
wp_render_block_style_variation_support_styles( 'core/paragraph', 'bold' );
wp_render_block_style_variation_support_styles( 'core/paragraph', 'italic' );
?>

例4: スタイルバリエーションが存在するかチェックする

スタイルバリエーションが存在するかをチェックしてから出力する方法です。

<?php 
if ( has_block_style( 'core/heading', 'large' ) ) {
    wp_render_block_style_variation_support_styles( 'core/heading', 'large' );
}
?>

例5: 条件に基づいてスタイルバリエーションを変更する

条件に応じて異なるスタイルバリエーションを適用する場合の例です。

<?php 
$style = ( is_page_template( 'landing-page.php' ) ) ? 'full-width' : 'default';
wp_render_block_style_variation_support_styles( 'core/paragraph', $style );
?>

注意点

  • この関数は主にブロックエディタで使用されるため、テーマやプラグイン内で適切なタイミングで呼び出す必要があります。

関連機能：