Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

template — šablona fragmentu HTML

Prvek `template` uchovává neaktivní fragment HTML, který může skript zkopírovat a vložit do dokumentu. Jeho obsah je přístupný přes `content`, nikoli jako běžné potomky prvku.

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<template id="item-template"><li></li></template>

Prvek template deklaruje fragment HTML pro pozdější použití. Běžná šablona svůj obsah nezobrazuje; ten zůstává neaktivní, takže se v ní uložené skripty během uložení nespouštějí. Je potřeba otevírací i uzavírací značka.

Vlastnost content objektu HTMLTemplateElement zpřístupňuje DocumentFragment. Prvky zapsané mezi značkami patří do tohoto fragmentu, nikoli mezi běžné potomky prvku template. Vyhledejte je pomocí template.content.querySelector(...); přidávání potomků přímo do template porušuje jeho obsahový model.

Pomocí template.content.cloneNode(true) vytvořte hlubokou kopii struktury. Kopii doplňte a vložte do dokumentu. Vložením fragmentu se přesunou jeho potomci a samotný fragment zůstane prázdný. Vložení původního content místo kopie by šablonu vyprázdnilo.

Deklarativní Shadow DOM je samostatné použití: shadowrootmode může způsobit, že parser vytvoří kořen stínu místo běžné šablony. Následující příklad tento atribut nepoužívá.

Příklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Template example</title>
</head>
<body>
  <template id="item-template"><li></li></template>
  <ul id="items"></ul>
  <script>
    const template = document.getElementById('item-template');
    const items = document.getElementById('items');

    for (const name of ['Ada', 'Lin']) {
      const fragment = template.content.cloneNode(true);
      fragment.querySelector('li').textContent = name;
      items.appendChild(fragment);
    }
  </script>
</body>
</html>

Výsledek

• Ada
• Lin

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje