Django template

1. template是基于文本格式的文件(html文件也是文本格式),包含如下一些关键字:
   • variables:当template被evaluated时，variable会被替换成相应的值，variable在模板中的格式:{{variable}},如果variable不存在，模板会使用TEMPLATE_STRING_IF_INVALID设置的值替换变量，默认是‘’.template中方法调用也是变量的一种,如{{blog.entry_set.all.count}},注意方法做变量时没办法传递参数，所以只能是无参方法作变量
   • filters:用于修改variable,‘|’称为管道符,对变量应用filter，如{{name|low}},其中low就是一个filter,filter还可以有参数，也可以自定义filter。django中大概有三十种filter,常用的有:
     • default:如果变量是false或者空，使用default值替换variable,{{value|default:”nothing”}},default的值默认不转义
     • length:获取变量的长度,{{value|length}}
     • striptags:除去html标签,{{value|striptags}}:value中含有标签时，标签会被删除只返回value的剩余部分
     • escape:转义字符串中的html标签
     • safe:使变量输出不会进行html转义，如果设置了自动转义关闭，这个filter就会失效
   • comments:用于模板中注释,格式{##},注释中也可包含代码，{# {%if foo%}bar{%else%} #}，模板evaluated时会正常执行
   • tags:控制template的逻辑,格式{% tag %},部分tag还要有{% endtag %},django自带大约二十多个tag,常用的如下:
     • for:用于数组循环

       <ul>
       {% for athlete in athlete_list %}
           <li>{{ athlete.name }}</li>
       {% endfor %}
       </ul>

     • if,elif,和else:

       {% if athlete_list %}
           Number of athletes: {{ athlete_list|length }}
       {% elif athlete_in_locker_room_list %}
           Athletes should be out of the locker room soon!
       {% else %}
           No athletes.
       {% endif %}

     • block和extends:模板继承时使用，block表示可以在子模板中改写的块,同一模板中的block名字不能相同，extends表示用于继承父模板
2. 模板继承:
   • 继承模板使用{% extends %}，并且它必须是子模板中第一个tag
   • 推荐在base template中多使用{% block %}
   • 如果多个模板中有重复内容，则考虑将内容移到base template中的{% block %}下
   • 如果要在子模板的{%block%}中访问父模板的block内容可以使用{{block.super}}
3. Django模板中默认开启了对用于输出的变量的html转义,如果要关闭转义功能，可以在变量，模板，site三个级别设置关闭

   #关闭变量转义
   This will not be escaped: {{ data|safe }}
   #关闭template转义,继承自该模板的子模板也会关闭
   {% autoescape off %}
       Hello {{ name }}
   {% endautoescape %}

4. Context 类:传递给模板，作用是替换模板中的变量。Context对象是个stack,所以包含push和pop方法,构造函数中可以包含两个参数:
   • 一个字典型，用于映射变量名和变量值
   • 当前application的名字，当url有命名空间时有用

     >>> c = Context()
     >>> c['foo'] = 'first level'
     >>> c.push()
     {}
     >>> c['foo'] = 'second level'
     >>> c['foo']
     'second level'
     >>> c.pop()
     {'foo': 'second level'}
     >>> c['foo']
     'first level'
     >>> c['foo'] = 'overwritten'
     >>> c['foo']
     'overwritten'
     >>> c.pop()
     Traceback (most recent call last):
     ...
     ContextPopException

5. RequestContext:Context的子类，其与Context有两个不同:
• 第一个参数是HttpRequest对象
• 会调用TEMPLATE_CONTEXT_PROCESSOR中的processor依次往RequestContext中加入一些预定义变量，自己也可以定义额外的processor再添加其他内容到RequestContext中

  from django.http import HttpResponse
  from django.template import RequestContext
  
  def ip_address_processor(request):
      return {'ip_address': request.META['REMOTE_ADDR']}
  
  def some_view(request):
      # ...
      c = RequestContext(request, {
          'foo': 'bar',
      }, [ip_address_processor])
      return HttpResponse(t.render(c))

6. 使用模板通常有两个步骤:
   • compile模板存到一个对象中.模板只编译一次
   • 调用模板对象的render方法，参数是context
     

      from django.template import Context, Template
      t = Template("My name is {{ my_name }}.")
     c = Context({"my_name": "Adrian"})
      t.render(c)
     "My name is Adrian."
     c = Context({"my_name": "Dolores"})
      t.render(c)
     "My name is Dolores."

7. variable lookup:变量名中可以包含点，当点出现时，以{{foo.bar}}为例它的解析顺序为:
   • dictionary lookup,如foo[“bar”]
   • attribute lookup,如foo.bar
   • list-index lookup,如foo[bar]
   • method lookup
     

     t = Template("My name is {{ person.first_name }}.")
     d = {"person": {"first_name": "Joe", "last_name": "Johnson"}}
     t.render(Context(d))
     "My name is Joe."
     
     class PersonClass: pass
     p = PersonClass()
     p.first_name = "Ron"
     p.last_name = "Nasty"
     t.render(Context({"person": p}))
     "My name is Ron."
     
     t = Template("The first stooge in the list is {{ stooges.0 }}.")
     c = Context({"stooges": ["Larry", "Curly", "Moe"]})
     t.render(c)
     "The first stooge in the list is Larry."

8. method lookup时，注意以下几点:
   • 调用方法抛出异常时，如果异常类型设置了”静态属性”silent_variable_failure=true，则变量会被替换为空，否则会替换为异常信息
   • 如果方法含有参数，则变量会被替换为空
   • 在模板中调用某些方法会产生负面影响如model.delete().为了防止这种情况可以设置alters_data=true.这样方法不会被调用，而是用TEMPLATE_STRING_IF_INVALID替换变量的值。model.delete方法的alters_data默认为true