Django的模板层简介
Django的模板层
如果我们想要利用视图函数返回一个页面,一种比较简单的方式是利用HttpResponse()
方法返回一个含有html内容的字符串:
def current_datetime(request):
now = datetime.datetime.now()
html = "<html><body>It is now %s.</body></html>" % now
return HttpResponse(html)
尽管这种方式可以十分方便的解释视图的工作方式,但是,直接将HTML硬编码到你的视图里却并不是一个好主意。原因如下:
1.对页面设计进行的任何改变都必须对 Python 代码进行相应的修改。 站点设计的修改往往比底层 Python 代码的修改要频繁得多,因此如果可以在不进行 Python 代码修改的情况下变更设计,那将会方便得多。
2.Python 代码编写和 HTML 设计是两项不同的工作,大多数专业的网站开发环境都将他们分配给不同的人员(甚至不同部门)来完成。 设计者和HTML/CSS的编码人员不应该被要求去编辑Python的代码来完成他们的工作。
3.程序员编写 Python代码和设计人员制作模板两项工作同时进行的效率是最高的,远胜于让一个人等待另一个人完成对某个既包含 Python又包含 HTML 的文件的编辑工作。
基于上述原因,将页面的设计与Python代码分离开会干净简洁并且更易于维护。
因此,我们需要使用Django的模板系统(Template System)来实现这种设计模式。
Django的模板文件
简单的讲,Django的模板文件其实就是HTML代码
与模板语法
结合而成的一个“组合体”。
这里我们还以“返回当前时间”的需求为例,这次我们用模板文件去做,视图函数中的内容为(这里略去路由部分):
def index(request):
import datetime
n = datetime.datetime.now()
now = n.strftime('%Y-%m-%d %X')
return render(request,'index.html',{'time_now':now})
模板文件index.html文件的内容为:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
<h4>当前时间:{{ time_now }}</h4>
</body>
</html>
这里render()
方法渲染的模板文件是index.html
,而往模板文件传的参数是time_now
这个键对应的key值now
。
模板文件index.html
中除了我们熟悉的html标签以外,多了一个模板语法:{{ time_now }}
。接下来为大家详细介绍下模板的语法。
Django的模板语法
变量
变量
就是在Django模板中遍历复杂数据结构的句点字符,它的语法如下:{{ var_name }}
这里的var_name
与视图函数中返回的render方法的第三个参数(字典)中的'key'值相对应。也就是说,模板文件接收的“参数”都是经过视图函数处理后传来的,而且视图函数可以将任何类型的数据(数字、字符串、列表、字典、对象、类等等)传给模板。
由于本文只讲解模板层的语法,因此下面的内容将路由控制与视图层的函数处理过程省略掉,但是建议大家在理解的时候尽量与路由控制与视图函数联系起来,因为这样有助于体会整个Django项目的“流程”。
变量的深度查询我们用句点符.来完成。比如我们想取列表ls下标为0的元素:{{ ls.0 }}
我们这里深入去研究变量的过滤器。所谓过滤器,其实就是对视图函数传来的值进行“加工”。过滤器的基本语法是:{{ obj|filter_name:param }}
。其中obj
为变量的名字;filter_name
为某一个过滤器的名字;param
是相应过滤器的参数。
各种常见的过滤器列举如下:
(1)date
:如果views.py文件中传给模板的是一个“时间戳”,我们需要对这个时间进行格式化,具体语法是:{{n|date:'Y-m-d'}}
。
(2)default
:如果一个变量是false或者为空,则使用给定的默认值。否则,使用变量的值。例如:{{value|default:'nothing'}}
。
(3)length
:返回值的长度。它对字符串和列表都起作用。例如:{{value|length}}
。
(4)slice
:切片,假如value为一个字符串,找到它下标为2-5切片组成的新字符串:{{value|slice:'2:5'}}
。
(5)truncatechars
:如果字符串字符多于指定的字符数量,那么会被截断。截断的字符串将以可翻译的省略号序列(“...”)结尾。参数是要截断的字符数。这里需要注意,结尾的'...'算三个字符,如果参数<=3,那浏览器上显示的永远是'...':{{value|truncatechars:5}}
。
(6)safe
:Django的模板中会对HTML标签和JS等语法标签进行自动转义,原因显而易见,这样是为了安全。但是有的时候我们可能不希望这些HTML元素被转义,比如我们做一个内容管理系统,后台添加的文章中是经过修饰的,这些修饰可能是通过一个类似于FCKeditor编辑加注了HTML修饰符的文本,如果自动转义的话显示的就是保护HTML标签的源文件。为了在Django中关闭HTML的自动转义有两种方式,如果是一个单独的变量我们可以通过过滤器“|safe”的方式告诉Django这段代码是安全的不必转义。比如views.py文件中的字符串是这样的:value="<a href="">点击</a>"
那index.html中告诉浏览器正常渲染就行,最终得到的是一个a标签:{{value|safe}
。
标签
标签的语法是这种结构: {% tag %}
。标签比变量更加复杂:一些在输出中创建文本,一些通过循环或逻辑来控制流程,一些加载其后的变量将使用到的额外信息到模版中。一些标签需要开始和结束标签,例如:
{% tag %}
...标签内容 ...
{% endtag %}
而标签的深度查询也跟变量一样,利用句点符来进行,这里主要介绍两种常见的标签:for标签
与if标签
。
(1)for标签:它的作用是遍历每一个元素。比如我们想遍历一个字典:
{% for key,value in dic.items %}
<p>{{key}}:{{value}}</p>
{% endfor %}
(1-1)循环期间的编号可以用{{ forloop }}
显示,一下是forloop的说明:
forloop.counter The current iteration of the loop (1-indexed)
forloop.counter0 The current iteration of the loop (0-indexed)
forloop.revcounter The number of iterations from the end of the loop (1-indexed)
forloop.revcounter0 The number of iterations from the end of the loop (0-indexed)
forloop.first True if this is the first time through the loop
forloop.last True if this is the last time through the loop
例如我们想在遍历上面的字典时加上编号:
{% for key,value in dic.items %}
<p>{{forloop.counter0}}:{{key}}:{{value}}</p>
{% endfor %}
(1-2)for...empty
:for标签带有一个可选的{% empty %} 从句,以便在给出的组是空的或者没有被找到时,可以有所操作。
{% for person in person_list %}
<p>{{ person.name }}</p>
{% empty %}
<p>sorry,no person here</p>
{% endfor %}
(2)if标签:{% if %}
会对一个变量求值,如果它的值是“True”(存在、不为空、且不是boolean类型的false值),对应的内容块会输出。
{% if num > 100 or num < 0 %}
<p>无效</p>
{% elif num > 80 and num < 100 %}
<p>优秀</p>
{% else %}
<p>凑活吧</p>
{% endif %}
继承
Django模版引擎中最强大也是最复杂的部分就是模版继承了。模版继承可以让您创建一个基本的“骨架”模版,它包含您站点中的全部元素并且可以定义能够被子模版覆盖的blocks 。
也就是说你,我们可以将重复的“骨架”写到一个base文件中,如果其它的文件都是基于这个骨架来写的,那么我们可以在这个骨架中在需要修改的地方用模板语法“标注”,以便可以让其它文件去替换它。
例如,我们在templates包中加入“骨架”文件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>
我们可以看到它定义了一个可以用于两列排版页面的简单HTML骨架。“子模版”的工作是用它们的内容填充空的blocks。在这个例子中,block标签定义了三个可以被子模版内容填充的block。blocks的作用是告诉模版引擎:子模版可能会覆盖掉模版中的这些位置。
我们将其中的一个字模板命名为base1.html,这里省略路由控制与视图函数中的内容,文件的内容是:
{% extends 'base.html' %}
{% block title %} 哈哈哈哈 {% endblock %}
{% block content %}
<p>{{ list_w }}</p>
{% endblock %}
extends
标签是这里的关键。它告诉模版引擎,这个模版“继承”了另一个模版。当模版系统处理这个模版时:首先,它将定位父模版——在此例中,就是“base.html”;然后,模版引擎将注意到 base.html 中的三个 block 标签,并用子模版中的内容来替换这些block。
根据child1.html文件中的内容,最终的输出看起来是这样的:
<!DOCTYPE html>
<html lang="en">
<head>
<link rel="stylesheet" href="style.css" />
<title>哈哈哈哈</title>
</head>
<body>
<div id="sidebar">
<ul>
<li><a href="/">Home</a></li>
<li><a href="/blog/">Blog</a></li>
</ul>
</div>
<div id="content">
<p> [111,222,333]</p>
</div>
</body>
</html>
这种方式使代码得到最大程度的复用,并且使得添加内容到共享的内容区域更加简单,例如,部分范围内的导航。但是需要注意的是,如果子模版并没有定义 sidebar block,所以系统最终会使用父模版中的值,也就是说,父模版的 {% block %} 标签中的内容总是被用作备选内容(fallback)。
关于继承,还有一下提示需要大家注意:
(1)如果你在模版中使用 {% extends %} 标签,它必须是模版中的第一个标签。其他的任何情况下,模版继承都将无法工作。
(2)在base模版中设置越多的 {% block %} 标签越好。请记住,子模版不必定义全部父模版中的blocks,所以,
你可以在大多数blocks中填充合理的默认内容,然后,只定义你需要的那一个。多一点钩子总比少一点好。
(3)如果你发现你自己在大量的模版中复制内容,那可能意味着你应该把内容移动到父模版中的一个 {% block %} 中。
(4)为了更好的可读性,你也可以给你的{% endblock %} 标签一个 名字 。例如:
{% block content %}
...
{% endblock content %}
在大型模版中,这个方法帮你清楚的看到哪一个{% block %}标签被关闭了。
(5)不能在一个模版中定义多个相同名字的block标签。
Django的模板层简介的更多相关文章
- 04-01 Django之模板层
Django之模板层 一 模板简介 在刚刚介绍完的视图层中我们提到,浏览器发送的请求信息会转发给视图函数进行处理,而视图函数在经过一系列处理后必须要有返回信息给浏览器.如果我们要返回html标签.cs ...
- python 全栈开发,Day69(Django的视图层,Django的模板层)
昨日内容回顾 相关命令: 1 创建项目 django-admin startproject 项目名称 2 创建应用 python manage.py startapp app名称 3 启动项目 pyt ...
- Django框架-模板层
Django框架-模板层 一.模板语法传值 1.验证是否python所有的数据类型都可以传递到前端 locals()的妙用:该方法虽然好用,但是在某些情况下会造成资源的浪费 结论:整型.浮点型.字符串 ...
- Django之模板层细说
django的模板层,基于我们前面学习的内容,也知道主要语法是{{变量相关}}{%逻辑相关%},那么具体还有哪些内容呢?且听我娓娓道来. 模板层(模板语法) 标签 过滤器 自定义标签,过滤器,incl ...
- 5、Django之模板层
一 模板简介 在刚刚介绍完的视图层中我们提到,浏览器发送的请求信息会转发给视图函数进行处理,而视图函数在经过一系列处理后必须要有返回信息给浏览器.如果我们要返回html标签.css等数据给浏览器进行渲 ...
- Django基础模板层(75-76)
Django框架之模板层(d75)一 模版语法之变量: ** locals() 会把*该*视图函数内的变量,传到模板 ** return render(request, 'index.html' ...
- Django的模板层
一 模版简介 你可能已经注意到我们在例子视图中返回文本的方式有点特别. 也就是说,HTML被直接硬编码在 Python代码之中. def current_datetime(request): now ...
- Django的视图层简介
Django的视图层 视图函数 所谓视图函数,其实就是我们Django项目中各个应用中的views.py文件中定义的每个用来处理URL路由映射到这里的逻辑函数.一个视图函数简称视图,它是个简单的Pyt ...
- Django基础——模板层(template) (Day67)
阅读目录 变量 标签 自定义过滤器和标签 模板层(template) 你可能已经注意到我们在例子视图中返回文本的方式有点特别. 也就是说,HTML被直接硬编码在 Python代码之中. 1 2 3 4 ...
随机推荐
- debian 安装使用NTP
编程之路刚刚开始,错误难免,希望大家能够指出. 领导要求,要4台机器时钟同步,上网查了查,主要看了看ptp和ntp,感觉ntp就够用,索性就直接上手ntp了. 以下内容纯属最基础的内容,只适合第一次接 ...
- Can’t call setState (or forceUpdate) on an unmounted component 警告处理方法
Can’t call setState (or forceUpdate) on an unmounted component Warning: Can't call setState (or forc ...
- centos7.3使用花生壳映射端口
首先下载花生壳客户端(其实我觉得更应该叫做服务端),选择相应的版本就可,例如我就是选择的linux->centos版本的 https://hsk.oray.com/download/ 我的版本为 ...
- centos7配置openldap服务器
参考链接 https://www.cnblogs.com/bigbrotherer/p/7251372.html 上面这篇参考文件在最后登录是有问题的 vi /etc/openldap/sldap.c ...
- skipper 内置的常用filters
skipper 的filter 功能很强大,可做好多方便的扩展 格式: all: * -> filter1 -> filter2 -> "http://127.0.0.1: ...
- promise对象的回调函数resolve的参数为另一个promise对象
/*如果调用resolve函数和reject函数时带有参数,那么它们的参数会被传递给回调函数. reject函数的参数通常是Error对象的实例,表示抛出的错误: resolve函数的参数除了正常的值 ...
- node api 之:Error
Node.js 中运行的应用程序一般会遇到以下四类错误: 标准的 JavaScript 错误: <EvalError> : 当调用 eval() 失败时抛出. <SyntaxErro ...
- cvsnt报错:Administrator: Switch to user failed due to configuration error. Contact your System Administrator
在安装CVSNT一开始用Administrator登录时总是报[login aborted]Switch to user failed due to configuration error. Cont ...
- spring-配置事务
使用注解方式配置事务: 一.事物管理 事务是一系列的动作,一旦其中有一个动作出现错误,必须全部回滚,系统将事务中对数据库的所有已完成的操作全部撤消,滚回到事务开始的状态,避免出现由于数据不一致而导致的 ...
- Java通过webservice接口获取天气信息
通过SOAP请求的方式获取天气信息并解析返回的XML文件. 参考: http://www.webxml.com.cn/WebServices/WeatherWS.asmx import java.io ...