mitmario.dev

Klassen schalten

JavaScript Im Browser 3 Min Lesezeit 3 BeispieleLektion 3 von 9

Wählst du eine Karte, soll sie hervorgehoben sein, solange sie gewählt bleibt. Danach sieht sie wieder normal aus. Das Aussehen dafür steht im Stylesheet unter einer Klasse. JavaScript sagt nur, welcher Zustand gerade gilt, und so bleiben Aussehen und Programm sauber getrennt.

Vier Methoden an classList

add, remove und contains
const karte = document.getElementById("karte");

karte.classList.add("ist-aktiv");
console.log("nach add:", karte.className);

// Mehrere auf einmal gehen auch.
karte.classList.add("gross", "hervor");
console.log("nach add:", karte.className);

// Eine Klasse zweimal hinzuzufügen ändert nichts.
karte.classList.add("gross");
console.log("immer noch:", karte.className);

karte.classList.remove("hervor");
console.log("nach remove:", karte.className);

// Eine Klasse zu entfernen, die gar nicht da ist, ist erlaubt
// und tut nichts. Es gibt keinen Fehler dafür.
karte.classList.remove("gibt-es-nicht");

console.log("aktiv?", karte.classList.contains("ist-aktiv"));
console.log("Anzahl:", karte.classList.length);

classList ist die Sammlung der Klassen eines Elements. Alles, was man mit Klassen tun will, ist dort schon eingebaut.

add("ist-aktiv") fügt hinzu. Mehrere Namen in einem Aufruf sind erlaubt. Fügst du eine Klasse doppelt hinzu, ändert sich nichts, sie ist danach genau einmal da.

remove("hervor") nimmt weg. Eine Klasse zu entfernen, die gar nicht da ist, ist ausdrücklich erlaubt und tut einfach nichts, du musst also vorher nicht fragen.

contains("ist-aktiv") fragt nach und liefert true oder false, wie im letzten Abschnitt.

toggle("offen") schaltet um. Das ist der interessante Fall.

toggle mit zweitem Argument

toggle mit und ohne zweites Argument
const eins = document.getElementById("eins");
const zwei = document.getElementById("zwei");

// Ohne zweites Argument: an, wenn aus, und aus, wenn an.
console.log(eins.classList.toggle("offen"), eins.className);
console.log(eins.classList.toggle("offen"), eins.className);
console.log(eins.classList.toggle("offen"), eins.className);

// Mit zweitem Argument: setze auf genau diesen Zustand.
// Egal wie oft, das Ergebnis ist immer dasselbe.
const istAngemeldet = true;
zwei.classList.toggle("sichtbar", istAngemeldet);
zwei.classList.toggle("sichtbar", istAngemeldet);
console.log("zwei:", zwei.className);

// Das hier ist dieselbe Aussage in vier Zeilen.
if (istAngemeldet) {
  zwei.classList.add("sichtbar");
} else {
  zwei.classList.remove("sichtbar");
}

Ohne zweites Argument macht toggle, was der Name sagt. Ist die Klasse da, kommt sie weg. Ist sie weg, kommt sie hin. Zurück gibt es true, wenn die Klasse danach da ist. Für einen Button, der ein Menü auf- und zuklappt, passt das.

Mit zweitem Argument setzt toggle einen Zustand. Bei toggle("sichtbar", istAngemeldet) ist die Klasse danach da, wenn der Wert true ist, und weg, wenn er false ist. Wie oft die Zeile läuft, spielt keine Rolle.

In der Eingabezeile der Console siehst du das am Rückgabewert. Am Ende des Beispiels trägt eins die Klasse, denn dreimal umgeschaltet heißt einmal an. eins.classList.toggle("offen") antwortet dort mit false und beim nächsten Mal mit true, jede Eingabe schaltet um. eins.classList.toggle("offen", false) antwortet dagegen mit false und beim zweiten Mal wieder mit false, weil das zweite Argument den Zustand festlegt, statt umzuschalten.

Unten im Beispiel steht dieselbe Aussage noch einmal ausgeschrieben, vier Zeilen mit if, add, else und remove. Das ist nicht nur länger. Der Klassenname steht dort an zwei Stellen. Benennst du eine davon um und vergisst die andere, lässt sich der Zustand zwar anschalten, aber nicht mehr abschalten.

Sobald eine Bedingung im Spiel ist, nehme ich toggle mit zweitem Argument. Für Umschalten ohne Bedingung bleibt toggle ohne.

Warum nicht className

Was className anrichtet
const mitListe = document.getElementById("mit-liste");
const mitText = document.getElementById("mit-text");

// classList.add ergänzt.
mitListe.classList.add("ist-aktiv");
console.log("classList:", mitListe.className);

// className = überschreibt alles. Die drei Klassen aus dem
// Markup sind weg, und mit ihnen ihr Aussehen.
mitText.className = "ist-aktiv";
console.log("className:", mitText.className);

// Der beliebte Versuch, das zu retten, geht auch schief:
// ein fehlendes Leerzeichen macht aus zwei Klassen eine.
mitText.className = mitText.className + "gross";
console.log("und jetzt:", mitText.className);
console.log("ist gross dabei?", mitText.classList.contains("gross"));

className ist der ganze Text mit allen Klassen am Stück. Zum Lesen ist das manchmal praktisch, zum Schreiben fast immer falsch.

mitText.className = "ist-aktiv" setzt nicht eine Klasse, es ersetzt alle. Die drei Klassen aus dem Markup sind danach weg, und damit auch alles, was das Stylesheet an ihnen festgemacht hat.

Im Beispiel siehst du das nebeneinander. Die obere Karte behält Rahmen, Schatten und Schriftgröße und bekommt die Färbung dazu. Die untere steht am Ende ganz nackt da. Die erste Zuweisung nimmt ihr Rahmen, Schatten und Größe, die an karte und gross hingen, und nach dem Rettungsversuch weiter unten ist auch der helle Grund weg, denn die Klasse heißt jetzt ist-aktivgross. Oft merkt man das erst, wenn später jemand eine Klasse im Markup ergänzt und die plötzlich verschwindet.

Der übliche Rettungsversuch macht es nicht besser. className = className + "gross" hängt an, aber ohne Leerzeichen, und danach steht ist-aktivgross da, eine einzige Klasse mit genau diesem Namen. Die gibt es nirgends. contains("gross") sagt false, und im Stylesheet greift keine Regel. In der Eingabezeile der Console antwortet mitText.classList mit DOMTokenList {0: "ist-aktivgross"}, also mit einem Eintrag, während mitListe.classList daneben vier hat.

In diesem Kurs kommt className = deshalb nicht mehr vor. classList kann alles davon und macht dabei nichts kaputt.

Klasse oder style

Steht ein Wert vorher fest, gehört er ins Stylesheet und wird über eine Klasse geschaltet. ist-versteckt, hat-fehler und ist-aktiv sind Zustände. Wie sie aussehen, entscheidet das Design und nicht das Programm.

Erst wenn ein Wert zur Laufzeit entsteht und gar nicht im Stylesheet stehen kann, ist style dran, und darum geht es in der nächsten Lektion.

In der Aufgabe bekommen drei Karten ihre Zustände über Klassen, und einer davon hängt an einer Bedingung.

Zum Mitnehmen

classList ergänzt und entfernt einzelne Klassen, className mit Gleichheitszeichen überschreibt alle. toggle mit zweitem Argument setzt eine Klasse auf genau den Zustand einer Bedingung.

Jetzt du

Basis Konto, kostenlos

Zu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.

Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.

Was in dieser Lektion steckt

  • Artikel mit 3 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe im Editor, direkt im Browser geprüft

    Öffnet sich mit dem Basis Konto.