Element Å¡ablony

Zabudovaný element <template> slouží jako úložiÅ¡tÄ› Å¡ablon HTML kódu. Prohlížeč ignoruje jeho obsah a zkontroluje jen správnost syntaxe, ale v JavaScriptu k nÄ›mu můžeme pÅ™istupovat a používat ho k vytvoÅ™ení dalších elementů.

Teoreticky můžeme pro účely uložení HTML kódu vytvoÅ™it nÄ›kde v HTML jakýkoli neviditelný element. Co je na <template> zvláštního?

Především jeho obsahem může být libovolný HTML, i když by normálně vyžadoval příslušnou uzavírací značku.

Například do nÄ›j můžeme vložit řádek tabulky <tr>:

<template>
  <tr>
    <td>Obsah</td>
  </tr>
</template>

Zpravidla když se pokusíme vložit <tr> tÅ™eba dovnitÅ™ <div>, prohlížeč detekuje vadnou strukturu DOMu a „opraví“ ji tak, že kolem ní pÅ™idá <table>. To není to, co chceme. Naproti tomu <template> uchovává pÅ™esnÄ› to, co tam umístíme.

Do <template> můžeme ukládat i styly a skripty:

<template>
  <style>
    p { font-weight: bold; }
  </style>
  <script>
    alert("Ahoj");
  </script>
</template>

Prohlížeč zachází s obsahem <template>, jako by byl „mimo dokument“: styly se neaplikují, skripty se nespustí, <video autoplay> se nepÅ™ehraje a podobnÄ›.

Obsah ožije (styly se aplikují, skripty se spustí atd.), až když jej vložíme do dokumentu.

Vložení šablony

Obsah Å¡ablony je k dispozici v její vlastnosti content jako DocumentFragment – zvláštní typ DOM uzlu.

Můžeme s ním zacházet jako s kterýmkoli jiným DOM uzlem až na jednu speciální vlastnost: když ho někam vložíme, namísto něj se vloží jeho děti.

Příklad:

<template id="Å¡ablona">
  <script>
    alert("Ahoj");
  </script>
  <div class="zpráva">Ahoj, světe!</div>
</template>

<script>
  let elem = document.createElement('div');

  // Naklonujeme obsah šablony, abychom ho mohli použít vícekrát
  elem.append(Å¡ablona.content.cloneNode(true));

  document.body.append(elem);
  // Nyní se skript z <template> spustí
</script>

PÅ™epiÅ¡me příklad stínového DOMu z minulé kapitoly pomocí <template>:

<template id="Å¡ablona">
  <style> p { font-weight: bold; } </style>
  <p id="zpráva"></p>
</template>

<div id="elem">Klikněte na mě</div>

<script>
  elem.onclick = function() {
    elem.attachShadow({mode: 'open'});

    elem.shadowRoot.append(Å¡ablona.content.cloneNode(true)); // (*)

    elem.shadowRoot.getElementById('zpráva').innerHTML = "Ahoj ze stínu!";
  };
</script>

Když na řádku (*) naklonujeme a vložíme Å¡ablona.content, vloží se namísto nÄ›j jeho dÄ›ti (<style>, <p>), protože je to DocumentFragment.

Budou tvořit stínový DOM:

<div id="elem">
  #shadow-root
    <style> p { font-weight: bold; } </style>
    <p id="zpráva"></p>
</div>

Shrnutí

Když to shrneme:

• Obsahem <template> může být jakýkoli syntakticky správný HTML.
• S obsahem <template> se zachází, jako by byl „mimo dokument“, takže nic neovlivní.
• V JavaScriptu můžeme pÅ™istupovat k obsahu Å¡ablony Å¡ablona.content a naklonovat ho, abychom ho mohli použít v nové komponentÄ›.

Značka <template> je pomÄ›rnÄ› unikátní, neboÅ¥:

• Prohlížeč kontroluje syntaxi HTML uvnitÅ™ ní (na rozdíl od Å™etÄ›zce se Å¡ablonou uvnitÅ™ skriptu).
• …Stále vÅ¡ak umožňuje použít libovolné HTML značky nejvyšší úrovnÄ›, včetnÄ› tÄ›ch, které bez přísluÅ¡ných obklopujících značek nedávají smysl (napÅ™. <tr>).
• Obsah se stane interaktivním, až bude vložen do dokumentu: skripty se spustí, <video autoplay> se začne pÅ™ehrávat atd.

Element <template> neobsahuje žádné iterační mechanismy, datové vazby nebo substituce promÄ›nných, ale můžeme si je na nÄ›m implementovat.