Django：模板template（一）

把模板的过程、语法、标签、反向地址解析、过滤器、模板继承与HTML转义记下笔记

1、概述及demo

动态生成HTML

模板的设计实现业务逻辑（View）和显示内容（template）的分离

一个模板可以给多个视图去使用，模板所使用的语法称为DTL（Django Template Language）定义在django.template包

如果要调用模板，则需要如下步骤：

加载模板。通过loader的get_template方法指定一个模板
渲染模板。
1. 　　指定一个上下文对象，RequestContext()
2. 　　用模板的render()方法接收上下文对象。作为HttpResponse()的参数

demo示例的过程：创建工程 - 添加数据库 - 创建应用 - 添加模板路径 - 设置路由 - 编写urls.py - 编辑视图 - 添加模板

添加模板路径：修改settings.py配置，在TEMPLATES中修改DIRS。指定TEMPLATES的目录

TEMPLATES = [

    {

        'BACKEND': 'django.template.backends.django.DjangoTemplates',

        'DIRS': [os.path.join(BASE_DIR, 'templates')],

        'APP_DIRS': True,

        'OPTIONS': {

            'context_processors': [

                'django.template.context_processors.debug',

                'django.template.context_processors.request',

                'django.contrib.auth.context_processors.auth',

                'django.contrib.messages.context_processors.messages',

            ],

        },

    },

添加模板：

booktest/views.py

from django.http import HttpResponse

from django.template import loader, RequestContext

def resp(request):

    t1 = loader.get_template('booktest/resp.html')

    context = RequestContext(request, {"text":"helloworld"})

    return HttpResponse(t1.render(context))

templates/booktest/resp.html

<body>

{{text}}

</body>

实际上上面的代码通过会被封装到一个函数render()中，所以我们一般简写为

from django.shortcuts import render

from django.http import HttpResponse

def resp(request):

    context = {"text":"helloworld"}

    return render(request, "booktest/resp.html", context)

2、模板语法

变量。两个大括号括起来的 {{变量名}}
标签。代码段 {% 代码块 %}
过滤器。就是一个竖线（|）
注释。{# 这里是注释 #}

变量

模板碰到变量的时候，计算这个变量的值，然后将结果输出

变量名有字母、数字、下划线组成。必须以字母或下划线开头

当模板引擎碰到圆点的时候，会按照如下的顺序进行查询：

字典。把圆点前面的内容理解为一个字典，圆点后面的内容理解为键
属性或方法查询。把圆点前面的内容理解为一个对象，圆点后面的内容理解为对象里面的属性或方法（访问方法不能加括号，方法也不能定义参数）
数字索引查询。把圆点前面的内容理解为列表或元组。圆点后面的内容理解为下标（下标只能为数字，不能为字符串）

比如访问{{book.id}}，会按照如下顺序解析：

把book当做字典。访问book[‘id’]，如果book字典中有id的键，则查询成功，并返回，如果没有id的键，或者甚至没有book字典，查询失败，往下
把book当做对象，把id当做属性或方法，尝试访问book.id或book.id()如果book对象中有id的属性或方法，则查询成功，调用并返回，否则往下
把book当做列表或元组，把id当做索引，访问book[id]，如果访问成功，则输出，否则往下
把book.id作为空字符串’’来输出

3、引入模型

在models.py中定义类HeroInfo

booktest/models.py

from django.db import models

# Create your models here.

class BookInfo(models.Model):

    btitle = models.CharField(max_length = 20)

    bpub_date = models.DateTimeField(db_column = 'pub_date')

    bread = models.IntegerField()

    bcomment = models.IntegerField()

    isDelete = models.BooleanField()

    class Meta():

        db_table = 'bookinfo'

class HeroInfo(models.Model):

    hname = models.CharField(max_length = 10)

    hgender = models.BooleanField()

    hcontent = models.CharField(max_length = 1000)

    isDelete = models.BooleanField()

    book = models.ForeignKey('BookInfo', on_delete = models.CASCADE)

    def showname(self):

        return self.hname

生成迁移，数据库中生成bookinfo和booktest_heroinfo的表

>>>python manage.py makemigrations

>>>python manage.py migrate

把book和hero的sql语句插入到数据库中

修改视图类 booktest/views.py

from django.shortcuts import render

from booktest.models import BookInfo, HeroInfo

# Create your views here.

def index(request):

    hero = HeroInfo.objects.get(pk=1)

    context = {'hero': hero}

    return render(request, 'booktest/index.html', context)

模型中，既可以访问属性，也可以访问方法（访问方法不能加括号）

booktest/index.html

<body>

    {{hero.hname}}

    {{hero.showname}}

</body>

4、使用标签

语法：{% 标签 %}。注意标签中写的是代码

作用：

在输出中创建文本
循环或条件判断等逻辑
加载外部信息

for标签

{% for ... in ... %}

{{ forloop.counter }} 表示当前是第几次循环

{% empty %}

列表是空或不存在的时候，执行这里

{% endfor %}

修改views.py booktest/views.py

# Create your views here.

def index(request):

    heroList = HeroInfo.objects.filter(isDelete=False)

    context = {'heroList': heroList}

    return render(request, 'booktest/index.html', context)

模板的代码中添加for标签 templates/booktest/index.html

<ul>

{% for hero in heroList %}

<li>{{ forloop.counter }}: {{hero.showname}}</li>

{% empty %}

<li>找不到</li>

{% endfor %}

</ul>

if标签

{% if ... %}

逻辑1

{% elif ... %}

逻辑2

{% else %}

逻辑3

{% endif %}

比如，想奇数行显示红色，偶数行显示蓝色

<ul>

{% for hero in heroList %}

  {% if forloop.counter|divisibleby:"2" %}

  <li style="color:red">{{ forloop.counter }}: {{hero.showname}}</li>

  {% else %}

  <li style="color:blue">{{ forloop.counter }}: {{hero.showname}}</li>

  {% endif %}

{% empty %}

<li>找不到</li>

{% endfor %}

</ul>

4、反向地址解释

{% url name p1 p2 ... %}

先创建一个页面

路由： booktest/urls.py

urlpatterns = [

    url('^$',views.index), # 路由到views.py中的index()函数

    url('^(\d+)$',views.show),

]

视图： booktest/views.py

urlpatterns = [

    url('^$',views.index), # 路由到views.py中的index()函数

    url('^(\d+)$',views.show),

]

模板：templates/booktest/show.html

<body>

    {{id}}

</body>

接下来考虑在index中，添加一个链接，点击后可以跳转到123。一般是这样写

<a href="/booktest/123">跳转</a>

但是万一路由被改变了

urlpatterns = [

    url(r'^admin/', include(admin.site.urls)),

    url('booktest1/', include('booktest.urls'))

]

此时，链接的地址就发生了改变。如果要随时去修改链接的地址，就有点麻烦了

因此考虑使用地址的反向解释：

正向：在浏览器中输入url后，用该url去匹配规则（URL_PATTERNS）

反向：根据URL规则，生成一个地址

首先，在urls的根中，使用namespace

django4/urls.py

urlpatterns = [

    url(r'^admin/', include(admin.site.urls)),

    url('booktest/', include('booktest.urls', namespace='booktest'))

]

在子urls中，添加name

booktest/urls.py

urlpatterns = [

    url('^$',views.index), # 路由到views.py中的index()函数

    url('^(\d+)$',views.show, name="show"),

]

在模板中使用反向地址解释

{% url name p1 p2 ... %}

其中，这里的name是指namspace:name

<a href="{% url 'booktest:show' 123 %}">跳转</a>

5、过滤器

# 语法：

{{ 变量|过滤器 }}

# 比如：

{{ name|lower  }}

# 表示将变量name的值全部变成小写

# 竖线|可以理解为python中的圆点（.）

# 可以在if标签中，使用过滤器，并结合运算符一起使用

{% if name|length > 2 %}

# 过滤器可以用来串联，构成过滤器链

name | lower | upper

# 过滤器可以传递参数

list | join:”,”

# 设置默认值的过滤器

value | default:”0”

#设置日期

value | date:”YYYY-mm-dd”

常用的django过滤器参考：https://www.cnblogs.com/huangxm/p/6286144.html

6、模板继承

很多网站的头部（页头）、底部（页脚）都是一样的。

把多个页面通用的部分抽取出来，做成父模板。然后在子模板中继承父模板，再实现各自的差异。

7、HTML转义

通过视图往模板输出带html标签的内容的时候

booktest/views.py

def htmlTest(request):

    context = {'text1':'<h2>123</h2>'}

    return render(request, 'booktest/htmlTest.html', context)

对应的模板捕获

templates/booktest/htmlTest.html

<body>

    {{text1}}

</body>

其实这里是做了html的转义。当我们给一段html格式的字符串的时候，到了模板中会自动的转义成特殊字符。最终原封不动的输出

实际上它使用的就是escape过滤器进行自动转义，所以下面两句是一样的效果

{{text1}}

{{text1 | escape }}

当需要按照它指定的格式输出的时候，考虑使用safe过滤器，目的是关闭转义

{{text1 | safe }}

如果有一整块代码都需要转义，考虑使用autoescape，并通过设置on打开转义，设置off关闭转义

{% autoescape off %}

    {{text1}}

{% endautoescape %}

如果是在模板代码中直接写html字符串

{{ text2 | default:'<h2>456</h2>' }}

则直接输出456，不需要转义