一、概要
对于模版,其实就是读取模版(其中嵌套着模版标签),然后将模型中获取的数据插入到模版中,最后将信息返回给用户。
二、模板应用
1、说明
只要是在html里面有模板语法就不是html文件了,这样的文件就叫做模板
本质就是html+模板语法
2、为什么要使用模板
对页面设计进行的任何改变都必须对 Python 代码进行相应的修改。 网站设计的修改往往比底层 Python 代码的修改要频繁得多,因此如果可以在不进行 Python 代码修改的情况下变更设计,那将会方便得多。
Python 代码编写和 HTML 设计是两项不同的工作,大多数专业的网站开发环境都将他们分配给不同的人员(甚至不同部门)来完成。 设计者和HTML/CSS的编码人员不应该被要求去编辑Python的代码来完成他们的工作。
程序员编写 Python代码和设计人员制作模板两项工作同时进行的效率是最高的,远胜于让一个人等待另一个人完成对某个既包含 Python又包含 HTML 的文件的编辑工作。
2、基本使用
views.py
class User:
def __init__(self, name=None, age=0):
self.name = name
self.age = age
# views
def index(request):
title = "Hello Django"
num = 110
li = [1, 2, 3, 4, 5]
dic = {'name': '小明', 'age': 20}
user1 = User(name='小明')
user2 = User(name='小红')
user_list = [user1, user2]
context = {
'num': num,
'title': title,
'li': li,
'dic': dic,
'user': user1,
'user_list': user_list,
}
return render(request, 'home/index.html', context)
templates/home/index.html
Title- 数字:{{ num }}
- 字符串:{{ title }}
- 列表:{{ li.0 }}
- 列表:{{ li.1 }}
- 列表:{{ li.2 }}
- 字典:{{ dic.name }}
- 字典:{{ dic.age }}
- 对象:{{ user.name }}
- 对象:{{ user.age }}
- 列表:{{ user_list.1.name }}
遍历li的值
{% for item in li %}
{{ item }}
{% endfor %}
遍历列表,去对象的值
{% for user in user_list %}
用户名:{{ user.name }}
密码:{{ user.age }}
{% endfor %}
遍历字典,
{% for user in dic.items %}
用户名:{{ user.name }}
密码:{{ user.age }}
{% endfor %}
遍历列表,去对象的值: 倒序
{% for user in user_list reversed %}
用户名:{{ user.name }}
密码:{{ user.age }}
{% endfor %}
三、模板语法
1、变量--{}
1.1、 {}语法
语法格式
{{ }}
举个栗子
#views.py
def index(request):
return render(request, 'home/index.html', {'content','模板语法'})
{{ content }}
1.2、语法
语法格式
对象.变量名
应用
字典查询(Dictionary lookup)
属性或方法查询(Attribute or method lookup)
数字索引查询(Numeric index lookup)
对象.方法名(必须无参)
举个栗子
见基本
2、标签--{% tag %}
标签看起来像是这样的: {% tag %}。标签比变量更加复杂:一些在输出中创建文本,一些通过循环或逻辑来控制流程,一些加载其后的变量将使用到的额外信息到模版中。
一些标签需要开始和结束标签 (例如{% tag %} ...标签 内容 ... {% endtag %})
2.1、for
语法格式1
{% for 元素 in 可迭代对象 %}
{{ 元素 }}
{% endfor %}
{% for 元素 in 可迭代对象 %}
{{ 元素. 属性}}
{% endfor %}
语法格式2
{% for 元素 in 可迭代对象 reversed%}
{{ 元素. 属性}}
{% endfor %}
语法格式3
{% for 元素 in 可迭代对象 %}
{{元素.属性}}
{% empty %}
空元素
{% endfor %}
语法格式4
{% for item in 可迭代对象 %}
# 默认从1开始计数
{{ forloop.counter }}
# 表示从0开始计数
{{ forloop.counter0 }}
#
{{ forloop.recounter }}
{{ forloop.recounter0 }}
# 判断是否是第一个元素
{{ forloop.first }}: {{ item }}
# 判断是否是最后一个元素
{{ forloop.last }}: {{ item }}
{% endfor %}
示例代码
{% for item in li %}
计算器
计数默认:{{ forloop.counter0 }}
计数倒序:{{ forloop.revcounter }}
是否第一项:{{ forloop.first }}
是否是最后一项:{{ forloop.last }}
{% endfor %}
{% for link in links %}
{{ link }}
{% if not forloop.last %} |
{% endif %}
{% endfor %}
2.2、if
语法格式
{% if 条件表达式1 %}
{% elif 条件表达式2 %}
{% else %}
{% endif %}
示例代码
{% if num > 100 or num < 0 %}
无效
{% elif num > 80 and num < 100 %}
优秀
{% else %}
差
{% endif %}
2.3、csrf_token
说明
用于生成csrf_token的标签,用于防治跨站攻击验证。注意如果你在view的index里用的是render_to_response方法,不会生效。其实,这里是会生成一个input标签,和其他表单标签一起提交给后台的。
注意:在settings中的中间件MIDDLEWARE中配置打开
'django.middleware.csrf.CsrfViewMiddleware',
语法格式
{%csrf_token%}
示例代码
{%csrf_token%}
2.4、url
说明
引用路由配置的地址
语法格式
{% url 'name' %}
举个栗子
url的用法也很简单,只要在urlpatterns里使用它,附加一个name
urlpatterns = [
url(r'^home$','index' ,name="test_url"),
]
2.5、static
说明
引用静态文件
使用步骤
1、在首部使用模板标签{% load staticfiles %}来说明一下内容,将载入静态文件;
2、使用{% static 'css/style.css' %}来指明CSS框架文件的存放位置;
3、若html文件中,出现需要引用静态文件的地方,都需要用static来替换。
示例代码
{% load staticfiles %}
Title模板标签
说明
该标签允许在(模板中)包含其它的模板的内容。 标签的参数是所要包含的模板名称,可以是一个变量,也可以是用单/双引号的字符串。 每当在多个模板中出现相同的代码时,就应该考虑是否要使用 {% include %} 来减少重复。
语法
{% include '引入的模板名' %}
示例代码
top.html
Title{% include 'top.html' %}
3、过滤器 {{obj|filter__name:param}}
可以通过过滤器来修改变量的显示,过滤器的形式是:{{ variable | filter }},管道符号'|'代表使用过滤器
过滤器能够采用链式的方式使用,例如:{{ text | escape | linebreaks }}
过滤器还可以带参数,例如: {{ bio|truncatewords:30 }}
过滤器的参数中如果带有空格,那么需要用引号引起来,例如:{{ list | join : ", "}}
django中30个内建的过滤器
3.1、add
说明
给变量加上相应的值
过滤器首先会强制把两个值转换成Int类型。如果强制转换失败, 它会试图使用各种方式吧两个值相加。它会使用一些数据类型 (字符串, 列表, 等等.)
语法格式
{{ value|add:"值" }}
举个栗子
#st = 'hello'
{{ st|add:"world" }}
3.2、default
说明
如果一个变量是False或者为空,使用给定的默认值。否则,使用变量的值
语法格式
{{ value|default:",默认值" }}
举个栗子
title = ''
{{ title|default:",默认值" }}
3.3、length
说明
返回值的长度。它对字符串和列表都起作用
语法格式
{{ value|length }}
举个栗子
li = ['a', 'b', 'c', 'd']
{{ li|length }} #4
3.5、date
说明
按指定的格式字符串参数格式化 date 或者 datetime 对象
语法格式
{{ value|date:"日期格式" }}
举个栗子
#如果 now_time = datetime.datetime.now()
{{ now_time|date:"Y-m-d H:i:s" }}
4、自定过滤器
4.1、说明
在内置的方法满足不了我们的需求的时候,就需要自己定义属于自己的方法了,自定义方法分别分为filter和simple_tag
4.2 、区别
传参:
filter默认最多只支持2个参数:可以用{{value|fun:"p1, p1, p3" }}这种形式将参数传递个函数
simple_tag支持多个参数:{% fun p1 p2 p3 p4 %} 有多少就写多少
模板语言if条件:
filter支持if
# 函数的结果作为if语句的条件
{% if value|f1 %}
True
{% else %}
False
simple_tag: 不支持模板语言if条件`
4.3、步骤
在settings中的INSTALLED_APPS,注册app
在app中创建templatetags目录,目录名必须为templatetags
创建一个自定义的custom_tags.py
from django import template
from django.utils.safestring import mark_safe
# register的名字是固定的,不可改变
register = template.Library()
# 过滤器
@register.filter
def test_filter(value, param):
return value + param
@register.filter
def test_filter2(value, param1,param2):
return value + param1 + param2
# 标签
@register.simple_tag
def multi_tag(value, p2, p3, p1):
return value * p2 * p3 * p1
@register.simple_tag # 标签
def my_input(id, arg):
result = "" % (id, arg,)
return mark_safe(result)
在使用自定义simple_tag和filter的html文件中导入之前创建的 custom_tags.py
在引用模板中导入:{% load custom_tags %}
在模板中使用
{# 使用filter方式调用自定义方法 #}
{{ test_filter1|test_filter2}}
!-- 将test_filter当做参数传递给test_filter2函数进行处理,接受2个参数 处理方式
{{ test_filter1|test_filter2:"xxx" }}
{# 使用simple_tag方式调用自定义方法 #}
{% multi_tag "处理的值" "参数1" "参数2" "参数3" %}
四、模版继承
1、说明
Django模版引擎中最强大也是最复杂的部分就是模版继承了。模版继承可以让您创建一个基本的“骨架”模版,它包含您网站中的全部元素,并且可以定义能够被子模版覆盖的块
2、相关语法
继承语法
{% extends "母版名称" %}
块语法
{% block 块名称 %}
重写内容
{% endblock %}
3、示例代码
母版
{% load staticfiles %}
{% block page_title %}
{% endblock %}
{% block page_css %}
{% endblock %}
{% block page_jq %}
{% endblock %}
{% block page_head %}
{% endblock %}
{% block page_content %}
{% endblock %}
子模板
{% extends 'base.html' %}
{% block page_jq %}
jq代码
{% endblock %}
{% block page_head %}
头部HTML代码
{% endblock %}
{% block page_content %}
主体HTML内容代码
{% endblock %}
{% block page_footer %}
底部HTML内容代码
{% endblock %}
4、总结
如果你在模版中使用 {% extends %} 标签,它必须是模版中的第一个标签。其他的任何情况下,模版继承都将无法工作。
在base模版中设置越多的 {% block %} 标签越好。请记住,子模版不必定义全部父模版中的blocks,所以,你可以在大多数blocks中填充合理的默认内容,然后,只定义你需要的那一个。多一点钩子总比少一点好。
如果你发现你自己在大量的模版中复制内容,那可能意味着你应该把内容移动到父模版中的一个 {% block %} 中。
如果需要获取父模板中的block 的内容,可以使用{{ block.super }} 变量。如果你想要在父block 中新增内容而不是完全覆盖它,它将非常有用。