HOWTO · JavaScript

CSS-Klassen in JavaScript ändern

Erfahren Sie, wie Sie die CSS-Klassen eines Elements mit className und classList ändern, einschließlich eines klickgesteuerten Beispiels.

Auf dieser Seite

Um das Erscheinungsbild eines Elements mit JavaScript zu ändern, wählen Sie es aus und aktualisieren Sie seine Klassen. Weisen Sie className zu, wenn Sie das gesamte Klassenattribut ersetzen; verwenden Sie classList, um einzelne Klassen-Tokens hinzuzufügen, zu entfernen oder zu ersetzen und andere Klassen zu erhalten. Ein Klick-Listener kann die Änderung als Reaktion auf eine Aktion des Lesers vornehmen.

Verschiedene Möglichkeiten zum Ändern der CSS-Klasse in JavaScript

Die vollständige Seite unten gibt dem div die ID dimensions und steuert seine Größe und seinen Hintergrund über CSS-Klassen. Die anfängliche Klasse bg_1 legt einen karmesinroten Hintergrund fest. Ein Klick auf das Element entfernt diese Klasse und fügt bg_2 hinzu, die einen petrolfarbenen Hintergrund festlegt. Sie können die Seite als HTML-Datei speichern und in einem Browser öffnen, um den Übergang zu sehen.

Die Eigenschaft className verwenden

className ist eine Eigenschaft, keine Methode. Wenn Sie ihr eine Zeichenkette zuweisen, wird das vollständige Klassenattribut des Elements ersetzt. Setzen Sie sie beispielsweise auf "dimensions bg_2", ändert sich der Hintergrund und die Größenklasse bleibt erhalten. Würden Sie sie nur auf "bg_2" setzen, würde auch dimensions entfernt; geben Sie daher jede Klasse an, die das Element behalten soll. Dieser Ansatz ist nützlich, wenn Sie bewusst die vollständige Klassenmenge festlegen möchten, etwa um eine bekannte Gruppe von Zustandsklassen auf einmal anzuwenden.

classList.remove und classList.add verwenden

classList ist eine Eigenschaft, die Methoden zum Bearbeiten einzelner Klassen-Tokens bereitstellt. Rufen Sie classList.remove("bg_1") und classList.add("bg_2") auf, um die Hintergrundklassen zu ändern, ohne dimensions oder andere, nicht zusammenhängende Klassen zu beeinträchtigen. add fügt ein bereits vorhandenes Token nicht doppelt hinzu, und remove wirkt nur auf das benannte Token. Verwenden Sie diese Operationen, wenn ein Element Klassen hat, die an ihrem Platz bleiben sollen, einschließlich Klassen, die durch anderes Seitenverhalten hinzugefügt wurden.

Die Methode classList.replace() verwenden

classList.replace("bg_1", "bg_2") ersetzt ein Token durch ein anderes und lässt die übrigen Klassen unverändert. Der Ersatz geschieht nur, wenn bg_1 vorhanden ist; fehlt das alte Token, wird kein Token geändert. Wählen Sie diese Methode, wenn ein Klassenzustand direkt auf einen anderen abgebildet wird. Separate Aufrufe von remove und add sind nützlich, wenn Sie die beiden Operationen explizit machen möchten oder wenn der Handler zwischen ihnen andere Arbeit zu erledigen hat.

Hier ist eine vollständige HTML-Seite einschließlich ihrer Styles, ihres Elements und ihres Klick-Handlers. Der kleine JavaScript-Adapter am Ende bildet dieselbe Seiteninteraktion nach, damit das Beispiel auch ein deterministisches Konsolenergebnis hat; in einem Browser übernimmt das Inline-Skript der Seite den eigentlichen Klick.

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

Der Browser-Teil zeigt das echte DOM-Muster: document.getElementById("dimensions") gibt das Element zurück, und addEventListener registriert den Callback, der bei einem Klick ausgeführt wird. Der Node.js-Adapter gibt die Änderung der Klassen-Tokens für die Konsolenausgabe wieder, da Node.js standardmäßig kein DOM einer Seite bereitstellt. Das Stylesheet bestimmt die sichtbaren Farben; die Änderung eines Klassennamens allein hat keine visuelle Wirkung, solange keine passende CSS-Regel existiert. Für einen direkten vollständigen Ersatz verwenden Sie className und listen jede zu behaltende Klasse auf. Für eine gezielte Änderung, die Größen-, Layout- und nicht zusammenhängende Zustandsklassen unberührt lässt, verwenden Sie die Methoden von classList. Wenn Ihr Handler scheinbar nichts tut, prüfen Sie, ob die ID übereinstimmt und ob beide Hintergrundklassen im Stylesheet der Seite definiert sind.