在 Django 模板中遍历复杂数据结构的关键是句点字符 (.)。

最好是用几个例子来说明一下。 比如,假设你要向模板传递一个 Python 字典。 要通过字典键访问该字典的值,可使用一个句点:

>>> 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.\'

同样,也可以通过句点来访问对象的属性。 比方说, Python 的 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.\'

这个例子使用了一个自定义的类,演示了通过实例变量加一点(dots)来访问它的属性,这个方法适用于任意的对象。

>>> 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() 方法,你在模板中可以使用同样的句点语法来调用它们:

>>> 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“

Python 列表类型

一点提示: Python的列表是从0开始索引。 第一项的索引是0,第二项的是1,依此类推。

句点查找规则可概括为: 当模板系统在变量名中遇到点时,按照以下顺序尝试进行查找:

  •     字典类型查找 (比如 foo[\”bar\”] )
  •     属性查找 (比如 foo.bar )
  •     方法调用 (比如 foo.bar() )
  •     列表类型索引查找 (比如 foo[bar] )

系统使用找到的第一个有效类型。 这是一种短路逻辑。

句点查找可以多级深度嵌套。 例如在下面这个例子中 {{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.\'