{"canonical_url":"https://engineer.company/de/glossary/web-components/","content_markdown":"# Web Components\n\n## Was es ist\n\nWeb Components ist die übliche Sammelbezeichnung für Browserfunktionen, mit\ndenen Autoren eigene HTML-Elemente definieren können. Eine Seite verwendet ein\nsolches Element anschließend wie jedes andere Tag. Im Englischen wird der\nBegriff auch kleingeschrieben. Die Standards benennen die Teile einzeln:\nCustom Elements sowie die Elemente `template` und `slot` im HTML-Standard,\nShadow Trees im DOM-Standard. Der Sammelbegriff steht im Titel einer W3C\nWorking Group Note vom 24. Juli 2014,\n[_Introduction to Web Components_](https://www.w3.org/TR/components-intro/).\nDas W3C hat dieses Dokument inzwischen eingestellt und als nicht mehr zu\nreferenzieren gekennzeichnet.\n\nEin Custom Element wird durch eine JavaScript-Klasse definiert, die\n`HTMLElement` erweitert und mit `customElements.define()` unter einem Namen\nregistriert wird. Die Definition legt fest, wie der HTML-Parser das Element\nerzeugt und wie es auf Änderungen reagiert. Danach lässt es sich aus Markup,\nmit `document.createElement()` oder mit `new` erstellen. Sein Name beginnt mit\neinem kleinen ASCII-Buchstaben, enthält keine großen ASCII-Buchstaben und muss\neinen Bindestrich enthalten. Dieser trennt eigene Namen von der Sprache selbst:\nLaut HTML-Standard werden HTML, SVG und MathML keine neuen Elemente mit\nBindestrich im Namen erhalten.\n\nEs gibt zwei Arten. Ein autonomes Custom Element wie das standardeigene\n`\u003cflag-icon country=\"nl\"\u003e` beginnt als einfaches Element ohne eingebaute\nBedeutung. Ein angepasstes eingebautes Element erweitert dagegen ein\nvorhandenes. Eine Klasse, die `HTMLButtonElement` erweitert, mit\n`{ extends: \"button\" }` registriert und als `\u003cbutton is=\"plastic-button\"\u003e`\nverwendet wird, behält alles, was einen Button ausmacht: Fokusverhalten,\nFormularübermittlung und das Attribut `disabled`.\n\nEin Shadow Tree ist ein gesonderter Knotenbaum, der an einem Element hängt.\nDieses Element heißt Host; seinen gewöhnlichen Baum nennt der DOM-Standard\nLight Tree. `attachShadow()` erzeugt eine Shadow Root im offenen oder\ngeschlossenen Modus. Nur im offenen Modus gibt die Eigenschaft `shadowRoot`\ndes Hosts diese Wurzel zurück. Ein `slot`-Element im Shadow Tree markiert, wo\ndie eigenen Kinder des Hosts erscheinen. Es zeigt die zugewiesenen Knoten\noder, wenn keine vorhanden sind, seinen eigenen Inhalt. Ein benannter Slot\nnimmt Kinder auf, deren Attribut `slot` seinen Namen trägt. Das Element\n`template` enthält ein nicht gerendertes HTML-Fragment, das ein Skript klonen\nkann. Mit dem Attribut `shadowrootmode` stellt ein `template` eine deklarative\nShadow Root dar. Ein Shadow Tree lässt sich deshalb auch direkt ins Markup\nschreiben.\n\n## Warum es wichtig ist\n\nEin erfundenes Tag war früher wenig nützlich. Rückblickend bezeichnet der\nHTML-Standard solche Elemente als ungültig und von geringem praktischem\nNutzen. Ein Custom Element ist dagegen ein vollwertiger Teil des Dokuments.\nDer Parser erzeugt es, DOM-Methoden erstellen es, und seine Klasse entscheidet,\nwas bei Attributänderungen oder beim Einfügen in eine Seite und beim Entfernen\ndaraus geschieht.\n\nDie Definition muss nicht zuerst eintreffen. Ein vom Parser bereits erzeugtes\nElement wird zum Custom Element, sobald eine Definition für seinen Namen\nregistriert ist. Der HTML-Standard nennt das Upgrading. Bis dahin gilt es als\nundefiniertes Element, ähnlich einem `span`: Text und Links darin erscheinen\nunverändert. Der Standard sagt ausdrücklich, dass Upgrades es erlauben, den\nInhalt eines Custom Elements schrittweise zu erweitern.\n\nEin Custom Element kann auch an Formularen und am Barrierefreiheitsbaum\nteilnehmen. Eine Klasse, die `static formAssociated = true` setzt und\n`attachInternals()` aufruft, erhält ein `ElementInternals`-Objekt. Dessen\n`setFormValue()` gibt dem Element einen Wert, den sein Formular wie den jedes\nanderen Bedienelements übermittelt. Dasselbe Objekt legt eine voreingestellte\nARIA-Rolle und ARIA-Zustände fest. Diese gelten, sofern der Seitenautor sie\nnicht durch das Attribut `role` oder die passenden `aria-*`-Attribute\nüberschreibt. Es kann außerdem benutzerdefinierte Zustände enthalten, die\nStylesheets mit der Pseudoklasse `:state()` auswählen.\n\nFür ein Team sorgt der Shadow Tree dafür, dass eine Komponente in sich\ngekapselt ist: Gewöhnliche Seitenselektoren reichen nicht in ihren internen\nShadow Tree hinein, und die Komponente legt fest, welche Teile von außen\ngestaltet werden dürfen. Geerbte Werte und Custom Properties können weiterhin\nhineingelangen. Über Slots angezeigter Inhalt aus dem Light Tree bleibt den\nSeitenselektoren zugänglich. Teilen sich mehrere Bibliotheken eine Seite,\nbietet der HTML-Standard lokal begrenzte Registries, erzeugt mit\n`new CustomElementRegistry()`. So können ihre Elemente nebeneinander bestehen,\nohne dass die Bibliotheken ihre Namen abstimmen müssen.\n\n## Wie es in der Praxis aussieht\n\nEine Produktkarte zeigt das Zusammenspiel. Die Seite hält den Inhalt als\ngewöhnliches Markup vor. Das Element, das in einen benannten Slot gehört,\nerhält das Attribut `slot`:\n\n```html\n\u003cproduct-card\u003e\n  \u003cspan slot=\"name\"\u003eOak stool\u003c/span\u003e\n  \u003ca href=\"/shop/oak-stool/\"\u003eSee the details\u003c/a\u003e\n\u003c/product-card\u003e\n\u003cscript type=\"module\" src=\"product-card.mjs\"\u003e\u003c/script\u003e\n```\n\nDas Modul definiert das Element. Die Vorlage wird einmal aufgebaut, und jede\nKarte erhält eine eigene Kopie davon in einer offenen Shadow Root:\n\n```js\nconst template = document.createElement(\"template\");\ntemplate.innerHTML = `\n  \u003ch2 part=\"title\"\u003e\u003cslot name=\"name\"\u003eUnnamed product\u003c/slot\u003e\u003c/h2\u003e\n  \u003cslot\u003e\u003c/slot\u003e\n`;\n\nclass ProductCard extends HTMLElement {\n  constructor() {\n    super();\n    const root = this.attachShadow({ mode: \"open\" });\n    root.append(template.content.cloneNode(true));\n  }\n}\n\nif (!customElements.get(\"product-card\")) {\n  customElements.define(\"product-card\", ProductCard);\n}\n```\n\nDie Seite gestaltet die Überschrift über den einen Teil, den die Komponente\nnach außen freigibt:\n\n```css\nproduct-card::part(title) {\n  font-size: 1.25rem;\n}\n```\n\nBevor `product-card.mjs` ausgeführt wurde, ist die Karte ein undefiniertes\nElement. Leser sehen den Produktnamen und den Link als gewöhnlichen\nInline-Inhalt. Beim Ausführen registriert `define()` die Klasse, und die\nbereits vorhandene Karte erhält ihr Upgrade. Ihr Konstruktor hängt eine\nShadow Root an und füllt sie mit einem Klon des Vorlageninhalts. Das `span`\nwird dem Slot namens `name` zugewiesen und erscheint innerhalb der\nÜberschrift. Der Link hat kein Attribut `slot` und landet deshalb im\nunbenannten Standardslot. Bei einer Karte ohne Namen erscheint stattdessen\nder eigene Inhalt des Slots, „Unnamed product“. Die Prüfung mit\n`customElements.get()` verhindert, dass eine zweite, über ein anderes Bundle\neintreffende Modulkopie bei `define()` eine Ausnahme auslöst.\n\nGemeinsame Komponenten helfen nur, wenn sie verwendet werden. Das Portfolio\ndieser Website enthält einen Fall dazu.\n[Das Designsystem für iOS 26 „Liquid Glass“](/de/portfolio/designed-an-ios-26-liquid-glass-design-system/)\ngeht von einer Oberfläche aus, in der jeder neue Bildschirm Buttons, Badges\nund Karten neu erfindet, jeweils etwas anders. Jede Änderung betrifft dadurch\nfünf eigens gebaute Varianten. Die dort beschriebene Antwort ist ein\nverbindlicher Komponentensatz, aus dem jeder Bildschirm zusammengesetzt wird.\nDazu gehören Card, Label, Button, GlassIconButton und DirectoryGrid.\nLint-Regeln lehnen selbst gebaute Badges oder Chips ab und verweisen auf die\nverbindliche Komponente. Die Seite sagt nicht, ob diese Komponenten Custom\nElements sind. Die Arbeitsweise lässt sich aber übertragen: eine Definition\nje Komponente, durch Werkzeuge durchgesetzt statt durch das Gedächtnis eines\nReviewers. Die Custom-Element-Registry erzwingt die erste Hälfte, indem sie\neine zweite Definition für denselben Namen ablehnt.\n\n## Wo es schiefgeht\n\n**Ein Name mit Bindestrich ersetzt eine Rolle.** „Ein autonomes Custom Element\nhat keine besondere Bedeutung: Es repräsentiert seine Kinder“, sagt der\nHTML-Standard. Sein Beispiel `taco-button` zeigt den Aufwand. Um als Button\nzu funktionieren, benötigt das Element `tabindex`, die ARIA-Rolle `button`,\neinen zugänglichen Namen, `aria-disabled`, Tastaturhandler, die Enter und\nLeertaste in Klicks umsetzen, und Stile für den deaktivierten Zustand. Selbst\ndann kann ein Custom Element kein voreingestelltes Fokusverhalten deklarieren.\n`tabindex=\"0\"` entspricht deshalb möglicherweise nicht dem Buttonverhalten der\nPlattform. Baut das Element auf einem vorhandenen auf, verringert die\nErweiterung eines eingebauten Elements laut Standard die Arbeit sowohl für\nseinen Autor als auch für seine Nutzer. Bei einem autonomen Element sollten\ndie voreingestellte Rolle und die Zustände über `ElementInternals` festgelegt\nwerden, statt dies jeder verwendenden Seite zu überlassen.\n\n**Der Konstruktor erledigt die eigentliche Arbeit.** Der HTML-Standard stellt\nRegeln für Custom-Element-Konstruktoren auf. Zuerst kommt `super()` ohne\nArgumente. Der Konstruktor darf Attribute und Kinder des Elements nicht lesen,\nweil ein neu erzeugtes statt nachträglich aufgewertetes Element noch keine\nhat. Er darf dem Element auch keine eigenen Attribute oder Kinder hinzufügen.\nEin Verstoß kann ein Element ergeben, das weder der Parser noch DOM-Methoden\nerzeugen können. In den Konstruktor gehören Anfangszustand, Voreinstellungen,\nEvent Listener und die Shadow Root; Abruf und Rendering gehören in\n`connectedCallback`.\n\n**`connectedCallback` soll nur einmal laufen.** Er kann mehrfach laufen.\nStandardmäßig löst das Verschieben eines Elements erst `disconnectedCallback`\nund dann `connectedCallback` aus. Das Element setzt seinen Zustand zurück, als\nwäre es entfernt und wieder eingefügt worden. Einmalige Einrichtung braucht ein\nFlag als Schutz. In `disconnectedCallback` sollte aufgeräumt werden, was\n`connectedCallback` gestartet hat. Soll ein Element beim Verschieben mit\n`moveBefore()` seinen Zustand behalten, wird `connectedMoveCallback` definiert.\nSchon dessen Vorhandensein ersetzt das übliche Paar, selbst bei leerem\nFunktionsrumpf.\n\n**Ein Name wird zweimal definiert.** `customElements.define()` löst einen\n`NotSupportedError` aus, wenn der Name oder die Klasse bereits registriert\nist, und einen `SyntaxError`, wenn der Name ungültig ist, etwa weil ihm ein\nBindestrich fehlt oder er einen Großbuchstaben enthält. Vor der Definition\nsollte `customElements.get()` prüfen, ob sie bereits vorhanden ist. Eine\nBibliothek, die neben anderen bestehen muss, sollte eine eigene lokal\nbegrenzte Registry erhalten.\n\n**Der geschlossene Modus gilt als Schutz.** Er verbirgt die Wurzel vor der\nEigenschaft `shadowRoot` des Hosts. Für Event Listener außerhalb dieses\ngeschlossenen Shadow Trees verbirgt er außerdem interne Knoten aus dem\nzusammengesetzten Ereignispfad. CSS Shadow Parts sagt ausdrücklich, dass\nShadow Trees bewusst keine Sicherheitsgrenze bilden, sondern eine Hilfe für\nSeitenautoren sind. Geheimnisse gehören nicht in Komponenten. Der geschlossene\nModus wird wegen seiner Wirkung auf äußeren Code gewählt, nicht als Schloss.\n\n**`attachShadow()` wird aufgerufen, wo es nicht funktionieren kann.** Der\nDOM-Standard erlaubt eine Shadow Root nur auf Elementen mit einem gültigen\nCustom-Element-Namen und auf einer kurzen Liste eingebauter Elemente. Dazu\ngehören `div`, `section`, `p` und `span`, aber nicht `button`. Auf einem\nangepassten eingebauten Button löst der Aufruf einen `NotSupportedError` aus.\nBei einem Element mit bereits vorhandener Wurzel verhält er sich zudem anders:\nIst diese deklarativ und hat denselben Modus, leert der Aufruf sie und gibt sie\nleer zurück. Andernfalls löst er eine Ausnahme aus. Vorher sollte deshalb nach\neiner vorhandenen Shadow Root gesucht werden, damit eine vom Server im Markup\ngelieferte deklarative Wurzel erhalten bleibt, statt gelöscht zu werden.\n\n**Seitenstile sollen bis ins Innere reichen.** CSS Shadow Parts nennt die\nGrenze eine Styling-Barriere und hält fest, dass sie eine Komponente zugleich\nschwerer gestaltbar macht, wenn die Seite das möchte. Elemente, die eine Seite\ngestalten darf, werden mit `part` freigegeben und von außen mit `::part()`\nangesprochen. Eine in einer anderen verschachtelte Komponente benötigt\n`exportparts` auf dem inneren Host, um ihre Teile bis zur Seite weiterzureichen.\nFarben und Abstände, die der Seite folgen sollen, werden aus Custom Properties\nauf dem Host gelesen. Sie erreichen den Shadow Tree durch Vererbung.\n\n**Der Inhalt existiert erst nach dem Skript.** Eine Komponente, die ihren\ngesamten Text mit JavaScript schreibt, zeigt Lesern bis zum Laden der\nDefinition nichts davon. Scheitert das Skript, erscheint überhaupt nichts.\nDer Inhalt sollte wie bei der Produktkarte im Light Tree stehen und Slots\nzugewiesen werden. Das Upgrade erweitert dann, was bereits vorhanden ist.\nMuss Inhalt warten, verbirgt ihn das Beispiel des HTML-Standards, bis\n`customElements.whenDefined()` für jedes Element aufgelöst wurde, das\n`:not(:defined)` entspricht.\n\n## Weiterführende Lektüre\n\n- [HTML Standard: Custom elements](https://html.spec.whatwg.org/multipage/custom-elements.html)\n  — Namensregeln, Anforderungen an Konstruktoren, Upgrades, formulargebundene\n  Elemente und `ElementInternals`, mit durchgearbeiteten Beispielen.\n- [DOM Standard: Shadow tree](https://dom.spec.whatwg.org/#shadow-trees) —\n  Shadow Roots und ihre Hosts, Slots, die ihnen zugewiesenen Knoten und die\n  Schritte hinter `attachShadow()`.\n- [HTML Standard: Scripting](https://html.spec.whatwg.org/multipage/scripting.html)\n  — das Element `template` mit seinem Attribut `shadowrootmode` und das\n  Element `slot`.\n- [CSS Shadow Parts](https://www.w3.org/TR/css-shadow-parts-1/) — der\n  W3C-Arbeitsentwurf vom 16. Dezember 2025, der `part`, `exportparts` und das\n  Pseudoelement `::part()` definiert.\n\n\u003chttps://engineer.company/de/glossary/web-components/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Wie Custom Elements, Shadow Trees, template und slot eigene HTML-Tags ermöglichen: ein durchgearbeitetes Beispiel und die wichtigsten Fallen.","formats":{"gemtext":"https://engineer.company/de/glossary/web-components/index.gmi","gopher":"https://engineer.company/de/glossary/web-components/gophermap","html":"https://engineer.company/de/glossary/web-components/","json":"https://engineer.company/de/glossary/web-components/index.json","markdown":"https://engineer.company/de/glossary/web-components/index.md","pdf":"https://engineer.company/de/glossary/web-components/index.pdf"},"kind":"page","language":"de","title":"Was sind Web Components?","url":"https://engineer.company/de/glossary/web-components/","version":1}