Как сформировать отдельный хидер или футер для первой страницы в mPDF на примере Drupal

Когда вам нужно создать PDF-документ с использованием библиотеки mPDF, бывает необходимо сделать так, чтобы на первой странице отображался отдельный футер (или хидер), отличающийся от остальных страниц. В этом примере мы рассмотрим, как использовать селектор @page :first для задания различных футеров для первой страницы и всех остальных страниц в вашем документе. Этот подход будет полезен не только для проектов на Drupal, но и для любых других случаев, где используется mPDF.

Основы подхода: использование @page :first

Для начала, вам нужно настроить CSS стили для страницы и футеров. Примерно так это выглядит:

Для всех страниц (кроме первой) используется стандартный футер print-page-footer.

Для первой страницы мы устанавливаем особый футер print-page-footer-first.

Дополнительно для рендера в браузере (например, при просмотре на экране) мы скрываем общий футер, чтобы не отображать оба футера сразу.

HTML-шаблон (Twig)

Чтобы настроить рендеринг футеров, нужно воспользоваться специализированными тегами htmlpagefooter из mPDF. Для этого создадим два отдельных контейнера для футеров — один для всех страниц, второй только для первой.

Как видно, мы подключаем один и тот же подшаблон футера (page-foot.twig), но оборачиваем его в разные контейнеры htmlpagefooter. Первый футер будет использоваться для всех страниц, кроме первой, а второй — только для первой страницы. В подшаблон передается параметр isFirst, который определяет, какой контент отобразить.

Логика внутри подшаблона

Теперь давайте разберемся с логикой внутри самого подшаблона page-foot.twig, где вы можете задать условие на отображение различного контента в зависимости от значения флага isFirst.

Здесь мы используем проверку флага isFirst, чтобы определить, какой контент выводить в футере. Когда isFirst равен 1, выводится футер для первой страницы, иначе — стандартный футер.

    Мало букафф? Читайте есчо !

    Убираем вставку   в пустые div контейнеры в CKEditor 5

    Апрель 9, 2025 г.

    Неприятная особенность CKEditor - добавляет в пустые контейнера (в <div>,<p> и т.п.) html код неразрывного пробела. Покажу как можно от этого избавиться через код в кастомном плагине для CKEditor 5 в экосистеме Drupal 8+. Нам понадобится ...

    Читать

    Кастомные настройки сайта в Drupal

    Март 9, 2025 г.

    На сайте всегда (или почти всегда) возникает задача управления настройками вроде телефон, email, какие то текстовые элементы, вроде копирайта, адрес организации и т.п. С точки зрения данных - требуется объект в терминах шаблонов проектирования - синглтон. ...

    Читать

    Twig-функция qr_code() в Drupal: простой плагин с использованием Endroid QR Code

    Октябрь 23, 2025 г.

    Иногда в шаблоне Drupal удобно вывести QR-код прямо по месту — без внешних файлов, без рендеринга через отдельный контроллер и без подключения сторонних ...

    Читать

    Добавить произвольную ссылку в меню на этапе препросессинга в Drupal

    Март 17, 2025 г.

    Иногда бывает потребность создать ссылку из кода. Структура ссылки довольно сложная на этапе препроцессинга шаблона меню, делюсь сниппетом кода. Потребуются следующие зависимости: [crayon-6966a49365c94412042323/] Добавим ссылку в меню main. ...

    Читать
     

    Комментарии к «Как сформировать отдельный хидер или футер для первой страницы в mPDF на примере Drupal»

    Понравилась статья? Есть вопросы? - пишите в комментариях.



    Комментарий: