CKTIS / HTML
slot — ein Element einem Shadow-DOM-Slot zuweisen
Das globale Attribut slot wählt einen benannten Slot im Shadow DOM aus, an dem ein Element dargestellt wird. Sein Wert entspricht dem name-Wert des slot-Elements; Attribut und Element haben unterschiedliche Aufgaben.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
slot="name"Das Attribut slot ist für alle HTML-Elemente zulässig. Bei der gewöhnlichen namensbasierten Zuweisung bestimmt es, an welcher Stelle im Shadow DOM des übergeordneten Elements ein Element dargestellt wird. Das Attribut allein erzeugt weder einen Shadow Tree noch eine Einfügestelle für Inhalte.
Verwechsle das Attribut slot am bereitgestellten Element nicht mit dem Element slot innerhalb des Shadow Trees. Das Attribut wählt einen Namen aus; das Element definiert über name ein Ziel mit diesem Namen. Die Werte müssen exakt übereinstimmen, auch hinsichtlich der Groß- und Kleinschreibung. Das zugewiesene Element muss ein direktes Kind des Hosts sein; das Attribut auf einem beliebigen tieferen Nachfahren reicht nicht aus.
Ein fehlendes Attribut oder slot="" wählt den Standard-Slot aus, also einen Slot ohne Namen. Ein nicht übereinstimmender Name führt nicht zum Standard-Slot. Ersatzinhalt innerhalb eines slot-Elements wird angezeigt, wenn ihm keine Knoten zugewiesen sind. Die Zuweisung verschiebt das Element nicht im DOM-Baum.
Im Beispiel bleibt span ein Kind von host, wird aber an der Stelle des slot mit name="label" dargestellt. Der erwartete Seitentext lautet Label: Hello. Nach der Änderung zu slot="other" lautet der erwartete Text Label: Fallback.
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>slot demo</title>
<div id="host"><span slot="label">Hello</span></div>
<script>
const host = document.getElementById('host');
const root = host.attachShadow({ mode: 'open' });
root.innerHTML = '<p>Label: <slot name="label">Fallback</slot></p>';
</script>Ergebnis
Label: Hello
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.