使用 template HTML 標簽的十個重要技巧

作者：dev 2024-08-20 10:15:14

為什么有用？通過使用 <template>，你可以創建可重用的內容塊，這些塊存儲在文檔中，但直到需要時才會顯示。這在需要動態創建多個 UI 組件實例或管理大型數據集時特別有用。

<template> HTML 標簽是一個功能強大但經常被忽視的元素。它允許你定義可重復使用的內容，這些內容可以被克隆并插入到 DOM 中，而不會在最初渲染。這一功能在創建動態、交互式 Web 應用時尤為有用。在本文中，我們將探討 10 個有效使用 <template> 標簽的技巧，幫助你在項目中充分發揮其潛力。

1.理解 <template> 標簽的基礎

<template>標簽是一個 HTML 元素，它包含不會在頁面加載時渲染的客戶端內容。相反，這些內容可以使用 JavaScript 在稍后克隆并插入到文檔中。

<template id="my-template">
  <div class="content">
    <h2>模板內容</h2>
    <p>這段內容在模板中。</p>
  </div>
</template>

為什么有用？通過使用 <template>，你可以創建可重用的內容塊，這些塊存儲在文檔中，但直到需要時才會顯示。這在需要動態創建多個 UI 組件實例或管理大型數據集時特別有用。

2.利用 <template> 標簽創建動態內容

<template>標簽最常見的用途之一是動態生成內容。例如，你可以克隆模板內容并將其追加到 DOM 中，以顯示從 API 獲取的數據。

const template = document.getElementById('my-template');
const clone = template.content.cloneNode(true);
document.body.appendChild(clone);

最佳實踐

確保唯一的 ID：克隆內容時，確保更新 ID 或其他需要保持唯一的屬性。
避免過度克隆：僅克隆所需的內容，以避免不必要的內存使用。

3.使用 <template> 標簽創建可重用的 UI 組件

<template>標簽非常適合創建可重用的 UI 組件，例如模態窗口、工具提示或卡片。通過將組件結構存儲在模板中，你可以輕松實例化多個實例而無需重復代碼。

<template id="card-template">
  <div class="card">
    <h3>卡片標題</h3>
    <p>卡片內容。</p>
  </div>
</template>

<script>
  const template = document.getElementById('card-template');
  for (let i = 0; i < 3; i++) {
    const clone = template.content.cloneNode(true);
    document.body.appendChild(clone);
  }
</script>

提示

模塊化代碼：將模板定義與 JavaScript 邏輯分開，保持代碼整潔有序。
克隆后定制：修改克隆的內容（例如文本或屬性），以創建組件的獨特實例。

4.將 <template> 標簽與 JavaScript 框架集成

許多現代 JavaScript 框架和庫（如 React、Vue 和 Angular）使用自己的模板系統。然而，在某些場景下，原生的<template>標簽仍然非常有用，例如在需要管理框架生命周期之外的內容時。

原生 JavaScript 示例

const template = document.getElementById('my-template');
const list = document.getElementById('item-list');

fetch('/api/items')
  .then(response => response.json())
  .then(items => {
    items.forEach(item => {
      const clone = template.content.cloneNode(true);
      clone.querySelector('h2').textContent = item.title;
      clone.querySelector('p').textContent = item.description;
      list.appendChild(clone);
    });
  });

提示

為特殊情況使用 <template> 標簽：在框架特定解決方案可能不夠靈活的場景中，使用 <template> 標簽。
與 Web 組件結合：在自定義元素中使用 <template> 標簽來定義 shadow DOM 內容。

5.使用 <template> 優化性能

<template>標簽對于性能優化非常有用。由于<template>中的內容在克隆之前不會渲染，你可以通過推遲非必要內容的渲染來減少初始頁面加載時間。

<template id="deferred-content">
  <div class="hidden-content">
    <p>這段內容稍后加載。</p>
  </div>
</template>

<script>
  window.addEventListener('load', () => {
    const template = document.getElementById('deferred-content');
    const clone = template.content.cloneNode(true);
    document.body.appendChild(clone);
  });
</script>

最佳實踐

延遲非關鍵內容：使用 <template> 加載用戶不立即需要的內容。
延遲加載：將 <template> 與延遲加載技術結合使用，以進一步提高性能。

6.通過 <template> 增強可訪問性

使用<template>標簽時，要注意可訪問性。由于模板中的內容在插入 DOM 之前不會渲染，確保克隆的內容對所有用戶都可訪問非常重要。

提示

const template = document.getElementById('accessible-template');
const clone = template.content.cloneNode(true);
clone.querySelector('.content').setAttribute('aria-live', 'polite');
document.body.appendChild(clone);

克隆后添加 ARIA 屬性：確保在模板內容插入 DOM 后添加任何必要的 ARIA 屬性。
屏幕閱讀器測試：使用屏幕閱讀器測試你的應用，以確保克隆的內容是可訪問的。

7.使用 <template> 管理大數據集

對于需要顯示大數據集的應用程序，<template>標簽可以幫助有效管理 DOM。通過克隆模板而不是手動創建元素，你可以保持代碼簡潔，并優化 DOM 交互。

<template id="row-template">
  <tr>
    <td class="name"></td>
    <td class="age"></td>
    <td class="email"></td>
  </tr>
</template>

<script>
  const template = document.getElementById('row-template');
  const tableBody = document.getElementById('table-body');

  fetch('/api/users')
    .then(response => response.json())
    .then(users => {
      users.forEach(user => {
        const clone = template.content.cloneNode(true);
        clone.querySelector('.name').textContent = user.name;
        clone.querySelector('.age').textContent = user.age;
        clone.querySelector('.email').textContent = user.email;
        tableBody.appendChild(clone);
      });
    });
</script>

提示

高效渲染：使用 <template> 標簽高效渲染大型表格或列表。
批量更新：批量處理 DOM 更新，最小化重排和重繪。

8.使用 <template> 處理條件內容

<template>標簽非常適合需要根據用戶交互或數據來顯示內容的場景。這樣，你可以提前準備內容，并在必要時顯示它。

<template id="login-template">
  <div class="login-form">
    <input type="text" placeholder="用戶名">
    <input type="password" placeholder="密碼">
    <button>登錄</button>
  </div>
</template>

<script>
  const template = document.getElementById('login-template');
  const loginContainer = document.getElementById('login-container');

  document.getElementById('show-login').addEventListener('click', () => {
    const clone = template.content.cloneNode(true);
    loginContainer.appendChild(clone);
  });
</script>

提示

預加載模板：預加載可能會根據用戶操作顯示的內容，以確保流暢的體驗。
切換可見性：將 <template> 與可見性切換結合使用，以創建交互式元素。

9.通過 <template> 簡化表單處理

表單通常需要動態元素，如添加或移除輸入字段。<template>標簽可以簡化此過程，允許你在需要時克隆預定義的表單字段。

<template id="field-template">
  <div class="form-field">
    <input type="text" placeholder="輸入值">
    <button class="remove-field">移除</button>
  </div>
</template>

<script>
  const template = document.getElementById('field-template');
  const form = document.getElementById('dynamic-form');

  document.getElementById('add-field').addEventListener('click', () => {
    const clone = template.content.cloneNode(true);
    form.appendChild(clone);
  });

  form.addEventListener('click', event => {
    if (event.target.classList.contains('remove-field')) {
      event.target.closest('.form-field').remove();
    }
  });
</script>

提示

動態表單：使用 <template> 根據用戶輸入動態添加或移除表單字段。
表單驗證：確保克隆的表單字段包含所有必要的驗證邏輯。

10.將 <template> 與 Web 組件結合使用

<template>標簽是創建 Web 組件的重要組成部分。通過將<template>與自定義元素結合使用，你可以封裝并重用復雜的 UI 組件。

<template id="tooltip-template">
  <style>
    .tooltip {
      position: absolute;
      background: #333;
      color: #fff;
      padding: 5px;
      border-radius: 4px;
      font-size: 12px;
      visibility: hidden;
      transition: visibility 0.2s;
    }
  </style>
  <div class="tooltip">
    <slot></slot>
  </div>
</template>

<script>
  class TooltipElement extends HTMLElement {
    constructor() {
      super();
      const template = document.getElementById('tooltip-template').content;
      const shadowRoot = this.attachShadow({ mode: 'open' });
      shadowRoot.appendChild(template.cloneNode(true));
    }

    connectedCallback() {
      this.addEventListener('mouseover', () => {
        this.shadowRoot.querySelector('.tooltip').style.visibility = 'visible';
      });

      this.addEventListener('mouseout', () => {
        this.shadowRoot.querySelector('.tooltip').style.visibility = 'hidden';
      });
    }
  }

  customElements.define('my-tooltip', TooltipElement);
</script>

<!-- 自定義提示工具元素的用法 -->
<my-tooltip>
  將鼠標懸停在我上面
  <span slot="tooltip-text">這是一個提示工具</span>
</my-tooltip>

結合 <template> 和 Web 組件的優勢

封裝：將組件的樣式和邏輯與應用的其余部分隔離開來。
可重用性：在應用的不同部分輕松重用復雜組件。
一致性：確保 UI 元素在整個應用中表現一致。

<template> HTML 標簽是一個多功能的工具，可以顯著改善你在 Web 應用中管理和操作 DOM 內容的方式。無論是創建可重用組件、管理大數據集，還是優化性能，<template> 標簽都提供了一種簡潔而高效的解決方案。通過掌握本文中討論的技巧和方法，你可以充分利用 <template> 標簽的潛力，構建更加動態、易于維護且性能更佳的 Web 應用。

在繼續探索 <template> 標簽的功能時，考慮將其與現代 Web 開發實踐（如 Web 組件和 JavaScript 框架）結合使用，以創建更強大和靈活的解決方案。

責任編輯：武曉燕來源：大遷世界

文檔 UI 組件