Django 系列博客(八)
django 系列博客(八)
前言
本篇博客介绍 django 中的模板层,模板都是django 使用相关函数渲染后传输给前端在显式的,为了想要渲染出我们想要的数据,需要学习模板语法,相关过滤器、标签。
模板简介
你可能注意到下面的例子返回文本的方式有点特别。当我们使用相关函数来渲染模板的时候,首先是打开了模板文件,然后将需要传入的参数填到文件中在返回给前端。
def current_datetime(request): now = datetime.datetime.now() html = '<html><body>it is now %s.</body></html>' % now return httpresponse(html)
尽管这很能直观的解释视图层的工作方式,但直接将 html 硬编码到你的视图里却不是个好主意。
- 对页面设计进行的任何改变都必须对
python
代码进行相应的更改。站点设计的修改往往比底层python
代码的修改要频繁的多,因此如何可以在不进行python
代码修改的情况下变更设计,那将会方便的多。 -
python
代码编写和html
设计是两项不同的工作,大多数专业的网站开发环境都会分配不同的部分或者开发人员来完成。设计者和html/css
的编码人员不应该被要求去编辑python
的代码来完成他们的工作。 - 程序员编写
python
代码和设计人员制作模板两项工作同时进行的效率是最高的,远胜于让一个人等待另一个人完成对某个既包含python
又包含html
的文件的编辑工作。
基于上述这些原因,将页面的设计和 python 的代码分离开来会更干净简洁更易维护。可以使用 django 的模板系统(templates system)来实现这种模式。
def current_time(req): import datetime now = datetime.datetime.now() html = '<html><body>it is now %s.</body></html>' % now # django模板修改的视图函数 from django.template import template, context now = datetime.datetime.now() t = '<html><body>it is now %s.</body></html>' % now c = context({'current_date': str(now)}) html = t.render(c) return httpresponse(html) # 另一种写法 import datetime now = datetime.datetime.now() return render(req, 'current_datetime.html', {'current_date': str(now)[:19]})
模板语法终点:
- 变量:{{ 变量名 }}
- 深度查询,用点语法
- 过滤器
- 标签:{{ % % }}
模板语法变量
在 django 模板中遍历复杂数据结构的关键是点语法
views.py
def template_test(request): name = 'lqz' li = ['lqz', 1, '18'] dic = {'name': 'lqz', 'age': 18} ll2 = [ {'name': 'lqz', 'age': 18}, {'name': 'lqz2', 'age': 19}, {'name': 'egon', 'age': 20}, {'name': 'kevin', 'age': 23} ] ll3=[] class person: def __init__(self, name): self.name = name def test(self): print('test函数') return 11 @classmethod def test_classmethod(cls): print('类方法') return '类方法' @staticmethod def static_method(): print('静态方法') return '静态方法' lqz = person('lqz') egon = person('egon') person_list = [lqz, egon] bo = true te = test() import datetime now=datetime.datetime.now() link1='<a href="https://www.baidu.com">点我<a>' from django.utils import safestring link=safestring.mark_safe(link1) # html特殊符号对照表(http://tool.chinaz.com/tools/htmlchar.aspx) # 这样传到前台不会变成特殊字符,因为django给处理了 dot='♠' # return render(request, 'template_index.html', {'name':name,'person_list':person_list}) return render(request, 'template_index.html', locals())
html文件
<p>{{ name }}</p> <p>{{ li }}</p> <p>{{ dic }}</p> <p>{{ lqz }}</p> <p>{{ person_list }}</p> <p>{{ bo }}</p> <p>{{ te }}</p> <hr> <h3>深度查询句点符</h3> <p>{{ li.1 }}</p> <p>{{ dic.name }}</p> <p>{{ lqz.test }}</p> <p>{{ lqz.name }}</p> <p>{{ person_list.0 }}</p> <p>{{ person_list.1.name }}</p> <hr> <h3>过滤器</h3> {#注意:冒号后面不能加空格#} <p>{{ now | date:"y-m-d h:i:s" }}</p> {#如果变量为空,设置默认值,空数据,none,变量不存在,都适用#} <p>{{ name |default:'数据为空' }}</p> {#计算长度,只有一个参数#} <p>{{ person_list |length }}</p> {#计算文件大小#} <p>{{ 1024 |filesizeformat }}</p> {#字符串切片,前闭后开,前面取到,后面取不到#} <p>{{ 'hello world lqz' |slice:"2:-1" }}</p> <p>{{ 'hello world lqz' |slice:"2:5" }}</p> {#截断字符,至少三个起步,因为会有三个省略号(传负数,1,2,3都是三个省略号)#} <p>{{ '刘清政 world lqz' |truncatechars:"4" }}</p> {#截断文字,以空格做区分,这个不算省略号#} <p>{{ '刘清政 是 大帅比 谢谢' |truncatewords:"1" }}</p> <p>{{ link1 }}</p> <p>{{ link1|safe }}</p> <p>{{ link }}</p> <p>♠</p> <p>{{ dot }}</p> {#add 可以加负数,传数字字符串都可以#} <p>{{ "10"|add:"-2" }}</p> <p>{{ li.1|add:"-2" }}</p> <p>{{ li.1|add:2 }}</p> <p>{{ li.1|add:"2" }}</p> <p>{{ li.1|add:"-2e" }}</p> {#upper#} <p>{{ name|upper }}</p> <p>{{ 'lqz'|lower }}</p> <hr> <h3>模版语法之标签</h3> {#for 循环 循环列表,循环字典,循环列表对象#} <ui> {% for foo in dic %} {{ foo }} {% endfor %} {#也可以混用html标签#} {% for foo in li %} <ul>foo</ul> {% endfor %} </ui> {#表格#} <table border="1"> {% for foo in ll2 %} <tr> <td>{{ foo.name }}</td> <td>{{ foo.age }}</td> </tr> {% endfor %} </table> <table border="1"> {#'parentloop': {}, 'counter0': 0, 'counter': 1, 'revcounter': 4, 'revcounter0': 3, 'first': true, 'last': false}#} {% for foo in ll2 %} <tr> <td>{{ forloop.counter }}</td> <td>{{ foo.name }}</td> <td>{{ foo.age }}</td> </tr> {% endfor %} </table> {% for foo in ll5 %} <p>foo.name</p> {% empty %} <p>空的</p> {% endfor %} <hr> <h3>if判断</h3> {% if name %} <a href="">hi {{ name }}</a> <a href="">注销</a> {% else %} <a href="">请登录</a> <a href="">注册</a> {% endif %} {#还有elif#} <hr> <h3>with</h3> {% with ll2.0.name as n %} {{ n }} {% endwith %} {{ n }} {% load my_tag_filter %} {{ 3|multi_filter:3 }} {#传参必须用空格区分#} {% multi_tag 3 9 10 %} {#可以跟if连用#} {% if 3|multi_filter:3 > 9 %} <p>大于</p> {% else %} <p>小于</p> {% endif %}
注意:点语法也可以用来引用对象的方法(无参数方法)
<h4>字典:{{ dic.name.upper }}</h4>
模板之过滤器
语法:
{{obj|filter__name:param}} 变量名字|过滤器名称:变量
default
如果一个变量是 false 或者为空,使用给定的默认值。否则使用变量的值。
{{ value|default:"nothing" }}
length
返回值得长度。它对字符串和列表都有效。
{{ value|length }}
如果value
是['a', 'b', 'c', 'd']
,那么输出是4。
filesizeformat
将值格式化为一个‘’人类可读的文件尺寸‘’('13kb', '4.1mb'等)。
{{ value|filesizeformat }}
如果 value
是 123456789,输出将会是 117.7 mb
。
date
输出格式化时间
{{ value|date:"y-m-d" }}
如果value=datetime.datetime.now()
,那么结果会是2019-01-10
。
slice
该方法只能传入一个参数,通常使用引号包裹。
{{ file_size|filesizeformat }}
如果后台的 file_size
为1024,那么结果会是1kb
。
truncatechars
如果字符串字符多于指定的字符数量,那么会被阶段。截断的字符串将以可翻译的省略号序列('...')
结束。
参数:要截断的字符数
{{ value|truncatechars:9 }}
safe
django的模板中会对html标签和js等语法标签进行自动转义,原因显而易见,这样是为了安全。但是有的时候我们可能不希望这些html元素被转义,比如我们做一个内容管理系统,后台添加的文章中是经过修饰的,这些修饰可能是通过一个类似于fckeditor编辑加注了html修饰符的文本,如果自动转义的话显示的就是保护html标签的源文件。为了在django中关闭html的自动转义有两种方式,如果是一个单独的变量我们可以通过过滤器“|safe”的方式告诉django这段代码是安全的不必转义。比如:
value="<a href="">点击</a>" # 不希望转义的链接
{{ value|safe}} # 添加 safe 过滤器就可以不转义了
其他过滤器
过滤器 | 描述 | 示例 |
---|---|---|
upper | 以大写方式输出 | user.name |
add | 给value加上一个数值 | user.age |
addslashes | 单引号加上转义号 | |
capfirst | 第一个字母大写 | 'good'|capfirst,返回 good |
center | 输出指定长度的字符串,把变量居中 | 'abcd'|center:'50' |
cut | 删除指定字符串 | 'you are not a english'|cut:'not' |
date | 格式化日期 | |
default | 如果值不存在,则使用默认值代替 | valut|default:'(n/a)' |
default_if_none | 如果值为none, 则使用默认值代替 | |
dicsort | 按某字段排序,变量必须是一个dictionary | for moment in moments |dictsort:'id'(百分号加大括号) |
dictsortreversed | 按某字段倒序排序,变量必须是dictionary | |
divisibleby | 判断是否可以被数字整除 | 224 | divisibleby:2 返回true |
escape | 按html转义,比如将”<”转换为”<” | |
filesizeformat | 增加数字的可读性,转换结果为13kb,89mb,3bytes等 | 1024 | filesizeformat 返回1.0kb |
first | 返回列表的第1个元素,变量必须是一个列表 | |
floatformat | 转换为指定精度的小数,默认保留1位小数 | 3.1415926|floatformat:3 返回3.142四舍五入 |
get_digit | 从个位数开始截取指定位置的数字 | 12345|get_digit:'1' |
join | 用指定分隔符连接列表 | ['abc','45']|join:'* 返回 abc*45' |
length | 返回列表中元素的个数或字符串长度 | |
length_is | 检查列表,字符串长度是否符合指定的值 | hello|length_is:'3' |
linebreaks | 用 或 |
'hi\n\ndavid'|linebreaks,返回 hi david |
linebreaksbr | 用 标签代替换行符 |
|
linenumbers | 为变量中的每一行加上行号 | |
ljust | 输出指定长度的字符串,变量左对齐 | 'ab'|ljust:5 返回'ab ' |
lower | 字符串变小写 | |
make_list | 将字符串转换为列表 | |
pluralize | 根据数字确定是否输出英文复数符号 | |
random | 返回列表的随机一项 | |
removetags | 删除字符串中指定的html标记 | value|removetags:'h1 h2' |
rjust | 输出指定长度的字符串,变量右对齐 | |
slice | 切片操作, 返回列表 | [3,9,1]|slice:':2',返回[3,9], 'asdikfjhihgie'|slice:'5',返回'asdik' |
slugify | 在字符串中留下减号和下划线,其它符号删除,空格用减号替换 | '5-2=3and5 2=3'|slugify,返回5-2 3and5-23 |
stringformat | 字符串格式化,语法同python | |
time | 返回日期的时间部分 | |
timesince | 以“到现在为止过了多长时间”显示时间变量 | 结果可能为45days,3hours |
timeuntil | 以“从现在开始到时间变量”还有多长时间显示时间变量 | |
title | 每个单词首字母大写 | |
truncatewords | 将字符串转换为省略表达方式 | 'this is a pen'|truncatewords:2 返回'this is ...' |
truncatewords_html | 同上,但保留其中的html标签 | ' this is a pen '|truncatewords:2,返回this is ... |
urlencode | 将字符串中的特殊字符转换为url兼容表达方式 | 'http://www.aaa.com/foo?a=b&b=c'|urlencode |
urlize | 将变量字符串中的url由纯文本变为链接 | |
wordcount | 返回变量字符串中的单词数 | |
yesno | 将布尔变量转换为字符串yes, no 或maybe | true|yesno,false|yesno,none|yesno,返回 yes,no,maybe |
模板之标签
标签看起来像是这样的:{% tag %}。标签比变量更加复杂:一些在输出中创建文本,一些通过循环或逻辑来控制流程,一些加载其后的变量将使用到的额外信息到模板中。一些标签需要开始和结束标签(例如{% tag %}...标签 内容... {% endtag %})。
for 标签
遍历每一个元素:
{% for person in person_list %} <p>{{ person.name }}</p> {% endfor %}
可以利用{% for obj in list reversed %}
反向完成循环。
遍历一个字典:
{% for key,val in dic.items %} <p>{{ key }}:{{ val }}</p> {% endfor %}
注:循环序号可以通过``{{ forloop }}显示
forloop.counter the current iteration of the loop (1-indexed) 当前循环的索引值(从1开始) forloop.counter0 the current iteration of the loop (0-indexed) 当前循环的索引值(从0开始) forloop.revcounter the number of iterations from the end of the loop (1-indexed) 当前循环的倒序索引值(从1开始) forloop.revcounter0 the number of iterations from the end of the loop (0-indexed) 当前循环的倒序索引值(从0开始) forloop.first true if this is the first time through the loop 当前循环是不是第一次循环(布尔值) forloop.last true if this is the last time through the loop 当前循环是不是最后一次循环(布尔值) forloop.parentloop 本层循环的外层循环
for...empty
for
标签带有一个可选的{% empty %}
从句,以便在给出的组是空的或者没有被找到时,可以有所操作。
{% for person in person_list %} <p>{{ person.name }}</p> {% empty %} <p>sorry,no person here</p> {% endfor %}
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 %}
if语句支持:and、or、==、>、<、!=、<=、>=、in、not in、is、is not判断。
with
使用一个简单地名字缓存一个复杂的变量,当你需要使用一个“昂贵的”方法(比如访问数据库)很多次的时候是非常有用的
例如:
{% with total=business.employees.count %} {{ total }} employee{{ total|pluralize }} {% endwith %} 不要写成as
cerf_token
{% csrf_token%}
这个标签用于跨站请求伪造保护
自定义标签和过滤器
在settings中的installed_apps配置当前app,不然django无法找到自定义的simple_tag.
在app中创建templatetags模块(模块名只能是templatetags)
创建任意 .py 文件,如:my_tags.py
from django import template from django.utils.safestring import mark_safe register = template.library() #register的名字是固定的,不可改变 @register.filter def filter_multi(v1,v2): return v1 * v2 <br> @register.simple_tag def simple_tag_multi(v1,v2): return v1 * v2 <br> @register.simple_tag def my_input(id,arg): result = "<input type='text' id='%s' class='%s' />" %(id,arg,) return mark_safe(result)
- 使用自定义 simple_tag和 fileter 的 html 文件中导入之前创建的 my_tags.py
{% load my_tags %}
- 使用simple_tag和filter(如何调用)
{% load xxx %} # num=12 {{ num|filter_multi:2 }} #24 {{ num|filter_multi:"[22,333,4444]" }} {% simple_tag_multi 2 5 %} 参数不限,但不能放在if for语句中 {% simple_tag_multi num 5 %}
注意:filter 可以用在 if 等语句后,simple_tag不可以
{% if num|filter_multi:30 > 100 %} {{ num|filter_multi:30 }} {% endif %}
推荐阅读
-
[狐狸谈网站系列八]爱什么也别爱站长
-
发布才2年半!Intel 14nm八代酷睿U系列全部退役
-
Flutter 即学即用系列博客——04 Flutter UI 初窥
-
Python使用Django实现博客系统完整版
-
spring cloud 入门系列八:使用spring cloud sleuth整合zipkin进行服务链路追踪
-
sql server 备份与恢复系列八 系统数据库备份与恢复分析
-
Flutter 即学即用系列博客——01 环境搭建
-
SLAM+语音机器人DIY系列:(八)高阶拓展——2.centos7下部署Django(nginx+uwsgi+django+python3)
-
【Linux系列】Centos7安装Samba并将工作区挂载到win(八)
-
Express全系列教程之(八):session的基本使用