HOWTO · JavaScript

JavaScript で CSS クラスを変更する

className と classList を使って要素の CSS クラスを変更する方法を、クリックで動作する例とともに学びます。

このページの内容

JavaScript で要素の外観を変更するには、その要素を選択し、クラスを更新します。クラス属性全体を置き換える場合は className を代入し、他のクラスを保持しながら個々のクラストークンを追加、削除、置換する場合は classList を使います。クリックリスナーを使えば、読者の操作に応じて変更を行うこともできます。

JavaScript で CSS クラスを変更するさまざまな方法

以下に示す完全なページでは、div に ID dimensions を与え、CSS クラスでサイズと背景を制御します。初期クラス bg_1 は深紅色の背景を設定します。要素をクリックするとそのクラスが削除され、青緑色の背景を設定する bg_2 が追加されます。ページを HTML ファイルとして保存し、ブラウザで開くと、切り替わりの様子を確認できます。

className プロパティの使用

className はメソッドではなくプロパティです。文字列を代入すると、要素のクラス属性全体が置き換わります。たとえば "dimensions bg_2" と設定すると、背景が変わり、サイズ用のクラスは保持されます。"bg_2" だけに設定すると dimensions も削除されるため、要素に残すべきクラスはすべて含めてください。この方法は、既知の状態クラスのグループを一度に適用する場合など、クラスの完全な集合を意図的に定義したいときに便利です。

classList.remove と classList.add の使用

classList は、個々のクラストークンを編集するメソッドを提供するプロパティです。classList.remove("bg_1") と classList.add("bg_2") を呼び出すと、dimensions やその他の無関係なクラスに影響を与えることなく背景クラスを変更できます。add は既に存在するトークンを重複して追加せず、remove は指定したトークンにのみ作用します。これらの操作は、ページの他の動作によって追加されたクラスを含め、そのまま残すべきクラスが要素にある場合に使用します。

classList.replace() メソッドの使用

classList.replace("bg_1", "bg_2") は、1つのトークンを別のトークンに置き換え、他のクラスはそのままにします。置換が行われるのは bg_1 が存在する場合のみで、古いトークンが存在しない場合はどのトークンも変更されません。あるクラスの状態が別の状態に直接対応する場合にこのメソッドを選んでください。remove と add を別々に呼び出す方法は、2つの操作を明示したい場合や、ハンドラーがその間に別の処理を行う場合に便利です。

以下は、スタイル、要素、クリックハンドラーを含む完全な HTML ページです。末尾にある小さな JavaScript アダプターは、同じページ操作をモデル化しており、例が決定的なコンソール結果も持てるようになっています。ブラウザでは、ページ内のインラインスクリプトが実際のクリックを処理します。

const html = `<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Change a CSS class</title>
  <style>
    .dimensions { width: 200px; height: 100px; }
    .bg_1 { background-color: crimson; }
    .bg_2 { background-color: teal; }
  </style>
</head>
<body>
  <div id="dimensions" class="dimensions bg_1">Click this box</div>
  <script>
    const element = document.getElementById("dimensions");
    element.addEventListener("click", () => {
      element.classList.remove("bg_1");
      element.classList.add("bg_2");
    });
  </script>
</body>
</html>`;

const element = {
  className: "dimensions bg_1",
  addEventListener(type, handler) {
    this.handler = handler;
  },
  classList: {
    remove(token) {
      element.className = element.className
        .split(" ")
        .filter((name) => name !== token)
        .join(" ");
    },
    add(token) {
      const names = element.className.split(" ");
      if (!names.includes(token)) names.push(token);
      element.className = names.join(" ");
    }
  }
};
const document = { getElementById: () => element };
const selected = document.getElementById("dimensions");
selected.addEventListener("click", () => {
  selected.classList.remove("bg_1");
  selected.classList.add("bg_2");
});
selected.handler();
console.log(selected.className);
dimensions bg_2

ブラウザ側の部分は実際の DOM パターンを示しています。document.getElementById("dimensions") が要素を返し、addEventListener がクリック時に実行されるコールバックを登録します。Node.js にはページの DOM がデフォルトでは用意されていないため、Node.js アダプターがコンソール出力用にクラストークンの変更を再現します。表示される色はスタイルシートによって決まります。対応する CSS ルールが存在しない限り、クラス名を変更するだけでは視覚的な効果はありません。直接かつ完全に置き換える場合は className を使い、保持すべきクラスをすべて列挙してください。サイズ、レイアウト、無関係な状態のクラスに触れない対象を絞った変更には、classList のメソッドを使用します。ハンドラーが何もしていないように見える場合は、ID が一致していることと、両方の背景クラスがページのスタイルシートで定義されていることを確認してください。