<slot>...</slot>

HTML4 HTML5

Znacznik <slot> jest specjalnym elementem w technologii Web Components (Shadow DOM). Służy jako miejsce docelowe (tzw. placeholder) wewnątrz szablonu komponentu, w które twórca strony może wstrzyknąć własną, zewnętrzną treść HTML.

Dzięki niemu można tworzyć elastyczne i wielokrotnego użytku komponenty, których wewnętrzna struktura jest zdefiniowana raz, ale zawartość poszczególnych sekcji (np. nagłówka czy stopki) może być modyfikowana z zewnątrz.

Oba znaczniki, otwierający i zamykający, są obowiązkowe.

Atrybuty:

Przykład 1

W poniższym przykładzie zdefiniowano szablon komponentu karty, w którym znacznik <slot> z atrybutem name="card-text" wyznacza miejsce na niestandardowy tekst. Jeśli użytkownik komponentu nie przekaże własnej treści, wyświetlony zostanie tekst domyślny znajdujący się wewnątrz slotu:

Kod:

<template id="custom-card-template"> <div style="border: 1px solid #999; padding: 10px; border-radius: 4px;"> <h3 style="margin-top: 0;">Karta komponentu</h3> <p> <slot name="card-text">To jest domyślny tekst karty (wyświetlany, gdy brak własnej treści).</slot> </p> </div> </template>

Przeglądarka zinterpretuje ten szablon i jego sloty (po wyrenderowaniu w komponencie) następująco:

Karta komponentu

To jest domyślny tekst karty (wyświetlany, gdy brak własnej treści).

Przykład 2: Dwa sloty (jeden z treścią domyślną, drugi z treścią wstrzykniętą)

W tym przykładzie komponent posiada dwa sloty: title oraz footer. Do pierwszego slotu wstrzykujemy własny nagłówek z zewnątrz, natomiast drugi slot pozostaje pusty w wywołaniu, przez co przeglądarka wyświetla w jego miejscu wbudowaną treść domyślną:

Kod:

<!-- Szablon komponentu z dwoma slotami --> <template id="user-card-template"> <div style="border: 1px solid #666; padding: 12px;"> <header> <slot name="title">Domyślny tytuł nagłówka</slot> </header> <footer style="margin-top: 10px; font-size: 0.9em; color: #555;"> <slot name="footer">Domyślna treść stopki komponentu</slot> </footer> </div> </template> <!-- Użycie komponentu: wstrzykujemy własny tytuł, a stopkę zostawiamy domyślną --> <user-card> <h4 slot="title" style="margin: 0;">Wstrzyknięty tytuł: Profil użytkownika</h4> </user-card>

Przeglądarka zinterpretuje ten układ następująco (nagłówek zastąpiono własną treścią, a w stopce pozostał tekst domyślny):

Wstrzyknięty tytuł: Profil użytkownika