Django自带的模板系统虽然比不上专业的类似jinjia2那么自由的模板系统,但是对于我们新手来说也是够用了,由于Django是一个强大且全面的大型Web框架,该有的都已经内置了,功能上不尽完美也有替代的方案,所以以后有机会再和大家说说如何替换默认自带模板系统。
今天我们来聊一聊Django模板系统使用的方法,我尽量全面且系统的介绍使用方法,如果有遗漏或欠缺的地方,麻烦指正。
1.语句语法的使用
- 变量或常量引用:{{ 变量或常量 }}
- 基础的语法使用:{% 语法 %}
- 变量或常量别名:{% 旧名称 as 新名称 %}
- 注释的简单用法:{# 注释内容 #}
1.1 静态文件引用:
{% load staticfiles %}
{% static "文件路径" %}
1.2 相对地址引用:
{% url '应用名称:url.py内定义的名字' %}
注意:名称后面可跟着参数,传值方式为位置传参(value1,value2)和关键词传参(value="1")。
1.3 变量或常量传递:
例如:我想根据网页内容的不同显示不同的标题。
做法:
# views.py
# -*- coding: utf-8 -*-
from django.shortcuts import render
def index(request):
title = "标题1"
return render(request, 'index.html', {'title ': title })
使用:
{{title}}
我的第一个HTML页面
我的第一个段落。
而如果是字典呢?
# views.py
# -*- coding: utf-8 -*-
from django.shortcuts import render
def index(request):
test_dict = {'name': '测试字典类型', 'content': '简单示例'}
return render(request, 'index.html', {'test_dict': test_dict})
使用(在模板中取字典的键是用 **. **(例如:test_dict.name),而不是我们认为的Python中的 test_dict['name']):
网站标题
{{ test_dict.name }}
{{ test_dict.content}}
特别注意:所有用到上下文传递的数据只能是字典类型,模板系统并不支持下标索引。
1.4 自定义模板标签:
说明:本段参考《 追梦人物:10 - 页面侧边栏:使用自定义模板标签 》
有时候我们需要使用一些公共的数据,而如果每次都在视图内写获取函数,那会导致我们写很多重复代码,所以Django为我们提供了自定义模板标签。
简单示例:
首先在我们的项目应用下创建一个 templatetags 文件夹。然后在这个文件夹下创建一个** __init__.py**文件,使这个文件夹成为一个 Python 包,之后在 templatetags\ 目录下创建一个 get_data.py 文件,这个文件存放自定义的模板标签代码。
# get_data.py
from django import template
register = template.Library()
@register.simple_tag
def get_data_age():
age = 10
return age
使用:
网站标题
{% load get_data %}
{% get_data_age as age%}
我的第一个HTML页面
我的年纪{{ age }}
说明:这里我们首先导入 template 这个模块,然后实例化了一个 template.Library 类,并将函数 get_recent_posts 装饰为 register.simple_tag。这样就可以在模板中使用语法 {% get_data_age %} 调用这个函数了。
注意: Django 1.9 后才支持 simple_tag 模板标签,如果你使用的 Django 版本小于 1.9,你将得到一个错误。
2.通用模板的使用
很多网站的网页会存在公共部分(即相同标签内容,比如导航,底部等),所以Django将这部分内容做成block,减轻我们的工作量。
2.1 简单使用方法:
首先在你的其他html文件同级目录下新建一个html文件,名称自定义,最好与公用部分含义一致,例如:test.html,下面我以这个名称做示例。
完整的HTML页面比如是这样的:
网站标题
我的第一个HTML页面
我的第一个段落。
我们把公共部分抽离出来,不同页面不同部分做成block:
提示:其中name为自定义名称。
网站标题
{% block name %}
{% endblock name %}
然后我们就可以修改index.html的内容:
{% extends 'test.html' %}
{% block name %}
{% endblock name %}
注意:“ Django 模板查找机制: Django 查找模板的过程是在每个 的 **templates **文件夹中找(而不只是当前应用 中的代码只在当前的应用的 templates 文件夹中找)。各个应用的 templates 形成一个文件夹列表,Django 遍历这个列表,一个个文件夹进行查找,当在某一个文件夹找到的时候就停止,所有的都遍历完了还找不到指定的模板的时候就是 Template Not Found (过程类似于Python找包)。这样设计有利当然也有弊,有利是的地方是一个应用可以用另一个应用的模板文件,弊是有可能会找错了。所以我们使用的时候在 templates 中建立一个 应用同名的文件夹,这样就好了。” -- 来自 《自强学堂-Django基础教程》
还有一个全内容引用:
{% include 'test1.html' %} :代表导入test1.html内所有内容到指定位置(可重复使用)。
3.逻辑控制的语法
3.1 if else 条件判断:
注意:这里的if语句并没有elif。
{% if 真/假 %}
执行语句一
{% else %}
否则执行语句二
{% endif%}
3.2 for in 循环遍历:
{% for 值 in 可迭代对象 %}
执行语句一
{% empty %}
值为空时执行的语句
{% endfor%}
3.2.1 for in 循环内的控制变量
- forloop.counter 索引从 1 开始算
- forloop.counter0 索引从 0 开始算
- forloop.revcounter 索引从最大长度到 1
- forloop.revcounter0 索引从最大长度到 0
- forloop.first 当遍历的元素为第一项时为真
- forloop.last 当遍历的元素为最后一项时为真
- forloop.parentloop 获取上一层 for 循环的 forloop
例如:
{% for item in items%}
{{ item }}{% if not forloop.last %}如果此次循环item为最后一个值,则item后面加上本段文字{% endif %}
{% endfor %}
其他更多用法自己实验。
3.3 ifequal/ifnotequal 值判断是否相同:
注意:{% ifequal %}比较两个值,如果相等,则显示{% ifequal %}和{% endifequal %}之间的所有内容:
{% ifnotequal%} 自然就是不相等了。
{% ifequal 值1 值2%}
执行语句一
{% else %}
否则执行语句二
{% endifequal %}
4.基础的模板过滤
- {{ bio | truncatewords:"30" }}:英文显示前30个字
- {{ bio | truncatechars:"30"}}:显示前30个字
- {{ pub_date | date:"F j, Y" }}:格式化
- {{ 123|add:"5" }} :给value加上一个数值
- {{ "AB'CD"|addslashes }} :单引号加上转义号,一般用于输出到javascript中
- {{ "abcd"|capfirst }} :第一个字母大写
- {{ "abcd"|center:"50" }} :输出指定长度的字符串,并把值对中
- {{ "123spam456spam789"|cut:"spam" }} :查找删除指定字符串
- {{ value|date:"F j, Y" }} :格式化日期
- {{ value|default:"(N/A)" }} :值不存在,使用指定值
- {{ value|default_if_none:"(N/A)" }} :值是None,使用指定值
- {{ 列表变量|dictsort:"数字" }} :排序从小到大
- {{ 列表变量|dictsortreversed:"数字" }} :排序从大到小
- {{% if 92|divisibleby:"2" %} 判断是否整除指定数字
- {{ string|escape }} :转换为html实体
- {{ 21984124|filesizeformat }} :以1024为基数,计算最大值,保留1位小数,增加可读性
- {{ list|first }} :返回列表第一个元素
- {{ "ik23hr&jqwh"|fix_ampersands }} :&转为&
- {{ 13.414121241|floatformat }} :保留1位小数,可为负数,几种形式
- {{ 13.414121241|floatformat:"2" }} :保留2位小数
- {{ 23456 |get_digit:"1" }} :从个位数开始截取指定位置的1个数字
- {{ list|join:", " }} :用指定分隔符连接列表
- {{ list|length }} :返回列表个数
- {% if 列表|length_is:"3" %} 列表个数是否指定数值
- {{ "ABCD"|linebreaks }} :用新行用
、
标记包裹 - {{ "ABCD"|linebreaksbr }} :用新行用
标记包裹 - {{ 变量|linenumbers }} :为变量中每一行加上行号
- {{ "abcd"|ljust:"50" }} :把字符串在指定宽度中对左,其它用空格填充
- {{ "ABCD"|lower }} :小写
- {% for i in "1abc1"|make_list %}ABCDE,{% endfor %} 把字符串或数字的字符个数作为一个列表
- {{ "abcdefghijklmnopqrstuvwxyz"|phone2numeric }} :把字符转为可以对应的数字??
- {{ 列表或数字|pluralize }} :单词的复数形式,如列表字符串个数大于1,返回s,否则返回空串
- {{ 列表或数字|pluralize:"es" }} :指定es
- {{ 列表或数字|pluralize:"y,ies" }} :指定ies替换为y
- {{ object|pprint }} :显示一个对象的值
- {{ 列表|random }} :返回列表的随机一项
- {{ string|removetags:"br p div" }} :删除字符串中指定html标记
- {{ string|rjust:"50" }} :把字符串在指定宽度中对右,其它用空格填充
- {{ 列表|slice:":2" }} :切片
- {{ string|slugify }} :字符串中留下减号和下划线,其它符号删除,空格用减号替换
- {{ 3|stringformat:"02i" }} :字符串格式,使用Python的字符串格式语法
- {{ "EAB
C D"|striptags }} :剥去[X]HTML语法标记 - {{ 时间变量|time:"P" }} :日期的时间部分格式
- {{ datetime|timesince }} :给定日期到现在过去了多少时间
- {{ datetime|timesince:"other_datetime" }} :两日期间过去了多少时间
- {{ datetime|timeuntil }} :给定日期到现在过去了多少时间,与上面的区别在于2日期的前后位置。
- {{ datetime|timeuntil:"other_datetime" }} :两日期间过去了多少时间
- {{ "abdsadf"|title }} :首字母大写
- {{ "A B C D E F"|truncatewords:"3" }} :截取指定个数的单词
- {{ "111221"|truncatewords_html:"2" }} :截取指定个数的html标记,并补完整
... 欢迎补充完善。
5.涉及的其他知识
5.1 自定义过滤器:
其实这里和之前1.4的自定义模板标签差不多,都是定义一个函数:
例如:这里我定义一个获取传入值前5位字符的过滤器
做法:同样是那个get_data.py文件
# get_data.py
from django import template
register = template.Library()
@register.filter(name='truncate_filter')
def truncate_chars(value):
if value.__len__() > 5:
return '%s......'% value[0:5]
else:
return value
如果没有使用name参数,django默认会将函数名作为name参数的值,所以下面的代码和上面的代码作用相同。
# get_data.py
from django import template
register = template.Library()
@register.filter
def truncate_chars(value):
if value.__len__() > 5:
return '%s......'% value[0:5]
else:
return value
说明:Library.filter(name,function,is_safe=False,needs_autoescape=False,excepts_localtime=False)函数默认需要两个参数,name是装饰器的名称(字符串类型),function是函数名。
后面三个参数可以参考 官方文档。这部分内容过于繁杂,一篇文章可能说不完,我暂时也并没有用到,所以不做过多阐述。
用法:
网站标题
{% load get_data %}
我的第一个HTML页面
我的年纪{{ "123456789"|truncate_chars}}
这里只是做一个示例,你自己可以定义更强大的过滤器,毕竟我们缺少的只是想象力。
end