Diese Seite wurde von der Cloud Translation API übersetzt.

Shadow DOM v1 – Eigenständige Webkomponenten

Mit Shadow DOM können Webentwickler ein abgegrenztes DOM und CSS für Webkomponenten erstellen.

Eric Bidelman

Zusammenfassung

Shadow DOM beseitigt die Brüchigkeit beim Erstellen von Webanwendungen. Die Brüchigkeit rührt von der globalen Natur von HTML, CSS und JS her. Im Laufe der Jahre haben wir eine exorbitante Anzahl von Tools entwickelt, um die Probleme zu umgehen. Wenn Sie beispielsweise eine neue HTML-ID/-Klasse verwenden, lässt sich nicht vorhersagen, ob es zu einem Konflikt mit einem vorhandenen Namen kommt, der auf der Seite verwendet wird. Subtile Fehler schleichen sich ein, die CSS-Spezifizität wird zu einem großen Problem (!important alles!), Stilauswahlen geraten außer Kontrolle und die Leistung kann leiden. Die Liste ließe sich fortsetzen.

Shadow DOM behebt Probleme mit CSS und DOM. Es führt stilbezogene Bereiche auf der Webplattform ein. Ohne Tools oder Benennungskonventionen können Sie CSS mit Markup bündeln, Implementierungsdetails ausblenden und in Vanilla-JavaScript eigenständige Komponenten erstellen.

Einführung

Shadow DOM ist einer der drei Web-Komponentenstandards: HTML-Vorlagen, Shadow DOM und benutzerdefinierte Elemente. HTML-Importe waren früher Teil der Liste, werden aber jetzt als veraltet eingestuft.

Sie müssen keine Webkomponenten erstellen, die Shadow-DOM verwenden. Wenn Sie dies tun, können Sie die Vorteile von CSS (CSS-Bereich, DOM-Kapselung, Komposition) nutzen und wiederverwendbare benutzerdefinierte Elemente erstellen, die robust, hochgradig konfigurierbar und extrem wiederverwendbar sind. Während benutzerdefinierte Elemente eine Möglichkeit sind, neue HTML-Inhalte (mit einer JS API) zu erstellen, ist das Shadow-DOM die Möglichkeit, HTML- und CSS-Inhalte bereitzustellen. Die beiden APIs werden kombiniert, um eine Komponente mit eigenständigem HTML, CSS und JavaScript zu erstellen.

Shadow DOM ist ein Tool zum Erstellen komponentenbasierter Apps. Daher bietet es Lösungen für häufige Probleme bei der Webentwicklung:

Isoliertes DOM: Das DOM einer Komponente ist in sich geschlossen. document.querySelector() gibt beispielsweise keine Knoten im Shadow DOM der Komponente zurück.
Beschränktes CSS: CSS, das im Shadow-DOM definiert ist, ist auf dieses beschränkt. Stilregeln greifen nicht ineinander und Seitenstile gehen nicht ineinander über.
Komposition: Entwerfen Sie eine deklarative, markupbasierte API für Ihre Komponente.
CSS vereinfacht: Mit einem begrenzten DOM können Sie einfache CSS-Selektoren und allgemeinere ID-/Klassennamen verwenden, ohne sich um Namenskonflikte kümmern zu müssen.
Produktivität: Stellen Sie sich Apps als DOM-Chunks vor, nicht als eine große (globale) Seite.

`fancy-tabs` Demo

In diesem Artikel beziehe ich mich auf eine Demokomponente (<fancy-tabs>) und auf Code-Snippets daraus. Wenn Ihr Browser die APIs unterstützt, sollte unten eine Live-Demo angezeigt werden. Andernfalls finden Sie die vollständigen Quellen auf GitHub.

Quellcode auf GitHub ansehen

Was ist Shadow DOM?

Hintergrund zum DOM

HTML ist die Grundlage des Webs, da es einfach zu bedienen ist. Mit wenigen Tags können Sie in Sekunden eine Seite erstellen, die sowohl eine Präsentation als auch eine Struktur hat. Allerdings ist HTML an sich nicht besonders nützlich. Für Menschen ist es einfach, eine textbasierte Sprache zu verstehen, aber Maschinen benötigen mehr. Geben Sie das Document Object Model (DOM) ein.

Wenn der Browser eine Webseite lädt, geschieht eine Menge Interessantes. Unter anderem wird damit das HTML-Dokument des Autors in ein Live-Dokument umgewandelt. Um die Struktur der Seite zu verstehen, analysiert der Browser HTML (statische Textstrings) in einem Datenmodell (Objekte/Knoten). Der Browser bewahrt die HTML-Hierarchie durch Erstellen eines Baums dieser Knoten auf: das DOM. Das Tolle am DOM ist, dass es eine Live-Darstellung Ihrer Seite ist. Im Gegensatz zum von uns erstellten statischen HTML enthalten die vom Browser erstellten Knoten Eigenschaften und Methoden und können vor allem von Programmen manipuliert werden. Deshalb können wir DOM-Elemente direkt mit JavaScript erstellen:

const header = document.createElement('header');
const h1 = document.createElement('h1');
h1.textContent = 'Hello DOM';
header.appendChild(h1);
document.body.appendChild(header);

ergibt das folgende HTML-Markup:

<body>
    <header>
    <h1>Hello DOM</h1>
    </header>
</body>

Das ist alles schön und gut. Was ist dann Shadow DOM?

DOM… im Schatten

Shadow DOM ist ein normales DOM mit zwei Unterschieden: 1) wie es erstellt/verwendet wird und 2) wie es sich im Verhältnis zum Rest der Seite verhält. Normalerweise erstellen Sie DOM-Knoten und hängen sie als untergeordnete Elemente an ein anderes Element an. Mit Shadow DOM erstellen Sie einen DOM-Baum mit begrenztem Umfang, der an das Element angehängt, aber von seinen tatsächlichen untergeordneten Elementen getrennt ist. Dieser untergeordnete Knoten wird als Schattenbaum bezeichnet. Das Element, an das es angehängt ist, ist sein Schattenhost. Alles, was Sie in den Schatten hinzufügen, wird lokal für das Hostelement, einschließlich <style>, festgelegt. So wird im Shadow-DOM die CSS-Stilzuordnung erreicht.

Shadow-DOM erstellen

Ein Schatten-Stammelement ist ein Dokumentfragment, das an ein „Host“-Element angehängt wird. Durch das Anhängen eines Schatten-Roots erhält das Element sein Shadow DOM. Wenn Sie ein Shadow DOM für ein Element erstellen möchten, rufen Sie element.attachShadow() auf:

const header = document.createElement('header');
const shadowRoot = header.attachShadow({mode: 'open'});
shadowRoot.innerHTML = '<h1>Hello Shadow DOM</h1>'; // Could also use appendChild().

// header.shadowRoot === shadowRoot
// shadowRoot.host === header

Ich verwende .innerHTML, um den Schatten-Root zu füllen, aber Sie können auch andere DOM-APIs verwenden. Das ist das Internet. Wir haben die Wahl.

Die Spezifikation definiert eine Liste von Elementen, die keinen Schattenbaum hosten können. Es gibt mehrere Gründe, warum ein Element auf der Liste stehen könnte:

Der Browser hostet bereits ein eigenes internes Shadow DOM für das Element (<textarea>, <input>).
Es macht keinen Sinn, dass das Element ein Shadow DOM (<img>) hostet.

Folgendes funktioniert beispielsweise nicht:

    document.createElement('input').attachShadow({mode: 'open'});
    // Error. `<input>` cannot host shadow dom.

Shadow DOM für ein benutzerdefiniertes Element erstellen

Das Shadow-DOM ist besonders nützlich, wenn Sie benutzerdefinierte Elemente erstellen. Mit Shadow DOM können Sie HTML, CSS und JS eines Elements in verschiedene Bereiche unterteilen und so eine „Webkomponente“ erstellen.

Beispiel: Ein benutzerdefiniertes Element fügt sich selbst ein Shadow DOM hinzu und kapselt sein DOM/CSS ein:

// Use custom elements API v1 to register a new HTML tag and define its JS behavior
// using an ES6 class. Every instance of <fancy-tab> will have this same prototype.
customElements.define('fancy-tabs', class extends HTMLElement {
    constructor() {
    super(); // always call super() first in the constructor.

    // Attach a shadow root to <fancy-tabs>.
    const shadowRoot = this.attachShadow({mode: 'open'});
    shadowRoot.innerHTML = `
        <style>#tabs { ... }</style> <!-- styles are scoped to fancy-tabs! -->
        <div id="tabs">...</div>
        <div id="panels">...</div>
    `;
    }
    ...
});

Hier gibt es einige interessante Dinge. Erstens: Das benutzerdefinierte Element erstellt sein eigenes Shadow DOM, wenn eine Instanz von <fancy-tabs> erstellt wird. Das geschieht in der constructor(). Zweitens: Da wir einen Schatten-Root erstellen, gelten die CSS-Regeln innerhalb des <style> für <fancy-tabs>.

Zusammensetzung und Slots

Die Zusammensetzung ist eine der am wenigsten verstandenen Funktionen von Shadow DOM, aber wohl die wichtigste.

In der Welt der Webentwicklung werden Apps deklarativ aus HTML-Code erstellt. Verschiedene Bausteine (<div>, <header>, <form>, <input>) werden zu Apps zusammengesetzt. Einige dieser Tags funktionieren sogar zusammen. Die Komposition ist der Grund, warum native Elemente wie <select>, <details>, <form> und <video> so flexibel sind. Jedes dieser Tags akzeptiert bestimmte HTML-Elemente als untergeordnete Elemente und führt etwas Besonderes mit ihnen aus. Beispielsweise weiß <select>, wie <option> und <optgroup> in Drop-down- und Mehrfachauswahl-Widgets gerendert werden. Das <details>-Element rendert <summary> als ausziehbaren Pfeil. Selbst <video> weiß, wie man mit bestimmten Kindern umgeht: <source>-Elemente werden nicht gerendert, wirken sich aber auf das Verhalten des Videos aus. Was für eine Magie!

Terminologie: Light-DOM und Shadow-DOM

Die Shadow-DOM-Komposition führt eine Reihe neuer Grundlagen in der Webentwicklung ein. Bevor wir uns in die Details vertiefen, sollten wir einige Begriffe standardisieren, damit wir uns auf die gleiche Sprache einigen.

Light DOM

Das Markup, das ein Nutzer Ihrer Komponente schreibt. Dieses DOM befindet sich außerhalb des Shadow DOM der Komponente. Das sind die tatsächlichen untergeordneten Elemente des Elements.

<better-button>
    <!-- the image and span are better-button's light DOM -->
    <img src="gear.svg" slot="icon">
    <span>Settings</span>
</better-button>

Shadow DOM

Das DOM, das ein Komponentenautor schreibt. Das Shadow DOM ist lokal für die Komponente und definiert ihre interne Struktur, das CSS mit begrenztem Gültigkeitsbereich und kapselt Ihre Implementierungsdetails ein. Außerdem kann festgelegt werden, wie Markup gerendert wird, das vom Nutzer Ihrer Komponente erstellt wurde.

#shadow-root
    <style>...</style>
    <slot name="icon"></slot>
    <span id="wrapper">
    <slot>Button</slot>
    </span>

Zusammengefalteter DOM-Baum

Das Ergebnis, wenn der Browser das Light DOM des Nutzers in Ihr Shadow DOM verteilt und das Endprodukt rendert. Der flache Baum ist das, was Sie letztendlich in den DevTools sehen und was auf der Seite gerendert wird.

<better-button>
    #shadow-root
    <style>...</style>
    <slot name="icon">
        <img src="gear.svg" slot="icon">
    </slot>
    <span id="wrapper">
        <slot>
        <span>Settings</span>
        </slot>
    </span>
</better-button>

Das <slot>-Element

Das Shadow-DOM stellt verschiedene DOM-Bäume mithilfe des <slot>-Elements zusammen. Slots sind Platzhalter in Ihrer Komponente, die Nutzer mit ihrem eigenen Markup füllen können. Wenn Sie einen oder mehrere Slots definieren, können Sie externes Markup im Shadow-DOM Ihrer Komponente rendern. Im Grunde sagen Sie damit: „Rendere das Markup des Nutzers hier.“

Elemente dürfen die Shadow-DOM-Grenze überschreiten, wenn sie von einem <slot> eingeladen werden. Diese Elemente werden als verteilte Knoten bezeichnet. Konzeptionell können verteilte Knoten etwas bizarr erscheinen. Slots verschieben das DOM nicht physisch, sondern rendern es an einer anderen Stelle im Shadow DOM.

Eine Komponente kann null oder mehrere Slots in ihrem Schatten-DOM definieren. Slots können leer sein oder Fallback-Inhalte enthalten. Wenn der Nutzer keine Light-DOM-Inhalte angibt, werden im Slot die Fallback-Inhalte gerendert.

<!-- Default slot. If there's more than one default slot, the first is used. -->
<slot></slot>

<slot>fallback content</slot> <!-- default slot with fallback content -->

<slot> <!-- default slot entire DOM tree as fallback -->
    <h2>Title</h2>
    <summary>Description text</summary>
</slot>

Sie können auch benannte Slots erstellen. Namenslose Slots sind bestimmte Lücken im Shadow-DOM, auf die Nutzer per Name verweisen.

Beispiel: Die Slots im Shadow DOM von <fancy-tabs>:

#shadow-root
    <div id="tabs">
    <slot id="tabsSlot" name="title"></slot> <!-- named slot -->
    </div>
    <div id="panels">
    <slot id="panelsSlot"></slot>
    </div>

Komponentennutzer deklarieren <fancy-tabs> so:

<fancy-tabs>
    <button slot="title">Title</button>
    <button slot="title" selected>Title 2</button>
    <button slot="title">Title 3</button>
    <section>content panel 1</section>
    <section>content panel 2</section>
    <section>content panel 3</section>
</fancy-tabs>

<!-- Using <h2>'s and changing the ordering would also work! -->
<fancy-tabs>
    <h2 slot="title">Title</h2>
    <section>content panel 1</section>
    <h2 slot="title" selected>Title 2</h2>
    <section>content panel 2</section>
    <h2 slot="title">Title 3</h2>
    <section>content panel 3</section>
</fancy-tabs>

Der flache Baum sieht in etwa so aus:

<fancy-tabs>
    #shadow-root
    <div id="tabs">
        <slot id="tabsSlot" name="title">
        <button slot="title">Title</button>
        <button slot="title" selected>Title 2</button>
        <button slot="title">Title 3</button>
        </slot>
    </div>
    <div id="panels">
        <slot id="panelsSlot">
        <section>content panel 1</section>
        <section>content panel 2</section>
        <section>content panel 3</section>
        </slot>
    </div>
</fancy-tabs>

Unsere Komponente kann verschiedene Konfigurationen verarbeiten, die flache DOM-Hierarchie bleibt jedoch gleich. Wir können auch von <button> zu <h2> wechseln. Diese Komponente wurde für verschiedene Arten von Kindern entwickelt – genau wie <select>.

Stile

Es gibt viele Möglichkeiten, Webkomponenten zu stylen. Eine Komponente, die das Shadow-DOM verwendet, kann von der Hauptseite gestaltet werden, eigene Stile definieren oder Hooks (in Form von benutzerdefinierten CSS-Eigenschaften) bereitstellen, mit denen Nutzer Standardeinstellungen überschreiben können.

Komponentendefinierte Stile

Die nützlichste Funktion von Shadow DOM ist CSS mit Bereich:

CSS-Selektoren von der äußeren Seite werden nicht innerhalb Ihrer Komponente angewendet.
Innerhalb definierte Stile werden nicht ausgeblendet. Sie gelten nur für das Hostelement.

CSS-Selektoren, die im Schatten-DOM verwendet werden, werden lokal auf Ihre Komponente angewendet. In der Praxis bedeutet das, dass wir wieder gängige ID-/Klassennamen verwenden können, ohne uns um Konflikte an anderer Stelle auf der Seite sorgen zu müssen. Einfachere CSS-Selektoren sind eine Best Practice im Shadow-DOM. Außerdem sind sie leistungsfördernd.

Beispiel: In einem Schatten-Root definierte Stile sind lokal

#shadow-root
    <style>
    #panels {
        box-shadow: 0 2px 2px rgba(0, 0, 0, .3);
        background: white;
        ...
    }
    #tabs {
        display: inline-flex;
        ...
    }
    </style>
    <div id="tabs">
    ...
    </div>
    <div id="panels">
    ...
    </div>

Stylesheets gelten auch für den Schattenbaum:

#shadow-root
    <link rel="stylesheet" href="styles.css">
    <div id="tabs">
    ...
    </div>
    <div id="panels">
    ...
    </div>

Haben Sie sich schon einmal gefragt, warum das Element <select> ein Mehrfachauswahl-Widget (anstelle eines Drop-down-Menüs) rendert, wenn Sie das Attribut multiple hinzufügen?

<select multiple>
  <option>Do</option>
  <option selected>Re</option>
  <option>Mi</option>
  <option>Fa</option>
  <option>So</option>
</select>

<select> kann sich selbst je nach den von Ihnen deklarierten Attributen unterschiedlich stylen. Webkomponenten können auch selbst einen Stil festlegen, indem sie die :host-Auswahl verwenden.

Beispiel: Komponente, die sich selbst stylet

<style>
:host {
    display: block; /* by default, custom elements are display: inline */
    contain: content; /* CSS containment FTW. */
}
</style>

Ein Problem bei :host ist, dass Regeln auf der übergeordneten Seite spezifischer sind als :host-Regeln, die im Element definiert sind. Das heißt, externe Stile haben Vorrang. So können Nutzer das Styling auf oberster Ebene von außen überschreiben. Außerdem funktioniert :host nur im Kontext eines Schatten-Roots und kann daher nicht außerhalb des Schatten-DOM verwendet werden.

Mit der funktionalen Form von :host(<selector>) können Sie das Targeting auf den Host ausrichten, wenn er mit einem <selector> übereinstimmt. So können Sie in Ihrer Komponente Verhaltensweisen einkapseln, die auf Nutzerinteraktionen reagieren oder interne Knoten basierend auf dem Host steuern.

<style>
:host {
    opacity: 0.4;
    will-change: opacity;
    transition: opacity 300ms ease-in-out;
}
:host(:hover) {
    opacity: 1;
}
:host([disabled]) { /* style when host has disabled attribute. */
    background: grey;
    pointer-events: none;
    opacity: 0.4;
}
:host(.blue) {
    color: blue; /* color host when it has class="blue" */
}
:host(.pink) > #tabs {
    color: pink; /* color internal #tabs node when host has class="pink". */
}
</style>

Kontextbasiertes Styling

:host-context(<selector>) stimmt mit der Komponente überein, wenn sie oder einer ihrer Vorfahren mit <selector> übereinstimmt. Eine gängige Anwendung ist die Themengestaltung basierend auf der Umgebung einer Komponente. Viele Nutzer wenden beispielsweise einen Kurs auf <html> oder <body> an:

<body class="darktheme">
    <fancy-tabs>
    ...
    </fancy-tabs>
</body>

:host-context(.darktheme) würde <fancy-tabs> formatieren, wenn es ein Abkömmling von .darktheme ist:

:host-context(.darktheme) {
    color: white;
    background: black;
}

:host-context() kann für die Themengestaltung nützlich sein, aber noch besser ist es, Style-Hooks mit benutzerdefinierten CSS-Eigenschaften zu erstellen.

Stil für verteilte Knoten festlegen

::slotted(<compound-selector>) stimmt mit Knoten überein, die auf eine <slot> verteilt sind.

Angenommen, wir haben eine Namensschildkomponente erstellt:

<name-badge>
    <h2>Eric Bidelman</h2>
    <span class="title">
    Digital Jedi, <span class="company">Google</span>
    </span>
</name-badge>

Das Shadow DOM der Komponente kann den <h2> und .title des Nutzers so stylen:

<style>
::slotted(h2) {
    margin: 0;
    font-weight: 300;
    color: red;
}
::slotted(.title) {
    color: orange;
}
/* DOESN'T WORK (can only select top-level nodes).
::slotted(.company),
::slotted(.title .company) {
    text-transform: uppercase;
}
*/
</style>
<slot></slot>

Wie Sie sich erinnern, verschieben <slot>s das Light-DOM des Nutzers nicht. Wenn Knoten in einer <slot> verteilt werden, rendert die <slot> ihr DOM, die Knoten bleiben jedoch physisch an Ort und Stelle. Vor der Bereitstellung angewendete Stile gelten auch nach der Bereitstellung weiter. Wenn das Light DOM jedoch verteilt wird, kann es zusätzliche Stile annehmen, die vom Shadow DOM definiert sind.

Ein weiteres, detaillierteres Beispiel von <fancy-tabs>:

const shadowRoot = this.attachShadow({mode: 'open'});
shadowRoot.innerHTML = `
    <style>
    #panels {
        box-shadow: 0 2px 2px rgba(0, 0, 0, .3);
        background: white;
        border-radius: 3px;
        padding: 16px;
        height: 250px;
        overflow: auto;
    }
    #tabs {
        display: inline-flex;
        -webkit-user-select: none;
        user-select: none;
    }
    #tabsSlot::slotted(*) {
        font: 400 16px/22px 'Roboto';
        padding: 16px 8px;
        ...
    }
    #tabsSlot::slotted([aria-selected="true"]) {
        font-weight: 600;
        background: white;
        box-shadow: none;
    }
    #panelsSlot::slotted([aria-hidden="true"]) {
        display: none;
    }
    </style>
    <div id="tabs">
    <slot id="tabsSlot" name="title"></slot>
    </div>
    <div id="panels">
    <slot id="panelsSlot"></slot>
    </div>
`;

In diesem Beispiel gibt es zwei Slots: einen benannten Slot für die Tabtitel und einen Slot für den Inhalt des Tab-Steuerfelds. Wenn der Nutzer einen Tab auswählt, wird die Auswahl fett formatiert und das Steuerfeld wird angezeigt. Dazu wählen Sie verteilte Knoten mit dem Attribut selected aus. Das JS-Script des benutzerdefinierten Elements (nicht hier zu sehen) fügt dieses Attribut zum richtigen Zeitpunkt hinzu.

Komponente von außen stylen

Es gibt verschiedene Möglichkeiten, eine Komponente von außen zu stylen. Am einfachsten ist es, den Tag-Namen als Auswahl zu verwenden:

fancy-tabs {
    width: 500px;
    color: red; /* Note: inheritable CSS properties pierce the shadow DOM boundary. */
}
fancy-tabs:hover {
    box-shadow: 0 3px 3px #ccc;
}

Externe Stile haben immer Vorrang vor im Shadow-DOM definierten Stilen. Wenn der Nutzer beispielsweise die Auswahl fancy-tabs { width: 500px; } schreibt, hat diese Vorrang vor der Regel der Komponente: :host { width: 650px;}.

Das Styling der Komponente selbst ist nur ein erster Schritt. Aber was passiert, wenn Sie die internen Elemente einer Komponente stylen möchten? Dazu benötigen wir benutzerdefinierte CSS-Eigenschaften.

Style-Hooks mit benutzerdefinierten CSS-Eigenschaften erstellen

Nutzer können interne Stile anpassen, wenn der Ersteller der Komponente mithilfe von benutzerdefinierten CSS-Eigenschaften Stilhooks bereitstellt. Konzeptionell ähnelt die Idee <slot>. Sie erstellen „Stil-Platzhalter“, die Nutzer überschreiben können.

Beispiel: Mit <fancy-tabs> können Nutzer die Hintergrundfarbe überschreiben:

<!-- main page -->
<style>
    fancy-tabs {
    margin-bottom: 32px;
    --fancy-tabs-bg: black;
    }
</style>
<fancy-tabs background>...</fancy-tabs>

Innerhalb des Shadow-DOMs:

:host([background]) {
    background: var(--fancy-tabs-bg, #9E9E9E);
    border-radius: 10px;
    padding: 10px;
}

In diesem Fall verwendet die Komponente black als Hintergrundwert, da der Nutzer ihn angegeben hat. Andernfalls wird standardmäßig #9E9E9E verwendet.

Themen für Fortgeschrittene

Geschlossene Schattenwurzeln erstellen (sollte vermieden werden)

Es gibt noch eine andere Variante des Shadow-DOMs, den sogenannten „geschlossenen“ Modus. Wenn Sie einen geschlossenen Schattenbaum erstellen, kann JavaScript außerhalb der Komponente nicht auf das interne DOM zugreifen. Das funktioniert ähnlich wie bei nativen Elementen wie <video>. JavaScript kann nicht auf das Shadow-DOM von <video> zugreifen, da der Browser es mit einem Shadow-Root im geschlossenen Modus implementiert.

Beispiel: Einen geschlossenen Schattenbaum erstellen:

const div = document.createElement('div');
const shadowRoot = div.attachShadow({mode: 'closed'}); // close shadow tree
// div.shadowRoot === null
// shadowRoot.host === div

Auch andere APIs sind vom geschlossenen Modus betroffen:

Element.assignedSlot ÷ TextNode.assignedSlot ergibt null
Event.composedPath() für Ereignisse, die mit Elementen im Schatten-DOM verknüpft sind, wird [] zurückgegeben

Hier ist eine Zusammenfassung, warum Sie niemals Webkomponenten mit {mode: 'closed'} erstellen sollten:

Künstliches Sicherheitsgefühl. Ein Angreifer kann Element.prototype.attachShadow jederzeit hacken.

Im geschlossenen Modus kann der Code des benutzerdefinierten Elements nicht auf sein eigenes Schatten-DOM zugreifen. Das ist ein absoluter Fehlschlag. Stattdessen müssen Sie eine Referenz für später speichern, wenn Sie Elemente wie querySelector() verwenden möchten. Das widerspricht völlig dem ursprünglichen Zweck des geschlossenen Modus.

    customElements.define('x-element', class extends HTMLElement {
    constructor() {
    super(); // always call super() first in the constructor.
    this._shadowRoot = this.attachShadow({mode: 'closed'});
    this._shadowRoot.innerHTML = '<div class="wrapper"></div>';
    }
    connectedCallback() {
    // When creating closed shadow trees, you'll need to stash the shadow root
    // for later if you want to use it again. Kinda pointless.
    const wrapper = this._shadowRoot.querySelector('.wrapper');
    }
    ...
});

Im geschlossenen Modus ist Ihre Komponente für Endnutzer weniger flexibel. Beim Erstellen von Webkomponenten kommt es vor, dass Sie eine Funktion vergessen. Eine Konfigurationsoption. Ein Anwendungsfall, den sich der Nutzer wünscht. Ein häufiges Beispiel ist das Vergessen geeigneter Styling-Hooks für interne Knoten. Im geschlossenen Modus können Nutzer keine Standardeinstellungen überschreiben und Stile anpassen. Es ist sehr hilfreich, auf die internen Komponenten zugreifen zu können. Letztendlich werden Nutzer Ihre Komponente forken, eine andere finden oder ihre eigene erstellen, wenn sie nicht das tut, was sie wollen :(

Mit Slots in JS arbeiten

Die Shadow DOM API bietet Dienstprogramme für die Arbeit mit Slots und verteilten Knoten. Sie sind beim Erstellen eines benutzerdefinierten Elements hilfreich.

slotchange-Ereignis

Das Ereignis slotchange wird ausgelöst, wenn sich die verteilten Knoten eines Slots ändern. Beispielsweise, wenn der Nutzer dem Light-DOM untergeordnete Elemente hinzufügt oder daraus entfernt.

const slot = this.shadowRoot.querySelector('#slot');
slot.addEventListener('slotchange', e => {
    console.log('light dom children changed!');
});

Hinweis : slotchange wird nicht ausgelöst, wenn eine Instanz der Komponente zum ersten Mal initialisiert wird.

Wenn Sie andere Arten von Änderungen am Light-DOM überwachen möchten, können Sie im Konstruktor Ihres Elements eine MutationObserver einrichten.

Welche Elemente werden in einem Slot gerendert?

Manchmal ist es hilfreich zu wissen, welche Elemente mit einem Slot verknüpft sind. Rufe slot.assignedNodes() auf, um herauszufinden, welche Elemente der Slot rendert. Mit der Option {flatten: true} wird auch der Fallback-Inhalt eines Slots zurückgegeben, wenn keine Knoten verteilt werden.

Angenommen, Ihr Shadow-DOM sieht so aus:

<slot><b>fallback content</b></slot>

Nutzung	Anruf	Ergebnis
<my-component>component text</my-component>	`slot.assignedNodes();`	`[component text]`
<my-component></my-component>	`slot.assignedNodes();`	`[]`
<my-component></my-component>	`slot.assignedNodes({flatten: true});`	`[<b>fallback content</b>]`

Welchem Slot ist ein Element zugewiesen?

Es ist auch möglich, die umgekehrte Frage zu beantworten. element.assignedSlot gibt an, welchem Komponenten-Slot dein Element zugewiesen ist.

Das Shadow-DOM-Ereignismodell

Wenn ein Ereignis aus dem Shadow DOM nach oben gesendet wird, wird sein Ziel angepasst, um die vom Shadow DOM bereitgestellte Kapselung beizubehalten. Das heißt, Ereignisse werden so umgeleitet, dass es so aussieht, als würden sie von der Komponente stammen, und nicht von internen Elementen im Shadow DOM. Einige Ereignisse werden nicht einmal aus dem Schatten-DOM weitergegeben.

Die folgenden Ereignisse überschreiten die Schattengrenze:

Fokusereignisse: blur, focus, focusin, focusout
Mausereignisse: click, dblclick, mousedown, mouseenter, mousemove usw.
Rad-Ereignisse: wheel
Eingabeereignisse: beforeinput, input
Tastaturereignisse: keydown, keyup
Zusammensetzungsereignisse: compositionstart, compositionupdate, compositionend
DragEvent: dragstart, drag, dragend, drop usw.

Tipps

Wenn der Schattenbaum geöffnet ist, gibt der Aufruf von event.composedPath() ein Array von Knoten zurück, die das Ereignis durchlaufen hat.

Benutzerdefinierte Ereignisse verwenden

Benutzerdefinierte DOM-Ereignisse, die an internen Knoten in einem Shadow-Tree ausgelöst werden, werden nicht über die Shadow-Grenze hinweg gesendet, es sei denn, das Ereignis wird mit dem Flag composed: true erstellt:

// Inside <fancy-tab> custom element class definition:
selectTab() {
    const tabs = this.shadowRoot.querySelector('#tabs');
    tabs.dispatchEvent(new Event('tab-select', {bubbles: true, composed: true}));
}

Bei composed: false (Standard) können Nutzer das Ereignis nicht außerhalb Ihres Schatten-Roots abhören.

<fancy-tabs></fancy-tabs>
<script>
    const tabs = document.querySelector('fancy-tabs');
    tabs.addEventListener('tab-select', e => {
    // won't fire if `tab-select` wasn't created with `composed: true`.
    });
</script>

Fokus

Wie Sie aus dem Ereignismodell des Shadow-DOMs wissen, werden Ereignisse, die im Shadow-DOM ausgelöst werden, so angepasst, dass sie den Anschein erwecken, als würden sie vom Hostelement stammen. Angenommen, Sie klicken beispielsweise auf ein <input> innerhalb einer Schatten-Stammgruppe:

<x-focus>
    #shadow-root
    <input type="text" placeholder="Input inside shadow dom">

Das focus-Ereignis sieht so aus, als käme es von <x-focus>, nicht von <input>. Entsprechend wird document.activeElement zu <x-focus>. Wenn der Schattenknoten mit mode:'open' erstellt wurde (siehe geschlossener Modus), können Sie auch auf den internen Knoten zugreifen, der den Fokus erhalten hat:

document.activeElement.shadowRoot.activeElement // only works with open mode.

Wenn mehrere Ebenen des Shadow DOM vorhanden sind (z. B. ein benutzerdefiniertes Element in einem anderen benutzerdefinierten Element), müssen Sie rekursiv in die Shadow-Wurzeln eindringen, um die activeElement zu finden:

function deepActiveElement() {
    let a = document.activeElement;
    while (a && a.shadowRoot && a.shadowRoot.activeElement) {
    a = a.shadowRoot.activeElement;
    }
    return a;
}

Eine weitere Option für den Fokus ist die Option delegatesFocus: true, mit der das Fokusverhalten von Elementen in einem Schattenbaum erweitert wird:

Wenn Sie auf einen Knoten im Shadow-DOM klicken und der Knoten kein fokussierbarer Bereich ist, wird der erste fokussierbare Bereich fokussiert.
Wenn ein Knoten im Shadow DOM den Fokus erhält, wird :focus zusätzlich zum fokussierten Element auf den Host angewendet.

Beispiel: Wie delegatesFocus: true das Fokusverhalten ändert

<style>
    :focus {
    outline: 2px solid red;
    }
</style>

<x-focus></x-focus>

<script>
customElements.define('x-focus', class extends HTMLElement {
    constructor() {
    super(); // always call super() first in the constructor.

    const root = this.attachShadow({mode: 'open', delegatesFocus: true});
    root.innerHTML = `
        <style>
        :host {
            display: flex;
            border: 1px dotted black;
            padding: 16px;
        }
        :focus {
            outline: 2px solid blue;
        }
        </style>
        <div>Clickable Shadow DOM text</div>
        <input type="text" placeholder="Input inside shadow dom">`;

    // Know the focused element inside shadow DOM:
    this.addEventListener('focus', function(e) {
        console.log('Active element (inside shadow dom):',
                    this.shadowRoot.activeElement);
    });
    }
});
</script>

Ergebnis

Oben sehen Sie das Ergebnis, wenn <x-focus> den Fokus hat (Nutzerklick, Tabulatortaste, focus() usw.). Es wird auf „Klickbarer Shadow-DOM-Text“ geklickt oder der Fokus liegt auf dem internen <input> (einschließlich autofocus).

Wenn Sie delegatesFocus: false festlegen, sehen Sie stattdessen Folgendes:

delegatesFocus: false und die interne Eingabe hat den Fokus. — `delegatesFocus: false` und der interne `<input>` ist fokussiert.

„delegatesFocus“: „false“ und „x-focus“ erhält den Fokus (z.B. hat es „tabindex='0'“). — `delegatesFocus: false` und `<x-focus>` erhält den Fokus (z.B. durch `tabindex="0"`).

„delegatesFocus“: „false“ und auf „Clickable Shadow DOM text“ (klickbarer Shadow-DOM-Text) oder auf einen anderen leeren Bereich innerhalb des Shadow-DOM des Elements geklickt wird — `delegatesFocus: false` und auf „Klickbarer Shadow DOM-Text“ geklickt wird (oder auf einen anderen leeren Bereich innerhalb des Shadow DOM des Elements).

Tipps und Tricks

Im Laufe der Jahre habe ich das ein oder andere über das Erstellen von Webkomponenten gelernt. Ich denke, einige dieser Tipps werden Ihnen beim Erstellen von Komponenten und beim Debuggen von Shadow DOM nützlich sein.

CSS-Begrenzung verwenden

In der Regel sind das Layout, der Stil und die Darstellung einer Webkomponente ziemlich unabhängig. Mit CSS-Begrenzungen in :host die Leistung steigern:

<style>
:host {
    display: block;
    contain: content; /* Boom. CSS containment FTW. */
}
</style>

Übertragbare Stile zurücksetzen

Übernehmbare Stile (background, color, font, line-height usw.) werden weiterhin im Shadow DOM übernommen. Das heißt, sie durchbrechen standardmäßig die Shadow-DOM-Grenze. Wenn Sie neu beginnen möchten, können Sie mit all: initial; vererbbare Stile auf ihren ursprünglichen Wert zurücksetzen, wenn sie die Schattengrenze überschreiten.

<style>
    div {
    padding: 10px;
    background: red;
    font-size: 25px;
    text-transform: uppercase;
    color: white;
    }
</style>

<div>
    <p>I'm outside the element (big/white)</p>
    <my-element>Light DOM content is also affected.</my-element>
    <p>I'm outside the element (big/white)</p>
</div>

<script>
const el = document.querySelector('my-element');
el.attachShadow({mode: 'open'}).innerHTML = `
    <style>
    :host {
        all: initial; /* 1st rule so subsequent properties are reset. */
        display: block;
        background: white;
    }
    </style>
    <p>my-element: all CSS properties are reset to their
        initial value using <code>all: initial</code>.</p>
    <slot></slot>
`;
</script>

Alle benutzerdefinierten Elemente auf einer Seite finden

Manchmal ist es hilfreich, benutzerdefinierte Elemente auf der Seite zu finden. Dazu müssen Sie das Shadow-DOM aller auf der Seite verwendeten Elemente rekursiv durchlaufen.

const allCustomElements = [];

function isCustomElement(el) {
    const isAttr = el.getAttribute('is');
    // Check for <super-button> and <button is="super-button">.
    return el.localName.includes('-') || isAttr && isAttr.includes('-');
}

function findAllCustomElements(nodes) {
    for (let i = 0, el; el = nodes[i]; ++i) {
    if (isCustomElement(el)) {
        allCustomElements.push(el);
    }
    // If the element has shadow DOM, dig deeper.
    if (el.shadowRoot) {
        findAllCustomElements(el.shadowRoot.querySelectorAll('*'));
    }
    }
}

findAllCustomElements(document.querySelectorAll('*'));

Elemente aus einer <template> erstellen

Anstatt einen Schattenknoten mit .innerHTML zu füllen, können wir eine deklarative <template> verwenden. Vorlagen sind ein idealer Platzhalter, um die Struktur einer Webkomponente zu deklarieren.

Siehe Beispiel unter Benutzerdefinierte Elemente: Wiederverwendbare Webkomponenten erstellen.

Verlauf und Browserunterstützung

Wenn Sie sich in den letzten Jahren mit Webkomponenten beschäftigt haben, wissen Sie, dass in Chrome 35 und höher sowie in Opera seit einiger Zeit eine ältere Version des Shadow-DOMs verwendet wird. Blink wird beide Versionen noch einige Zeit parallel unterstützen. Die Version 0-Spezifikation enthielt eine andere Methode zum Erstellen eines Schatten-Stammknotens (element.createShadowRoot anstelle von element.attachShadow in Version 1). Wenn die ältere Methode aufgerufen wird, wird weiterhin ein Schatten-Stammknoten mit der Version 0-Semantik erstellt, sodass bestehender Version 0-Code nicht beschädigt wird.

Wenn Sie an der alten Version 0 interessiert sind, lesen Sie die Artikel auf html5rocks: 1, 2, 3. Es gibt auch einen guten Vergleich der Unterschiede zwischen Shadow DOM v0 und v1.

Unterstützte Browser

Shadow DOM v1 wird in Chrome 53 (Status), Opera 40, Safari 10 und Firefox 63 unterstützt. Die Entwicklung von Edge hat begonnen.

Prüfen Sie, ob Folgendes vorhanden ist, um Shadow DOM zu erkennen:attachShadow

const supportsShadowDOMV1 = !!HTMLElement.prototype.attachShadow;

Polyfill

Bis die Browserunterstützung weithin verfügbar ist, können Sie die shadydom- und shadycss-Polyfills verwenden, um die Funktion von Version 1 zu nutzen. Shady DOM ahmt die DOM-Begrenzung von Shadow DOM nach und shadycss-Polyfills füllen CSS-Benutzereigenschaften und die Stilbegrenzung der nativen API aus.

Installieren Sie die Polyfills:

bower install --save webcomponents/shadydom
bower install --save webcomponents/shadycss

Verwenden Sie die Polyfills:

function loadScript(src) {
    return new Promise(function(resolve, reject) {
    const script = document.createElement('script');
    script.async = true;
    script.src = src;
    script.onload = resolve;
    script.onerror = reject;
    document.head.appendChild(script);
    });
}

// Lazy load the polyfill if necessary.
if (!supportsShadowDOMV1) {
    loadScript('/bower_components/shadydom/shadydom.min.js')
    .then(e => loadScript('/bower_components/shadycss/shadycss.min.js'))
    .then(e => {
        // Polyfills loaded.
    });
} else {
    // Native shadow dom v1 support. Go to go!
}

Eine Anleitung zum Einfügen von Shims und zum Festlegen des Gültigkeitsbereichs Ihrer Stile finden Sie unter https://github.com/webcomponents/shadycss#usage.

Fazit

Zum ersten Mal haben wir eine API-Primitiv, die eine korrekte CSS- und DOM-Begrenzung bietet und eine echte Komposition ermöglicht. In Kombination mit anderen Webkomponenten-APIs wie benutzerdefinierten Elementen bietet das Shadow-DOM eine Möglichkeit, wirklich gekapselte Komponenten zu erstellen, ohne Hacks oder älteres Gepäck wie <iframe>s zu verwenden.

Verstehen Sie mich nicht falsch. Shadow DOM ist in der Tat ein komplexes Thema. Aber es ist ein Biest, das es wert ist, gelernt zu werden. Nehmen Sie sich Zeit. Lernen Sie es und stellen Sie Fragen.

Weitere Informationen

Unterschiede zwischen Shadow DOM v1 und v0
„Introducing Slot-Based Shadow DOM API“ (Einführung in die slotbasierte Shadow DOM API) aus dem WebKit-Blog
Web Components and the future of Modular CSS von Philip Walton
„Benutzerdefinierte Elemente: Wiederverwendbare Webkomponenten erstellen“ aus den WebFundamentals von Google
Shadow DOM v1-Spezifikation
Spezifikation für benutzerdefinierte Elemente V1

FAQ

Kann ich Shadow DOM v1 bereits verwenden?

Mit einer Polyfill ist das möglich. Weitere Informationen zur Browserunterstützung

Welche Sicherheitsfunktionen bietet Shadow DOM?

Shadow DOM ist keine Sicherheitsfunktion. Es ist ein einfaches Tool zum Festlegen des CSS-Gültigkeitsbereichs und zum Ausblenden von DOM-Baumstrukturen in Komponenten. Wenn Sie eine echte Sicherheitsgrenze benötigen, verwenden Sie eine <iframe>.

Muss eine Webkomponente Shadow DOM verwenden?

Nein. Sie müssen keine Webkomponenten erstellen, die Shadow DOM verwenden. Wenn Sie jedoch benutzerdefinierte Elemente mit Shadow DOM erstellen, können Sie Funktionen wie CSS-Bereichsdefinition, DOM-Kapselung und ‑Komposition nutzen.

Was ist der Unterschied zwischen offenen und geschlossenen Schattenwurzeln?

Weitere Informationen finden Sie unter Geschlossene Schattenwurzeln.