Простейшим способом создания объекта Template является его прямое порождение. Класс Template расположен в модуле django.template, конструктор принимает единственный аргумент — строку с кодом шаблона. Давайте рассмотрим как это всё работает с помощью интерактивного интерпретатора языка Python.

В каталоге проекта mysite, созданном с помощью команды django-admin.py startproject (это было описано в главе «Начинаем»), выполните команды python manage.py shell для запуска интерактивного интерпретатора.

Рассмотрим основы шаблонной системы:

>>> from django.template import Template
>>> t = Template('My name is {{ name }}.')
>>> print t

Если вы попробовали запустить данный код в интерпретаторе, то вы увидели нечто подобное:

<django.template.Template object at 0xb7d5f24c>

Шестнадцатеричный адрес объекта — 0xb7d5f24c будет всякий раз разным, не обращайте на это внимание. Это внутренняя информация Python, так называемый «идентификатор» созданного объекта Template.

При создании объекта Template шаблонная система компилирует строку с кодом шаблона во внутренний оптимизированный формат, готовый для обработки. Но если ваш шаблонный код содержит синтаксические ошибки, вызов Template() приведёт к исключению TemplateSyntaxError:

>>> from django.template import Template
>>> t = Template('{% notatag %}')
Traceback (most recent call last):
  File "<stdin>", line 1, in ?
  ...
django.template.TemplateSyntaxError: Invalid block tag: 'notatag'

Термин «block tag^[7]» в данном случае относится к {% notatag %}. «Блочный тег» и «шаблонный тег» являются синонимами.

Система вызывает исключение TemplateSyntaxError в любом из нижеприведённых случаев:

После того, как объект Template создан, вы можете передавать ему данные через контекст. Контекстом называют набор значений, ассоциированных с шаблонными переменными. Шаблон использует контекст для замены шаблонных переменных на значения и для вычисления тегов.

Контекст в Django представлен классом Context, который определён в модуле django.template. Конструктор этого класса принимает один необязательный аргумент — словарь, содержащий имена переменных и ассоциированные им значения. Вызовите метод render() объекта Template для заполнения шаблона контекстными значениями:

>>> from django.template import Context, Template
>>> t = Template('My name is {{ name }}.')
>>> c = Context({'name': 'Stephane'})
>>> t.render(c)
u'My name is Stephane.'

Единственное, о чём следует упомянуть — то, что значение t.render(c) является объектом Unicode, а не обычной строкой Python. Вы можете выразить это, добавив u перед строкой. Django везде использует объекты Unicode вместо обычных строк. Если вы не понимаете последствия этого подхода, не беспокойтесь. Просто запомните, что поддержка Unicode позволяет упростить для вашего приложения поддержку национальных языков.

Имена переменных должны начинаться с буквы (A-Z или a-z) и могут состоять из множества букв, цифр, символов подчёркивания и точек. (Точки являются особым случаем, мы скоро рассмотрим их.) Имена переменных регистрозависимы.

Ниже показан пример компиляции и обработки шаблона, который похож на тот, что мы рассмотрели в начале главы:

>>> from django.template import Template, Context
>>> raw_template = """<p>Dear {{ person_name }},</p>
...
... <p>Thanks for placing an order from {{ company }}. It's scheduled to
... ship on {{ ship_date|date:"F j, Y" }}.</p>
...
... {% if ordered_warranty %}
... <p>Your warranty information will be included in the packaging.</p>
... {% else %}
... <p>You didn't order a warranty, so you're on your own when
... the products inevitably stop working.</p>
... {% endif %}
...
... <p>Sincerely,<br />{{ company }}</p>"""
>>> t = Template(raw_template)
>>> import datetime
>>> c = Context({'person_name': 'John Smith',
...     'company': 'Outdoor Equipment',
...     'ship_date': datetime.date(2009, 4, 2),
...     'ordered_warranty': False})
>>> t.render(c)
u"<p>Dear John Smith,</p>\n\n<p>Thanks for placing an order from Outdoor
Equipment. It's scheduled to\nship on April 2, 2009.</p>\n\n\n<p>You
didn't order a warranty, so you're on your own when\nthe products
inevitably stop working.</p>\n\n\n<p>Sincerely,<br />Outdoor Equipment
</p>"

Рассмотрим каждую строку кода:

Таковы основы использования шаблонной системы Django: просто напишите шаблонную строку, создайте объект Template, создайте Context и вызовите метод render().

После того, как вы создали объект Template, вы можете с его помощью обработать множество контекстов. Например:

# Так делать не стоит
for name in ('John', 'Julie', 'Pat'):
    t = Template('Hello, {{ name }}')
    print t.render(Context({'name': name}))

# Правильный подход
t = Template('Hello, {{ name }}')
for name in ('John', 'Julie', 'Pat'):
    print t.render(Context({'name': name}))

Django обрабатывает шаблон достаточно быстро. Внутри всё это сводится к вызову единственного регулярного выражения. Это сильно контрастирует по отношению к шаблонным движкам, построенным на XML, которые вносят затраты на разбор XML и по скорости проигрывают шаблонной системе Django.

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

Ключом к такой всеядности является символ . (точка). Используйте точку для получения доступа к ключам словаря, атрибутам, методам и индексам объекта.

Это хорошо проиллюстрировано в нескольких примерах. Например, предположим, что вы передали словарь в шаблон. Для получения доступа к значениям этого словаря по ключу следует использовать точку:

>>> from django.template import Template, Context
>>> person = {'name': 'Sally', 'age': '43'}
>>> t = Template('{{ person.name }} is {{ person.age }} years old.')
>>> c = Context({'person': person})
>>> t.render(c)
u'Sally is 43 years old.'

Аналогично, точка также позволяет получить доступ к атрибутам объекта. Например, объект datetime.date содержит атрибуты year, month и day, и вы можете получить к ним доступ:

>>> from django.template import Template, Context
>>> import datetime
>>> d = datetime.date(1993, 5, 2)
>>> d.year
1993
>>> d.month
5
>>> d.day
2
>>> t = Template('The month is {{ date.month }} and the year is {{ date.year }}.')
>>> c = Context({'date': d})
>>> t.render(c)
u'The month is 5 and the year is 1993.'

Следующий пример использует класс, демонстрируя методику получения доступа к атрибутам объекта:

>>> from django.template import Template, Context
>>> class Person(object):
...     def __init__(self, first_name, last_name):
...         self.first_name, self.last_name = first_name, last_name
>>> t = Template('Hello, {{ person.first_name }} {{ person.last_name }}.')
>>> c = Context({'person': Person('John', 'Smith')})
>>> t.render(c)
u'Hello, John Smith.'

С помощью точек можно получать доступ к методам объектов. Например, каждая строка Python обладает методами upper() и isdigit(), и вы можете использовать их в шаблонной системе Django с помощью «точечного» синтаксиса:

>>> from django.template import Template, Context
>>> t = Template('{{ var }} -- {{ var.upper }} -- {{ var.isdigit }}')
>>> t.render(Context({'var': 'hello'}))
u'hello -- HELLO -- False'
>>> t.render(Context({'var': '123'}))
u'123 -- 123 -- True'

Следует отметить, что не следует завершать имя метода скобками. Также нет никакой возможности передать аргументы в методы, вы можете использовать только те методы, которые не требуют аргументов. (Мы объясним такой подход немного позже в этой главе.)

Наконец, точки используются для доступа к элементам списка по индексу, например:

>>> from django.template import Template, Context
>>> t = Template('Item 2 is {{ items.2 }}.')
>>> c = Context({'items': ['apples', 'bananas', 'carrots']})
>>> t.render(c)
u'Item 2 is carrots.'

Отрицательные значения индекса не допускаются. Например, шаблонная переменная {{ items.-1 }} вызовет исключение TemplateSyntaxError.

Использование «точечного» синтаксиса можно описать так, когда шаблонная система обнаруживает точку в имени переменной, она пытается выполнить следующие действия в указанном порядке:

Система использует первое, что сработает.

«Точечный» поиск может быть многоуровневым. Например, в следующем примере используется переменная {{ person.name.upper }}, которая преобразовывается в поиск по словарю (person['name']) и затем вызывается метод (upper()):

>>> from django.template import Template, Context
>>> person = {'name': 'Sally', 'age': '43'}
>>> t = Template('{{ person.name.upper }} is {{ person.age }} years old.')
>>> c = Context({'person': person})
>>> t.render(c)
u'SALLY is 43 years old.'

>>> from django.template import Template, Context
>>> t = Template('Your name is {{ name }}.')
>>> t.render(Context())
u'Your name is .'
>>> t.render(Context({'var': 'hello'}))
u'Your name is .'
>>> t.render(Context({'NAME': 'hello'}))
u'Your name is .'
>>> t.render(Context({'Name': 'hello'}))
u'Your name is .'

Большую часть времени, вы будете создавать объекты Context передавая готовый словарь в Context(). Но вы можете добавлять и удалять элементы из объекта Context после его создания, используя стандартный синтаксис словаря Python:

>>> from django.template import Context
>>> c = Context({"foo": "bar"})
>>> c['foo']
'bar'
>>> del c['foo']
>>> c['foo']
Traceback (most recent call last):
  ...
KeyError: 'foo'
>>> c['newvariable'] = 'hello'
>>> c['newvariable']
'hello'