Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

template — predloga fragmenta HTML

Element `template` hrani neaktivni fragment HTML, ki ga lahko skript kopira in vstavi v dokument. Do njegove vsebine dostopamo prek `content`, ne kot do običajnih otrok elementa.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

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

Element template deklarira fragment HTML za poznejšo uporabo. Običajna predloga svoje vsebine ne prikazuje; ta ostane neaktivna, zato se skripti v njej med shranjevanjem ne izvajajo. Potrebni sta tako začetna kot zaključna oznaka.

Lastnost content objekta HTMLTemplateElement razkriva DocumentFragment. Elementi, zapisani med oznakama, pripadajo temu fragmentu in ne običajnim otrokom elementa template. Poiščite jih z template.content.querySelector(...); neposredno dodajanje otrok elementu template krši njegov vsebinski model.

Uporabite template.content.cloneNode(true) za globoko kopiranje strukture. Kopijo dopolnite in jo vstavite v dokument. Vstavitev fragmenta premakne njegove otroke, sam fragment pa ostane prazen. Vstavitev izvirnega content namesto kopije bi izpraznila predlogo.

Deklarativni Shadow DOM je ločena uporaba: shadowrootmode lahko povzroči, da razčlenjevalnik ustvari koren sence namesto običajne predloge. Spodnji primer tega atributa ne uporablja.

Primeri

<!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>

Rezultat

• Ada
• Lin

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri