add_cssclass()

2025/7/1 Tuesday

add_cssclass() は、HTML要素にクラスを追加するための関数です。

主に動的に要素のスタイルを変更したり、特定の条件で異なるクラスを適用したりする場合に使用されます。この関数を使用することで、コードの可読性を向上させつつ、スタイルの適用を柔軟に制御できます。

機能の説明

add_cssclass() は、HTMLの特定の要素に対してCSSクラスを追加するための関数です。主に以下のような用途で利用されます。

条件に応じたクラスの動的適用
既存のクラスに対する追加変更
WordPressのフィルターやアクションフックと組み合わせたクラス管理

シンプルなコード例

$classes = "default-class";
$classes = add_cssclass($classes, "new-class");
echo '<div class="' . esc_attr($classes) . '">Content</div>';

このコードでは、default-class というクラスに new-class を追加し、div 要素に適用しています。

使い方の説明

基本的な使用例

function add_cssclass($existing_classes, $new_class) {
    if (!empty($existing_classes)) {
        return $existing_classes . ' ' . $new_class;
    }
    return $new_class;
}

$existing_classes：既存のクラス名
$new_class：追加するクラス名
すでにクラスが存在する場合は、スペースを挟んで追加する

一緒に使うことが多い関連タグ

`get_body_class()`

$body_classes = get_body_class();
$body_classes = add_cssclass(implode(' ', $body_classes), 'custom-class');
echo '<body class="' . esc_attr($body_classes) . '">';

get_body_class() で取得したクラスリストに、custom-class を追加
implode(' ', $body_classes) で配列を文字列に変換

追加情報で取得したい場合

`get_post_class()` を活用する

$post_classes = get_post_class();
$post_classes = add_cssclass(implode(' ', $post_classes), 'highlight');
echo '<article class="' . esc_attr($post_classes) . '">';