mitmario.dev

Attribute setzen

JavaScript Im Browser 3 Min Lesezeit 3 BeispieleLektion 2 von 9

Solange ein Formular nicht fertig ist, soll sein Button gesperrt bleiben. Ein Link bekommt ein anderes Ziel, ein Bild eine Beschreibung. Das alles sind Attribute, und für die gibt es eigene Wege.

Der allgemeine Weg

setAttribute, removeAttribute und hasAttribute
const link = document.getElementById("link");
const bild = document.getElementById("bild");

// Setzen. Gibt es das Attribut schon, wird es überschrieben.
link.setAttribute("href", "/lernen/javascript");
link.setAttribute("title", "Der JavaScript-Kurs");
bild.setAttribute("alt", "Ein Beispielbild");

// Fragen.
console.log("hat title?", link.hasAttribute("title"));
console.log("hat target?", link.hasAttribute("target"));

// Entfernen.
link.removeAttribute("title");
console.log("und jetzt?", link.hasAttribute("title"));

// Was am Ende im Markup steht.
console.log(link.outerHTML);

Mit drei Methoden kommst du bei Attributen überall hin.

setAttribute("href", "/lernen/javascript") setzt ein Attribut. Gibt es das Attribut schon, wird sein Wert überschrieben, sonst kommt es dazu. Der Wert ist immer Text, auch wenn du eine Zahl übergibst.

hasAttribute("title") fragt, ob es da ist, und liefert true oder false.

removeAttribute("title") nimmt es weg. Ein Attribut auf "" zu setzen ist nicht dasselbe. Dann ist es nämlich immer noch da, nur leer.

Diese drei funktionieren bei jedem Attribut.

Der direkte Weg

Eigenschaft statt Attribut, und die Falle bei disabled
const eins = document.getElementById("eins");
const zwei = document.getElementById("zwei");
const drei = document.getElementById("drei");

// Der direkte Weg über die Eigenschaft. Kurz und lesbar.
eins.disabled = true;
console.log("eins gesperrt?", eins.disabled);

// Dasselbe über das Attribut. Der Wert ist dabei egal,
// es zählt nur, dass das Attribut da ist.
zwei.setAttribute("disabled", "");
console.log("zwei gesperrt?", zwei.disabled);

// Das hier gibt nichts frei.
drei.setAttribute("disabled", "false");
console.log("drei gesperrt?", drei.disabled);

// Freigeben geht nur so.
drei.disabled = false;
console.log("drei jetzt noch gesperrt?", drei.disabled);

Für viele Attribute gibt es zusätzlich eine Eigenschaft am Element, etwa el.id, el.href oder el.disabled. Die ist kürzer und meistens die bessere Wahl. Zwei Eigenschaften spiegeln ihr Attribut allerdings nicht. value und checked sagen, was gerade im Feld steht, und das Attribut bleibt dabei so, wie es im Markup stand.

Beim Lesen in Abschnitt 10 konnten Attribut und Eigenschaft schon auseinanderlaufen. getAttribute("href") lieferte den Text aus dem Markup, link.href die aufgelöste Adresse. Beim Schreiben kommt ein zweiter Unterschied dazu, und der hat mehr Folgen.

Bei Boolean-Attributen zählt nur, ob sie da sind. disabled, checked, required und readonly gelten, wenn das Attribut im Markup steht, und sonst nicht. Ihr Wert ist völlig egal.

Deshalb sperrt setAttribute("disabled", "false") am dritten Feld des Beispiels das Feld. Das sieht aus wie eine Freigabe und ist eine Sperre, denn das Attribut ist jetzt da. Freigeben geht nur mit removeAttribute("disabled") oder, viel lesbarer, mit el.disabled = false.

Bei Boolean-Attributen nehme ich deshalb die Eigenschaft. el.disabled = true und el.disabled = false sind eindeutig und kurz, und falsch verstehen kann man sie auch nicht. Einen Haken gibt es bei readonly. Die Eigenschaft heißt readOnly, mit großem O, und ein el.readonly = true tut gar nichts.

Am Ende des Beispiels ist das dritte Feld wieder frei. Fragst du in der Eingabezeile der Console nach document.getElementById("drei").getAttribute("disabled"), kommt null zurück. Die Eigenschaft hat das Attribut also nicht überstimmt, sie hat es weggenommen.

Eigene Daten schreiben

Eigene Daten mit dataset schreiben
const button = document.getElementById("speichern");

console.log("vorher:", button.dataset.version);

// Schreiben geht genauso wie Lesen.
button.dataset.version = "4";
console.log("nachher:", button.dataset.version);
console.log("im Markup:", button.getAttribute("data-version"));

// Ein neuer Name legt ein neues Attribut an. Aus kursId
// wird dabei data-kurs-id, die Umschreibung läuft rückwärts.
button.dataset.kursId = "javascript";
console.log(button.outerHTML);

// Wegnehmen geht mit delete.
delete button.dataset.kursId;
console.log("danach:", button.outerHTML);

Aus dataset lesen kennst du aus Abschnitt 10, und Schreiben geht genauso. button.dataset.version = "4" setzt das Attribut data-version.

Die Umschreibung zwischen den beiden Schreibweisen klappt rückwärts wie vorwärts. dataset.kursId erzeugt data-kurs-id. Vor jeden Großbuchstaben kommt ein Bindestrich, und der Buchstabe wird klein.

Wegnehmen geht mit delete button.dataset.kursId. Das ist eins der wenigen Male in diesem Kurs, dass delete überhaupt vorkommt.

Klasse oder data-Attribut

Beides beschreibt etwas am Element. Es lohnt sich trotzdem, die beiden auseinanderzuhalten.

Eine Klasse ist ein Zustand, den es gibt oder nicht, etwa ist-aktiv, ist-versteckt oder hat-fehler. Sie hängt am Aussehen, deshalb steht die passende Regel im Stylesheet. In der nächsten Lektion wird sie zum Werkzeug für alles Sichtbare.

Ein data-Attribut ist ein Wert, etwa data-kurs-id="javascript", data-kurs-stunden="47" oder data-version="4". Es hängt an den Daten und nicht am Aussehen, und wer eine Versionsnummer trotzdem als Klasse ablegt, braucht am Ende für jede einzelne Nummer eine eigene Klasse.

In Abschnitt 12 kommt der praktische Grund dazu. Reagierst du auf einen Klick, musst du wissen, welcher Eintrag gemeint war, und ein data-id am Element beantwortet das in einer Zeile.

aria-Attribute

aria-expanded, aria-invalid und aria-live sind ganz normale Attribute, und du setzt sie mit setAttribute wie alle anderen. Eigene Eigenschaften gibt es inzwischen auch (el.ariaExpanded). Der Kurs bleibt trotzdem bei setAttribute("aria-expanded", "true"), weil diese Schreibweise für jedes aria-Attribut gleich aussieht und man sich keine zweite Liste mit Namen merken muss.

Mit ihnen erfährt ein Screenreader, was auf der Seite gerade los ist. aria-invalid kommt in Abschnitt 13 dran, aria-expanded und aria-live in Abschnitt 20. Gesetzt werden sie wie ein title.

In der Aufgabe brauchst du alle drei Wege an einem kleinen Formular.

Zum Mitnehmen

setAttribute geht bei jedem Attribut, die Eigenschaft ist kürzer. Bei disabled, checked und required entscheidet allein, ob das Attribut da ist, und mit dem Wert false gilt es trotzdem. Eigene Daten schreibt dataset.

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.