Django2.0——模板渲染(一)
在前面的介绍中我们都是用简单的 django.http.HttpResponse来把内容显示到网页上,本节将讲解如何使用渲染模板的方法来显示内容,即调用精美的HTML页面。模板的创建既可以在项目下创建一个templates目录来存放模板,也可以在app应用中新建一个templates文件夹来存放各个模板。
模板配置
要注意的是不管是以哪种方式创建,都要记得在settings中进行配置,不然在调用视图函数时是找不到你指定的是哪个模板。如果是在项目下创建的模板目录,则在settings中的TEMPLATES中的DIRS进行配置,输入创建模板的路径。如果是在app应用中创建的模板,把 app名 加入到 settings.INSTALLED_APPS中。
项目下的templates配置
app下的templates的配置
模板渲染
模板渲染利用的是django.shortcuts.render方法,放在视图函数的return语句中。render方法的第一个参数是request关键字,第二个参数是模板的路径,第三个可选参数是context,以字典的格式作为参数传递给模板,模板可以通过模板变量来接收,模板变量在下面会介绍。
注意:我们一般将模板放在app下的templates中,Django会自动去这个文件夹中找。但 假如我们每个app的templates中都有一个 index.html,当我们在views.py中使用的时候,直接写一个 render(request, 'index.html'),Django 能不能找到当前 app 的 templates 文件夹中的 index.html 文件夹呢?(答案是不一定能,有可能找错)下面介绍下模板的查找机制是怎样的。
Django 模板查找机制: Django 查找模板的过程是在每个 app 的 templates 文件夹中找(而不只是当前 app 中的代码只在当前的 app 的 templates 文件夹中找)。各个 app 的 templates 形成一个文件夹列表,Django 遍历这个列表,一个个文件夹进行查找,当在某一个文件夹找到的时候就停止,所有的都遍历完了还找不到指定的模板的时候就是 Template Not Found (过程类似于Python找包)。这样设计有利当然也有弊,有利是的地方是一个app可以用另一个app的模板文件,弊是有可能会找错了。所以我们使用的时候在 templates 中建立一个 app 同名的文件夹,这样就好了。即在每个app中的 templates 文件夹中再建一个 app 的名称,仅和该app相关的模板放app/templates/app/ 目录下面。
下面在music这个app中实现模板的渲染,首先在music下创建一个目录templates及其子目录music来存放一个模板index.html,再在settings文件中进行配置,再在视图文件中写一个视图函数利用render方法来调用这个模板。
模板变量
模板变量用来接收视图函数传来的值,传来的是一个字典格式。字典中的key在模板中充当变量名,value可以是字典、模型、函数、列表、类方法等。在模板中,变量加点有着特殊的含义,其表示查找。故若传来value是一个字典或列表,可以通过变量.key或变量.下标来取特定的值。
模板变量的语法规则: {{ 变量名 }} 。
下面举一个小例子,传递一个列表和一个字典,然后再模板中分别取一个展示。
模板过滤器
作用: 对变量进行过滤。在真正渲染出来之前,过滤器会根据功能处理好变量,然后得出结果后再替换掉原来的变量展示出来。
语法规则:{{ 变量名|过滤器:参数 }} ,变量名与过滤器通过管道符|分隔开,过滤器的参数与过滤器通过冒号分隔。
下图是一些常用过滤器的总结。
注意:default无论是真的None还是空字符,都会返回一个False,而default_if_none在变量真的为None时才会返回False,然后使用提供的默认值。
date和time的格式化字符如下图所示:
下面的小例子是时间的过滤
floatformat过滤器用于过滤浮点型数据,默认保留一位小数,也可以指定保留小数的个数。
safe过滤器用于关闭变量的自动转义,变量的自动转义就是将<、>、&、空格等转为前端的特殊字符。