Шаблонизация: партиалы и генераторы страниц
Как не копировать шапку и подвал в каждый файл: партиалы и include, генераторы статических сайтов (Eleventy, Astro) и шаблонные строки JavaScript. Обзорный урок.
Проблема повторов
У сайта из десяти страниц на каждой есть одинаковые шапка, меню и подвал. Если скопировать их десять раз, то при смене пункта меню придётся править десять файлов и обязательно что-то забудешь. Чистый HTML не умеет подключать другие файлы, поэтому на помощь приходит шаблонизация: общие части выносят в отдельные файлы (партиалы, англ. partials), а инструмент склеивает из них готовые страницы.
Партиалы и include
Идея в любом движке одна: пишем общий кусок один раз и вставляем командой. Синтаксис зависит от инструмента. Вот пример на Nunjucks, который используют, в частности, в Eleventy:
<!-- _includes/header.njk -->
<header>
<a href="/">Главная</a>
<a href="/about/">О нас</a>
</header>
<!-- страница -->
{% include "header.njk" %}
<main>Содержимое страницы</main>
Рядом часто идут макеты (layouts): общая обёртка страницы с <head>, шапкой и подвалом, в которую подставляется содержимое каждой страницы. В PHP то же делается через include, а в старых HTML-проектах для этого применяли технологию SSI. Переменные тоже поддерживаются, например заголовок страницы подставляется в <title> макета.
Генераторы статических сайтов
Генератор статических сайтов (SSG) на этапе сборки превращает шаблоны и данные в обычные HTML-файлы, которые можно выложить на любой хостинг. Вот два популярных:
| Инструмент | Особенности |
|---|---|
| Eleventy (11ty) | простой, работает на Node.js, поддерживает Nunjucks, Liquid, Markdown и другие шаблонизаторы; ничего не навязывает |
| Astro | компонентный подход, по умолчанию отдаёт страницы без лишнего JavaScript, удобен для контентных сайтов |
Запускаются они командами npm, как Vite в одном из прошлых уроков, а результат складывается в папку сборки (в Eleventy по умолчанию _site). Содержимое страниц часто пишут в Markdown, а генератор оборачивает его в макет. Если сайт небольшой и редко меняется, такой подход — золотая середина между ручным HTML и громоздкой CMS.
Шаблонные строки JavaScript
В самом JavaScript есть встроенное средство для сборки HTML из данных: шаблонная строка в обратных кавычках с подстановкой через ${}. Это лишь краткий пример, сам язык изучим дальше:
const items = ["Главная", "Каталог", "Контакты"];
const menu = `
<ul>
${items.map((name) => `<li>${name}</li>`).join("")}
</ul>`;
Переменная menu станет строкой с тремя пунктами списка. Метод map превращает каждый элемент массива в строку с тегом <li>, а join("") склеивает их. Если данные приходят от пользователя, их нужно экранировать, иначе возможны уязвимости; это мы обсудим в курсе по JavaScript.
Возьмите свой сайт из двух-трёх страниц. Выпишите, какие блоки повторяются на каждой странице (шапка, меню, подвал, подключаемые стили). Нарисуйте схему: что вы вынесете в партиалы, а что в макет. Затем попробуйте Eleventy по документации (11ty.dev): создайте макет и страницу, соберите сайт и сравните результат с исходным HTML.
Начните с самого простого: вынесите в партиал только подвал. Когда заработает, добавьте шапку, а затем и общий макет.
Оглавление курса
Модуль 1Старт10
- 1Что такое HTML и как работает веб-страница
- 2Инструменты: редактор, браузер и DevTools
- 3Первая страница: Hello, World
- 4Структура документа: doctype, html, head, body
- 5Раздел head: title, meta и кодировка
- 6Теги и атрибуты
- 7Комментарии и проверка разметки
- 8Файлы проекта и пути: абсолютные и относительные
- 9Публикация сайта: GitHub Pages и хостинг
- 10История HTML и стандарты: WHATWG, W3C
Модуль 2Текст, ссылки и списки10
Модуль 3Изображения, медиа и таблицы10
- 21Изображения: тег img
- 22Форматы изображений, srcset и picture
- 23figure и figcaption
- 24Аудио и видео: audio, video
- 25Встраивание: iframe, YouTube и карты
- 26Таблицы: основы
- 27Структура таблицы: thead, tbody, tfoot
- 28Объединение ячеек: colspan и rowspan
- 29Доступные таблицы: caption и scope
- 30Практикум: таблица тарифов
Модуль 4Семантическая вёрстка10
Модуль 5Формы10
- 41Форма: form, action и method
- 42Типы полей input
- 43label, id и name
- 44textarea и select
- 45Флажки и переключатели
- 46Кнопки: button и input type=submit
- 47Встроенная валидация: required, pattern, min, max
- 48Группировка полей: fieldset и legend
- 49datalist, output, progress и meter
- 50Практикум: форма регистрации
