Когда стоит использовать simple_tag в шаблонах Django

В Django передача данных в шаблон обычно начинается двумя способами.

  • Передача данных через контекст в представлении: явно передаём данные, необходимые для рендеринга страницы.
  • Глобальная передача данных через context processor: добавляем данные, которые нужны во всех шаблонах.

Есть ещё один способ – simple_tag (пользовательский тег шаблона).

Правильно использованный simple_tag облегчает представление, а шаблон делает более чистым. Неправильное использование приводит к потере прозрачности данных, и поддержка становится труднее.

Django веб‑разработка в центре кухни

В этой статье я не претендую на «правильный» ответ, а просто делюсь тем, когда я обычно использую simple_tag.

Определение simple_tag в одном предложении

Функция, принимающая уже существующие значения в шаблоне и возвращающая результат, готовый к отображению.

  • Можно вызывать по запросу (on demand).
  • Логика форматирования/комбинирования/преобразования вынесена из шаблона.

Границы традиционных подходов

Вставка в представлении: «основные данные страницы»

Если данные критичны для рендеринга страницы, я всегда оставляю их в представлении.

  • Список/детали, формирующие структуру страницы.
  • Результаты условных веток.
  • Данные, полученные через ORM‑запросы.

Переносить это в тег шаблона затрудняет отслеживание.

Context processor: «глобальные данные для всех шаблонов»

Примеры:

  • request
  • Информация о вошедшем пользователе
  • Глобальные настройки/меню/конфигурация
  • Общие UI‑данные, например, количество уведомлений

Но context processor имеет свои недостатки.

  • Автоматически добавляется везде, что затрудняет отслеживание.
  • Сложный код повышает стоимость каждой страницы.

Поэтому я ограничиваю глобальные данные и обрабатываю их через simple_tag.

Критерии использования simple_tag

Мои правила просты:

  1. Ключевые данные страницы? → представление
  2. Есть ли ORM‑запросы? → представление
  3. Можно ли собрать/преобразовать данные из request и context processor? → simple_tag
  4. Отделена от основной логики? → simple_tag

Главное:

  • Ответственность за «получение» данных (особенно из БД) – в представлении.
  • Ответственность за «подготовку к отображению» – в simple_tag.

Почему ORM всегда в представлении

Использование ORM в тегах шаблона часто приводит к:

  • N+1‑запросам при итерации.
  • Задержке в обнаружении источника проблемы.
  • Неясности в применении кэширования/префетчинга.

Поэтому я придерживаюсь:

  • Логика работы с БД – в представлении (или сервис‑слое).
  • simple_tag обрабатывает только уже полученные данные.

Самый распространённый паттерн: комбинирование request + глобального контекста

Я обеспечиваю доступность request и значений из пользовательских context processor'ов во всех шаблонах, а simple_tag использует их для:

  • Составления строк.
  • Изменения формата по условию.
  • Преобразования типов.
  • Формирования структуры, удобной для шаблона.

Преимущества:

  • В представлении нет «кода только для вывода».
  • В шаблоне можно быстро вызвать короткую функцию.
  • Нет обращения к БД – только к уже переданным данным.

Пример: перенос сложной логики в simple_tag

В шаблонах удобно использовать {% if %} и {% for %}, но при росте условий и вложенности код становится нечитаемым.

Например, при комбинировании глобальных данных и request часто возникает длинный блок условий.

Перенос логики в simple_tag позволяет:

  • Сосредоточить шаблон на UI.
  • Тестировать и поддерживать логику в одном месте.
{% load ui_helpers %}
{% greeting_message %}

Внутри тега выполняется вся сложная проверка, а шаблон остаётся чистым.

Ситуации, где simple_tag особенно полезен

  • Повторяющееся форматирование (даты, суммы, текстовые метки) в нескольких шаблонах.
  • Определение UI‑состояния на основе request (активные пункты меню, переключатели).
  • Преобразование глобального контекста в структуру, удобную для шаблона.
  • UI‑помощники, не связанные с основной логикой представления (выбор CSS‑классов, генерация текста бейджей, простые проверки прав).

Важность согласованных критериев в команде

Мои правила – не абсолютная истина, но наличие критериев:

  • Сохраняет понятность кода.
  • Упрощает отладку и поддержку.
  • Снижает споры при код‑ревью.

Я доволен этим подходом и продолжаю его использовать.

Итоги

Как вы разделяете ответственность?

  • Как далеко допускаете глобальный контекст?
  • Как далеко встраиваете логику в теги шаблона?
  • Где заканчивается «обязанность представления»?

Независимо от подхода, наличие чётких критериев – ключ к долгосрочной поддержке.

Связанные статьи