wp_get_block_style_variation_name_from_class()


WordPressの関数wp_get_block_style_variation_name_from_class()は、指定されたクラスからブロックスタイルのバリエーション名を取得するために使用されます。

構文

wp_get_block_style_variation_name_from_class( string $class );
  • $class (string) — クラス名を指定します。通常、ブロックスタイルのクラス名です。

例1: クラス名からバリエーション名を取得

指定されたクラス名に基づいて、スタイルバリエーション名を取得します。

<?php
$class = 'wp-block-button__link';
$variation_name = wp_get_block_style_variation_name_from_class( $class );
echo $variation_name;
?>

例2: ブロックスタイルのバリエーションをチェック

特定のクラスに基づいてバリエーション名を取得し、その結果に基づいて条件を設定します。

<?php
$class = 'wp-block-button__link is-style-outline';
$variation_name = wp_get_block_style_variation_name_from_class( $class );
if ( $variation_name ) {
    echo 'スタイルバリエーション名: ' . $variation_name;
} else {
    echo 'バリエーションが見つかりません';
}
?>

例3: デフォルトのクラスでスタイルを取得

デフォルトのスタイルを持つクラスからバリエーション名を取得します。

<?php
$class = 'wp-block-cover';
$variation_name = wp_get_block_style_variation_name_from_class( $class );
echo 'デフォルトスタイル: ' . $variation_name;
?>

例4: スタイルのバリエーションが存在しない場合

存在しないバリエーションのクラス名を指定して、結果がないことを確認します。

<?php
$class = 'wp-block-paragraph is-style-custom';
$variation_name = wp_get_block_style_variation_name_from_class( $class );
if ( ! $variation_name ) {
    echo '指定されたバリエーションは存在しません';
}
?>

例5: 特定のスタイルが適用されているかどうかの確認

スタイルバリエーション名を取得し、その適用を確認するために使用します。

<?php
$class = 'wp-block-quote is-style-large';
$variation_name = wp_get_block_style_variation_name_from_class( $class );
echo $variation_name ? '適用されたバリエーション: ' . $variation_name : 'バリエーションなし';
?>

注意点

  • 指定されたクラスがスタイルのバリエーションを持たない場合、関数は空の値を返します。
  • この関数は、主にテーマやプラグインでカスタムブロックスタイルのバリエーションを管理する際に便利です。

関連機能：