wp_get_elements_class_name()


WordPressのwp_get_elements_class_name()関数は、指定された要素のクラス名を取得するために使用されます。この関数は、テーマやプラグイン開発において、動的にクラス名を生成する際に役立ちます。

構文

wp_get_elements_class_name( string|array $elements, string $context = '' );

引数の説明:

  • $elements (string|array) — クラス名を取得したい要素の名前または配列。
  • $context (string) — クラス名を生成する際のコンテキスト。オプション。

例1: 単一の要素のクラス名を取得

この例では、単一の要素のクラス名を取得します。

<?php echo wp_get_elements_class_name( 'header' ); ?>

例2: 複数の要素のクラス名を取得

この例では、複数の要素のクラス名を配列で取得します。

<?php echo wp_get_elements_class_name( array( 'header', 'footer' ) ); ?>

例3: コンテキストを指定してクラス名を取得

この例では、コンテキストを指定してクラス名を取得します。

<?php echo wp_get_elements_class_name( 'header', 'custom-context' ); ?>

例4: 動的にクラス名を生成

この例では、動的にクラス名を生成して出力します。

<?php echo wp_get_elements_class_name( get_post_type() ); ?>

例5: カスタムクラス名を追加

この例では、カスタムクラス名を追加して出力します。

<?php echo wp_get_elements_class_name( 'header', 'custom-class' ); ?>

例6: 条件に基づいてクラス名を変更

この例では、条件に基づいてクラス名を変更します。

<?php echo wp_get_elements_class_name( is_front_page() ? 'home' : 'page' ); ?>

例7: フィルターフックを使用してクラス名を変更

この例では、フィルターフックを使用してクラス名を変更します。

<?php echo apply_filters( 'custom_class_name', wp_get_elements_class_name( 'header' ) ); ?>

注意点

  • この関数は、WordPressのバージョン5.5以上で利用可能です。
  • コンテキストを指定する場合、そのコンテキストに応じたクラス名が生成されます。
  • 動的にクラス名を生成する際は、セキュリティに注意してください。

関連機能：