Django 模板使用

模板简介

模板就是一个文件，格式可以是：HTML,XML,CSV,etc

一个模板包好变量（在模板求值时用值替换）和标记（模板加载时的逻辑控制）

{% extends "base_generic.html" %}  # 母版

{% block title %}{{ section.title }}{% endblock %}  # 块标记，重载母版的此模块内容

{% block content %}
<h1>{{ section.title }}</h1>

{% for story in story_list %}
<h2>
  <a href="{{ story.get_absolute_url }}">  # 变量
    {{ story.headline|upper }}
  </a>
</h2>
<p>{{ story.tease|truncatewords:"100" }}</p>  # 标记，截断字符串
{% endfor %}
{% endblock %}

模板渲染

模板变量

变量表现为{{ variable }}，在加载时它将替换成对应值。

变量名由字母数字字符和下划线(“_”)的任何组合组成，但不能以下划线开头。点(".")也出现在变量部分，尽管它有一个特殊的含义，如下所示。重要的是，变量名中不能有空格或标点字符。

点(".")查找顺序

字典(dictionary)查找
属性(attribute)或者方法(method)查找
索引查找

注：只有没有参数的简单方法才能在模板中调用

例子:

{% for k, v in defaultdict.items %}
Do something with k and v here...
{% endfor %}

过滤器

在模板中可以使用过滤器进行逻辑惭怍

注释

在模板中使用{# #}进行注释

{# greeting #}hello

模板继承

Django模板引擎中最强大的部分(因此也是最复杂的部分)是模板继承。模板继承允许您构建一个基本的“骨架”模板，该模板包含站点的所有公共元素，并定义子模板可以覆盖的block。

the base.html

<!DOCTYPE html>
<html lang="en">
<head>
    <link rel="stylesheet" href="style.css">
    <title>{% block title %}My amazing site{% endblock %}</title>
</head>

<body>
    <div id="sidebar">
        {% block sidebar %}
        <ul>
            <li><a href="/">Home</a></li>
            <li><a href="/blog/">Blog</a></li>
        </ul>
        {% endblock %}
    </div>

    <div id="content">
        {% block content %}{% endblock %}
    </div>
</body>
</html>

the children html

{% extends "base.html" %}  # 加载母版

{% block title %}My amazing blog{% endblock %}  # 重载母版	
{% block content %}  # 重载母版
{% for entry in blog_entries %}
    <h2>{{ entry.title }}</h2>
    <p>{{ entry.body }}</p>
{% endfor %}
{% endblock %}

说明：

extends标签告诉当前模板是由其他模板继承而来。当模板进行求值时，首先加载这个父模板(base.html)。
如果子模板没有重载父模板中的{% block %}标签，父模板中的内容将被加载到当前内容里。

模板继承实现了代码重用，并更易维护。

模板继承使用技巧

如果在模板中使用{% extends %}，那么它必须是该模板中的第一个模板标记。否则，模板继承将无法工作。
基础模板中有更多的{% block %}标记更好。记住，子模板不必定义所有的父模块，因此您可以在一些模块中填写合理的默认值，然后只定义您稍后需要的。挂钩越多越好。
如果您发现自己在多个模板中复制了内容，这可能意味着您应该将该内容移动到父模板中的{% block %}。
如果需要从父模板({{block)中获取块的{{block.super}}变量可以做到这一点。如果您想要添加到父块的内容而不是完全覆盖它，那么这是非常有用的。使用{{block.super}}不会自动转义(请参阅下一节)，因为如果需要，它已经在父模板中转义了。
使用模板标记在{% block %}之外创建的变量不能在块内使用。

注：模板的 block可以命名，但是不可以在同一模板中定义相同名字的 block。

其他知识点

自动转义

为防止可能存在在xxs攻击，模板会将html和javascript标签自动转义。

如果可以确定内容是安全的，并且需要正确显示它，可以使用safe过滤器

This will be escaped: {{ data }}
This will not be escaped: {{ data|safe }}

对于一整个块想取消转义，可以使用autoescape标签

{% autoescape off %}
    Hello {{ name }}
{% endautoescape %}

autoescape标签可以嵌套，来控制哪些内容需要转义，哪些内容不需要转义

Auto-escaping is on by default. Hello {{ name }}

{% autoescape off %}
    This will not be auto-escaped: {{ data }}.

    Nor this: {{ other_data }}
    {% autoescape on %}
        Auto-escaping applies again: {{ name }}
    {% endautoescape %}
{% endautoescape %}

注：autoescape将传递效果给extend和include标签。

default后的内容不会被转义，应该手动写成转义字符替代原内容

{{ data|default:"3 &lt; 2" }}

{{ data|default:"3 < 2" }}  {# Bad! Don't do this. #}

调用方法

方法必须的无参数方法

{{ task.comment_set.all.count }}  # 调用时不加()

自定义标签和过滤器

需要注册app到settings.py的INSTALLED_APPS中

并且将用自定义标签和过滤器加载到调用的模板中 {% load mytags %}